@furongjun1999/dsh-memory 0.4.3 → 0.4.5

package/docs//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md

@@ -0,0 +1,221 @@
+# 功能调用映射表 v0.1（功能 → 显式代码）
+
+> 目标：**任何一个功能，都能从这份文档查到它调用的是哪段代码**。
+> 所有调用都是显式的——没有隐式 provider、没有隐式记忆后端。
+>
+> 版本：v0.1 · 2026-09-10 · 对应改造：md_cg 唯一真源 / AEIS 降能力库 / 白箱下线 / roleplay+mutual 归 LIB。
+
+---
+
+## 0. 三条总原则
+
+| 原则 | 含义 | 落点 |
+| --- | --- | --- |
+| **唯一真源** | 记忆的写 / 读 / 裁决 / 留痕只有一处：md_cg 认知图 | `md_cg/` |
+| **能力库** | AEIS 不再存记忆，只提供能力（白箱引擎、角色生成） | 由 md_cg 显式调用 |
+| **显式调用** | 每个功能 = 一条写明参数的调用，可 grep 可追踪 | 本表 |
+
+```
+DSH 插件 (src/)
+   │  src/lib/mdcg_client.ts  ← 插件侧唯一显式入口
+   ▼
+MCP stdio：md_cg/mcp_server.py
+   │  cg(op=...) / stg(op=...)        ← 两个认知基元（kernel 面）
+   │  mdcg_remember                  ← 写入工具（跳过 audit 的写入口，见 §1 注）
+   ├──────────────► md_cg/*.py        （认知图内部实现）
+   └─ cg(op=whitebox) ─► md_cg/whitebox.py ─► AEIS 能力库（python -m aeis.mcp.server）
+```
+
+---
+
+## 1. 认知基元 `cg`（`md_cg/mcp_server.py:_cg_call`，入口 L1058）
+
+| 功能 | 显式调用 | 代码位置 |
+| --- | --- | --- |
+| 服务信息 / 健康 | `cg(op=info)` | `mcp_server.py:1062` → `audit.kinds` |
+| 路由：意图→知识+建议能力 | `cg(op=route)` | `mcp_server.py:1070` → `MdCG.search` |
+| 读取（按 id / 召回 / 预算） | `cg(op=read)` | `mcp_server.py:1090` → `MdCG.get` / `MdCG.recall` / `MdCG.search` |
+| 写入（含冲突检测/闸门/**审核**） | `cg(op=write)` | `mcp_server.py:1344` → `audit.audit` + `MdCG.add` / `remember_gated` / `propose` |
+| **插件写入入口（跳过审核）** | `mdcg_remember` | `mcp_server.py:1691` → `MdCG.remember_gated`（gated=true）/ `MdCG.add`（gated=false） |
+| 目标 | `cg(op=goal)` | `mcp_server.py:1190` → `MdCG.add_goal` / `set_goal_status` / `list_goals` |
+| 最近记忆 | `cg(op=recent)` | `mcp_server.py:1209` → `MdCG.remember_event` / `recent_events` |
+| 外部裁决回填 | `cg(op=verify)` | `mcp_server.py:1221` → `MdCG.verify` |
+| 审核队列 | `cg(op=review)` | `mcp_server.py:1225` → `MdCG.review_*` |
+| 主动遗忘 / 恢复 | `cg(op=forget)` | `mcp_server.py:1241` → `MdCG.forget` / `restore` |
+| 保护（不可遗忘） | `cg(op=protect)` | `mcp_server.py:1247` → `_protect_call` → `md_cg/protect.py` |
+| 身份维度 | `cg(op=identity)` | `mcp_server.py:1250` → `_identity_call` → `md_cg/identity.py` |
+| 一致性检测 | `cg(op=consistency)` | `mcp_server.py:1253` → `_consistency_call` → `md_cg/consistency.py` |
+| 元认知 | `cg(op=metacognition)` | `mcp_server.py:1256` → `_metacognition_call` → `md_cg/metacognition.py` |
+| 自我状态 | `cg(op=self_state)` | `mcp_server.py:1259` → `_self_state_call` → `md_cg/self_state.py` |
+| 飞轮 / 自愈 | `cg(op=sustain)` | `mcp_server.py:1262` → `_sustain_call` → `md_cg/sustain.py` |
+| 洗脑 / 去污染 | `cg(op=scrub)` | `mcp_server.py:1265` → `_scrub_call` → `md_cg/scrub.py` |
+| 预测 / 因果门 | `cg(op=predict)` | `mcp_server.py:1268` → `_predict_call` → `md_cg/predict.py` |
+| 因果链 | `cg(op=causal)` | `mcp_server.py:1271` → `_causal_call` → `md_cg/chain.py` |
+| **白箱能力库** | `cg(op=whitebox)` | `mcp_server.py:1274` → `_whitebox_call` → `md_cg/whitebox.py`（见 §3） |
+| 代码索引 | `cg(op=index_code)` | `mcp_server.py:1277` → `md_cg/codeindex.py` |
+
+> ⚠️ **插件写入必须走 `mdcg_remember`，不能走 `cg(op=write)`**：
+> `cg(op=write)` 先过 `audit.audit(content_kind)`，未声明 `content_kind` 且未配置
+> `MDCG_POLICY_FILE` 时恒判 BLINDSPOT/DEFER —— 只进审核队列、**永不落盘**。
+> 实测：自动记忆走 `cg(op=write)` 时 0 篇 md 文档；改用 `mdcg_remember(gated=true)`
+> 后 verdict=ACCEPT、md 文档数=1、timeline/read 均命中。
+> `cg(op=write)` 仍保留给「需要审核留痕的显式写入」场景。
+
+## 2. 语义时空基元 `stg`（`mcp_server.py:_stg_call`，入口 L1316）
+
+| 功能 | 显式调用 | 代码位置 |
+| --- | --- | --- |
+| 两节点关系 | `stg(op=relation)` | `mcp_server.py:1320` → `stg.relation` |
+| 时间线 | `stg(op=timeline)` | `mcp_server.py:1322` → `stg.timeline` |
+| 锚点检索 | `stg(op=anchors)` | `mcp_server.py:1326` → `stg.anchors` |
+| 时空一致性 | `stg(op=consistency)` | `mcp_server.py:1329` → `stg.consistency` |
+
+## 3. 白箱能力库（`md_cg/whitebox.py`，AEIS 降为能力库后的唯一入口）
+
+白箱 LLM provider **已下线**（不再注册 `lingshu-whitebox`）；能力改由 md_cg 显式调用并留痕。
+
+| 功能 | 显式调用 | 代码位置 |
+| --- | --- | --- |
+| 统一分发 | `cg(op=whitebox, action=...)` | `mcp_server.py:1274` → `_whitebox_call`（L1306）→ `whitebox.dispatch`（`whitebox.py:387`） |
+| 白箱问答 | `action=ask` | `whitebox.py:322 ask` → `WhiteboxClient.ask`（`whitebox.py:185`）→ 能力库 `wisdom_chat` |
+| 白箱编码 | `action=remember` | `whitebox.py:334 remember` → `WhiteboxClient.remember`（`whitebox.py:194`）→ 能力库 `remember` |
+| **验证编码能力** | `action=verify_encoding` | `whitebox.py:234 verify_encoding`：写入口令→追问命中 |
+| **验证已有知识回答能力** | `action=verify_existing` | `whitebox.py:266 verify_existing`：探针问题 route=self 且非空 |
+| 连通性探测 | `action=ping` | `whitebox.py:300 ping` |
+| 验证报告 | `action=report` | `whitebox.py:366 report`（self 层留痕汇总） |
+| 留痕 | — | `whitebox.py:350 _record` → `cg.add(layer=self, tags=['whitebox:verify'], verification_basis='test')` |
+
+> 细粒度工具别名：`mdcg_whitebox`（`mcp_server.py:1345`）与 `cg(op=whitebox)` 等价。
+> 启动命令可由 `MDCG_WHITEBOX_CMD` / `MDCG_WHITEBOX_ARGS` / `MDCG_WHITEBOX_TIMEOUT` 覆盖（`whitebox.py:61`）。
+
+## 4. 插件侧 LIB 本地库（`src/lib/`）
+
+### 4.1 `mdcg_client.ts` —— 插件调用认知图的唯一显式入口
+
+| 插件方法 | 映射到 | 说明 |
+| --- | --- | --- |
+| `cg(args)` / `stg(args)` | MCP `cg` / `stg` | 逃生口，显式传参 |
+| `route(intent)` | `cg(op=route)` | 意图 → 知识 + 建议能力 |
+| `read(query)` / `get(nodeId)` | `cg(op=read)` | 语义召回 / 按 id 取 |
+| `write(content, extra)` | MCP `mdcg_remember`（gated=false） | 直写 `MdCG.add`；角色 / 转录 / 导入复用 |
+| `remember(content, extra)` | MCP `mdcg_remember`（gated=true, layer=contextual） | 记忆沉淀 + 主动遗忘闸门 |
+| `recall(query, k)` | `cg(op=read, query, k)` | 语义召回；读取记 access log（复用观测） |
+| `verify(nodeId, evidence, verdict)` | `cg(op=verify)` | 外部裁决回填 |
+| `recent(limit)` | `cg(op=recent)` | 近期事件窗口 |
+| `timeline(limit)` | `stg(op=timeline)` | 最近记忆时间线（自动召回注入用） |
+| `identity(subjectId)` | `cg(op=identity)` | 身份维度读取 |
+| `whitebox(action, extra)` | `cg(op=whitebox)` | 白箱能力验证 |
+| `serviceInfo()` | `cg(op=info)` | 服务信息 |
+| `verifyClaim(claim)` | `cg(op=read)` + 依据强度判定 | 互维 memory 通道 |
+| `writeRole(roleId, content)` | `mdcg_remember(layer=knowledge)` | 角色定义落图 |
+| `writeTranscript(roleId, sid, who, text)` | `mdcg_remember(layer=contextual)` | 对话转录落图 |
+
+身份注入：`MDCG_ROOT / MDCG_TENANT / MDCG_CLEARANCE / MDCG_ACTOR / MDCG_IDENTITY`
+（`mdcg_client.ts` 构造器）。**写入还需凭据**：`MDCG_TOKEN`（推荐）或
+`MDCG_LEGACY_ENV_AUTH=1`（兼容旧部署）——**两者都不设即默认状态**：只读 guest
+（读 / 召回 / 时间线可用，写入全失败、不落盘）。
+
+### 4.2 `roleplay_web.ts` —— 角色扮演网页（LIB 本地库）
+
+| 功能 | 显式调用 | 代码位置 |
+| --- | --- | --- |
+| 对话生成 | 能力库 `roleplay_chat` | `roleplay_web.ts:765` |
+| 用户发言落图 | `MdcgClient.writeTranscript(role, cid, 'user', msg)` | `roleplay_web.ts:765` → `mdcg_remember` |
+| 角色回复落图 | `MdcgClient.writeTranscript(role, cid, 'assistant', reply)` | `roleplay_web.ts:784` → `mdcg_remember` |
+| 新建角色 | 能力库 `role_create` + `MdcgClient.writeRole` | `roleplay_web.ts:848` / `851` |
+| 导入记忆/锚点/价值观 | 能力库 `role_import` + `MdcgClient.write`（三导入→knowledge/self/structural） | `roleplay_web.ts:681` / `692` |
+| 落图开关 | `toGraph(label, fn)`（未就绪静默跳过，失败仅告警） | `roleplay_web.ts:451` |
+
+### 4.3 `mutual.ts` —— 互维维护（LIB 本地库）
+
+| 功能 | 显式调用 | 代码位置 |
+| --- | --- | --- |
+| memory 通道核验 | `MdcgClient.verifyClaim`（注入），未就绪回退能力库 `wisdom_verify` | `index.ts:274` |
+| 复核通道 | 能力库 `think`（DeepSeek 独立复核） | `index.ts:296` |
+| 双通道合并裁决 | `combineVerdict` | `mutual.ts:236` |
+| 任务处理 | `processTask` → `whiteboxVerify` + `llmReview` | `mutual.ts:267` |
+| 心跳 / 任务扫描 | `writeHeartbeat` / `scanTasks` | `mutual.ts`（默认导出 L406） |
+
+### 4.4 `whitebox_llm.ts` —— 白箱 LLM 适配器（**已下线，保留为本地库**）
+
+- 不再被 `src/index.ts` 安装 → DSH 设置页无 `lingshu-whitebox` provider。
+- 保留原因：未来成熟后恢复；或作为库复用 `isCardFormat()` 等纯函数。
+- 白箱能力验证改走 §3 的 `cg(op=whitebox)`。
+
+## 5. 数据迁移
+
+| 功能 | 显式命令 | 代码位置 |
+| --- | --- | --- |
+| AEIS（sqlite）→ 认知图 | `python -m md_cg.migrate_aeis --db <sqlite> --root <md_root>` | `md_cg/migrate_aeis.py:migrate` |
+| 角色扮演 + 互维 → 认知图 | `python -m md_cg.migrate_roleplay --data-dir <roleplay_data> --root <md_root> [--mutual-dir <~/.lingxu_net>]` | `md_cg/migrate_roleplay.py:migrate` |
+
+`migrate_roleplay` 的映射：
+
+| 源 | 目标层 | node_id |
+| --- | --- | --- |
+| `roleplay/_roles.json` 角色 | knowledge | `roleplay_role_<id>` |
+| `*_items`（memory / anchors / values） | knowledge / self / structural | `roleplay_<role>_<kind>_<i>` |
+| `transcripts/<role>__<cid>.jsonl` 每轮 | contextual | `roleplay_turn_<role>_<cid>_<idx>` |
+| 互维 `result-<id>.json` / `task-<id>.json` | contextual | `mutual_task_<id>` |
+
+验证：P18 `python -m md_cg.test_p18_whitebox`；P19 `python -m md_cg.test_p19_migrate_roleplay`。
+
+## 6. 配置项 → 生效位置
+
+| 配置 | 默认 | 生效位置 |
+| --- | --- | --- |
+| `mdcg.enabled` | true | `index.ts:189` 是否启动认知图子进程 |
+| `mdcg.root` | `data/mdcg` | `MDCG_ROOT` → `mdcg_client.ts:81` |
+| `mdcg.actor` | `dsh-memory` | `MDCG_ACTOR`；**须与迁移 `--actor` 一致** |
+| `mdcg.tenant` | `default` | `MDCG_TENANT`；**须与迁移 `--tenant` 一致** |
+| `mdcg.clearance` | `private` | `MDCG_CLEARANCE`；决定能读写的密级上限 |
+| `env.MDCG_TOKEN` | **无（写权限默认关闭）** | 认知图写入凭据。签发：`python -m md_cg.tokens issue --role designer --actor dsh-memory --clearance internal --ops-allow … --layers-allow …`（`--ops-allow` / `--layers-allow` 只能收窄，`--role recorder` 为最小权限版） |
+| `env.MDCG_LEGACY_ENV_AUTH` | 无 | 兼容旧部署的 env 直连身份（`recorder`）；与 `MDCG_TOKEN` 都不设 → 只读 `guest` |
+| `env.MDCG_CAN_ADMIN` | 无 | 配合 legacy auth：`'1'` → `designer`（可写 `self` 层，角色 anchors 导入需要） |
+
+**写权限默认关闭**：不配凭据时插件以只读 `guest` 运行——读 / 召回 / 时间线
+照常，写入不落盘（`index.ts` 启动告警）。是否打开由用户决定。三种身份的
+实际覆盖（用 `_probe_token.py` 对真实 MCP 进程实测）：
+
+| 调用点 | `guest`（默认） | `record`（最小权限） | `designer`（收窄版） |
+| --- | --- | --- | --- |
+| `route` / `read` / `recall` / `recent` / `stg(op=timeline)` | ✓ | ✓ | ✓ |
+| `cg(op=whitebox)` | ✓ | ✗ | ✓ |
+| `cg(op=goal)` | ✗ | ✓ | ✓ |
+| `cg(op=identity)` / `cg(op=verify)` | ✗ | ✗ | ✓ |
+| `mdcg_remember` → contextual / knowledge / structural | ✗ | ✓ | ✓ |
+| `mdcg_remember` → self（角色 anchors 导入） | ✗ | ✗ | ✓ |
+| 管理类（`forget` / `restore` / `review_decide`） | ✗ | ✗ | ✗（收窄后不留） |
+| `mutual.enabled` | false | `index.ts:256` 是否启动互维维护 |
+| `MDCG_MCP_SURFACE` | `kernel` | `mcp_server.py`：kernel 仅 `cg`/`stg`，full 另含 29 个细粒度工具 |
+
+## 7. 关键约定
+
+1. **身份绑定加密**：私有内容按 `(tenant, actor)` 派生 DEK；换身份读同一节点 = 「不可读即不存在」。
+   故迁移脚本 `--tenant/--actor` 必须与插件 `config.mdcg.tenant/actor` 一致。
+2. **依据强度**：`verification_basis` 取值限 `compiler | test | measurement | formal_proof | data | other`；
+   互维判定视前五者为「强依据」（`mdcg_client.ts:56`）。
+3. **失败降级**：认知图未就绪时，互维回退能力库 `wisdom_verify`（`index.ts:274`）；
+   角色扮演落图失败仅告警，不阻断对话（`roleplay_web.ts:446`）。
+4. **写权限 fail-closed 且默认关闭**：md_cg 无 `MDCG_TOKEN` / `MDCG_LEGACY_ENV_AUTH=1`
+   时降级为只读 `guest`——`route`/`read`/`recall`/`timeline` 正常（自动召回不受影响），
+   但 `mdcg_remember` 全部 `AccessDenied`、不落盘。**默认即此状态**，打开写权限由用户
+   自行决定；插件不代为注入凭据，只在启动时告警（`index.ts`），避免「看起来在记忆、
+   其实没落盘」。写 `self` 层（角色 anchors 导入）须 `designer`
+   （`MDCG_CAN_ADMIN=1` 或收窄版 designer 令牌）。
+5. **写入通道唯一**：所有插件写入经 `mdcg_remember`；`cg(op=write)` 会走 audit
+   （未声明 `content_kind` 时永不落盘），仅供需要审核留痕的显式调用。
+6. **stdio 一律 UTF-8**：`MdcgClient` 构造子进程时强制 `PYTHONIOENCODING=utf-8`。
+   Windows 下 piped Python 默认 `gbk` + `surrogateescape`，Node 写的 UTF-8 中文会被
+   解成孤立代理字符（`\udcXX`）→ md_cg 落盘/回写 `UnicodeEncodeError`，**中文记忆
+   全部失败**。md_cg 自带测试（`test_p2_mcp.py`）与 `test/bridge.test.ts` 均以该
+   环境变量启动，客户端此前漏设。
+
+## 8. 变更记录
+
+| 日期 | 变更 |
+| --- | --- |
+| 2026-09-10 | md_cg 定为唯一真源；AEIS 降能力库；白箱 provider 下线（保留本地库）+ 新增 `cg(op=whitebox)` 验证通道；roleplay/mutual 迁入 `src/lib` 并改用认知图；新增 `migrate_roleplay.py` 与 P18/P19 测试。 |
+| 2026-09-10 | **写入通道修正**：插件写入由 `cg(op=write)` 改为 MCP `mdcg_remember`（`cg(op=write)` 过 audit，未声明 content_kind 时永不落盘）；自动记忆改用 `mdcg_remember(gated=true)`，实测 ACCEPT + md 落盘 + timeline/read 命中。补写入凭据（`MDCG_TOKEN` / `MDCG_LEGACY_ENV_AUTH`）与启动期告警。 |
+| 2026-09-10 | **stdio 编码修正**：`MdcgClient` 子进程强制 `PYTHONIOENCODING=utf-8`。此前 Windows 下 gbk/surrogateescape 解码导致中文内容 `UnicodeEncodeError`，中文记忆无法落盘（实测真实桥 E2E 复现并修复）。 |
+| 2026-09-10 | **写权限改为「默认关闭 + 令牌化」**：`MDCG_TOKEN` 取代 `MDCG_LEGACY_ENV_AUTH` 成为推荐路径，示例配置一律注释掉（由用户决定是否打开）；`md_cg/tokens.py` 的 `issue` 子命令补齐 `--ops-allow` / `--layers-allow`（对齐 Python API 已有的收窄能力）。三种身份的实际覆盖矩阵见 §6。 |

package/docs//345/267/245/344/275/234/347/272/252/345/276/213_/350/256/244/347/237/245/345/233/276/346/235/241/347/233/256_v1.1.json

@@ -11,12 +11,12 @@
   "reject": []
  },
  "_comment": "identity负责端口分流; negative只否决明确域外; 无//注释(标准JSON)",
- "content": "工作纪律集: 4条方法论(理论先行/全面处理/白箱方法/根因) + 3条执行(验证/双副本/兜底)",
+ "content": "工作纪律集: 4条方法论(理论先行/全面处理/白箱方法/根因) + 3条执行(验证/双副本/兜底) + 1条思考(中文思考/协作模式分级) + 1条保密(敏感信息隔离) + 3条图像线(选源护栏/历史查询优先/算法权威唯一) + 1条协作(访谈澄清:先问清再动手) + 1条合规(内容政策合规:公开产物过内容政策+隐私双清单) + 1条执行环境(命令执行统一走python/UTF-8: 显式encoding+PYTHONUTF8=1, 规避GBK)",
  "execution": {
   "how": "按identity(端口)+任务类型路由到对应纪律"
  },
  "response": {
-  "direct": "按工作纪律路由: 重要/长期→理论先行; 有相关成果→全面处理; 已读4篇→白箱方法; 有偏差→根因纪律; 入库前→验证纪律; 多副本→双副本; MCP不可用→兜底纪律。"
+  "direct": "按工作纪律路由: 重要/长期→理论先行; 有相关成果→全面处理; 已读4篇→白箱方法; 有偏差→根因纪律; 入库前→验证纪律; 多副本→双副本; MCP不可用→兜底纪律; 对外公开→内容政策合规(内容政策+隐私双清单)。命令执行→python/UTF-8(见第15条)。"
  },
  "subgraph": {
   "nodes": [
@@ -184,6 +184,196 @@
     "response": {
      "direct": "按工作纪律第7条: 兜底纪律——主路径不可用则切等价兜底(如MCP→python直调), 并写进文档。"
     }
+   },
+   {
+    "id": "discipline_chinese_thinking",
+    "semantic": "8.中文思考",
+    "content": "思考/推理语言=中文; 复杂项目→用「我们需要」深思考+交流确认(互补盲区); 简单项目→用「让我」快速执行(省资源); 复杂度用情绪(新奇/挑战/曾受批评)+信息差判定. 语言锚点=每个推理段开篇用中文短语钉住语言.",
+    "conditions": {
+     "apply": [
+      "中文区域",
+      "中文项目开发过程"
+     ]
+    },
+    "negative": {
+     "reject": [
+      "需要英文编写的场景",
+      "英文环境",
+      "英文文档",
+      "国际接口"
+     ]
+    },
+    "execution": {
+     "how": "判定复杂度(情绪: 新奇/挑战/曾受批评 + 信息差: 不确定度)→复杂?「我们需要」深思考+确认 | 简单?「让我」快速执行; 推理开篇即中文锚点; 全程中文, 仅代码/标识符/引用保留原文"
+    },
+    "response": {
+     "direct": "按工作纪律第8条: 中文思考——中文书写; 复杂(新奇/挑战/曾受批评/高信息差)→「我们需要」交流确认互补盲区; 简单→「让我」快速执行不空耗; 每段推理开篇用中文短语锚定语言。"
+    }
+   },
+   {
+    "id": "discipline_sensitive_isolation",
+    "semantic": "9.敏感信息隔离",
+    "content": "含敏感信息（个人隐私、私有内容等）的文档：只写私有库(AEIS)，不上传任何公开库；推送/提交描述不写敏感词。",
+    "conditions": {
+     "apply": [
+      "文档含敏感信息",
+      "含个人隐私",
+      "含私有内容"
+     ]
+    },
+    "negative": {
+     "reject": [
+      "文档无敏感信息",
+      "纯公开技术内容"
+     ]
+    },
+    "execution": {
+     "how": "识别文档是否含敏感信息→若含→只写私有库(AEIS)+不上传公开库+推送描述不写敏感词；若不含→正常处理"
+    },
+    "response": {
+     "direct": "按工作纪律第9条: 敏感信息隔离——含敏感/隐私内容只放私有库(AEIS)，不推公开库，推送描述不写敏感词。"
+    }
+   },
+   {
+    "id": "discipline_image_source_guardrail",
+    "semantic": "10.图像选源护栏",
+    "content": "图像处理选源必须核对历史参考/既有管线产物；负路由：原图拒处理版(用原始全彩)、线稿拒实色线稿(用结构线稿canny_contour)、还原拒退化产物(用complete_restore)；未核对规范源→DEFER(未验证不写入)。",
+    "conditions": {
+     "apply": [
+      "构建图像四类图",
+      "选图像处理源"
+     ]
+    },
+    "negative": {
+     "reject": [
+      "已核对规范源",
+      "纯公开数据"
+     ]
+    },
+    "execution": {
+     "how": "选源→_guard_source 依kind判ACCEPT/REJECT/DEFER→未ACCEPT不构建"
+    },
+    "response": {
+     "direct": "按工作纪律第10条: 图像选源护栏——核对历史参考, 拒处理版/实色线稿/退化产物, 未验证不写入。"
+    }
+   },
+   {
+    "id": "discipline_record_first",
+    "semantic": "11.历史查询优先(先查记录再做)",
+    "content": "选算法/选源前必须查历史记录(产物图→记录(如ROUNDTRIP.md)→源码算法(darkline.py/linework.py/contour_semantics/linecolor.py))→用已走通算法+阈值；未找到记录→DEFER(不盲选/不调参)。线稿不适用 raw canny/zone_linework(碎/细+网格线)→用 darkline(Sobel+mag.mean+std*thr_mult, thr_mult=1.5最优)白底黑线。",
+    "conditions": {
+     "apply": [
+      "选图像/算法/源",
+      "复现已有能力"
+     ]
+    },
+    "negative": {
+     "reject": [
+      "已有记录且已核对",
+      "无历史可查的纯新算法"
+     ]
+    },
+    "execution": {
+     "how": "定位产物图→查记录→定位源码算法→确认阈值机制→用该算法生成；未找到→DEFER"
+    },
+    "response": {
+     "direct": "按工作纪律第11条: 历史查询优先——先查记录/源码用已走通算法, 未找到不盲选DEFER；线稿用darkline(Sobel+mean+std*1.5)白底黑线, 拒raw canny/zone_linework。"
+    }
+   },
+   {
+    "id": "discipline_algorithm_authority",
+    "semantic": "12.算法权威唯一(根因纪律)",
+    "content": "选算法/算法标准以【唯一权威文档】为准(VISION_PIPELINE: 线稿=darkline.py Sobel+mean+std*1.5; 色块=contour_semantics); 选算法前先查文档(非记忆); 禁止遇问题临时切换算法; 换算法须先记录+更新文档(版本管理); 勿漂移。",
+    "conditions": {
+     "apply": [
+      "选图像/视觉算法",
+      "复现已有能力"
+     ]
+    },
+    "negative": {
+     "reject": [
+      "无对应权威文档的探索期"
+     ]
+    },
+    "execution": {
+     "how": "选算法→查唯一权威文档→用文档算法→若需换: 记录原因+更新文档后再换"
+    },
+    "response": {
+     "direct": "按工作纪律第12条: 算法权威唯一(线稿=darkline.py/色块=contour_semantics)——选算法查文档, 勿临时切换/漂移; 换算法须记录+更新文档。"
+    }
+   },
+   {
+    "id": "discipline_interview_clarify",
+    "semantic": "13.访谈澄清(先问清再动手)",
+    "content": "重要任务启动时 AI 先向使用者提问,确认要做什么;按 design tree 逐轮提问(每轮问全部前置已落定的问题,编号+推荐答案),直到完全清楚(无未决问题)才执行/固化;事实自查不问使用者,决策归使用者. 访谈即调用认知图进行功能识别: 对条件进行确认(conditions)、递归确认子内容(subgraph/depends_on)、如何执行(execution)、不适用条件是什么(negative)——与认知图节点四要素完全同构. 配套机制: MCP grill 工具族(认知图工具的补全,非独立新增; grill_start/grill_node/grill_frontier/grill_finish), frontier 非空拒绝固化(不完全清楚就不固化).",
+    "conditions": {
+     "apply": [
+      "重要项目",
+      "需求模糊",
+      "新任务启动"
+     ]
+    },
+    "negative": {
+     "reject": [
+      "情感交互",
+      "闲聊",
+      "明确单步小改动"
+     ]
+    },
+    "execution": {
+     "how": "任务启动→开访谈(grill_start)→逐轮提问(frontier)→全部落定→与使用者确认共识→执行/固化(grill_finish); 放弃用 abandon(可逆)"
+    },
+    "response": {
+     "direct": "按工作纪律第13条: 访谈澄清——先提问确认要做什么,逐轮问到完全清楚才动手;事实自查,决策归使用者,不完全清楚不固化。"
+    }
+   },
+   {
+    "id": "discipline_content_policy",
+    "semantic": "14.内容政策合规",
+    "content": "任何对外公开的产物(数据集/文档/示例/发布包)必须过「内容政策 + 隐私」两条独立清单：①内容政策——剔除性/成人内容与政治敏感内容(含项目内部的成人研究记录、术语、会话名，如 vulva/sexual/阴部 等标记)；②隐私——PII/密钥/路径脱敏。过滤必须在生成阶段做(抽样/构建时跳过并从同层补充)，不得事后删条破坏分布。双复检 0 命中才提交。已发布发现违规→删条 + 重写 git 历史(force push) + 通知平台清缓存 + 评估残留风险。",
+    "conditions": {
+     "apply": [
+      "对外公开产物",
+      "提交公开仓库",
+      "数据集/文档产出"
+     ]
+    },
+    "negative": {
+     "reject": [
+      "纯内部私有产物",
+      "不含违规内容且无隐私"
+     ]
+    },
+    "execution": {
+     "how": "产出→过内容政策清单(POLICY_DENY)→过隐私脱敏→双复检0命中→提交；已发布违规→删条+重写历史+通知平台清缓存"
+    },
+    "response": {
+     "direct": "按工作纪律第14条: 内容政策合规——对外公开产物必须过「内容政策+隐私」双清单，过滤在生成阶段做；已发布发现违规要删条+重写git历史+通知平台清缓存。"
+    }
+   },
+   {
+    "id": "discipline_python_exec",
+    "semantic": "15.命令执行统一走python",
+    "content": "一切命令执行统一经 python 子进程并显式 UTF-8(encoding='utf-8', errors='replace')，不经 Windows shell(cmd/PowerShell) 直接执行；子进程环境置 PYTHONUTF8=1 使 locale 不回落 GBK，规避 _readerthread 的 UnicodeDecodeError 与 stdout 的 UnicodeEncodeError。",
+    "conditions": {
+     "apply": [
+      "执行命令",
+      "运行测试/脚本",
+      "跨进程读写文本"
+     ]
+    },
+    "negative": {
+     "reject": [
+      "IDE 内置工具直调",
+      "无跨进程的纯内存计算"
+     ]
+    },
+    "execution": {
+     "how": "构造 argv 列表→subprocess.run(capture_output=True, text=True, encoding='utf-8', errors='replace')→env 带 PYTHONUTF8=1→shell=False"
+    },
+    "response": {
+     "direct": "按工作纪律第15条: 命令执行统一走python——argv列表+显式UTF-8+PYTHONUTF8=1, 不经Windows shell, 规避GBK解码异常。"
+    }
    }
   ]
  }