dsh-instruction-memory 1.0.8 → 1.0.9

package/README.md

@@ -77,7 +77,7 @@ DSH 就会得到第二份空记忆，看起来像"记忆消失"。
 `dsh.compatibility.dsh` 与 `dsh.engines.dsh` 声明为同一串：
 
 ```
->=0.1.3-alpha.2 <0.1.4 || >=0.1.4-0 <0.1.5-0 || >=0.1.5-alpha.1 <0.1.6-0 || >=0.1.6-alpha.0 <0.2.0-0 || >=0.2.0-0
+>=0.1.3-alpha.2 <0.1.4 || >=0.1.4-0 <0.1.5-0 || >=0.1.5-alpha.1 <0.1.6-0 || >=0.1.6-alpha.0 <0.1.7-0 || >=0.1.7-alpha.0 <0.2.0-0 || >=0.2.0-0
 ```
 
 **实测范围**：以下 5 个宿主版本已在 **Windows / Node 22** 上逐个真实启动验证（每个版本都确认了
@@ -85,7 +85,8 @@ DSH 就会得到第二份空记忆，看起来像"记忆消失"。
 
 `0.1.3-alpha.2` · `0.1.5-alpha.1` · `0.1.5-alpha.2` · `0.1.5-rc.1` · `0.1.5-rc.2`
 
-此外 `0.1.6-alpha.2` 完成了完整的装载与兼容性判定核验（`host-range-test.mjs` 的固定矩阵覆盖它）。
+此外 `0.1.6-alpha.2` 与 `0.1.7-rc.2` 完成了完整的装载与兼容性判定核验（`host-range-test.mjs`
+的固定矩阵覆盖它们，且该脚本会**读取本机实际安装的宿主版本**做实时断言）。
 
 **为什么写成分段形式**：node-semver 规定"候选版本带预发布标签时，区间里必须存在同一个
 major.minor.patch 且自身带预发布标签的比较符"。这条规则是**集合级**的——一个 `||` 分支最多
@@ -98,16 +99,20 @@ major.minor.patch 且自身带预发布标签的比较符"。这条规则是**
   在把 `0.1.3` 当 token 时会放行 `0.1.3-alpha.0/1`。
 
 ⚠️ **一个必须知道的上限**：**未声明的未来 minor 的预发布版本，无法被任何范围覆盖。**
-`0.1.7-rc.1` 这类版本 tuple 与所有比较符都不同，在 npm 语义下**永远匹配不到**——与
-`^0.1.0` 无法匹配 `0.1.7-rc.1` 是同一个限制。正式版（`0.1.7`、`0.2.0`、`1.0.0` 等）不受影响。
-DSH 发布新的预发布 minor 时需追加一段，例如 `|| >=0.1.7-alpha.0 <0.2.0-0`；
-`host-range-test.mjs` 的矩阵会把这类缺口暴露出来。
-
-**历史修复说明**：1.0.7 及以前，范围末段是 `>=0.1.5-alpha.1`。它使宿主 `0.1.6-alpha.2`
-在 npm **默认**语义下被判为**不兼容**（预发布门禁要求 tuple 相同：`0.1.5 ≠ 0.1.6`，
-`>=` 的大小比较根本走不到）。插件市场因为传入 `includePrerelease: true` 而侥幸放行，但任何
-标准 semver 判定都会拒绝——包括 `npm` / `pnpm` 的依赖解析。现已改为逐段枚举，
-两种判定模式结果一致。
+`0.1.8-rc.1` 这类版本 tuple 与所有比较符都不同，在 npm 语义下**永远匹配不到**——与
+`^0.1.0` 无法匹配 `0.1.8-rc.1` 是同一个限制。正式版（`0.1.8`、`0.2.0`、`1.0.0` 等）不受影响。
+DSH 发布新的预发布 minor 时需追加一段，例如 `|| >=0.1.8-alpha.0 <0.2.0-0`；
+`host-range-test.mjs` 的**实时守卫**会把这类缺口暴露出来（它直接读本机安装的宿主版本）。
+
+**历史修复说明**（同一个 bug 出现过两次，值得记下来）：
+
+- 1.0.7 及以前，范围末段是 `>=0.1.5-alpha.1`，使宿主 `0.1.6-alpha.2` 在 npm **默认**语义下
+  被判为**不兼容**（预发布门禁要求 tuple 相同：`0.1.5 ≠ 0.1.6`，`>=` 的大小比较根本走不到）。
+- 1.0.8 改为逐段枚举，但只枚举到 `0.1.6`。DSH 随后发布 `0.1.7-rc.2`，**同一个假阴性再次出现**：
+  范围里最后一个预发布 tuple 是 `0.1.6`，而 `0.1.7 ≠ 0.1.6`。1.0.9 补上 `0.1.7` 段。
+
+两次都因为插件市场传入 `includePrerelease: true` 而侥幸放行，但任何标准 semver 判定
+（`npm` / `pnpm` 的依赖解析）都会拒绝。现在 `host-range-test.mjs` 同时具备固定矩阵与实时守卫。
 
 **未验证范围**：macOS / Linux、`headless` 与 `tui` profile、以及上表之外的其他 DSH 版本均未实测。
 

package/lib/index.js

@@ -36,7 +36,28 @@ const STORE_FILE_NAME = 'memory.json'
 /** Pre-release location, kept only so existing installs can migrate off it. */
 const LEGACY_FILE_NAME = '.dsh-instruction-memory.json'
 const SECTION_NAME = 'instruction-memory'
-const SECTION_ORDER = 900
+/**
+ * Placement of the injected instruction block among the system prompt's
+ * ordered sections. Sections are concatenated ascending; equal orders fall
+ * back to code-unit name order, which is not something a plugin can reason
+ * about — so this value must not collide with a reserved slot.
+ *
+ * `@deepseek-ai/dsh-system-prompt` owns a central `SECTION_ORDERS` table
+ * (0.1.7-rc.2): HARNESS_IDENTITY -1000, DEPLOYMENT_PERSONA_PREFIX 0,
+ * PLAN_POLICY 500, TEAM_POLICY 600, PTC_ONLY 800, FILE_REFERENCE **900**,
+ * TOOL_BASH 1000, … STRUCTURED_OUTPUT 9900, HARNESS_SOURCE 10000,
+ * WEB_SURFACE 10100, DEPLOYMENT_PERSONA_SUFFIX 10200.
+ *
+ * This was 900 through 1.0.8 — an exact tie with FILE_REFERENCE. It never
+ * threw (a tie only degrades to dictionary order), and it happened to sort
+ * the way we wanted: `instruction-memory` > `file-reference` on code units
+ * ('i' 105 > 'f' 102), so the block landed just after the file references.
+ * That is an accident of the name, not a decision, and renaming the section
+ * would silently move it. 950 states the intent outright: in the gap between
+ * FILE_REFERENCE (900) and TOOL_BASH (1000) — after the file-reference block,
+ * before the tool descriptions, clear of every reserved value.
+ */
+const SECTION_ORDER = 950
 const API_PREFIX = '/instruction-memory/api'
 /** Request body ceiling for the settings-page route; anything larger is rejected. */
 const MAX_BODY_CHARS = 1_000_000

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-instruction-memory",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "User-only instruction memory for DSH: long-term instructions maintained in the settings UI and auto-injected into every conversation — the model has no write access. 指令记忆：只由用户在设置页维护的长期指令，自动注入此后每轮对话；模型没有任何写入口。",
   "license": "MIT",
   "type": "module",
@@ -61,16 +61,16 @@
     },
     "client": {
       "inject": [
-        "@deepseek-ai/dsh-client-runtime",
-        "@deepseek-ai/dsh-client-ui-slots"
+        "@deepseek-ai/dsh-client-ui-renderer",
+        "@deepseek-ai/dsh-client-ui-settings"
       ],
       "platform": "web"
     },
     "engines": {
-      "dsh": ">=0.1.3-alpha.2 <0.1.4 || >=0.1.4-0 <0.1.5-0 || >=0.1.5-alpha.1 <0.1.6-0 || >=0.1.6-alpha.0 <0.2.0-0 || >=0.2.0-0"
+      "dsh": ">=0.1.3-alpha.2 <0.1.4 || >=0.1.4-0 <0.1.5-0 || >=0.1.5-alpha.1 <0.1.6-0 || >=0.1.6-alpha.0 <0.1.7-0 || >=0.1.7-alpha.0 <0.2.0-0 || >=0.2.0-0"
     },
     "compatibility": {
-      "dsh": ">=0.1.3-alpha.2 <0.1.4 || >=0.1.4-0 <0.1.5-0 || >=0.1.5-alpha.1 <0.1.6-0 || >=0.1.6-alpha.0 <0.2.0-0 || >=0.2.0-0"
+      "dsh": ">=0.1.3-alpha.2 <0.1.4 || >=0.1.4-0 <0.1.5-0 || >=0.1.5-alpha.1 <0.1.6-0 || >=0.1.6-alpha.0 <0.1.7-0 || >=0.1.7-alpha.0 <0.2.0-0 || >=0.2.0-0"
     }
   }
 }