CIE-Unified

HANDOFF.md

  1# HANDOFF — Branch B（claude-cli）开工文档
  2
  3> 分支：branch-b | 机器：mini ~/code/CIE-Unified | 2026-03-31
  4
  5---
  6
  7## 1. 分支定位
  8
  9**工程稳健增强 runtime**——先能跑、先能验证、先能出结果。允许过渡性结构，但不越过 LOCKED_IMPLEMENTATION_SPEC.md 的边界。
 10
 11---
 12
 13## 2. 共同起点
 14
 15| 文件 | 作用 | 状态 |
 16|------|------|------|
 17| README.md | 概念宪法——世界观、动力学主线、三核三层一带 | 三方锁定 |
 18| LOCKED_IMPLEMENTATION_SPEC.md | 施工合同——禁止项、接口、测试口径 | 三方锁定 |
 19
 20两个文件在 main 分支，branch-b 从 main 分叉，起点一致。
 21
 22---
 23
 24## 3. 必须实现的接口（SPEC §5）
 25
 26```python
 27class CIERuntime:
 28    def ingest(self, input, context=None, anchors=None): ...
 29    def step(self, n=1): ...
 30    def emit(self): ...
 31    def commit_feedback(self, feedback): ...
 32    def snapshot_state(self): ...
 33    def reset_session(self): ...
 34```
 35
 36---
 37
 38## 4. 必须通过的测试（SPEC §7）
 39
 40### Smoke tests
 411. 冷启动能否点火
 422. output-to-input 回灌是否真实存在
 433. 无任务时是否出现归巢
 444. 衰减/遗忘是否发生
 455. 任务切换时激活核是否迁移
 466. 资源不足时是否允许降级输出
 47
 48### Dynamics tests
 491. 局部稳定吸引子
 502. 闭环/技能通道
 513. 经验层沉积
 524. 技能带从经验层中出现
 535. 能力核慢更新
 546. 锚点纠正漂移
 55
 56---
 57
 58## 5. 核心状态
 59
 60```
 61(φ, μ, J)
 62φ(v) = 节点势场（慢变）
 63μ(v) = 激活分布（快变）
 64J(u,v) = 边流（中速）
 65```
 66
 67---
 68
 69## 6. 三核三层一带
 70
 71```
 72锚点核（恒星）     → 参照、边界、归巢
 73  └─ 能力层         → 各能力核的整体稳定分布
 74      └─ 能力核（行星） → 已内化能力团块
 75          └─ 经验层     → 近场可复用痕迹
 76              └─ 技能带  → 经验层内固化的高频通道
 77激活核（卫星）     → 当前任务工作体
 78记忆层（碎片带）   → 原始历史痕迹
 79```
 80
 81沉积路径：记忆层 → 经验层 → 技能带 → 能力核
 82
 83---
 84
 85## 7. 关键方程
 86
 87```
 88行动释放    u = o · c · φ(ε)
 89自适应衰减  α(x) = α₀ · (1 - c(x))^β · (1 / κ(x))
 90三级归巢    dx_A/dt = F_task + λ₁·(能力核 - x_A) + λ₂·(锚点核 - x_A)
 91图上扩散    φ_new(v) = φ(v) + μ · (L_G φ)(v)
 92锚点核定义  锚点核 = { x : α(x) < ε }
 93吸引度      attraction(x) = delta(x) · gap(x) · reach(x)
 94行动倾向    action_drive(x) = attraction(x) · free_capacity · (1 - cost(x)/risk_budget)
 95```
 96
 97---
 98
 99## 8. 开发计划
100
101### Phase 0：骨架
102- [ ] 图结构（节点、边、权重）
103- [ ] 三元组状态 (φ, μ, J) 的数据结构
104- [ ] CIERuntime 接口壳
105- [ ] 冷启动点火
106
107### Phase 1：流动
108- [ ] 图上扩散（L_G）
109- [ ] 激活传播
110- [ ] 行动释放 u = o·c·φ(ε)
111- [ ] 输出即输入回灌
112
113### Phase 2：归巢与衰减
114- [ ] 三级归巢力
115- [ ] 自适应衰减 α(x)
116- [ ] 锚点核自动浮出
117- [ ] 降级输出
118
119### Phase 3：沉积
120- [ ] 经验层沉积
121- [ ] 技能带检测
122- [ ] 能力核慢更新
123- [ ] sedimentation_trace 记录
124
125### Phase 4：验证
126- [ ] Smoke tests 全通
127- [ ] Dynamics tests 全通
128- [ ] snapshot_state 完整输出
129- [ ] 统一格式测试报告
130
131---
132
133## 9. 数据
134
135沿用 CIE v5 已有的数据集：
136- OCR 教科书语料（1217 条，一年级上册）
137- AsahiLuna/china-text-book-md（1759 个 markdown 文件）
138- 两个分支使用同一批数据，不各自找数据
139
140---
141
142## 10. 不做的事
143
144- 不迁移旧代码（cie-v5 / cie-original / cie-ref）
145- 不引入固定维度向量作为本体
146- 不用 exact_text_map 做推理
147- 不用 if/else 硬编码行为
148- 不抢跑 Branch A 的设计方向