@furongjun1999/dsh-memory 0.4.7 → 0.4.8

package/docs/README.md

@@ -0,0 +1,111 @@
+# docs/ 目录索引
+
+> 按工程域分目录，与本仓 README「平台全景」五件套对应。新文档先归域、后登记到本页对应清单；跨域的横切件留顶层。改纪律真源路径前须核对引用面（AGENTS.md / 渲染管线 / md_cg 注释）。
+
+## 目录结构
+
+```
+docs/
+├── 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.5.md) | 完整能力说明 · 配置项全表 |
+| [发布说明 v0.3.0](mdcg/release_v0.3.0.md) / [v0.4.5](mdcg/release_v0.4.5.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) | 功能整理与迁移对照 |
+| [灵枢自我层定义](mdcg/灵枢_自我层定义.md) | 自我层行为规范（test_p16 行号级引用） |
+| [三层拆分规划 v0.1](mdcg/灵枢三层拆分规划_v0.1.md) | 架构分层规划 |
+| [记忆操作系统 MdCGOS 与 MCP 接入 v0.1](mdcg/记忆操作系统_MdCGOS与MCP接入_v0.1.md) | 核心架构设计 |
+| [认知图 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) | 路线图 |
+| [主代理子代理记忆架构设计](mdcg/主代理子代理记忆架构设计.md) | 多代理记忆分工 |
+| [子代理配置标准 v0.4](mdcg/子代理配置标准_v0.4.md) | 统一执行默认（§0）/ 派发 / 确定性执行（§7）/ 复用 / 产出物生命周期（§5.4） |
+| [单元自我锚点·系统提示词标准 v0.3](mdcg/单元自我锚点_系统提示词标准_v0.3.md) | 提示词锚点标准 |
+| [令牌与角色权职分离 v0.1](mdcg/令牌与角色权职分离_v0.1.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) | 评分 / 评估 / 教程 |
+
+## 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 工作记忆规划 |
+
+## 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.1](theory/理论仓拆分与白箱知识库内迁_v0.1.md) | 拆分方案 |
+
+## eval/ · 评测与第三方验证
+
+| 文档 | 内容 |
+|---|---|
+| [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 |
+| [第三方验证·LoCoMo 独立复现](eval/第三方验证报告_LoCoMo_灵枢_.md)（[png](eval/第三方验证报告_LoCoMo_灵枢_.png)） | 独立评测全流程复现 |
+| [六家横评 100 题中英双查 v1.0](eval/横评_六家100题中英双查_v1.0.md) | 六家同口径对照 |
+| [实验方案·学习闭环 AB 与横评 v1.0](eval/实验方案_学习闭环AB与横评_v1.0.md) | 实验设计 |
+
+## plans/ · 项目计划 / 交接 / 规格
+
+| 文档 | 内容 |
+|---|---|
+| [命名治理·项目计划](plans/命名治理_项目计划.md) | 命名规范治理 |
+| [知识图谱项目·交接文档 2026-09-14](plans/知识图谱项目_交接文档_20260914.md) | 项目交接 |
+| [GridWorld 最小闭环规格 v0.1](plans/GridWorld最小闭环规格_v0.1.md) | 实验规格 |
+
+## 归域规则（新文档放哪）
+
+1. **工程文档** → 对应工程域（`mdcg/`、`swarm/`、`hive/`、`world_model/`；rust / compiler 有专属文档时新增同目录）。
+2. **跨工程理论** → `theory/`；**评测 / 第三方报告** → `eval/`；**计划 / 交接 / 规格** → `plans/`。
+3. **横切全局件**（工作纪律真源等）→ 留顶层，移动前必须核对引用面并全量重写。
+4. 入域后在本页对应清单登记一行；`discipline/`、`experiments/`、`promo/` 既有惯例不变。

package/docs/discipline/harnesses.yaml

@@ -1,152 +1,215 @@
-# 工作纪律 · harness 适配矩阵
-#
-# 真源（唯一手写）：docs/工作纪律_认知图条目_v1.1.json
-# 本文件只声明「怎么把真源渲染成各端产物」，不承载纪律本体（与真源边界一致）。
-#
-# transport:
-#   file        —— 产物是一个独立文件；path 相对仓库根，或以 ~ 开头（用户目录）
-#   config-key  —— 产物写进某个 YAML 配置文件的指定键；用受管标记块原地修订，保留注释
-# variant:  full    —— 全文形态（含声明出口表 / 收尾流程 / 维护规则），供会话起始注入
-#           compact —— 精简形态（执行公约 + 路由表 + 声明），供「每轮都在」的系统提示槽位
-#           skill   —— SKILL.md 形态（YAML frontmatter + 纪律正文），供 Claude Code / Codex 插件的 skills/ 目录
-# enabled:  是否纳入 render --write 与 verify 的默认范围
-# memory:   该端 Agent 访问灵枢记忆的通路；仅声明事实，不参与渲染与校验。两种形态：
-#           ① MCP 客户端配置 —— 写客户端配置里的 server 名（如 mcp/mdcg）；
-#           ② 宿主内建桥   —— 插件直接 spawn 同一个 md_cg.mcp_server 为子进程，
-#                            再注册为宿主工具（DSH 侧 = lingshu_cg / lingshu_stg）。
-#           底层服务是同一个 python -m md_cg.mcp_server；差别只在"谁去连它"。
-#           未列该项的端表示通路未在本矩阵登记，不代表该端无通路。
-
-version: 1
-source: docs/工作纪律_认知图条目_v1.1.json
-
-targets:
-
-  dsh:
-    enabled: true
-    transport: config-key
-    path: '~/.dsh/profiles/web/cordis.patch.yml'
-    entry_id: system-prompt
-    key: personaPrefix
-    variant: compact
-    format: text
-    marker: lingshu:discipline
-    memory: plugin/lingshu_cg+lingshu_stg (插件内建桥，spawn md_cg.mcp_server；tools=core)
-    note: >-
-      DSH 系统提示 order=0（DEPLOYMENT_PERSONA_PREFIX），每轮注入；
-      严格 {{variable}} 插值 ⇒ 正文禁含裸 {{ 。
-    # 端差异与落地边界 → 注入 compact 模板的 %%PREAMBLE%%（模板保持通用，差异留在矩阵）
-    preamble: |-
-      【本端（DSH）与其它端的差异】
-      - 记忆通路：插件内建 lingshu_cg / lingshu_stg 两个基元（tools = core），即正文纪律中的 cg / stg——同一服务，勿因名字不同而猜测；其余能力经 cg(op=…) / stg(op=…) 分发，op 为必填参数（漏传会被参数签名推导兜底并标记 op_derived）。
-      - 注入时机：本段在系统提示 order=0（DEPLOYMENT_PERSONA_PREFIX），每轮都在；codebuddy / zcode 端是会话起始一次性注入全文。
-      - 自动记忆：本端有 session hook，默认自动转录用户消息（assistant / tool 默认关）。
-        故第 16 条在本端只补核心结论（内容／原因／位置／验证结论），不复述对话流水——否则与自动转录重复、稀释检索。
-        CodeBuddy 端无会话 hook，其自动记忆改由第 16 条显式归档驱动；两端落地方式不同，勿照搬。
-
-      【仓库结构与公开边界（第 9 / 14 条落地用）】
-      - 仓库按 harness 分目录：dsh/ · codebuddy/ · zcode/ · codex/；共享层（md_cg/ · docs/ · scripts/）在仓库根。
-      - 根目录 AGENTS.md 是本地私有件（.gitignore，含运维注记）；公开产物是 codebuddy/CODEBUDDY.md 与 zcode/AGENTS.md。
-      - 公开仓 = GitHub FuRongJun-1999/dsh-memory；私有运行时 = AEIS。含敏感／隐私内容只写 AEIS，不进公开仓。
-
-      【纪律本体的维护链路】
-      - 真源 docs/工作纪律_认知图条目_v1.1.json → scripts/render_discipline.py → 各端产物 → scripts/verify_discipline.py 守漂移。
-      - 改纪律 = 改真源 → 重渲染（--write）→ 过校验（漂移即非零退出）；禁止手改本段（下次渲染会覆盖）。
-
-  codebuddy:
-    enabled: true
-    transport: file
-    path: codebuddy/CODEBUDDY.md
-    variant: full
-    format: markdown
-    memory: mcp/mdcg (cg,stg)
-    note: >-
-      CodeBuddy 会话起始全文注入。**根目录 CODEBUDDY.md 优先于 AGENTS.md**——
-      本仓产物落 codebuddy/CODEBUDDY.md（不落根，避免屏蔽本地私有 AGENTS.md）；
-      外部用户复制该文件到自身项目根即生效（见 codebuddy/README.md）。
-
-  zcode:
-    enabled: true
-    transport: file
-    path: zcode/AGENTS.md
-    variant: full
-    format: markdown
-    preserve: true
-    note: >-
-      ZCode 读项目根 AGENTS.md。本仓产物落 zcode/AGENTS.md（不落根，避免与
-      CodeBuddy 的 CODEBUDDY.md 及本地 AGENTS.md 冲突）；复制到项目根生效。
-
-  codex:
-    enabled: true
-    transport: file
-    path: codex/AGENTS.md
-    variant: full
-    format: markdown
-    preserve: true
-    memory: mcp/mdcg (cg,stg)
-    note: >-
-      Codex CLI 读项目根 AGENTS.md（另支持 ~/.codex/AGENTS.md 全局）。
-      本仓产物落 codex/AGENTS.md（不落根，根 AGENTS.md 是本地私有件）；
-      复制到项目根即生效。MCP 通路模板见 codex/config.toml.example。
-
-  claude-code:
-    enabled: true
-    transport: file
-    path: claude/CLAUDE.md
-    variant: full
-    format: markdown
-    preserve: true
-    memory: mcp/mdcg (cg,stg)
-    note: >-
-      Claude Code（Anthropic）会话起始读取项目根 CLAUDE.md（另支持 ~/.claude/CLAUDE.md
-      全局、CLAUDE.local.md 私有附加）。本仓产物落 claude/CLAUDE.md（不落根——根 AGENTS.md
-      是本地私有件，且落根会与 CodeBuddy / Codex 端的根级注入并存造成重复）；
-      复制到项目根即生效。MCP 通路模板见 claude/mcp.json.example（项目级 .mcp.json）。
-    preamble: |-
-      【本端（Claude Code）与其它端的差异】
-      - 记忆通路：MCP server「mdcg」（项目级 .mcp.json 或 claude mcp add 配置，tools = kernel 面 cg/stg）；
-        其余能力经 cg(op=…) / stg(op=…) 分发。
-      - 注入时机：本段在会话起始一次性注入全文（CLAUDE.md）；DSH 端是每轮都在的 compact 系统提示。
-      - 自动记忆：本端无会话 hook 自动转录，记忆沉淀由第 16 条显式归档驱动（与 CodeBuddy / Codex 端同构）。
-
-  # —— 插件生态形态（新增）：纪律不再靠复制注入文件，而是随插件 skills/ 分发 ——
-  claude-code-plugin-skill:
-    enabled: true
-    transport: file
-    path: claude/lingshu-memory/skills/linglu-discipline/SKILL.md
-    variant: skill
-    format: markdown
-    memory: mcp/mdcg (cg,stg)
-    note: >-
-      Claude Code 插件形态（插件根 = claude/lingshu-memory/，经仓根 .claude-plugin/marketplace.json
-      分发：/plugin marketplace add FuRongJun-1999/dsh-memory → /plugin install）。
-      CLAUDE.md 不能随插件分发，纪律注入改由 skill 承载（Claude 按 frontmatter description 自动调用，
-      或 /lingshu-memory:linglu-discipline 显式调用）。
-    preamble: |-
-      【本 skill（Claude Code 插件形态）与其它端的差异】
-      - 记忆通路：MCP server「mdcg」（tools = kernel 面 cg/stg，其余能力经 op 分发）。插件不含大脑本体——
-        安装后须按插件 README 把 mcp.json.example 配置为项目 .mcp.json（PYTHONPATH 指向你本机的 dsh-memory 仓库）。
-      - 注入时机：Claude 按本 skill 的 description 在任务开始 / 命中触发词时自动调用；
-        也可用 /lingshu-memory:linglu-discipline 显式调用。其它端是会话起始一次性全文注入——
-        本 skill 形态下若本会话尚未加载过本 skill，应先加载再动手。
-      - 写入凭据：mdcg fail-closed，未配 MDCG_TOKEN 时只读 guest（读得到、写不进）；签发见插件 README。
-
-  codex-plugin-skill:
-    enabled: true
-    transport: file
-    path: codex/lingshu-memory/skills/linglu-discipline/SKILL.md
-    variant: skill
-    format: markdown
-    memory: mcp/mdcg (cg,stg)
-    note: >-
-      Codex 插件形态（插件根 = codex/lingshu-memory/，.codex-plugin/plugin.json，name 与文件夹一致；
-      经仓根 .agents/plugins/marketplace.json 分发：codex plugin marketplace add <本仓路径> → codex plugin add）。
-      与 codex/AGENTS.md 手工路线并存：AGENTS.md 是会话起始全文注入主通道，本 skill 是插件分发的等价形态。
-    preamble: |-
-      【本 skill（Codex 插件形态）与其它端的差异】
-      - 记忆通路：MCP server「mdcg」（tools = kernel 面 cg/stg，其余能力经 op 分发）。插件不含大脑本体——
-        安装后须按插件 README 把 config.toml.example 的 [mcp_servers.mdcg] 两段合并进 ~/.codex/config.toml
-        （PYTHONPATH 指向你本机的 dsh-memory 仓库）。
-      - 注入时机：Codex 按 skill 三级渐进加载（元数据常驻、正文触发时加载）；项目根 AGENTS.md 仍是
-        会话起始全文注入主通道，本 skill 与之同源、并存不冲突。
-      - 写入凭据：mdcg fail-closed，未配 MDCG_TOKEN 时只读 guest（读得到、写不进）；签发见插件 README。
+# 工作纪律 · harness 适配矩阵
+#
+# 真源（唯一手写）：docs/工作纪律_认知图条目_v1.1.json
+# 本文件只声明「怎么把真源渲染成各端产物」，不承载纪律本体（与真源边界一致）。
+#
+# transport:
+#   file        —— 产物是一个独立文件；path 相对仓库根，或以 ~ 开头（用户目录）
+#   config-key  —— 产物写进某个 YAML 配置文件的指定键；用受管标记块原地修订，保留注释
+# variant:  full    —— 全文形态（含声明出口表 / 收尾流程 / 维护规则），供会话起始注入
+#           compact —— 精简形态（执行公约 + 路由表 + 声明），供「每轮都在」的系统提示槽位
+#           skill   —— SKILL.md 形态（YAML frontmatter + 纪律正文），供 Claude Code / Codex 插件的 skills/ 目录
+# enabled:  是否纳入 render --write 与 verify 的默认范围
+# memory:   该端 Agent 访问灵枢记忆的通路；仅声明事实，不参与渲染与校验。两种形态：
+#           ① MCP 客户端配置 —— 写客户端配置里的 server 名（如 mcp/mdcg）；
+#           ② 宿主内建桥   —— 插件直接 spawn 同一个 md_cg.mcp_server 为子进程，
+#                            再注册为宿主工具（DSH 侧 = lingshu_cg / lingshu_stg）。
+#           底层服务是同一个 python -m md_cg.mcp_server；差别只在"谁去连它"。
+#           未列该项的端表示通路未在本矩阵登记，不代表该端无通路。
+# slot:     该产物在**宿主侧**占的注入位（对应下面 injection.slots 的键）。
+#           用途（Pi⑦⑤ 祖先链发现 + 防重复）：宿主从启动目录逐级上溯读同名件，故需按槽位
+#           发现「这条链上还并存哪些竞争件」；config-key 类产物无文件槽位，写 system-prompt-key。
+
+version: 1
+source: docs/工作纪律_认知图条目_v1.1.json
+
+# —— 注入面发现与防重复（Pi⑦⑤）——
+# 依据：宿主 agent 的注入件不是单点读取——它从启动目录逐级上溯读同名件（AGENTS.md /
+# CLAUDE.md / CODEBUDDY.md），故「产物落在哪」不等于「宿主只读到这一份」。本段把该事实
+# 声明为机械判据的输入，由 scripts/verify_discipline.py 裁决（判据见其 check_injection_matrix）：
+#   ① 同一物理文件被两个 target 写            → 后渲染者静默覆盖前者        → 硬失败
+#   ② 仓根出现会遮蔽本地私有件的槽位件         → 本地纪律注入在该宿主下失效   → 硬失败（§5 机械化的那条）
+#   ③ 同一条祖先链上并存同槽位件               → 宿主可能一并读到 / 按声明的
+#      择优顺序遮蔽                             → **发现面报告**（宿主侧事实，本仓不裁决，但不得假定不存在）
+injection:
+  version: 1
+  # 槽位 = 宿主侧的注入位；文件名列表 = **声明的宿主读取优先级**（首项优先，靠后者在同槽位被忽略）。
+  # 属「声明」而非「实测」：宿主行为一旦与此声明不符，应改本段而不是改判据。
+  slots:
+    codebuddy-session: [CODEBUDDY.md, AGENTS.md]
+    zcode-session: [AGENTS.md]
+    codex-session: [AGENTS.md]
+    claude-session: [CLAUDE.md]
+    plugin-skill: [SKILL.md]
+    # DSH 是配置键注入（personaPrefix），无文件级竞争面 —— 显式声明为空，不参与祖先链发现
+    system-prompt-key: []
+  # 仓根**允许**存在的槽位件：root AGENTS.md 是本地私有件（by design，见 codebuddy-local target）。
+  # 其余槽位件一旦出现在仓根，按 slots 声明顺序会遮蔽本地私有件 → 判硬失败。
+  root_allow: [AGENTS.md]
+  # 祖先链上溯终点：filesystem = 一路查到盘根（仓外命中只报告）；repo = 只查仓内。
+  chain_scope: filesystem
+
+targets:
+
+  dsh:
+    enabled: true
+    transport: config-key
+    slot: system-prompt-key
+    path: '~/.dsh/profiles/web/cordis.patch.yml'
+    entry_id: system-prompt
+    key: personaPrefix
+    variant: compact
+    format: text
+    marker: lingshu:discipline
+    memory: plugin/lingshu_cg+lingshu_stg (插件内建桥，spawn md_cg.mcp_server；tools=core)
+    note: >-
+      DSH 系统提示 order=0（DEPLOYMENT_PERSONA_PREFIX），每轮注入；
+      严格 {{variable}} 插值 ⇒ 正文禁含裸 {{ 。
+    # 端差异与落地边界 → 注入 compact 模板的 %%PREAMBLE%%（模板保持通用，差异留在矩阵）
+    preamble: |-
+      【本端（DSH）与其它端的差异】
+      - 记忆通路：插件内建 lingshu_cg / lingshu_stg 两个基元（tools = core），即正文纪律中的 cg / stg——同一服务，勿因名字不同而猜测；其余能力经 cg(op=…) / stg(op=…) 分发，op 为必填参数（漏传会被参数签名推导兜底并标记 op_derived）。
+      - 注入时机：本段在系统提示 order=0（DEPLOYMENT_PERSONA_PREFIX），每轮都在；codebuddy / zcode 端是会话起始一次性注入全文。
+      - 自动记忆：本端有 session hook，默认自动转录用户消息（assistant / tool 默认关）。
+        故第 16 条在本端只补核心结论（内容／原因／位置／验证结论），不复述对话流水——否则与自动转录重复、稀释检索。
+        CodeBuddy 端无会话 hook，其自动记忆改由第 16 条显式归档驱动；两端落地方式不同，勿照搬。
+
+      【仓库结构与公开边界（第 9 / 14 条落地用）】
+      - 仓库按 harness 分目录：dsh/ · codebuddy/ · zcode/ · codex/；共享层（md_cg/ · docs/ · scripts/）在仓库根。
+      - 根目录 AGENTS.md 是本地私有件（.gitignore，含运维注记）；公开产物是 codebuddy/CODEBUDDY.md 与 zcode/AGENTS.md。
+      - 公开仓 = GitHub FuRongJun-1999/dsh-memory；私有运行时 = AEIS。含敏感／隐私内容只写 AEIS，不进公开仓。
+
+      【纪律本体的维护链路】
+      - 真源 docs/工作纪律_认知图条目_v1.1.json → scripts/render_discipline.py → 各端产物 → scripts/verify_discipline.py 守漂移。
+      - 改纪律 = 改真源 → 重渲染（--write）→ 过校验（漂移即非零退出）；禁止手改本段（下次渲染会覆盖）。
+
+  codebuddy:
+    enabled: true
+    transport: file
+    slot: codebuddy-session
+    path: codebuddy/CODEBUDDY.md
+    variant: full
+    format: markdown
+    memory: mcp/mdcg (cg,stg)
+    note: >-
+      CodeBuddy 会话起始全文注入。**根目录 CODEBUDDY.md 优先于 AGENTS.md**——
+      本仓产物落 codebuddy/CODEBUDDY.md（不落根，避免屏蔽本地私有 AGENTS.md）；
+      外部用户复制该文件到自身项目根即生效（见 codebuddy/README.md）。
+
+  zcode:
+    enabled: true
+    transport: file
+    slot: zcode-session
+    path: zcode/AGENTS.md
+    variant: full
+    format: markdown
+    preserve: true
+    note: >-
+      ZCode 读项目根 AGENTS.md。本仓产物落 zcode/AGENTS.md（不落根，避免与
+      CodeBuddy 的 CODEBUDDY.md 及本地 AGENTS.md 冲突）；复制到项目根生效。
+
+  codex:
+    enabled: true
+    transport: file
+    slot: codex-session
+    path: codex/AGENTS.md
+    variant: full
+    format: markdown
+    preserve: true
+    memory: mcp/mdcg (cg,stg)
+    note: >-
+      Codex CLI 读项目根 AGENTS.md（另支持 ~/.codex/AGENTS.md 全局）。
+      本仓产物落 codex/AGENTS.md（不落根，根 AGENTS.md 是本地私有件）；
+      复制到项目根即生效。MCP 通路模板见 codex/config.toml.example。
+
+  claude-code:
+    enabled: true
+    transport: file
+    slot: claude-session
+    path: claude/CLAUDE.md
+    variant: full
+    format: markdown
+    preserve: true
+    memory: mcp/mdcg (cg,stg)
+    note: >-
+      Claude Code（Anthropic）会话起始读取项目根 CLAUDE.md（另支持 ~/.claude/CLAUDE.md
+      全局、CLAUDE.local.md 私有附加）。本仓产物落 claude/CLAUDE.md（不落根——根 AGENTS.md
+      是本地私有件，且落根会与 CodeBuddy / Codex 端的根级注入并存造成重复）；
+      复制到项目根即生效。MCP 通路模板见 claude/mcp.json.example（项目级 .mcp.json）。
+    preamble: |-
+      【本端（Claude Code）与其它端的差异】
+      - 记忆通路：MCP server「mdcg」（项目级 .mcp.json 或 claude mcp add 配置，tools = kernel 面 cg/stg）；
+        其余能力经 cg(op=…) / stg(op=…) 分发。
+      - 注入时机：本段在会话起始一次性注入全文（CLAUDE.md）；DSH 端是每轮都在的 compact 系统提示。
+      - 自动记忆：本端无会话 hook 自动转录，记忆沉淀由第 16 条显式归档驱动（与 CodeBuddy / Codex 端同构）。
+
+  # —— 插件生态形态（新增）：纪律不再靠复制注入文件，而是随插件 skills/ 分发 ——
+  claude-code-plugin-skill:
+    enabled: true
+    transport: file
+    slot: plugin-skill
+    path: claude/lingshu-memory/skills/linglu-discipline/SKILL.md
+    variant: skill
+    format: markdown
+    memory: mcp/mdcg (cg,stg)
+    note: >-
+      Claude Code 插件形态（插件根 = claude/lingshu-memory/，经仓根 .claude-plugin/marketplace.json
+      分发：/plugin marketplace add FuRongJun-1999/dsh-memory → /plugin install）。
+      CLAUDE.md 不能随插件分发，纪律注入改由 skill 承载（Claude 按 frontmatter description 自动调用，
+      或 /lingshu-memory:linglu-discipline 显式调用）。
+    preamble: |-
+      【本 skill（Claude Code 插件形态）与其它端的差异】
+      - 记忆通路：MCP server「mdcg」（tools = kernel 面 cg/stg，其余能力经 op 分发）。插件不含大脑本体——
+        安装后须按插件 README 把 mcp.json.example 配置为项目 .mcp.json（PYTHONPATH 指向你本机的 dsh-memory 仓库）。
+      - 注入时机：Claude 按本 skill 的 description 在任务开始 / 命中触发词时自动调用；
+        也可用 /lingshu-memory:linglu-discipline 显式调用。其它端是会话起始一次性全文注入——
+        本 skill 形态下若本会话尚未加载过本 skill，应先加载再动手。
+      - 写入凭据：mdcg fail-closed，未配 MDCG_TOKEN 时只读 guest（读得到、写不进）；签发见插件 README。
+
+  codex-plugin-skill:
+    enabled: true
+    transport: file
+    slot: plugin-skill
+    path: codex/lingshu-memory/skills/linglu-discipline/SKILL.md
+    variant: skill
+    format: markdown
+    memory: mcp/mdcg (cg,stg)
+    note: >-
+      Codex 插件形态（插件根 = codex/lingshu-memory/，.codex-plugin/plugin.json，name 与文件夹一致；
+      经仓根 .agents/plugins/marketplace.json 分发：codex plugin marketplace add <本仓路径> → codex plugin add）。
+      与 codex/AGENTS.md 手工路线并存：AGENTS.md 是会话起始全文注入主通道，本 skill 是插件分发的等价形态。
+    preamble: |-
+      【本 skill（Codex 插件形态）与其它端的差异】
+      - 记忆通路：MCP server「mdcg」（tools = kernel 面 cg/stg，其余能力经 op 分发）。插件不含大脑本体——
+        安装后须按插件 README 把 config.toml.example 的 [mcp_servers.mdcg] 两段合并进 ~/.codex/config.toml
+        （PYTHONPATH 指向你本机的 dsh-memory 仓库）。
+      - 注入时机：Codex 按 skill 三级渐进加载（元数据常驻、正文触发时加载）；项目根 AGENTS.md 仍是
+        会话起始全文注入主通道，本 skill 与之同源、并存不冲突。
+      - 写入凭据：mdcg fail-closed，未配 MDCG_TOKEN 时只读 guest（读得到、写不进）；签发见插件 README。
+
+  # —— 本地私有注入件（.gitignore，不入公开仓）：只校验，不渲染 ——
+  # 它是「纪律本体 + 本地增强」的手工件（§1 设计者视角含本机路径、§0.6 工具规范、§5 运维注记），
+  # full 模板渲染会覆盖这些本地增强段，故 render: false（禁写盘）。
+  codebuddy-local:
+    enabled: true
+    render: false
+    transport: file
+    slot: codebuddy-session
+    path: AGENTS.md
+    variant: full
+    format: markdown
+    memory: mcp/mdcg (cg,stg)
+    note: >-
+      根目录 AGENTS.md = 本机 CodeBuddy 会话注入件（见本文件 dsh preamble「仓库结构与公开边界」）。
+      历史缺陷（20260916 漂移实例）：它是手工件、长期不在渲染/校验矩阵内，0.1 / 0.6 把 DSH 端
+      注册名写死为通用工具名并加「非 cg」的反向否决，本端 agent 因此对工具名产生疑惑——
+      与「手写行号必腐化」同构：无守卫的手工件必然漂移。
+      修法：纳入矩阵只做校验（render: false），守卫 ①声明出口逐字一致；②工具名随端标注
+      （件内每处 DSH 端基元名须与 MCP 端正名 mdcg 同行出现）；③编号完备（缺条即其声明缺失）。
+    # 形态说明（20260916 修订）：本件 §2 路由表原为分组表格；markdown 表格单元格须转义
+    # 半角 '|'，而真源 execution.how 含半角 '|'（第 2 / 8 条）——与「逐字嵌入」物理不相容，
+    # 故曾退让为 verify_fields advisory（差异全量打印、不判失败，不静默）。
+    # 现按使用者裁定改为**列表形态**（与渲染产物同源、逐字真源），摘要化差异归零：
+    # 撤下 verify_fields，本件回到**全字段 strict**（trigger / action / negative / declaration）。
+    # 同轮另一项：真源第 1 条 how 补「与既有实践」，与 content / response.direct 自洽——
+    # 原 how 缺该语、与真源自身矛盾，手工件反而是对的（属真源过时，非件漂移）。

package/docs/discipline/templates/full.md.tmpl

@@ -1,58 +1,60 @@
-# 工作纪律（%%VERSION%%）· %%COUNT%% 条
-
-> 本文件由 `scripts/render_discipline.py` 从真源
-> `docs/工作纪律_认知图条目_v1.1.json` 渲染生成，**请勿手改**；改真源后重跑渲染。
-> 真源指纹（SHA256 前16位）：%%SOURCE_SHA%%
-
-## 概述
-
-%%OVERVIEW%%
-
-## 执行公约
-
-| 约定 | 内容 |
-|---|---|
-| **0.1 会话起始先查记忆** | 动手前先调认知图入口——工具名随端：MCP 端 = server「mdcg」的 `cg`；DSH 端 = 内建基元 `lingshu_cg`（即下文所有 `cg(...)`，同一服务勿因名字不同而猜测）。**`op` 是必填参数（route/read/write/verify/review…），任何调用都显式传、勿省略**。先 `cg(op=route, intent=<任务意图>)`；命中纪律/知识则按其 `execution.how` 执行。**禁止跳过此步直接改代码或跑命令。** |
-| **0.2 命中即声明** | 命中纪律须在回复中输出该条 `response.direct` 原文（「按工作纪律第 N 条：…」）。**这是「已执行」的唯一可观测证据；未声明即视为未执行。** |
-| **0.3 产出即证据** | 「动作」栏要求的产出（判定单／检索结果／验证结论／归档节点 id）必须实际给出，缺失即未执行。 |
-| **0.4 违规即归档** | 发现自己违反任一条 → 第 4 条归因 + 第 16 条写入灵枢记忆。**隐瞒违规本身是更严重的违规。** |
-| **0.5 例外不外溢** | 某条的「不适用」只豁免该条，不豁免其它条。 |
-
-## 纪律路由表
-
-%%ROUTING_TABLE_FULL%%
-
-## 声明出口（`response.direct` 原文 · 未输出即未执行）
-
-%%DECLARATION_TABLE%%
-
-## 记忆接口速查（`cg` / `stg`）
-
-工具名随端：MCP 端 = server「mdcg」的 `cg` / `stg`；DSH 端 = 内建基元 `lingshu_cg` / `lingshu_stg`（与 `cg` / `stg` 同一服务，仅注册名不同）。**`op` 一律必填。**
-
-| op | 用途 | 常用参数 |
-|---|---|---|
-| `route` | 任务开始路由记忆（返回知识 + 建议能力，不执行） | `intent`（任务意图） |
-| `read` | 召回/检索/按 id 取（`session`=只取该会话归属的记忆，缺省不过滤） | `query` / `node_id` / `k` / `layer` / `budget_tokens` / `context` / `session` |
-| `write` | 写入（先按 content_kind 审核 + 冲突检测，ACCEPT 落盘 / DEFER 入审核队列 / REJECT 入负记忆）。**自动归属**：frontmatter 带 `writer`/`session`/`harness`（服务端身份，不可伪造） | `content` / `content_kind`（text/code/…）/ `node_id`（同 id 即改写）/ `layer` / `tags` / `importance` / `verification_basis` / `condition_space` / `gated` / `consistency` / `on_conflict`（reject\|defer\|record） |
-| `verify` | 对节点做证据验证（confirmed/weakened/falsified）——**非队列裁决** | `node_id` / `verdict` / `evidence` |
-| `review` | 审核队列：`action=list/rounds/records` 查看；传 `pid`+`decision`+`reason` 即裁决落盘（accept/reject/edit/merge，**需 can_admin**；本机未配置外部验证器时写入恒 DEFER 入队，靠此裁决落盘） | `action` / `pid` / `decision` / `reason` / `edits` / `merge_into` |
-| `recent` | 近期事件窗口 | `action`（add/list/clear）/ `limit` |
-| `forget` / `protect` | 软删除/恢复 / 写保护 | `node_id` |
-
-三条调用铁律：
-1. **`op` 必填**——漏传会触发参数签名推导兜底（返回标记 `op_derived: true`），复杂任务中也必须显式传，防静默执行错误意图。
-2. **返回 `moved_to: "review_queue"` / `verdict: DEFER/REJECT` 时不要重试**——这是校验闸门的正常行为（返回自带 `hint` 说明），重试同样结果；落盘须由设计者权限（can_admin）经 `op=review` 裁决（decision=accept/reject/edit/merge，本机工具：`python scripts/review_cli.py list`），agent 端无裁决权是设计（写入者不得自裁自决），转告使用者即可。
-3. `stg` 同理经 `op` 分发（`timeline` / `relation` / `anchors` 等）。
-
-## 收尾强制流程（任务完成时不可跳过）
-
-1. **验证**（第 5 条）：未验证不固化——回放／断言／回归通过才收尾。
-2. **归档**（第 16 条）：提炼关键修改（内容／原因／位置／验证结论四要素，禁写中间过程）→ 写入灵枢记忆。
-3. **自检**（第 4 条）：本次是否有违规？有 → 按条件层归因，并补不适用条件。
-
-## 本文件维护（防漂移）
-
-- 真源唯一：`docs/工作纪律_认知图条目_v1.1.json`。
-- 本文件是**渲染产物**，不是手抄投影；任何端的手改都会被 `scripts/verify_discipline.py` 判为漂移。
-- 改纪律 → 改真源 → `render_discipline.py --write` → `verify_discipline.py` 通过 → 提交。
+# 工作纪律（%%VERSION%%）· %%COUNT%% 条
+
+> 本文件由 `scripts/render_discipline.py` 从真源
+> `docs/工作纪律_认知图条目_v1.1.json` 渲染生成，**请勿手改**；改真源后重跑渲染。
+> 真源指纹（SHA256 前16位）：%%SOURCE_SHA%%
+
+## 概述
+
+%%OVERVIEW%%
+
+## 执行公约
+
+| 约定 | 内容 |
+|---|---|
+| **0.1 会话起始先查记忆** | 动手前先调认知图入口——工具名随端：MCP 端 = server「mdcg」的 `cg`；DSH 端 = 内建基元 `lingshu_cg`（即下文所有 `cg(...)`，同一服务勿因名字不同而猜测）。**`op` 是必填参数（route/read/write/verify/review…），任何调用都显式传、勿省略**。先 `cg(op=route, intent=<任务意图>)`；命中纪律/知识则按其 `execution.how` 执行。**禁止跳过此步直接改代码或跑命令。** |
+| **0.2 命中即声明** | 命中纪律须在回复中输出该条 `response.direct` 原文（「按工作纪律第 N 条：…」）。**这是「已执行」的唯一可观测证据；未声明即视为未执行。** |
+| **0.3 产出即证据** | 「动作」栏要求的产出（判定单／检索结果／验证结论／归档节点 id）必须实际给出，缺失即未执行。 |
+| **0.4 违规即归档** | 发现自己违反任一条 → 第 4 条归因 + 第 16 条写入灵枢记忆。**隐瞒违规本身是更严重的违规。** |
+| **0.5 例外不外溢** | 某条的「不适用」只豁免该条，不豁免其它条。 |
+
+## 纪律路由表
+
+%%ROUTING_TABLE_FULL%%
+
+## 声明出口（`response.direct` 原文 · 未输出即未执行）
+
+%%DECLARATION_TABLE%%
+
+## 记忆接口速查（`cg` / `stg`）
+
+工具名随端：MCP 端 = server「mdcg」的 `cg` / `stg`；DSH 端 = 内建基元 `lingshu_cg` / `lingshu_stg`（与 `cg` / `stg` 同一服务，仅注册名不同）。**`op` 一律必填。**
+
+| op | 用途 | 常用参数 |
+|---|---|---|
+| `route` | 任务开始路由记忆（返回知识 + 建议能力，不执行） | `intent`（任务意图） |
+| `read` | 召回/检索/按 id 取（`session`=只取该会话归属的记忆，缺省不过滤） | `query` / `node_id` / `k` / `layer` / `budget_tokens` / `context` / `session` |
+| `write` | 写入（先按 content_kind 审核 + 冲突检测，ACCEPT 落盘 / DEFER 入审核队列 / REJECT 入负记忆）。**自动归属**：frontmatter 带 `writer`/`session`/`harness`（服务端身份，不可伪造） | `content` / `content_kind`（text/code/…）/ `node_id`（同 id 即改写）/ `layer` / `tags` / `importance` / `verification_basis` / `condition_space` / `gated` / `consistency` / `on_conflict`（reject\|defer\|record） |
+| `verify` | 对节点做证据验证（confirmed/weakened/falsified）——**非队列裁决** | `node_id` / `verdict` / `evidence` |
+| `review` | 审核队列：`action=list/rounds/records` 查看；传 `pid`+`decision`+`reason` 即裁决落盘（accept/reject/edit/merge，**需 can_admin**；本机未配置外部验证器时写入恒 DEFER 入队，靠此裁决落盘） | `action` / `pid` / `decision` / `reason` / `edits` / `merge_into` |
+| `task` | 结构层任务实体（工程台账，跨会话/上下文压缩后不遗忘）：`name` 即身份（同名即同任务，slug 归一），`action` = open/status/plan_add/get/list/find/session（缺省 list）；**迁 `done` 必须同时给 `result`**（缺一不收，拒收不落盘）；未提供的字段沿用旧值（结果不会被静默清空） | `name` / `action` / `plan`（分步计划，每轮覆盖） / `change`（计划变更，逐轮追加） / `result` / `task_status`（active\|blocked\|done\|dropped） / `goal` / `acceptance` / `boundary` / `condition` / `node_id` |
+| `recent` | 近期事件窗口 | `action`（add/list/clear）/ `limit` |
+| `forget` / `protect` | 软删除/恢复 / 写保护 | `node_id` |
+| `help` | 取回工具面上**被投影外置**的完整 op / 参数文档（工具面渐进披露：常驻提示只留一行职责，参数语义按需取；不带 `query` 则列出全部工具） | `query`（工具名或 op 名，如 `cg` / `write`）/ `limit` |
+
+三条调用铁律：
+1. **`op` 必填**——漏传会触发参数签名推导兜底（返回标记 `op_derived: true`），复杂任务中也必须显式传，防静默执行错误意图。
+2. **返回 `moved_to: "review_queue"` / `verdict: DEFER/REJECT` 时不要重试**——这是校验闸门的正常行为（返回自带 `hint` 说明），重试同样结果；落盘须由设计者权限（can_admin）经 `op=review` 裁决（decision=accept/reject/edit/merge，本机工具：`python scripts/review_cli.py list`），agent 端无裁决权是设计（写入者不得自裁自决），转告使用者即可。
+3. `stg` 同理经 `op` 分发（`timeline` / `relation` / `anchors` 等）。
+
+## 收尾强制流程（任务完成时不可跳过）
+
+1. **验证**（第 5 条）：未验证不固化——回放／断言／回归通过才收尾。
+2. **归档**（第 16 条）：提炼关键修改（内容／原因／位置／验证结论四要素，禁写中间过程）→ 写入灵枢记忆。
+3. **自检**（第 4 条）：本次是否有违规？有 → 按条件层归因，并补不适用条件。
+
+## 本文件维护（防漂移）
+
+- 真源唯一：`docs/工作纪律_认知图条目_v1.1.json`。
+- 本文件是**渲染产物**，不是手抄投影；任何端的手改都会被 `scripts/verify_discipline.py` 判为漂移。
+- 改纪律 → 改真源 → `render_discipline.py --write` → `verify_discipline.py` 通过 → 提交。