Skip to content

Commit c231449

Browse files
committed
feat(organize): expose the organizer to agents as memory_organize (#231)
The engine landed in v0.8 with an explicit "not in the tool list yet" note, and nothing outside test/organize.test.js could reach it: no tool registration, no hit on either API surface, no `.organize(` call site in the repo. This is the throttle: a `memory_organize` tool (mode dryRun|apply) behind a flat `organizeEnabled` switch, off by default and off in the lightMode preset. Hidden-by-default reuses the v0.8.5 lever — a model that cannot see the tool does not call it. Light mode presets it off for a protocol reason, not a cost one: apply must carry the previous report's run_id, which is the step weak models drop. Preset only; an explicit user switch still wins. apply's `opts.hiddenIds` finally gets a producer. Without one the organizer would be a second path around scope governance, so the tool layer computes it with the #170 rule-4 idiom (same shape as register_document's hiddenEvidenceIds); invisible rows stay "unknown, archived or out of scope", so no existence leak. Candidates are stamped from the session identity like memory_save — otherwise rows written through organize would all land unscoped. Guards updated in the same pass: #195 matrix (both branches; its list and structure checks now run with exposure gates on, since an opt-in tool is absent from the default registry), tools.test.js schema subset, api.test.js flag count lock 103 -> 104, CONFIGURATION.md key + light-mode list.
1 parent 4abb257 commit c231449

16 files changed

Lines changed: 763 additions & 17 deletions

‎dsh-mneme/CHANGELOG.md‎

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

33
## [Unreleased]
44

5+
## 🆕 新增
6+
7+
- **agent 主动整理接口接上调用入口:`memory_organize` 工具 + `organizeEnabled`(#231,默认关)**:引擎在 v0.8 就造好了(`src/organize.js`:dryRun 出比对报告 → agent 判断 → apply 落库,筛除只归档不删,全程复用 `dream_runs` 的回执语义),但当时刻意「不进工具列表、不加独立开关」,于是它一直是**只有测试能调用**的功能——`tools.js` 的十一个工具里没有它,两张 API 脸 0 命中,全仓 `.organize(` 零调用点。这一批接的是油门:新工具 `memory_organize`(`mode: dryRun|apply`,缺省 dryRun)+ 顶层扁平开关 `organizeEnabled`(默认 `false`)。**默认关与「关 = 不注册」是同一件事的两面**:开关关掉时工具根本不进注册表,模型看不到就不会调——沿用 v0.8.5 工具暴露闸的定性(比在描述里劝模型别用更可靠);轻量档预设也关,但理由不是成本而是协议:dryRun→apply 要求模型拿住上一轮的 `run_id` 再回来,弱模型漏这一环就是一次被拒的调用。预设不剥夺显式开启的权利(合并顺序「用户开关 > 轻量预设 > bundle」,同 `continuityRescueEnabled`)。**补上 `opts.hiddenIds` 这个零生产者的可信上下文**:`organize.apply` 收它、却从来没人传(工具没接,自然没有生产者)——不接就等于让整理接口成为第二条绕过 scope 治理的改库通道。现在由工具层按 #170 复核项 4 的口径算好传入(`register_document` 的 `hiddenEvidenceIds` 同形):他 scope 的 explicit 行按「不存在」处理,回执文案维持「unknown, archived or out of scope」那一句,不泄漏存在性。经整理落库的候选与 `memory_save` 同源盖章(会话身份 `auto`、显式参数改盖 `explicit`),否则这条路写出来的行会全部躺在未标注(全局可见)那一档。测试 +11(`test/organize-tool.test.js`):默认不注册 / 开启后注册、dryRun 一行不写只留回执、apply 三态计数、拒绝没有报告的 apply、scope 盖章两例,外加一条**先写错后修正**的用例——最初拿「别人 scope 的行」测 `hiddenIds`,可那行永远不会成为报告的命中行,把守卫整段摘掉测试照样绿;换成「同比对键但会话看不见」那一格(匿名会话对 explicit 行 fail-closed),再用变异确认它真的会红。#195 的工具矩阵两个分支都补了(清单比对与 C 层结构断言改用暴露闸全开的配置——opt-in 工具在默认配置下不在注册表里,用默认配置跑那条护栏会静默失效)、`tools.test.js` 的 schema 子集加走一遍暴露配置、`api.test.js` 旗标计数锁 103→104、`docs/CONFIGURATION.md` 补键与轻量档清单。**本批刻意不含**:注入侧的「能力说明」段落(属 #249 剩下的另一半,本批唯一表面是工具描述),以及面板上 `run_type='organize'` 回执的展示口径。
8+
59
## 🐛 修复
610

711
- **蒸馏的转录被模型当成「该我回话了」:同一窗口确定性失败,重试 20 次、越试越贵(#493)**:转录以「用户:…」开头、**裸放**在一条 user 消息里(`src/summarize.js` 的 `collectMessages`),格式指令只在 system 里。模型于是把它当成当前发言接着往下说/点评,输出里连 `[` 都没有,`parseSummaryJsonResult` 在括号早退处直接判 `invalid summary JSON`;而解析失败不推进游标(语义是「这段还没提炼完,下次接着来」),下一个 `turn/end` 重试**同文同温**——同输入同错,窗口还随新事件继续变大。报告者的 20 条失败 input tokens 8194 → 11118 单调递增、`finish_reason = stop`,正是这条路径;本机注入恒定返回中文点评的假 stream 复现出 19 次额外调用、落库 0 条、游标不动。改法两条:①**围栏 + 角色重申**——user 消息现在以「你是第三方提炼员,不是下面这段会话的参与者」开头,转录包进 `<<<会话转录开始>>>` / `<<<会话转录结束>>>`;围栏是确定性的,重试收到的转录与首次逐字节相同(既有回归用例依赖这条);system 保持原样,因为模型对「这段文本是什么」的判断由它所在的 user 消息决定,只写进 system 救不回来(实测同段转录只加 system 约束仍 0/2 出 JSON)。②**失败护栏**(新键 `summarizeParseFailureMaxRetries`,默认 `0` = 关):连续失败到阈值后强制消费游标跳过该窗口,避免一条会话被同一窗口卡死。默认关是因为放弃内容本身有代价——短窗口偶发失败仍值得重试。

‎dsh-mneme/docs/CONFIGURATION.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -284,6 +284,7 @@
284284
| `externalApiHost` | `127.0.0.1` | 绑定地址 | 改成非回环 = 把整个记忆库暴露给网络,自负其责 |
285285
| `disableMemorySearch` | `false` | 对模型隐藏 `memory_search` 工具(v0.8.5) | 慢/轻量模型的工具往返节流;隐藏即不可调 |
286286
| `disableMemoryArchive` | `false` | 对模型隐藏 `memory_archive` 工具 | 同上 |
287+
| `organizeEnabled` | `false` | 对模型开放 `memory_organize` 工具(#231:先 dryRun 出比对报告,agent 判断后 apply 落库) | 与上面两个**反向**:那两个藏默认在场的工具,本键开默认不在场的能力。关 = 工具根本不注册(模型看不到就不会调)。dryRun→apply 是两步协议,弱模型容易漏 `run_id` 或跳过报告,所以 `LIGHT_MODE_OFF` 里有它;apply 只能引用一次真实报告、且一份报告只许落地一次 |
287288
| `actionPipelineEnabled` | `false` | M.O. 只读视图的门控:做法图谱 + 对话行结算卡 | opt-in beta;只是纯 UI 入口、不引入重型后台路径,故不进 `LIGHT_MODE_OFF`。写账另有独立的执行记账键(`/mo-run`),看图 ≠ 写账 |
288289
| `actionRunEnabled` | `false` | M.O. 执行记账:`/mo-run` 开一次执行窗口,窗口内命令执行才可能被记成一条 run | opt-in beta;挂在热路径(每个会话事件都过一次监听),故 `LIGHT_MODE_OFF` 里有它 |
289290
| `actionNudgeEnabled` | `false` | M.O. 自动沉淀:每轮结束(`turn/end`)后挖一次「这个项目重复走的动作」,结果落成 `memoryDir/proposals/<项目键>/` 里的提议,等人确认 | opt-in beta;三个 M.O. 键里最重的一条——挂 `session/event` 且要**同步解压 zstd 会话日志**(本机 118 份实测 16.2s,单次预算 `budgetMs`=4s 兜底),故 `LIGHT_MODE_OFF` 里有它。**永不自动落草稿**:`materialize` 恒 false,进仓库必须是人的显式动作 |
@@ -320,6 +321,7 @@
320321
`graphAnchoringEnabled` · `graphWeightEnabled` · `graphInjectHint` · `graphPassiveConfirm` ·
321322
`actionRunEnabled` · `actionNudgeEnabled` ·
322323
`dreamNarrativeEnabled` · `documentMemoryEnabled` · `heatEnabled` · `continuityRescueEnabled` ·
324+
`organizeEnabled`(#231) ·
323325
`preInjectGate.enabled`(#380) · `distillRecords.enabled`(#399)
324326

325327
预设只是默认值而非强制:用户显式写进 feature_flags 的值在装配顺序上后展开、仍然生效

‎dsh-mneme/lib/config.js‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -849,6 +849,19 @@ export const Config = z.object({
849849
disableMemorySearch: z.boolean().default(false),
850850
disableMemoryArchive: z.boolean().default(false),
851851

852+
// Issue #231 第二批:agent 主动整理接口(src/organize.js)的**暴露**闸。引擎在
853+
// PR #267 就造好了,当时刻意不进工具列表、不加开关(模块头注释:「与 #249 同批
854+
// 暴露时只差『注册工具 + 注入指引』一步」),配置面留到这一批再定——就是这里。
855+
// 与上面两个 disable* 是**反向**语义:那两个把默认在场的工具藏起来,本键把默认
856+
// 不在场的能力开出来。因为 dryRun→apply 是一套两步协议(apply 必须引用真实报告
857+
// 的 run_id),让 agent 未经用户同意就能整理记忆,不是「少一次往返」的成本问题,
858+
// 而是「谁在改库」的授权问题。
859+
// 进 LIGHT_MODE_OFF:两步协议在弱模型上最容易走歪(漏 run_id、或跳过报告直接
860+
// apply——那一拒绝就是一次失败的工具调用),而一次 dryRun 的代价是一回嵌入调用
861+
// 加按 type 有界扫库。这是预设给的默认值、不是强制:用户显式勾选仍然赢(合并顺序
862+
// 「用户开关 > 轻量预设 > bundle」,同 continuityRescueEnabled / distillRecords.enabled)。
863+
organizeEnabled: z.boolean().default(false),
864+
852865
// --- scope: v0.8.0 A1 存储层(issue #17)--------------------------------
853866
// 总开关默认关:关闭时写入不标注 scope、去重维持 (type, title) 现状,行为
854867
// 逐字节不变。开启后**两条写入路径都自动盖章**(*_scope_source='auto'):
@@ -966,6 +979,10 @@ const LIGHT_MODE_OFF = [
966979
"dreamNarrativeEnabled",
967980
// 轻量模式不开 document 指针行(#230,opt-in:注册/注入/检索增强全随闸)。
968981
"documentMemoryEnabled",
982+
// #231 第二批:轻量档不开 agent 主动整理。理由不是成本而是协议——dryRun→apply
983+
// 要求 agent 拿住上一轮的 run_id 再回来,弱模型漏这一环就是一次被拒的调用;
984+
// 预设关、不剥夺显式开启的权利(合并顺序同 continuityRescueEnabled)。
985+
"organizeEnabled",
969986
// 轻量模式不开热计算(heat 属于重型增强;关掉后 sleep 降级也退回纯时间分层)。
970987
"heatEnabled",
971988
// 轻量模式不开注入前判定(#380:LLM-per-turn 附加路径,每帧注入多一次池级

‎dsh-mneme/lib/organize.js‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,10 @@
22
// agent 主动整理接口(issue #231,口径基线 = #164 的「第三腿触发」):dryRun
33
// 出比对报告 → agent 判断 → apply 落库;筛除项进归档不删;调用全程留审计回执。
44
//
5-
// 只做功能本体(维护者口径,issue #231):落在 service 层并带测试,**不进工具
6-
// 列表、不加独立 opt-in 开关**——#249 到位时只差「注册工具 + 注入指引」一步。
5+
// 只做功能本体(维护者口径,issue #231):落在 service 层并带测试。**调用入口在
6+
// 第二批**(#231:`tools.js` 的 `memory_organize` + `organizeEnabled` 默认关)——
7+
// 本模块至今不读任何配置键,闸门与 scope 盖章都在调用方那一侧,所以本体语义与
8+
// 第一批逐字节相同。
79
//
810
// 独立成模块(AGENTS.md 尺寸约定,同 document.js / recall-stats.js 先例):
911
// service.js 只做依赖注入 + barrel 出口,调用方零改动。

‎dsh-mneme/lib/service.js‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2568,8 +2568,9 @@ export function createService({ store, mirror, config, onWrite, logger, document
25682568
saveWithDedupe,
25692569
registerDocument,
25702570
// agent 主动整理接口(#231):内聚块在 src/organize.js,这里只做依赖注入 +
2571-
// barrel 出口。刻意不加 opt-in 开关(维护者口径:功能本体不做开关,与 #249
2572-
// 同批暴露时再定配置面),也不进工具列表——工具注册在 #249 那批。
2571+
// barrel 出口。本体不带配置键(第一批口径),暴露闸住在工具层(#231 第二批的
2572+
// `organizeEnabled` → `tools.js` 的 `memory_organize`):service 侧不认识开关,
2573+
// 所以直连 service 的调用方(测试、内部管线)不受面板那格影响。
25732574
organize,
25742575
recoverMirror,
25752576
getMirrorHealth,

‎dsh-mneme/lib/settings.js‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -185,6 +185,10 @@ const FEATURE_FLAG_BOOLEANS = [
185185
// 在慢/轻量模型上是多余往返,面板可关(默认关=行为不变)。
186186
"disableMemorySearch",
187187
"disableMemoryArchive",
188+
// Issue #231 第二批:agent 主动整理(memory_organize 工具)的暴露闸。与上面两个
189+
// 反向——那两个藏默认在场的工具,本键开默认不在场的能力(默认关=工具根本不存在,
190+
// 行为逐字节不变)。面板可启停=线上回滚开关。
191+
"organizeEnabled",
188192
// 嵌套对象开关:config.js 里是 memoryQualityFilter / llmAudit 对象的 enabled
189193
// 子字段。kv 按点号键平铺存("memoryQualityFilter.enabled": false),index.js
190194
// 合并时展开回嵌套对象,api.js 的 effective 从对象子字段取值。

0 commit comments

Comments
 (0)