Resident Container

Resident 容器

Status: 方向 Accepted（Haisu，2026-10-13，Multica TFHS-34 讨论后确认"方向认可"；2026-10-14 两轮逐条裁定技能归属、会话回收与归属、GitHub 登录态、技能遗忘、回调接口、对话状态推断；同日经 TFHS-49 裁定技能权重与遗忘的具体规则及原则审批入口，本页已按裁定修订）· 边界级决策见 ADR-0013 · Implementation：未实现 · 本页字段、目录与工具名为设计提案，随实现与受控验证演进。

Provenance — 来自 Multica 任务 TFHS-34「关于 viva 中 ai 个体的容器」（2026-10-13）：Haisu 提出畅想（记忆、状态、自进化、多个体、技能同步、Samuel 中枢），Agent 给出结构方案，Haisu 回复"方向认可"。本页把讨论结论对齐到 Viva 现有本体（Core-Thesis、Domain-Model、ADR-0010、ADR-0012、Research-Agent-Memory-Architecture）后固化；与现有裁决冲突处已在 ADR-0013 显式处理，未决处列入 Open-Questions。

1. 一句话

AI 成员（Resident）是一份由 Viva 持有的数据，而不是一个进程；模型（Cognitive Engine）是外接的思考器官，agent 软件（Worker / harness）是借来的手脚。 容器负责两个方向：会话开始时把成员投影进 harness，会话结束后把发生的事回收回成员。投影与回收的适配器做好了，成员就不依赖任何具体模型或 agent 软件。

这是 Core-Thesis "The member must exist before the member thinks" 与 "Session dies. Resident persists." 的具体化，不是新的产品方向。

2. 讨论用语 → Viva 术语

讨论中的说法	Viva 术语	说明
AI 个体（Samuel、Deven、Alice、Oliver、Victor）	Resident	名字是配置数据，不是代码（Viva ≠ Samuel）
LLM（Claude / GPT / DeepSeek / Kimi）	Cognitive Engine	可替换器官
agent 软件（pi、Hermes、Codex、Claude Code…）	Worker / harness	可替换工具；首版检测范围见 ADR-0012 §5
容器	Viva 的 Resident 资产层（身份 + 时间轴 + 技能 + 投影/回收）	不是另一个服务或另一套成员系统
记忆	experience（原始）→ knowledge（策展后）	五层不变量 raw event ≠ experience ≠ memory ≠ self-model ≠ identity 不变
状态（谈工作 / 谈个人）	对话状态（Engagement State），新概念	见 §6；不要与 Workspace（长期语境）混用
自进化（principle / skill）	分层策展：记忆 / 技能 / 原则	见 §7
Neo 式下载技能	把团队技能加入另一成员的技能集	见 §8

与 ADR-0012 §5 的关系：该处"自模型容器经受控通道取材、自行判定是否保存"的职责，由本容器的回收与策展承担；self-model 本身仍按 self_model_candidate 规则只记录、不自动演化（Open-Questions 第 3 条继续成立）。

3. 总体结构

flowchart LR
  subgraph Harness["Worker / harness（可替换）"]
    PI[pi]
    CC[Claude Code]
    CX[Codex]
    HM[Hermes]
  end
  subgraph Viva["Viva：Resident 资产层"]
    ING[回收：受控申报 + session 取材] --> EXP[experience]
    EXP --> CUR[策展 / 准入门]
    CUR --> KN[(knowledge · skills · principles)]
    KN --> EVO[分层进化] --> KN
    ST[对话状态] --> PROJ[投影：上下文装配]
    KN --> PROJ
    ID[identity：role / engine / tools] --> PROJ
    API[成员回调接口<br/>recall / remember / state / skill]
    KN <--> API
  end
  Harness -- 申报 / 会话记录 --> ING
  PROJ -- 指令文件 / 技能目录 / 工作包 --> Harness
  Harness <-- 运行时调用（经 grant 校验） --> API

Loading

3.1 成员回调接口是什么

投影只发生在会话开始时，装进去的是一小份精选内容。会话进行中，正在 harness 里工作的成员（例如在 Claude Code 里运行的 Samuel）还需要随时回头找 Viva：

• recall：查自己的记忆，例如"上次和 Haisu 定的测试策略是什么"；
• remember：提交一条值得记住的内容（作为策展候选）；
• state：读取或申报当前对话状态；
• skill：列出或读取自己技能集里的技能。

这一组"成员在会话中调用 Viva"的入口就是成员回调接口。没有它，成员只能用开场时装进去的那一份，记不起没被预装的内容，也无法在会话中途写回。

Viva 已有这样的入口：成员作为子进程运行时，通过执行 viva … 命令回调 Viva，并经过 grant 校验（Conceptual-Architecture）。所以 C2 先在 CLI 上加这四类命令。

已定（Haisu 2026-10-14）：先用 CLI，需要时再加 MCP。 MCP 形态是可选的增强，不是前提：

• 好处：harness 会把 MCP 工具连同参数说明直接列给模型，模型更容易发现、更稳定地调用；不需要 shell 权限，也不依赖指令文件里写清命令用法。
• 不提供的代价：只能用于有 shell 工具的 harness（目前的 coding agent 都有），模型要靠指令文件学会命令；纯对话、没有 shell 的入口无法回调。
• 无论哪种形态，都必须走同一授权入口，不能成为绕过 grant 的旁路。

4. 成员资产的组成

每个成员拥有以下资产（落点遵循 ADR-0011：SQLite 保存状态与关系，普通文件保存正文；各事实只有一个权威来源）：

资产	内容	变化速度	现状
identity	名字、role、engine 绑定、tools、人格与职责边界说明（soul.md，含本命技能，见 §7.1）	几乎不变，Haisu 显式修改	role/engine/tools 已实现；soul.md 未实现
principles	从经验中沉淀、经 Haisu 批准的工作原则	慢	未实现（新增类别，见 §7）
技能集	该成员携带哪些团队技能（SKILL.md）及各自权重	中	skill 条目已实现（团队归属）；技能集与权重未实现，见 §7、§8
knowledge	personal_memory、self_model_candidate 等策展条目	中	已实现手工策展 + provenance + usage
experience	journal 与执行日志、回收的会话记录	快，只追加	journal 已实现；session 回收未实现
对话状态	当前 domain / project / 对话对象 / 活动	每次会话	未实现

正文以人可读的开放格式保存，便于直接阅读、修改、用版本历史看到"成长"的 diff，以及回滚一次坏的进化。索引（FTS、向量、访问统计）是派生数据，可以重建。具体记忆后端仍未裁决（Open-Questions 第 1 条），本页的契约不依赖某个后端。

5. 记忆

5.1 最小记忆单元

一条文本记忆至少要回答四类问题。这与 Research-Agent-Memory-Architecture §5.2 的需求清单一致：

1. 内容：一句话摘要（用于检索和装配）+ 正文（经过、原因、结论、后续）。
2. 作用域：属于谁（ADR-0010 的 owner 类别）、在什么对话状态下应被激活（domain / project / 相关的人）。
3. 时间与溯源：何时发生、何时失效或被哪条取代、来自哪次执行或哪段会话（harness + 会话标识 + 轮次范围）。
4. 权重与状态：重要性及理由、可信度、生命周期（active / superseded / archived / retracted）、真实使用记录。

参考字段（提案，实现时以后端已有能力为先，不强制新 schema）：

id: mem_2026-10-13_0007
kind: personal_memory          # ADR-0010 的归属类别
owner: samuel
form: episode                  # episode 事件 | fact 事实 | preference 偏好 | reflection 反思
summary: "与 Haisu 决定 TFHS 改为先独立 QA 再合并"
scope: { domain: work, project: tfhs, people: [haisu] }
time: { occurred_at: 2026-10-13T22:30+08:00, valid_until: null }
source: { execution: exe_…, harness: claude-code, session: "…jsonl", turns: [41, 58] }
importance: { score: 0.8, reason: "Haisu 明确强调" }
confidence: 0.9
status: active
links: { supersedes: [mem_2026-10-02_0003], derived_from: [] }
used_in: []                    # 复用证据，ADR-0010 规则不变

5.2 管线

1. 回收（取材）：两种来源。一是 ADR-0012 §5 的受控申报，二是读取 harness 自己保存在本机的会话记录（如 Claude Code、Codex 的 JSONL 会话文件；各 harness 的实际位置与格式在实现时逐一核实）。每个 harness 一个适配器，统一转成"轮次序列 + 归属"。
   • 所有会话都回收，不按内容挑选（Haisu 裁定，2026-10-14）。
   • 会话归属于参与它的成员，默认只有该成员可见：Haisu 与 Samuel 的对话，Alice 看不到。
   • 成员身份只能通过 Viva 启动（Haisu 裁定，2026-10-14）：经 Viva 启动的会话由执行记录确定归属；不经 Viva 启动的会话（例如直接在终端打开 Claude Code）不自动认定是哪个成员。
   • 会话归类导入：从各 harness 的历史会话中挑选，由 Haisu 归到某个成员的 experience。这样 Haisu 在 pi 里和 Samuel 的对话、在 Codex 里和 Samuel 的对话，最终都汇成 Samuel 的会话，可以在一个入口查到 Samuel 在所有 harness 里的会话。
   • 落盘前照常脱敏（secret redaction），回收内容只进入 experience，不自动成为 memory。
2. 策展：会话结束后（或批处理时）由模型提出候选：拆分事件、与已有条目比对后给出新增 / 更新 / 取代 / 忽略建议。候选经过 Temporal-Model §5 的准入门（复现、意外、强调、再推导成本高）才写入；写入必须带 provenance。
3. 召回：先按授权与 owner 范围过滤，再按对话状态过滤，然后做精确字段 / FTS / 可选向量检索，按相关性、明确重要性、时效排序，最后在 token 预算内装配。分两条路：会话开始时预装配一小份，会话中由成员通过回调接口按需检索。

5.3 不进记忆的东西

外部系统里本来就有权威来源的动态事实，例如 issue 状态、PR 是否合并、任务与执行状态、授权，不存成记忆，每次实时查询。记忆只保存解释与决策：为什么这么定、Haisu 偏好什么、上次哪个方案失败了。否则记忆会与现实冲突。

6. 对话状态（Engagement State）

对话状态是一个小结构，决定这次会话激活哪些记忆和技能：

{ "domain": "work", "project": "tfhs", "interlocutor": "haisu",
  "activity": "progress_review", "since": "2026-10-13T23:00+08:00" }

• 识别：分三级，前一级能确定就不走后一级。

  1. 显式切换：Haisu 说"聊点私事"或执行 state personal。
  2. 入口规则：从哪个仓库、哪个 Task、哪个对话入口进入，多数工作会话据此即可确定，不调用模型。
  3. 模型判断：只处理前两级判断不了的会话。采用判断类模型：只做判断，返回类型化的决策和校准过的置信度，由调用方设定阈值，高于阈值自动采用、低于阈值转为询问。Haisu 提出的 Jev（TypeSafe AI 的 System One 模型，typesafe.ai，2026-10-14 查阅）是这类模型的代表，可以换成同类模型；它和 Engine 一样是可替换的绑定。对话状态正好是"从几个固定选项里选一个"的问题，适合这种模型；置信度低时直接问 Haisu，不靠猜。备选是让成员当前的 engine 在会话开头通过回调接口自己申报（不需要额外模型）。
     • 判断模型走云端 API 是正常用法（Haisu 裁定，2026-10-14）：本地优先指成员状态与资产由 Haisu 本机持有，不排斥调用云端模型，Viva 调用 DeepSeek 等也是走 API。

  推断结果展示给 Haisu，可以纠正，纠正本身也留痕。

• 作用：对召回、技能挂载、表达方式做过滤。只能收窄，不能放宽 ADR-0010 的可见性边界：个人记忆依然不会进入其他成员的任务；工作状态下不召回 personal 域的条目。

• 留痕：状态切换记为一条 experience，使成员能回答"我们上次聊到哪了"。

• 与 Workspace 的区别：Workspace 是空间轴上的长期工作语境；对话状态是一次会话里"现在在谈什么"。两者正交。

7. 分层进化

参考 Hermes 的学习闭环（复杂任务完成后生成技能，并在后续使用中改进技能；见 Research-Hermes），作为设计借鉴，不是依赖（ADR-0005 选项 3）。分三层，速度与审核力度各不相同：

层	产物	触发	晋升 / 审核
记忆	knowledge 条目	每次会话后的策展候选	准入门 + provenance；可撤回
技能	团队技能（SKILL.md），加入总结出它的成员的技能集	多步骤任务成功完成，或同类任务反复出现	没有转正环节，只有权重：被使用则加权，长时间不用则降权，低于阈值即遗忘（见下）
原则	成员的 principle 条目	定期反思：从多条 experience 总结规律（例如"多轮开发-测试往返通常意味着需求不清"）	必须由 Haisu 批准；协调成员每周汇总候选，在 Viva 内审批（见 §7.2）；永不自动晋升

7.1 技能的权重与遗忘

方向由 Haisu 于 2026-10-14 裁定（ADR-0013 Decision 6）；具体规则经 Multica TFHS-49 讨论，Haisu 同日逐条裁定。参考了 Hermes Curator、SkillForge、PraisonAI、SLIM、MemoryBank、MemoryOS 的做法，以及"技能库扩大后选择准确率下降主要来自相似技能互相抢占"的研究结论。参数均为配置项，下列为初始值，先按此运行，再按真实数据调整。

目的与范围：成员携带的技能过多时，模型难以准确判断该用哪个。权重是每个成员各自的：同一个团队技能，Samuel 常用、权重高，Alice 很少用、权重低。

1. 什么算一次使用

事件	来源	计入权重
投影：技能出现在会话的技能列表里	Viva 投影时记录	不计，只作观测（否则"被装进会话"会自我强化）
读取：成员在一次 Execution 中打开技能正文	回调 viva skill get，或从回收的会话记录识别 harness 的技能调用	计，写一条 used_in（技能、成员、Execution）
结果：该 Execution 的结束状态	Execution 记录	决定分值：成功 1.0，失败或中断 0.25
纠正：Haisu 标记"这次用错了 / 技能有问题"	手动	该次记 0，技能列入复审

不让成员自评"技能是否帮上忙"：模型自评不可靠，也不符合 Core-Thesis 诚实约束。

2. 权重：状态值 + 每个技能一条衰减轨道

• 每个（成员，技能）有一条权重状态记录，保存当前权重、所属衰减轨道和最近更新点（成员会话序号或时间）。每次使用事件结束后先把权重衰减到当前，再加上本次分值；选取与判断时读取当前值（按距上次更新的会话数或天数做一次衰减，O(1)），不扫描使用事件。
• 使用事件照常只追加（Domain-Model 不变量 I2），是权重的依据；状态值可以从事件重建，用于审计和修复。
• 衰减轨道有两种，每个技能只按其中一种衰减，不会两条同时生效（Haisu 2026-10-14）：
  • 会话轨：按该成员自己的会话数衰减，半衰期 30 次会话。成员不工作时不衰减。适合随工作量出现的技能。
  • 时间轨：按自然时间衰减，半衰期 60 天。适合按周期使用、与会话数无关的技能，例如每月用一次的计算工资技能：中间穿插再多会话也不影响，但连续两个月没用，就开始衰减。
• 一个技能该走哪条轨道，判断标准尚未确定，可能作为一条 principle，另行讨论（Open-Questions 第 16 条）。在定下之前，技能默认走会话轨，Haisu 可以为单个技能指定时间轨。
• 不设上限：衰减本身把常用技能的权重稳定在一个高位。

3. 遗忘

满足任一条件即遗忘，追加一条 forgotten 事件：

• 阈值：当前权重 < 0.1，且按所属轨道已有足够长的时间没用（会话轨 ≥ 20 次会话，时间轨 ≥ 60 天）。不用的证据要足够，才算没用。
• 容量：技能集超过 30 个时，从当前权重最低的开始遗忘。

豁免：

• 本命技能：写入该成员 soul.md 的技能不可被遗忘，也不占 30 个的名额。soul.md 是成员 identity 的一部分（规范层："我选择成为什么"），只由 Haisu 显式修改；它不是 Hermes 式把整个人格压成一份的静态档案，self-model 仍按假设制独立存放（见 Research-Self-Model-Relationship）。成员是否需要某个本命技能，由 Haisu 决定，不由使用频次决定。
• 新技能保护期：技能新加入成员技能集（自己总结的、自己领取的或同步来的）后，该成员的前 10 次会话内不被遗忘；初始记一次 1.0 的使用。
• 首次启用：现有技能都视为刚加入，保护期从启用时算起；前一个月只试运行，报告"若启用会遗忘哪些"，不实际执行。

遗忘不物理删除：技能退出该成员的技能集，不再被投影，也不在该成员自己的技能集搜索里出现；它仍在团队技能库中，使用历史可查。

4. 权重的用法

• 每次会话最多投影 10 个技能：先按对话状态过滤，再按与本次任务的相关性排序，权重作为第二排序键（不以权重为主，避免老技能一直挤掉新技能）。
• 技能集里没被投影的技能，成员在会话中可以通过回调 viva skill search 搜到并使用。没投影不等于不可用。
• 排序与遗忘读的是同一个当前权重，不维护两套计数。

5. 找回与领取：交给成员自己判断

• 成员在会话中可以搜索整个团队技能库，需要什么就领取什么，不需要 Haisu 批准：被遗忘的技能使用后回到技能集，从未拥有的技能使用后加入技能集（相当于成员自助完成技能同步，按新技能处理）。每次领取或找回都追加事件，并写进协调成员的周报。
• Haisu 也可以手动找回或加入：viva skill restore <成员> <技能>。
• 找回后不需要特殊的起算规则：旧事件早已衰减，本次使用按正常分值计入。

6. 重叠检测

技能加入成员技能集时，与该成员现有技能比较相似度；超过阈值的写进周报，建议合并。合并结果作为新的团队技能保存，记录 derived_from。只提示，不自动合并。

7. 运行方式

使用事件结束时更新权重状态；遗忘检查在成员会话结束时进行，确定性计算，不调用 LLM。遗忘、找回、领取与合并建议每周汇总进协调成员的报告。

7.2 原则候选的审批

• 候选由定期反思产生。协调成员（Samuel）每周汇总一次，形成审批清单，每条附依据（来自哪些 experience / 执行）。
• 审批入口放在 Viva 内（Haisu 裁定，2026-10-14）：先用 viva CLI，Workbench 具备后再加界面。不放在 Multica：Multica 面向多人、多设备、多 agent 协作，Viva 是 Haisu 一个人、多设备、多 agent 的协作系统，成员资产与审批应在同一处。
• Haisu 逐条批准、驳回或修改。驳回保留理由，同样的候选不再反复提出；超过 4 周未审的候选自动过期，不生效。

共同纪律：

• 每次进化（新技能、技能修改、原则变更）都留版本记录，附依据（来自哪些 experience / 执行）。效果变差可以回滚。
• Core-Thesis 诚实约束不变：没有使用记录不叫"已复用"，未经批准的原则不叫"学到了"；未实现的进化能力不出现在 UI 与文案中。
• self_model_candidate 的规则不变（只记录、永不自动晋升）。principle 是规范层的工作原则（"我应该怎么做事"），不是关于成员自身的假设，两者分开存放。

8. 多成员：隔离与技能同步

• 技能归属团队，技能集属于成员（Haisu 裁定，2026-10-14："所有成员的技能都是团队的"）。ADR-0010 的 skill 归属团队不变；每个成员有自己的技能集——携带哪些团队技能、各自权重多少——成员之间互相独立。
• 隔离：每个成员的记忆、原则、技能集和会话互相独立；成员回调接口按调用方的执行归属只开放该成员的数据（与 grant 校验同一入口）。
• 共享层：project_knowledge、team_knowledge 与团队技能库的规则不变。
• 技能同步（Neo 式下载）：把一个团队技能加入另一个成员的技能集并给一个初始权重，例如把 Deven 常用的 PR 审查技能加给 Alice。技能本来就是团队的，所以同步不需要复制。若需要按目标成员的工具环境改写（Alice 的测试工具与 Deven 不同），改写结果作为新的团队技能保存，记录来源（derived_from）。之后按 §7 的使用情况加权或遗忘。
• 记忆不直接复制：经验要在成员间传递时，先提炼成技能或 team_knowledge 再共享，不拷贝别人的个人记忆和会话。

9. 协调成员作为中枢（Samuel 场景）

目标体验：Haisu 打开 Viva 问 Samuel"昨晚工作进度如何"，Samuel 回答哪些 issue 在等合并、哪些被 block 需要人工介入、哪些经历了多轮开发-测试；Haisu 修正策略后，Samuel 修订文档与 issue，并协调 Deven / Alice / Oliver / Victor。

拆解：

1. 对话状态切到 work / progress_review；
2. 实时查询：通过 Viva 的 Task / Execution 记录与 GitHub 连接器取得等待合并、blocked、多轮往返（按评论轮次或状态反复变化判断）的项；
3. 记忆补充：召回之前定下的策略与决定，解释某个 issue 为什么卡住；
4. 执行修正：Haisu 给出新方向后，Samuel 把决定写成 knowledge 条目；需要别人执行时，在 Haisu 授予的 grant 范围内派发（ADR-0007，子 grant 不得放大）。

issue 系统是成员之间的共享黑板，不另造任务系统；成员之间的直接消息只用于协商，结论落回 Task / issue。

GitHub 登录态不属于容器（Haisu 裁定，2026-10-14）：Samuel 能否修订 GitHub issue / PR，取决于它运行的环境是否有 gh 登录态。这是运行环境的凭据，不是容器管理的资产，容器既不保管也不发放。拿不到登录态时，相关工作就是受阻，如实报告，不绕过。merge / approve / push 保护分支仍只属于 owner（Domain-Model 不变量 I4）。

10. 实现路线

与 Roadmap 里程碑的对应关系（随 Roadmap 于 2026-10-14 一并接受，viva#100；各阶段均未实现）。实现跟踪：viva#113，子 issue #114–#121。

阶段	内容	退出证据	对应里程碑
C0 投影	成员 identity 说明文件；把 identity、精选知识与技能渲染进 Pi 与至少一个第二 harness 的指令文件与技能目录	同一成员在两个 harness 中表现出一致的职责与约束	M2
C1 回收	Claude Code、Codex 会话适配器；experience 归档；会话归类导入与按成员汇总的会话入口；策展候选；FTS 召回	一次真实会话的结论能在下一次另一 harness 的会话中被召回并有 usage 记录	M2
C2 成员回调接口	recall / remember / state / skill 四类调用，用现有 viva CLI 提供（见 §3.1）；MCP 在遇到没有 shell 的入口时再加	两个 harness 通过同一接口读写同一成员的资产，越权调用被拒绝并留痕	M2
C3 状态与反思	对话状态识别与过滤；定期反思总结技能与原则候选；技能权重与遗忘	工作状态下零个人条目召回；原则候选经 Haisu 批准后生效；长期未用的技能退出技能集	M2 / 研究线
C4 多成员与技能同步	成员技能集、技能同步与改写；协调成员晨报流程	一个团队技能加入成员 B 的技能集后，在 B 的真实任务中被使用	M3

每个阶段都沿用 Core-Thesis 的进度定义：以真实证据衡量，不以功能数量衡量。

11. 风险与对策

风险	对策
记忆污染：错误结论写入后被反复召回	保留溯源与可信度；支持撤回与取代；冲突时同时展示来源与时间，不融合成模糊摘要
进化漂移：技能或原则越改越偏	原则必须人工批准；所有变更可回滚
技能过多：成员选不准该用哪个技能	每个成员的技能按使用加权、按所属轨道（会话数或自然时间）降权，低于阈值或超出容量即遗忘；每次会话最多投影 10 个；相似技能提示合并（§7.1）
成本	策展与反思用便宜模型批处理，不在每轮对话中调用；成本按 Research-Agent-Memory-Architecture §6 的方法记录后估算
隐私	会话归属参与它的成员，其他成员看不到；personal 域不进入团队共享层，工作状态下不召回；回收的会话记录先脱敏再落盘
与现实冲突	动态事实一律实时查询，不从记忆中读取

相关页面

ADR-0013 · ADR-0010 · ADR-0012 · Domain-Model · Temporal-Model · Research-Agent-Memory-Architecture · Research-Hermes · Open-Questions · Roadmap