Three cross-reviews read this repo at
|
||
|---|---|---|
| docs | ||
| examples | ||
| media | ||
| .gitignore | ||
| README.md | ||
Remain Passport · 留物护照
用多模态 AI 给每一件需要被记住的东西发一本数字护照:物品、订阅、健康养护,一台 Agent 引擎统一管理。
在线 Demo
体验地址:https://passport.rechtan.com
打开后选择「进入访客 Demo」,无需注册或填写账号。访客环境会生成一套隔离、限时、日期相对的示例数据;关闭标签页后再次进入会恢复初始状态。
推荐评审顺序:
- 在「概览」查看延寿、省下金额、在管护照和本周事项。
- 进入 Agent 工作区,输入「帮我给这件物品建一本护照」,观察任务识别和结构化 Artifact。
- 在护照册选择一件物品,发起维修问诊,观察逐轮追问与修/换决策卡。
- 查看「管家周报」和待办,理解 Agent 如何从档案主动发现保修、养护与续费机会。
完整的 5 分钟演示脚本见 docs/DEMO.md。
这是什么
Remain Passport 不是给传统 App 加一个聊天框,而是给长期运行的生活资产 Agent 造了一个可视化工作空间。用户只负责提供照片、症状或修正意见,Agent 负责补全档案、推导养护义务、辅助维修决策,并定期巡检全部档案。
系统用统一的 subject 抽象管理三类对象:
| 护照 | 典型对象 | Agent 产生的价值 |
|---|---|---|
| 物品护照 | 家电、数码、耗材 | 保修提醒、耗材周期、修换决策 |
| 服务护照 | 会员、订阅、周期服务 | 续费提醒、低使用率检查 |
| 健康护照 | 洗牙、视力检查、复查事项 | 复查周期、行动建议;不替代医疗诊断 |
flowchart LR
U[用户] --> W[Web Demo]
U --> T[Agent TUI]
W --> A[Passport Agent]
T --> A
A --> C[通用对话]
A --> S1[S1 建档]
S1 --> S2[S2 养护推导]
A --> S3[S3 维修问诊]
S3 --> K[脱敏知识沉淀]
A --> S4[S4 自主巡检]
C --> O[Artifact / 回复]
S1 --> O
S2 --> O
S3 --> O
S4 --> O
O --> H[用户确认与执行]
Agent 与 Skills
| 能力 | 输入 | 可交付输出 | 人的角色 |
|---|---|---|---|
| 通用对话与任务路由 | 文字、图片、会话历史 | 回复、Markdown 或图表 Artifact、任务切换 | 描述目标,决定是否进入领域流程 |
| S1 建档 Intake | 实物照片、截图、补充说明 | 可编辑的护照草稿、识别依据、待确认字段 | 修正字段并确认签发 |
| S2 养护推导 | 品类、型号、日期与使用信息 | 保修、耗材、续费或复查义务 | 接受、修改或拒绝建议 |
| S3 维修问诊 | 护照上下文、症状、图片、追问回答 | 维修价/残值/新品价对照、修换建议、行动步骤 | 回答关键问题并作最终决定 |
| 知识沉淀 | 已完成问诊和决策结果 | 去除联系人、订单号、序列号后的品类级经验 | 不公开原始对话;在账号页查看已入库内容并可随时撤回 |
| S4 自主巡检 | 全部有效护照与义务 | 红黄绿发现、自然语言周报、可转待办事项 | 审阅优先级并执行待办 |
Skills 的触发方式、交互闭环与边界见 docs/AGENT_AND_SKILLS.md。本仓库不公开 Skill prompt、模型编排、工具注册表或结构化 Schema 实现。
两种交互界面
- Web Demo:面向最终用户,展示 Agent 对话、图片输入、Artifact、护照册、维修决策、周报与待办。
- Agent TUI:面向重度用户和评测人员的终端界面,默认进入 Agent 工作区,提供统一历史、对话编辑器和 Artifact 三栏,并通过受限 API Key 使用与 Web 相同的服务端 Agent。
TUI 的公开交互说明见 docs/TUI.md。为了不泄露实现,本仓库不提供 TUI 源码或安装包;评审的可运行入口是在线 Web Demo。
可验证成果
- 多模态建档:从铭牌照片识别型号,并生成身份字段与养护义务。
- 协同编辑:用户修改过的字段不会被 Agent 静默覆盖,只能形成待接受或拒绝的提议。
- 引导式问诊:Agent 每轮聚焦一个有区分度的问题,最后交付可执行的修/换决策卡。
- 数据飞轮:问诊结果先泛化、再确定性脱敏,成为跨账号可检索的品类经验。
- 贡献可撤回:账号页列出本账号进入知识库的全部案例,可逐条查看实际入库文本并撤回;访客问诊不入库。
- 自主巡检:定时扫描档案,生成周报、风险分级和待办,不依赖用户主动提问。
- 诚实降级:模型、向量检索或联网能力不可用时明确说明,不用假 Agent 数据代替。
- 版本可对账:
curl -s https://passport.rechtan.com/version返回构建号、编译时间、Demo 开关、Agent 状态与数据库迁移版本。
已完成的运行验证和公开 Demo 健康状态见 docs/VALIDATION.md,交互输出形态见 examples/OUTPUT_SAMPLES.md。
参赛仓库说明
这是一个无源码的作品展示仓库,用于 Wave 3 交叉评审与产品验收。它提供在线 Demo、产品说明、Agent/Skills 能力契约、交互样例、验证记录及媒体素材索引,但不包含完整实现仓库的任何源码。
| 本仓库包含 | 本仓库不包含 |
|---|---|
| 在线 Demo 与操作说明 | Rust、Svelte、TypeScript 等源码 |
| Agent/Skills 的公开能力说明 | Skill prompts、工具编排和内部 Schema |
| 脱敏后的输入输出样例 | 模型密钥、环境变量和部署凭据 |
| 人与 AI 协作流程、Specs 对照 | 数据库、附件、用户数据和服务日志 |
| 可公开的验证结论和媒体索引 | 私有仓库地址、提交历史和内部运维细节 |
详细披露边界见 docs/DISCLOSURE_BOUNDARY.md。赛事要求与证据映射见 docs/SPECS.md。
Wave 3 交叉评测之后改了什么、以及哪些意见接受了但本轮没做,逐条列在 docs/WAVE3_CHANGES.md。
仓库导航
passport-competition/
├── README.md
├── docs/
│ ├── AGENT_AND_SKILLS.md # Agent 与 Skills 的公开能力契约
│ ├── DEMO.md # 2 分钟速览与 5 分钟主线
│ ├── DISCLOSURE_BOUNDARY.md # 无源码披露边界
│ ├── SPECS.md # 赛事评测项与证据对照
│ ├── TUI.md # 终端 Agent 的交互说明
│ ├── VALIDATION.md # 已验证能力与公开站点状态
│ └── WAVE3_CHANGES.md # 交叉评测后的改动与明确未做项
├── examples/
│ └── OUTPUT_SAMPLES.md # 脱敏后的输入输出形态
└── media/
└── README.md # 截图与录屏清单
产品边界
Remain Passport 不是完整记账系统、医疗诊断平台或二手交易撮合平台。健康护照仅管理复查和养护事项;维修建议是辅助决策,金额会标注依据和不确定性;「护照移交」当前为概念演示。