fde2e-bu 1.2.0 → 1.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fde2e-bu",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "FDE2E Browser Use CLI —— skills 管理＋MCP server＋扩展配对（零运行时依赖）",
   "type": "module",
   "bin": {

package/src/cli.mjs

@@ -14,8 +14,9 @@ import { runServe } from './mcp/serve.mjs';
 import { runHttpServe, DEFAULT_HTTP_PORT } from './mcp/http.mjs';
 import { runNmHost } from './nm/host.mjs';
 import { cmdBindInstall, cmdBindStatus, cmdBindRemove, assertBindPlatform } from './nm/bind.mjs';
+import { cmdSelfUpdate, DEFAULT_FEED_URL } from './nm/update.mjs';
 import { resolveConfigDir } from './configdir.mjs';
-import { cmdStatus, cmdDoctor, cmdUpdate } from './misc.mjs';
+import { cmdStatus, cmdDoctor } from './misc.mjs';
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
@@ -35,7 +36,8 @@ const MAIN_HELP = `fde2e-bu —— FDE2E Browser Use 命令行（零运行时依
               serve（stdio JSON-RPC 2.0；--http＝仅回环 token 端点）| add | list | remove
   status    桥服务（omni /healthz）健康探测，离线降级提示；顶部显示已配对执行器
   doctor    自检：node 版本 / 配置路径 / 环境变量 / 扩展 zip / NM manifest / pairing
-  update    更新提示（尊重 npm，不自作下载器）
+  update    扩展自更新：发现 unpacked 安装 → feed 检查 → 下载校验原子替换
+              [--ext-dir <dir>] [--feed <url>] [--dry-run]
   bind      扩展↔CLI 一次性配对（Chrome Native Messaging）
               install | status | remove
 
@@ -112,6 +114,29 @@ flag 面按子命令收窄（C1）：不适用 flag 与多余位置参数一律
 （如 mcp list --profile-id x 不再被静默忽略）；--port/--token 仅 --http 模式可用。
 --home/--dir 显式重定向配置根与工作区根（测试用，不碰真实家目录）。`;
 
+const UPDATE_HELP = `fde2e-bu update —— 扩展自更新（unpacked 独立安装）
+
+用法：
+  fde2e-bu update [--ext-dir <dir>] [--feed <url>] [--dry-run]
+      发现本机 unpacked 安装（Chrome 系浏览器 Preferences/Secure Preferences 的
+      extensions.settings[meojillndgamkbfjijfehjaefolnfopn].path，多浏览器多
+      profile 全扫）→ fetch feed（缺省 ${DEFAULT_FEED_URL}）→ semver 只认 > →
+      下载（https 强制）→ sha256/字节数双校验 → staging 解压（zip-slip/条目数/
+      根 manifest/总量四重防护）→ rm+rename 原子替换（Windows 瞬态占用退避）。
+      多处安装全部应用；任一失败不回滚其它。受 FDE2E Omni 桌面版管理的安装
+      （~/fde2e/bu/ 内或目录旁 .browser-extension-state.json）自动跳过——随 App 更新。
+      --ext-dir <dir>    显式指定安装目录（复核 manifest.json 在场即可，免扫描）
+      --feed <url>       覆写 feed 地址（测试/私有部署；仍强制 https）
+      --dry-run          只报发现与目标版本，不写盘
+      0 命中 → exit 1＋指引（浏览器未开过本插件/装在非常规处时用 --ext-dir）。
+      CLI 本体的更新仍走 npm：npm i -g fde2e-bu@latest。
+
+环境变量（NM host 路径也生效）：
+  BU_UPDATE_BASE      下载基址/白名单重定向（测试假 feed server/私有部署；
+                      信任重定向到指定基址，不是放宽为任意域）
+
+设计：openspec/changes/bu-online-selfupdate（proposal/design C）。`;
+
 const BIND_HELP = `fde2e-bu bind —— 扩展↔CLI 一次性配对（Chrome Native Messaging）
 
 平台：支持 macOS 与 Linux（NM 清单按 Chrome 规范路径文件落盘）；Windows 需注册表
@@ -296,18 +321,42 @@ export async function main(argv) {
       return cmdDoctor({ home: values.home, dir: values.dir, json: values.json, configDir: values['config-dir'], manifestsDir: values['manifests-dir'] });
     }
     case 'update': {
-      // C1：update 除 help 外无 flag（--json 等一律 exit 2），多余位置参数同样拒绝
-      assertFlags(rest, ['help'], 'update', { help: MAIN_HELP });
+      // A3（bu-online-selfupdate）：--ext-dir/--feed/--dry-run；不适用 flag 与多余
+      // 位置参数一律 exit 2（cli-tooling 规格）；--feed 在参数面即强制 https。
+      assertFlags(rest, ['ext-dir', 'feed', 'dry-run', 'help'], 'update', { help: UPDATE_HELP });
       const { positionals, values } = parse(rest, {
-        options: { help: { type: 'boolean', short: 'h' } },
-        help: MAIN_HELP,
+        options: {
+          'ext-dir': { type: 'string' },
+          feed: { type: 'string' },
+          'dry-run': { type: 'boolean' },
+          help: { type: 'boolean', short: 'h' },
+        },
+        help: UPDATE_HELP,
       });
       if (values.help) {
-        console.log(MAIN_HELP);
+        console.log(UPDATE_HELP);
         return 0;
       }
-      assertNoPositionals(positionals, 'update', { help: MAIN_HELP });
-      return cmdUpdate();
+      assertNoPositionals(positionals, 'update', { help: UPDATE_HELP });
+      if (values['ext-dir'] !== undefined && values['ext-dir'] === '') {
+        throw new UsageError('--ext-dir 不能为空', { help: UPDATE_HELP });
+      }
+      if (values.feed !== undefined) {
+        let u;
+        try {
+          u = new URL(values.feed);
+        } catch {
+          throw new UsageError(`--feed url 无法解析：${values.feed}`, { help: UPDATE_HELP });
+        }
+        if (u.protocol !== 'https:') {
+          throw new UsageError(`--feed 必须 https（收到 ${u.protocol}//${u.host}）`, { help: UPDATE_HELP });
+        }
+      }
+      return cmdSelfUpdate({
+        ...(values['ext-dir'] !== undefined ? { extDir: values['ext-dir'] } : {}),
+        ...(values.feed !== undefined ? { feed: values.feed } : {}),
+        dryRun: Boolean(values['dry-run']),
+      });
     }
     case 'bind': {
       // A3：bind install/status/remove；--help/-h → BIND_HELP exit 0；裸 bind → 帮助 exit 2

package/src/misc.mjs

@@ -1,4 +1,5 @@
-// status / doctor / update（tasks 1.2 / 1.3 / 4.2；C2 P2-7；A5＝pairing 消费）。
+// status / doctor（tasks 1.2 / 1.3；C2 P2-7；A5＝pairing 消费）。
+// （update 组自 bu-online-selfupdate A3 起改走 src/nm/update.mjs 的 cmdSelfUpdate。）
 import { existsSync, readdirSync } from 'node:fs';
 import { join, dirname, resolve } from 'node:path';
 import { homedir } from 'node:os';
@@ -8,7 +9,6 @@ import { findSkillsWorkspace } from './skills/skills.mjs';
 import { resolveConfigDir } from './configdir.mjs';
 import { readPairing, defaultProfileId } from './nm/host.mjs';
 import { manifestTargets, readManifest, hostScriptExecutable } from './nm/bind.mjs';
-import pkg from '../package.json' with { type: 'json' }; // P1-3：update 文案版本真值单源
 
 // ---------- status（task 1.2 + C2）：/healthz 探活＋绑定配置面＋六落点注册清单 ----------
 
@@ -227,15 +227,3 @@ export async function cmdDoctor({ home, dir, json, fetchImpl, healthzTimeoutMs,
   }
   return counts.fail > 0 ? 1 : 0;
 }
-
-// ---------- update（task 4.2）：尊重 npm，不自作下载器 ----------
-
-/** P1-3：版本真值取 package.json（不再写死 0.1.0/「尚未发布」——发布与否是
- *  registry 侧事实，CLI 只如实报当前版本与更新命令，404 语义交给用户对照）。 */
-export function cmdUpdate() {
-  console.log(`当前 fde2e-bu@${pkg.version}；更新走 npm（不自作下载器）：`);
-  console.log('  npm i -g fde2e-bu@latest     # 全局安装形态');
-  console.log('  npx -y fde2e-bu@latest …     # 免装直跑（生产建议 pin 版本）');
-  console.log('若 npm registry 报 404（E404/PACKAGE_VERSION_NOT_FOUND），说明该版本尚未发布——属正常现象，等发布即可。');
-  return 0;
-}

package/src/nm/asset.mjs

@@ -0,0 +1,288 @@
+// NM 资产代取（change bu-chrome154-downloads B1，design §A）——SW 发起
+// `bu:asset-fetch`，host 按白名单校验后流式下载到生态资产目录
+// `~/fde2e/bu/assets/<safe-name>`，回绝对路径（CDP DOM.setFileInputFiles 消费）。
+// 背景：Chrome 154 上 chrome.downloads 对插件全量即断——配图上传链改走本通道，
+// 浏览器下载仅作保底回退（SW 侧 cdp.js downloadTo）。
+//
+// 契约（帧协议不变，host.mjs 写队列串行应答）：
+//   → {type:'bu:asset-fetch', url, name, maxBytes, allowHosts:[…]}
+//   ← {type:'bu:asset-fetch:ok', path, bytes, finalUrl, sha256}
+//   ← {type:'bu:asset-fetch:error', code, message}
+//     code ∈ bad-msg|bad-url|not-allowed|too-large|net|io
+//     （bad-msg/bad-url/not-allowed/too-large＝确定性拒绝——SW 侧不回退直接抛；
+//      net/io＝环境性失败——SW 无 CLI 时可回退 chrome.downloads）
+//
+// 安全边界（design §A「白名单双闸」的 host 侧）：
+//   - host **不自带**业务白名单（allowHosts 由 SW 从 constraints 传入），但强制
+//     协议与域校验——https-only（http 仅本机回环 dev）＋ allowHosts 成员匹配；
+//   - 重定向**逐跳**白名单（manual redirect 循环，任何一跳越权即断，最多 5 跳）；
+//   - maxBytes 双闸：content-length 预检 ＋ 流式累计（超限即断，不做无界落盘）；
+//   - 落盘 temp+rename 原子写；safe-name 同 cdp.js 规则（/ 与 \ 替换 _，另拒
+//     '.'/'..' 防目录逃逸）；写前清扫目录内 mtime>24h 文件（即取即用语义，防
+//     无界增长）。
+// 依赖全注入可测（home/fs/fetchImpl/now/sweepTtlMs）。
+import { createHash } from 'node:crypto';
+import * as realFs from 'node:fs';
+import { homedir } from 'node:os';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import { join } from 'node:path';
+
+/** 消息类型（SW cdp.js assetFetch 客户端的入口消息）。 */
+export const ASSET_FETCH_MSG_TYPE = 'bu:asset-fetch';
+/** 重定向逐跳上限（design §A：redirect 逐跳白名单，5 跳预算）。 */
+export const MAX_REDIRECT_HOPS = 5;
+/** 资产目录内文件清扫 TTL（24h——上传即取即用，裕量覆盖重试）。 */
+export const ASSET_SWEEP_TTL_MS = 24 * 60 * 60 * 1000;
+/** http 放行的本机回环 host（URL.hostname 口径——IPv6 带方括号）。 */
+export const ASSET_LOOPBACK_HOSTS = ['127.0.0.1', 'localhost', '[::1]'];
+/** 单次 maxBytes 声明上限（防畸形巨值把资产目录当无界落盘面；业务上限在 SW 侧）。 */
+export const MAX_BYTES_CEILING = 1024 * 1024 * 1024;
+/** name 长度上限（文件名级；safe 化后仍适用）。 */
+export const NAME_MAX = 255;
+/** allowHosts 条数上限（防滥用；constraints 两侧白名单均 ≤4 条）。 */
+export const ALLOW_HOSTS_MAX = 64;
+
+/** 资产代取错误（code ∈ bad-msg|bad-url|not-allowed|too-large|net|io）。 */
+export function assetError(code, message) {
+  const err = new Error(message ?? code);
+  err.name = 'AssetFetchError';
+  err.code = code;
+  return err;
+}
+
+/** 本模块错误码封闭集（区分 Node 内建 err.code 如 ENOENT/EPIPE——那些按 io 兜底）。 */
+const ASSET_ERROR_CODES = new Set(['bad-msg', 'bad-url', 'not-allowed', 'too-large', 'net', 'io']);
+
+function errorReply(code, message) {
+  return { type: 'bu:asset-fetch:error', code, message };
+}
+
+/**
+ * 单跳校验（纯函数，供测试与逐跳循环共用）：
+ *   1. 协议必须 http(s)（其它协议 ⇒ bad-url）；
+ *   2. http 仅本机回环（⇒ not-allowed）；
+ *   3. hostname 必须是 allowHosts 成员（⇒ not-allowed）。
+ * @param {URL} u
+ * @param {string[]} allowHosts
+ * @returns {{code:string, message:string}|null}
+ */
+export function checkAssetHop(u, allowHosts) {
+  if (u.protocol !== 'https:' && u.protocol !== 'http:') {
+    return { code: 'bad-url', message: `资产 url 协议必须 http(s)（收到 ${u.protocol}//${u.hostname}）` };
+  }
+  if (u.protocol === 'http:' && !ASSET_LOOPBACK_HOSTS.includes(u.hostname)) {
+    return { code: 'not-allowed', message: `http 资产仅允许本机（${ASSET_LOOPBACK_HOSTS.join('/')}），收到 http://${u.hostname}` };
+  }
+  if (!allowHosts.includes(u.hostname)) {
+    return { code: 'not-allowed', message: `资产域名不在 allowHosts（只允许 ${allowHosts.join('/')}，收到 ${u.hostname}）` };
+  }
+  return null;
+}
+
+/** safe 化文件名（与 cdp.js downloadTo 同规则：/ 与 \ 替换 _；'.'/'..' 拒绝）。 */
+export function safeAssetName(name) {
+  // 路径分隔符 + Windows 保留字符一并替换（对抗审查 P3.3——跨平台优雅降级为可写名）
+  const safe = String(name).replace(/[/\\:*?"<>|\x00-\x1f]/g, '_');
+  if (safe === '.' || safe === '..') {
+    throw assetError('bad-msg', `资产 name 非法（${JSON.stringify(name)}——safe 化后仍是目录引用）`);
+  }
+  return safe;
+}
+
+/**
+ * 资产目录清扫（best-effort）：删除 mtime 早于 now−ttl 的**文件**（目录不动）；
+ * 单个 stat/unlink 失败忽略（清扫不阻断下载）。
+ */
+export function sweepAssetDir(dir, { ttlMs = ASSET_SWEEP_TTL_MS, now = Date.now(), fs = realFs } = {}) {
+  let names;
+  try {
+    names = fs.readdirSync(dir);
+  } catch {
+    return; // 目录不存在/不可读 → 无可清扫
+  }
+  for (const n of names) {
+    const p = join(dir, n);
+    try {
+      const st = fs.statSync(p);
+      if (!st.isFile()) continue;
+      if (now - st.mtimeMs > ttlMs) fs.rmSync(p, { force: true });
+    } catch { /* best-effort */ }
+  }
+}
+
+/** 丢弃响应体（redirect/manual 路径释放连接；无 body/不可取消则忽略）。 */
+async function discardBody(res) {
+  try {
+    if (res?.body?.cancel) await res.body.cancel();
+    else if (res?.body?.destroy) res.body.destroy();
+  } catch { /* 丢弃失败不阻断 */ }
+}
+
+/**
+ * 逐跳白名单下载循环（design §A：redirect:'manual'，任何一跳越权即断）。
+ * @returns {Promise<{res: object, finalUrl: string}>} 终跳 2xx 响应（body 未消费）
+ */
+async function fetchWithHopAllowlist(url, allowHosts, fetchImpl) {
+  let current = url;
+  for (let hop = 0; ; hop += 1) {
+    const deny = checkAssetHop(current, allowHosts);
+    if (deny) throw assetError(deny.code, deny.message);
+    let res;
+    try {
+      res = await fetchImpl(current.href, { redirect: 'manual' });
+    } catch (err) {
+      throw assetError('net', `资产下载失败（${current.host}）：${err?.message ?? err}`);
+    }
+    if (res && [301, 302, 303, 307, 308].includes(res.status)) {
+      const loc = res.headers?.get?.('location');
+      await discardBody(res);
+      if (typeof loc !== 'string' || loc === '') {
+        throw assetError('net', `重定向缺 Location（${current.host} → HTTP ${res.status}）`);
+      }
+      if (hop >= MAX_REDIRECT_HOPS) {
+        throw assetError('net', `重定向超过 ${MAX_REDIRECT_HOPS} 跳（终点 ${current.href}）`);
+      }
+      let next;
+      try {
+        next = new URL(loc, current.href); // 相对 Location 按当前跳解析
+      } catch {
+        throw assetError('net', `重定向 Location 无法解析：${loc}`);
+      }
+      current = next;
+      continue;
+    }
+    if (!res || typeof res.ok !== 'boolean' || !res.ok) {
+      await discardBody(res);
+      throw assetError('net', `资产下载失败（${current.host}）：HTTP ${res?.status ?? '???'}`);
+    }
+    // manual 模式下 res.url＝本跳请求 URL；缺省（桩环境）回退 current.href
+    const finalUrl = typeof res.url === 'string' && res.url !== '' ? res.url : current.href;
+    return { res, finalUrl };
+  }
+}
+
+/**
+ * 处理 bu:asset-fetch（async——下载/落盘是异步动作）。永不 reject：一切失败映射
+ * 错误帧（code 语义见文件头）。
+ * @param {unknown} msg
+ * @param {{ home?: string, fs?: object, fetchImpl?: Function, now?: () => number,
+ *           sweepTtlMs?: number }} [deps]
+ * @returns {Promise<{type:'bu:asset-fetch:ok', path:string, bytes:number, finalUrl:string, sha256:string}
+ *                 |{type:'bu:asset-fetch:error', code:string, message:string}>}
+ */
+export async function assetFetchHost(msg, deps = {}) {
+  // 1. 形状校验（结构性畸形 ⇒ bad-msg——确定性拒绝，SW 不回退）
+  if (msg === null || typeof msg !== 'object' || Array.isArray(msg)) {
+    return errorReply('bad-msg', '消息须为 JSON 对象');
+  }
+  if (msg.type !== ASSET_FETCH_MSG_TYPE) {
+    return errorReply('bad-msg', `未知消息类型：${JSON.stringify(msg.type ?? null)}`);
+  }
+  if (typeof msg.url !== 'string' || msg.url === '') {
+    return errorReply('bad-msg', `url 须为非空字符串（收到 ${JSON.stringify(msg.url ?? null)}）`);
+  }
+  if (typeof msg.name !== 'string' || msg.name === '' || msg.name.length > NAME_MAX) {
+    return errorReply('bad-msg', `name 须为 1~${NAME_MAX} 字符的字符串（收到 ${JSON.stringify(msg.name ?? null)}）`);
+  }
+  if (!Number.isSafeInteger(msg.maxBytes) || msg.maxBytes <= 0 || msg.maxBytes > MAX_BYTES_CEILING) {
+    return errorReply('bad-msg', `maxBytes 须为 (0, ${MAX_BYTES_CEILING}] 的整数（收到 ${JSON.stringify(msg.maxBytes ?? null)}）`);
+  }
+  if (!Array.isArray(msg.allowHosts) || msg.allowHosts.length === 0 || msg.allowHosts.length > ALLOW_HOSTS_MAX
+    || msg.allowHosts.some((h) => typeof h !== 'string' || h === '' || h.length > 253)) {
+    return errorReply('bad-msg', `allowHosts 须为 1~${ALLOW_HOSTS_MAX} 条非空字符串数组（收到 ${JSON.stringify(msg.allowHosts ?? null)}）`);
+  }
+  let safe;
+  try {
+    safe = safeAssetName(msg.name);
+  } catch (err) {
+    return errorReply(err.code, err.message);
+  }
+
+  const fsMod = deps.fs ?? realFs;
+  const fetchFn = deps.fetchImpl ?? globalThis.fetch;
+  if (typeof fetchFn !== 'function') {
+    return errorReply('net', '无可用 fetch（Node >= 18）');
+  }
+
+  /** 失败路径的 temp 残留清理（成功路径 rename 已把 temp 就位为终名）。 */
+  let tempPath = null;
+  try {
+    // 2. 首跳 URL 解析（字符串已到、不可解析 ⇒ bad-url）
+    let u;
+    try {
+      u = new URL(msg.url);
+    } catch {
+      throw assetError('bad-url', `资产 url 无法解析：${msg.url}`);
+    }
+
+    // 3. 逐跳白名单下载（含首跳协议/域校验）
+    const { res, finalUrl } = await fetchWithHopAllowlist(u, msg.allowHosts, fetchFn);
+    if (!res.body) throw assetError('net', '资产下载响应无 body');
+
+    // 4. content-length 预检（maxBytes 第一闸；无声明则只靠流式第二闸）
+    const clRaw = res.headers?.get?.('content-length');
+    if (typeof clRaw === 'string' && /^\d+$/.test(clRaw) && Number(clRaw) > msg.maxBytes) {
+      await discardBody(res);
+      throw assetError('too-large', `资产超限（content-length=${clRaw} > maxBytes=${msg.maxBytes}）`);
+    }
+
+    // 5. 落盘准备：目录 mkdir -p ＋ 写前清扫（mtime>ttl 的文件 best-effort 删）
+    const dir = join(deps.home ?? homedir(), 'fde2e', 'bu', 'assets');
+    fsMod.mkdirSync(dir, { recursive: true });
+    sweepAssetDir(dir, {
+      ...(deps.sweepTtlMs !== undefined ? { ttlMs: deps.sweepTtlMs } : {}),
+      // 专用 nowMs（epoch 毫秒）——不复用 host 共享 deps.now（那是 ISO 字符串，串线即
+      // 清扫静默失效的哑弹；对抗审查 P3.1）
+      ...(deps.nowMs !== undefined ? { now: deps.nowMs() } : {}),
+      fs: fsMod,
+    });
+    const finalPath = join(dir, safe);
+    tempPath = join(dir, `.bu-asset-${process.pid}-${safe}.tmp`);
+    fsMod.rmSync(tempPath, { force: true });
+
+    // 6. 流式累计（maxBytes 第二闸）＋ sha256 ＋ temp 写入 → rename 原子就位
+    const source = res.body.getReader ? Readable.fromWeb(res.body) : Readable.from(res.body);
+    const hash = createHash('sha256');
+    const sink = fsMod.createWriteStream(tempPath);
+    let bytes = 0;
+    try {
+      await pipeline(source, async function* countAndPass(chunks) {
+        for await (const chunk of chunks) {
+          bytes += chunk.length;
+          if (bytes > msg.maxBytes) {
+            throw assetError('too-large', `资产超限（流式累计 ${bytes} > maxBytes=${msg.maxBytes}）`);
+          }
+          hash.update(chunk);
+          yield chunk;
+        }
+      }, sink);
+    } catch (err) {
+      if (err?.name === 'AssetFetchError' && ASSET_ERROR_CODES.has(err.code)) throw err; // too-large 等本模块错误原样透传
+      throw assetError('io', `资产落盘中断：${err?.message ?? err}`);
+    } finally {
+      try { sink.destroy(); } catch { /* 已关闭 */ }
+    }
+    try {
+      fsMod.renameSync(tempPath, finalPath);
+    } catch (err) {
+      fsMod.rmSync(tempPath, { force: true });
+      throw assetError('io', `资产原子就位失败（${safe}）：${err?.message ?? err}`);
+    }
+    return {
+      type: 'bu:asset-fetch:ok',
+      path: finalPath,
+      bytes,
+      finalUrl,
+      sha256: hash.digest('hex'),
+    };
+  } catch (err) {
+    if (tempPath !== null) {
+      try { fsMod.rmSync(tempPath, { force: true }); } catch { /* 清残留失败不遮蔽原错误 */ }
+    }
+    if (err?.name === 'AssetFetchError' && ASSET_ERROR_CODES.has(err.code)) {
+      return errorReply(err.code, err?.message ?? String(err));
+    }
+    return errorReply('io', err?.message ?? String(err)); // 兜底：未映射异常按 io
+  }
+}