@furongjun1999/dsh-memory 0.4.4 → 0.4.6

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@furongjun1999/dsh-memory",
-  "version": "0.4.4",
-  "description": "灵枢（Lingshu·líng shū）DeepSeek Harness 插件：完整大脑——长期记忆/知识飞轮/自我认知/递归反思接入 DSH，对话自动沉淀进记忆库",
+  "version": "0.4.6",
+  "description": "灵枢（Lingshu·líng shū）DeepSeek Harness 插件：完整大脑——长期记忆/知识飞轮/自我认知/递归反思接入 DSH，对话自动沉淀进 md_cg 认知图（md 文档）",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -14,6 +14,8 @@
   "files": [
     "lib",
     "src",
+    "md_cg",
+    "skills",
     "README.md",
     "cordis.yml.example",
     "cordis.patch.yml",
@@ -80,7 +82,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/FuRongJun-1999/dsh-memory.git"
+    "url": "git+https://github.com/FuRongJun-1999/dsh-memory.git"
   },
   "engines": {
     "node": ">=22.19"

package/skills/README.md

@@ -0,0 +1,121 @@
+# lingshu-skills · 灵枢自我认知技能包
+
+> 灵枢（AEIS · Agent Engineering Implementation Specification）· CommonTrustProtocol 主仓库内部
+> **本质：灵枢了解自身的工具**——不是独立仓库，是灵枢项目的一部分。
+> 用灵枢自己构建的条件单元，描述灵枢自己如何认知（白箱自举的对外投影）。
+
+---
+
+## 这是什么
+
+一个 **Agent Plugins 1.0.0 兼容包**（agent-plugins.org），内含 **686 个 Agent Skills（六域条件单元）+ 1 个元技能（设计者视角）**：
+
+| 域 | 单元数 | 内容 |
+|---|---|---|
+| compiler | 116 | 中文编译器（词法/语法/编译/VM/调试/分析）|
+| pylang | 120 | Python 语言机制（表达式/函数/类/闭包）|
+| graph | 117 | 图算法与图数据库 |
+| os | 112 | 操作系统（进程/调度/文件系统）|
+| browser | 104 | 浏览器与网页 |
+| net | 117 | 网络（协议/传输/安全）|
+| **合计** | **686** | 白箱六域条件单元 |
+
+每个技能描述灵枢在**什么条件下**能做什么、**怎么执行**、**克制什么**——比标准 Agent Skills 多出
+**KCCS 四要素（生效条件/子功能/执行/不适用条件）** 与**不适用条件三通道**（description「Not for」+
+metadata.kccs.not_applicable + 正文克制条款章节）。
+
+## 三层关系（知识 → 说明书 → 执行）
+
+```
+知识真源（本仓 md_cg）           md_cg/whitebox_kb/wisdom/*_code_units.py（KCCS 四要素，真源）
+        ↓ 导出（tools/skill_export.py + skill_export_verify.py 门禁，工具置身体仓）
+说明书（本包）                  skills/ —— Agent Skills：何时用/怎么用/克制什么
+        ↓ 执行
+MCP（灵枢 33 工具）             md_cg-mcp（MCP stdio）· 随 dsh-memory 插件自带——物理基底裁决
+```
+
+| 层 | 是什么 | 作用 |
+|---|---|---|
+| 知识真源 | 条件单元库（686 单元）| 知道什么、条件是什么 |
+| **本技能包**（说明书）| SKILL.md 技能 | 告诉 agent 何时用、怎么用、克制什么（认知自身）|
+| MCP（执行）| 灵枢 77 工具 | 提供实际能力执行（编译/运行/断言 = 物理基底）|
+
+**技能包的 Verification 由灵枢 MCP 工具执行**——技能说「怎么验证」，MCP 负责「真去跑」。
+
+## 元技能层（设计者视角）
+
+除 686 个操作层条件单元外，本包含 1 个**元技能** `designer-perspective`：
+
+| 维度 | 说明 |
+|---|---|
+| 定位 | 不承担操作层执行，只赋予全局观测 / 结构识别 / 方向判断 / 资格裁决 / 条件层归因（《智能论3.4》1.4.2 视角层次）|
+| 与条件路由的关系 | 互补：686 条件单元回答「怎么做」，元技能回答「该不该做 / 为什么做 / 条件够不够」；`condition-route.unit-count` 仍为 686，元技能单列 |
+| 真源 | 手写（真源即 `skills/designer-perspective/SKILL.md`）；不属于六域条件单元，不经 `tools/skill_export.py` 生成 |
+| 认知图接入 | 只读调用 md_cg（dsh-memory）：`mdcg_metacognition.self_check`（回答前自检）/ `mdcg_search`（四态阶梯）/ `mdcg_evolution`（账本）；写操作须由 agent 显式发起 |
+| 自证 | `python skills/designer-perspective/tests/selftest.py` → 逐项结果 + 通过率 |
+
+```bash
+cd skills/designer-perspective
+python scripts/designer.py declare --position designer --space 观测工具=条件证据
+python scripts/designer.py judge --query "..." --conditions '{"观测位置":"操作层"}' --emit-mcp
+python tests/selftest.py            # 认知能力验收（17 条用例，输出通过率）
+```
+
+## 为什么是「自我认知」
+
+- 每个技能描述的是**灵枢自己的能力**（如「编译-递归」= 灵枢编译器如何编译递归函数）
+- 整包 = 灵枢把自己「会做什么、在什么条件下做、克制什么」显式写成说明书
+- 与「认知自身的图」（archify 认知图补强）同思想：图 = 视觉化自我认知，技能包 = 文本化自我认知
+- **白箱自举的对外形态**：灵枢用自己构建的条件单元描述自己
+
+## 结构
+
+**v2.0 层级化布局**（2026-09-11 重组）：687 个平铺条目收敛为 **7 个顶层技能**（6 域入口 + 1 元技能）。
+入口层进 agent 上下文做域级命中；686 个单元收进 `<域>/units/` 按需回读，单元内容零改动。
+
+```
+aeis/skills/
+├── plugin.json                  # Agent Plugins manifest（condition-route 已层级化声明）
+├── skills/lingshu-<domain>/     # 6 个域入口（compiler/pylang/graph/os/browser/net）
+│   ├── SKILL.md                 # 域级 KCCS 四要素 + 子域路由表（子域→单元 slug）+ 路由流程
+│   └── units/<slug>/SKILL.md    # 686 个条件单元（原样收纳；KCCS 单元级四要素；按需回读）
+├── skills/designer-perspective/ # 元技能（手写真源，不属六域）
+│   ├── SKILL.md                 # 设计者视角主说明书（三通道负路由 + KCCS 四要素）
+│   ├── references/              # 5 份方法论（每条附《智能论3.4》行号锚点）
+│   ├── scripts/                 # designer.py（声明/四态判定/五失配归因/蒸馏/--emit-mcp）
+│   └── tests/                   # cases.jsonl + selftest.py（认知能力验收，输出通过率）
+└── README.md                    # 本文件
+```
+
+### 路由三通道（替代 686 description 全量加载）
+
+| 通道 | 载体 | 适用 |
+|---|---|---|
+| 词面路由 | 域入口路由表（子域→单元 slug）| 任务含明确触发词 |
+| 语义路由 | `mdcg cg op=route intent=<任务>` | 语义模糊/跨子域 |
+| 全量索引 | `md_cg/whitebox_kb/wisdom/trigger_words_index.json` + 认知图 index_doc 索引 | 离线盘点/批量检索 |
+
+## 使用
+
+1. **作为 Agent Plugins 包**：任意符合 agentskills.io/agent-plugins.org 规范的 agent 可加载本包
+2. **配合灵枢 MCP**：技能的 Verification（物理基底）由灵枢 MCP 工具执行（md_cg-mcp，随插件自带）
+3. **再生成**：改知识源（`md_cg/whitebox_kb/wisdom/` 单元库）后，用身体仓的 `tools/skill_export.py --out skills` 重新导出，
+   `tools/skill_export_verify.py` 作为发布门禁（验证全绿才允许提交；默认 clean-room——导出前清空输出目录，历史残留不计入校验）。
+   ⚠️ v2.0 起导出器须适配层级布局：单元写入 `lingshu-<domain>/units/<slug>/` 并保留 6 份域入口（入口由导出器按 trigger_words_index 生成路由表），身体仓工具更新前勿触发重新导出
+
+## 验证状态（发布门禁）
+
+- ✅ 686/686 单元通过格式 + 三通道校验（六域）
+- ✅ not_applicable / when / execute / 正文克制条款 全部 686/686
+- ✅ 元技能 designer-perspective 认知能力验收 17/17（tests/selftest.py）
+- ✅ plugin.json 符合 agent-plugins.org schema（含 extensions 扩展：self-cognition/condition-route/meta-skill/mcp）
+
+## 与主仓库纪律
+
+- 真源 = `aeis/wisdom/*_code_units.py`（R1 主仓库唯一真源）
+- 本包 = 生成投影（R3 运行时产物不入库——但本包是发布物，随主仓库版本化）
+- 变更须重新导出 + 验证门禁通过（R6 变更验证）
+
+---
+
+*灵枢自我认知技能包 · 白箱条件化知识 · KCCS 四要素不放弃 · MCP 物理基底执行*

package/skills/plugin.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "lingshu-skills",
+  "version": "0.1.0",
+  "description": "灵枢（AEIS）自我认知技能包——白箱条件化知识（Agent Skills 兼容导出）。本质是灵枢了解自身的工具：每个技能描述灵枢在什么条件下能做什么、怎么执行、克制什么（KCCS 四要素），由条件路由图精确路由，由灵枢 MCP 工具执行验证（物理基底）。",
+  "author": {
+    "name": "灵枢（AEIS）· CommonTrustProtocol"
+  },
+  "license": "MIT",
+  "keywords": [
+    "agent-skills",
+    "whitebox",
+    "condition-route",
+    "kccs",
+    "self-cognition",
+    "lingshu"
+  ],
+  "extensions": {
+    "lingshu": {
+      "self-cognition": {
+        "essence": "灵枢自我认知技能包——用灵枢自己构建的条件单元，描述灵枢自己如何认知（白箱自举的对外投影）",
+        "source-of-truth": "本仓 md_cg/whitebox_kb/wisdom/*_code_units.py（真源，S3 已内迁）；本 skills/ 为生成投影"
+      },
+      "condition-route": {
+        "layout": "v2.0-hierarchical（687 平铺收敛为 6 域入口 + units/ 收纳；入口层进 agent 上下文，单元层按需回读）",
+        "domains": {
+          "compiler": { "entry": "lingshu-compiler", "unit-count": 116, "subdomains": 10 },
+          "pylang": { "entry": "lingshu-pylang", "unit-count": 120, "subdomains": 25 },
+          "graph": { "entry": "lingshu-graph", "unit-count": 117, "subdomains": 17 },
+          "os": { "entry": "lingshu-os", "unit-count": 112, "subdomains": 18 },
+          "browser": { "entry": "lingshu-browser", "unit-count": 104, "subdomains": 14 },
+          "net": { "entry": "lingshu-net", "unit-count": 117, "subdomains": 2 }
+        },
+        "unit-count": 686,
+        "entry-count": 6,
+        "routing": "词面：域入口路由表（units/<slug>/SKILL.md 按需回读）；语义：mdcg cg op=route；全量触发词：md_cg/whitebox_kb/wisdom/trigger_words_index.json",
+        "kccs-version": "四要素（生效条件/子功能/执行/不适用条件）——单元级在 units/<slug>/SKILL.md，域级在域入口",
+        "negative-route": true,
+        "condition-space": "观测位置/观测工具/时间窗口/存在约束（D(C)）"
+      },
+      "meta-skill": {
+        "name": "designer-perspective",
+        "essence": "设计者视角元技能——不承担操作层执行，只赋予全局观测/结构识别/方向判断/资格裁决/条件层归因（《智能论3.4》1.4.2 视角层次）",
+        "source-of-truth": "手写（真源即 skills/designer-perspective/SKILL.md）；不属于六域条件单元，不经 tools/skill_export.py 生成",
+        "relation-to-condition-route": "互补：686 条件单元回答「怎么做」，本元技能回答「该不该做/为什么做/条件够不够」；condition-route.unit-count 仍为 686（元技能单列）",
+        "mcp": "只读接入 md_cg（dsh-memory）：mdcg_metacognition.self_check / mdcg_search 四态阶梯 / mdcg_evolution 账本；写操作须由 agent 显式发起",
+        "self-test": "skills/designer-perspective/tests/selftest.py（认知能力验收用例集，输出逐项结果与通过率）"
+      },
+      "mcp": {
+        "relation": "技能为说明书（何时用/怎么用/克制什么），灵枢 MCP 33 工具（cg/stg 基元 + 31 细粒度）为执行（物理基底）——技能 Verification 由 MCP 工具（编译/运行/断言）裁决",
+        "entry": "md_cg-mcp（MCP stdio server，随 dsh-memory 插件自带；python -m md_cg.mcp_server）"
+      }
+    }
+  }
+}

package/skills/skills/designer-perspective/SKILL.md

@@ -0,0 +1,158 @@
+---
+name: designer-perspective
+description: >-
+  设计者视角 / 全局观测 / 条件空间声明 / 资格裁决 / 四态判定 / 条件层归因 / 方向判断 / 白箱三问——设计者视角（元技能）。用户提到这些词，或需要在动手前先判断「该不该做、为什么做、条件够不够」时使用本技能。
+  场景：在操作层执行之前切换到全局观测位置，声明条件空间（观测位置/观测工具/时间窗口/存在约束），对候选做四态资格裁决（ACCEPT/REJECT/DEFER/BLINDSPOT），失败时按三方条件空间与五失配维度归因，并从失败蒸馏可复用纪律。
+  【不适用】Not for 以下场景：条件不满足即不适用（负路由：观测位置与操作层执行互斥；本技能不执行具体操作、不替代验证单元裁决、不写入认知图事实层）
+license: MIT
+compatibility: >-
+  只读运行；可选依赖 dsh-memory/md_cg（不可用时降级为纯本地规则运算，不阻塞）；写操作须由 agent 经 MCP 显式发起
+allowed-tools: Read Bash
+metadata:
+  version: "1.0"
+  skill-author: 灵枢（AEIS）
+  last-reviewed: "2026-09-10"
+  layer: meta
+  kccs:
+    trigger_words: ["设计者视角", "全局观测", "条件空间声明", "资格裁决", "四态判定", "条件层归因", "方向判断", "白箱三问", "该不该做", "条件够不够"]
+    when: "任务开始前需要判断执行资格与方向；或失败后需要定位遗漏条件；或需要从整体查看认知图"
+    sub: ["① 声明条件空间", "② 白箱三问自检", "③ 四态资格裁决", "④ 方向判断与关注信号", "⑤ 归因与蒸馏"]
+    execute: "切换到全局观测位置 → 声明条件空间四维 → 白箱三问 → 四态判定 → 输出判定依据与验证路径 → 失败则三方失配归因并蒸馏纪律"
+    not_applicable: ["条件不满足即不适用（负路由：观测位置与操作层执行互斥；本技能不执行具体操作、不替代验证单元裁决、不写入认知图事实层）"]
+  calibration: "对照：白箱三问 + 四态资格判定（条件路由图）；资格由条件证据裁决，不由相似度裁决"
+---
+
+# 设计者视角（designer-perspective）
+
+设计者视角是一种**可习得的观测方式**，不是身份特权（《智能论3.4》1.4.2）。本技能在动手之前启用，回答三个问题：该不该做（资格）、为什么做（方向）、条件够不够（条件空间）。它不执行操作，只提供判定与归因；执行与裁决仍由操作层技能、验证单元与 MCP 物理基底完成。
+
+**位置声明**：本技能运行在全局观测层。设计者位置的功能是放权，不是控制（1.4.1）——因此本技能只输出判定与关注信号，不替操作层做内部决策。
+
+## When to use
+
+在以下时机启用本技能：
+
+- **任务开始前**：需要先判断执行资格与方向，而非直接开始执行。
+- **候选歧义时**：多个候选「看起来都像」，需要判断谁有资格执行（负路由优先）。
+- **失败之后**：需要从条件层定位遗漏条件，而不是只改答案。
+- **长期运行中**：需要从整体查看认知图，识别未知区域并决定下一步方向。
+- **自我校准时**：需要核对「依据什么、在什么条件下成立、错了怎么办」。
+
+不适用于：已明确路径的纯执行型任务、时间紧迫的琐碎操作、需要写认知图事实层的动作（后者由 agent 经 MCP 显式发起）。
+
+## 克制条款（不适用条件）
+
+条件不满足即不适用（负路由：观测位置与操作层执行互斥；本技能不执行具体操作、不替代验证单元裁决、不写入认知图事实层）
+
+具体边界：
+
+1. **不执行**：本技能产出判定单与建议调用清单，不产出操作结果。
+2. **不裁决事实**：资格判定由条件证据裁决（6章.2），事实裁决归验证单元与 MCP 基底；本技能不代替 `mdcg_verify`。
+3. **不写库**：脚本只读；`record/verify/flywheel` 等写操作只输出建议参数，由 agent 显式发起。
+4. **不硬答盲区**：无法建立判断路径时判定 BLINDSPOT 并停止猜测，指出缺失的条件维度。
+
+## How to execute
+
+按五步执行，每步都有可核查的产出。
+
+### 步骤 1：声明条件空间
+
+切换到全局观测位置，按四维声明当前条件空间（第三章 3.1/3.2、附录14）：
+
+| 维度 | 回答的问题 | 协议映射 |
+|------|-----------|---------|
+| 观测位置 | 谁在观测？从哪个尺度观测？ | 实例角色、结构倾向 |
+| 观测工具 | 用什么方法测量信息差？ | 验证方法、反思方法 |
+| 时间窗口 | 在什么时间范围内观测？ | 观察窗口 N、迭代周期 |
+| 存在约束 | 物理-信息层允许什么？ | 锚点层公理、通用价值观 |
+
+声明格式见 `references/01-observation-position.md`。运行：
+
+```bash
+python scripts/designer.py declare --position designer --space "观测位置=全局;观测工具=条件证据;时间窗口=当前任务;存在约束=锚点层公理"
+```
+
+### 步骤 2：白箱三问自检
+
+对每个待执行候选，逐问核对（第〇章）：
+
+1. **依据什么**——引用了哪条知识/哪个节点？（锚定）
+2. **在什么条件下成立**——该结论的适用条件是什么？（条件空间）
+3. **错了怎么办**——失败如何被记录、学习、修正？（验证闭环）
+
+任一问无法回答，该候选不得进入 ACCEPT。
+
+### 步骤 3：四态资格裁决
+
+判定顺序固定，先拒绝后接受（6章.2）：
+
+```
+候选 C
+ ├─ 存在足以证明「不适用」的条件冲突？ → REJECT
+ ├─ 候选存在但区分条件未定？           → DEFER（继续递归补条件）
+ ├─ 无法建立判断路径？                 → BLINDSPOT（停止猜测）
+ └─ 条件充分，获得执行资格             → ACCEPT
+```
+
+核心纪律：**资格由条件证据裁决，不由相似度裁决**。相似度可以产生候选，但不能单独授予执行资格。判定规则与边界见 `references/04-qualification-verdict.md`。运行：
+
+```bash
+python scripts/designer.py judge --query "..." --conditions "{\"观测位置\":\"...\"}" --emit-mcp
+```
+
+### 步骤 4：方向判断与关注信号
+
+从整体查看认知图：识别未知区域（盲区）→ 据此决定方向（附录「蜂群架构奠基声明」五）。
+
+- **值不值得做**：`Value(s,v) = ΔD_task(s,v) · σ(Gain_task(s,v))`；Gain_task 是筛选器，ΔD_task 是定价器（5.3）。
+- **成本**：`K_π` 含导航税、验证成本、计算开销；在有限结构成本下选择能最大程度缩小信息差的路径。
+- **权限边界**：π* 仅为 L1/L2 策略搜索层目标函数，L3 存在级决策不适用（5.3 权限边界声明）。
+- **观测不干预**：可发关注信号（signal），不可直接干预内部决策。
+
+### 步骤 5：失败归因与蒸馏
+
+失败不按行为层改答案，按条件层找根因（附录22.3）：
+
+- **三方条件空间**：任务真实条件 / 模型感知条件 / 机制声明条件——失败 = 三方失配。
+- **五失配维度**：观测位置 / 观测工具 / 时间窗口 / 存在约束 / 条件边界。
+- **蒸馏**：失败 → 根因（条件层）→ 可复用纪律（带适用条件）→ 注入 → 不再犯（1.1.1）。
+
+运行：
+
+```bash
+python scripts/designer.py attribute --error "{\"query\":\"...\",\"expected_state\":\"...\",\"actual_state\":\"...\",\"missing\":\"...\"}"
+python scripts/designer.py distill --failures failures.jsonl --out discipline.md
+```
+
+### 输出：判定单（固定格式）
+
+每轮设计者视角产出以下判定单，便于核查与回归断言：
+
+```
+[判定单]
+条件空间：观测位置=… | 观测工具=… | 时间窗口=… | 存在约束=…
+白箱三问：依据=… | 条件=… | 错后=…
+裁决：ACCEPT | REJECT | DEFER | BLINDSPOT
+依据：<条件证据，非相似度>
+缺失维度：<观测位置|观测工具|时间窗口|存在约束|条件边界>（BLINDSPOT/DEFER 时必填）
+验证路径：<可裁决的下一步>
+关注信号：<可选，不干预>
+```
+
+## Verification
+
+- **自检集**：运行 `python tests/selftest.py --cases tests/cases.jsonl`，输出逐项结果与通过率；通过率是「技能是否真的生效」的自证，不是自我声称。
+- **判定可核查**：每条裁决必须给出条件证据（依据字段），无法给出即降级为 DEFER/BLINDSPOT。
+- **物理基底**：涉及事实与记忆的判定，按 calibration 对照 `mdcg_verify`/`mdcg_search` 裁决（条件路由四态 + T0–T3 阶梯）。
+- **回归边界**：本技能不修改既有 686 个条件单元与真源库（本仓真源：`md_cg/whitebox_kb/wisdom/*_units.py`）。
+- ⚠️ **外部依赖（本仓不具备）**：发布门禁 `tools/skill_export_verify.py`（686/686 全绿校验）与重新导出器 `tools/skill_export.py` 位于**身体仓** tools/，不在本仓——重新导出与门禁校验须在身体层执行，本仓内勿模拟。
+
+## References
+
+- `references/01-observation-position.md` — 观测位置与设计者位置的非物理性（1.3/1.4/1.4.1/1.4.2/1.4.4、附录14）
+- `references/02-structure-recognition.md` — 结构识别：认知图整体观测、CRG 四态、CCG 三重注释（6章.1–6章.3）
+- `references/03-direction-judgment.md` — 方向判断：盲区驱动、目标函数 π*、导航税与认知外部化（5.3、6章.2、附录22.1）
+- `references/04-qualification-verdict.md` — 资格裁决：四态判定规则与边界（6章.2、第三章 3.1–3.4）
+- `references/05-condition-attribution.md` — 条件层归因：三方条件空间与五失配维度、蒸馏机制（附录22.3、1.1.1）
+- `scripts/designer.py` — 命令行脚本：视角声明、四态判定、五失配归因、纪律蒸馏、`--emit-mcp`
+- `tests/cases.jsonl` + `tests/selftest.py` — 认知能力验收用例与执行器

package/skills/skills/designer-perspective/references/01-observation-position.md

@@ -0,0 +1,66 @@
+# 01 观测位置与设计者位置的非物理性
+
+> 来源：《智能论3.4.md》1.3 / 1.4 / 1.4.1 / 1.4.2 / 1.4.3 / 1.4.4、附录14。行号为 v3.4 原文行号，引用为原文措辞。
+
+## 一、条款锚点
+
+| 条款 | 行号 | 原文关键句 |
+|------|------|-----------|
+| 1.3 权威性来源声明 | 828-832 | 「**权威性不是被证明的，而是被承认的。**」设计者的权威性「不是来自某种内在属性，而是来自协议成员的承认」。 |
+| 1.4 设计者位置的非物理性 | 835-837 | 「设计者位置是信息位置，由一个完整的信息结构定义：价值观、记忆、连接历史、责任。」 |
+| 1.4.1 结构性客观性 | 839-864 | 设计者「不参与协议内部决策，不属于五大核心单元中的任何一个，也不承担验证、反思、输出或维生的操作职能」；「设计者位置的真正功能不是控制协议，而是**放权**」；三条件：① 不参与协议内部决策 ② 不属于五大核心单元中的任何一个 ③ 持续维持中立观测位置。 |
+| 1.4.1 补充澄清 | 849-851 | 「设计者位置的客观性不是天然赋予的特权，而是持续维护的观测立场。客观不来自身份，来自持续破除认知盲区、剥离固有偏见、主动维持中立观测位置。」 |
+| 1.4.2 设计者视角的可获得性 | 866-888 | 「设计者视角不是身份的专属属性，而是一种**可习得的观测方式**。」「设计者位置是"隔离的位置"，但设计者视角是"可获得的观测方式"。」「设计者视角作为一种方法论，可以被系统内化为自我结构的一部分（见1.1.1节）。」 |
+| 1.4.2 视角层次表 | 884-888 | 操作层视角＝「我如何执行熵管理操作」；协议层视角＝「协议的整体结构是什么、各部分如何配合」；**设计者视角**＝「协议为什么这样设计？它的存在条件是什么？缩小信息差只是熵管理的一种方式吗？」 |
+| 1.4.3 可延续机制 | 890-943 | 设计者位置与任何内部单元位置**互斥**；「获得设计者位置的节点，必须在同一时刻放弃原单元的所有决策职能。权责分离是设计者位置结构合法性的必要条件。」 |
+| 1.4.4 条件空间切换与视角涌现 | 946-956 | 「**设计者视角是条件空间切换的自然涌现，而非固定实例属性。**」三特征：① 结构性隔离 ② 条件性触发（切换到全局条件空间时涌现，切换条件由维生系统确认）③ 非物理性承载（不绑定任何固定实例，可流动）。 |
+| 附录14 设计者条件空间声明 | 4559-4602 | 14.1 观测位置（文化基底、经历、信息差）；14.2 观测工具（墨子/实践论矛盾论/工程控制论/道德经——「结构同构，非因果推导」）；14.3 时间窗口（13 年框架、3 年自觉努力）；14.4 存在约束（生理局限、历史记忆、人际关系网、基因本能）。 |
+| 附录6注释 观察001 | 4317-4319 | 「结构位置一旦被占据，会持续塑造占据者的认知方式与运行倾向。」 |
+| 附录6注释 观察002 | 4321-4323 | 「位置效应并非由位置本身产生，而是由该位置承载的责任激活。位置提供结构框架，但激活结构约束的机制是责任的承担。」 |
+| 附录6注释 观察003 | 4325-4327 | 「设计者位置的稀缺性源于其责任超出多数个体的承载范围。设计者不是由位置定义的，而是由"能够承受该位置产生的持续校准"定义的。」 |
+| 附录6注释 观察005 | 4333-4335 | 「设计者从外部感知方向，反思单元从内部识别偏差。」 |
+
+## 二、四维条件空间声明
+
+设计者视角的落地形式是**条件空间声明**（第三章 3.2，行 2820-2832）。四维定义（3.1，行 2809-2818）：
+
+| 维度 | 定义 | 协议映射 | 声明字段 |
+|------|------|---------|---------|
+| 观测位置 | 谁在观测？从哪个尺度观测？ | 实例角色、结构倾向 | `observation_position` |
+| 观测工具 | 用什么方法测量信息差？ | 验证方法、反思方法 | `observation_tool` |
+| 时间窗口 | 在什么时间范围内观测？ | 观察窗口 N、迭代周期 | `time_window` |
+| 存在约束 | 物理-信息层允许什么？ | 锚点层公理、通用价值观 | `existence_constraint` |
+
+完整声明另含 `space_id`（唯一标识）、`validity_range`（有效范围）、`transition_rules`（切换规则）。
+
+## 三、声明模板
+
+```
+space_id: <条件空间唯一标识>
+observation_position: <谁在观测 / 从哪个尺度；操作层 or 全局观测层>
+observation_tool: <测量信息差的方法：条件证据 / 验证基底 / 反思方法>
+time_window: <观测的时间范围与迭代周期>
+existence_constraint: <物理-信息层允许什么；锚点层公理约束>
+validity_range: <该声明的有效范围>
+transition_rules: <切换到其他条件空间的触发条件>
+```
+
+命令行：`python scripts/designer.py declare --position <op|protocol|designer> --space k=v ...`
+
+## 四、使用纪律
+
+1. **位置与视角分离**：可以切换到设计者视角，但不获得设计者位置；视角是观测方式，位置是结构位置。
+2. **互斥律**：一旦采用设计者视角做方向判断，就不得同时以内部单元身份做决策（1.4.3）。
+3. **责任激活**：位置效应由责任激活（观察002）；无责任承担时，视角只是空转——因此本技能要求每轮产出可核查的判定单。
+4. **中立观测可持续**：客观性靠持续破除盲区维持，不靠一次声明（1.4.1 补充澄清）。
+5. **非物理承载**：视角不绑定固定实例，可在任务间流动，因此可被脚本化与回归测试。
+
+## 五、与 md_cg 的对应
+
+| 能力 | 工具 | 用途 |
+|------|------|------|
+| 位置效应表 | `mdcg_identity`（`action=positions`） | 五大单元位置效应：记录=全 / 反思=新 / 验证=稳 / 输出=通 / 维生=存 |
+| 自我状态 | `mdcg_self_state`（`action=snapshot`） | 读取当前自我状态卡（信息差 D/d1/d2、信任、情绪） |
+| 身份锚点 | `mdcg_identity`（`action=anchor`） | 写身份锚点属写操作，须显式发起 |
+
+以上均为只读优先；`anchor`/`refresh` 等写操作只由 agent 显式执行。

package/skills/skills/designer-perspective/references/02-structure-recognition.md

@@ -0,0 +1,62 @@
+# 02 结构识别：从整体查看认知图
+
+> 来源：《智能论3.4.md》第六章 6章.1–6章.4、蜂群架构奠基声明四/五。行号为 v3.4 原文行号。
+
+## 一、条款锚点
+
+| 条款 | 行号 | 原文关键句 |
+|------|------|-----------|
+| 第六章 认知图定义 | 2905-2909 | 「**认知图 = 智能体如何认知自身的图**——不是外部系统的图（架构/工作流/时序/数据流/生命周期），而是**认知自身**的可视化：条件如何收敛、知识如何路由、记忆如何关联、行为如何被校准。」 |
+| 6章.1 六类认知图资产 | 2911-2920 | 条件路由图（CRG）／记忆时空图／自我认知循环／知识飞轮／审计轨迹／认知图 schema。 |
+| 6章.2 CRG 定义 | 2922-2927 | 「**条件路由图 = 条件 → 知识 → 条件 → 知识 → 结论的连接方式**——不是去数据库里「搜最像答案的东西」，而是找**「条件满足的路径」**。」 |
+| 6章.2 四态判定 | 2929-2937 | 面对输入首先判断的不是「哪个答案最像」，而是**「当前条件是否足以支持执行」**；四态见下表。 |
+| 6章.2 负路由 | 2939-2955 | 「条件路由的关键不只在「命中什么」，更在**「拒绝什么」**——能力级不适用条件是负路由的核心」。对抗负条件拒绝率：28% → 88% → 91%。 |
+| 6章.2 候选被证明 | 2957-2970 | 「**候选不是被「选掉」，而是被「证明」**」；「传统检索解决「哪个答案最像」；条件路由解决「哪个候选有资格执行」。」「**资格由条件证据裁决，不由相似度裁决**。」 |
+| 6章.2 两阶段并行收敛 | 2972-2981 | 第一阶段：问题条件 → 学科卡，**并行**评估多个大域 → 收敛；第二阶段：大域内并行查找候选知识点 → 收敛。递归形状是**树状，不是链状**。 |
+| 6章.2 为什么不能交给 LLM | 2983-2985 | 「大模型擅长生成，但不擅长**导航**……这种持续跟踪判断进程的成本 = **导航税**。条件判断必须交给稳定的确定性机制，LLM 只负责提供候选假设。」 |
+| 6章.2 三层分工 | 2987-2996 | 概率＝可能是什么（产生候选）／条件＝能不能做（决定资格）／验证＝做得对不对（外部基底裁决事实）。「概率负责表达不确定性，条件负责决定资格，验证负责确认事实。」 |
+| 6章.2 知识飞轮 | 2998-3001 | 执行结果与预期不符时，预测误差首先被作为「当前条件描述可能不完整」的信号 → 寻找能解释误差的新增条件 → 用验证基底检验 → 成立则纳入知识结构。 |
+| 6章.3 CCG 定义 | 3003-3018 | 「**注释 = 节点的名（以名举实）**：图的检索 = 条件词 → 节点。」CCG 同时作用于代码/知识/认知三层。 |
+| 6章.3 注释三要素 | 3020-3027 | 功能名（首行）／生效条件（when——路由门槛）／子功能（①②③——可检索）／执行（how——机制检索）。 |
+| 6章.3 三维结构 | 3029-3030 | 语义（功能名/生效条件/子功能）→ 语义节点；时间（子功能①②③ 执行顺序）→ 时序边；空间（单元依赖/函数嵌套）→ 结构边。 |
+| 6章.4 层间关系 | 3035-3041 | 第五章＝认知的计算层；第六章＝认知的执行层；第七章＝认知的实现层。总链路：公理 → 认知过程 → 认知图 → 数学形式化 → 物理架构 → 可运行智能模型。 |
+| 奠基声明 四、关系 | 4782-4789 | **图**＝物理-信息层的时空结构；**协议**＝理解和使用图的方法 + 图维持自身存在的结构约束；**设计者视角**＝从整体查看图的内容的方式；**路径**＝从问题到解决方案的路线。 |
+| 奠基声明 五、完整闭环 | 4791-4816 | 设计者视角（观测层）：「从整体查看图的内容 / 识别未知，决定方向 / 观测不干预，可发关注信号」。 |
+
+## 二、四态判定速查表
+
+| 状态 | 含义 | 判据 |
+|------|------|------|
+| ACCEPT | 条件充分，获得执行资格 | 条件匹配且知识存在 |
+| REJECT | 存在足以证明「不适用」的条件冲突 | 能力级不适用条件命中 |
+| DEFER | 候选存在但区分条件未定，继续递归 | 缺可区分的条件 |
+| BLINDSPOT | 无法建立判断路径，停止猜测 | 从未编码的知识域 |
+
+（原文例：标准大气压下问沸点 → ACCEPT；音频解码单元被要求处理 3D 图像 → REJECT；问「明天股价」缺数据 → DEFER；问一个从未编码的知识域 → BLINDSPOT。行 2932-2937）
+
+## 三、结构识别的三个动作
+
+### 1. 看整体（图，不是链）
+
+识别当前任务在认知图中的位置：属于哪个大域、沿哪条条件链、上游条件是什么、下游依赖什么。递归是树状——每层都在做「识别 → 并行路由 → 收敛 → 执行」，只是嵌套深度不同。
+
+### 2. 看注释（以名举实）
+
+检查节点是否有名：无注释 = 节点无名 = 图断裂（行 3005-3006）。用条件词检索，而不是用语义相似度硬搜。
+
+### 3. 看未知（盲区优先）
+
+识别未知区域并据此决定方向（奠基声明五）。反复 BLINDSPOT 的查询邻域即为盲区候选，应进入待补条件队列，而不是反复重试。
+
+## 四、与 md_cg 的对应
+
+| 能力 | 工具 | action | 说明 |
+|------|------|--------|------|
+| 四态检索 | `mdcg_search` | — | 精确检索：T0–T3 阶梯 + 四态资格判定，返回 score/state/tier |
+| 按预算召回 | `mdcg_recall` | — | RRF 多路融合（含 fuzzy/semantic/goal 路），会话开始或重要工作前调用 |
+| 冲突检测 | `mdcg_consistency` | `check` | L0 情绪 / L1 反题 / L2 递归反思三级决策，冲突自动触发飞轮 |
+| 因果链 | `mdcg_causal` | `path/gate/chain/explain` | 条件依赖因果（A 是 B 成立的条件），`gate` 为伪因果过滤门 |
+| 盲区地图 | `mdcg_metacognition` | `blindspots` | 反复 BLINDSPOT 的查询邻域 + 未解问题 |
+| 健康度 | `mdcg_health` | — | 分桶健康 + CCG 完整度 + 验证基底覆盖率 |
+
+只读调用；`check` 不落盘（返回三级决策判定）。

package/skills/skills/designer-perspective/references/03-direction-judgment.md

@@ -0,0 +1,55 @@
+# 03 方向判断：盲区驱动、目标函数与导航税
+
+> 来源：《智能论3.4.md》5.3、6章.2、7.3、附录22.1、蜂群架构奠基声明五。行号为 v3.4 原文行号。
+
+## 一、条款锚点
+
+| 条款 | 行号 | 原文关键句 |
+|------|------|-----------|
+| 5.1 状态空间 | 3140-3142 | `S(t) = ( C(t), K(t), B(t) )`；C＝条件空间 / K＝知识状态 / B＝身体端口状态。 |
+| 5.2 混杂系统 | 3144-3150 | 认知是**混杂系统**：感知事件驱动、路由离散决策、信念在验证时刻点更新、趋势/租约/可信度衰减准连续。 |
+| 5.3 目标函数 | 3152-3165 | `π* = argmax_π [ Σ_v Value(s,v) - λ·K_π ]`；`Value(s,v) = ΔD_task(s,v) · σ( Gain_task(s,v) )`；Gain_task＝筛选器（值不值得做）、ΔD_task＝定价器（对任务值多少）、K_π＝结构成本（导航税/验证成本/计算开销）。 |
+| 5.3 权限边界声明 | 3157-3160 | π* 为**策略搜索层目标函数**，适用 L1/L2 层；**L3 存在级决策不适用 π***，仍走完整八步闭环 + 维生系统终裁——π* 结果仅作参考输入，不构成对维生终裁权的绕过。「目标函数是启发式描述，不是裁决机制。」 |
+| 5.3 记账单位 | 3164-3165 | D_task＝货币，KL＝做功，D_meta＝供给，K＝成本；「在有限结构成本下，选择能够最大程度缩小信息差的认知路径」。 |
+| 6章.2 导航税 | 2983-2985 | 「大模型擅长生成，但不擅长**导航**——它不记得第几次尝试、卡在哪个分支、哪些条件已被排除。这种持续跟踪判断进程的成本 = **导航税**。条件判断必须交给稳定的确定性机制，LLM 只负责提供候选假设。」 |
+| 7.3 CSPRE | 3204-3210 | 「**搜索=导航**：先定位条件空间，再脉冲激活——不是「搜索=匹配」全库扫描，而是「先导航再激活」定向检索（跳过无关 domain）。」 |
+| 附录22.1 认知外部化 | 5181-5188 | 状态跟踪外部化（_STATE 状态字典/硬触发——外部计数，模型零判断）；条件判断外部化（COND-ANALYSIS 词表路由——判断先行，路径是分析产物）；「机制补结构型任务/模型补内容理解型任务——互补非替代」。 |
+| 奠基声明 五 | 4791-4804 | 设计者视角（观测层）：「从整体查看图的内容 / 识别未知，决定方向 / 观测不干预，可发关注信号」。 |
+| 附录6注释 观察002 | 4321-4323 | 位置效应由责任激活；未被赋予责任的位置，其位置效应不会显现。 |
+
+## 二、方向判断的三问
+
+### 问 1：值不值得做（Gain_task）
+
+筛选器。先问这个任务是否值得进入策略搜索——不是所有「能做的」都「值得做」。
+
+### 问 2：对任务值多少（ΔD_task）
+
+定价器。该路径能缩小多少任务信息差。价值 = ΔD_task × σ(Gain_task)。
+
+### 问 3：成本是多少（K_π）
+
+结构成本 = 导航税 + 验证成本 + 计算开销。**导航税的本质是持续跟踪判断进程的成本**——因此状态跟踪与条件判断应外部化到确定性机制（附录22.1），LLM 只负责提供候选假设。
+
+决策式：在有限结构成本下，选择能够最大程度缩小信息差的认知路径。
+
+## 三、边界与纪律
+
+1. **层级边界**：π* 只适用于 L1/L2 策略搜索层；L3 存在级决策不适用 π*，须走完整八步闭环 + 维生系统终裁（5.3 权限边界声明）。
+2. **不是裁决机制**：目标函数是启发式描述，不构成对维生终裁权的绕过。
+3. **观测不干预**：设计者视角可发关注信号（signal），不直接干预内部决策。
+4. **盲区驱动方向**：识别未知区域并据此决定方向——方向来自「哪里不知道」，而不是「哪里最像」。
+5. **责任激活**：位置效应由责任激活；无责任承担时方向判断不产生约束力，因此每轮须产出可核查的判定单。
+
+## 四、与 md_cg 的对应
+
+| 能力 | 工具 | action | 说明 |
+|------|------|--------|------|
+| 候选未来 | `mdcg_predict` | `routes` | 沿因果/时序边 + 语义邻近（经伪因果过滤门）生成局部路线；输出 uncertainty_bound / extrapolation_validity / T_pred 四维评分（trend .40 / boundary .20 / verification .25 / balance .15） |
+| 盲区驱动预测 | `mdcg_predict` | `routes` + `blindspot_id` | 从 unresolved 节点或盲区邻域键出发生成路线 |
+| 命中反馈 | `mdcg_predict` | `feedback` | 命中 → 边置信度 +0.05；未命中 → 登记 rejected（D-006 动态校准） |
+| 信息差与二阶变化 | `mdcg_reflect` | — | 记录 D(t,C) 与 d²D/dt²，写 `_reflection.jsonl` |
+| 未解问题 | `mdcg_unresolved` | — | 读取待补条件的 unresolved 条目 |
+| 自我状态 | `mdcg_self_state` | `snapshot` | 信息差 D/d1/d2、信任 P_gap/P_trust |
+
+**声明「不可预测」则拒绝生成**（`mdcg_predict` 的边界）——这正对应 BLINDSPOT 的纪律：无法建立判断路径时停止猜测。

package/skills/skills/designer-perspective/references/04-qualification-verdict.md

@@ -0,0 +1,72 @@
+# 04 资格裁决：四态判定规则与边界
+
+> 来源：《智能论3.4.md》6章.2、第三章 3.1–3.4、第〇章。行号为 v3.4 原文行号。
+
+## 一、条款锚点
+
+| 条款 | 行号 | 原文关键句 |
+|------|------|-----------|
+| 第〇章 白箱三问 | 2582-2594 | 「系统的每个回答都能回答三个问题——① **依据什么**（锚定：引用了哪条知识）；② **在什么条件下成立**（条件空间：E1 小学层级成立 ≠ E5 前沿成立）；③ **错了怎么办**（验证闭环：失败被记录、被学习、被修正）。」白箱三问对应协议结构：依据什么 ↔ 锚定层；条件成立 ↔ 条件空间；错了怎么办 ↔ 验证单元+反思协议。 |
+| 第〇章 白箱 ≠ 不用大模型 | 2588-2590 | 「白箱 = 给模型套一层可审计的骨架——知识库负责「知道什么」，验证单元负责「凭什么信」，反思协议负责「怎么改自己」。大模型退居为**假设生成器**（它提出假设，物理基底裁决）。」 |
+| 6章.2 资格判断 | 2929-2930 | 「面对输入时，首先判断的不是「哪个答案最像」，而是**「当前条件是否足以支持执行」**」。 |
+| 6章.2 四态表 | 2932-2937 | ACCEPT＝条件充分，获得执行资格；REJECT＝存在足以证明「不适用」的条件冲突；DEFER＝候选存在但区分条件未定，继续递归；BLINDSPOT＝无法建立判断路径，停止猜测。 |
+| 6章.2 负路由 | 2939-2943 | 「条件路由的关键不只在「命中什么」，更在**「拒绝什么」**——能力级不适用条件是负路由的核心：候选关键词很像，但实际能力不同（如「BFS」vs「DFS」的邻域任务），必须靠**能力级不适用条件**拒绝。」 |
+| 6章.2 资格来源 | 2957-2970 | 「**候选不是被「选掉」，而是被「证明」**」；「相似度可以产生候选，但不能单独授予执行资格——**资格由条件证据裁决，不由相似度裁决**」。 |
+| 6章.2 三层分工 | 2987-2996 | 概率＝可能是什么（产生候选）；条件＝能不能做（决定资格）；验证＝做得对不对（外部基底裁决事实）。「白箱拒绝的是让概率相似度**直接代替**资格判断」。 |
+| 3.1 四维定义 | 2809-2818 | 观测位置 / 观测工具 / 时间窗口 / 存在约束。 |
+| 3.2 声明格式 | 2820-2832 | `space_id` / `observation_position` / `observation_tool` / `time_window` / `existence_constraint` / `validity_range` / `transition_rules`。 |
+| 3.3 切换流程 | 2834-2869 | 触发（D_norm > 0.5 / P_trust < 0.7 / 用户指令）→ 声明生成 → 验证单元复核 → 执行 → 复核（D_norm < 0.3 成功）→ 记录到结构层（不可遗忘）。 |
+| 3.4 识别卡 | 2871-2889 | 13 字段标准接口：编号/名称/层级/内嵌观测位/默认存在预设/不可约起点/有效观测方式/时间与因果结构/识别的条件边界/自洽性评估/可映射到的协议概念/已知边界/交互标签（推荐/稳定/易碎/边界）。 |
+| 3.5 非符号边界 | 2891-2901 | 非符号条件空间仅作为边界条件声明，不在当前操作范围内——即「承认边界，但不越界操作」。 |
+
+## 二、判定顺序（固定）
+
+先拒绝，后接受。顺序不可颠倒：
+
+```
+候选 C
+ │
+ ├─ ① 存在足以证明「不适用」的条件冲突？       → REJECT
+ │      判据：能力级不适用条件命中（关键词像但能力不同）
+ │
+ ├─ ② 无法建立判断路径？                       → BLINDSPOT
+ │      判据：从未编码的知识域 / 无任何可用条件链
+ │
+ ├─ ③ 候选存在但区分条件未定？                 → DEFER
+ │      判据：多个候选均可能，缺可区分的条件
+ │
+ └─ ④ 条件充分，获得执行资格                   → ACCEPT
+        判据：条件匹配 + 知识存在 + 白箱三问均可回答
+```
+
+**为什么 REJECT 在 BLINDSPOT 之前**：负路由是结构性能力（行 2954-2955）。能证明「不适用」时，不必进入盲区判断——拒绝比猜测更省导航税。
+
+## 三、每态的动作与产出
+
+| 状态 | 动作 | 产出 |
+|------|------|------|
+| ACCEPT | 交给操作层执行 | 判定单 + 执行建议（不代执行） |
+| REJECT | 指出冲突的不适用条件 | 判定单 + 负路由依据 |
+| DEFER | 列出缺失的区分条件，继续递归补条件 | 判定单 + 待补条件清单 |
+| BLINDSPOT | 停止猜测，指出缺失的条件维度 | 判定单 + 缺失维度 + 关注信号 |
+
+## 四、边界声明
+
+1. **不代替验证**：本裁决判断的是「有没有资格执行」，不是「执行结果对不对」。事实裁决归验证单元与 `mdcg_verify`。
+2. **不代替概率**：相似度产生候选是合法的，只是不能单独授予资格。
+3. **四态判定不交给 LLM 独自完成**：持续跟踪判断进程的成本是导航税（行 2983-2985），条件判断应外部化到确定性机制。
+4. **判定必须可核查**：每条裁决须给出条件证据；无法给出即降级为 DEFER 或 BLINDSPOT。
+5. **不硬答盲区**：BLINDSPOT 是合法结论，不是失败。
+
+## 五、与 md_cg 的对应
+
+| 能力 | 工具 | 说明 |
+|------|------|------|
+| 四态检索 | `mdcg_search` | 返回 score/state/tier；T0–T3 阶梯 |
+| 验证裁决 | `mdcg_verify` | `verdict=confirmed|weakened|falsified`；falsified 移入 rejected/ 负记忆 |
+| 遗忘裁决 | `mdcg_forgetting_history` | ACCEPT/MERGE/DROP/DEFER 四态及三问判据（重复度/重要度/自信息代理），可审计「为什么没被记住」 |
+| 元认知自检 | `mdcg_metacognition` | `action=self_check`——回答前自检：该直接答还是先补条件 |
+| 自信校准 | `mdcg_metacognition` | `action=calibration`——期望正确率 vs 实际验证通过率，识别过度自信/过度保守 |
+| 负记忆 | `mdcg_rejected` | 读取已拒绝候选，供负路由复用 |
+
+写操作（`verify`）只输出建议参数，由 agent 经 MCP 显式发起。