@fanchao8609/agent_brain_sync 1.28.1 → 1.28.3

package/bin/abs.js

@@ -64,10 +64,17 @@ async function cmdUpdate({ yes }) {
   const cmp = cmpVersion(cur, latest);
   console.log(`当前: ${cur}`);
   console.log(`最新: ${latest}`);
+
   if (cmp === 0) {
-    console.log('已是最新，无需升级。');
+    // ★ 版本对不代表宿主模板对（2026-11-07 实报）。
+    //   现场：以前被双副本的旧代码刷过宿主，版本号已被 npm 推上去，但 ~/.pi/
+    //   里仍是旧模板 —— 此时报「已是最新」然后什么都不做，用户以为升级完了，
+    //   界面却永远不变。故照样刷新一遍（install 幂等，无副作用）。
+    console.log('已是最新，仍刷新一次宿主模板（幂等）。');
+    await refreshHosts(yes);
     return;
   }
+
   // 本地比 registry 新 —— 典型场景：开发中从源码装过全局，或在改一个未发布的版本。
   // 此时不能走 npm i -g @latest：那会把本地版**降级**覆盖掉（2026-10-06 实际发生：
   // 源码 1.16.2 被拉回 registry 的 1.16.1）。只比较 `===` 而没有方向判断，就是这个坑。
@@ -77,6 +84,7 @@ async function cmdUpdate({ yes }) {
     console.log('  想把它正式发布：      npm publish（在源码目录，发布后 update 即恢复正常）');
     return;
   }
+
   console.log(`\n升级 ${cur} → ${latest} …`);
   const r = await runCmd('npm', ['i', '-g', '@fanchao8609/agent_brain_sync@latest']);
   if (r === null) {
@@ -84,36 +92,48 @@ async function cmdUpdate({ yes }) {
     process.exit(1);
   }
   console.log(r);
-  // ★ 重装宿主必须交给**刚装好的那份新代码**去做，不能用本进程（2026-11-07 实报）。
-  //
-  // 病根：本进程是旧版 bin/abs.js，通过 import 加载的也是**旧版 src/install.js**。
-  //   旧 install.js 里的 stableBinPath() 用 process.execPath 推导全局包路径，
-  //   于是 hook 模板里的 @@ABS_BIN@@ 被烧成**旧副本**的路径，模板快照也是旧的。
-  //   结果：npm 已升到新版（npm ls -g 显示 1.28.0），但 ~/.pi/ 里写的还是旧模板，
-  //   界面一点没变，而且 hook 从此指向旧副本 —— 下一版继续错。
-  //   实测（fxh-mb）：/usr/bin/abs -> /usr/lib/...（1.26.0，PATH 优先）
-  //   与 /opt/node.../bin/abs -> /opt/...（1.28.0，npm 的 prefix，不在 PATH）。
-  //
-  // 修法：升级后用 `npm prefix -g` 算出新包的真实路径，把「刷新宿主」转交给
-  //   那个新包的 bin/abs.js 执行（子进程）。它算 stableBinPath 时会指向自己。
-  //   找不到新包才退回本进程的 runInstall（至少不比原来差）。
+  await refreshHosts(yes);
+}
+
+/**
+ * 把宿主 hook/skill/编辑器刷新一遍。
+ *
+ * ★ 必须交给**刚装好的那份新代码**去做，不能用本进程（2026-11-07 实报）。
+ *
+ * 病根：本进程是旧版 bin/abs.js，通过 import 加载的也是**旧版 src/install.js**。
+ *   旧 install.js 的 stableBinPath() 用 process.execPath 推导全局包路径，于是
+ *   hook 模板里的 @@ABS_BIN@@ 被烧成**旧副本**的路径，模板快照也是旧的。
+ *   结果：npm 已升到新版（npm ls -g 显示 1.28.0），但 ~/.pi/ 里写的还是旧模板，
+ *   界面一点没变，而且 hook 从此指向旧副本 —— 下一版继续错。
+ *   实测（fxh-mb）：/usr/bin/abs → /usr/lib/...（1.26.0，PATH 优先）
+ *   与 /opt/node.../bin/abs → /opt/...（1.28.0，npm 的 prefix，不在 PATH）。
+ *
+ * 修法：用 `npm prefix -g` 算出新包的真实路径，把刷新转交给那个新包的
+ *   bin/abs.js 执行（子进程）。它算 stableBinPath 时会指向自己。
+ *   找不到新包才退回本进程的 runInstall（至少不比原来差）。
+ */
+async function refreshHosts(yes) {
   const freshEntry = await freshInstallEntry();
   console.log('\n刷新四宿主 hook/skill（hook 脚本烧的是绝对路径 + 模板快照，升级后必须重装）…');
-  if (freshEntry) {
-    if (freshEntry !== resolveBinPath()) console.log(`  用新装的副本执行: ${freshEntry}`);
-    // --all：update 的语义是「把升好的版本铺到所有已装宿主」，不能二次弹窗重选。
-    //   旧代码调 runInstall({agent: undefined}) 在 TTY 下会弹菜单，回车只装 pi ——
-    //   另装过 omp / Claude Code 的机器升级后那几个宿主永远不刷新（2026-11-07 实报）。
-    const args = ['install', '--all'];
-    if (yes) args.push('--yes');
-    const code = await runInherit(process.execPath, [freshEntry, ...args]);
-    if (code !== 0) {
-      console.error(`\n✗ 刷新宿主失败（退出码 ${code}）。手动重跑：node ${freshEntry} install --all`);
-      process.exit(1);
-    }
-  } else {
+  if (!freshEntry) {
     console.log('  ⚠ 未定位到新安装的副本，用当前进程刷新（可能仍是旧模板）');
     await runInstall({ agent: undefined, mcp: true, skill: true, yes: yes !== false });
+    console.log('\n完成。重启宿主（pi / omp / opencode / claude-code / codex）后新 hook 生效。');
+    return;
+  }
+  if (freshEntry !== resolveBinPath()) console.log(`  用新装的副本执行: ${freshEntry}`);
+  // 宿主选择交给新副本的交互菜单：**默认勾 pi，其余多选**（2026-11-07 用户定）。
+  //   不传 --yes —— 传了等于「不问、只装 pi」，另装过 omp / Claude Code 的机器
+  //   那几个宿主升级后永远不刷新（实报）。
+  //   也不用 --all —— 那会往没在用的宿主配置里写条目，与「默认只装 pi、
+  //   其余 opt-in」的既定策略相反。
+  const args = ['install'];
+  // 已是非交互场景（update --yes、脚本、CI）时不模拟菜单，交给 pickAgents 走默认 pi。
+  if (yes) args.push('--yes');
+  const code = await runInherit(process.execPath, [freshEntry, ...args]);
+  if (code !== 0) {
+    console.error(`\n✗ 刷新宿主失败（退出码 ${code}）。手动重跑：node ${freshEntry} install`);
+    process.exit(1);
   }
   console.log('\n完成。重启宿主（pi / omp / opencode / claude-code / codex）后新 hook 生效。');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fanchao8609/agent_brain_sync",
-  "version": "1.28.1",
+  "version": "1.28.3",
   "description": "agent-brain-sync: 跨会话 AI 编码记忆 — hook 纯触发 + CLI/MCP 读写 .brain markdown 图谱, 防并发写保护。",
   "type": "module",
   "license": "MIT",

package/src/install.js

@@ -5,6 +5,7 @@
 //   - Codex:      ~/.codex/hooks.json。
 //   - OpenCode / Pi: 官方只吃 TS plugin/extension(无 shell-hook 配置) → 初版给出手工指引。
 // 纪律: 幂等(重复安装=更新)、原子写(tmp+rename)、卸载只删自己装的、写入前备份。
+import { execFileSync } from 'node:child_process';
 import { promises as fs } from 'node:fs';
 import * as fsSync from 'node:fs';
 import { homedir } from 'node:os';
@@ -475,6 +476,62 @@ export function staleBinWarning(binOverride) {
   ].join('\n');
 }
 
+/**
+ * 双副本检测：本机是否还装着**另一份**本包？
+ *
+ * ★ 为何需要（2026-11-07 实报）：远程机器有两份全局安装 ——
+ *   /usr/bin/abs → /usr/lib/node_modules/...（旧）
+ *   npm prefix → /opt/node.../lib/node_modules/...（新）
+ *   PATH 里 `/usr/bin` 在前，于是 `abs update` 跑的是旧副本；它用自己那份旧
+ *   install.js 刷宿主，把旧模板和旧 bin 路径写进 ~/.pi/，界面一点不变。
+ *
+ * 这里只做**检测与报告**，不自动改 PATH —— 改用户 shell 配置是越权动作。
+ * 正确修法在 bin/abs.js 的 cmdUpdate 里（把刷新动作转交给 npm prefix 下的新副本）；
+ * 本函数负责让「装完之后仍然指错」这件事在输出里可见，而不是静默。
+ *
+ * @returns {string|null} 有另一份时返回提示，否则 null。
+ */
+export function duplicateInstallWarning() {
+  let pkgName = '';
+  try {
+    pkgName = JSON.parse(fsSync.readFileSync(join(ABS_DIR, 'package.json'), 'utf8')).name || '';
+  } catch { return null; }
+  if (!pkgName) return null;
+
+  // ★ 只关心「两份都是全局安装」的情形。
+  //   从开发仓库直接跑 install（self 不在 node_modules 下）是正常的开发流程，
+  //   此时与全局那份版本不同是预期的 —— 那不是双副本故障，报出来只会是噪声
+  //   （2026-11-07 自测时先误报了一次）。
+  if (!/[\\/]node_modules[\\/]/.test(ABS_DIR)) return null;
+
+  let npmRoot;
+  try {
+    npmRoot = execFileSync('npm', ['prefix', '-g'], { encoding: 'utf8' }).trim();
+  } catch { return null; }
+  if (!npmRoot) return null;
+
+  // npm prefix 下的那份（「正确」的那份）与本进程所在那份（可能正是旧副本）
+  const correct = [join(npmRoot, 'lib', 'node_modules', pkgName), join(npmRoot, 'node_modules', pkgName)]
+    .find((x) => fsSync.existsSync(x));
+  if (!correct) return null;
+  const self = ABS_DIR;
+  try {
+    if (fsSync.realpathSync(correct) === fsSync.realpathSync(self)) return null;  // 同一份，正常
+  } catch { return null; }
+
+  let correctVer = '?', selfVer = '?';
+  try { correctVer = JSON.parse(fsSync.readFileSync(join(correct, 'package.json'), 'utf8')).version || '?'; } catch {}
+  try { selfVer = JSON.parse(fsSync.readFileSync(join(self, 'package.json'), 'utf8')).version || '?'; } catch {}
+
+  return [
+    '⚠ 本机存在两份 abs 全局安装，本次安装用的是：',
+    `     ${self}  (v${selfVer})`,
+    '  npm 装的那份在：',
+    `     ${correct}  (v${correctVer})`,
+    `  修法: 用新那份重跑 —— node ${join(correct, 'bin', 'abs.js')} install --all`,
+  ].join('\n');
+}
+
 function agentsSkillWarning() {
   const p = join(homedir(), '.agents', 'skills', 'abs-agent-brain-sync', 'SKILL.md');
   if (!fsSync.existsSync(p)) return null;
@@ -960,7 +1017,12 @@ const INSTALLERS = {
 };
 
 export function installSummary() {
-  return HOSTS.map((h) => `  ${h.key.padEnd(12)} ${h.label}`).join('\n');
+  // 标出默认项，否则用户看不出「回车 = 只装 pi」到底装哪个（2026-11-07 用户要求：
+  // 默认勾 pi，其余多选）。
+  return HOSTS.map((h) => {
+    const mark = h.key === DEFAULT_AGENT ? '  ← 默认（回车只装这个，要多个请用逗号列出）' : '';
+    return `  ${h.key.padEnd(12)} ${h.label}${mark}`;
+  }).join('\n');
 }
 
 export async function runInstall({ agent, all = false, mcp = true, skill = true, yes = false } = {}) {
@@ -1005,6 +1067,8 @@ export async function runInstall({ agent, all = false, mcp = true, skill = true,
   }
   const stale = staleBinWarning();
   if (stale) console.log('\n' + stale);
+  const dup = duplicateInstallWarning();
+  if (dup) console.log('\n' + dup);
 
   console.log('\n完成。项目内运行 abs init 建图谱; 会话里说 "abs load" 续接。');
 }