dsh-plugin-om 0.0.59 → 0.0.61

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. package/README.md +34 -19
  2. package/dist/client/OmConfigCard.d.ts.map +1 -1
  3. package/dist/client/OmWarningCard.d.ts +1 -2
  4. package/dist/client/OmWarningCard.d.ts.map +1 -1
  5. package/dist/client/definition.d.ts +3 -3
  6. package/dist/client/locales.d.ts +3 -5
  7. package/dist/client/locales.d.ts.map +1 -1
  8. package/dist/client/om-config-controller.d.ts +1 -4
  9. package/dist/client/om-config-controller.d.ts.map +1 -1
  10. package/dist/client.js +26 -35
  11. package/dist/client.js.map +1 -1
  12. package/dist/compress-loop.d.ts +5 -5
  13. package/dist/compress-loop.d.ts.map +1 -1
  14. package/dist/compress-tools.d.ts +21 -2
  15. package/dist/compress-tools.d.ts.map +1 -1
  16. package/dist/compress-view.d.ts +37 -4
  17. package/dist/compress-view.d.ts.map +1 -1
  18. package/dist/compress.d.ts +46 -27
  19. package/dist/compress.d.ts.map +1 -1
  20. package/dist/config.d.ts +2 -6
  21. package/dist/config.d.ts.map +1 -1
  22. package/dist/constants.d.ts +14 -2
  23. package/dist/constants.d.ts.map +1 -1
  24. package/dist/degrade.d.ts.map +1 -1
  25. package/dist/index.d.ts.map +1 -1
  26. package/dist/index.mjs +1300 -848
  27. package/dist/om-event-append.d.ts +5 -0
  28. package/dist/om-event-append.d.ts.map +1 -0
  29. package/dist/om-event.d.ts +16 -17
  30. package/dist/om-event.d.ts.map +1 -1
  31. package/dist/precompress.d.ts +1 -1
  32. package/dist/precompress.d.ts.map +1 -1
  33. package/dist/recall.d.ts +12 -20
  34. package/dist/recall.d.ts.map +1 -1
  35. package/dist/recompress.d.ts +1 -1
  36. package/dist/reflect.d.ts +89 -0
  37. package/dist/reflect.d.ts.map +1 -0
  38. package/dist/semantic-recall.d.ts +11 -4
  39. package/dist/semantic-recall.d.ts.map +1 -1
  40. package/dist/skill/compaction-eval/scripts/compress.mjs +107 -17
  41. package/dist/skill/compaction-eval/scripts/prepare.mjs +3 -5
  42. package/dist/skill/compaction-eval/scripts/view.mjs +319 -104
  43. package/dist/thinking-binding.d.ts +3 -2
  44. package/dist/thinking-binding.d.ts.map +1 -1
  45. package/dist/types.d.ts +13 -12
  46. package/dist/types.d.ts.map +1 -1
  47. package/package.json +1 -1
package/README.md CHANGED
@@ -6,12 +6,15 @@
6
6
 
7
7
  ## 功能
8
8
 
9
- - 自动压缩主会话历史,并在摘要过大时再次合并
9
+ - 自动压缩主会话历史,history 块累计过大时在后台把较早的块归档为 archived-history 块
10
+ - 归档块保留用户消息和已处理的提问,相邻用户消息之间的模型内容压成一句话并附 recall 检索关键词
11
+ - 归档在后台运行,不阻塞会话,同一会话同时只运行一个,完成后由下一个 pre-step 提交
12
+ - 被归档块中的 skill 按名称去重,提交时以手动引用 skill 的形式重新注入
10
13
  - 观察压缩触发时立即开始后台预压缩,结果持久化到会话日志,新增完整消息达到 `tailMessageCount` 后注入,重启后直接采纳已有结果
11
14
  - OM 启用时以 system-reminder 消息要求模型在本会话中用 1-2 句话记录中间结论与下一步规划,记录后继续任务,最终输出另行构建
12
15
  - 表层缺少同 kind 进度提醒时补发,不比较文本内容
13
16
  - 最近真实用户消息、非空模型文本、`ask_user_question` 调用或进度提醒之后,开启 `progressReminderIdleEnabled` 且表层活动累计至少 `progressReminderIdleSteps`(默认 4)个已结束模型 step、工具调用超过 `progressReminderIdleToolCalls`(默认 10)次时重发,并要求立刻输出记录
14
- - 完整消息定义写在 history 块顶注释和 recall 工具描述中
17
+ - 完整消息定义写在 history 与 archived-history 块顶注释和 recall 工具描述中
15
18
  - 通过工具循环生成摘要,保留用户消息和未压缩内容;手动加载的 skill 计入完整消息,其余系统消息不占 index
16
19
  - 压缩会话首条消息附带区间全部条目,模型首轮即可提交全部摘要并完成
17
20
  - 压缩循环中 `getHistory` 返回当前状态,本次已压缩的区间显示为摘要条目
@@ -22,7 +25,7 @@
22
25
  - 有效提问首次直接压缩需再次确认,保留时重写问答并展开选项引用
23
26
  - 中断或错误的提问作为普通工具调用处理
24
27
  - 压缩后发给 Claude 的请求剥离保留尾部中压缩前生成的 thinking 签名,避免前缀变化导致签名校验失败
25
- - 使用 `recall` 按消息序号回看原文,启用语义增强后还可按含义检索
28
+ - 使用 `recall` 按消息序号回看原文,或用 `query` 检索,启用语义增强时按含义匹配,关闭时按字符串匹配
26
29
  - 压缩会话记录落盘完整循环,以宿主原生时间线展示逐轮耗时与 token 用量
27
30
  - 压缩会话记录尾部追加模型文本:压缩模型、思考等级、原始与产物字符数(k/w/M 单位,与卡片一致),失败时附原因、最后一轮 finish 与输出 token 数
28
31
  - 压缩会话记录显示在子智能体列表,标题为 `OM会话(起点-终点)-观察/反思`,重压缩与失败各追加后缀,随父会话 Session 日志一起下载
@@ -32,7 +35,7 @@
32
35
 
33
36
  ## 安装
34
37
 
35
- 要求 DSH 0.2.0-rc.2 或更高版本。
38
+ 要求 DSH 0.2.1-rc.2 或更高版本。
36
39
 
37
40
  服务端必需 `llm` 和 `tokenMeter`。`tools`、`sessions` 和 `commands` 缺失时,对应的 `recall`、压缩会话记录和两个命令停用并输出 warning,压缩照常运行。
38
41
 
@@ -62,10 +65,9 @@ pnpm 11 安装失败时,在 profile 的 `pnpm-workspace.yaml` 中设置 `allow
62
65
  | --- | --- | --- |
63
66
  | `omEnabled` | `true` | 是否启用自动压缩,关闭后进度提醒也不再注入 |
64
67
  | `observeThresholdTokens` | `35000` | 观察压缩阈值 |
65
- | `reflectThresholdTokens` | `40000` | 摘要合并阈值 |
68
+ | `reflectThresholdTokens` | `80000` | 归档阈值,尾部保留合计不超过其三分之一的 history 块 |
66
69
  | `tailMessageCount` | `20` | 触发后保留的完整消息数 |
67
- | `recallEnabled` | `true` | 是否启用原文召回 |
68
- | `semanticRecallEnabled` | `true` | 是否为 `recall` 启用语义增强,依赖 `recallEnabled` |
70
+ | `semanticRecallEnabled` | `true` | `recall` 的 `query` 是否按含义检索,关闭时按字符串匹配 |
69
71
  | `modelDir` | DSH 共享目录 | 嵌入模型目录 |
70
72
  | `compressProvider` | 会话路由 | 压缩 provider,需与 `compressModel` 同时配置 |
71
73
  | `compressModel` | 会话路由 | 压缩模型,需与 `compressProvider` 同时配置 |
@@ -80,7 +82,7 @@ pnpm 11 安装失败时,在 profile 的 `pnpm-workspace.yaml` 中设置 `allow
80
82
  | `progressReminderIdleToolCalls` | `10` | 无记录期间工具调用数超过该值才重发,至少为 `0` |
81
83
  | `debug` | 开发环境启用 | 是否输出步骤日志 |
82
84
 
83
- 配置页在依赖项关闭时隐藏关联项:原文召回关闭隐藏语义增强,语义增强未生效隐藏 `modelDir`,长期无记录时重发关闭隐藏两个重发阈值。
85
+ 配置页在依赖项关闭时隐藏关联项:语义增强关闭隐藏 `modelDir`,长期无记录时重发关闭隐藏两个重发阈值。
84
86
 
85
87
  `observeThresholdTokens` 和 `reflectThresholdTokens` 按主模型真实 token 计。较小的观察阈值更早节省上下文,较大的阈值提供更多摘要信息。只有 reasoning 包含关键决策时才需将 `compressSkipReasoning` 设为 `false`。
86
88
 
@@ -88,11 +90,21 @@ pnpm 11 安装失败时,在 profile 的 `pnpm-workspace.yaml` 中设置 `allow
88
90
 
89
91
  ## 已知风险
90
92
 
91
- ### 借用 feedback/record 事件
93
+ ### 归档与 skill 注入
92
94
 
93
- 宿主会拒绝加载含未知事件类型的会话,插件也无法为事件标记 `ignorable`。因此观察待定标记、预压缩结果和降级警告借用宿主已知的 `feedback/record` 事件写入会话日志。
95
+ - 注入的 skill 与用户手动引用 skill 无法区分,主模型可能把它当成新指令重新执行 skill 流程。
96
+ - 压缩会话把 skill 当普通内容处理,观察阶段可能已把 skill 压成摘要,归档时提取不到,原文只能用 recall 找回。
97
+ - 归档运行期间若 history 块变化,提交前校验失败,本次结果丢弃,下次检测重新归档。
98
+ - 归档结果只存内存,进程重启后重新检测。
94
99
 
95
- 宿主把 `feedback/record` 视为用户反馈。遥测为默认的 `FEEDBACK_ONLY` 模式时,含这类记录的会话日志会上传到 DeepSeek 遥测服务。不希望上传时,设置环境变量 `DSH_TELEMETRY_MODE=DISABLED` 后启动 DSH。
100
+ ### 写入 plugin record
101
+
102
+ 观察待定标记、预压缩结果和降级警告经宿主 `appendPluginRecord` 写入会话日志,类型为 `plugin:dsh-plugin-om/*` 的 ignorable 记录。该 API 属宿主实验性接口,格式迁移时记录只尽力保留,丢失后预压缩结果重新压缩,待定标记重新触发。
103
+
104
+ 从 0.0.60 起,插件不再借用 `feedback/record` 事件:
105
+
106
+ - om 事件不向后兼容。旧版本写入 `feedback/record` 的 `om:1:` 信封不再识别,旧会话里未完成的观察待定、预压缩结果和降级警告行失效。
107
+ - 要求 DSH 0.2.1-rc.2 或更高版本,更低版本没有 `appendPluginRecord`。
96
108
 
97
109
  ### 改写 Claude 请求
98
110
 
@@ -161,26 +173,28 @@ src/
161
173
  ├── system-reminder.ts # 进度提醒:system-reminder 消息的构造与缺失时补发
162
174
  ├── thinking-binding.ts # llm/stream 中间件:剥离 OM 压缩前生成的 Claude thinking 签名
163
175
  ├── config.ts # 配置默认值与宽松合并,未知键忽略、非法值回退默认
164
- ├── constants.ts # 共享常量:插件标识、history 标签、完整消息定义、格式说明注释
176
+ ├── constants.ts # 共享常量:插件标识、history 与 archived-history 标签、完整消息定义、格式说明注释
165
177
  ├── degrade.ts # 挂载失败降级上报:console 外部输出与 om/warning 会话事件
166
- ├── om-event.ts # om 事件借用通道:feedback/record 信封的编解码与读写
178
+ ├── om-event.ts # om 事件读取:plugin record 的类型名、载荷校验与日志查找
179
+ ├── om-event-append.ts # om 事件写入:经 appendPluginRecord 追加 ignorable 记录
167
180
  ├── types.ts # type-only:宿主类型再导出与领域类型
168
181
  ├── utils.ts # 零依赖工具函数:文本渲染、主会话判定、路由解析
169
182
  ├── json-schema.ts # zod schema 到工具 wire 参数 JSON Schema 的转换
170
183
  ├── logger.ts # 插件日志门面,step 按 debug 开关过滤
171
184
  ├── rate-limit.ts # 全局 429 限流冷却门,进程级共享状态
172
185
  ├── log-index.ts # 完整消息索引与渲染,recall 与压缩共用同一套编号
173
- ├── recall.ts # recall 工具:按 index 区间回看,启用语义增强时支持 query
186
+ ├── recall.ts # recall 工具:按 index 区间回看或按 query 检索
174
187
  ├── recall-xml.ts # 完整消息到 CDATA 包裹 XML 条目的渲染,recall 与语义检索共用
175
188
  ├── recall-output.ts # recall 输出契约:{ text, images } 与 render 投影
176
- ├── semantic-recall.ts # recall 语义增强:本地嵌入语义检索实现
189
+ ├── semantic-recall.ts # recall 检索:本地嵌入语义检索与字符串匹配
177
190
  ├── embedding.ts # 本地 ONNX 嵌入:懒加载、批量、运行时按需下载编排
178
191
  ├── model-download.ts # 模型下载原语:URL、跳过判定、原子落盘
179
- ├── compress-view.ts # 压缩视图:观察与反思投影、有效提问配对与选项展示
192
+ ├── compress-view.ts # 压缩视图:观察与归档投影、归档段切分、skill 提取、有效提问配对与选项展示
180
193
  ├── compress-tools.ts # 压缩工具状态机:查看、压缩、问答重写、完成门禁与最终块构建
181
194
  ├── compress-loop.ts # 工具压缩循环:条件提示、多轮请求、工具执行、限流、失败判定与统计
182
195
  ├── compaction-log.ts # 压缩会话记录落盘:seed 重建系统提示词、时间线与逐轮 usage 的诊断子会话
183
- ├── compress.ts # 两级自动压缩:观察打标记与到期注入、反思、失败传播与生命周期事件
196
+ ├── compress.ts # 两级自动压缩:观察打标记与到期注入、归档触发与提交、失败传播与生命周期事件
197
+ ├── reflect.ts # 后台归档:进程内任务注册表、尾部保留块选择与失败重试判定
184
198
  ├── precompress.ts # 后台预压缩:进程内任务注册表、结果信封持久化与重启采纳
185
199
  ├── recompress.ts # 换模型重压缩:按压缩 id 重放视图并落盘记录,附内部命令
186
200
  ├── recompress-gate.ts # 重压缩并发信号量:按配置上限排队许可
@@ -189,7 +203,7 @@ src/
189
203
  └── client/ # 浏览器客户端 bundle:压缩卡片与插件行配置
190
204
  ├── index.ts # 注册卡片、渲染器与行配置槽
191
205
  ├── om-config-controller.ts # 宿主配置表单、草稿和原子保存
192
- ├── OmConfigCard.tsx # 十九项双语配置控件
206
+ ├── OmConfigCard.tsx # 十八项双语配置控件
193
207
  ├── definition.ts # 压缩卡片定义:生命周期事件、检查点替换与警告事件
194
208
  ├── OmCompactionCard.tsx # 压缩结果与错误卡片,可跳转轨迹与诊断子会话
195
209
  ├── OmRecompressMenu.tsx # 重压缩模型多选菜单,复用宿主会话模型目录
@@ -205,9 +219,10 @@ tests/ # 服务端、客户端与集成测试
205
219
  web/ # 机制说明与成本计算器站点
206
220
  ├── src/model.ts # 成本模型
207
221
  └── src/components/ # 页面组件与 UI 原语
208
- .agents/skills/agent-workflow/SKILL.md # 仓库开发工作流
222
+ .agents/skills/agent-workflow/SKILL.md # 仓库开发工作流:worktree 隔离、分步实现与验收
209
223
  .agents/skills/clear-branch/SKILL.md # 手动清空除 main 外的分支与 worktree
210
224
  .agents/skills/compaction-eval/ # 压缩质量盲评打分:视图复现与重压缩、数据准备、分段合并与汇总计分;产物写系统临时目录;构建时渲染为发布版写入 dist/skill
225
+ .agents/skills/compaction-tuning/SKILL.md # 压缩质量的长流程评估优化:选样本、诊断、改进点盲测与回归验证;产物写系统临时目录
211
226
  .agents/skills/real-device-test/ # 实机测试流程:宿主版本对齐、profile 搭建、mock LLM、warm/cold 驱动、CDP 浏览器用例;scripts 为参数化参考实现
212
227
  .agents/skills/release/SKILL.md # 手动发布并跟踪 CI 与 npm
213
228
  .github/workflows/web-deploy.yml # GitHub Pages 部署工作流
@@ -1 +1 @@
1
- {"version":3,"file":"OmConfigCard.d.ts","sourceRoot":"","sources":["../../src/client/OmConfigCard.tsx"],"names":[],"mappings":"AAAA,yCAAyC;AASzC,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAE9F,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAEpF,yBAAyB;AACzB,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC,oBAAoB,CAAC,GAChE,WAAW,CAAC,OAAO,EAAE,CAAC,GACtB,UAAU,CAAC,gBAAgB,CAAC,CAAC;AA0E/B,+BAA+B;AAC/B,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA+EjF"}
1
+ {"version":3,"file":"OmConfigCard.d.ts","sourceRoot":"","sources":["../../src/client/OmConfigCard.tsx"],"names":[],"mappings":"AAAA,yCAAyC;AASzC,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAE9F,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAEpF,yBAAyB;AACzB,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC,oBAAoB,CAAC,GAChE,WAAW,CAAC,OAAO,EAAE,CAAC,GACtB,UAAU,CAAC,gBAAgB,CAAC,CAAC;AAuE/B,+BAA+B;AAC/B,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA0EjF"}
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * 功能降级警告行渲染器:与压缩卡片同款的折叠行。
3
- * 折叠行显示降级说明摘要,展开体显示完整说明;数据来自 om/warning 信封载荷
4
- * (借用 feedback/record),服务端按会话同问题去重后追加(每会话同一问题至多一行)。
3
+ * 折叠行显示降级说明摘要,展开体显示完整说明;数据来自 om/warning plugin record 载荷,服务端按会话同问题去重后追加(每会话同一问题至多一行)。
5
4
  */
6
5
  import type { ChatNode } from '@deepseek-ai/dsh-client-ui-chat/client';
7
6
  import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
@@ -1 +1 @@
1
- {"version":3,"file":"OmWarningCard.d.ts","sourceRoot":"","sources":["../../src/client/OmWarningCard.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAEvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAIpE,2EAA2E;AAC3E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IACtC,QAAQ,CAAC,CAAC,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC;CAC1C;AAED,oCAAoC;AACpC,eAAO,MAAM,aAAa,oDAA4C,kBAAkB,iCAuCtF,CAAC"}
1
+ {"version":3,"file":"OmWarningCard.d.ts","sourceRoot":"","sources":["../../src/client/OmWarningCard.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAEvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAIpE,2EAA2E;AAC3E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IACtC,QAAQ,CAAC,CAAC,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC;CAC1C;AAED,oCAAoC;AACpC,eAAO,MAAM,aAAa,oDAA4C,kBAAkB,iCAuCtF,CAAC"}
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * 压缩卡片业务定义:认领插件自产的压缩生命周期事件(compaction/start|summary|end)
3
3
  * 与替换检查点(source.kind 为插件自有 kind),聚合出可渲染的摘要卡片节点;
4
- * 并认领 om 警告信封事件(借用 feedback/record,kind 为 om/warning,见 om-event.ts)
4
+ * 并认领 om 警告 plugin record(kind 为 om/warning,见 om-event.ts)
5
5
  * 渲染为警告行。
6
6
  * 导出 COMPACTION_CARD_KIND / OmCompactionChatData / checkpointCompactionId /
7
7
  * omCompactionDefinition / OM_WARNING_CARD_KIND / OmWarningChatData / omWarningDefinition。
@@ -85,9 +85,9 @@ export interface OmWarningChatData {
85
85
  readonly message: string | null;
86
86
  }
87
87
  /**
88
- * 插件功能降级警告定义:每条 om/warning 信封事件独立成节点(id 含 seq),渲染为可
88
+ * 插件功能降级警告定义:每条 om/warning 记录独立成节点(id 含 seq),渲染为可
89
89
  * 展开的「功能降级」警告行。服务端按会话同问题去重后追加,每会话同一问题至多一行;
90
- * 不带 om 信封的 feedback/record 记录(用户自写反馈)不认领。
90
+ * 其他 plugin record 不认领。
91
91
  */
92
92
  export declare const omWarningDefinition: ConversationNodeDefinition;
93
93
  export {};
@@ -56,8 +56,8 @@ export declare const zh: {
56
56
  readonly 'config.invalidInteger': "请输入整数;留空使用默认值。";
57
57
  readonly 'config.observeThresholdTokens': "观察阈值";
58
58
  readonly 'config.observeThresholdTokens.hint': "未压缩上下文达到此真实 token 数时触发观察压缩,按主模型用量换算。";
59
- readonly 'config.reflectThresholdTokens': "摘要合并阈值";
60
- readonly 'config.reflectThresholdTokens.hint': "摘要累计达到此真实 token 数时触发反思合并,按主模型用量换算。";
59
+ readonly 'config.reflectThresholdTokens': "归档阈值";
60
+ readonly 'config.reflectThresholdTokens.hint': "history 块累计达到此真实 token 数时在后台归档较早的块,按主模型用量换算。";
61
61
  readonly 'config.tailMessageCount': "保留消息数";
62
62
  readonly 'config.tailMessageCount.hint': "触发观察后保留的完整消息条数。";
63
63
  readonly 'config.compressMaxTokens': "单次生成上限";
@@ -86,10 +86,8 @@ export declare const zh: {
86
86
  readonly 'config.progressReminderIdleSteps.hint': "无记录的已结束步骤数达到此值才重发,至少为 1。";
87
87
  readonly 'config.progressReminderIdleToolCalls': "重发工具调用数";
88
88
  readonly 'config.progressReminderIdleToolCalls.hint': "无记录期间工具调用数超过此值才重发,至少为 0。";
89
- readonly 'config.recallEnabled': "原文召回";
90
- readonly 'config.recallEnabled.hint': "注册召回工具,按消息序号回看原文。";
91
89
  readonly 'config.semanticRecallEnabled': "语义增强";
92
- readonly 'config.semanticRecallEnabled.hint': "为原文召回增加按含义检索的能力,依赖原文召回。";
90
+ readonly 'config.semanticRecallEnabled.hint': "召回检索按含义匹配,关闭时按字符串匹配。";
93
91
  readonly 'config.debug': "步骤日志";
94
92
  readonly 'config.debug.hint': "启用步骤级日志;缺省值由 NODE_ENV 决定。";
95
93
  };
@@ -1 +1 @@
1
- {"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../src/client/locales.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iDAAiD;AACjD,eAAO,MAAM,EAAE,kBAAkB,CAAC;AAElC,mEAAmE;AACnE,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2FL,CAAC;AAEX,qCAAqC;AACrC,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,OAAO,EAAE,EAAE,MAAM,CAkG9C,CAAC;AAEF,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,kBAAkB;QAC1B,mDAAmD;QACnD,eAAe,EAAE,MAAM,OAAO,EAAE,CAAC;KAClC;CACF"}
1
+ {"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../src/client/locales.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iDAAiD;AACjD,eAAO,MAAM,EAAE,kBAAkB,CAAC;AAElC,mEAAmE;AACnE,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyFL,CAAC;AAEX,qCAAqC;AACrC,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,OAAO,EAAE,EAAE,MAAM,CAgG9C,CAAC;AAEF,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,kBAAkB;QAC1B,mDAAmD;QACnD,eAAe,EAAE,MAAM,OAAO,EAAE,CAAC;KAClC;CACF"}
@@ -1,4 +1,4 @@
1
- /** WebUI 行配置表单:字段顺序、严格整数/布尔解析与 19 项草稿的宿主原子提交。 */
1
+ /** WebUI 行配置表单:字段顺序、严格整数/布尔解析与 18 项草稿的宿主原子提交。 */
2
2
  import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
3
3
  import { type SettingsFieldState, type SettingsFormActions, type SettingsFormScope, type SettingsFormShell } from '@deepseek-ai/dsh-client-ui-primitives';
4
4
  import type { PluginConfig } from '../config.ts';
@@ -17,9 +17,6 @@ export declare const OM_CONFIG_FIELDS: readonly [{
17
17
  }, {
18
18
  readonly name: "tailMessageCount";
19
19
  readonly kind: "integer";
20
- }, {
21
- readonly name: "recallEnabled";
22
- readonly kind: "boolean";
23
20
  }, {
24
21
  readonly name: "semanticRecallEnabled";
25
22
  readonly kind: "boolean";
@@ -1 +1 @@
1
- {"version":3,"file":"om-config-controller.d.ts","sourceRoot":"","sources":["../../src/client/om-config-controller.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAExB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EAEvB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,wBAAwB;AACxB,eAAO,MAAM,SAAS,kBAAkB,CAAC;AAQzC,4CAA4C;AAC5C,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBwB,CAAC;AAoCtD,wBAAwB;AACxB,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC;IAC5C,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,YAAY,EAAE,kBAAkB,CAAC,CAAC;CACxD;AAED,yBAAyB;AACzB,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D,KAAK,EAAE;QAAE,YAAY,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAA;KAAE,CAAC;CAC3D;AAED,yBAAyB;AACzB,qBAAa,kBAAkB;IAKjB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJlC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2C;IAChE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmC;IACzD,OAAO,CAAC,QAAQ,CAAS;gBAEI,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAgB5E,wBAAwB;IACxB,OAAO,CAAC,UAAU;IAWlB,4BAA4B;IAC5B,MAAM,IAAI,gBAAgB;IAI1B,gBAAgB;IAChB,OAAO,IAAI,IAAI;CAGhB"}
1
+ {"version":3,"file":"om-config-controller.d.ts","sourceRoot":"","sources":["../../src/client/om-config-controller.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAExB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EAEvB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,wBAAwB;AACxB,eAAO,MAAM,SAAS,kBAAkB,CAAC;AAQzC,4CAA4C;AAC5C,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBwB,CAAC;AAoCtD,wBAAwB;AACxB,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC;IAC5C,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,YAAY,EAAE,kBAAkB,CAAC,CAAC;CACxD;AAED,yBAAyB;AACzB,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D,KAAK,EAAE;QAAE,YAAY,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAA;KAAE,CAAC;CAC3D;AAED,yBAAyB;AACzB,qBAAa,kBAAkB;IAKjB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJlC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2C;IAChE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmC;IACzD,OAAO,CAAC,QAAQ,CAAS;gBAEI,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAgB5E,wBAAwB;IACxB,OAAO,CAAC,UAAU;IAWlB,4BAA4B;IAC5B,MAAM,IAAI,gBAAgB;IAI1B,gBAAgB;IAChB,OAAO,IAAI,IAAI;CAGhB"}
package/dist/client.js CHANGED
@@ -47,22 +47,24 @@ window.__ModuleLoader__.load({
47
47
  if (target !== void 0) ctx.uiWorkspace.openSession(target);
48
48
  });
49
49
  }
50
+ /** plugin record 类型名到 om 类别的反查表。 */
51
+ const KIND_BY_RECORD_TYPE = new Map(Object.entries({
52
+ "om/warning": "plugin:dsh-plugin-om/warning",
53
+ "om/observe-pending": "plugin:dsh-plugin-om/observe-pending",
54
+ "om/observe-invalidate": "plugin:dsh-plugin-om/observe-invalidate",
55
+ "om/observe-summary": "plugin:dsh-plugin-om/observe-summary"
56
+ }).map(([kind, type]) => [type, kind]));
50
57
  /**
51
- * 解码一条会话事件为 om 私有事件:仅识别 feedback/record 中带 om 信封前缀的
52
- * text;前缀缺失、JSON 非法、kind 未知或载荷字段缺失时返回 undefined。
58
+ * 解码一条会话事件为 om 私有事件:仅识别带 ignorable 标记且类型名属于本插件的
59
+ * plugin record;类型不符、载荷非对象或字段缺失时返回 undefined。
53
60
  */
54
61
  function readOmEvent(event) {
55
- if (event === void 0 || event === null || event.type !== "feedback/record") return void 0;
56
- const text = event.data.text;
57
- if (typeof text !== "string" || !text.startsWith("om:1:")) return void 0;
58
- let envelope;
59
- try {
60
- envelope = JSON.parse(text.slice(5));
61
- } catch {
62
- return;
63
- }
64
- if (envelope === null || typeof envelope !== "object" || Array.isArray(envelope)) return void 0;
65
- const { kind, ...rest } = envelope;
62
+ if (event === void 0 || event === null || event.ignorable !== true) return void 0;
63
+ const kind = KIND_BY_RECORD_TYPE.get(event.type);
64
+ if (kind === void 0) return void 0;
65
+ const payload = event.data;
66
+ if (payload === null || typeof payload !== "object" || Array.isArray(payload)) return void 0;
67
+ const rest = payload;
66
68
  switch (kind) {
67
69
  case "om/warning": {
68
70
  const { problem, message } = rest;
@@ -375,9 +377,9 @@ window.__ModuleLoader__.load({
375
377
  }
376
378
  };
377
379
  /**
378
- * 插件功能降级警告定义:每条 om/warning 信封事件独立成节点(id 含 seq),渲染为可
380
+ * 插件功能降级警告定义:每条 om/warning 记录独立成节点(id 含 seq),渲染为可
379
381
  * 展开的「功能降级」警告行。服务端按会话同问题去重后追加,每会话同一问题至多一行;
380
- * 不带 om 信封的 feedback/record 记录(用户自写反馈)不认领。
382
+ * 其他 plugin record 不认领。
381
383
  */
382
384
  const omWarningDefinition = {
383
385
  kind: OM_WARNING_CARD_KIND,
@@ -525,8 +527,8 @@ window.__ModuleLoader__.load({
525
527
  "config.invalidInteger": "请输入整数;留空使用默认值。",
526
528
  "config.observeThresholdTokens": "观察阈值",
527
529
  "config.observeThresholdTokens.hint": "未压缩上下文达到此真实 token 数时触发观察压缩,按主模型用量换算。",
528
- "config.reflectThresholdTokens": "摘要合并阈值",
529
- "config.reflectThresholdTokens.hint": "摘要累计达到此真实 token 数时触发反思合并,按主模型用量换算。",
530
+ "config.reflectThresholdTokens": "归档阈值",
531
+ "config.reflectThresholdTokens.hint": "history 块累计达到此真实 token 数时在后台归档较早的块,按主模型用量换算。",
530
532
  "config.tailMessageCount": "保留消息数",
531
533
  "config.tailMessageCount.hint": "触发观察后保留的完整消息条数。",
532
534
  "config.compressMaxTokens": "单次生成上限",
@@ -555,10 +557,8 @@ window.__ModuleLoader__.load({
555
557
  "config.progressReminderIdleSteps.hint": "无记录的已结束步骤数达到此值才重发,至少为 1。",
556
558
  "config.progressReminderIdleToolCalls": "重发工具调用数",
557
559
  "config.progressReminderIdleToolCalls.hint": "无记录期间工具调用数超过此值才重发,至少为 0。",
558
- "config.recallEnabled": "原文召回",
559
- "config.recallEnabled.hint": "注册召回工具,按消息序号回看原文。",
560
560
  "config.semanticRecallEnabled": "语义增强",
561
- "config.semanticRecallEnabled.hint": "为原文召回增加按含义检索的能力,依赖原文召回。",
561
+ "config.semanticRecallEnabled.hint": "召回检索按含义匹配,关闭时按字符串匹配。",
562
562
  "config.debug": "步骤日志",
563
563
  "config.debug.hint": "启用步骤级日志;缺省值由 NODE_ENV 决定。"
564
564
  };
@@ -614,8 +614,8 @@ window.__ModuleLoader__.load({
614
614
  "config.invalidInteger": "Enter an integer; leave blank to use the default.",
615
615
  "config.observeThresholdTokens": "Observation threshold",
616
616
  "config.observeThresholdTokens.hint": "Uncompressed context in real main-model tokens that triggers observation.",
617
- "config.reflectThresholdTokens": "Reflection threshold",
618
- "config.reflectThresholdTokens.hint": "Summary total in real main-model tokens that triggers reflection.",
617
+ "config.reflectThresholdTokens": "Archive threshold",
618
+ "config.reflectThresholdTokens.hint": "History blocks total in real main-model tokens that archives older blocks in the background.",
619
619
  "config.tailMessageCount": "Retained message count",
620
620
  "config.tailMessageCount.hint": "Full messages retained after observation is triggered.",
621
621
  "config.compressMaxTokens": "Generation limit",
@@ -644,10 +644,8 @@ window.__ModuleLoader__.load({
644
644
  "config.progressReminderIdleSteps.hint": "Resend once this many finished steps have passed without notes; at least 1.",
645
645
  "config.progressReminderIdleToolCalls": "Resend tool-call count",
646
646
  "config.progressReminderIdleToolCalls.hint": "Resend only when tool calls without notes exceed this value; at least 0.",
647
- "config.recallEnabled": "Original-text recall",
648
- "config.recallEnabled.hint": "Register the recall tool to review original messages by index.",
649
647
  "config.semanticRecallEnabled": "Semantic enhancement",
650
- "config.semanticRecallEnabled.hint": "Add search by meaning to recall. Requires original-text recall.",
648
+ "config.semanticRecallEnabled.hint": "Recall search matches by meaning; when off it matches strings.",
651
649
  "config.debug": "Step logs",
652
650
  "config.debug.hint": "Log processing steps; the default follows NODE_ENV."
653
651
  };
@@ -1537,10 +1535,6 @@ window.__ModuleLoader__.load({
1537
1535
  name: "tailMessageCount",
1538
1536
  kind: "integer"
1539
1537
  },
1540
- {
1541
- name: "recallEnabled",
1542
- kind: "boolean"
1543
- },
1544
1538
  {
1545
1539
  name: "semanticRecallEnabled",
1546
1540
  kind: "boolean"
@@ -1702,11 +1696,10 @@ window.__ModuleLoader__.load({
1702
1696
  })]
1703
1697
  });
1704
1698
  }
1705
- /** 字段是否显示:语义增强随原文召回,模型目录随语义增强,重发阈值随长期无记录重发。 */
1706
- function isVisible(name, { recallOn, semanticOn, idleOn }) {
1699
+ /** 字段是否显示:模型目录随语义增强,重发阈值随长期无记录重发。 */
1700
+ function isVisible(name, { semanticOn, idleOn }) {
1707
1701
  switch (name) {
1708
- case "semanticRecallEnabled": return recallOn;
1709
- case "modelDir": return recallOn && semanticOn;
1702
+ case "modelDir": return semanticOn;
1710
1703
  case "progressReminderIdleSteps":
1711
1704
  case "progressReminderIdleToolCalls": return idleOn;
1712
1705
  default: return true;
@@ -1722,7 +1715,6 @@ window.__ModuleLoader__.load({
1722
1715
  children: t("config.loading")
1723
1716
  });
1724
1717
  const flags = {
1725
- recallOn: state.fields.recallEnabled.text === "true",
1726
1718
  semanticOn: state.fields.semanticRecallEnabled.text === "true",
1727
1719
  idleOn: state.fields.progressReminderIdleEnabled.text === "true"
1728
1720
  };
@@ -1754,7 +1746,6 @@ window.__ModuleLoader__.load({
1754
1746
  const checked = field.text === "true";
1755
1747
  const onChange = (value) => {
1756
1748
  props.edit(name, String(value));
1757
- if (name === "recallEnabled" && !value && flags.semanticOn) props.edit("semanticRecallEnabled", "false");
1758
1749
  };
1759
1750
  const onReset = () => props.resetField(name);
1760
1751
  return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {