# docs/ 目录索引

> 按工程域分目录，与本仓 README「平台全景」五件套对应。新文档先归域、后登记到本页对应清单；跨域的横切件留顶层。改纪律真源路径前须核对引用面（AGENTS.md / 渲染管线 / md_cg 注释）。

## 目录结构

```
docs/
├── ops/       安装与运维（安装前置 / 写入凭据 / 升级重启 / FAQ）
├── dev/       开发与编码约定（测试约定 / 编码契约 / 开关矩阵）
├── mdcg/      灵枢大脑 md_cg 工程（架构/工具表/发布/教程/护栏）
├── swarm/     蜂群运行时 swarm/
├── hive/      蜂巢并发引擎 hive/
├── world_model/  世界模型神经网络底层架构（hex 系列台账）
├── theory/    智能论与白箱智能理论（跨工程）
├── eval/      评测与第三方验证报告
├── plans/     项目计划 / 交接文档 / 实验规格（跨工程）
├── discipline/  工作纪律渲染管线（模板 / harness 矩阵）
├── promo/     宣传物料
├── experiments/ 实验区（gitignored，可重跑再生产物）
└── 工作纪律_认知图条目_v1.1.json   ← 全局真源（横切面，不属单一工程）
```

## mdcg/ · 灵枢大脑 md_cg 工程

| 文档 | 内容 |
|---|---|
| [README 详细版](mdcg/README详细版_v0.4.10.md) | 完整能力说明 · 配置项全表 |
| [发布说明 v0.3.0](mdcg/release_v0.3.0.md) / [v0.4.5](mdcg/release_v0.4.5.md) / [v0.4.11](mdcg/release_v0.4.11.md) | 各版变更 / 升级指引 |
| [工具表 v0.3.0](mdcg/tool_table_v0.3.0.md) | MCP 工具清单 |
| [功能调用映射表 v0.1](mdcg/功能调用映射表_v0.1.md) | 功能 → 源码行号（管线生成，勿手写行号） |
| [灵枢 MCP 工具总表 v3.4](mdcg/灵枢MCP工具总表_v3.4.md) | 工具参数与调用规范 |
| [灵枢 82 工具迁移映射 v0.1](mdcg/灵枢82工具_功能整理与迁移映射_v0.1.md) | **历史**：82 属**旧 aeis 引擎**的工具面（非本仓 md_cg）；映射目标＝「保留 `cg`/`stg` 两个基元面，**不再注册** 82 个独立工具」 |
| [灵枢自我层定义](mdcg/灵枢_自我层定义.md) | 自我层行为规范（test_p16 行号级引用） |
| [三层拆分规划 v0.1](mdcg/灵枢三层拆分规划_v0.1.md) | 架构分层规划 |
| [记忆操作系统 MdCGOS 与 MCP 接入 v0.1](mdcg/记忆操作系统_MdCGOS与MCP接入_v0.1.md) | 核心架构设计 |
| [Recall 核心状态与来源信息](mdcg/recall_metadata.md) | Recall 返回 metadata 的字段来源、状态含义与兼容性 |
| [认知图 MD 目录方案 v0.1](mdcg/认知图_MD目录方案_v0.1.md) | 目录方案（test_p27 验收对象） |
| [认知图索引与工程规范化计划 v0.1](mdcg/认知图_索引与工程规范化_计划_v0.1.md) | 索引工程化 |
| [认知图条件空间合成与生效条件口径 v0.1](mdcg/认知图_条件空间合成与生效条件口径_v0.1.md) | 条件论口径 |
| [认知图 G4-G8 缺口裁定单 v0.1](mdcg/认知图_G4-G8缺口裁定单_v0.1.md) | 缺口裁决留痕 |
| [认知图作为记忆操作系统：评估与路线 v0.1](mdcg/认知图作为记忆操作系统_评估与路线_v0.1.md) | 路线图 |
| [单元自我锚点·系统提示词标准 v0.3](mdcg/单元自我锚点_系统提示词标准_v0.3.md) | 提示词锚点标准 |
| [缺口单 P0 收口 v0.1](mdcg/缺口单_P0收口_v0.1.md) | P0 缺口清单 |
| [源码级架构审计：GPT 批评对照 v1.0](mdcg/源码级架构审计_GPT批评对照_v1.0.md) | 外部审计取证 |
| [护栏宪章 v2.0](mdcg/guardrail-charter.md) | 对外部智能体与人类的行为边界 |
| [memory_score](mdcg/memory_score.html)（[png](mdcg/memory_score.png)） · [memory-assessment](mdcg/memory-assessment.html) · [教学教程](mdcg/lingshu_tutorial.html) | 评分 / 评估 / 教程 |
| [发布门禁链 v0.1](mdcg/发布门禁链_v0.1.md) | 三层门禁（pre-commit 自动重挂 / prepublishOnly check / CI 兜底）与安装 |
| [睡眠周期 · 运维前提与维护指南 v1.0](mdcg/睡眠周期_运维前提与维护指南_v1.0.md) | 睡眠周期的 git 前提 / 版本库位置 / 维护动作（看历史·看改动·只给 revert 的回退·冲突挂起）/ 开关与自动边界 |
| [D_meta 工程化方案 v0.2](mdcg/D_meta_工程化方案_v0.2.md) | D_task / D_meta 分离的工程化方案 |
| [代码评审与条件化注释 · 契约 v0.1](mdcg/代码评审与条件化注释_契约_v0.1.md) | 评审与条件化注释契约 |
| [全库代码评审与条件化注释 · 计划 v0.1](mdcg/全库代码评审与条件化注释_计划_v0.1.md) | 全库评审执行计划 |
| [灵枢记忆动词协议 v1.0（draft）](mdcg/灵枢记忆动词协议_v1.0-draft.md) | 记忆动词协议草案 |
| [环二 · 白箱填充流水线 v0.1](mdcg/环二_白箱填充流水线_v0.1.md) | 白箱填充流水线（测试阶段记录） |
| [跨端验证与同步协议 v0.1](mdcg/跨端验证与同步协议_v0.1.md) | 跨端验证与同步协议 |
| [记忆系统架构优化·交付层瓶颈理论与设计 v0.1](mdcg/记忆系统架构优化_交付层瓶颈理论与设计_v0.1.md) | 两篇论文（DeliverMem / GroundingPI）的统一原理 → 灵枢五原则现状对照 → 四层改造方向 → 瓶颈定位实验规格（两个 oracle）；理论文档，不含实现补丁 |
| [外部提交核验·状态链轨 v0.2（TanPowasd）](mdcg/外部提交核验_状态链轨v0.2_TanPowasd_20261011.md) | issue #110/#111 外部答卷的**独立复算**记录：我方官方判分器 + 提交方答卷 → 主臂十项读数逐位复现、校准门四条 `passed=True`；含五处限定与一次自我更正 |
| [状态链轨 v0.2·灵枢臂 A/B 全量实测](mdcg/状态链轨_灵枢臂A-B全量实测_20261012.md) | 官方口径 harness 下**同 adapter 只差 `created_at`** 的 625 题对照：B(fact_time) 现值 +0.53/滞后 −0.40，但历史 −0.27/四态 −0.18/缘由 −0.16 ⇒ **B 非净改进**；并暴露 harness 变更链覆盖缺陷（两组皆≈0） |

## swarm/ · 蜂群运行时

| 文档 | 内容 |
|---|---|
| [功能说明 v0.6](swarm/蜂群多智能体_功能说明_v0.6.md) | .pbc 确定性实例 + Gossip/WAL/信任聚合 |
| [使用报告 2026-09-13](swarm/蜂群多智能体_使用报告_20260913.md) | 实测记录 |
| [蜂群互联 v0.1](swarm/蜂群互联_v0.1.md) | 多蜂群互联协议 |
| [蜂群盲区标记 v1.0](swarm/蜂群盲区标记_v1.0.md) | 盲区协同标记 |
| [蜂群同错检测实验协议 v0.1](swarm/蜂群同错检测实验协议_v0.1.md) | 同错检测实验设计 |

## hive/ · 蜂巢并发引擎

| 文档 | 内容 |
|---|---|
| [蜂巢工作记忆·项目计划](hive/蜂巢工作记忆_项目计划.md) | hive 工作记忆规划 |
| [蜂巢设计·理论对齐 v0.1](hive/蜂巢设计_理论对齐_v0.1.md) | 智能论3.4 ↔ 蜂巢源码 ↔ 外部调研三方对齐：20 条锚点映射 / 6 项设计裁决 / 候选清单分组裁定 / 四阶段路线 / 诚实边界 |
| [蜂巢迭代·宏观与群体调度 v0.1](hive/蜂巢迭代_宏观与群体调度_v0.1.md) | 三层调度（微观进程已闭环 / 中观任务 DAG 本期 / 宏观群体规划）+ dsh-omc 七不变量对照 + I-1 依赖门禁施工细节 |
| [主代理子代理记忆架构设计](hive/主代理子代理记忆架构设计.md) | 多代理记忆分工（三层记忆 / session 隔离 / 卡片回流） |
| [子代理配置标准 v0.5](hive/子代理配置标准_v0.5.md) | 运行时角色拓扑·六位（§8：副代理=设计者视角）/ 统一执行默认（§0）/ 派发 / 确定性执行（§7）/ 复用 / 产出物生命周期（§5.4） |
| [令牌与角色权职分离 v0.1](hive/令牌与角色权职分离_v0.1.md) | 权限模型 |
| [令牌语义修正·仲裁位 v0.1](hive/令牌语义修正_仲裁位_v0.1.md) | 设计稿：新增 orchestr 角色（3.9 仲裁实例投影）+ 拆分裁决权/管理权闸门 + 迁移顺序与能红判据 |
| [多端 harness 通信契约 v0.1](hive/多端harness通信契约_v0.1.md) | 多端 harness 通信契约 |
| [蜂巢双实例互验 · 设计定稿](hive/蜂巢双实例互验_设计定稿.md) | 打破自指悖论的双实例互验工程形态（设计定稿） |
| [检索路径与认知结构契约 v0.1](hive/检索路径与认知结构契约_v0.1.md) | 检索路径与认知结构契约 |
| [检索收敛口径实测与 S1b 设计 v0.1](hive/检索收敛实测与S1b设计_v0.1.md) | 检索收敛口径实测（真实库 12,149 节点，只读）与 S1b 设计 |
| [真实库端到端实测：S1b 收益与召回权衡 v0.1](hive/真实库端到端实测_S1b与召回权衡_v0.1.md) | S1b 收益与召回权衡实测 |
| [真实库端到端实测：S7 倒排候选层 v0.1](hive/真实库端到端实测_S7倒排候选层_v0.1.md) | S7 倒排候选层实测（候选内加速 + 零召回损失） |

## world_model/ · 世界模型神经网络底层架构

| 文档 | 内容 |
|---|---|
| [世界模型·神经网络底层架构 v1.0](world_model/世界模型_神经网络底层架构_v1.0.md) | hex 系列工程成果台账（11 件组件 / 反传语义 / Rust 后端 / 认知图对接面 / 验证基线与红线） |

## theory/ · 智能论理论

| 文档 | 内容 |
|---|---|
| [白箱智能是什么？](theory/白箱智能是什么？.md) | 教学一 |
| [智能的认知过程](theory/智能的认知过程.md) | 教学二 |
| [智能的公理化基石](theory/智能的公理化基石.md) | 教学三 |
| [信息差为什么必然存在且自然扩大](theory/信息差为什么必然存在且自然扩大.md) | 教学四 |
| [白箱智能系列·第五篇：让 AI 真正装上记忆](theory/白箱智能系列·第五篇：让AI真正装上记忆.md) | 系列续篇 |
| [智能论 3.4](theory/智能论3.4.md) | 理论主文档 |
| [并发必然性理论 v0.2](theory/并发必然性理论_v0.2.md) | 并发架构的必然性论证 |
| [单线程与注意力集中 v1.0](theory/单线程与注意力集中_无争议理论文档_v1.0.md) | 无争议理论文档（含验证留痕表） |
| [概念分层对齐表 v0.1](theory/概念分层对齐表_v0.1.md) | 概念层级对齐 |
| [认知代理与收敛结构·条件论重构 v0.1](theory/认知代理与收敛结构_条件论重构_v0.1.md) | 条件论 |
| [理论·机制·代码·实验·缺口矩阵 v0.1](theory/理论_机制_代码_实验_缺口矩阵_v0.1.md) | 全景矩阵 |
| [不可靠定理与失效优先框架 v0.3](theory/不可靠定理与失效优先框架_v0.3.md) | Fail-First Theorems：T0 失效定理推导链（T0–T14/A1–A4）· 14 行理论×机制×代码矩阵（2026-09-26 工程核验）· 落地清单含 v0.1 承接节 |
| [理论仓拆分与白箱知识库内迁 v0.1](theory/理论仓拆分与白箱知识库内迁_v0.1.md) | 拆分方案 |
| [上下文不足与记忆系统同构 · 原理分析 v0.1](theory/上下文不足_LLM与记忆系统同构_原理分析_v0.1.md) | LLM 架构与记忆系统的三重同构（功能/问题/方案）；由 T4+T5 推出「要四可则必须显式化」；P1-P4 可证伪预测 |
| [从 LLM 推理框架反推记忆系统调优 v0.1](theory/LLM推理框架原理_向记忆系统移植_v0.1.md) | 八条可搬原理（阶段分离 / 不对称资源 / 缓存分层 / 存算分区 / 有界重放 / 两级命中 / 边际回报 / 异步延迟一拍）+ 移植严判据 + 明确不搬三层；含「我们缺 155 万亿 tokens/天校准台」的诚实边界 |

## eval/ · 评测与第三方验证

> **读法提示（先看口径再看数）**：本目录评测分**多套独立标尺**——① **七维档位判定**（六家同尺 · v3.1，主口径，**给档不给单一分**）；② **外部独立八维加权**（统一评分 v7，**仅两家对照、差距在噪声内**）；③ 本仓自建题池（历史口径，保留供复现）。**三者不可互比**，引用时须连口径一起引。

| 文档 | 内容 |
|---|---|
| [AGI 七维评分报告 v3.1（六家同尺实测 + U/I 单家自测）](eval/AGI七维评分报告_六家记忆系统同尺实测_v3.1.md) | 七维 × 六家实测对比 / U·I 单家活体自测（▲）/ 映射规则 / 诚实边界 |
| [关系链检索：弱分支预算饥饿修复](eval/chain_best_first_20261013.md) | 原生 Markdown 默认 RRF 改前/改后对照、独立穷举守卫、定点变异与资源边界 |
| [DSH 收尾审计计数 · #606 交付记录](eval/hook_audit_summary_20261021.md) | 关闭/更新时累计摘要、静默降级、73 项回归与 5 组定点变异 |
| [AGI 七维评分报告 v1.0](eval/AGI七维评分报告_md_cg_v1.0.md) / [v2.0](eval/AGI七维评分报告_md_cg_v2.0.md)（历史） | 单家自评（结构取证口径） |
| [第三方复评·统一评分 v7](eval/第三方验证报告_灵枢_vs_dejavu_统一评分_v7.md) | 七轮对照（**外部独立标尺 · 仅两家 · 与七维档位判定不可互比**）：灵枢 9.258 / deja-vu 9.119；**评审者声明该差距在评审噪声以内**，且 v7 含对自身四条建议**全撤回**的勘误 |
| [第三方验证·LoCoMo 独立复现](eval/第三方验证报告_LoCoMo_灵枢_.md)（[png](eval/第三方验证报告_LoCoMo_灵枢_.png)） | 独立评测全流程复现 |
| [六家横评 100 题中英双查 v1.0](eval/横评_六家100题中英双查_v1.0.md) | 六家同口径对照 |
| [实验方案·学习闭环 AB 与横评 v1.0](eval/实验方案_学习闭环AB与横评_v1.0.md) | 实验设计 |

## ops/ · 安装与运维

| 文档 | 内容 |
|---|---|
| [ops/ 索引](ops/README.md) | 本域两篇的入口 |
| [安装与前置](ops/安装与前置.md) | 一键配置 / 手工三步 / 前置条件 / 已验证环境 / 装后验证 / 排障线索 |
| [运维与排障](ops/运维与排障.md) | 升级须重启常驻进程（代校验）/ 写入凭据与 committed 语义 / FAQ |

## dev/ · 开发与编码约定

| 文档 | 内容 |
|---|---|
| [dev/ 索引](dev/README.md) | 本域两篇的入口 |
| [编码与测试约定](dev/编码与测试约定.md) | 构建 / Python 测试必须 -m / 全 UTF-8 与入口自保证 / id 契约 v2 / Linux 双栈验证 |
| [开关矩阵](dev/开关矩阵.md) | 检索与归一 env 开关、默认值与裁定沿革 |

## plans/ · 项目计划 / 交接 / 规格

| 文档 | 内容 |
|---|---|
| [命名治理·项目计划](plans/命名治理_项目计划.md) | 命名规范治理 |
| [知识图谱项目·交接文档 2026-09-14](plans/知识图谱项目_交接文档_20260914.md) | 项目交接 |
| [GridWorld 最小闭环规格 v0.1](plans/GridWorld最小闭环规格_v0.1.md) | 实验规格 |
| [多主体世界模型·对齐评估与落地设计 v0.1](plans/多主体世界模型_对齐评估与落地设计_v0.1.md) | 五层对齐评估＋A→B→C 动工基线（33 条复核发现已裁定） |
| [语义时空图补全·世界模型功能端 设计 v0.1](plans/语义时空图补全_世界模型功能端_设计_v0.1.md) | 现状盘点（四 op＋L0 台账）＋L2 槽位 schema 方向＋语料管线与验收口径（待签收） |
| [灵枢协作架构·设计 v0.1](plans/灵枢协作架构_设计_v0.1.md) | 蜂群 × 项目管理 × 资源分配 × 群聊 × 团队记忆：统一任务生命周期（一条状态机两个权威面）＋三层同构嵌套＋分期能红判据（设计稿，含 6 项待裁） |
| [灵枢信任接线·设计规格 v0.1](plans/灵枢信任接线_设计规格_v0.1.md) | 把既有信任值（links.py 的 p_trust）接进资源分配：读向三闸／写向闭环／档位表 ＋ 十条能红判据（P2 开工依据，含 5 项待裁） |
| [相对时间锚定·设计 v0.1](plans/相对时间锚定_设计_v0.1.md) | `MDCG_TIME_ANCHOR`（缺省关）：正文相对时间 → 派生事件区间 `temporal_anchor`；问句点名日期 → `time_anchor` 路 + 交集前置；LoCoMo 读数、污染声明与下界 |

## 悬赏板 · 已独立成仓

悬赏板（规则 / 状态机 / 账本 / 荣誉榜 / 发布模板）已迁至独立仓 [`FuRongJun-1999/dsh-bounty`](https://github.com/FuRongJun-1999/dsh-bounty)；本仓不再维护其实现。设计稿留 [plans/悬赏板设计_v0.1.md](plans/悬赏板设计_v0.1.md) 一页指针。

## 根级横切交接件（留 docs/ 根，不入子域）

跨项目/跨端的学习交接与总纲件，按惯例留 docs/ 根（L3 惯例）：

| 文档 | 内容 |
|---|---|
| [GBrain 可借鉴点 · 灵枢落点交接 20260919](GBrain可借鉴点_灵枢落点交接_20260919.md) | GBrain 借鉴点与灵枢落点交接 |
| [Pi 可学习优点 · 灵枢大脑改进交接 20260915](Pi可学习优点_灵枢大脑改进交接_20260915.md) | Pi 优点吸收交接 |
| [存算一体架构学习 · 外部理论对照与路线交接 20260916](存算一体架构学习_外部理论对照与路线交接_20260916.md) | 存算一体外部理论对照 |
| [存算一体神经网络架构 · 总纲与交接 20260916](存算一体神经网络架构_总纲与交接_20260916.md) | 存算一体总纲 |
| [灵枢自我改进工作计划 · 外部研究系列吸收 v1 20260919](灵枢自我改进工作计划_外部研究系列吸收_v1_20260919.md) | 自我改进工作计划 |
| [白箱化纲领 · 三项目学习总架构与 Ghidra 交接 20260916](白箱化纲领_三项目学习总架构与Ghidra交接_20260916.md) | 白箱化总纲领 |
| [记忆评审系统 · 立项设计与施工交接 20260915](记忆评审系统_立项设计与施工交接_20260915.md) | 记忆评审立项交接 |
| [秤 · 多主体世界模型评测规范 v2.1（冻结版）](秤_记忆系统评测规范_v2.1.md) | 记忆系统评测规范：双轨制 / 六条件 / 四态判定 / 校准零号前置门（横切评测规范，2026-10-05 收入） |
| [发布件回溯说明 v0.1](发布件回溯说明_v0.1.md) | 发布件回溯 |
| [dsh-TUI 兼容判定单 v0.1](dsh-tui_兼容判定单_v0.1.md) | 外部终端 UI（dsh-TUI）与灵枢的接缝取证、已落地适配、未验证边界与下一步 |

## 归域规则（新文档放哪）

1. **工程文档** → 对应工程域（`mdcg/`、`swarm/`、`hive/`、`world_model/`；rust / compiler 有专属文档时新增同目录）。
2. **跨工程理论** → `theory/`；**评测 / 第三方报告** → `eval/`；**计划 / 交接 / 规格** → `plans/`。
3. **横切全局件**（工作纪律真源等）→ 留顶层，移动前必须核对引用面并全量重写。
4. 入域后在本页对应清单登记一行；`discipline/`、`experiments/`、`promo/` 既有惯例不变。

- [Memory-RSI 五轮工作与提交范围（第五轮进行中）](eval/memory-rsi-work-summary-20261012.md)