dsh-smooth-stream 0.4.3 → 0.5.0

package/README.en.md

@@ -111,6 +111,19 @@ To uninstall: `pnpm dsh plugin --profile web remove dsh-smooth-stream`.
 
 ---
 
+## Kernel Compatibility
+
+| DSH kernel | This plugin |
+|---|---|
+| 0.1.0-rc.5 - 0.1.0-rc.7 | ✅ all versions |
+| 0.1.1-rc.2 | ✅ all versions |
+| 0.1.2-alpha.1 - 0.1.2-alpha.3 | ✅ 0.4.3+; 0.4.2 and earlier fail to load on 0.1.2 because they statically import the removed helper |
+
+- ✅ = compatible. `0.1.2-alpha.3` is the current host kernel and has been verified live (built-artifact import + test suites); the remaining kernels are covered by the dual-kernel-compatible design (one build, one API surface).
+- **Kernel 0.1.2 removed the `settingsNamespace()` runtime helper** (on ≤ 0.1.1 it was a validating identity function; 0.1.2 keeps only the same-named type). This plugin does not statically import that symbol any more — it inlines its namespace constant locally and asserts it as the `SettingsNamespace` type, which works on both old and new kernels.
+- Since 0.4.3 the plugin no longer statically imports `settingsNamespace()` (see the compat fix in git history); older versions only work on kernels ≤ 0.1.1.
+- **Never statically import runtime symbols from `@deepseek-ai/*` packages.** The host CLI starts via `node --import tsx/esm`, and tsx applies the host `tsconfig` `paths` mapping, so a bare `@deepseek-ai/*` import from an external plugin may be redirected into the host's own sources — any host-side rename or removal then explodes at boot as a module instantiation error. Type-only imports (`import type`) are unaffected.
+
 ## Presets & Configuration
 
 The plugin defaults to `preset: balanced`. You can tune the cadence in your profile's `cordis.patch.yml`:

package/README.md

@@ -110,6 +110,19 @@ Host 日志中显示 `[dsh-smooth-stream] plugin loaded!` 即表示已成功加
 
 ---
 
+## 内核兼容性
+
+| DSH 内核 | 本插件支持情况 |
+|---|---|
+| 0.1.0-rc.5 ～ 0.1.0-rc.7 | ✅ 全部版本 |
+| 0.1.1-rc.2 | ✅ 全部版本 |
+| 0.1.2-alpha.1 ～ 0.1.2-alpha.3 | ✅ 0.4.3 起；0.4.2 及更早版本因静态导入已移除的助手而在 0.1.2 上加载失败 |
+
+- ✅ = 兼容。`0.1.2-alpha.3` 为当前宿主内核，已实测（产物导入 + 测试套件）；其余内核按双内核兼容设计支持（同一份构建、同一 API 面）。
+- **0.1.2 起内核移除了 `settingsNamespace()` 运行时助手**（≤ 0.1.1 上它只是个校验恒等函数，0.1.2 仅保留同名类型）。本插件不静态导入该符号，而是在注册设置命名空间时本地内联常量并断言为 `SettingsNamespace` 类型，新旧内核通用。
+- 0.4.3 起不再静态导入 `settingsNamespace()`（见 git 历史中的兼容修复）；更早版本仅在 ≤ 0.1.1 内核上可用。
+- **不要对 `@deepseek-ai/*` 包的运行时符号做静态导入**。宿主 CLI 经 `node --import tsx/esm` 启动，tsx 会应用宿主 `tsconfig` 的 `paths` 映射，外部插件对 `@deepseek-ai/*` 的裸导入可能被重定向进宿主源码，一旦宿主侧改名/删符号就会以模块实例化错误的形式炸掉启动。类型导入（`import type`）不受影响。
+
 ## 配置与手感预设
 
 插件默认采用 `preset: balanced`。如需切换手感，可在对应 profile 的 `cordis.patch.yml` 中修改：