dsh-reasoning-distill 0.1.4 → 0.1.5

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 本插件的版本变更记录。
 
+## 0.1.5
+
+- **适配 DSH `0.2.0-rc.1` ～ `0.2.1-rc.1`**：in-place 补丁在每个版本上 `--apply` → `--check` → `--revert` 全部通过（回退后工作树逐字节干净），打过补丁的包 `tsc -b` 通过，持久化探针（none / zstd）通过；兼容范围写进 `dsh.compatibility.dshReleases`。
+- `scripts/probe-inplace-durability.mjs` 同时适配 jsonl 后端的两种导出形态：`0.2.1-alpha.2` 及以前是 default export 的提供者类，`0.2.1-alpha.3` 起是 `name` + `apply` 的 Cordis 插件。
+- README 开头补充「版本与安装方式」：可能适配的版本范围、已知可运行 in-place 的版本（`0.2.1-alpha.1`、`0.2.1-alpha.5`），以及「想要全部功能与最佳体验请用从源码构建的 DSH」。
+
 ## 0.1.4
 
 - **in-place 宿主补丁现在自动适配 `0.2.1-alpha.1` ～ `0.2.1-alpha.5`**：同一个编辑点可以带多组完整锚点，脚本按宿主实际形态挑**恰好匹配的一组**；一组都不匹配、或有多组命中，仍然整体拒绝、不做部分写入。

package/README.md

@@ -4,6 +4,12 @@
 
 > 插件**默认关闭**，装好后需要在「设置 → 思考压缩」里选中一个改写后端并手动打开总开关。
 
+> **版本与安装方式（先看这里）**
+>
+> - **可能适配的 DSH 版本**：`0.2.0-rc.1` ～ `0.2.1-rc.1`。这一范围内的补丁、类型与语义都逐版本验证过，明细见下文「经过测试的 DSH 版本」。
+> - **已知可以正常运行 in-place 后端**的版本：`0.2.1-alpha.1`、`0.2.1-alpha.5`。
+> - **想要全部功能与最佳体验，请使用从源码构建的 DSH**（clone 官方仓库后从源码运行或构建）。**从 npm 直接下载的版本**和**第三方打包版**（例如 dsh-desktop）无法给宿主源码打补丁，in-place 后端用不了，只能退而使用 message-edit。
+
 ---
 
 ## 一、它做什么
@@ -36,11 +42,17 @@
 
 #### 经过测试的 DSH 版本
 
-- **实机运行验证过的只有 `0.2.1-alpha.1`**：就是本插件开发机正在运行的版本，in-place 补丁已在真实会话里长期使用。
-- **补丁本身经过验证的版本**：`0.2.1-alpha.1` ～ `0.2.1-alpha.5`。做法是把官方仓库单独 clone 出来，逐个 tag 跑 `--apply` → `--check` → `--revert` → `--check`（全部通过，回退后工作树逐字节干净），并让打过补丁的树跑 `tsc -b`（`alpha.3` 与 `alpha.5` 实测通过）。
-  - `alpha.4` / `alpha.5` 的 6 个补丁目标文件与 `alpha.3` 逐字节相同，所以这三个版本是同一组结论。
-- 上面的"覆盖"只证明：补丁能干净地打上、能逐字节回退、打过补丁的包能通过类型检查。**运行期行为只有 `alpha.1` 是实测的**；更"新"的宿主版本请先在一个可回退的环境里验证再长期使用。
-- 版本差异最大的一处：`packages/session/session-persistence-jsonl/src/storage.ts` 的 `install()` 从 `0.2.1-alpha.3` 起改成了 generator effect + 闭包变量（`writers` 取代 `this.writers`，在 generator 内部 `this` 已不是那个实例）。补丁脚本为此处带**两份锚点**，会按宿主实际形态自动选择匹配的那份，不会用"只改缩进"的方式硬套。
+分三档看，别把"补丁能打上"当成"整套在真实会话里跑过"：
+
+| 档位 | 覆盖的版本 | 做到了什么 |
+| --- | --- | --- |
+| 已知可运行 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.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` 已不是那个实例）。补丁脚本为此处带**两份锚点**，会按宿主实际形态自动选择匹配的那份。
+- `scripts/probe-inplace-durability.mjs` 同时适配了 jsonl 后端的两种导出形态：`0.2.1-alpha.2` 及以前 default export 提供者类，`0.2.1-alpha.3` 起是 `name` + `apply` 的 Cordis 插件。
 
 ### 旧后端 `message-edit`（保留兼容，不推荐）
 

package/lib/client/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-reasoning-distill",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "type": "module",
   "description": "Distill over-long model reasoning into its useful core and replay the distilled version on every later request, with a per-session cost report.",
   "license": "MIT",
@@ -62,7 +62,14 @@
     },
     "compatibility": {
       "dshReleases": {
-        "0.2.1-alpha.1": "compatible"
+        "0.2.0-rc.1": "compatible",
+        "0.2.0-rc.2": "compatible",
+        "0.2.1-alpha.1": "compatible",
+        "0.2.1-alpha.2": "compatible",
+        "0.2.1-alpha.3": "compatible",
+        "0.2.1-alpha.4": "compatible",
+        "0.2.1-alpha.5": "compatible",
+        "0.2.1-rc.1": "compatible"
       },
       "node": ">=20"
     }

package/scripts/probe-inplace-durability.mjs

@@ -24,7 +24,7 @@
 
 import { Context } from '@deepseek-ai/cordis'
 import SessionStore, { SessionId } from '@deepseek-ai/dsh-session'
-import JsonlSessionPersistence from '@deepseek-ai/dsh-session-persistence-jsonl'
+import * as jsonlPersistence from '@deepseek-ai/dsh-session-persistence-jsonl'
 import { createMessage } from '@deepseek-ai/dsh-llm'
 import { mkdtemp, readFile, rm } from 'node:fs/promises'
 import { tmpdir } from 'node:os'
@@ -44,11 +44,28 @@ function check(label, ok, detail) {
 
 const root = await mkdtemp(join(tmpdir(), 'dsh-inplace-probe-'))
 
+/**
+ * The jsonl backend as something this host can mount, in either shape it has shipped.
+ *
+ * Up to 0.2.1-alpha.2 the package default-exported the provider class; from 0.2.1-alpha.3 it is a
+ * plain Cordis plugin (a module-level name + apply, with its Config no longer a static member).
+ * The probe adapts instead of pinning one tag, so a checkout at any covered 0.2.x release can be
+ * verified with this one file.
+ * @returns the plugin value ctx.plugin accepts.
+ */
+function jsonlPlugin() {
+  if (typeof jsonlPersistence.default === 'function') return jsonlPersistence.default
+  if (typeof jsonlPersistence.apply === 'function') {
+    return { name: jsonlPersistence.name, apply: jsonlPersistence.apply }
+  }
+  throw new Error('dsh-session-persistence-jsonl exports neither a default plugin nor apply()')
+}
+
 /** Mount one SessionStore + jsonl backend over the shared root. */
 async function boot() {
   const ctx = new Context()
   await ctx.plugin(SessionStore)
-  await ctx.plugin(JsonlSessionPersistence, { root, compression: COMPRESSION })
+  await ctx.plugin(jsonlPlugin(), { root, compression: COMPRESSION })
   return ctx
 }
 
@@ -146,7 +163,7 @@ try {
 
     // A fresh context over the same root: what a restarted process would see.
     fresh = new Context()
-    await fresh.plugin(JsonlSessionPersistence, { root, compression: COMPRESSION })
+    await fresh.plugin(jsonlPlugin(), { root, compression: COMPRESSION })
     const onDisk = storedReasoning(await storedEvents(fresh, session.id))
     check('a restarted reader sees the rewrite on disk', onDisk === REWRITTEN, String(onDisk))
     if (COMPRESSION === 'none') {