@furongjun1999/dsh-memory 0.4.11 → 0.5.1

package/codebuddy/CODEBUDDY.md

@@ -1,12 +1,12 @@
-# 工作纪律（工作纪律_认知图条目_v1.1）· 17 条
+# 工作纪律（工作纪律_认知图条目_v1.1）· 18 条
 
 > 本文件由 `scripts/render_discipline.py` 从真源
 > `docs/工作纪律_认知图条目_v1.1.json` 渲染生成，**请勿手改**；改真源后重跑渲染。
-> 真源指纹（SHA256 前16位）：37aed1b5423c00af
+> 真源指纹（SHA256 前16位）：26bff32d73644699
 
 ## 概述
 
-工作纪律集: 4条方法论(理论先行/全面处理/白箱方法/根因) + 3条执行(验证/双副本/兜底) + 1条思考(中文思考/协作模式分级) + 1条保密(敏感信息隔离) + 3条图像线(选源护栏/历史查询优先/算法权威唯一) + 1条协作(访谈澄清:先问清再动手) + 1条合规(内容政策合规:公开产物过内容政策+隐私双清单) + 2条执行调度与运行环境(命令执行统一走python/UTF-8: 显式encoding+PYTHONUTF8=1, 规避GBK; 任务派发统一走蜂巢: 任何执行性任务经蜂巢spawn/submit执行并留痕, agent本体只做编排, L1出口=产物落点为只读判定(不改仓库/外部状态)可直跑须留痕) + 1条记忆闭环(任务收尾归档:每次任务执行完只将核心修改(内容/原因/位置/验证结论)按CCG六要素(功能名/生效条件/子功能/执行/验证方式/不适用条件)成文存入灵枢记忆, 不写中间过程)
+工作纪律集: 4条方法论(理论先行/全面处理/白箱方法/根因) + 3条执行(验证/双副本/兜底) + 1条思考(中文思考/协作模式分级) + 1条保密(敏感信息隔离) + 3条图像线(选源护栏/历史查询优先/算法权威唯一) + 1条协作(访谈澄清:先问清再动手) + 1条合规(内容政策合规:公开产物过内容政策+隐私双清单) + 2条执行调度与运行环境(命令执行统一走python/UTF-8: 显式encoding+PYTHONUTF8=1, 规避GBK; 任务派发统一走蜂巢: 任何执行性任务经蜂巢spawn/submit执行并留痕, agent本体只做编排, L1出口=产物落点为只读判定(不改仓库/外部状态)可直跑须留痕) + 1条记忆闭环(任务收尾归档:每次任务执行完只将核心修改(内容/原因/位置/验证结论)按CCG六要素(功能名/生效条件/子功能/执行/验证方式/不适用条件)成文存入灵枢记忆, 不写中间过程) + 1条信息获取(工作区索引优先: 查工作区文件先读 WORKSPACE_INDEX.md(仓根, 由 scripts/workspace_index.py 从 git 追踪面管线生成), 尚无则先跑 --write 生成再读, 不以重复全盘浏览代替; 索引是会陈化的手工件, 故须管线生成+机械守卫, 否则退化为误导源)
 
 ## 执行公约
 
@@ -139,6 +139,13 @@
 - **不适用**：纯会话内对话/问答(无执行动作)｜蜂巢不可用且任务必须立即执行(兜底须声明)｜L1只读判定(产物落点=不改仓库/不改外部状态的本地只读命令, 秒级·可逆·高频, 如跑门禁/测试/回归/lint看结论; 判据是产物落点而非「任务简单」的主观感受, 直跑须输出一行「L1 直跑：<命令> — 风险/频次/可逆性」留痕, 留痕粒度按任务(同一任务的多条只读命令合并为一条留痕, 不逐命令逐行); 层级归属的复核者=使用者+GitHub使用者)｜情感交互｜闲聊
 - **声明**：按工作纪律第17条: 任务派发统一走蜂巢——任何执行性任务经蜂巢 spawn/submit 执行并留痕(spec/status/result), agent本体只做编排; 宿主自带subagent/team不是等价通道, 兜底须声明。L1只读判定(产物落点=不改仓库/外部状态)可直跑, 须输出「L1 直跑：<命令> — 风险/频次/可逆性」留痕。
 
+### 18. 工作区索引优先
+
+- **触发**：查找工作区文件｜需要了解工作区结构｜跨目录检索定位｜长会话续接/上下文压缩后查找工作区文件
+- **动作**：定位工作区文件→先读 WORKSPACE_INDEX.md(仓根)→有则按表中职责/关键入口直接定位→无则先 python scripts/workspace_index.py --write 生成再读→守卫报陈化先重生成→不以重复全盘浏览代替; 新增顶层目录/根级文件须在脚本 DIR_ROLES/ROOT_FILES 登记后重生成; 上下文压缩/长会话续接后, 先 cg route『工作区索引』重建纪律视野(压缩会丢弃未留下执行痕迹的纪律, 只剩被声明过的条目——须主动召回)
+- **不适用**：已明确路径的单文件操作｜纯会话内对话/问答(无文件查找)｜仓外路径/系统路径(git 追踪面之外)
+- **声明**：按工作纪律第18条: 工作区索引优先——查工作区文件先读 WORKSPACE_INDEX.md(仓根, 管线生成); 无则先跑 scripts/workspace_index.py --write 生成再读, 不以重复全盘浏览代替。
+
 ## 声明出口（`response.direct` 原文 · 未输出即未执行）
 
 | # | 声明（response.direct 原文） |
@@ -160,6 +167,7 @@
 | 15 | 按工作纪律第15条: 命令执行统一走python——argv列表+显式UTF-8+PYTHONUTF8=1, 不经Windows shell, 规避GBK解码异常。 |
 | 16 | 按工作纪律第16条: 任务收尾归档——每次任务执行完只提炼核心修改(内容/原因/位置/验证结论)并按 CCG 六要素(功能名/生效条件/子功能/执行/验证方式/不适用条件)成文存入灵枢记忆, 写入后发起一次读取查询确认写入成功且可检索, 禁写中间过程/试错/调试等无效信息, 与第2条形成「查记忆→执行→写记忆→读回确认」闭环。 |
 | 17 | 按工作纪律第17条: 任务派发统一走蜂巢——任何执行性任务经蜂巢 spawn/submit 执行并留痕(spec/status/result), agent本体只做编排; 宿主自带subagent/team不是等价通道, 兜底须声明。L1只读判定(产物落点=不改仓库/外部状态)可直跑, 须输出「L1 直跑：<命令> — 风险/频次/可逆性」留痕。 |
+| 18 | 按工作纪律第18条: 工作区索引优先——查工作区文件先读 WORKSPACE_INDEX.md(仓根, 管线生成); 无则先跑 scripts/workspace_index.py --write 生成再读, 不以重复全盘浏览代替。 |
 
 ## 记忆接口速查（`cg` / `stg`）
 

package/codebuddy/README.md

@@ -1,90 +1,92 @@
-# CodeBuddy 端 · 灵枢接入配置
-
-本目录 = **CodeBuddy harness 专属配置**（灵枢 = Lingshu 记忆系统）。与 `dsh/`、`zcode/` 平级，
-共享层（`md_cg/` 大脑、`data/`、`docs/`、`scripts/`）在仓库根，不属任何单端。
-
-## 目录内容
-
-| 文件 | 作用 | 性质 |
-|---|---|---|
-| `CODEBUDDY.md` | 16 条工作纪律全文（会话起始注入） | **渲染产物**，勿手改 |
-| `mcp.json` | 灵枢接入模板：`mdcg`（记忆大脑）+ `hive`（蜂巢并发）两条 MCP server（复制进 CodeBuddy 设置） | 模板 |
-| `README.md` | 本文件（接入说明 + 记忆策略） | 手写 |
-
-## 三步接入
-
-### 1. 接入记忆大脑（MCP）
-
-把 `mcp.json` 里的 `mcpServers.mdcg` 一段合并进 CodeBuddy 的 MCP 配置，然后把
-`PYTHONPATH` 的占位值（`REPLACE_WITH_ABSOLUTE_PATH_TO_dsh-memory`）替换为**你本机
-dsh-memory 仓库所在目录**。此处须用可解析的绝对路径——Python 要据此定位仓库内的 `md_cg`
-包，相对路径会随进程工作目录漂移而失效。
-
-`md_cg` 大脑随仓库自带，**无需 pip 安装任何引擎**；只需本机有 Python 与 Node ≥ 22.19。
-
-> **工具面 `MDCG_MCP_SURFACE=kernel`**（与 `md_cg/mcp_server.py` 的默认值一致）：只暴露 `cg` /
-> `stg` 两个认知基元；`cg` 已覆盖 `route` / `read` / `write` 等全部 op，**写入通道不缺**。
-> 细粒度 `mdcg_*` 工具仅在 `full` 面可见，属兼容 / 调试用途，日常接入无需开启。
-
-#### 1b. 接入蜂巢（多智能体并发 + 任务上下文管理）
-
-`mcp.json` 里同源的第二条 `mcpServers.hive` 一并合并——四工具 `hive_spawn` / `hive_poll` /
-`hive_kill` / `hive_doctor`，提供**跨 harness 通用的并发执行**与**任务上下文管理**
-（`context_files` 注入、预算交回续跑、进展卡观察）。语义与边界见
-[`../hive/README.md`](../hive/README.md) 的「各 harness 注册」。
-
-> 依赖 Rust 侧 `hive.exe` 与 `hive/config.local.json`（执行器密钥）。未构建时先
-> `cd hive && cargo build --release`；首次 `hive_spawn` 会自动以 detached 方式拉起 `serve`。
-> **确定性任务（跑命令 / 测试）不在 MCP 面**，走 CLI：
-> `hive/target/release/hive.exe submit --spec <spec.json>`。
-
-### 2. 注入工作纪律
-
-把 `CODEBUDDY.md` 复制到**你项目的根目录**。
-
-> CodeBuddy 规则优先级：根目录存在 `CODEBUDDY.md` 时会**忽略 `AGENTS.md`**。
-> 本仓库刻意把产物放在 `codebuddy/` 子目录而**不落根**——因为仓库根的 `AGENTS.md`
-> 是本地私有载体（含本机运维注记，已被 `.gitignore` 忽略）。子目录放置既让外部用户可直接取用，
-> 又不屏蔽本地纪律。
-
-### 3. 重启会话
-
-纪律在**会话开始时全文注入一次**，改动后须新建会话才生效。
-
-## 记忆策略：只记重要内容，不记流水
-
-灵枢是记忆系统，但**什么都记等于什么都不记**——因此写入侧有两道机制化过滤，而非靠人自觉：
-
-| 层 | 内容 | 落点 | 过滤方式 |
-|---|---|---|---|
-| **重要内容** | 核心修改：内容 / 原因 / 位置 / 验证结论 | `knowledge` / `self` 层 | `cg(op=write, gated=true)` 过**三问四态闸门**，非 `ACCEPT` 不落盘 |
-| **对话记录** | 会话转录 | `contextual` 层 | 主动遗忘闸门按重要性阈值自动 `DROP` 低熵噪音 |
-
-- **纪律第 16 条**要求每次任务收尾主动归档核心修改——这是「对话 → 长期记忆」的闭环入口。
-- **严禁**写入中间过程 / 试错步骤 / 调试细节 / 重复确认；这类内容会污染检索、干扰后续召回。
-- CodeBuddy 侧**没有** DSH 那样的会话 hook 自动记忆，故记忆沉淀由纪律驱动（Agent 在收尾显式调用
-  `cg(op=write, gated=true)`），而非进程自动抓取。
-
-## 写入凭据（决定能否真正落盘）
-
-`md_cg` 是 **fail-closed**：不配凭据时插件以**只读 guest** 运行——读取 / 召回 / 时间线照常，
-但记忆写入**不落盘**。要落盘请签发令牌：
-
-```bash
-python -m md_cg.tokens issue --role designer --actor codebuddy --clearance internal ^
-  --ops-allow info,route,read,write,recent,goal,identity,whitebox,verify ^
-  --layers-allow knowledge,contextual,structural,self,goals,unresolved,rejected
-```
-
-然后把 `MDCG_TOKEN` 填进 `mcp.json` 的 `env`（或设系统环境变量后引用）。
-
-> **别把 `ok: true` 当写成功**：未落盘时返回体形如
-> `{"ok": true, "committed": false, "moved_to": "review_queue"}`——是否落盘**只看 `committed`**。
-
-## 维护（面向灵枢维护者）
-
-- `CODEBUDDY.md` 由 `scripts/render_discipline.py` 从**唯一真源** `docs/工作纪律_认知图条目_v1.1.json`
-  渲染生成，矩阵见 `docs/discipline/harnesses.yaml`（`codebuddy` 槽位）。
-- 改纪律 → 改真源 → `python scripts/render_discipline.py --target codebuddy --write`
-  → `python scripts/verify_discipline.py --target codebuddy` 通过 → 提交。
-- **手改本目录的 `CODEBUDDY.md` 会被 `verify_discipline.py` 判为漂移**。
+# CodeBuddy 端 · 灵枢接入配置
+
+本目录 = **CodeBuddy harness 专属配置**（灵枢 = Lingshu 记忆系统）。与 `dsh/`、`zcode/` 平级，
+共享层（`md_cg/` 大脑、`data/`、`docs/`、`scripts/`）在仓库根，不属任何单端。
+
+## 目录内容
+
+| 文件 | 作用 | 性质 |
+|---|---|---|
+| `CODEBUDDY.md` | 16 条工作纪律全文（会话起始注入） | **渲染产物**，勿手改 |
+| `mcp.json` | 灵枢接入模板：`mdcg`（记忆大脑）+ `hive`（蜂巢并发）两条 MCP server（复制进 CodeBuddy 设置） | 模板 |
+| `README.md` | 本文件（接入说明 + 记忆策略） | 手写 |
+
+## 三步接入
+
+### 1. 接入记忆大脑（MCP）
+
+把 `mcp.json` 里的 `mcpServers.mdcg` 一段合并进 CodeBuddy 的 MCP 配置，然后把
+`PYTHONPATH` 的占位值（`REPLACE_WITH_ABSOLUTE_PATH_TO_dsh-memory`）替换为**你本机
+dsh-memory 仓库所在目录**。此处须用可解析的绝对路径——Python 要据此定位仓库内的 `md_cg`
+包，相对路径会随进程工作目录漂移而失效。
+
+`md_cg` 大脑随仓库自带，**无需 pip 安装任何引擎**；只需本机有 Python 与 Node ≥ 22.19。
+
+> **工具面 `MDCG_MCP_SURFACE=kernel`**（与 `md_cg/mcp_server.py` 的默认值一致）：只暴露 `cg` /
+> `stg` 两个认知基元；`cg` 已覆盖 `route` / `read` / `write` 等全部 op，**写入通道不缺**。
+> 细粒度 `mdcg_*` 工具仅在 `full` 面可见，属兼容 / 调试用途，日常接入无需开启。
+
+#### 1b. 接入蜂巢（多智能体并发 + 任务上下文管理）
+
+`mcp.json` 里同源的第二条 `mcpServers.hive` 一并合并——四工具 `hive_spawn` / `hive_poll` /
+`hive_kill` / `hive_doctor`，提供**跨 harness 通用的并发执行**与**任务上下文管理**
+（`context_files` 注入、预算交回续跑、进展卡观察）。语义与边界见
+[`../hive/README.md`](../hive/README.md) 的「各 harness 注册」。
+
+> 依赖 Rust 侧 `hive.exe` 与 `hive/config.local.json`（执行器密钥）。未构建时先
+> `cd hive && cargo build --release`；`cargo` 不在 PATH 时改用绝对路径
+> `"%USERPROFILE%\.cargo\bin\cargo.exe" build --release --manifest-path hive/Cargo.toml`；
+> 首次 `hive_spawn` 会自动以 detached 方式拉起 `serve`。
+> **确定性任务（跑命令 / 测试）不在 MCP 面**，走 CLI：
+> `hive/target/release/hive.exe submit --spec <spec.json>`。
+
+### 2. 注入工作纪律
+
+把 `CODEBUDDY.md` 复制到**你项目的根目录**。
+
+> CodeBuddy 规则优先级：根目录存在 `CODEBUDDY.md` 时会**忽略 `AGENTS.md`**。
+> 本仓库刻意把产物放在 `codebuddy/` 子目录而**不落根**——因为仓库根的 `AGENTS.md`
+> 是本地私有载体（含本机运维注记，已被 `.gitignore` 忽略）。子目录放置既让外部用户可直接取用，
+> 又不屏蔽本地纪律。
+
+### 3. 重启会话
+
+纪律在**会话开始时全文注入一次**，改动后须新建会话才生效。
+
+## 记忆策略：只记重要内容，不记流水
+
+灵枢是记忆系统，但**什么都记等于什么都不记**——因此写入侧有两道机制化过滤，而非靠人自觉：
+
+| 层 | 内容 | 落点 | 过滤方式 |
+|---|---|---|---|
+| **重要内容** | 核心修改：内容 / 原因 / 位置 / 验证结论 | `knowledge` / `self` 层 | `cg(op=write, gated=true)` 过**三问四态闸门**，非 `ACCEPT` 不落盘 |
+| **对话记录** | 会话转录 | `contextual` 层 | 主动遗忘闸门按重要性阈值自动 `DROP` 低熵噪音 |
+
+- **纪律第 16 条**要求每次任务收尾主动归档核心修改——这是「对话 → 长期记忆」的闭环入口。
+- **严禁**写入中间过程 / 试错步骤 / 调试细节 / 重复确认；这类内容会污染检索、干扰后续召回。
+- CodeBuddy 侧**没有** DSH 那样的会话 hook 自动记忆，故记忆沉淀由纪律驱动（Agent 在收尾显式调用
+  `cg(op=write, gated=true)`），而非进程自动抓取。
+
+## 写入凭据（决定能否真正落盘）
+
+`md_cg` 是 **fail-closed**：不配凭据时插件以**只读 guest** 运行——读取 / 召回 / 时间线照常，
+但记忆写入**不落盘**。要落盘请签发令牌：
+
+```bash
+python -m md_cg.tokens issue --role designer --actor codebuddy --clearance internal ^
+  --ops-allow info,route,read,write,recent,goal,identity,whitebox,verify ^
+  --layers-allow knowledge,contextual,structural,self,goals,unresolved,rejected
+```
+
+然后把 `MDCG_TOKEN` 填进 `mcp.json` 的 `env`（或设系统环境变量后引用）。
+
+> **别把 `ok: true` 当写成功**：未落盘时返回体形如
+> `{"ok": true, "committed": false, "moved_to": "review_queue"}`——是否落盘**只看 `committed`**。
+
+## 维护（面向灵枢维护者）
+
+- `CODEBUDDY.md` 由 `scripts/render_discipline.py` 从**唯一真源** `docs/工作纪律_认知图条目_v1.1.json`
+  渲染生成，矩阵见 `docs/discipline/harnesses.yaml`（`codebuddy` 槽位）。
+- 改纪律 → 改真源 → `python scripts/render_discipline.py --target codebuddy --write`
+  → `python scripts/verify_discipline.py --target codebuddy` 通过 → 提交。
+- **手改本目录的 `CODEBUDDY.md` 会被 `verify_discipline.py` 判为漂移**。

package/codebuddy/mcp.json

@@ -1,27 +1,27 @@
-{
-  "mcpServers": {
-    "mdcg": {
-      "command": "python",
-      "args": ["-m", "md_cg.mcp_server"],
-      "env": {
-        "PYTHONPATH": "REPLACE_WITH_ABSOLUTE_PATH_TO_dsh-memory",
-        "PYTHONUTF8": "1",
-        "PYTHONIOENCODING": "utf-8",
-        "MDCG_MCP_SURFACE": "kernel",
-        "MDCG_ACTOR": "codebuddy",
-        "MDCG_TENANT": "default",
-        "MDCG_CLEARANCE": "private",
-        "MDCG_TOKEN": ""
-      }
-    },
-    "hive": {
-      "command": "python",
-      "args": ["-m", "hive.hive_mcp.mcp_server"],
-      "env": {
-        "PYTHONPATH": "REPLACE_WITH_ABSOLUTE_PATH_TO_dsh-memory",
-        "PYTHONUTF8": "1",
-        "PYTHONIOENCODING": "utf-8"
-      }
-    }
-  }
-}
+{
+  "mcpServers": {
+    "mdcg": {
+      "command": "python",
+      "args": ["-m", "md_cg.mcp_server"],
+      "env": {
+        "PYTHONPATH": "REPLACE_WITH_ABSOLUTE_PATH_TO_dsh-memory",
+        "PYTHONUTF8": "1",
+        "PYTHONIOENCODING": "utf-8",
+        "MDCG_MCP_SURFACE": "kernel",
+        "MDCG_ACTOR": "codebuddy",
+        "MDCG_TENANT": "default",
+        "MDCG_CLEARANCE": "private",
+        "MDCG_TOKEN": ""
+      }
+    },
+    "hive": {
+      "command": "python",
+      "args": ["-m", "hive.hive_mcp.mcp_server"],
+      "env": {
+        "PYTHONPATH": "REPLACE_WITH_ABSOLUTE_PATH_TO_dsh-memory",
+        "PYTHONUTF8": "1",
+        "PYTHONIOENCODING": "utf-8"
+      }
+    }
+  }
+}