@kira905/dsh-memory-toolkit 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -3,6 +3,25 @@
 本仓的版本按**语义化版本**：改结论/改契约升主版本，加能力升次版本，修错别字与文档订正不升。
 英文摘要见每节末尾的 *English* 行。
 
+## v0.1.2 — 2026-10-30
+
+**内部标识残留清剿**（无 API / 行为契约变化）：
+
+- 注释里残留的内部笔记路径、构建机设备标记一并清掉；`dsh-memory-local` 的 `lib/` 与 `src/` 两份适配层副本
+  改成一致（`memory-engine` 184 项与适配层收敛用例复跑同绿）。
+
+*English: residual internal note paths and build-machine device markers removed from comments; the lib/ and src/ adapter copies stay byte-identical; no behaviour change.*
+
+## v0.1.1 — 2026-10-30
+
+**部署面补齐 + 用语刷净**（无 API / 行为契约变化）：
+
+- `dsh-memory-local/` 部署侧支持 `.modules.yaml` profiles（主包 0.2.0-rc.x 的文件布局），新增「全新安装」分支，备份目录改为按需创建。
+- 内部用语刷净：构建机的设备标记改为中性写法（`【设备：ROG】`），文档标签示例由设备名改为通用词（`工作记录`）；对应单测断言同步更新，`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).*
+
 ## v0.1.0 — 2026-10-19（首发）
 
 **首发范围**（从自用工作流中拆出的记忆面四件，源码级只读复制 + 脱敏 + 补齐仓骨架）：

package/dsh-memory-local/deploy.mjs

@@ -137,8 +137,13 @@ console.log(`source   : ${here}`)
 console.log(`target   : ${target}${isProduction ? '  ⚠ PRODUCTION HOME' : '  [non-default home]'}`)
 console.log(`entity   : ${entityExists ? (alreadyFork ? `already fork (sha ${entitySha.slice(0, 16)}…)` : entityPkg?.fork ? 'fork, but different sha' : `upstream ${entityPkg?.name}@${entityPkg?.version}`) : 'absent'}`)
 console.log(`lib sha  : ${srcSha}`)
-if (!fs.existsSync(packageMapFile)) {
-  console.error(`[deploy] 找不到 ${packageMapFile} —— 这不是一个可加载的 DSH profile`)
+// gate0b：profile 可加载性 —— 0.1.x 世代用 node_modules/.package-map.json，
+// 0.2.0-rc.x 起该文件已废弃（2026-10-28 实测：已装 @deepseek-ai 包 6,273 个 .js
+// 里 `package-map` / `packageMap` / `modules.yaml` 零引用），现世代以 pnpm 的
+// node_modules/.modules.yaml 为准 ⇒ 二者任一存在即视为可加载。
+const modulesYamlFile = path.join(profile, 'node_modules', '.modules.yaml')
+if (!fs.existsSync(packageMapFile) && !fs.existsSync(modulesYamlFile)) {
+  console.error(`[deploy] 找不到 ${packageMapFile} 或 ${modulesYamlFile} —— 这不是一个可加载的 DSH profile`)
   process.exit(EXIT.USAGE)
 }
 
@@ -170,6 +175,12 @@ if (isUpstream) {
   const existing = findMatchingSnapshot(target)
   if (existing) { backupDir = existing; reusedSnapshot = true }
   else backupDir = path.join(archiveRoot, `g24-s2a-memory-deploy-${stamp()}`)
+} else if (!entityExists) {
+  // 目标 profile 里**根本没有** dsh-memory 实体 = 全新安装（2026-10-28 为小汐生活实例
+  // `--profile life` 补的分支）：没有「上游原物」可归档，restore.mjs 也用不到还原源
+  // ⇒ 只建一个记录目录，DEPLOY-INFO 落这里。
+  backupDir = path.join(archiveRoot, `g24-s2a-memory-deploy-${stamp()}`)
+  console.log('[deploy] 目标 profile 无 dsh-memory 实体 = 全新安装，无需归档上游原物')
 } else {
   // 已在 fork 态：沿用最近一个「含上游原物」的备份目录（restore 的唯一还原源）
   const candidates = fs.existsSync(archiveRoot)
@@ -288,6 +299,7 @@ const info = {
   rollback: `node ${path.join(here, 'restore.mjs')} --target ${home}${isProduction ? ' --allow-production' : ''}`,
 }
 const infoFile = path.join(backupDir, `DEPLOY-INFO-${stamp()}.json`)
+fs.mkdirSync(backupDir, { recursive: true })
 fs.writeFileSync(infoFile, `${JSON.stringify(info, null, 2)}\n`, 'utf8')
 console.log(`\n[deploy] complete — 记录：${infoFile}`)
 console.log('[deploy] 未重启任何 DSH（本脚本不做重启）。隔离实例请用测试环境冒烟脚本启动：')

package/dsh-memory-local/lib/host-adapter.js

@@ -50,7 +50,7 @@
 //   唯一源 = 本文件；派生副本 = `tools/sync-host-adapter.mjs` 幂等生成到各包 `lib/host-adapter.mjs`（含源 sha 头）；
 //   守门 = `tools/check-decoupling.mjs` R5 校验副本 sha == 唯一源。
 //
-// 【设备：工作ROG】｜P0 落地 2026-09-14 ｜ P2-提前批 2026-09-15 ｜ +`SVC.clientModules`（生态面板 boot 解析修复）2026-09-23
+// P0 落地 2026-09-14 ｜ P2-提前批 2026-09-15 ｜ +`SVC.clientModules`（生态面板 boot 解析修复）2026-09-23
 // ｜ 2026-09-28 档 B 切（`UNKNOWN_FAMILY_POLICY`: 'unknown' → 'open'，主人单独批准）
 // ｜ 2026-10-10 空会话误判治本（`classifyTail` 加「整段零回合内事件 ⇒ closed」前置判定；
 //    修「新建空会话静止 10 分钟被判卡死」；真源 `docs\交付报告-卡死自愈空会话误判治本-20261010.md`）
@@ -105,7 +105,7 @@ export const EV = Object.freeze({
   FS_OBSERVED: 'fs/observed',
   TOOLS_PRE_EXECUTE: 'tools/pre-execute',
   // —— P2：0.1.5 新增事件族（取证口径 = 两线 `lib/types/known-event-types.js` 逐行 diff，
-  //    见 docs\长期库大扫除-20260914\adapter-认知缺口取证-20260915.md）。
+  //    依据见项目内部取证笔记）。
   //    ⚠️ **只登记常量，不进任何判定表**：这些名字属"新线上可能出现的事件"，
   //    是否需要据此改判定属档 B（换尺子），本批不做。
   DELIVERABLES_PRESENTED: 'deliverables/presented',
@@ -900,7 +900,7 @@ const CAPABILITY_LINES = Object.freeze({
  * P2 能力档扩展面（**只登记"这条线上有什么"的事实**：承载体 / 失效症状 / 降级出口）。
  * ⚠️ 本表**不含策略** —— 不写"该怎么办"，只写"是什么、会怎样坏、哪个出口可用"；
  *     `fallback` 给的是**出口名**（调用方自行决定用不用），不是自动行为。
- * 取证来源：`docs\长期库大扫除-20260914\adapter-认知缺口取证-20260915.md` +
+ * 取证来源：项目内部取证笔记 +
  *   本批 2026-09-15 两线主包闭包实读（服务名扫描 / settings 导出面 / known-event-types diff）。
  */
 const CAPABILITY_DETAIL = Object.freeze({

package/dsh-memory-local/src/host-adapter.js

@@ -50,7 +50,7 @@
 //   唯一源 = 本文件；派生副本 = `tools/sync-host-adapter.mjs` 幂等生成到各包 `lib/host-adapter.mjs`（含源 sha 头）；
 //   守门 = `tools/check-decoupling.mjs` R5 校验副本 sha == 唯一源。
 //
-// 【设备：工作ROG】｜P0 落地 2026-09-14 ｜ P2-提前批 2026-09-15 ｜ +`SVC.clientModules`（生态面板 boot 解析修复）2026-09-23
+// P0 落地 2026-09-14 ｜ P2-提前批 2026-09-15 ｜ +`SVC.clientModules`（生态面板 boot 解析修复）2026-09-23
 // ｜ 2026-09-28 档 B 切（`UNKNOWN_FAMILY_POLICY`: 'unknown' → 'open'，主人单独批准）
 // ｜ 2026-10-10 空会话误判治本（`classifyTail` 加「整段零回合内事件 ⇒ closed」前置判定；
 //    修「新建空会话静止 10 分钟被判卡死」；真源 `docs\交付报告-卡死自愈空会话误判治本-20261010.md`）
@@ -105,7 +105,7 @@ export const EV = Object.freeze({
   FS_OBSERVED: 'fs/observed',
   TOOLS_PRE_EXECUTE: 'tools/pre-execute',
   // —— P2：0.1.5 新增事件族（取证口径 = 两线 `lib/types/known-event-types.js` 逐行 diff，
-  //    见 docs\长期库大扫除-20260914\adapter-认知缺口取证-20260915.md）。
+  //    依据见项目内部取证笔记）。
   //    ⚠️ **只登记常量，不进任何判定表**：这些名字属"新线上可能出现的事件"，
   //    是否需要据此改判定属档 B（换尺子），本批不做。
   DELIVERABLES_PRESENTED: 'deliverables/presented',
@@ -900,7 +900,7 @@ const CAPABILITY_LINES = Object.freeze({
  * P2 能力档扩展面（**只登记"这条线上有什么"的事实**：承载体 / 失效症状 / 降级出口）。
  * ⚠️ 本表**不含策略** —— 不写"该怎么办"，只写"是什么、会怎样坏、哪个出口可用"；
  *     `fallback` 给的是**出口名**（调用方自行决定用不用），不是自动行为。
- * 取证来源：`docs\长期库大扫除-20260914\adapter-认知缺口取证-20260915.md` +
+ * 取证来源：项目内部取证笔记 +
  *   本批 2026-09-15 两线主包闭包实读（服务名扫描 / settings 导出面 / known-event-types diff）。
  */
 const CAPABILITY_DETAIL = Object.freeze({

package/memory-db-tools/audit-analyze.mjs

@@ -298,7 +298,7 @@ export function selfTest() {
   const inFile = path.join(tmp, "memories.json");
   const outDir = path.join(tmp, "out");
   try {
-    const base = "【设备：工作ROG】重复内容判定用长文本片段甲乙丙丁戊己庚辛壬癸子丑寅卯辰巳午未申酉戌亥";
+    const base = "【设备：ROG】重复内容判定用长文本片段甲乙丙丁戊己庚辛壬癸子丑寅卯辰巳午未申酉戌亥";
     const DRV = path.parse(process.cwd()).root;
     const mems = [
       { id: 1, text: base, pinned: true, tags: "", created_at: 1, updated_at: 1 },

package/memory-db-tools/audit-struct-probe.mjs

@@ -166,11 +166,11 @@ export function selfTest() {
   try {
     const mems = [
       { id: 1, text: "普通条目", pinned: false, tags: "", created_at: 1, updated_at: 1 },
-      { id: 2, text: "【设备：工作ROG】正常条目", pinned: true, tags: "", created_at: 1, updated_at: 1 },
+      { id: 2, text: "【设备：ROG】正常条目", pinned: true, tags: "", created_at: 1, updated_at: 1 },
       { id: 3, text: "【设备：某个奇怪的东西】异常设备标", pinned: false, tags: "", created_at: 1, updated_at: 1 },
       {
         id: 4,
-        text: "【设备：工作ROG】\n【设备：TUF】双标条目" + "x".repeat(300),
+        text: "【设备：ROG】\n【设备：TUF】双标条目" + "x".repeat(300),
         pinned: false,
         tags: "",
         created_at: 1,

package/memory-db-tools/refine-memories.mjs

@@ -3,7 +3,7 @@
  * refine-memories.mjs —— 记忆库「按 payload 逐条改写」通用写入入口（先 dry-run，--apply 才写）
  *
  * 与既有一次性大扫除脚本的关系：
- *   · 后者是 **2026-09-15 长期库大扫除 L4 那次的一次性脚本** —— 它的 `validate()` 内置
+ *   · 后者是 **2026-09-15 那次一次性梳理脚本** —— 它的 `validate()` 内置
  *     `IDS_EXPECTED = [17 个固定 id]` 覆盖度自检（"载荷必须恰好是那 17 条"）⇒ **新 payload 必被 fail-closed 拒**，
  *     不可复用（2026-09-24 实测：新载荷报「载荷缺条目 / 含计划外条目」）。
  *   · 本脚本 = 同一套安全骨架（单事务 / 逐条校验 / 改前全文留档 / 可回滚），**去掉硬编码 id 清单**，

package/memory-engine/lib/domain-tags.mjs

@@ -81,7 +81,7 @@ export function tokensOf(tags) {
   return String(tags ?? '').split(/\s+/).map((t) => t.trim()).filter(Boolean);
 }
 
-/** 该条 already 有哪些域标签（token 级精确比较，**不用 includes**：`工作rog` 不等于 `工作`）。 */
+/** 该条 already 有哪些域标签（token 级精确比较，**不用 includes**：`工作记录` 不等于 `工作`）。 */
 export function domainTokensIn(tags) {
   const set = new Set(tokensOf(tags));
   return DOMAIN_TOKENS.filter((t) => set.has(t));

package/memory-engine/test/07-domain-tags.test.mjs

@@ -42,17 +42,17 @@ test('appendDomainTags：追加不覆盖原标签', () => {
   assertEq(r.added, ['技术', 'dsh生态'], 'added 记录实际新增');
 });
 test('appendDomainTags：同输入跑两次 ⇒ 第二次零新增（写前逐标签判重）', () => {
-  const once = D.appendDomainTags('项目 工作rog', ['工作']);
+  const once = D.appendDomainTags('项目 工作记录', ['工作']);
   const twice = D.appendDomainTags(once.tags, ['工作']);
-  assertEq(once.tags, '项目 工作rog 工作', '第一次追加');
+  assertEq(once.tags, '项目 工作记录 工作', '第一次追加');
   assertEq(twice.added, [], '第二次零新增');
   assertEq(twice.tags, once.tags, '第二次不改内容');
   const tokens = D.tokensOf(twice.tags);
   assertEq(tokens.length, new Set(tokens).size, '无重复 token');
 });
-test('appendDomainTags：**token 级**判重（`工作rog` ≠ `工作`）', () => {
-  const r = D.appendDomainTags('工作rog', ['工作']);
-  assertEq(r.added, ['工作'], '`工作rog` 不算已含 `工作`');
+test('appendDomainTags：**token 级**判重（`工作记录` ≠ `工作`）', () => {
+  const r = D.appendDomainTags('工作记录', ['工作']);
+  assertEq(r.added, ['工作'], '`工作记录` 不算已含 `工作`');
   assert(r.tags.split(/\s+/).includes('工作'), '新 token 独立存在');
 });
 test('appendDomainTags：集合外的标签被丢弃（模型自创词不落库）', () => {
@@ -66,7 +66,7 @@ test('appendDomainTags：标签集为空 ⇒ 一个字都不动', () => {
   assertEq(r.added, [], '零新增');
 });
 test('domainTokensIn：只认域标签 token', () => {
-  assertEq(D.domainTokensIn('技术 dsh生态 工作rog'), ['技术', 'dsh生态'], 'token 级识别');
+  assertEq(D.domainTokensIn('技术 dsh生态 工作记录'), ['技术', 'dsh生态'], 'token 级识别');
   assertEq(D.domainTokensIn(''), [], '空 tags');
 });
 test('tagSetHash：与顺序无关、与重复无关、不同集不同哈希', () => {

package/memory-engine/test/08-distill.test.mjs

@@ -124,7 +124,7 @@ test('distilledTagOf / srcKeyInTags：标签形态可往返解析', () => {
   assert(tags.includes('srcids=3,9'), '带源 id 清单（升序）');
   assert(/\sdate=\d{8}$/.test(tags), '带日期');
   assertEq(D.srcKeyInTags(tags), 'd0123456789abcdef', '能解析回来');
-  assertEq(D.srcKeyInTags('技术 工作rog'), null, '普通标签解析为 null');
+  assertEq(D.srcKeyInTags('技术 工作记录'), null, '普通标签解析为 null');
 });
 
 // ── 02 输入挑选：窗口 ∪ 台账 + 不自我指涉 + D2 从严 ─────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kira905/dsh-memory-toolkit",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "private": false,
   "publishConfig": {
     "access": "public"