Skip to content

Commit c8717ef

Browse files
committed
chorography M3:开局注入提纲 + /choro 回执(过期只提示)
会话工作目录命中已登记仓库时,每轮往 systemPrompt 折进一小块标题级提纲 (模块名 / 文件数 / 页状态 / 页相对路径),档位 chorographyInject = light/full/off; /choro 给定点查看,只报过期不自动重跑(spec §2 D6)。 - 折进既有 memory context,不开第三个(V3 实读宿主源码:context 只按 order 排序、 同 order 无 name 兜底);次序 时间 → 地志 → 热上下文 → 长期记忆。 - 宿主 side 无任何体积上限(renderPrompt 只是 join),上限自兜:light 900 字符 / full 6000 字符,逐行累加截断,不切半行。 - 轻量档在消费侧判 lightMode 压成 off,而非写进 LIGHT_MODE_OFF(那张表对平铺键 赋 false,枚举键进去会静默失效)。档位不是命令闸:/choro 只认 chorographyEnabled。 - 热路径不 fork git:注入只吃 DB 行;真过期判定(rev-parse 比对基线)只在 /choro。 渲染缓存键用 outline.generatedAt(页级),不是 choro_repos.updated_at——T1 富化 只推页级时间,按仓库行做键会让注入块停在「骨架」而 /choro 已报「已富化」。 - 按 cwd 找仓库复用 scope.workspace_scope 口径,祖先前缀匹配、最长 root 胜出。 - 注入永不抛:取 cwd / 查库 / 渲染任一步失败都退化成空串 + 一条 warn;从仓库读来的 标题与路径过一次 escapePromptVars(宿主 interpolate 扫到非法 {{…}} 会崩整轮装配)。 - 面板补上 chorographyEnabled 总闸与档位下拉(M1 留的洞:空态文案让人去设置里打开, 而设置里根本没有那一行)。 - /choro 只读:不 rebuild、不写档位、不落数据;回执不进模型上下文。 验证:全量 npm test 2806 tests / 2805 pass / 0 fail / 1 skipped; check-sync 94 文件一致;新增 wiki-inject 10 例、choro-command 11 例、 wiki-queries +2、inject +3。
1 parent da23e37 commit c8717ef

28 files changed

Lines changed: 1668 additions & 33 deletions

‎AGENTS.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ dsh-mneme 是 DSH 宿主的记忆插件(蒸馏 / 注入 / 检索 / 巩固 / sc
5151
| 外来行判据 | `src/memory-source.js` | 「本库不巩固别人导入的原文」这条契约的唯一实现(`isImportedRow`),挂在 saveWithDedupe 汇流口与巩固/睡眠/整理的九个行池上([docs/SHARE.md](dsh-mneme/docs/SHARE.md)) |
5252
| 分享包(出与收) | `src/share.js` + `src/share-http.js` + `src/share-import.js` | 出包口径与入包闸门(`buildSharePack` / `validateSharePack`,一条不合格整包拒)、两张皮共用的解析与答复(`shareReply` / `receiveReply` / `undoReply` 各只有一份——**「两张皮只许剩鉴权与路径不同」这条纪律归 `share-http.js`**,它同时承诺「这一层从不抛」)、收侧入库与整包退出(一个事务、按 `share_external_id` 幂等、物删不归档)。面板三件(分享弹层 / 接收弹层 / 外来区筛选与整包退出)在 `lib/client.js`,出包口径、入包闸门、错误码→状态全在那里读、不在那里复述;唯一的例外是外来说的那个字面量 `"imported"`(独立 bundle 不能 `import src/memory-source.js`),它由 `test/client-share.test.js` 的跨文件镜像锁钉回 `IMPORTED_SOURCE` 那一份 |
5353
| 实体 | `src/entities/extractor.js`(存储侧在 store 三表) | 写入时 LLM 抽取实体/属性/关系 |
54-
| 仓库地志(chorography) | `src/wiki/{plan,scan,partition,render,t0,t1,queries}.js` + `bin/dsh-mneme-choro.mjs`(表在 store 六张 `choro_*`) | 仓库 → 确定性骨架页(T0 零模型)+ plan.yaml 正面控制;T1 生成轮逐模块 headless 会话补语义段与 claims(`--t1`,三重上限,runner 注入可测);**wiki 行永不进记忆行池 / dream / 质量过滤**。消费面 M1 已接:面板第二座位 `dsh-mneme-wiki` + 三只读工具 + `/choro/*` 读路由(`chorographyEnabled` 闸,关 = 工具不注册 / 路由 409);M3 注入未动。spec:[docs/specs/2026-11-04-chorography-design.md](docs/specs/2026-11-04-chorography-design.md) |
54+
| 仓库地志(chorography) | `src/wiki/{plan,scan,partition,render,t0,t1,queries,inject}.js` + `src/choro-command.js` + `bin/dsh-mneme-choro.mjs`(表在 store 六张 `choro_*`) | 仓库 → 确定性骨架页(T0 零模型)+ plan.yaml 正面控制;T1 生成轮逐模块 headless 会话补语义段与 claims(`--t1`,三重上限,runner 注入可测);**wiki 行永不进记忆行池 / dream / 质量过滤**。消费面(M1 + M3 已接):面板第二座位 `dsh-mneme-wiki` + 三只读工具 + `/choro/*` 读路由 + **开局提纲注入**(折进 memory context,档位 `chorographyInject` = light/full/off,只注标题级、宿主无体积上限所以自兜字符预算)+ `/choro` 只读回执(过期只提示、绝不自动重跑);`chorographyEnabled` 是总闸,关 = 工具不注册 / 路由 409 / 注入块空串 / 命令不注册。spec:[docs/specs/2026-11-04-chorography-design.md](docs/specs/2026-11-04-chorography-design.md) |
5555
| 检索辅助 | `src/search/{bm25,adaptive}.js`、`src/vector-index.js`、`src/embedding.js`、`src/local-embedder.js`、`src/reranker.js` | BM25 / 自适应阈值 / 向量索引 / 嵌入 / 重排 |
5656
| 热度 | `src/heat.js` | 纯函数遗忘曲线(opt-in) |
5757
| 复用统计 | `src/recall-stats.js` | recall_runs 只读聚合(#217,Top-N 召回 + 僵尸率) |
Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
# chorography M3 实现计划(分支 feat/chorography-m3,基于 origin/main da23e37——M0/M1/M2 均已合并)
2+
3+
spec §10 第三档:**开局注入 + 过期提示 + `/choro` 指令**([design](../specs/2026-11-04-chorography-design.md) §7 / §10)。M4(记忆库入口迁移)本档不动。
4+
5+
## V3 已验(2026-11-05,本机)
6+
7+
spec §11 的 V3 问的是「与宿主现有 `systemPrompt` 注入的先后顺序与体积上限」。宿主 `@deepseek-ai/dsh-system-prompt` 的实现已从 `app.asar` 提出读过,三条结论直接决定了本档的设计:
8+
9+
1. **宿主侧完全没有体积上限**。`renderPrompt` 只是 `sections.map(...).join("\n\n")`,`assemble()` 里没有 token/字符预算、没有截断、没有超限报错。→ **上限只能由插件自己兜**,本档在渲染侧设行数与字符双上限。
10+
2. **context 只按 order 排序,同 order 没有 name 兜底**(`sort((a, b) => a.order - b.order)`)。mneme 的 `memory`(90) / `user-settings`(85) 都排在宿主 `WORKING_DIRECTORY`(100) 之前——记忆块出现在「当前工作目录」那句台词之前,这是既有事实,本档不改。
11+
3. **空文本的 context 被过滤、不占位**(`filter(text.length > 0)`)。→ 「本帧不注入就 `return ""`」是宿主契约内的合法关闭方式,不是 hack。
12+
4. 追加一条:`interpolate()` 扫到 `{{…}}` 但变量不合法/未注册会**抛错并崩整轮装配**。从仓库读来的模块标题与路径必须过 `escapePromptVars`(mneme 已有,`src/user-settings.js`)。
13+
14+
## 已定实现决策(P24–P33)
15+
16+
| # | 决策 | 理由 | 被否备选 |
17+
|---|---|---|---|
18+
| P24 | 地志块**折进既有的 `memory` context**,不开第三个 context | `test/inject.test.js` 断言 `contexts.length === 2`;`inject.js:399-402` 的注释已经写明「Folding it here (instead of a separate context) keeps the prompt assembly stable at two blocks」;spec §7 也要求「合并成一次拼装,避免同一份提示里长两块」 | 新开 `{name:"chorography", order:88}`——要改既有断言,且直接违背 spec 原话 |
19+
| P25 | 档位键 `chorographyInject`,枚举 `off`/`light`/`full`,**默认 `light`**,走 `z.union([z.const(...)])`(同 `summarizeDedupeMode`) | spec §7 原话就是三档 + 默认 light | 布尔键——表达不了三档;跟随 `chorographyEnabled` 隐式开——那就没有「关注入但保留工具」的组合 |
20+
| P26 | 轻量档**不用 `LIGHT_MODE_OFF`**,改在消费侧判 `config.lightMode === true` → 视为 `off` | `applyLightModePreset` 对平铺键一律赋 `false`;枚举键进去会得到与 schema 不符的 `false`,而 `false !== "off"` 时注入照样渲染(静默失效,比不关更糟) | 把 `chorographyInject` 塞进 `LIGHT_MODE_OFF`——见左;改成布尔键——同 P25 |
21+
| P27 | 「按 cwd 找仓库」**不新写一份 registry 读取**,直接吃注入器已经解析出来的 `scope.workspace_scope` | 那个值来自 `createScopeResolver`(registry 反查优先、`header.cwd` 兜底、失败落 NULL),是全仓唯一的 cwd 口径;再写一份就是两张皮,且 #487 的 Proxy 陷阱会重犯 | 在注入器里重读 `workspaceRegistry`——重犯 #487 |
22+
| P28 | 仓库匹配走**祖先前缀**,不是精确相等 | 会话 cwd 常常是仓库子目录(`D:/repo/src`);精确相等会让绝大部分真实会话匹配不到 | 只认精确相等——等于给用户加一条「必须在仓库根开会话」的暗规则 |
23+
| P29 | **热路径不 fork git**。注入块只带「生成时间 + 基线短 sha」,真过期判定(`git rev-parse HEAD` 比对)只在 `/choro` 里做 | 每轮注入跑一次 `execFileSync` 在 Windows 上是几十毫秒起步,且这是给模型看的提示、不是硬判定;`/choro` 是人主动触发,付得起 | 注入时跑 git——热路径不可接受的成本,且失败降级路径又是一处 |
24+
| P30 | 「一句摘要」位**用模块 title + 文件数 + 页状态**,不解析页正文 | spec §7 明确「只注标题级不注正文」,解析正文取摘要恰好违反这一条;`choro_modules` 也没有 summary 列(M0 没建)。页状态(skeleton/enriched/failed)反而是模型最需要的信息——它据此知道这一页有没有语义 | 从 `choro_claims` 取首条架构结论——claims 质量不定且体积不可控,留给后续档;解析 markdown 正文——违 spec |
25+
| P31 | 渲染失败/取不到仓库/取不到 cwd **一律返回空串**,绝不让注入抛错 | `memory` context 已在热路径上;一个附属信息块把整轮 systemPrompt 搞崩是不成比例的失败 | 抛错让宿主记录——一次 DB 异常就整轮没有记忆注入 |
26+
| P32 | 数据访问仍全部走 `queries.js`(新增 `repoByCwd` / `outline` 两函数),`inject.js` 只做渲染 | `queries.js` 的头注释就是「真源纪律:slug 只从 DB 白名单解析,路径拼装零用户输入」;在注入侧另写 SQL 就是第二份白名单 | 注入侧自写 SQL——两张皮 |
27+
| P33 | `/choro` **只读**,不做 rebuild、不写档位 | spec §2 D6「只手动触发」;命令 handler 的返回值只作 UI 回执(`pipeline-command.js` 注释原话),写操作该走面板或 CLI,不该藏在一条斜杠命令里 | `/choro rebuild`——在宿主进程里跑 T0 写盘,越权且失败面大;`/choro light` 切档位——feature flags 改了也要重启 DSH 才生效,回执照样要说「重启」,收益低于代价 |
28+
29+
## 步骤
30+
31+
1. `src/wiki/queries.js` 加 `repoByCwd(cwd)`(realpath 归一 + 祖先前缀匹配)与 `outline(repoId)`(注入所需最小列集);
32+
2. 新增 `src/wiki/inject.js`:`resolveInjectTier(config)` 纯函数 + `renderChoroBlock(...)` 纯渲染 + `createChoroInject({ choro, config, logger })` → `{ text(cwd), dispose() }`,带渲染缓存;
33+
3. `src/config.js` 加 `chorographyInject` 枚举键,改 `chorographyEnabled` 那段「不进 LIGHT_MODE_OFF」的注释(理由只剩一半);
34+
4. `src/settings.js` 的 `FEATURE_FLAG_ENUMS` 加 `chorographyInject`;
35+
5. `src/lang.js` 加地志注入块文案与 `/choro` 命令文案(中英双份);
36+
6. `src/inject.js` 的 `memory` context 里按「时间 → 地志 → 热上下文 → 长期记忆」拼接,快照加 `choroChars`;
37+
7. 新增 `src/choro-command.js`(照 `pipeline-command.js` 的形状),`src/index.js` 在 `disposers` 声明之后注册(TDZ 纪律);
38+
8. `lib/client.js`:`FEATURE_GROUPS` 的 `group.enhance` **末尾**加 `chorographyEnabled`(放末尾是为了不推远 `test/client.test.js:2468` 那个 700 字符窗口),组尾加 `choroSub` 档位下拉;
39+
9. `docs/CONFIGURATION.md` 加键行、改 `chorographyEnabled` 措辞;`CHANGELOG.md`;`AGENTS.md` 模块地图;
40+
10. 测试:新增 `test/wiki-inject.test.js` 与 `test/choro-command.test.js`,补 `test/inject.test.js`,`test/api.test.js` 计数 112→113;
41+
11. `npm run sync` + `node scripts/check-sync.js` + `npm test`。
42+
43+
## 落地状态(2026-11-05)
44+
45+
全部 11 步已落地,闸门实测:
46+
47+
- `node scripts/check-sync.js` → ✓ src/ 与 lib/ 一致(94 个文件)
48+
- `cd dsh-mneme && npm test` → **tests 2805 / pass 2804 / fail 0 / cancelled 0 / skipped 1**,71s
49+
- 新增/扩充测试:`test/wiki-inject.test.js`(新建 9 例)、`test/choro-command.test.js`(新建 11 例)、`test/wiki-queries.test.js` 6 例(+2)、`test/inject.test.js` 31 例(+3)、`test/api.test.js` 旗标计数 112 → 113
50+
- 端到端冒烟(临时脚本,未提交):临时 git 夹具跑真实 T0 → light/full 各出 3 行提纲;`{chorographyEnabled:true, lightMode:true}` → tier=off / chars=0;`/choro` 回执带批次标题、全表、基线一致与正文读法提示
51+
52+
### 实现中改掉的三处口径(都由冒烟暴露)
53+
54+
1. **档位不是命令闸**:`resolveInjectTier` 在 `lightMode: true` 下也返回 `off`,若用它当 `/choro` 的开关,轻量档用户会被告知「没开,去设置里打开」而设置里明明开着。命令只认 `chorographyEnabled`。
55+
2. **两档排序统一**:`light` 原按文件数降序、`full` 按 slug 字母序,同一份地志在两档下次序不同。改为先排序再分档。
56+
3. **截断语改差额**:`/choro` 的「另有 N 个模块」原来传模块总数,会让人以为大部分没看到;改为总表行数减实际列出的行数。另修注入行把页路径粘在右括号后(缺分隔空格)。

‎dsh-mneme/CHANGELOG.md‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,19 @@
22

33
## [Unreleased]
44

5+
- **chorography M3:开局注入 + 过期提示 + `/choro` 命令**:spec §10 的消费面收尾。会话工作目录命中已登记仓库时,每轮往 systemPrompt 里塞一小块**标题级**提纲(模块名 / 文件数 / 页状态 / 页相对路径,约 8 行),档位 `chorographyInject` = `light`(默认,前 6 个模块)/ `full`(全部)/ `off`;`/choro` 给主动查看,且**只提示过期、绝不自动重跑**(spec §2 D6)。
6+
7+
- **折进既有 memory context,不新开第三个 context**(P24):宿主 `@deepseek-ai/dsh-system-prompt` 的 context 只按 `order` 排序、**同 order 没有 name 兜底**(V3 实读源码确认),多开一块就多一份拼装抖动;spec §7 也明写「与 mneme 现有 systemPrompt 注入合并成一次拼装」。拼接次序 `时间 → 地志 → 热上下文 → 长期记忆`——地志是稳定背景,热上下文每轮都变,稳定在前。
8+
- **宿主侧没有任何体积上限**(V3 实测,本机 asar 解包读源码):`renderPrompt` 只是 `sections.map(...).join("\n\n")`,没有 token/字符预算、没有截断、没有超限报错。所以上限只能自己兜:`light` 900 字符 / `full` 6000 字符,**逐行累加截断而不是拼完再切**——切在行中间会让最后一条模块行变成半句话,模型读到的路径就可能是断的。空文本 context 被宿主 `filter(text.length > 0)` 过滤、不占位,所以「不注入」就是返回空串。
9+
- **`chorographyInject` 不进 `LIGHT_MODE_OFF`**(P26):那张表对平铺键一律赋 `false`,枚举值塞进去会得到与 schema 不符的 `false`,而 `false !== "off"` 时注入照样渲染——比不关更糟。改为在消费侧判 `config.lightMode === true` 即 `off`(`wiki/inject.js` 的 `resolveInjectTier`)。**但档位不是命令闸**:轻量档下 `resolveInjectTier` 同样返回 `off`,若拿它当 `/choro` 的开关,用户会听到「没开,去设置里打开」而设置里明明是开着的——`/choro` 只认 `chorographyEnabled`(档位管注入,命令管子系统开没开,实测复现后拆开的)。`chorographyEnabled` 本身仍不进轻量档,但理由收窄成一句:它是「是否启用这个子系统」,不是「每轮付多少」,键注释与 CONFIGURATION.md 同步改写。
10+
- **热路径不 fork git**(P29):注入块只吃 DB 已有的行,生成时间写进去但不重算基线;真过期判定(`git rev-parse HEAD` vs `choro_repos.git_baseline`)只放在 `/choro` 里——那是人主动敲的,付得起一次 rev-parse。注入器带**渲染**缓存(每轮仍查一次 DB 取键,那是索引查询不是 fork git),键 `tier|lang|repoId|outline.generatedAt`——**不是仓库行的 `updated_at`**:T1 富化只推 `choro_pages.generated_at`、不动仓库行,若按仓库行做键,用户刚跑完 `--t1 --apply` 注入块还会写着「骨架」而 `/choro` 已经报「已有语义段」。不额外挂失效回调(热路径上少一条回调就少一处能崩的地方)。
11+
- **三态过期,不许把「读不到」说成「没过期」**:`/choro` 分别报 基线一致 / 可能已过期(附两个短 sha)/ 读不到 HEAD(不是 git 仓库或 git 不可用)。
12+
- **按 cwd 找仓库复用既有 scope 口径**(P27/P28):注入侧直接吃注入器已经解析好的 `scope.workspace_scope`(workspaceRegistry 反查优先、`header.cwd` 兜底),不新写一处 registry 读取(#487:cordis 4 的 ctx 是 Proxy,裸读未 inject 的属性会抛)。匹配用**祖先前缀**而非精确相等(会话 cwd 常在子目录),多仓嵌套时最长 root 胜出;Windows 上按小写比较。
13+
- **注入永不抛**(P31):取 cwd / 查仓库 / 渲染任一步失败都退化成空串 + 一条 warn,不让一块附属信息把整轮 systemPrompt 搞崩。从仓库读来的标题与路径过一次 `escapePromptVars`——宿主 `interpolate()` 扫到非法 `{{…}}` 会**抛错崩整轮装配**;转义只做在注入这一层,`/choro` 的 UI 回执直接用未转义文本(它不进宿主模板)。
14+
- **面板补上总闸 + 档位**(M1 留的洞):`chorographyEnabled` 此前面板里没有任何一行,而空态的文案却让用户「去设置里打开」。现在它挂在 `group.enhance` 组末,档位下拉作组尾子块(枚举键没有通用渲染器,与 `summarizeSub` / `distillSub` 同款手写)。
15+
- **`/choro` 只读**(P33):不做 rebuild、不写档位、不落任何数据;参数一律不带(重建与富化都在 CLI)。返回值走 DSH 的 CommandResult 契约,**只作 UI 回执、不进模型上下文**——要模型看见提纲,靠的是开局注入。
16+
- **两处口径级修正**(端到端冒烟里看出来的):① 注入行原来把页路径直接粘在右括号后(`(3 文件).chorography/modules/src.md`),补一个分隔空格;② `light` 与 `full` 原来各按各的排序(后者按 slug 字母序),同一份地志在两个档位下次序不同、读起来像被重扫过——统一按文件数降序 + slug 升序。`/choro` 提纲超 6000 字符时的截断语也从「另有 N 个模块(总数)」改成**差额**:报总数会让读者以为大部分模块都看不到。
17+
518
- **chorography M2:T1 语义生成轮——逐模块 headless 会话补四段语义正文 + 溯源 claims**:`dsh-mneme-choro <repo> --t1 --apply`(缺省 dry-run 只列候选;`--module` 单跑 / `--model` 路由 / `--timeout` 墙钟 / `--retry-failed` 拉回失败页)。会话产出的架构/约定/技术栈/构建四段插在骨架页「生成说明」节之前(T0 确定性段落原样保留),claims 落 `choro_claims` 表 + `evidence/<slug>.json` 双处同源。
619

720
- **V1 已实测通过**(T1 的全部前提):桌面版 headless 通道通——两个必需配方进了真实 runner:①**绕过 `.cmd` wrapper 直接调 exe**(`ELECTRON_RUN_AS_NODE=1 + --expose-internals`,wrapper 在 Git Bash 下路径引号会碎);②**模型路由走 `--patch` 一次性临时 overlay** 指池模型(bili-scroll 同款、零配置改动;headless 默认路由 deepseek-official 要 API key,MISSING_CREDENTIAL)。overlay 只有 provider/model 名,无 key(红线 4)。

0 commit comments

Comments
 (0)