No description
Find a file
Rech Tan 26b0782ee7 docs: answer the Wave 3 cross-review with what shipped and what did not
Three cross-reviews read this repo at 45d21d4. Two things in it were wrong by
the time they were read, and one was a promise with nothing behind it.

Wrong: VALIDATION.md said public registration was closed. There is no
registration at all now — sign-in moved to an external identity service with a
one-time code to the admin mailbox as the fallback, and this service stores no
passwords. The status table also predated /version.

Promised but absent: README and AGENT_AND_SKILLS claimed contributions to the
shared repair knowledge base could be traced and withdrawn. There was no way to
see them and no way to withdraw them. That is now real — an account page
section listing the actual stored text of every case it contributed, each one
withdrawable, and guest triage no longer contributes at all, because a guest's
account is deleted with its session and a contribution nobody can withdraw
should not be created in the first place.

Recorded the defect that the reviewer's own suggestion found: redaction
measured runs of consecutive digits, so 400-8888-8888 split into 3/4/4, each
group short of the threshold, and a whole phone number reached the shared base
untouched. Worth writing down because it argues for their point better than any
"verified" claim in this file does.

Added WAVE3_CHANGES.md. The showcase repo is a snapshot, so iteration is
invisible here by construction; a page that lists what changed and what was
declined is a more honest fix than manufactured commits. It carries the build
id, so every claim on it can be checked against the deployed /version.

The declined list stays as prominent as the completed one: no evidence.json, no
public verifier, no screen recordings, no price confidence intervals, no health
tiering, no data export. No dates promised for any of them.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-06 16:54:08 +08:00
docs docs: answer the Wave 3 cross-review with what shipped and what did not 2026-08-06 16:54:08 +08:00
examples docs: add source-free competition showcase 2026-08-02 16:41:57 +08:00
media docs: add source-free competition showcase 2026-08-02 16:41:57 +08:00
.gitignore docs: add source-free competition showcase 2026-08-02 16:41:57 +08:00
README.md docs: answer the Wave 3 cross-review with what shipped and what did not 2026-08-06 16:54:08 +08:00

Remain Passport · 留物护照

用多模态 AI 给每一件需要被记住的东西发一本数字护照:物品、订阅、健康养护,一台 Agent 引擎统一管理。

在线 Demo

体验地址:https://passport.rechtan.com

打开后选择「进入访客 Demo」无需注册或填写账号。访客环境会生成一套隔离、限时、日期相对的示例数据关闭标签页后再次进入会恢复初始状态。

推荐评审顺序:

  1. 在「概览」查看延寿、省下金额、在管护照和本周事项。
  2. 进入 Agent 工作区,输入「帮我给这件物品建一本护照」,观察任务识别和结构化 Artifact。
  3. 在护照册选择一件物品,发起维修问诊,观察逐轮追问与修/换决策卡。
  4. 查看「管家周报」和待办,理解 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 不是完整记账系统、医疗诊断平台或二手交易撮合平台。健康护照仅管理复查和养护事项;维修建议是辅助决策,金额会标注依据和不确定性;「护照移交」当前为概念演示。