跳到主要内容

Controllers

状态：Active / Controller 外部状态入口 最后更新：2026-05-13 用途：为 Labs-FinTecAI Admin、各产品 Program Controller、个人域 Agent 和团队域 Agent 提供可恢复、低上下文、可隔离的状态入口

1. 定位​

controllers/ 保存 Controller 的恢复状态，不保存正式产品事实。

正式事实源仍是：

  • baseline/
  • registry/
  • projects/
  • references/
  • evaluation/
  • packets/
  • governance/

Controller 状态只回答：

  • 我是谁；
  • 我负责什么；
  • 我不负责什么；
  • 当前做到哪里；
  • 新会话怎么继续；
  • 哪些 lane / checkpoint 待吸收。

2. 目录规则​

每个 Controller 使用同一结构：

controllers/<controller-id>/
  state.md
  lanes/<lane-id>.md
  checkpoints/<date>-<lane>-<topic>.md

当前仓库只预置 state.md。lanes/ 和 checkpoints/ 由真实协作需要按需创建，避免空目录和形式化维护。

3. 读取顺序​

新会话恢复时：

  1. 读本文；
  2. 读 registry.md；
  3. 读目标 Controller 的 state.md；
  4. 若属于某条 lane，再读对应 lanes/<lane-id>.md；
  5. 读取最新未吸收 checkpoint；
  6. 按 state.md 的 Recovery Instructions 继续。

4. 不冲突原则​

  • state.md 只由对应 Controller 或 Labs-FinTecAI Admin 吸收更新；
  • lane owner 只维护自己的 lane；
  • checkpoint append-only，作为回写建议和恢复证据；
  • 公共入口和发布闭环仍由 Labs-FinTecAI Admin 收束；
  • 变更范围必须遵守 governance/document-change-scope-policy.md。