@mingmaple/dsh-handover 0.9.14 → 1.0.0

package/scripts/check-docs.mjs

@@ -22,6 +22,13 @@ const problems = [];
 const readmeLines = fs.readFileSync(readme, 'utf8').split(/\r?\n/).length;
 if (readmeLines > 200) problems.push('README 应不超过 200 行（当前 ' + readmeLines + ' 行）');
 
+// 1.1 README「为什么需要」一节为用户 2026-11-13 与 2026-11-15 两次指定的正文（例外 E-01）：逐字比对，改动即失败
+const WHY_PINNED = '单个会话的上下文越用越多，用到一定程度之后，出错的可能也会随之上升；可若这时压缩上下文，或者写好交接换一个会话，又会丢掉已经积累的信息。面对这样的两难，有没有更好的取舍？\n\n本插件一定能很好地帮助你。来试试吧；不满意，随时关闭插件并删除即可。';
+{
+  const m = fs.readFileSync(readme, 'utf8').match(/## 为什么需要\s*\n+([\s\S]*?)\n+## /);
+  const got = m ? m[1].trim() : '';
+  if (got !== WHY_PINNED) problems.push('README「为什么需要」一节为用户指定正文（E-01），不得改写');
+}
 // 2. 旧数与旧术语
 const FORBIDDEN = ['21 个工具', '27 个工具', '未分类', '追加系统提示词', '4,028', '4.6 KB', '每库 24 行', 'CHANGELOG'];
 // 审阅语境与内部用语：这些词只应出现在桌面审阅材料里，不能进对外文档与版本说明。

package/scripts/e2e-migration.mjs

@@ -15,7 +15,7 @@ const argIdx = process.argv.indexOf('--dist');
 const dist = argIdx !== -1 ? path.resolve(process.argv[argIdx + 1]) : path.join(repo, 'dist');
 
 const imp = (rel) => import(pathToFileURL(path.join(dist, rel)).href);
-const { pmPackTool } = await imp('tools/ho_pack.mjs');
+const { pmBackupTool } = await imp('tools/ho_backup.mjs');
 const { resolveConfig } = await imp('lib/config.mjs');
 
 const fails = [];
@@ -47,7 +47,7 @@ const env = {
   selfId: () => null,
   selfCwd: () => null,
 };
-const packTool = pmPackTool(env);
+const packTool = pmBackupTool(env);
 /** action 分流：pack／verify／restore 都走同一个工具（合并口径）。 */
 const run = (args) => packTool.execute(args, null);
 

package/scripts/office.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * 命令行查在任登记表：`node scripts/office.mjs 全局 全局3 Mingent`
+ * 命令行查在任登记表：`node scripts/office.mjs 全局 全局3 Demo1`
  *
  * 与工具 ho_office 同一份实现、同一份记录（_Control_Center/records/Office.json），
  * 区别只是不起会话也能查。工作区根按 --root → DSH_OFFICE_ROOT → 从 cwd 向上找 _Control_Center 的顺序解析。
@@ -32,14 +32,14 @@ for (let i = 0; i < argv.length; i++) {
   if (a === '--all' || a === '-a') { all = true; continue; }
   if (a === '-h' || a === '--help') {
     console.log('用法：node scripts/office.mjs [查询…] [--all] [--json] [--root <工作区根>]');
-    console.log('示例：node scripts/office.mjs 全局 全局3 Mingent');
+    console.log('示例：node scripts/office.mjs 全局 全局3 Demo1');
     process.exit(0);
   }
   queries.push(a);
 }
 if (!root) root = walkUp(process.cwd());
 if (!root) {
-  console.error('找不到工作区根（没有 _Control_Center）：用 --root 指定，例如 --root E:\\_Project_Mate\\_Workspace');
+  console.error('找不到工作区根（没有 _Control_Center）：用 --root 指定，例如 --root <全局根绝对路径>');
   process.exit(2);
 }
 

package/scripts/portability.mjs

@@ -0,0 +1,71 @@
+/**
+ * 跨平台可移植性测试（1.0）：
+ * 1. 路径等价键按平台折叠大小写：Windows 与 macOS 折叠，Linux 保留；
+ * 2. 7-Zip 探测覆盖 Windows、macOS、Linux 的常见位置与 PATH；
+ * 3. 工作区相对路径一律用 path.sep 组装，不写死分隔符；
+ * 4. 迁移助手不依赖 PowerShell 或 bash，链接类型按平台选择；
+ * 5. 路径比较不再无条件折叠大小写。
+ *
+ * 全程只读源码与构建产物，不碰真实工作区与真实 HOME。
+ * 用法：node scripts/portability.mjs [--dist <dist 目录>]
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const repo = path.resolve(here, '..');
+const dist = (() => {
+  const i = process.argv.indexOf('--dist');
+  return i !== -1 && process.argv[i + 1] ? path.resolve(process.argv[i + 1]) : path.join(repo, 'dist');
+})();
+
+const fails = [];
+function ok(cond, msg, extra) {
+  if (cond) console.log('  通过 ' + msg);
+  else { fails.push(msg + (extra ? ' → ' + extra : '')); console.log('  未通过 ' + msg + (extra ? ' → ' + extra : '')); }
+}
+function section(t) { console.log(''); console.log('== ' + t + ' =='); }
+const imp = (rel) => import(pathToFileURL(path.join(dist, rel)).href);
+const read = (rel) => fs.readFileSync(path.join(repo, rel), 'utf8');
+
+const { pathKey, samePath, relToAbs } = await imp('lib/pathkey.mjs');
+
+section('1 路径等价键');
+ok(pathKey('C:\\Data\\WS\\', 'win32') === 'c:/data/ws', 'Windows 折叠大小写并去分隔符', pathKey('C:\\Data\\WS\\', 'win32'));
+ok(pathKey('C:\\Data\\WS', 'darwin') === 'c:/data/ws', 'macOS 折叠大小写', pathKey('C:\\Data\\WS', 'darwin'));
+ok(pathKey('/data/WS', 'linux') === '/data/WS', 'Linux 保留大小写', pathKey('/data/WS', 'linux'));
+ok(samePath('C:\\A\\b', 'c:/a/B', 'win32') === true, 'Windows 两种写法视为同一路径');
+ok(samePath('/data/WS', '/data/ws', 'linux') === false, 'Linux 大小写不同视为不同路径');
+ok(relToAbs('/root', 'a/b') === path.join('/root', 'a', 'b'), '相对路径按平台分隔符组装');
+
+section('2 7-Zip 探测');
+const seven = read('src/lib/sevenzip.mjs');
+for (const p of ['/usr/bin/7z', '/usr/local/bin/7z', '/opt/homebrew/bin/7z', '/usr/bin/7za', '/opt/homebrew/bin/7zz', '7z.exe']) {
+  ok(seven.indexOf(p) !== -1, '候选含 ' + p);
+}
+ok(seven.indexOf('BARE') !== -1, 'PATH 上的 7z、7zz、7za 也探测');
+
+section('3 路径组装');
+ok(read('src/lib/scaffold.mjs').indexOf(".split('/').join(path.sep)") !== -1, '脚手架用 path.sep 组装相对路径');
+ok(read('src/lib/archive.mjs').indexOf(".split('/').join(path.sep)") !== -1, '归档恢复用 path.sep 组装相对路径');
+
+section('4 迁移与链接');
+const mover = read('src/lib/mover.mjs');
+ok(mover.indexOf("process.platform === 'win32' ? 'junction' : 'dir'") !== -1, '链接类型按平台选择');
+ok(mover.indexOf('不依赖 PowerShell') !== -1, '迁移助手不依赖外部 shell');
+ok(mover.indexOf("process.platform === 'win32' ? t.toLowerCase() : t") !== -1, '链接目标比较按平台折叠大小写');
+
+section('5 路径比较不再无条件折叠');
+const files = ['src/lib/mover.mjs', 'src/lib/api.mjs', 'src/lib/session-ops.mjs', 'src/lib/status.mjs', 'src/lib/scaffold.mjs', 'src/tools/ho_workspace.mjs'];
+const bad = files.filter((f) => read(f).indexOf(".replace(/\\/+$/, '').toLowerCase()") !== -1);
+ok(bad.length === 0, '以上文件不再写死「转斜杠 + 去尾 + 小写」', bad.join(', '));
+ok(read('src/lib/pathkey.mjs').indexOf('process.platform') !== -1, '大小写折叠集中在 pathkey.mjs');
+
+console.log('');
+if (fails.length) {
+  console.log('PORTABILITY FAIL ' + fails.length + ' 项：');
+  for (const f of fails) console.log('  - ' + f);
+  process.exit(1);
+}
+console.log('PORTABILITY OK（跨平台检查全过）');