@kira905/dsh-memory-toolkit 0.1.2 → 0.1.3

package/CHANGELOG.md

@@ -3,6 +3,43 @@
 本仓的版本按**语义化版本**：改结论/改契约升主版本，加能力升次版本，修错别字与文档订正不升。
 英文摘要见每节末尾的 *English* 行。
 
+## v0.1.3 — 2026-10-30
+
+**主包补 bundle 声明 + 子路径导出面**（修「装完不生效」；无插件行为变化）：
+
+根因是**声明层错位**：`dsh-memory-local/` 的 bundle 声明写在私有子包自己的 `package.json` 里，主包没有 `dsh.bundle`
+⇒ `dsh plugin add` 只打一行 `declares no dsh.bundle` 警告、profile 的 `dsh.profile.bundles` 不变，**装了等于没装**
+（rc 仍是 0，所以用户会当成装好了）。本版把声明提到主包根，并给出宿主 loader（ESM `import()`）能解析的子路径。
+
+- 新增仓根 `cordis.patch.yml`：`id: kira905-memory`（**不是** `memory` —— 那个 id 归官方 `dsh-memory`，撞 id 会静默顶掉或启动抛错）、
+  `name: '@kira905/dsh-memory-toolkit/dsh-memory-local'`；`config` 与子包那份逐键相同（含 `path`）。
+- 主包 `package.json` 新增 `dsh.bundle.patch = ./cordis.patch.yml`。
+- 主包 `package.json` 新增 `exports`：`./dsh-memory-local` → `./dsh-memory-local/lib/index.js`（**文件**，不是目录）、
+  `./package.json` → `./package.json`；**没有** `"."` 条目（主包 `lib/` 没有 `index.js`，包根导入本来就不通）。
+- `files` 补上 `cordis.patch.yml`（否则 tarball 里没有它，装了照样不生效）。
+
+**迁移四条（"收窄包面"变更 —— 只升 patch 号，但请读一遍）**：
+
+1. **从包根导入的写法会失败**（`import '@kira905/dsh-memory-toolkit'`）—— 旧版本来也不通（没有 `main` / `exports`），
+   本版给它一个**明确的** `ERR_PACKAGE_PATH_NOT_EXPORTED`，而不是 "Cannot find package …/index.js" 这种像"文件丢了"的报错。
+   没有可迁移的既有用法。
+2. **子路径导入改走 `exports`**：`@kira905/dsh-memory-toolkit/dsh-memory-local` 从 0.1.2 的
+   `ERR_UNSUPPORTED_DIR_IMPORT`（ESM 不认目录）变成**可用**；反过来，深路径
+   `@kira905/dsh-memory-toolkit/dsh-memory-local/lib/index.js` 从 0.1.2 的"可达"变成 **`ERR_PACKAGE_PATH_NOT_EXPORTED`**。
+   踩到的把 specifier 换成映射后的 `…/dsh-memory-local`（**不要**反过来删 `exports` 图省事 —— 那会把 ESM 这条路重新掐死）。
+3. **与官方 `dsh-memory` 二选一**：本包定位是**替代实现**（`dsh-memory-local` 是 `dsh-memory@0.1.0` 的 fork），两者抢同一个
+   "记忆"位置。装之前读 `<profile>/package.json` 的 `dsh.profile.bundles`，含 `dsh-memory` 就**别装**（反之亦然）；
+   要换实现先把另一个摘掉，别让两份同时加载。
+4. **旧版仍在 npm、可回退**：`0.1.2` 及以前都在，`npm i @kira905/dsh-memory-toolkit@0.1.2` 可回退；回退后深路径恢复可达，
+   同时"不挂载"的老行为也回来（不坏，但等于白装）。
+
+*English: 0.1.3 declares the bundle at the package root (new `cordis.patch.yml`, `id: kira905-memory`) and adds an
+`exports` map that points the `./dsh-memory-local` subpath at a real file, so `dsh plugin add` mounts the fork instead
+of printing "declares no dsh.bundle". No plugin behaviour changed. This narrows the package surface: the deep
+`…/dsh-memory-local/lib/index.js` path is no longer importable (use the mapped subpath), the package root still has no
+entry point (now with an explicit `ERR_PACKAGE_PATH_NOT_EXPORTED`), and this package replaces — never coexists with —
+the official `dsh-memory`. 0.1.2 stays on npm for rollback.*
+
 ## v0.1.2 — 2026-10-30
 
 **内部标识残留清剿**（无 API / 行为契约变化）：
@@ -17,7 +54,7 @@
 **部署面补齐 + 用语刷净**（无 API / 行为契约变化）：
 
 - `dsh-memory-local/` 部署侧支持 `.modules.yaml` profiles（主包 0.2.0-rc.x 的文件布局），新增「全新安装」分支，备份目录改为按需创建。
-- 内部用语刷净：构建机的设备标记改为中性写法（`【设备：ROG】`），文档标签示例由设备名改为通用词（`工作记录`）；对应单测断言同步更新，`memory-engine` 184 项全绿。
+- 内部用语刷净：构建机的设备标记改为中性写法（原来的构建机设备标记），文档标签示例由设备名改为通用词（`工作记录`）；对应单测断言同步更新，`memory-engine` 184 项全绿。
 - 本版起 `npm publish` 走 `next` 标签、稳定后再挂 `latest`。
 
 *English: deploy side now supports `.modules.yaml` profiles (host 0.2.0-rc.x) with a fresh-install branch and lazy backup-dir creation; internal build-machine wording scrubbed (no API/behaviour change).*

package/README.md

@@ -1,5 +1,33 @@
 # dsh-memory-toolkit
 
+> **本仓装完即用**（0.1.3 起）：`dsh plugin --profile <profile> add @kira905/dsh-memory-toolkit` 一条命令，`dsh.bundle` 会让它自动挂进 profile 的组合列表，**不需要再手工写 `cordis.patch.yml`**。包内 3 个 CLI（`dsh-memory-audit` / `dsh-memory-summary` / `dsh-memory-export`）与挂载无关，`npm i -g` 或 `npx` 直接用。
+
+## 装完自检（三条只读验法）
+
+`<profile>` 换成你实际用的 profile（默认 `web`），`<数据根>` 换成你的 DSH 数据根（默认 `~/.dsh`）。
+
+```powershell
+# ① 组合树里有没有它（只读、约 0.6 秒、不启服务）
+dsh --profile <profile> --dump-config | Select-String "dsh-memory-toolkit"
+# 期望：bundle 层出现一行 "# == <登记名>"、insert 层出现 "- id: <entry>"（问的都是「它挂上没」）；
+#       本仓包名 @kira905/dsh-memory-toolkit —— 带 scope 装的写带 scope 名、老工装 / 手写的可能是裸名，两种都搜一遍
+#       ⚠️ 若该包会 insert 一行，还要数一遍"同一个 id 出现了几次"，必须 == 1
+
+# ② 组合列表里有没有它（只读）
+Get-Content <数据根>/profiles/<profile>/package.json | Select-String "@kira905/dsh-memory-toolkit"
+# 期望：dependencies 与 dsh.profile.bundles 两处都有（CLI 类只需要 dependencies；bundles 里也可能写裸名 dsh-memory-toolkit）
+
+# ③ 命令在不在 —— 【只查存在，不执行】
+Test-Path <数据根>/profiles/<profile>/node_modules/.bin/dsh-memory-summary.CMD   # 装进 profile 的
+Test-Path "$env:APPDATA\npm\dsh-memory-summary.CMD"                           # npm i -g 装的
+# 期望：True。两条路径按你实际用的装法挑一条
+```
+
+> 探针只做存在性检查（只看命令文件在不在，不执行任何命令）。
+> 要不要用 `--help` 验，见本仓当前说明与该命令的参数表。
+
+---
+
 **DSH（DeepSeek Harness）生态的记忆面工具集** —— 一个独立向量记忆引擎、一套记忆库只读体检工具链、
 一个自持 fork 的本地记忆插件，以及一个 persona ↔ 记忆体检小工具。
 

package/cordis.patch.yml

@@ -0,0 +1,32 @@
+# Package-root bundle patch for @kira905/dsh-memory-toolkit.
+#
+# Why this file exists at the package root (0.1.3): the fork's own patch lives
+# inside the private sub-package `dsh-memory-local/`, so `dsh plugin add`
+# reported "declares no dsh.bundle" and mounted nothing. The declaration now
+# sits next to `dsh.bundle.patch` in the root package.json.
+#
+# `id` is deliberately NOT `memory`: that id belongs to the official
+# `dsh-memory` bundle. Two entries carrying the same id either override each
+# other silently (loader 1.0.x) or abort boot (older loaders), and
+# `--dump-config` prints both rows with rc=0 either way. One memory slot, one
+# implementation: install this package OR `dsh-memory`, never both.
+#
+# `config` is a deliberate full copy of `dsh-memory-local/cordis.patch.yml`
+# (a patch replaces the targeted row's whole config, so a row cannot inherit
+# keys from another file). `path` intentionally has no code-side default: a
+# durable store of user facts must not land in whatever directory the harness
+# happened to start in. The deployment value lives here, beside the row,
+# resolved through the loader's `dshHomePath` so every profile on this machine
+# shares one memory file.
+
+- insert:
+    - id: kira905-memory
+      name: '@kira905/dsh-memory-toolkit/dsh-memory-local'
+      config:
+        path: !!js dshHomePath('memory/memory.db')
+        promptRecentCount: 10
+        promptMaxChars: 2000
+        maxTextChars: 2000
+        searchLimitDefault: 10
+        searchLimitMax: 50
+        promptOrder: 50

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kira905/dsh-memory-toolkit",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -30,12 +30,22 @@
   "engines": {
     "node": ">=22"
   },
+  "exports": {
+    "./dsh-memory-local": "./dsh-memory-local/lib/index.js",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
   "bin": {
     "dsh-memory-audit": "./persona-memory-audit.mjs",
     "dsh-memory-summary": "./memory-db-tools/list-memory-summary.mjs",
     "dsh-memory-export": "./memory-db-tools/audit-export.mjs"
   },
   "files": [
+    "cordis.patch.yml",
     "memory-engine/",
     "memory-db-tools/",
     "dsh-memory-local/",