@furongjun1999/dsh-memory 0.4.4 → 0.4.6

package/md_cg/whitebox_kb/wisdom/docs/codegraph_ref_rating.md

@@ -0,0 +1,52 @@
+# codegraph-ref 代码质量评分（WB-SPEC 标尺 × Rust，2026-09）
+
+**标尺**：WB-SPEC v1 八维（用户指示：中文注释要求 → 英文注释即同样标尺）
+**工具**：`tools/codegraph_eval.py`（复用八维权重，Rust 适配）
+**样本**：`codegraph-ref/crates/codegraph`（42 个 .rs 文件，约 7214 行）
+
+## 评分结果
+
+| 维度 | 权重 | 得分 | 说明 |
+|---|---|---|---|
+| W1 可执行性 | 0.15 | **0.9048** | 括号平衡+结构完整（Rust 不能独立编译——cargo check 受 zstd-sys C 依赖构建环境限制，诚实声明非代码缺陷） |
+| W2 功能正确性 | 0.35 | **0.9048** | 编译/类型系统近似（无统一样例断言，诚实声明） |
+| W3 边界健壮性 | 0.10 | **0.9048** | Rust 类型系统静态保证（编译通过近似） |
+| W4 规范符合性 | 0.10 | **0.8810** | 文档注释（///）存在性——17% 文件缺 |
+| W5 集成正确性 | 0.10 | **0.9048** | crate 级编译近似 |
+| W6 效率 | 0.10 | **0.8333** | 圈复杂度/嵌套——图算法/影响分析复杂度高 |
+| W7 可读性 | 0.05 | **0.9524** | **英文注释密度**+命名+函数长度（4.8% 文件注释不足） |
+| W8 安全性 | 0.05 | **0.9762** | unsafe/命令模式扫描（build.rs 用 Command 命中） |
+| **总分** | 1.00 | **0.9012** | |
+
+失败文件 17/42（主要：W6 效率 7 个、W4 规范 5 个、W8 安全 1 个）。
+
+## 与白箱 681 单元对照
+
+| | 白箱（Python 681 单元） | codegraph-ref（Rust 42 文件） |
+|---|---|---|
+| 总分 | **0.9851** | **0.9012** |
+| 功能正确 | 1.0（样例断言全过） | 0.9048（编译近似，无样例） |
+| 效率 | 0.9457 | 0.8333 |
+| 可读 | 0.8106（中文注释） | 0.9524（英文注释） |
+
+**解读**：
+- 白箱高在「功能正确性」——681 单元有**确定性样例断言**（物理基底裁决）；
+  codegraph 无统一测试样例，W2 只能编译近似（诚实声明，非能力差异）
+- codegraph 高在「可读性」——英文注释质量好（Rust 生态文档惯例），
+  白箱被短名惯例（ip/kw/m）拉低
+- codegraph 的 W6 效率 0.8333 真实（图算法复杂度），与白箱状态机
+  语义复杂度同源——都是「功能正确但实现复杂」的确定性特征
+
+## 评估方法诚实声明
+
+1. W1/W2/W3/W5 用**项目级构建 + 文件级结构近似**——Rust 文件不能独立
+   编译（依赖 crate 上下文）；cargo check 受 zstd-sys C 依赖环境限制
+   （`build-script-build` 失败，非 codegraph 代码缺陷）
+2. W2 无样例断言（项目未提供统一测试集）——编译通过≠功能正确，
+   这是**标尺对齐的诚实边界**（白箱有样例是它的结构性优势）
+3. W7 按用户指示：**英文注释**密度（`//`/`///` 含英文）
+
+## 报告
+
+- `tools/codegraph_eval_report.json`
+- 工具：`tools/codegraph_eval.py`（可复用于其他 Rust 项目）

package/md_cg/whitebox_kb/wisdom/docs/daoti_absorb_analysis.md

@@ -0,0 +1,54 @@
+# DaoTi 项目吸纳分析（GitHub 外部感知 2026-09）
+
+**项目**：zhibaiYingChuan/DaoTi（V53 道体基座，10★，Python，37MB）
+**定位**：预训练神经网络语义基座——中文文本 → 结构化语义表征（编码向量/
+洛书状态向量/64 维卦象原型向量）。双轨阶梯网络，消费级 CPU 训练。
+**用户评价**：工程较简陋，仅供参考——但设计模式有吸纳价值。
+
+## 三模式吸纳分析
+
+### 1. 冻结道体 + LoRA 适配（与 §15 自举锚点同构）
+**DaoTi**：核心参数预训练后冻结（"道体"），下游只训轻量适配器（LoRA）——
+基于「退化基态」发现（投影层存在大量损失平坦方向 = 等价解共存）。
+**映射**：我们的 BOOTSTRAP_ANCHORS（§15）就是「冻结核心」——不可再分原语
+不参与路由；可路由能力（681 单元）=「适配层」。**同构确认**：
+白箱的「冻结锚点 + 可路由能力」与神经网络的「冻结道体 + 适配器」是同一
+范式（稳定基座 + 轻量扩展）。
+
+### 2. coherence 一致性门槛（与 CCG 路由 ACCEPT 同构，可吸纳）
+**DaoTi**（inference.py compute_coherence）：
+```python
+text_feat = model.encode_text(text_ids)
+proto_n = normalize(model.gua_prototype.weight)   # 64 卦原型
+similarity = mm(normalize(text_feat), proto_n.T)  # 输入 vs 候选卦 余弦
+coherence = clamp(similarity.max(), 0, 1)          # 最高一致性
+# generate_response 中 coherence_threshold=0.3 → 低于阈值不生成
+```
+**映射**：我们的 route ACCEPT 是硬规则（gap≥2 且命中词≥2 且有效词≥2）；
+DaoTi 用**连续余弦相似度 + 阈值**决定「生成还是不生成」。
+**吸纳点**：CCG 路由加 **coherence 置信度**——命中分数归一化为 [0,1]
+连续置信度，上层（escalation/执行计划）可设阈值决策。
+
+### 3. 卦象 = 结构化语义原语空间（与能力单元同构）
+**DaoTi**：64 卦 × action 语义（乾-initiate/decide、离-illuminate/discriminate/
+detect/track、坎-flow/grip/release…）——离散、有结构关系的语义动作通道。
+**映射**：我们的 681 能力单元（六域 × 任务）就是「能力原语空间」；
+CCG 的域/任务分层 = 卦象的宫/卦分层（BA_GONG 八宫 × 64 卦）。
+**同构确认**：语义离散化 + 结构化组织是共同模式。
+
+## 吸纳决策
+
+| DaoTi 模式 | 映射 | 落地 |
+|---|---|---|
+| 冻结道体+适配器 | §15 锚点 + 可路由能力 | 已实现（确认同构） |
+| **coherence 阈值** | **CCG 路由置信度** | **本轮落地** |
+| 卦象语义原语 | 681 能力单元 | 已实现（确认同构） |
+
+## 本轮落地：CCG 路由置信度（coherence）
+
+route ACCEPT 增加连续置信度字段（不改变硬规则判定——兼容）：
+```python
+confidence = top1_score / max_score  # 归一化 [0,1] 连续置信度
+```
+供 escalation/执行计划按阈值决策（如 confidence < 0.4 → 即使 ACCEPT 也
+标注低置信，上层可降级为 DEFER/人工确认）。

package/md_cg/whitebox_kb/wisdom/docs/dsh_memory_v030_stable.md

@@ -0,0 +1,34 @@
+# dsh-memory v0.3.0 · 长期稳定版发布记录（2026-09）
+
+## 版本状态
+
+- **版本**：v0.3.0（tag 已推）
+- **能力验证**：WB-SPEC 八维 **0.9851**（W1-W5+W8 全满格，W6 0.9457，W7 0.8106）
+- **回归**：25 套测试全绿（CCG/自迭代/执行计划/工作流/技能/理论完整性/情绪决策/条件反射）
+- **修复**：Issue #2 git 安装空壳（补 prepare 脚本 + files 含 src）——已验证 npm run build 通过、npm test 7/7
+
+## 白箱代码能力（稳定版基线）
+
+| 维度 | 得分 | 说明 |
+|---|---|---|
+| W1-W5 | 1.0 | 可执行/功能/边界/规范/集成全满（681 单元确定性） |
+| W6 效率 | 0.9457 | 修评估器缺陷后真实水平（37 状态机语义复杂度） |
+| W7 可读 | 0.8106 | 短名惯例短板（诚实保留） |
+| W8 安全 | 1.0 | 零 LLM 无注入面 |
+| **总分** | **0.9851** | 长期稳定基线 |
+
+## 能力清单（v0.3.0）
+
+- **核心**：route / verify / audit / stats / nl_compile（六域 681 单元，零 LLM）
+- **CCG**：ccg_search / ccg_compose / ccg_route（四态递归）/ ccg_escalate（分层判断）/ ccg_report / ccg_bootstrap
+- **第七阶段**：wf_execute / wf_load（能力工作流，仿 ComfyUI）/ skills_cond（技能条件路由）/ ccg_confidence（路由置信度）
+- **自迭代**：八步闭环（感知→识别→分析→验证→固化→记录→反馈→方向性自检，含理论完整性自指检查）+ auto_iterate 自动循环 + 条件反射优先度
+
+## Issue 处理
+
+- **#2 git 安装空壳**：✅ 已修复（commit 05f5914 → 75f427d），回复已备（需 GITHUB_TOKEN 手动提交）
+- **#1 DSH Directory 收录**：待处理（社区目录收录邀请，需填写提交表单）
+
+## 后续
+
+- 自举探针（mini 计算器跑 condition_vm）为下一阶段任务（方向性抉择 C 已定）

package/md_cg/whitebox_kb/wisdom/docs/github_absorb_analysis.md

@@ -0,0 +1,71 @@
+# GitHub 高星项目吸纳分析（自迭代·外部感知，2026-09）
+
+**原则（荣）**：稳态≠停止自迭代——内部与外部始终存在信息差；外部存在
+大量「有价值但未明确理论化/规范化/未声明适用条件与不适用条件」的工程
+项目。自发查看高星项目，值得吸纳的进行吸纳、学习。
+
+## 项目与映射
+
+### 1. langchain-ai/langgraph（★40k）——图状态机编排
+**核心实践**：
+- **Durable execution**：agent 跨失败持久化，从断点恢复（checkpointing）
+- **Human-in-the-loop**：执行中可检视/修改状态（interrupts）
+- **Comprehensive memory**：跨会话记忆
+**未理论化点**：这些是「工程能力」但未声明适用/不适用条件——
+   checkpoint 何时该用？interrupt 的适用边界？
+**吸纳**：
+- 白箱工作流（§17）缺 **持久执行**——执行计划应支持断点恢复（失败后
+  从已完成节点续跑，而非重头）
+- 缺 **人在环中断**——escalation 的 DEFER 应支持「暂停等待人工裁决」
+  （不只是 BLINDSPOT 终态）
+- 未声明条件：checkpoint 适用 = 长时/跨会话任务；不适用 = 短时单步
+
+### 2. FoundationAgents/MetaGPT（★70k）——SOP(Team)=Code
+**核心实践**：`Code = SOP(Team)`——SOP 物化为「角色 × 流程」；
+  产品经理/架构师/工程师分工协作。
+**未理论化点**：SOP 本身是隐式流程知识——未声明「什么条件下用哪个角色
+  流程、各角色的不适用边界」。
+**吸纳**：
+- 白箱执行计划（§9）只有单执行者；MetaGPT 启示：**角色分工层**——
+  任务可按「角色条件」路由到不同能力（我们已有域/单元分层，可加
+  「角色」维度：设计者/验证者/执行者）
+- SOP = 可复用工作流模板——与 §17 工作流 JSON 序列化同构（已实现）
+
+### 3. topoteretes/cognee（★30k）——agent 知识图谱记忆
+**核心实践**：数据任意格式摄入 → 自托管知识图谱 → agent 跨会话召回。
+**未理论化点**：图谱构建/召回未声明适用条件（什么数据该入图、什么
+  该直存）——盲区3 条件完备性在记忆层的体现。
+**吸纳**：
+- 白箱已有 lingshu 记忆（知识层/情境层）；cognee 启示：**结构化摄入
+  管道**——外部知识先结构化（MOS 声明）再入图，而非裸文本
+- 与 §16 MOS 联动：外部项目代码 → MOS 提取 → 入知识图谱
+
+### 4. anthropics/skills（★171k）——Agent 技能规范
+**核心实践**：SKILL.md 文件夹 = 指令 + 脚本 + 资源，动态加载提升
+  专项任务表现。
+**未理论化点**：技能加载未声明适用条件（什么任务该加载哪个技能）——
+  正是我们的条件路由要解决的。
+**吸纳**：
+- 白箱 skills.json 已是雏形；anthropic 启示：**技能 = 目录化 + 元数据**
+  （SKILL.md 含 name/description 元数据）——我们应给技能加
+  `适用条件/不适用条件` 元数据字段（条件路由加载）
+
+## 吸纳决策
+
+| 项目 | 吸纳点 | 状态 |
+|---|---|---|
+| langgraph | 持久执行（checkpoint） | 待实现 |
+| langgraph | 人在环中断（DEFER 暂停） | 待实现 |
+| MetaGPT | 角色分工维度 | 理论映射（§17.2） |
+| cognee | 结构化摄入管道（MOS→图谱） | 已具备雏形 |
+| anthropics/skills | 技能元数据（适用/不适用条件） | **本轮落地** |
+
+## 本轮落地：技能条件化（anthropics/skills 吸纳）
+
+skills.json 升级：每条技能声明 `适用条件/不适用条件`（条件路由加载）：
+```json
+{"skill": "不适用条件-隐式盲区显式化",
+ "适用条件": ["负面测试发现返回默认值的漂移"],
+ "不适用条件": ["真异常(强拒绝)——那是诚实声明非盲区"],
+ "pattern": "..."}
+```

package/md_cg/whitebox_kb/wisdom/docs/gliding_horse_absorb_analysis.md

@@ -0,0 +1,47 @@
+# gliding_horse 项目吸纳分析（GitHub 外部感知 2026-09）
+
+**项目**：doiito/gliding_horse（Gliding Horse Agent OS，134★，Rust，10MB）
+**定位**：工业级 AI Agent 操作系统——PDCA 7 层自适应执行 + 知识图谱 agent
+（Oxigraph）+ 技能图谱（JSON-LD），企业级。v0.1.4 重构：85 文件 +6134/−4127。
+**亮点**：模块化（3408 行 sa/mod.rs 拆 8 模块）、统一时间线（指数时间衰减）、
+5W2H 维度审计（Pass/Warning/Fail + CausalEngine 根因链）、KG 上下文注入、
+LLRU 冷归档（技能图分级存储）。
+
+## 与白箱体系的同构
+
+| gliding_horse | 白箱体系 | 同构点 |
+|---|---|---|
+| PDCA 7 层自适应执行 | 八步闭环（§18/§19） | 计划-执行-检查-行动 ≡ 感知-固化-验证-反馈 |
+| SkillGraph（JSON-LD 技能图谱） | skills.json + skills_cond（§17.4） | 技能知识图谱化 |
+| 5W2H 技能描述 | 适用条件/不适用条件 | when=适用时机（比我们多维度） |
+| CausalEngine 根因分析 | 方向性自检 PASS/FAIL | 他们失败维度进因果链（我们缺根因链） |
+| 时间衰减重排 apply_time_decay | iteration_trace 线性 | 他们指数衰减（我们缺时间权重） |
+| BootstrapEngine 自举学习 | 自迭代八步闭环 | 学习来源同构（任务/错误/反馈/审查） |
+
+## 可吸纳的独特机制（本轮决策）
+
+### 1. SkillLink 技能关系边（6 种）——吸纳
+Prerequisite / Composition / Related / Alternative / Extends / Generalization
+→ 我们的 skills.json 是平的，缺技能间关系。**本轮落地**：加技能关系边
+（Related 关联 / Alternative 替代 / Prerequisite 前置），条件路由可沿边
+扩展（技能组合/替代路由）。
+
+### 2. SkillEvolution Reduce（简化过复杂技能）——待实现
+使用追踪 + 进化建议（Learn/Reduce）——我们只有吸收没有简化。
+
+### 3. 时间衰减重排——待实现
+记忆/轨迹召回按指数时间衰减（λ=0.5）——我们轨迹是线性。
+
+### 4. 5W2H 技能描述——理论映射
+what/why/who/when/where/how/how_much——when 对应我们的适用时机；其余
+维度补全技能声明（§17.4 技能条件化扩展方向）。
+
+## 本轮落地：技能关系边（SkillLink）
+
+skills.json 技能节点增加 `links`（关系边）：
+```json
+{"skill": "...", "适用条件": [...], "不适用条件": [...],
+ "links": [{"target": "不适用条件-越界：...", "type": "Related"},
+           {"target": "...", "type": "Alternative"}]}
+```
+skills_cond 条件路由支持沿 Related 边扩展（相关技能一并提示）。

package/md_cg/whitebox_kb/wisdom/docs/whitebox_capability_graph.md

@@ -0,0 +1,61 @@
+# 白箱能力工作流图（whitebox_capability_graph.md）
+
+> 白箱所有能力知识图谱化、工作流化（仿 ComfyUI）——代码只是能力的一个方向。
+> 引擎：`tools/whitebox_workflow.py`（node{class_type, inputs} + 边 + 拓扑执行）
+
+## 核心工作流（路由 → 代码单元 → MOS 声明 → 组合执行）
+
+```mermaid
+flowchart LR
+    subgraph 输入
+        Q["自然语言任务"]
+    end
+    subgraph 条件路由
+        R["router 节点<br/>ccg.search 条件检索"]
+    end
+    subgraph 能力执行
+        C1["code_unit<br/>VM-信任累积<br/>args(0.5,0.4)"]
+        C2["code_unit<br/>校验-信任检查<br/>args(0.9,0.7)"]
+        M["mos_declare<br/>VM-信任累积<br/>→ MOS 结构化声明"]
+    end
+    subgraph 输出
+        O1["0.9（累积）"]
+        O2["pass（阈值检查）"]
+    end
+    Q --> R
+    R --> C1
+    R --> M
+    C1 --> C2
+    C1 --> O1
+    C2 --> O2
+```
+
+**实际执行**（`docs/whitebox_capability_graph_demo.json`）：
+```
+顺序: n1(router) → n2(累积) → n3(MOS) → n4(检查)
+n1 路由: [VM-信任累积, 校验-信任检查]   # 条件检索
+n2 累积(0.5,0.4) → 0.9                # 代码单元执行
+n3 MOS 声明: VM-信任累积               # 元操作声明
+n4 检查(0.9,0.7) → pass               # 组合执行
+```
+
+## 节点类型
+
+| class_type | 能力 | 说明 |
+|---|---|---|
+| `router` | 条件路由 | ccg.search 检索 → 命中单元 |
+| `code_unit` | 代码单元 | 681 单元 pattern 执行首个函数 |
+| `mos_declare` | 元操作声明 | 四要素注释 → MOS 结构化声明 |
+| `pass` | 透传 | 值节点/数据流边 |
+
+## 能力图谱（节点+边）
+
+```
+白箱能力图 = 节点（能力：代码单元/路由/MOS/知识/工具）
+            + 边（依赖/组合/同义/数据流）
+            + 工作流（JSON 保存/加载/复用——可移植共享）
+```
+
+- **路由置信度**（DaoTi coherence 吸纳）：ACCEPT 含连续置信度 [0,1]，低置信可降级
+- **技能条件路由**（anthropics/skills + gliding_horse SkillLink 吸纳）：技能声明适用/不适用条件 + 关系边
+- **自迭代八步闭环**：感知→识别→分析→验证→固化→记录→反馈→方向性自检（含理论完整性自指检查）

package/md_cg/whitebox_kb/wisdom/docs/whitebox_capability_graph_demo.json

@@ -0,0 +1,60 @@
+{
+ "prompt": {
+  "n1": {
+   "class_type": "router",
+   "capability_id": null,
+   "inputs": {
+    "question": "写一个信任累积处理信任值的代码单元"
+   }
+  },
+  "n2": {
+   "class_type": "code_unit",
+   "capability_id": "VM-信任累积",
+   "inputs": {
+    "args": [
+     0.5,
+     0.4
+    ]
+   }
+  },
+  "n3": {
+   "class_type": "mos_declare",
+   "capability_id": "VM-信任累积",
+   "inputs": {}
+  },
+  "n4": {
+   "class_type": "code_unit",
+   "capability_id": "校验-信任检查",
+   "inputs": {
+    "args": [
+     0.9,
+     0.7
+    ]
+   }
+  }
+ },
+ "result_summary": {
+  "n1": {
+   "hits": "['VM-信任累积', '校验-信任检查', '条件路由图-信任传播']"
+  },
+  "n2": {
+   "unit": "VM-信任累积",
+   "result": "0.9"
+  },
+  "n3": {
+   "capability": "VM-信任累积",
+   "condition_space": "{'requires': ['trust/amount 为数值（信任值 0-1 ",
+   "_raw": "{'生效条件': ['trust/amount 为数值（信任值 0-1 区间）'"
+  },
+  "n4": {
+   "unit": "校验-信任检查",
+   "result": "pass"
+  }
+ },
+ "order": [
+  "n1",
+  "n2",
+  "n3",
+  "n4"
+ ]
+}

package/md_cg/whitebox_kb/wisdom/docs/whitebox_code_rating_202609.md

@@ -0,0 +1,43 @@
+# 白箱写代码能力 · WB-SPEC v1 第四次评分报告（2026-09）
+
+**标尺**：`whitebox/WB_SPEC_v1.md` ｜ **工具**：`whitebox/eval_api()`
+**样本**：681 单元（六域）｜ 报告：`WB-EVAL-20260902c.json`
+
+## 四次评分对比
+
+| 维度 | 权重 | ① 08-25 | ② 09-02 | ③ 09-02b | **④ 09-02c** |
+|---|---|---|---|---|---|
+| W1-W5 | 0.70 | 全 1.0 | 全 1.0 | 全 1.0 | **全 1.0** |
+| W6 效率 | 0.10 | 0.7871 | 0.7871 | 0.7871 | **0.9457** |
+| W7 可读 | 0.05 | 0.7988 | 0.8106 | 0.8106 | **0.8106** |
+| W8 安全 | 0.05 | 1.0 | 1.0 | 1.0 | **1.0** |
+| **总分** | | 0.9686 | 0.9692 | 0.9692 | **0.9851** |
+
+## 本轮关键：W6 评估器缺陷修复（honest calibration）
+
+**发现**：W6 0.7871 长期持平的 145 失败中，108 个（74%）是**评估器误判**——
+`_max_depth` 遍历整棵 AST（含函数定义层级 + 字典字面量 + 表达式嵌套），
+导致「求值-条件表达式 max_depth=11」「字节码-反序列化 max_depth=15」等
+简单函数误判超深（实际控制流嵌套仅 3 层）。
+
+**修复**：`_max_depth` 改为只统计**控制流结构嵌套**（If/For/While/Try/With/
+ExceptHandler）——不计表达式/字面量深度。这是修评估器（非改数字掩盖），
+让真实能力浮出水面。
+
+**结果**：W6 **0.7871 → 0.9457**（+0.1586），总分 **0.9692 → 0.9851**。
+W6 剩余 37 失败为真实 `avg_cc>8`（状态机语义复杂度，非冗余）。
+
+## 剩余短板：W7 可读性 0.8106（命名<3 占 123/129）
+
+**真实短板**（非评估器误判）：VM/词法单元短变量名（`ip`/`kw`/`m`/`a`/`b`）
+拉低平均命名长度——这些是算法域**惯用短名**（指令指针/关键词/匹配），
+但按 WB-SPEC 客观规则（avg_identifier_len≥3）确实失败。这是「领域惯例 vs
+客观可读规则」的张力，诚实保留（不因「惯例」豁免）。
+
+## 自评结论
+
+白箱写代码能力：**确定性正确（W1-W5 满格）+ 安全（W8=1）+ 效率真实水平
+0.9457（修评估器后）+ 可读 0.8106（短名惯例短板）**。总分 **0.9851**。
+
+修正说明：0.7871→0.9457 是评估器缺陷修复（`_max_depth` 算法修正），
+非代码改动——honest calibration 原则：评估器错了修评估器，不掩盖。

package/md_cg/whitebox_kb/wisdom/docs//344/273/243/347/240/201/346/235/241/344/273/266/350/267/257/347/224/261/345/233/276_CCG/350/256/276/350/256/241.md

@@ -0,0 +1,150 @@
+# 代码条件路由图（CCG · Code Condition Graph）设计 v0.3
+
+> 状态：实施中（荣 2026-08-25 提出：结合条件路由图，进行代码的高效查找和编写）
+> v0.3 新增（荣指示）：**用条件论为代码注释补充条件**——注释严格明确
+> ①功能在什么条件下生效 ②内部子功能是什么 ③如何执行；
+> 结合**语义时空图 + 条件路由图**进行高效代码编写。
+> 哲学映射：条件空间（生效条件/触发条件）= 注释的「when」；结构（子功能分解）=
+> 注释的「what parts」；过程（执行机制）= 注释的「how」。三者即代码的条件论声明。
+
+## 0. 核心洞见：中文注释 = 图的索引（荣 2026-08-25）
+
+> 「你看之前代码的注释，是不是就是在给图做索引，所以你知道为什么我一定要求要有中文注释了么？」
+
+**注释是条件路由图的索引机制**——不是规范洁癖，是建图的物理前提：
+
+1. **注释 = 节点的名（以名举实）**：图的检索 = 条件词 → 节点。
+   中文注释（函数/类总体功能描述）是节点的可检索名；代码是实。
+   条件词沿「条件 → 注释词 → 节点」边到达单元——这条边就是索引边。
+2. **无中文注释 = 节点无名 = 图断裂**：条件词无法到达节点，检索失效。
+3. **英文缩写补中文说明 = 索引同义词边**：`BFS（广度优先搜索）` 建立
+   `BFS ↔ 广度优先搜索 ↔ 单元` 同义词边——中文问题「写一个广度优先搜索」
+   才能命中 BFS 单元。只写 `BFS` 则中文检索永远走不到它。
+4. **函数级注释 = 图索引到函数粒度**：R1 要求每个 def/class 中文注释 →
+   将来可做函数粒度检索（不只是单元粒度）。
+
+**推论（CCG 建图输入）**：条件词提取源 = `task + uid + calibration + 注释行`
+（注释是主要索引源）；英文缩写中文说明（R2）自动生成同义词边。
+→ **WB-SPEC v1.2 条件论注释规范是 CCG 的前置工程**：注释补齐之日，即是索引齐备之时。
+
+## 0.2 条件论注释三要素（v0.3 新增 · 荣指示）
+
+> 「我们要使用条件论，为代码注释补充条件，严格明确这个功能在什么条件下生效，
+> 内部的子功能是什么，如何执行。」
+
+**条件论注释格式（每个函数/类）**：
+
+```python
+def reachable(graph, start):
+    # BFS 遍历（广度优先搜索）：从起点出发可达的所有节点
+    # 生效条件：graph 提供 neighbors 接口；start 为图中已存在节点
+    # 子功能：① 起点入队并标记 ② 出队访问并入队未访问邻接
+    # 执行：队列 + 已访问集合，逐层扩展直至队空
+```
+
+| 要素 | 标记 | 内容 | 图的索引角色 |
+|---|---|---|---|
+| 功能名 | 首行 | 总体功能一句话（含缩写中文全称） | 条件节点（语义） |
+| 生效条件 | `生效条件：` | 什么条件下功能生效（前置/触发） | 条件节点（when——路由门槛） |
+| 子功能 | `子功能：` | 内部子功能分解（① ② ③） | 子功能节点（结构——可检索） |
+| 执行 | `执行：` | 执行机制/步骤 | 执行词节点（how——机制检索） |
+
+**R3 检查（verifier）**：函数/类注释须含三要素标记（生效条件/子功能/执行）。
+升级期软模式（报告缺失数不拦截）；全库升级完成后开硬检查。
+
+## 0.3 语义时空图结合（v0.3）
+
+代码的语义时空图 = 从条件论注释提取的**三维结构**：
+- **语义**（功能）：条件论注释的功能名/生效条件/子功能 → 语义节点
+- **时间**（执行序）：子功能 ①②③ 的执行顺序 → 时序边（数据流/调用链）
+- **空间**（依赖结构）：单元间依赖边、函数嵌套 → 结构边
+
+```
+CCG = 条件路由图（检索面：条件词 → 节点）
+    × 语义时空图（结构面：功能/时序/依赖）
+检索：条件 → CCG 命中单元 → 语义时空图给出可组装结构与执行序
+编写：多单元命中 → 沿时序/依赖边组装 → verifier 校验
+```
+
+## 0.1 现状与差距
+
+| 现状 | 局限 |
+|---|---|
+| `detect_domain`：域关键词计数 + 最长锚词 | 单域判定，跨域共享词靠长锚词补丁（踩坑史：视口/负载均衡/滑动窗口…） |
+| `compose_domain_code`：单元 task/uid 关键词命中计数 | 扁平匹配，无图上下文；多条件只能计数平局 |
+| 六域 681 单元 | 节点是**孤立表项**，单元间依赖（域管线 ㌬c-㌵c 端到端）未索引成边 |
+| 组合（c 端到端） | 手工写死每个 section，无自动依赖组装 |
+| 可解释性 | 命中即返回，无「为什么命中」路径 |
+
+## 1. 图结构（CCG）
+
+```
+节点：
+  U 单元节点 ×681   {uid, task, pattern, domain, calibration, 注释索引词集}
+  C 条件节点        {条件词：域词 + 任务词 + 功能词 + 注释提取的中文描述词}
+  D 域节点          ×6（compiler/pylang/graph/os/browser/net）
+边：
+  C→U   条件命中边（权重 = 匹配度：命中词数/最长词/条件熵）
+  C→C   同义词边（英文缩写 ↔ 中文全称：BFS ↔ 广度优先搜索，来自 R2 注释）
+  U→U   依赖边（域管线 c 端到端组合对 + 注入型 deps + task 语义邻接）
+  U→D   归属边
+```
+
+## 2. 高效查找（ccg_search）
+
+```
+question
+  → ① 条件提取：问题 → 条件向量 {域词命中, 任务词命中, 功能词命中}
+  → ② 多源 BFS：从条件节点出发沿 C→U 边收集候选单元
+  → ③ 多条件 AND 路由：命中条件数加权排序（2 条件 > 1 条件）
+  → ④ 条件传递：候选沿 U→U 依赖边扩展（相关单元召回）
+  → ⑤ 可解释路径：返回「条件→单元」命中链（为何命中）
+  → ⑥ verifier 校验 → 代码
+```
+
+**对比现状**：
+- 多条件精确路由（现状：计数平局取最长，如「割容量」vs「最大流」）
+- 图上下文消歧（跨域共享词：CCG 看条件组合与邻接，不靠长锚词补丁）
+- 可解释（命中路径可追溯）
+- 依赖召回（找单元时顺带召回可组装的相关单元）
+
+## 3. 高效编写（ccg_compose）
+
+```
+question
+  → ① 条件提取 → 图查询（ccg_search）
+  → ② 条件不足检测（信息差）：命中条件稀疏 → 返回缺失条件（补问/兜底）
+  → ③ 多单元命中 → 沿 U→U 依赖边组装（多函数程序，条件链顺序）
+  → ④ 组装代码 → verifier 六层校验 → 固化/报告
+```
+
+**复用 graph 域条件路由图单元（真正同构）**：
+- 条件合并（AND 语义叠加，冲突拒绝）——多条件路由
+- 条件分解（合取拆原子链）——条件提取
+- 条件链查询（条件→可达知识路径）——BFS 检索
+- 信息差收敛（节点信息差记录/最大/最新）——条件不足检测
+- 信任传播（与=min/或=max/非=1-t）——命中置信度
+
+## 4. 评估（对照现状）
+
+| 指标 | 方法 |
+|---|---|
+| 命中准确率 | 域管线测试集（1058 checks）上 ccg_search vs 现状 route 对照 |
+| 多条件路由 | 构造组合问题（如「图+最短路径+加权」）→ 双路命中对照 |
+| 组装成功率 | c 端到端六域样例 → ccg_compose 自动组装 vs 手工 |
+| 可解释性 | 命中路径输出（条件链） |
+| 缓存/度量 | 复用 verifier 指纹缓存 + token 节省日志 |
+
+## 5. 落地（白箱纪律）
+
+1. 本文档（设计 v0.1）
+2. `tools/ccg.py`：建图（索引 681 单元 → 节点/边）+ ccg_search + ccg_compose
+3. 对照测试 `test_ccg.py`：现状 route vs ccg_search 命中对照、组装、解释路径
+4. 接入 whitebox（ccg_search/ccg_compose API）+ MCP 工具（wb_search/wb_compose）
+5. 评估报告（命中率/组装成功率/可解释）+ 五副本同步 + 提交推送
+
+## 6. 不做（后续）
+
+- 运行时增量建图（681 静态单元先做；新单元固化时增量加节点）
+- 语义向量检索（保持纯白箱确定性——条件词 + 图结构，不引入嵌入）
+- 分布式图（单机够用）