dsh-anima 2.2.1 → 2.2.3

package/CHANGELOG.md

@@ -9,6 +9,53 @@
 
 ---
 
+## [2.2.3] - 2026-11-11
+
+修复设置页右上角徽标的版本号，并把拦这个错误的断言挂进发布流程。
+2.2.2 是纯文档版，只 bump 了 `package.json`，没同步客户端里写死的那个常量，
+于是发出的包上徽标仍显示 `v2.2.1`，与本包实际版本对不上号。
+
+### 修复
+
+- **徽标版本号与 package.json 一致**：`client/index.mjs` 的 `VERSION` 常量从
+  `2.2.1` 改到 `2.2.3`，设置页右上角显示 `v2.2.3`。
+- **发布前自动拦住同类错误**：`package.json` 新增 `prepublishOnly`（跑
+  `npm run verify`）。`scripts/verify-core.mjs:3204` 本来就有一条
+  「客户端徽标版本与 package.json 的 version 一致」的断言，2.2.2 发布时没跑它，
+  所以没拦住；挂上钩子后，下次再漏改同一个常量，publish 会直接失败，而不是
+  发出一个带错号的包。
+- **安装示例的版本号对齐到 2.2.3**：README.md / README_EN.md 安装段的 pin 与
+  `@` / `#` 说明，一起从 2.2.2 / v2.2.2 改到 2.2.3 / v2.2.3。
+
+### 没做
+
+- 除 `VERSION` 这一个常量外，运行时代码、存储格式（DOMAIN_VERSION 仍为 1）
+  一律不动，2.2.2 升到 2.2.3 不需要迁移数据、不影响已有配置。
+- 讲历史区间的陈述（「从 1.0.0 到 2.2.1 的存储格式相同」等）与 2.2.2 及更早的
+  更新日志原样保留，bump 时不做全量版本替换，避免误伤历史记录。
+
+## [2.2.2] - 2026-11-11
+
+纯文档版本：把已经合进 main、却没随任何 npm 版本发出的安装说明修正带上 npm。
+不改代码、不改存储格式、没有新功能。
+
+### 修复
+
+- **npm 发布包的 README 不再自相矛盾**：2.2.1 的包是从 tag b795497 打的，当时的
+  安装段还写着「本插件尚未发布到 npm，从仓库直接装」——可这个包本身已经发在 npm 上。
+  修正（提交 5f5049f：把安装段改成「从 npm 安装（推荐）」并给出按包名安装的命令）是在
+  那个 tag 之后才合进 main 的，所以 2.2.1 包没带上它。2.2.2 把修正后的
+  README.md / README_EN.md 重新发布一次。
+- **安装示例的版本号对齐到 2.2.2**：npm 段与 GitHub 段的 pin，以及解释 @ / # 的
+  相邻文字，一起从 2.2.1 / v2.2.1 改到 2.2.2 / v2.2.2。
+
+### 没做
+
+- 代码、运行时行为、存储格式（DOMAIN_VERSION 仍为 1）一律不动，2.2.1 升到 2.2.2
+  不需要迁移数据。
+- 讲历史区间的陈述（「从 1.0.0 到 2.2.1 的存储格式相同」等）与 2.2.1 及更早的
+  更新日志原样保留，bump 时不做全量版本替换，避免误伤历史记录。
+
 ## [2.2.1] - 2026-11-10
 
 一轮增量 review（按 git diff 逐段读 23 个提交）报出两条，都修掉了。这是纯修复版本，

package/README.md

@@ -494,12 +494,12 @@ URL 内嵌凭据等 11 类模式。
 
 ## 安装
 
-### 从 GitHub 安装（推荐）
+### 从 npm 安装（推荐）
 
-本插件尚未发布到 npm，从仓库直接装：
+已发布到 npm，包名 `dsh-anima`，直接用包名装：
 
 ```
-dsh plugin add github:Melody-cx/dsh-anima#v2.2.1
+dsh plugin add dsh-anima@2.2.3
 ```
 
 或者手工改 profile 的 `package.json`：
@@ -507,13 +507,37 @@ dsh plugin add github:Melody-cx/dsh-anima#v2.2.1
 ```jsonc
 {
   "dependencies": {
-    "dsh-anima": "github:Melody-cx/dsh-anima#v2.2.1"
+    "dsh-anima": "2.2.3"
   },
   "dsh": { "profile": { "bundles": [ /* ... */ "dsh-anima" ] } }
 }
 ```
 
-`#v2.2.1` 是标签（也可以写 commit SHA，或整个省略以跟随 `main`）。**建议 pin 住一个版本**，
+`@2.2.3` 可以换成别的已发布版本，或整个省略以装最新版。**建议 pin 住一个版本**，
+否则上游发了新版，下次安装就会直接换掉。
+
+然后 `pnpm install`，**重启 DSH**。宿主侧改动一律需要重启才生效。
+
+### 从 GitHub 安装（跟进未发布改动）
+
+想装还没发到 npm 的版本、或直接跟进 `main`，就从仓库装：
+
+```
+dsh plugin add github:Melody-cx/dsh-anima#v2.2.3
+```
+
+或者手工改 profile 的 `package.json`：
+
+```jsonc
+{
+  "dependencies": {
+    "dsh-anima": "github:Melody-cx/dsh-anima#v2.2.3"
+  },
+  "dsh": { "profile": { "bundles": [ /* ... */ "dsh-anima" ] } }
+}
+```
+
+`#v2.2.3` 是标签（也可以写 commit SHA，或整个省略以跟随 `main`）。**建议 pin 住一个版本**，
 否则上游的任何改动都会在下次安装时直接进入你的 profile。git 源下载的是**整个仓库 tarball**
 （本仓库很小），首次安装可能比 npm 源慢一些，超时的话重试一次即可。
 

package/README_EN.md

@@ -471,12 +471,12 @@ The near-duplicate hint deliberately only hints and never merges: auto-merging w
 
 ## Installation
 
-### From GitHub (recommended)
+### From npm (recommended)
 
-The plugin is not published to npm yet; install it straight from the repository:
+Published to npm as `dsh-anima`. Install by package name:
 
 ```
-dsh plugin add github:Melody-cx/dsh-anima#v2.2.1
+dsh plugin add dsh-anima@2.2.3
 ```
 
 Or edit the profile's `package.json` by hand:
@@ -484,13 +484,37 @@ Or edit the profile's `package.json` by hand:
 ```jsonc
 {
   "dependencies": {
-    "dsh-anima": "github:Melody-cx/dsh-anima#v2.2.1"
+    "dsh-anima": "2.2.3"
   },
   "dsh": { "profile": { "bundles": [ /* ... */ "dsh-anima" ] } }
 }
 ```
 
-`#v2.2.1` is the tag (a commit SHA works too, or drop it entirely to follow `main`). **Pin a version** —
+`@2.2.3` can be any published version, or drop it entirely to install the latest. **Pin a version** —
+otherwise a new upstream release replaces it on the next install.
+
+Then `pnpm install` and **restart DSH**. Any host-side change requires a restart to take effect.
+
+### From GitHub (to follow unreleased changes)
+
+To install a version not yet on npm, or track `main` directly:
+
+```
+dsh plugin add github:Melody-cx/dsh-anima#v2.2.3
+```
+
+Or edit the profile's `package.json` by hand:
+
+```jsonc
+{
+  "dependencies": {
+    "dsh-anima": "github:Melody-cx/dsh-anima#v2.2.3"
+  },
+  "dsh": { "profile": { "bundles": [ /* ... */ "dsh-anima" ] } }
+}
+```
+
+`#v2.2.3` is the tag (a commit SHA works too, or drop it entirely to follow `main`). **Pin a version** —
 otherwise any upstream change lands in your profile on the next install. A git source downloads the
 **whole repository tarball** (this one is small), so the first install may be slower than an npm source;
 retry once if it times out.

package/client/index.mjs

@@ -46,7 +46,7 @@ window.__ModuleLoader__.load({
     const NS = 'anima'
     // 与 package.json 的 "version" 保持同一条口径：徽标上显示的版本和发布的版本
     // 必须是同一个数字，否则用户报 bug 时对不上号。
-    const VERSION = '2.2.1'
+    const VERSION = '2.2.3'
     const REQUEST_TIMEOUT_MS = 15000
 
     // ── 设置页分区 ──────────────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-anima",
-  "version": "2.2.1",
+  "version": "2.2.3",
   "description": "DSH 助手人格与外挂记忆层：AI 自身的名字与角色、按工作区两级覆盖、带待审缓冲区的长期记忆",
   "icon": "./assets/icon.svg",
   "type": "module",
@@ -11,7 +11,8 @@
     "smoke": "node scripts/smoke-host.mjs && node scripts/smoke-client.mjs",
     "acceptance": "node scripts/acceptance.mjs",
     "review": "node scripts/review.mjs",
-    "check": "node scripts/verify-core.mjs && node scripts/smoke-host.mjs && node scripts/smoke-client.mjs && node scripts/check-client-i18n.mjs"
+    "check": "node scripts/verify-core.mjs && node scripts/smoke-host.mjs && node scripts/smoke-client.mjs && node scripts/check-client-i18n.mjs",
+    "prepublishOnly": "npm run verify"
   },
   "keywords": [
     "dsh",