dsh-goal-ledger 0.2.1 → 0.2.2

package/README.md

@@ -38,19 +38,24 @@ embedding 距离衡量的是「目标与输出的字面语义分离度」，有
 
 ### 从插件市场装（推荐）
 
-DSH 的插件市场读取你**自己配置的索引地址**，本仓库同时托管了一份索引（`market-index.json`）。在 设置 → 插件 → 发现（Discover）里添加这个地址：
+DSH 的插件市场读取你**自己配置的索引地址**。本插件已发布到 npm，索引随包提供，在 设置 → 插件 → 发现（Discover）里添加：
 
 ```
-https://raw.githubusercontent.com/zhegemingzimeibanquan/dsh-goal-ledger/master/market-index.json
+https://unpkg.com/dsh-goal-ledger@0.2.2/market-index.json
 ```
 
 然后在市场里搜索「目标台账」或 `dsh-goal-ledger` 安装即可。
 
+**为什么用 unpkg 而不是 GitHub raw**：实测这台机器访问 `raw.githubusercontent.com` 会被连接重置（curl 与 node 均 `ECONNRESET`，3/3 失败），而 `unpkg.com` 稳定 200。索引地址是用户手动填的，必须给一个真的能打开的。
+
 ### 命令行装
 
 ```bash
-# 从市场索引的同一份源码安装（固定 commit，无需 npm 账号）
-dsh plugin --profile desktop add git+https://github.com/zhegemingzimeibanquan/dsh-goal-ledger.git#6afaf8038d0d4b84b1b92eb4f16a5cc103b55bfe
+# 从 npm 装（推荐，48 KB，秒级）
+dsh plugin --profile desktop add dsh-goal-ledger
+
+# 从 Git 装（固定 commit，不走 npm 缓存）
+dsh plugin --profile desktop add git+https://github.com/zhegemingzimeibanquan/dsh-goal-ledger.git#f7669338eae9e15acb3a263890cc88d79e8ef0f1
 
 # 或者从本地目录装（开发用）
 dsh plugin --profile desktop add file:C:/Project/dsh-goal-ledger
@@ -202,6 +207,7 @@ test/full.mjs         全链路：解析 → 聚类 → 真实 embedding 调用
 npm install                  # 装 devDependencies（react / react-dom / jsdom）
 npm run test:render          # 渲染回归测试，离线，不需要 DSH 运行
 npm run test:correction      # 纠正逻辑 + 动态配置路由，离线
+npm run test:manifest        # 用 DSH 自己的校验器验证 manifest 与 market-index
 npm test                     # 冒烟测试，直接跑真实会话
 npm run test:full            # 全链路（会真实调用 embedding API）
 npm run check                # 全部文件语法检查
@@ -216,6 +222,47 @@ npm install --no-save @napi-rs/canvas
 npm run test:render-field    # 读真实 snapshot.json，输出 drift-field.png
 ```
 
+### 发布新版本
+
+### 发布新版本
+
+顺序很重要：**先提交、再打 tag、最后发布**。反过来的话，npm 上的内容和 tag 指向的代码会对不上，而这件事没有任何工具会报错——`test/published-matches-tag.mjs` 就是为它写的。
+
+`market-index.json` 随包发布，所以索引里记的版本号与 manifest 的版本号必须是同一个事实的两次记录。
+
+```bash
+# 1. 同步升版本（package.json 与 market-index.json 一起改，避免只改一处）
+node scripts/bump-version.cjs 0.2.3
+
+# 2. 更新 README 里的索引地址（用户要从这里复制）
+#    https://unpkg.com/dsh-goal-ledger@0.2.3/market-index.json
+
+# 3. 校验，并跑一遍全量测试
+npm run test:manifest
+npm test && npm run test:correction && npm run test:render
+
+# 4. 提交，打 tag（与 package.json 版本一致，带 v 前缀）
+git add -A && git commit -m "release: v0.2.3"
+git tag -a v0.2.3 -m "dsh-goal-ledger v0.2.3"
+git push origin master --follow-tags
+
+# 5. 发布，然后断言 npm 上的内容就是 tag 里的内容
+npm publish --registry=https://registry.npmjs.org --access public
+npm run test:published -- 0.2.3 v0.2.3
+
+# 6. 等 unpkg 同步后确认索引可读（正常 1-5 分钟）
+npm run test:published -- 0.2.3 v0.2.3   # 再跑一次即为复查
+curl -sS -o /dev/null -w "%{http_code}\n" https://unpkg.com/dsh-goal-ledger@0.2.3/market-index.json
+```
+
+`test:published` 会把 npm 上的 tarball 解开，逐文件与 tag 里的 git 内容比对，并核对 `version` / `engines` / `dsh` / `exports` / `files` 字段。**这是「npm 发布的就是这个 tag」的唯一硬证据**。
+
+**索引地址必须带精确版本号**：`unpkg.com/dsh-goal-ledger/market-index.json` 会 302 重定向到最新版，而 DSH 市场**拒绝重定向**（文档明确写「Redirects refused」），所以只能写 `@0.2.3` 这种精确地址。
+
+### 为什么不在 GitHub raw 上托管索引
+
+实测本机访问 `raw.githubusercontent.com` **全部被重置**（curl 与 node 都 `ECONNRESET`，3/3 失败），而同一时刻 `github.com`、`api.github.com`、`npmjs.org`、`unpkg.com` 都正常。索引地址是用户手动配置的，必须给一个真的打得开的——所以索引随 npm 包走 unpkg。
+
 ### 测试里两个 jsdom 坑（都真实踩过）
 
 1. **`react-dom` 必须在 jsdom 全局就位之后再 `require`**。它在模块初始化时就固化 `canUseDOM`；提前加载会让它判定「没有 DOM」，整套事件系统都不装，之后合成的 `input` 事件**永远到不了 `onChange`** —— 表现和「受控输入框坏了」一模一样，但插件代码其实是对的。

package/market-index.json

@@ -81,8 +81,8 @@
       },
       "versions": [
         {
-          "version": "0.2.1",
-          "publishTimestamp": 1793158503,
+          "version": "0.2.2",
+          "publishTimestamp": 1793169063,
           "source": {
             "type": "npm"
           },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-goal-ledger",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Goal-distance ledger and failure-cluster panel for DeepSeek Harness — audits your own sessions, shows where goals drifted and where tool calls actually failed.",
   "type": "module",
   "license": "MIT",
@@ -59,7 +59,8 @@
     "test:full": "node test/full.mjs",
     "test:render-field": "node test/render-field.mjs",
     "check": "node --check lib/index.js && node --check lib/client.js && node --check src/session-reader.js && node --check src/failure-cluster.js && node --check src/embed-config.js && node --check src/correction.js && node --check src/distance.js",
-    "test:manifest": "node test/manifest.mjs"
+    "test:manifest": "node test/manifest.mjs",
+    "test:published": "node test/published-matches-tag.mjs"
   },
   "devDependencies": {
     "jsdom": "^26.1.0",