dsh-reasoning-distill 0.1.8 → 0.1.10

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 本插件的版本变更记录。
 
+## 0.1.10
+
+- **计费口径修正**：只统计「产出压缩的那一轮」内、用户发下一条消息之前后续请求的重放；跨轮次的重放不再计入节省（DeepSeek 的 API 不参考之前轮次的 `reasoning_content`），报告里的当前减量也按这一轮计算，旧轮次的改写不再显示为节省。
+- **兼容性标注**：`dsh.compatibility.dshReleases` 增补 `0.2.1-rc.2`。核对了 rc.1 与 rc.2 的 6 个 in-place 补丁目标文件与公开 API catalog，两者逐字节相同，因此 rc.1 的完整验证结论同样适用；README 的测试版本表同步更新。
+
+## 0.1.9
+
+- README 开头补充「适用场景」说明：本插件只在单轮次、多步工具调用的超长单轮对话里划算；多轮问答中每轮步骤少、压缩收益有限，且 DeepSeek 的 API 默认不会参考之前轮次的 `reasoning_content`（仅请求携带 tools 时拼接进上下文），改写还会让缓存前缀失效、后续请求按未命中计费，整体往往难以抵消。插件面向「说完任务就不管」的许愿式编程，在根据用户反馈反复精修的阶段建议关闭。
+- 本次没有代码改动。
+
 ## 0.1.8
 
 - **调整初始配置**：刚安装时默认规则里的「对可续接子代理启用」「附带工具调用结果」「压缩最终回答轮」现在默认关闭。新建的逐模型规则同样以一个全关的初始层开始（三种会话类型全关，上述三项也显式关闭），不会因为现有默认规则把它们开着而自动继承为开。

package/README.md

@@ -2,11 +2,19 @@
 
 把过长的模型思考压缩成核心内容，之后每次请求都重放压缩版，省下重复发送的 token；同时给出每个会话的开销与节省报告。
 
+> **⚠️ 适用场景**
+>
+> 本插件只在 **「单轮次、多步工具调用的超长单轮对话」** 里划算。模型连续调用很多步工具时，同一段历史在每一步都要重新发送，压缩后的思考会在同一轮里被反复重放，省下的输入 token 才能累积到超过蒸馏开销。
+>
+> **「多轮问答」** 中每轮通常只有少量步骤，压缩省下的 token 有限。更关键的是，**DeepSeek 的 API 在多轮对话中不会参考之前轮次的 `reasoning_content`**（只有请求携带 tools 时才会拼接进上下文），压缩后的思考通常不会被模型读到；改写却会改变历史内容，而上下文缓存按前缀精确匹配，改写点之后的内容会变成未命中输入，再加上每次蒸馏的费用，整体往往难以抵消。
+>
+> 可以说这个插件的设计目标就是 **「说完任务就什么都不管了」的「许愿式编程」** ，也就是一次说清任务、让 agent 自行跑完很长的工具调用链。在 **「根据用户反馈反复精修」** 的阶段，对话形态是多轮问答，**建议关闭插件**（关掉设置里的总开关即可）。
+
 > 插件**默认关闭**，装好后需要在「设置 → 思考压缩」里选中一个改写后端并手动打开总开关。
 
 > **版本与安装方式（先看这里）**
 >
-> - **可能适配的 DSH 版本**：`0.2.0-rc.1` ～ `0.2.1-rc.1`。这一范围内的补丁、类型与语义都逐版本验证过，明细见下文「经过测试的 DSH 版本」。
+> - **可能适配的 DSH 版本**：`0.2.0-rc.1` ～ `0.2.1-rc.2`（`0.2.1-rc.2` 与 `0.2.1-rc.1` 的补丁目标文件、公开 API catalog 逐字节相同，结论直接适用）。这一范围内的补丁、类型与语义都逐版本验证过，明细见下文「经过测试的 DSH 版本」。
 > - **已知可以正常运行 in-place 后端**的版本：`0.2.1-alpha.1`、`0.2.1-alpha.5`。
 > - **想要全部功能与最佳体验，请使用从源码构建的 DSH**（clone 官方仓库后从源码运行或构建）。**从 npm 直接下载的版本**和**第三方打包版**（例如 dsh-desktop）无法给宿主源码打补丁，in-place 后端用不了，只能退而使用 message-edit。
 
@@ -49,6 +57,7 @@
 | 已知可运行 in-place | `0.2.1-alpha.1`、`0.2.1-alpha.5` | alpha.1 是本插件开发机（补丁已长期在真实会话中使用）；alpha.5 是反馈该问题的用户所在版本，补丁与插件均确认可用 |
 | 完整启动 | `0.2.1-rc.1` | 独立 clone 全量构建后装入插件并启动 `web`，插件的安装页与报告页路由都能正常应答 |
 | 补丁 + 类型 + 语义 | `0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`～`0.2.1-alpha.5`、`0.2.1-rc.1` | 独立 clone 上逐版本 `--apply` → `--check` → `--revert`（回退后工作树逐字节干净）、打过补丁的包 `tsc -b` 通过、持久化探针 `scripts/probe-inplace-durability.mjs` 通过（none 与 zstd）、插件依赖的宿主 API 兼容探针通过 |
+| 等价核对 | `0.2.1-rc.2` | 6 个补丁目标文件与公开 API catalog 和 `0.2.1-rc.1` 逐字节相同，故上一行对 rc.1 的全部结论直接适用 |
 
 - 也就是说：**在 0.2.x 范围内，in-place 补丁与插件的宿主 API 都有逐版本实测依据**；其中 `0.2.1-alpha.1` 与 `0.2.1-alpha.5` 已知可正常运行 in-place，完整启动验证过的是 `0.2.1-rc.1`。其余版本请先在可回退的环境里试。
 - 版本差异最大的一处：`packages/session/session-persistence-jsonl/src/storage.ts` 的 `install()` 从 `0.2.1-alpha.3` 起改成了 generator effect + 闭包变量（`writers` 取代 `this.writers`，在 generator 内部 `this` 已不是那个实例）。补丁脚本为此处带**两份锚点**，会按宿主实际形态自动选择匹配的那份。
@@ -200,8 +209,8 @@ node scripts/dsh-inplace-patch.mjs --check          # 打全了输出 PATCHED
 
 ### 报告里的几个数字
 
-- **当前单次请求减量**：当前生效的改写让**这一次**请求少带的估算 token，是存量而不是累计；改写被整段压缩淘汰后相应减少，全部淘汰归零。
-- **历史累计节省**：永不重置。
+- **当前单次请求减量**：当前这一轮（用户发下一条消息之前）里，下一次请求会少带的估算 token，是存量而不是累计；改写被整段压缩淘汰后相应减少，全部淘汰归零。用户发新消息后归零，因为新的一轮不会重放上一轮的思考。
+- **历史累计节省**：永不重置，但只统计**产出压缩的那一轮**里、用户发下一条消息之前后续请求的重放；跨轮次的重放不计入（DeepSeek 的 API 不参考之前轮次的 reasoning_content）。
 - **净收益** = 历史累计节省 − 蒸馏开销 − 缓存断裂开销。
 - **最近一步未触发的原因**：面板会直接给出（总开关关、未选择后端、规则关、未到阈值、上下文占用超过上限、这一步没有思考、有多个思考块、有后台工作在跑等）。
 - **压缩会话**：每次蒸馏都会开一个旁路会话，用来查看这次压缩的提示词与回答。它**只存在于内存里、不写盘**：本次运行期间可以点开，重启后自动过期，报告里会显示"会话已随上次运行结束（内容见下方明细）"——完整内容本来就在明细里。

package/lib/client/index.js

@@ -1359,49 +1359,49 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var Settings_module_css_default = {
-			"pickerList": "jP3NOa_pickerList",
-			"primary": "jP3NOa_primary",
-			"modalBackdrop": "jP3NOa_modalBackdrop",
-			"modal": "jP3NOa_modal",
-			"modalBody": "jP3NOa_modalBody",
+			"checks": "jP3NOa_checks",
+			"section": "jP3NOa_section",
 			"log": "jP3NOa_log",
-			"prompt": "jP3NOa_prompt",
-			"actions": "jP3NOa_actions",
-			"note": "jP3NOa_note",
-			"badge": "jP3NOa_badge",
-			"preview": "jP3NOa_preview",
-			"error": "jP3NOa_error",
-			"pickerPanel": "jP3NOa_pickerPanel",
-			"pickerItem": "jP3NOa_pickerItem",
-			"installEntry": "jP3NOa_installEntry",
-			"modeCards": "jP3NOa_modeCards",
-			"toggle": "jP3NOa_toggle",
-			"modeCard": "jP3NOa_modeCard",
+			"header": "jP3NOa_header",
 			"sectionHeading": "jP3NOa_sectionHeading",
-			"itemBody": "jP3NOa_itemBody",
-			"installProgress": "jP3NOa_installProgress",
 			"muted": "jP3NOa_muted",
-			"header": "jP3NOa_header",
-			"section": "jP3NOa_section",
-			"page": "jP3NOa_page",
-			"checks": "jP3NOa_checks",
-			"iconButton": "jP3NOa_iconButton",
-			"priceGrid": "jP3NOa_priceGrid",
-			"logBox": "jP3NOa_logBox",
-			"route": "jP3NOa_route",
-			"search": "jP3NOa_search",
+			"pickerList": "jP3NOa_pickerList",
+			"steps": "jP3NOa_steps",
 			"secondary": "jP3NOa_secondary",
+			"rule": "jP3NOa_rule",
+			"picker": "jP3NOa_picker",
+			"search": "jP3NOa_search",
+			"capBox": "jP3NOa_capBox",
+			"modalHead": "jP3NOa_modalHead",
+			"preview": "jP3NOa_preview",
+			"pickerItem": "jP3NOa_pickerItem",
+			"logBox": "jP3NOa_logBox",
+			"prompt": "jP3NOa_prompt",
+			"page": "jP3NOa_page",
+			"pickerPanel": "jP3NOa_pickerPanel",
 			"peakBox": "jP3NOa_peakBox",
+			"modalBackdrop": "jP3NOa_modalBackdrop",
+			"installEntry": "jP3NOa_installEntry",
 			"holidayBox": "jP3NOa_holidayBox",
-			"backendOptions": "jP3NOa_backendOptions",
-			"rule": "jP3NOa_rule",
+			"actions": "jP3NOa_actions",
 			"item": "jP3NOa_item",
+			"error": "jP3NOa_error",
+			"backendOptions": "jP3NOa_backendOptions",
 			"installBlock": "jP3NOa_installBlock",
-			"modalHead": "jP3NOa_modalHead",
-			"steps": "jP3NOa_steps",
+			"route": "jP3NOa_route",
+			"modeCards": "jP3NOa_modeCards",
+			"toggle": "jP3NOa_toggle",
+			"modalBody": "jP3NOa_modalBody",
+			"note": "jP3NOa_note",
+			"badge": "jP3NOa_badge",
+			"primary": "jP3NOa_primary",
+			"itemBody": "jP3NOa_itemBody",
+			"priceGrid": "jP3NOa_priceGrid",
+			"modal": "jP3NOa_modal",
+			"iconButton": "jP3NOa_iconButton",
+			"modeCard": "jP3NOa_modeCard",
 			"field": "jP3NOa_field",
-			"picker": "jP3NOa_picker",
-			"capBox": "jP3NOa_capBox"
+			"installProgress": "jP3NOa_installProgress"
 		};
 		//#endregion
 		//#region src/client/InstallBackend.tsx
@@ -2834,41 +2834,41 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var View_module_css_default = {
-			"summary": "_7CZWHG_summary",
-			"textBlock": "_7CZWHG_textBlock",
-			"secondary": "_7CZWHG_secondary",
-			"facts": "_7CZWHG_facts",
-			"positive": "_7CZWHG_positive",
-			"section": "_7CZWHG_section",
-			"activity": "_7CZWHG_activity",
-			"metric": "_7CZWHG_metric",
-			"entryBody": "_7CZWHG_entryBody",
-			"negative": "_7CZWHG_negative",
-			"activityDot": "_7CZWHG_activityDot",
-			"muted": "_7CZWHG_muted",
+			"blockedBanner": "_7CZWHG_blockedBanner",
 			"activityLabel": "_7CZWHG_activityLabel",
-			"popup": "_7CZWHG_popup",
-			"activeRow": "_7CZWHG_activeRow",
-			"note": "_7CZWHG_note",
 			"popupRow": "_7CZWHG_popupRow",
 			"activityDotBlocked": "_7CZWHG_activityDotBlocked",
-			"activityWhy": "_7CZWHG_activityWhy",
-			"popupList": "_7CZWHG_popupList",
-			"popupFacts": "_7CZWHG_popupFacts",
-			"popupHead": "_7CZWHG_popupHead",
-			"blockedBanner": "_7CZWHG_blockedBanner",
-			"rdPulse": "_7CZWHG_rdPulse",
-			"entry": "_7CZWHG_entry",
+			"secondary": "_7CZWHG_secondary",
+			"actions": "_7CZWHG_actions",
+			"popupActions": "_7CZWHG_popupActions",
 			"sessionInfo": "_7CZWHG_sessionInfo",
-			"iconButton": "_7CZWHG_iconButton",
 			"header": "_7CZWHG_header",
-			"headerTrigger": "_7CZWHG_headerTrigger",
+			"negative": "_7CZWHG_negative",
+			"metric": "_7CZWHG_metric",
+			"textBlock": "_7CZWHG_textBlock",
+			"positive": "_7CZWHG_positive",
+			"popupHead": "_7CZWHG_popupHead",
+			"iconButton": "_7CZWHG_iconButton",
+			"facts": "_7CZWHG_facts",
 			"entryTitle": "_7CZWHG_entryTitle",
+			"popupFacts": "_7CZWHG_popupFacts",
+			"entry": "_7CZWHG_entry",
+			"popup": "_7CZWHG_popup",
+			"popupList": "_7CZWHG_popupList",
+			"rdPulse": "_7CZWHG_rdPulse",
+			"headerTrigger": "_7CZWHG_headerTrigger",
+			"note": "_7CZWHG_note",
+			"activity": "_7CZWHG_activity",
+			"activityWhy": "_7CZWHG_activityWhy",
+			"activeRow": "_7CZWHG_activeRow",
+			"section": "_7CZWHG_section",
+			"muted": "_7CZWHG_muted",
+			"error": "_7CZWHG_error",
 			"page": "_7CZWHG_page",
+			"summary": "_7CZWHG_summary",
 			"sessionRow": "_7CZWHG_sessionRow",
-			"error": "_7CZWHG_error",
-			"popupActions": "_7CZWHG_popupActions",
-			"actions": "_7CZWHG_actions"
+			"entryBody": "_7CZWHG_entryBody",
+			"activityDot": "_7CZWHG_activityDot"
 		};
 		//#endregion
 		//#region src/client/ActivityChip.tsx