ADR 0013

ADR 0013 — Resident 容器：投影与回收、对话状态、分层进化、成员技能集

Status: Accepted（方向）（Haisu，2026-10-13，Multica TFHS-34："方向认可了"；2026-10-14 Haisu 逐条裁定技能归属、会话回收、GitHub 登录态、技能遗忘、回调接口、会话归属与对话状态推断，本文已按裁定修订）· Implementation：未实现 · 设计细节见 Resident-Container

效力说明：Haisu 认可的是方向与边界（本文 Decision 各条）；字段、目录、工具名与阶段划分是设计提案，随实现与受控验证演进。本文不修订 ADR-0010：技能仍归属团队，本文只补充"每个成员各自携带哪些技能、权重多少"。ADR-0011（Rust / Pi / SQLite）、ADR-0012（常驻运行时与受控申报）继续有效。

修订记录：2026-10-13 初稿曾写"修订 ADR-0010，skill 默认归属成员"，2026-10-14 Haisu 指出两者不矛盾——"所有成员的技能都是团队的"——该修订撤回；同日按裁定改写 Decision 2、6、7、8；随后又按第二轮裁定补充 Decision 2（会话归属与归类导入）、5（Jev）、6（遗忘确认）、9（回调接口）；第三轮明确 Decision 5 中 Jev 只代表一类模型、云端调用与本地优先不矛盾；随后按 TFHS-49 裁定补充 Decision 6 的技能权重、遗忘规则与原则审批入口。

Context

Haisu 在 TFHS-34 中提出：Viva 要成为 AI 成员的容器，让成员脱离具体模型（Claude、GPT、DeepSeek、Kimi）与 agent 软件（pi、Hermes、Codex、Claude Code），把 LLM 当作外部思考的器官。容器需要：

• 记忆：能从各 agent 软件提取会话，保存并在之后取用（先只考虑文本）；
• 状态：区分"谈工作"与"谈个人"，状态决定激活哪部分记忆；
• 自进化：形成新的原则与技能，参考 Hermes；
• 多个成员（Samuel 策划、Deven 开发、Alice 测试、Oliver 运维、Victor 交易）：记忆互相独立，各自的技能集互相独立，但技能同步要比人类简单得多；
• 协调：Samuel 作为中枢，回答进度、接受修正、调整文档与 issue，并协调其他成员。

Viva 已有的本体覆盖了其中一部分：Resident ≠ Engine ≠ Worker（ADR-0006）、四类知识归属与复用证据（ADR-0010）、受控申报通道兼作自模型容器的取材通道（ADR-0012 §5）、委派授权（ADR-0007）。尚未覆盖的是：harness 双向适配的形状、对话状态、进化的分层、成员技能集与技能的权重和遗忘。

Decision

1. 容器即 Viva 的 Resident 资产层，不是另一个系统。 成员是 Viva 持有的数据（identity、experience、knowledge、技能集、principles、对话状态）；模型与 harness 是可替换器官。不新增与 Resident 平行的"个体"对象。

2. 双向适配：投影与回收。 会话开始时 Viva 把成员投影进 harness（指令文件、技能目录、工作包、回调接口）；会话结束后从 harness 回收会话内容。所有会话都回收，不按内容挑选；每段会话归属于参与它的成员，默认只有该成员可见（Haisu 与 Samuel 的对话，Alice 看不到）。成员身份只能通过 Viva 启动：经 Viva 启动的会话由执行记录确定归属；不经 Viva 启动的会话（例如直接在终端打开 Claude Code）不自动认定成员。为此提供会话归类导入：从各 harness 的历史会话中挑选，由 Haisu 归到某个成员的 experience。这样同一成员在 pi、Codex、Claude Code 等不同 harness 里的会话，最终都汇成该成员的会话，可在一个入口查到。回收内容只进入 experience，经策展与准入门才成为 knowledge；它不成为任务或执行状态的权威来源（屏幕推断不入库的规则不变）。落盘前照常脱敏。

3. 最小记忆单元的四要素：内容（摘要 + 正文）、作用域（owner + 激活条件）、时间与溯源（发生、失效 / 取代、来源执行或会话）、权重与状态（重要性及理由、可信度、生命周期、使用记录）。具体 schema 以选定后端的能力为先，不强制新 schema；记忆后端仍未裁决。

4. 动态事实不进记忆。 issue / PR / Task / Execution / grant 等有权威来源的状态每次实时查询；记忆只保存解释与决策。

5. 对话状态（Engagement State）是新的成员运行期概念。 至少包含 domain、project、对话对象、活动；显式切换优先，其次按入口规则判断，仍判断不了的交给判断模型，结果可纠正。判断模型采用判断类模型（输出带校准置信度的类型化决策，置信度低于阈值时转为询问 Haisu）；Jev（TypeSafe AI）是这类模型的代表，可替换为同类模型，与 Engine 一样是可替换的绑定。判断模型通过云端 API 调用是正常用法：本地优先指成员状态与资产由 Haisu 本机持有，不排斥调用云端模型（Viva 调用 DeepSeek 等也是走 API）。对话状态只能收窄 ADR-0010 的可见性边界，不能放宽。

6. 进化分三层：

   • 记忆：策展候选 + 准入门。
   • 技能：从成功的工作中总结生成；没有"转正"环节，而是带权重：被使用则加权，长时间不用则降权，低于阈值即遗忘——退出该成员的可用技能集，不再被投影或召回。目的是让成员不会因技能太多而选不准该用哪个。遗忘不物理删除（Domain-Model 不变量 I2）：技能退出该成员的技能集，仍保留在团队技能库，随时可以找回（Haisu 2026-10-14 确认）。具体规则（TFHS-49，Haisu 2026-10-14 裁定，细则见 Resident-Container §7.1）：
     • 只有在 Execution 中真正读取技能正文才算使用；被投影进会话不算。成功记 1.0，失败记 0.25，被 Haisu 纠正记 0。
     • 权重是每个（成员，技能）的状态值，每次使用后更新，选取与判断时读当前值；使用事件只追加，状态值可从事件重建。
     • 衰减轨道有两种：按成员会话数（半衰期 30 次）或按自然时间（半衰期 60 天）。每个技能只按其中一种衰减，不会同时生效；判断标准另行讨论（可能作为 principle），在此之前默认走会话轨。
     • 当前权重 < 0.1 且按所属轨道已足够久未用（≥ 20 次会话或 ≥ 60 天），或技能集超过 30 个时，遗忘权重最低者。新技能有 10 次会话的保护期；首月只试运行。
     • 写入成员 soul.md 的是本命技能，不可被遗忘，不占容量。
     • 每次会话最多投影 10 个技能，相关性为主、权重为辅；其余可在会话中搜索。
     • 成员可自行从团队技能库找回或领取任何技能，不需批准，留事件并进周报。
   • 原则：新增的成员级规范条目，必须由 Haisu 批准，永不自动晋升。协调成员每周汇总候选，审批入口在 Viva 内（先 CLI，后 Workbench），不放在 Multica（Haisu 2026-10-14 裁定；细则见 Resident-Container §7.2）。

   每次进化留版本与依据，可回滚。self_model_candidate 的规则不变。

7. 技能归属团队，技能集属于成员。 ADR-0010 的 skill 归属团队不变：所有成员的技能都是团队的。每个成员有自己的技能集（携带哪些团队技能、各自的权重），成员之间互相独立。技能同步就是把一个团队技能加入另一个成员的技能集，并给一个初始权重；若需要按目标成员的工具环境改写，改写结果作为新的团队技能保存并记录来源（derived_from）。成员的个人记忆不直接复制给其他成员；需要传递的经验先提炼为技能或 team_knowledge。

8. GitHub 登录态不属于容器。 成员能否修订 GitHub issue / PR，取决于它所运行的环境是否有 gh 登录态，这是运行环境的凭据，不是容器管理的资产。拿不到登录态时，相关工作如实报告受阻，不绕过。Samuel 的派发、观察、修正沿用 ADR-0007（子 grant 不得放大）；merge / approve / push 保护分支仍只属于 owner（不变量 I4）。issue 系统是成员之间的共享黑板。

9. 成员回调接口先用 CLI。 成员在会话中途查记忆、写回、读写对话状态、取技能，先通过现有 viva CLI（经 grant 校验）提供；遇到没有 shell 的入口时再加 MCP 形态，且必须走同一授权入口（Haisu 2026-10-14 同意）。

Consequences

• Domain-Model、Product-Model、Temporal-Model 以补充段落登记新增概念（技能集与权重、对话状态、principle）；技能归属的原文无需修订。
• 新概念在实现前不出现在 UI 与文案中（Core-Thesis 诚实约束）。
• 技能权重与遗忘的具体规则及原则审批入口已于 2026-10-14 经 TFHS-49 裁定（Open-Questions 第 15 条 resolved）；参数为初始值，按真实数据调整。
• 实现路线提案见 Resident-Container §10，对应 Roadmap 的 M2 / M3；阶段划分随 Roadmap 于 2026-10-14 一并接受（viva#100），均未实现。

Alternatives considered

• 把 Hermes 当作成员运行时：仍按 ADR-0005 的顾虑当前倾向否决；Hermes 的学习闭环只作为设计借鉴。
• 技能归属成员（初稿方案）：撤回。团队归属 + 成员技能集已能表达"各成员技能互相独立"。
• 技能"试用 → 转正"（初稿方案）：撤回。改为权重与遗忘，直接针对"技能太多选不准"的问题。
• 记忆由各 harness 自行保存：换 harness 等于换人，违背 "Session dies. Resident persists."，否决。