dsh-cuigengji-plugin 0.4.4 → 0.4.5

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 (14) hide show
  1. package/README.md +1 -1
  2. package/docs/CHANGELOG.md +7 -0
  3. package/docs/agent-installation.md +12 -11
  4. package/docs/development.md +3 -3
  5. package/docs/getting-started.md +6 -6
  6. package/docs/market-listing.md +1 -1
  7. package/docs/npm-publishing.md +1 -1
  8. package/docs/package-name-migration.md +3 -3
  9. package/docs/release-process.md +4 -2
  10. package/docs/test-report.md +9 -1
  11. package/docs/upgrade.md +2 -2
  12. package/lib/client.js +4 -4
  13. package/package.json +4 -4
  14. package/skills/cuigengji-maintenance/SKILL.md +1 -1
package/README.md CHANGED
@@ -57,7 +57,7 @@
57
57
 
58
58
  ## 开始使用
59
59
 
60
- 当前主要适配 DSH Windows 桌面版，0.4.4 支持 **0.2.1-rc.2** 和 **0.2.0-rc.2**。旧插件 0.4.3 会被新版 DSH 的版本检查拒绝，更新催更姬即可，小说数据与原有功能保持不变。普通用户无需另装 Git、Node.js 或编译源码。
60
+ 当前主要适配 DSH Windows 桌面版，最低版本为 **0.2.0-rc.2**，后续版本默认允许安装；已实际验收 **0.2.1-rc.2** 和 **0.2.0-rc.2**。旧插件 0.4.3 会被新版 DSH 的版本检查拒绝，更新催更姬即可，小说数据与原有功能保持不变。普通用户无需另装 Git、Node.js 或编译源码。
61
61
 
62
62
  推荐把[安装与更新指南](docs/agent-installation.md)交给 Agent；也可以按[桌面安装步骤](docs/getting-started.md)，在 DSH“添加插件”中安装[成品包](https://github.com/mistnest/dsh-cuigengji-plugin/releases/latest)。更新时自动备份、迁移并校验已有作品，详见[更新与数据迁移](docs/upgrade.md)。
63
63
 
package/docs/CHANGELOG.md CHANGED
@@ -1,5 +1,12 @@
1
1
  # 更新记录
2
2
 
3
+ ## 0.4.5 放宽 DSH 版本范围
4
+
5
+ - 最低宿主要求改为 DSH `>=0.2.0-rc.2`，宿主与 peer 依赖声明保持一致；后续 DSH 正式版和预发布版不再因未列入白名单而被拒绝安装。
6
+ - 安装允许范围与实际验收记录分开维护，已实际验收 Windows 桌面版 0.2.1-rc.2 和 0.2.0-rc.2；未来版本允许安装不代表已经逐一测试。遇到真实接口变化再按受影响能力处理。
7
+ - 正文、规划、设定、预设、工具和存储格式沿用公开 0.4.3 系列；新版 DSH 的实际工作台运行、无 Git 安装、0.4.3 / 0.4.4 升级和旧包名迁移分别验收，保留原配置及小说工作数据。
8
+ - 0.4.4 已经公开，安装包保持原样；本次声明调整以新补丁版本发布，避免同版本出现不同包内容。
9
+
3
10
  ## 0.4.4 新版 DSH 兼容修补
4
11
 
5
12
  - 支持 DSH Windows 桌面版 0.2.1-rc.2，保留 0.2.0-rc.2 兼容；修复原 0.4.3 因宿主版本声明被新版插件管理器拒绝安装的问题。
package/docs/agent-installation.md CHANGED
@@ -4,12 +4,13 @@
4
4
 
5
5
  ## 下载入口
6
6
 
7
- - 目标发布：[0.4.4](https://github.com/mistnest/dsh-cuigengji-plugin/releases/tag/v0.4.4)
8
- - 成品安装包：[dsh-cuigengji-plugin-0.4.4.tgz](https://github.com/mistnest/dsh-cuigengji-plugin/releases/download/v0.4.4/dsh-cuigengji-plugin-0.4.4.tgz)
9
- - 哈希校验：[SHA256SUMS](https://github.com/mistnest/dsh-cuigengji-plugin/releases/download/v0.4.4/SHA256SUMS)
10
- - 已验证宿主：DSH Windows 桌面版 **0.2.1-rc.2** 和 **0.2.0-rc.2**。后续宿主版本以对应发布说明为准。
7
+ - 目标发布：[0.4.5](https://github.com/mistnest/dsh-cuigengji-plugin/releases/tag/v0.4.5)
8
+ - 成品安装包：[dsh-cuigengji-plugin-0.4.5.tgz](https://github.com/mistnest/dsh-cuigengji-plugin/releases/download/v0.4.5/dsh-cuigengji-plugin-0.4.5.tgz)
9
+ - 哈希校验：[SHA256SUMS](https://github.com/mistnest/dsh-cuigengji-plugin/releases/download/v0.4.5/SHA256SUMS)
10
+ - 最低宿主：DSH **0.2.0-rc.2**；后续正式版和预发布版默认允许安装。
11
+ - 已验证宿主：DSH Windows 桌面版 **0.2.1-rc.2** 和 **0.2.0-rc.2**。此列表是实际验收记录，不是安装白名单；后续版本遇到具体接口错误时按错误排查，不因未测试就擅自添加版本豁免或改动用户配置。
11
12
 
12
- 安装或更新优先使用精确版本 `dsh-cuigengji-plugin@0.4.4`，执行前核对 npm 精确版本与发布说明。无 Git 验收覆盖新装、旧宿主的 0.4.3 同名升级及 0.4.1 旧名升级，升级后检查完整逻辑工作库保留。备用入口使用上面的 `.tgz` URL，或下载后的 Windows 绝对路径。也支持仓库地址 `https://github.com/mistnest/dsh-cuigengji-plugin`；0.4.1 起仓库包含完整编译文件，不需要构建授权。GitHub 的源码 ZIP 不替代 `.tgz` 包。
13
+ 安装或更新优先使用精确版本 `dsh-cuigengji-plugin@0.4.5`，执行前核对 npm 精确版本与发布说明。无 Git 验收覆盖新装、旧宿主的 0.4.3 / 0.4.4 同名升级及 0.4.1 旧名升级，升级后检查完整逻辑工作库保留。备用入口使用上面的 `.tgz` URL，或下载后的 Windows 绝对路径。也支持仓库地址 `https://github.com/mistnest/dsh-cuigengji-plugin`；0.4.1 起仓库包含完整编译文件，不需要构建授权。GitHub 的源码 ZIP 不替代 `.tgz` 包。
13
14
 
14
15
  **环境清单中若存在旧包 `dsh-cuigengji`，先按[安装名称迁移](package-name-migration.md)以关闭状态装入新包，再离线转接启用项和原配置。不要直接同时启用两个包。** 新安装或已经使用统一名称的更新继续本页流程。
15
16
 
@@ -19,7 +20,7 @@
19
20
 
20
21
  ## 用户可直接交给 Agent 的话
21
22
 
22
- > 请按催更姬的 Windows Agent 安装指南帮我安装或更新 dsh-cuigengji-plugin 到 0.4.4。使用 DSH 原生插件管理与已公开成品包；如果存在旧安装名，先完成名称迁移。保留已有配置和小说数据，完整重启后确认实际加载版本、数据目录和迁移校验结果。重新进入插件时应能直接继续写作。
23
+ > 请按催更姬的 Windows Agent 安装指南帮我安装或更新 dsh-cuigengji-plugin 到 0.4.5。使用 DSH 原生插件管理与已公开成品包；如果存在旧安装名，先完成名称迁移。保留已有配置和小说数据，完整重启后确认实际加载版本、数据目录和迁移校验结果。重新进入插件时应能直接继续写作。
23
24
 
24
25
  ## 1. 查明当前环境
25
26
 
@@ -44,13 +45,13 @@ Windows 外部 Agent 可以用 PowerShell 的 `Get-FileHash -Algorithm SHA256`
44
45
  通过 DSH 原生工具安装固定版本：
45
46
 
46
47
  ```json
47
- {"action":"install_bundle","target":"dsh-cuigengji-plugin@0.4.4","enabled":true}
48
+ {"action":"install_bundle","target":"dsh-cuigengji-plugin@0.4.5","enabled":true}
48
49
  ```
49
50
 
50
51
  需要使用 GitHub 成品包时：
51
52
 
52
53
  ```json
53
- {"action":"install_bundle","target":"https://github.com/mistnest/dsh-cuigengji-plugin/releases/download/v0.4.4/dsh-cuigengji-plugin-0.4.4.tgz","enabled":true}
54
+ {"action":"install_bundle","target":"https://github.com/mistnest/dsh-cuigengji-plugin/releases/download/v0.4.5/dsh-cuigengji-plugin-0.4.5.tgz","enabled":true}
54
55
  ```
55
56
 
56
57
  或把 `target` 换成已经核对过的本地 `.tgz` 绝对路径。没有原生工具访问能力的外部 Agent，可以先准备好包，交由 DSH 的原生插件页安装，并继续接手后面的验证。
@@ -76,12 +77,12 @@ desktop profile 由桌面应用管理。普通 DSH CLI 会拒绝对它直接操
76
77
  再核对版本、原数据根和原作品 ID；下面的数据目录是示例，请换成之前查明的目录：
77
78
 
78
79
  ```json
79
- {"action":"verify","args":{"expectedVersion":"0.4.4","expectedDataRoot":"C:\\Users\\用户名\\AppData\\Local\\cuigengji","expectedNovelIds":[]}}
80
+ {"action":"verify","args":{"expectedVersion":"0.4.5","expectedDataRoot":"C:\\Users\\用户名\\AppData\\Local\\cuigengji","expectedNovelIds":[]}}
80
81
  ```
81
82
 
82
83
  `expectedNovelIds` 可填升级前作品的真实 ID，不用新 ID 替代。确认：
83
84
 
84
- - `status.status=ready`，实际加载版本为 0.4.4，数据根与更新前一致。
85
+ - `status.status=ready`，实际加载版本为 0.4.5，数据根与更新前一致。
85
86
  - `verify.verified=true`，各作品、正文版本、回收站、设定、规划页和绑定数量符合原数据。
86
87
  - 原有作品仍能通过只读工具访问。初次安装应是可用空库，不会附带作者小说。
87
88
 
@@ -91,7 +92,7 @@ desktop profile 由桌面应用管理。普通 DSH CLI 会拒绝对它直接操
91
92
 
92
93
  ## 失败时怎样处理
93
94
 
94
- - **新版 DSH 拒绝旧 0.4.3**：旧包仅声明支持 0.2.0-rc.2。DSH 0.2.1-rc.2 使用本页的 0.4.4 更新入口，保留原配置和数据根，不添加兼容豁免或停用供应链检查。
95
+ - **新版 DSH 拒绝旧 0.4.3**：旧包仅声明支持 0.2.0-rc.2。DSH 0.2.1-rc.2 使用本页的 0.4.5 更新入口，保留原配置和数据根，不添加兼容豁免或停用供应链检查。
95
96
  - **无法从依赖变更中确定安装了哪一个包**：若重复用了同一个仓库地址，改为目标版本的 `.tgz` URL 或明确的新提交地址；核对安装结果与重启后版本，不把无依赖变更当作更新完成。
96
97
  - **找不到 Git / `git ls-remote`**：核对是否误用了仓库地址，换成已核实的 `.tgz`。
97
98
  - **不兼容或构建批准提示**：保留宿主的具体结果，按相应发布说明处理，不绕过宿主检查。
package/docs/development.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  渠道分工、版本规则与每次发布的顺序统一见[渠道维护与发布流程](release-process.md)；本文说明具体构建、测试和迁移验收工具。
4
4
 
5
- 当前插件版本 0.4.4，统一公开名称 `dsh-cuigengji-plugin`，Node.js 24+，DSH 支持 0.2.1-rc.2 和 0.2.0-rc.2。源码同时包含 TypeScript、JavaScript 和 JSX，尚未完成全部模块的 TypeScript 迁移。
5
+ 当前插件版本 0.4.5，统一公开名称 `dsh-cuigengji-plugin`，Node.js 24+，最低宿主要求 DSH `>=0.2.0-rc.2`，后续版本默认允许安装；实际验收 DSH 0.2.1-rc.2 和 0.2.0-rc.2。开发依赖固定 0.2.1-rc.2，范围回归用例不代表已运行未来宿主。源码同时包含 TypeScript、JavaScript 和 JSX，尚未完成全部模块的 TypeScript 迁移。
6
6
 
7
7
  ## 模块与构建
8
8
 
@@ -64,12 +64,12 @@ Windows 上 `scripts/check-release-install.mjs` 在临时 profile 中调用 DSH
64
64
  `npm run test:host-compat -- --desktop-exe <exe> --package <tgz> --report <json>` 在临时 profile 启动该桌面内置的真实 DSH Host，通过 headless 浏览器验收侧栏入口、首次建书、正文自动保存、规划、设定、预设和导入导出，并检查宿主工具与 Skill 注册。只用合成数据，不发送聊天或调用模型；失败截图与诊断保存在报告旁。正式 `release prepare` 也会执行这项检查。
65
65
 
66
66
  ```powershell
67
- node scripts/check-release-install.mjs --desktop-exe "C:\新版DSH\DeepSeek Harness.exe" --old-desktop-exe "C:\旧版DSH\DeepSeek Harness.exe" --package "C:\发布目录\dsh-cuigengji-plugin-0.4.4.tgz" --old-package "C:\旧包目录\dsh-cuigengji-plugin-0.4.3.tgz" --report "C:\验收目录\update.json"
67
+ node scripts/check-release-install.mjs --desktop-exe "C:\新版DSH\DeepSeek Harness.exe" --old-desktop-exe "C:\旧版DSH\DeepSeek Harness.exe" --package "C:\发布目录\dsh-cuigengji-plugin-0.4.5.tgz" --old-package "C:\旧包目录\dsh-cuigengji-plugin-0.4.3.tgz" --report "C:\验收目录\update.json"
68
68
  ```
69
69
 
70
70
  省略 `--old-package` 验证全新安装；`--package` 也可使用真实 Release `.tgz` URL、完整 GitHub 仓库 URL 或固定提交的 `github:owner/repo#commit`。默认不提供 Git，固定提交使用完整 40 位 SHA；不固定提交的仓库地址加 `--with-git` 验收宿主的 Git 引用解析。GitHub 路径同样检查安装后的编译文件、无构建授权和旧库内容。用户安装使用[原生 Agent 指南](agent-installation.md)，不运行此开发者验收脚本。
71
71
 
72
- npm 首次发布与后续可信发布流程见 [npm 发布](npm-publishing.md)。首次发布成功后，同一验收脚本可用 `--npm-package dsh-cuigengji-plugin@0.4.4` 检查按包名安装；它与 `--package` 二选一，继续使用没有 Git 的隔离 profile。名称转换由 `tests/package-identity.test.js` 和真实安装验收覆盖，包括自定义数据根、home/profile 配置、去重、配置原始备份和幂等重试。
72
+ npm 首次发布与后续可信发布流程见 [npm 发布](npm-publishing.md)。首次发布成功后，同一验收脚本可用 `--npm-package dsh-cuigengji-plugin@0.4.5` 检查按包名安装；它与 `--package` 二选一，继续使用没有 Git 的隔离 profile。名称转换由 `tests/package-identity.test.js` 和真实安装验收覆盖，包括自定义数据根、home/profile 配置、去重、配置原始备份和幂等重试。
73
73
 
74
74
  ## 小说数据与源码分离
75
75
 
package/docs/getting-started.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # 安装与开始使用
2
2
 
3
- 使用 DSH Windows 桌面版自带的插件管理即可，普通用户无需另装 Git、Node.js 或 pnpm，也不用编译源码。0.4.4 支持 DSH **0.2.1-rc.2** 和 **0.2.0-rc.2**，其他宿主版本请先核对对应发布说明。
3
+ 使用 DSH Windows 桌面版自带的插件管理即可，普通用户无需另装 Git、Node.js 或 pnpm，也不用编译源码。最低 DSH 版本为 **0.2.0-rc.2**，此后的版本默认允许安装；已实际验收 **0.2.1-rc.2** 和 **0.2.0-rc.2**。
4
4
 
5
5
  ## 交给 Agent 安装或更新
6
6
 
@@ -12,7 +12,7 @@
12
12
 
13
13
  ## 自己在桌面版安装
14
14
 
15
- 当前稳定版为 **0.4.4**，统一名称为 `dsh-cuigengji-plugin`。新安装与已使用统一名称的用户可直接按包名安装。旧安装名为 `dsh-cuigengji` 的用户，把[名称迁移指南](package-name-migration.md)交给 Agent，由它保留配置与小说完成转换。
15
+ 当前稳定版为 **0.4.5**，统一名称为 `dsh-cuigengji-plugin`。新安装与已使用统一名称的用户可直接按包名安装。旧安装名为 `dsh-cuigengji` 的用户，把[名称迁移指南](package-name-migration.md)交给 Agent，由它保留配置与小说完成转换。
16
16
 
17
17
  1. 从 DSH 左侧进入“插件”，点击“添加插件”。
18
18
  2. 在“包名或地址”中填写下面的包名。
@@ -23,17 +23,17 @@
23
23
  dsh-cuigengji-plugin
24
24
  ```
25
25
 
26
- 需要固定本次版本时，填写 `dsh-cuigengji-plugin@0.4.4`。更新已有插件也可填写精确版本，保留原有配置与小说数据。镜像暂未同步时，可改选 npm 官方源。
26
+ 需要固定本次版本时，填写 `dsh-cuigengji-plugin@0.4.5`。更新已有插件也可填写精确版本，保留原有配置与小说数据。镜像暂未同步时，可改选 npm 官方源。
27
27
 
28
28
  ### 成品包备用入口
29
29
 
30
30
  也可以在同一“包名或地址”输入框安装 GitHub Release 成品包：
31
31
 
32
32
  ```text
33
- https://github.com/mistnest/dsh-cuigengji-plugin/releases/download/v0.4.4/dsh-cuigengji-plugin-0.4.4.tgz
33
+ https://github.com/mistnest/dsh-cuigengji-plugin/releases/download/v0.4.5/dsh-cuigengji-plugin-0.4.5.tgz
34
34
  ```
35
35
 
36
- 或者先[下载成品包](https://github.com/mistnest/dsh-cuigengji-plugin/releases/tag/v0.4.4)，将下载后的 Windows 绝对路径填入同一输入框。需要核对下载文件时，可使用 Release 中的 `SHA256SUMS`，或交给 Agent 检查。GitHub 与 npm 使用同一份已验收的包；GitHub 的“Download ZIP”是源码下载，不是这里的成品包。
36
+ 或者先[下载成品包](https://github.com/mistnest/dsh-cuigengji-plugin/releases/tag/v0.4.5)，将下载后的 Windows 绝对路径填入同一输入框。需要核对下载文件时，可使用 Release 中的 `SHA256SUMS`，或交给 Agent 检查。GitHub 与 npm 使用同一份已验收的包；GitHub 的“Download ZIP”是源码下载，不是这里的成品包。
37
37
 
38
38
  ### GitHub 地址安装
39
39
 
@@ -83,7 +83,7 @@ Windows 桌面版是当前主要验证环境；其他系统的默认目录已实
83
83
 
84
84
  **安装后没有入口**：在 DSH 插件管理中检查催更姬是否已安装、启用，并按提示完全退出、重启。仍没有入口时，将[Agent 安装指南](agent-installation.md)交给 Agent 核对当前环境和实际加载状态。
85
85
 
86
- **新版 DSH 提示 0.4.3 不兼容**：在“包名或地址”填写 `dsh-cuigengji-plugin@0.4.4` 更新，不用关闭版本检查或移动小说。0.4.4 保留原有功能与数据格式。
86
+ **新版 DSH 提示 0.4.3 不兼容**：在“包名或地址”填写 `dsh-cuigengji-plugin@0.4.5` 更新，不用关闭版本检查或移动小说。0.4.5 保留原有功能与数据格式。
87
87
 
88
88
  **提示版本冲突**：保留草稿，读取最新内容后比较。不要修改版本号强行覆盖另一会话或 AI 的修改。
89
89
 
package/docs/market-listing.md CHANGED
@@ -22,7 +22,7 @@ tarball: https://github.com/mistnest/dsh-cuigengji-plugin/releases/download/v0.4
22
22
 
23
23
  市场显示名统一为 `dsh-cuigengji-plugin`，中文介绍保留“催更姬”，便于按英文名称或中文名称查找。条目文件名和仓库地址仍用于识别作者与项目，不随显示名修改。
24
24
 
25
- 仓库保留 `dsh-plugin`、`deepseek-harness`、`cuigengji` 等主题标签，供市场与 Agent 检索。实际宿主兼容范围以 `package.json` 和 Release 为准，不扩大声明。npm 包名也统一为 `dsh-cuigengji-plugin`，首次发布与安装验收通过后再将包名入口标为可用；成品包仍使用固定版本 Release 地址。用户界面标题保持“催更姬”，英文安装名在全部渠道一致。
25
+ 仓库保留 `dsh-plugin`、`deepseek-harness`、`cuigengji` 等主题标签，供市场与 Agent 检索。最低宿主要求以 `package.json` 为准，Release 单独列明实际验收版本，未来版本默认允许安装。npm 包名也统一为 `dsh-cuigengji-plugin`，首次发布与安装验收通过后再将包名入口标为可用；成品包仍使用固定版本 Release 地址。用户界面标题保持“催更姬”，英文安装名在全部渠道一致。
26
26
 
27
27
  ## 收录验收
28
28
 
package/docs/npm-publishing.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  整体渠道分工与发布验收顺序见[渠道维护与发布流程](release-process.md)。本文负责 npm 首次发布、可信发布配置和按包名安装验收。
4
4
 
5
- npm 包、GitHub 仓库和市场显示名统一为 **`dsh-cuigengji-plugin`**。目标精确版本、归档和默认标签均验收通过后，用户可在 DSH「插件 → 添加插件 → 包名或地址」中填写 `dsh-cuigengji-plugin`，固定本次版本填写 `dsh-cuigengji-plugin@0.4.4`。「安装源」选择默认、npm 官方源或大陆镜像，不填写 GitHub 地址。这条路线不需要 Git。旧包名安装的用户按[名称迁移指南](package-name-migration.md)更新。
5
+ npm 包、GitHub 仓库和市场显示名统一为 **`dsh-cuigengji-plugin`**。目标精确版本、归档和默认标签均验收通过后，用户可在 DSH「插件 → 添加插件 → 包名或地址」中填写 `dsh-cuigengji-plugin`，固定本次版本填写 `dsh-cuigengji-plugin@0.4.5`。「安装源」选择默认、npm 官方源或大陆镜像，不填写 GitHub 地址。这条路线不需要 Git。旧包名安装的用户按[名称迁移指南](package-name-migration.md)更新。
6
6
 
7
7
  首次发布需要维护者自己的 npm 账号。npm 发布与 `dshmarket` 收录互相独立：npm 包可用不代表市场已收录，市场收录状态仍以[收录申请](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/7064)和公开目录为准。
8
8
 
package/docs/package-name-migration.md CHANGED
@@ -15,10 +15,10 @@
15
15
  通过 DSH 原生工具安装精确版本，使用 `enabled:false`：
16
16
 
17
17
  ```json
18
- {"action":"install_bundle","target":"https://github.com/mistnest/dsh-cuigengji-plugin/releases/download/v0.4.4/dsh-cuigengji-plugin-0.4.4.tgz","enabled":false}
18
+ {"action":"install_bundle","target":"https://github.com/mistnest/dsh-cuigengji-plugin/releases/download/v0.4.5/dsh-cuigengji-plugin-0.4.5.tgz","enabled":false}
19
19
  ```
20
20
 
21
- npm 发布并验证后，`target` 也可使用 `dsh-cuigengji-plugin@0.4.4`。读取真实安装返回，确认新包已落盘。安装失败时旧包继续保留，停止后续步骤。
21
+ npm 发布并验证后，`target` 也可使用 `dsh-cuigengji-plugin@0.4.5`。读取真实安装返回，确认新包已落盘。安装失败时旧包继续保留，停止后续步骤。
22
22
 
23
23
  ### 2. 正常退出后，运行名称迁移工具
24
24
 
@@ -51,7 +51,7 @@ DSH 内的 Agent 需要在退出前准备后台维护任务。工具可加 `--wa
51
51
 
52
52
  ### 3. 从原入口重新打开，核对作品
53
53
 
54
- 从用户原来的快捷方式启动 DSH。确认仅新包被启用，工具调用和前端入口各只有一份；再按[更新与数据迁移](upgrade.md)调用 `cuigengji_maintenance` 的 `status` / `verify`，核对 `0.4.4`、原数据根和升级前作品 ID。只有就绪且完整性验证通过才报告完成。
54
+ 从用户原来的快捷方式启动 DSH。确认仅新包被启用，工具调用和前端入口各只有一份；再按[更新与数据迁移](upgrade.md)调用 `cuigengji_maintenance` 的 `status` / `verify`，核对 `0.4.5`、原数据根和升级前作品 ID。只有就绪且完整性验证通过才报告完成。
55
55
 
56
56
  ### 4. 清理旧依赖
57
57
 
package/docs/release-process.md CHANGED
@@ -15,7 +15,7 @@ npm run release -- status
15
15
 
16
16
  其他电脑传实际 DSH exe 路径，或设置 `CUIGENGJI_DESKTOP_EXE`。这些命令不会更新或关闭正式 DSH，不读真实作品；原生安装测试使用临时 profile 和虚构工作库。
17
17
 
18
- 0.4.4 的目标宿主为 0.2.1-rc.2，上一公开版 0.4.3 仅支持旧宿主。验收时将 `--desktop-exe` 指向新版，另加 `--old-desktop-exe "C:\旧版DSH\DeepSeek Harness.exe"`（或 `CUIGENGJI_PREVIOUS_DESKTOP_EXE`）提供旧运行时。脚本先用旧宿主运行旧插件，再用新版升级，不绕过新宿主的兼容检查。可以使用经过官方签名及校验的独立桌面解包目录，无需替换作者的正式安装。
18
+ 0.4.5 声明最低宿主要求 `>=0.2.0-rc.2`，实际验收目标为 0.2.1-rc.2 与 0.2.0-rc.2。跨宿主升级验收时将 `--desktop-exe` 指向新版，另加 `--old-desktop-exe "C:\旧版DSH\DeepSeek Harness.exe"`（或 `CUIGENGJI_PREVIOUS_DESKTOP_EXE`）提供旧运行时。脚本先用旧宿主运行旧插件，再用新版升级，不绕过新宿主的兼容检查。可以使用经过官方签名及校验的独立桌面解包目录，无需替换作者的正式安装。
19
19
 
20
20
  | 命令 | 负责什么 |
21
21
  | --- | --- |
@@ -79,7 +79,9 @@ GitHub 仓库、npm 包和市场显示名统一为 **`dsh-cuigengji-plugin`**，
79
79
 
80
80
  - 汇总本次新功能、体验调整、修复与兼容变化；没有的类别不硬凑。
81
81
  - 区分本地试用修改与已经公开的版本。更新 `package.json`、锁文件中的本包版本记录（如有）、[更新记录](CHANGELOG.md)和安装指南中的固定版本示例。
82
- - 记录已验证的 DSH 桌面版本与数据布局；兼容声明以实际验收为准。
82
+ - `engines.dsh` 与 DSH peer 依赖声明表达最低宿主要求，默认允许此后的版本，不把已测试名单写成精确版本白名单。开发依赖仍固定实际开发与验收版本，保证可重复构建。
83
+ - 单独记录已实际验证的 DSH 桌面版本与数据布局。用官方检查器验证最低版本、后续正式版/预发布版与过旧版本的范围语义；未来版本的范围用例不算实际宿主验收。
84
+ - 遇到已知接口破坏时，优先对受影响的辅助功能做能力检测与局部降级，必要时为真实不兼容的宿主添加明确边界。核心正文读写或数据完整性不可用时明确报错；新宿主仍须实际启动并通过发布验收后才分发修补包。
83
85
  - 涉及存储变化时，补迁移路径、合成旧库样例、失败恢复和回滚说明。
84
86
 
85
87
  ### 2. 构建并验收
package/docs/test-report.md CHANGED
@@ -1,6 +1,14 @@
1
1
  # 公开版验收说明
2
2
 
3
- 最近兼容修补验收：2026-10-17，版本 0.4.4，目标宿主 DSH 0.2.1-rc.2 / Windows，桌面内置 Node v24.21.0 / Electron 44.7.0 / pnpm 11.28.5；旧宿主基线 0.2.0-rc.2。
3
+ 最近兼容修补验收：2026-10-17，版本 0.4.5，目标宿主 DSH 0.2.1-rc.2 / Windows，桌面内置 Node v24.21.0 / Electron 44.7.0 / pnpm 11.28.5；旧宿主基线 0.2.0-rc.2。
4
+
5
+ ## 0.4.5 最低版本范围与实际宿主验收
6
+
7
+ - `engines.dsh` 和 DSH peer 依赖统一声明 `>=0.2.0-rc.2`，不使用版本豁免。官方兼容检查器覆盖最低版本、后续 rc/正式版本放行和过旧版本拒绝；这些范围用例不代表实际运行过未来宿主。
8
+ - 正式发布前重新使用新版桌面自己的包管理器、Electron Node 和内置 pnpm，在没有 Git 或全局 Node 的临时 profile 中安装最终归档，实际启动该桌面内置的 DSH Host。
9
+ - 实际宿主前端验收侧栏入口、首次建书、正文读取/编辑/自动保存、规划、设定、写作预设与导入导出；同时验证五个工具和六个 Skill 注册、接手索引、MCP 与工作库完整性。页面和插件请求不得有异常。
10
+ - 分别验证公开 0.4.3、0.4.4 与 0.4.1 旧包名的跨宿主升级；比较升级前后完整逻辑工作库摘要，保留作品、正文与历史、回收站、设定、规划、预设、绑定及重试记录。旧宿主另行实际运行工作台回归。
11
+ - 验收使用合成数据，不操作作者正式 DSH/profile 或私人小说，不调用模型。各项结果、桌面版本、截图和最终归档哈希保存在发布工作目录 `releases/v0.4.5/`；任一必需检查失败都不分发。
4
12
 
5
13
  ## 0.4.4 新版宿主兼容
6
14
 
package/docs/upgrade.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # 更新与数据迁移
2
2
 
3
- 0.4.4 是基于 0.4.3 的宿主兼容修补，支持 DSH 0.2.1-rc.2 与 0.2.0-rc.2，不改变存储格式。0.4.3 在新版 DSH 被版本检查拒绝时，由宿主安装 `dsh-cuigengji-plugin@0.4.4`，保留原配置和数据根；不必先导出再导入，也不要删除旧作品。
3
+ 0.4.5 延续公开 0.4.3 系列功能，最低宿主要求为 DSH `>=0.2.0-rc.2`，后续正式版与预发布版默认允许安装；已实际验收 0.2.1-rc.2 和 0.2.0-rc.2。0.4.4 的精确版本白名单已放宽，存储格式保持不变。0.4.3 在新版 DSH 被版本检查拒绝时，由宿主安装 `dsh-cuigengji-plugin@0.4.5`，保留原配置和数据根；不必先导出再导入，也不要删除旧作品。
4
4
 
5
5
  0.4.2 将公开名称统一为 `dsh-cuigengji-plugin`。旧名 `dsh-cuigengji` 安装的用户需要由升级 Agent 完成一次[安装名称迁移](package-name-migration.md)，转接启用项和配置，避免两个包同时加载。小说目录、内部 ID、工具名与数据格式保持兼容。
6
6
 
@@ -32,7 +32,7 @@
32
32
  然后使用真实加载版本和数据根进行校验：
33
33
 
34
34
  ```json
35
- {"action":"verify","args":{"expectedVersion":"0.4.4","expectedDataRoot":"C:\\Users\\用户\\AppData\\Local\\cuigengji"}}
35
+ {"action":"verify","args":{"expectedVersion":"0.4.5","expectedDataRoot":"C:\\Users\\用户\\AppData\\Local\\cuigengji"}}
36
36
  ```
37
37
 
38
38
  只有 `status.status` 为 `ready` 且 `verify.verified` 为 `true`，才能向用户报告更新完成。校验结果包含作品、章节、历史、设定、规划和绑定数量，不返回正文内容。
package/lib/client.js CHANGED
@@ -45,7 +45,7 @@ var import_react = require("react");
45
45
  // package.json
46
46
  var package_default = {
47
47
  name: "dsh-cuigengji-plugin",
48
- version: "0.4.4",
48
+ version: "0.4.5",
49
49
  description: "\u50AC\u66F4\u59EC\uFF1A\u7ED9\u5927\u80A5\u9C7C\u4E00\u4E2A\u5C0F\u8BF4\u5DE5\u4F5C\u53F0\uFF0C\u4E00\u8D77\u5199\u6B63\u6587\u3001\u8BA8\u8BBA\u60C5\u8282\u3001\u6574\u7406\u4EBA\u7269\u4E0E\u4E16\u754C\u8BBE\u5B9A\u3002",
50
50
  type: "module",
51
51
  main: "runtime/index.js",
@@ -113,7 +113,7 @@ var package_default = {
113
113
  },
114
114
  engines: {
115
115
  node: ">=24",
116
- dsh: "0.2.0-rc.2 || 0.2.1-rc.2"
116
+ dsh: ">=0.2.0-rc.2"
117
117
  },
118
118
  dependencies: {
119
119
  "@modelcontextprotocol/sdk": "1.29.0",
@@ -122,8 +122,8 @@ var package_default = {
122
122
  },
123
123
  peerDependencies: {
124
124
  "@deepseek-ai/cordis": "~4.0.4",
125
- "@deepseek-ai/dsh-atomic-write": "0.2.0-rc.2 || 0.2.1-rc.2",
126
- "@deepseek-ai/dsh-tools": "0.2.0-rc.2 || 0.2.1-rc.2",
125
+ "@deepseek-ai/dsh-atomic-write": ">=0.2.0-rc.2",
126
+ "@deepseek-ai/dsh-tools": ">=0.2.0-rc.2",
127
127
  "@deepseek-ai/schemastery": "~3.18.4"
128
128
  },
129
129
  devDependencies: {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-cuigengji-plugin",
3
- "version": "0.4.4",
3
+ "version": "0.4.5",
4
4
  "description": "催更姬：给大肥鱼一个小说工作台，一起写正文、讨论情节、整理人物与世界设定。",
5
5
  "type": "module",
6
6
  "main": "runtime/index.js",
@@ -68,7 +68,7 @@
68
68
  },
69
69
  "engines": {
70
70
  "node": ">=24",
71
- "dsh": "0.2.0-rc.2 || 0.2.1-rc.2"
71
+ "dsh": ">=0.2.0-rc.2"
72
72
  },
73
73
  "dependencies": {
74
74
  "@modelcontextprotocol/sdk": "1.29.0",
@@ -77,8 +77,8 @@
77
77
  },
78
78
  "peerDependencies": {
79
79
  "@deepseek-ai/cordis": "~4.0.4",
80
- "@deepseek-ai/dsh-atomic-write": "0.2.0-rc.2 || 0.2.1-rc.2",
81
- "@deepseek-ai/dsh-tools": "0.2.0-rc.2 || 0.2.1-rc.2",
80
+ "@deepseek-ai/dsh-atomic-write": ">=0.2.0-rc.2",
81
+ "@deepseek-ai/dsh-tools": ">=0.2.0-rc.2",
82
82
  "@deepseek-ai/schemastery": "~3.18.4"
83
83
  },
84
84
  "devDependencies": {
package/skills/cuigengji-maintenance/SKILL.md CHANGED
@@ -25,7 +25,7 @@ description: 安装或更新催更姬后，查询自动迁移、备份和完整
25
25
  返回当前插件版本、实际数据根、来源/目标存储版本、迁移阶段、完整备份路径、作品和正文数量，以及失败原因。它不要求会话绑定小说，迁移失败时仍可调用。
26
26
 
27
27
  ```json
28
- {"action":"verify","args":{"expectedVersion":"0.4.4","expectedDataRoot":"C:\\Users\\用户名\\AppData\\Local\\cuigengji"}}
28
+ {"action":"verify","args":{"expectedVersion":"0.4.5","expectedDataRoot":"C:\\Users\\用户名\\AppData\\Local\\cuigengji"}}
29
29
  ```
30
30
 
31
31
  它在锁内重新读取并校验工作库，返回计数、摘要哈希和每项检查结果。不要把摘要哈希当作正文内容，也不要把数据根替换成维护者电脑上的路径。