CIE-Unified

commit

7d2f76f

parent

4c794d4

author

im_wower

date

2026-03-31 15:30:29 +0800 CST

branch-b: HANDOFF开工文档——骨架/流动/归巢/沉积四阶段计划

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