agent-hub-runner 0.1.1 → 0.1.3

package/README.md

@@ -1,3 +1,4 @@
+<!-- @意图#R690(2026-11-01): 加「改动记录」一节：存在哪、打码、64 KB、30 天、怎么删 -->
 <!-- @意图#R666(2026-10-29): 改成不用全局安装的 npx 一条命令（码@地址）、Mac 开机自启、stop / uninstall、常见报错 -->
 <!-- @意图#R664(2026-10-29): npm 包 agent-hub-runner 的说明（随包发布）：给客户看的安装、配对、再连、查看、断开、卸载和安全提示 -->
 # agent-hub-runner
@@ -51,6 +52,8 @@ npx -y agent-hub-runner@latest uninstall       # 关掉开机自启、删掉复
 
 开机自启时，程序复制到 `~/.agent-runner/bin/<版本>/`，日志在 `~/.agent-runner/logs/runner.log`（超过 5MB 自动清空）。网页上提示「有新版本」时，按提示运行那一条升级命令。
 
+仓库开发者（R699）：要让仓库里的源码 `runner/runner.mjs` 直接连测试服、开机自启，用 `agent-hub/scripts/runner-test.sh autostart on|off | start | stop | status | log`（launchd 服务 `com.agenthub.runner.src`，日志 `~/.agent-runner/logs/runner-src.log`，不复制程序，改了代码 `start` 一下就生效）。普通用户不用管这个。
+
 ## 配置文件
 
 - 默认在 `~/.agent-runner/config.json`（权限 600），里面有服务器地址、设备 id、长期令牌、电脑名和每个 bot 的目录。别发给别人。
@@ -71,6 +74,12 @@ npx -y agent-hub-runner@latest uninstall       # 关掉开机自启、删掉复
 - 在网页抽屉「连着的电脑」里点「断开」：令牌立刻作废，再连要重新配对；开机自启也会自己关掉。
 - 卸载：`npx -y agent-hub-runner@latest uninstall`（加 `--purge` 连配置一起删，不再问）。
 
+## 改动记录（0.1.2 起）
+
+- bot 每次写文件、改文件，运行器在配置文件旁边的 `edits/` 文件夹（默认 `~/.agent-runner/edits/`，只有你能读）存一份改动记录，网页上点「已改文件 / 已写文件（自动允许）」那行灰字就能看到改了什么。内容只在你电脑上，服务器不存。
+- 存之前会把像密钥的字符串换成 `***`（`sk-…`、`ghp_…`、连接串里的密码、私钥、`XXX_KEY=…` 这类赋值）；每条最多 64 KB；只留 30 天，过期自动删。电脑不在线时网页上看不到。
+- 不想留：直接删掉 `edits/` 文件夹，不影响别的。
+
 ## 安全提示
 
 - 别把放着密钥、令牌的文件夹授权出去：bot 在授权文件夹里读、写、改文件不用你批准。

package/autostart.mjs

@@ -17,7 +17,8 @@ export const LABEL = "com.agenthub.runner";
 export const LOG_MAX_BYTES = 5 * 1024 * 1024;
 export const THROTTLE_S = 10;
 /** 复制到 ~/.agent-runner/bin/<版本>/ 的文件（package.json 用来读版本号） */
-export const COPY_FILES = ["runner.mjs", "ops.mjs", "edit.mjs", "autostart.mjs", "package.json"];
+// @意图#R690(2026-11-01): 多复制 changes.mjs（runner.mjs 要 import 它，少了开机自启的副本起不来）
+export const COPY_FILES = ["runner.mjs", "ops.mjs", "edit.mjs", "changes.mjs", "autostart.mjs", "package.json"];
 /** 优先用的稳定 node 路径（Homebrew 升级 node 后这两个软链还在；nvm 的带版本号路径卸了就没了） */
 export const STABLE_NODES = ["/opt/homebrew/bin/node", "/usr/local/bin/node"];
 export const ONLY_MAC = "开机自启目前只支持 Mac";

package/changes.mjs

@@ -0,0 +1,195 @@
+// @意图#R690(2026-11-01): 私聊里「已改文件 / 已写文件（自动允许）」点开看改动（king 同意 R690）：改动内容只存在你电脑上（运行器配置旁边的 edits/<auto_id>.json，权限 600），
+// 服务器库里只记 id。改文件存按行对比（带改前、改后行号和前后 3 行，网页左右对照用），写文件存写进去的内容；存之前先打码（和服务器 redactSecrets 同一套规则，
+// 共用测试样例 test/fixtures/redact-cases.json）；每条最多 64 KB（超出截断并标记）；只留 30 天（启动时和每次存时顺手清，最多一小时一次）。存失败只记日志，不影响写改本身。
+import fs from "node:fs/promises";
+import path from "node:path";
+
+export const CHANGE_ID_RE = /^auto-[0-9a-f]{32}$/;
+export const MAX_RECORD_BYTES = 64 * 1024;
+export const KEEP_MS = 30 * 24 * 60 * 60_000;
+export const CLEAN_EVERY_MS = 60 * 60_000;
+export const CONTEXT_LINES = 3;
+/** 中间改动部分（去掉首尾相同的行后）行数乘积超过这个就不细算，整块当作删了再加 */
+export const MAX_DIFF_CELLS = 4_000_000;
+
+/** 改动记录放在配置文件旁边的 edits/ 里（跟着 AGENT_RUNNER_CONFIG 走，dev 和正式配置各管各的文件，名字是 auto_id 不会撞）。 */
+// @意图#R690(2026-11-01): king 定甲：放配置旁边
+export const changesDirFor = (configFile) => path.join(path.dirname(configFile), "edits");
+
+// 变量名以 KEY / TOKEN / SECRET / PASSWORD / PASSWD 结尾（API_KEY、db.password、apiKey、token 都算；monkey、tokens 不算）
+const NAME = String.raw`(?:(?:[A-Za-z0-9]+[_.-])*(?:KEY|TOKEN|SECRET|PASSWORD|PASSWD|key|token|secret|password|passwd|Key|Token|Secret|Password)|[a-z][A-Za-z0-9]*(?:Key|Token|Secret|Password))`;
+const QUOTED_ASSIGN = new RegExp(String.raw`(^|[^\w.-])(["']?)(${NAME})\2([ \t]*[=:][ \t]*)(["'])([^"'\r\n]+)\5`, "gm");
+const LINE_ASSIGN = new RegExp(String.raw`^([ \t]*(?:export[ \t]+)?)(${NAME})([ \t]*[=:][ \t]*)([^\s"'#][^\s#]*)`, "gm");
+
+/**
+ * 打码（和服务器 server/src/model-keys.ts 的 redactSecrets 规则一字不差，样例见 test/fixtures/redact-cases.json）：
+ * sk- / ghp_ 开头的串、连接串里的密码、私钥块（BEGIN/END 两行留着，中间每行换成 ***，行数不变）、
+ * 变量名像密钥的赋值（带引号的值任何位置都打；不带引号的只认行首的 .env / yaml 写法）。
+ */
+// @意图#R690(2026-11-01): king 定乙：服务器三条规则 + 私钥块 + .env 式 XXX_KEY / TOKEN / SECRET / PASSWORD = 值；打码不改变行数（行号对得上）
+export function redactSecrets(text) {
+  let s = String(text);
+  s = s.replace(/(-----BEGIN [A-Z0-9 ]*-----)([\s\S]*?)(-----END [A-Z0-9 ]*-----)/g, (_m, a, body, b) => a + body.replace(/[^\r\n]+/g, "***") + b);
+  s = s.replace(/(-----BEGIN [A-Z0-9 ]*PRIVATE KEY-----)((?:(?!-----END )[\s\S])*)$/, (_m, a, body) => a + body.replace(/[^\r\n]+/g, "***")); // 截断了没有 END 的私钥块
+  s = s.replace(/(?<![A-Za-z0-9])sk-[A-Za-z0-9_-]+/g, "sk-***").replace(/(?<![A-Za-z0-9])ghp_[A-Za-z0-9_]+/g, "ghp_***")
+    .replace(/([a-z][a-z0-9+.-]*:\/\/[^\s:/@]+):[^\s@/]+@/gi, "$1:***@");
+  s = s.replace(QUOTED_ASSIGN, (m, pre, q1, name, eq, q2, val) => (val === "***" ? m : `${pre}${q1}${name}${q1}${eq}${q2}***${q2}`));
+  s = s.replace(LINE_ASSIGN, "$1$2$3***");
+  return s;
+}
+
+/** 按行拆（去 BOM、换行统一成 LF；末尾换行不算多一行）。 */
+export function splitLines(text) {
+  let t = String(text);
+  if (t.startsWith("\uFEFF")) t = t.slice(1);
+  t = t.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+  if (t === "") return [];
+  const a = t.split("\n");
+  if (a[a.length - 1] === "") a.pop();
+  return a;
+}
+
+/** 逐行对比：返回每一行 {t:" "|"-"|"+", o:改前行号|null, n:改后行号|null, s:内容}；连着的一段改动里先删后加。 */
+// @意图#R690(2026-11-01): 带两边行号，网页既能画左右对照也能画红绿一栏
+export function diffLines(a, b) {
+  let p = 0;
+  while (p < a.length && p < b.length && a[p] === b[p]) p++;
+  let q = 0;
+  while (q < a.length - p && q < b.length - p && a[a.length - 1 - q] === b[b.length - 1 - q]) q++;
+  const A = a.slice(p, a.length - q), B = b.slice(p, b.length - q);
+  const mid = []; // " " / "-" / "+" 序列
+  if (A.length && B.length && A.length * B.length <= MAX_DIFF_CELLS) {
+    const n = A.length, m = B.length, w = m + 1;
+    const dp = new Uint32Array((n + 1) * w);
+    for (let i = n - 1; i >= 0; i--) for (let j = m - 1; j >= 0; j--) {
+      dp[i * w + j] = A[i] === B[j] ? dp[(i + 1) * w + j + 1] + 1 : Math.max(dp[(i + 1) * w + j], dp[i * w + j + 1]);
+    }
+    let i = 0, j = 0;
+    while (i < n || j < m) {
+      if (i < n && j < m && A[i] === B[j]) { mid.push(" "); i++; j++; }
+      else if (j >= m || (i < n && dp[(i + 1) * w + j] >= dp[i * w + j + 1])) { mid.push("-"); i++; }
+      else { mid.push("+"); j++; }
+    }
+  } else {
+    for (let i = 0; i < A.length; i++) mid.push("-");
+    for (let j = 0; j < B.length; j++) mid.push("+");
+  }
+  // 连着的改动里先删后加
+  const tags = [];
+  for (let k = 0; k < mid.length;) {
+    if (mid[k] === " ") { tags.push(" "); k++; continue; }
+    let d = 0, ad = 0;
+    while (k < mid.length && mid[k] !== " ") { if (mid[k] === "-") d++; else ad++; k++; }
+    for (let x = 0; x < d; x++) tags.push("-");
+    for (let x = 0; x < ad; x++) tags.push("+");
+  }
+  const out = [];
+  let o = 0, nn = 0;
+  for (let k = 0; k < p; k++) { out.push({ t: " ", o: o + 1, n: nn + 1, s: a[o] }); o++; nn++; }
+  for (const t of tags) {
+    if (t === " ") { out.push({ t, o: o + 1, n: nn + 1, s: a[o] }); o++; nn++; }
+    else if (t === "-") { out.push({ t, o: o + 1, n: null, s: a[o] }); o++; }
+    else { out.push({ t, o: null, n: nn + 1, s: b[nn] }); nn++; }
+  }
+  for (let k = 0; k < q; k++) { out.push({ t: " ", o: o + 1, n: nn + 1, s: a[o] }); o++; nn++; }
+  return out;
+}
+
+/** 把逐行对比切成几处改动，每处前后带 ctx 行没变的；两处之间没变的不超过 2×ctx 行就并成一处。 */
+export function hunksOf(rows, ctx = CONTEXT_LINES) {
+  const idx = [];
+  rows.forEach((r, i) => { if (r.t !== " ") idx.push(i); });
+  const hunks = [];
+  let k = 0;
+  while (k < idx.length) {
+    let start = idx[k], end = idx[k];
+    while (k + 1 < idx.length && idx[k + 1] - end - 1 <= 2 * ctx) { k++; end = idx[k]; }
+    k++;
+    const from = Math.max(0, start - ctx), to = Math.min(rows.length, end + ctx + 1);
+    const lines = rows.slice(from, to);
+    let oStart = 1, nStart = 1;
+    for (let i = 0; i < from; i++) { if (rows[i].t !== "+") oStart++; if (rows[i].t !== "-") nStart++; }
+    hunks.push({ old_start: oStart, new_start: nStart, lines });
+  }
+  return hunks;
+}
+
+const jsonBytes = (v) => Buffer.byteLength(JSON.stringify(v), "utf8") + 1; // 存进去占的字节（加逗号）
+
+/**
+ * 生成一条改动记录（存之前先打码、截到 64 KB）。
+ * edit：{ v, id, tool, path, at, hunks, added, removed, truncated }；write：{ v, id, tool, path, at, lines, total_lines, chars, truncated }
+ */
+// @意图#R690(2026-11-01): 改文件存红绿对比（king 定），写文件只存写进去的内容、不存旧文件（king 定乙）；每条最多 64 KB（king 定甲）
+export function buildChangeRecord({ id, tool, path: p, before, after, content, at = new Date().toISOString() }) {
+  const budget = MAX_RECORD_BYTES - 1024;
+  const head = { v: 1, id, tool, path: String(p ?? ""), at };
+  if (tool === "write") {
+    const text = String(content ?? "");
+    const all = splitLines(redactSecrets(text));
+    const lines = [];
+    let used = 0, truncated = false;
+    for (const l of all) {
+      const b = jsonBytes(l);
+      if (used + b > budget) { truncated = true; break; }
+      lines.push(l); used += b;
+    }
+    return { ...head, lines, total_lines: all.length, chars: text.length, truncated };
+  }
+  const rows = diffLines(splitLines(redactSecrets(before ?? "")), splitLines(redactSecrets(after ?? "")));
+  let added = 0, removed = 0;
+  for (const r of rows) { if (r.t === "+") added++; else if (r.t === "-") removed++; }
+  const hunks = [];
+  let used = 0, truncated = false;
+  for (const h of hunksOf(rows)) {
+    used += jsonBytes({ old_start: h.old_start, new_start: h.new_start, lines: [] });
+    const keep = [];
+    for (const l of h.lines) {
+      const b = jsonBytes(l);
+      if (used + b > budget) { truncated = true; break; }
+      keep.push(l); used += b;
+    }
+    if (keep.length) hunks.push({ ...h, lines: keep });
+    if (truncated) break;
+  }
+  return { ...head, hunks, added, removed, truncated };
+}
+
+/** 改动记录的存取和清理（目录用到时才建，700；文件 600）。 */
+// @意图#R690(2026-11-01): 只留 30 天（king 定甲）：启动时清一次，每次存时顺手清（最多一小时一次），按文件修改时间算
+export function createChangeStore(dir, { now = Date.now, log = () => {} } = {}) {
+  let lastClean = 0;
+  const fileOf = (id) => path.join(dir, `${id}.json`);
+  async function clean(force = false) {
+    if (!force && now() - lastClean < CLEAN_EVERY_MS) return 0;
+    lastClean = now();
+    let names;
+    try { names = await fs.readdir(dir); } catch { return 0; }
+    let removed = 0;
+    for (const f of names) {
+      if (!/^auto-[0-9a-f]{32}\.json$/.test(f)) continue;
+      try {
+        const st = await fs.stat(path.join(dir, f));
+        if (now() - st.mtimeMs > KEEP_MS) { await fs.unlink(path.join(dir, f)); removed++; }
+      } catch { /* 别的进程删了 */ }
+    }
+    return removed;
+  }
+  return {
+    dir,
+    clean,
+    async save(id, record) {
+      if (!CHANGE_ID_RE.test(String(id))) throw new Error("改动记录 id 不对");
+      await fs.mkdir(dir, { recursive: true, mode: 0o700 });
+      const f = fileOf(id);
+      await fs.writeFile(f, JSON.stringify(record), { mode: 0o600 });
+      await fs.chmod(f, 0o600);
+      await clean().catch((e) => log(`清理旧改动记录失败：${e?.message ?? e}`));
+    },
+    /** 找不到（没存、已清理、id 不对）返回 null */
+    async get(id) {
+      if (!CHANGE_ID_RE.test(String(id))) return null;
+      try { return JSON.parse(await fs.readFile(fileOf(id), "utf8")); } catch { return null; }
+    },
+  };
+}

package/ops.mjs

@@ -1,7 +1,7 @@
 // @意图#R636(2026-10-27): 运行器在你电脑上真正执行 read / write / edit / bash。路径只在这里判断（S6 结论：服务器不解析用户电脑的路径）：
 // 先按授权目录换算成真实路径（解开符号链接，包括指向不存在目标的符号链接），不在授权目录里的一律拒绝；bash 的工作目录就是授权目录。
 // 第一轮没有沙箱（king 定的范围）：bash 里的命令本身能碰到目录外的东西，只能靠你看清批准卡片再点。
-import { spawn } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
@@ -68,7 +68,7 @@ function imageMime(buf) {
 export async function opRead(args, root) {
   const real = await resolveInside(args.path, root);
   const st = await fs.stat(real);
-  if (st.isDirectory()) throw new Error(`${args.path} 是目录，不是文件（看目录里有什么用 bash 的 ls）`);
+  if (st.isDirectory()) throw new Error(`${args.path} 是目录，不是文件（看目录里有什么用 ${process.platform === "win32" ? "PowerShell 的 Get-ChildItem" : "bash 的 ls"}）`);
   if (st.size > MAX_READ_BYTES) throw new Error(`${args.path} 太大（${st.size} 字节），超过 ${MAX_READ_BYTES} 字节；用 bash 的 head/sed 看一部分`);
   const buf = await fs.readFile(real);
   const mime = imageMime(buf);
@@ -77,39 +77,79 @@ export async function opRead(args, root) {
 }
 
 /** write：建好上级目录再整份写入。 */
+// @意图#R690(2026-11-01): 写成功后交给 onChange 存一份改动记录（写进去的内容），存记录的事不影响写本身
 // @意图#R636(2026-10-27): 写文件（已经过批准，只执行这一次）
-export async function opWrite(args, root) {
+export async function opWrite(args, root, { onChange } = {}) {
   if (typeof args.content !== "string") throw new Error("content 必须是文字");
   const real = await resolveInside(args.path, root);
   await fs.mkdir(path.dirname(real), { recursive: true });
   await fs.writeFile(real, args.content, "utf8");
+  await onChange?.({ tool: "write", path: args.path, content: args.content });
   return { bytes: Buffer.byteLength(args.content, "utf8") };
 }
 
 /** edit：和 pi 原版同样的精确替换。 */
+// @意图#R690(2026-11-01): 写回成功后把改前（读到的原文）、改后（写回的内容）交给 onChange 算对比、存记录：同一个函数里拿到的两份，不会和别的改动串
 // @意图#R636(2026-10-27): 改文件（已经过批准，只执行这一次）
-export async function opEdit(args, root) {
+export async function opEdit(args, root, { onChange } = {}) {
   if (!Array.isArray(args.edits) || args.edits.length === 0) throw new Error("Edit tool input is invalid. edits must contain at least one replacement.");
   const real = await resolveInside(args.path, root);
   let raw;
   try { raw = await fs.readFile(real, "utf8"); } catch (e) { throw new Error(`Could not edit file: ${args.path}. Error code: ${e?.code ?? "unknown"}.`); }
   const next = editText(raw, args.edits, args.path);
   await fs.writeFile(real, next, "utf8");
+  await onChange?.({ tool: "edit", path: args.path, before: raw, after: next });
   return { replaced: args.edits.length };
 }
 
-function killGroup(child) {
+function killGroup(child, platform = process.platform) {
   if (!child.pid) return;
+  // @意图#R721(2026-11-02): Windows 没有负进程组，要 taskkill /T /F 才能连子进程一起杀
+  if (platform === "win32") {
+    try { spawnSync("taskkill", ["/PID", String(child.pid), "/T", "/F"], { stdio: "ignore", windowsHide: true }); } catch { /* 进程已经没了 */ }
+    try { child.kill("SIGKILL"); } catch { /* ignore */ }
+    return;
+  }
   try { process.kill(-child.pid, "SIGKILL"); } catch { /* 进程组已经没了 */ }
   try { child.kill("SIGKILL"); } catch { /* ignore */ }
 }
 
+/**
+ * 按平台选执行器。
+ * Windows 上没有 bash：用 PowerShell，整段脚本转 UTF-16LE base64 传给 -EncodedCommand。
+ * 这样一次解决两个实现时踩到的坑：① 中文参数走 -Command 会按 ANSI 代码页解码成乱码；
+ * ② powershell -Command 的退出码恒为 0，得靠脚本尾巴的 exit $LASTEXITCODE 才拿得到真实结果。
+ */
+// @意图#R721(2026-11-02): Windows 用 PowerShell 跑命令（客户是小白，不能要求装 Git Bash）
+export function shellFor(command, platform = process.platform) {
+  if (platform === "win32") {
+    // $ProgressPreference 必须关：不加的话 PowerShell 会把进度流序列化成 #< CLIXML ... 写到 stderr，模型会看到一堆垃圾。
+    // `2>&1 | ForEach-Object { "$_" }`：错误也要转成纯字符串，否则 ErrorRecord 会被序列化成 CLIXML；
+    // 用管道逐条处理，保持边跑边输出（不缓冲）。
+    const script = [
+      "$ProgressPreference = 'SilentlyContinue'",
+      "[Console]::OutputEncoding=[Text.Encoding]::UTF8",
+      "$OutputEncoding=[Text.Encoding]::UTF8",
+      "& {",
+      command,
+      '} 2>&1 | ForEach-Object { "$_" }',
+      "exit $LASTEXITCODE",
+      "",
+    ].join("\n");
+    return {
+      file: "powershell.exe",
+      args: ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-OutputFormat", "Text", "-EncodedCommand", Buffer.from(script, "utf16le").toString("base64")],
+    };
+  }
+  return { file: "bash", args: ["-c", command] };
+}
+
 /**
  * bash：在授权目录里用你终端的环境变量跑（服务器的环境变量不下发）。输出边跑边交给 onData；
  * 超时或 signal 中止时杀掉整个进程组。返回 { exitCode, timedOut, aborted }。
  */
 // @意图#R636(2026-10-27): 跑命令（已经过批准，只执行这一次），有超时，超时杀进程
-export function opBash(args, root, { onData, signal } = {}) {
+export function opBash(args, root, { onData, signal, platform = process.platform } = {}) {
   const command = args.command;
   if (typeof command !== "string" || !command.trim()) return Promise.reject(new Error("command 是空的"));
   let timeoutS = DEFAULT_BASH_TIMEOUT_S;
@@ -118,12 +158,13 @@ export function opBash(args, root, { onData, signal } = {}) {
     if (!Number.isFinite(t) || t <= 0) return Promise.reject(new Error("Invalid timeout: must be a finite number of seconds"));
     timeoutS = t;
   }
+  const shell = shellFor(command, platform);
   return new Promise((resolve, reject) => {
-    const child = spawn("bash", ["-c", command], { cwd: root, detached: true, stdio: ["ignore", "pipe", "pipe"], env: process.env });
+    const child = spawn(shell.file, shell.args, { cwd: root, detached: platform !== "win32", stdio: ["ignore", "pipe", "pipe"], env: process.env, windowsHide: true });
     let timedOut = false;
     let aborted = false;
-    const timer = setTimeout(() => { timedOut = true; killGroup(child); }, timeoutS * 1000);
-    const onAbort = () => { aborted = true; killGroup(child); };
+    const timer = setTimeout(() => { timedOut = true; killGroup(child, platform); }, timeoutS * 1000);
+    const onAbort = () => { aborted = true; killGroup(child, platform); };
     if (signal) {
       if (signal.aborted) onAbort();
       else signal.addEventListener("abort", onAbort, { once: true });
@@ -141,12 +182,13 @@ export function opBash(args, root, { onData, signal } = {}) {
 }
 
 /** 按 op 分派；未知 op 拒绝。 */
+// @意图#R690(2026-11-01): write、edit 也收 extra（onChange 存改动记录）
 // @意图#R636(2026-10-27): 协议里只有这四种工具调用
 export function runOp(op, args, root, extra) {
   const a = args && typeof args === "object" ? args : {};
   if (op === "read") return opRead(a, root);
-  if (op === "write") return opWrite(a, root);
-  if (op === "edit") return opEdit(a, root);
+  if (op === "write") return opWrite(a, root, extra);
+  if (op === "edit") return opEdit(a, root, extra);
   if (op === "bash") return opBash(a, root, extra);
   return Promise.reject(new Error(`未知操作 ${op}`));
 }

package/package.json

@@ -1,10 +1,32 @@
 {
   "name": "agent-hub-runner",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "agent-hub 的电脑运行器：配对后让你的 bot 在这台电脑上读写授权目录里的文件、跑命令（跑命令要你在网页上批准）",
   "type": "module",
-  "bin": { "agent-hub-runner": "bin/agent-hub-runner.mjs" },
-  "files": ["runner.mjs", "ops.mjs", "edit.mjs", "autostart.mjs", "bin/agent-hub-runner.mjs", "README.md"],
-  "engines": { "node": ">=22" },
-  "scripts": { "test": "node --test" }
+  "bin": {
+    "agent-hub-runner": "bin/agent-hub-runner.mjs"
+  },
+  "files": [
+    "runner.mjs",
+    "ops.mjs",
+    "edit.mjs",
+    "changes.mjs",
+    "autostart.mjs",
+    "bin/agent-hub-runner.mjs",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "test": "node --test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cs1145994973/agent-hub-runner.git"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
 }

package/runner.mjs

@@ -23,9 +23,10 @@ import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 import readline from "node:readline/promises";
-import { execFile } from "node:child_process";
+import { execFile, spawn, spawnSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { runOp } from "./ops.mjs";
+import { buildChangeRecord, changesDirFor, CHANGE_ID_RE, createChangeStore } from "./changes.mjs";
 import { autostartOff, autostartOn, autostartStatus, logFileFor, ONLY_MAC, otherAutostarts, runnerHome, truncateLogIfBig } from "./autostart.mjs";
 
 export const PROTOCOL_VERSION = 1;
@@ -97,10 +98,19 @@ function checkNode() {
 
 export const PICK_PROMPT = "选择要授权给 bot 的文件夹";
 export const PICK_SCRIPT = `POSIX path of (choose folder with prompt "${PICK_PROMPT}")`;
+/** Windows 上的弹窗脚本：系统自带的 .NET 文件夹选择框，不需要任何额外安装。 */
+export const PICK_SCRIPT_WIN = [
+  "[Console]::OutputEncoding=[Text.Encoding]::UTF8",
+  "Add-Type -AssemblyName System.Windows.Forms",
+  "$d = New-Object System.Windows.Forms.FolderBrowserDialog",
+  `$d.Description = '${PICK_PROMPT}'`,
+  "$d.ShowNewFolderButton = $true",
+  "if ($d.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK) { [Console]::Out.Write($d.SelectedPath) }",
+].join("\n");
 /** R640：这个 bot 在对照表里没有目录时，调用一律回这句。 */
 // @意图#R666(2026-10-29): 「右栏」是 R663 以前的位置，改成输入框下面「我的电脑」那一行（和服务器 devices.ts 的 NO_DIR 一字不差）
 export const NO_DIR = "还没给这个 bot 选目录，请在这个 bot 的私聊里点输入框下面「我的电脑」那一行，再点「选择目录」";
-export const PICK_ONLY_MAC = "只支持 Mac：选目录的窗口只在 Mac 上弹";
+export const PICK_ONLY_MAC = "只支持 Mac 和 Windows：选目录的窗口只在 Mac / Windows 上弹";
 /** R640：pair 带了 --dir 时的提示（不报错，照常配对，目录不用）。 */
 export const PAIR_DIR_IGNORED = "目录请连上后在每个 bot 的私聊里选（--dir 已不用，这次没用它）";
 
@@ -137,6 +147,43 @@ export function pickDirMac({ signal } = {}) {
 
 /** 检查授权目录：存在、换成真实路径、是目录、不是磁盘根目录。返回真实路径。 */
 // @意图#R640(2026-10-27): 每个 bot 选的目录都走这套检查
+
+/**
+ * Windows 上弹系统「选文件夹」窗口（.NET FolderBrowserDialog，系统自带，不用装任何东西）。
+ * 选了返回路径；点取消返回 null；signal 中止时 taskkill 关掉窗口并抛 AbortError；弹不出来（没有桌面会话）抛错。
+ */
+// @意图#R716(2026-11-02): Windows 客户是小白，不能要求装 Git Bash，也不能靠手填路径；弹窗用系统自带的 .NET 窗口
+export function pickDirWindows({ signal, spawn: spawnFn = spawn } = {}) {
+  return new Promise((resolve, reject) => {
+    const b64 = Buffer.from(PICK_SCRIPT_WIN + "\n", "utf16le").toString("base64");
+    // 带 -STA：FolderBrowserDialog 要求单线程公寓；不带 -NonInteractive：要的就是交互窗口
+    const child = spawnFn("powershell.exe", ["-NoProfile", "-STA", "-ExecutionPolicy", "Bypass", "-OutputFormat", "Text", "-EncodedCommand", b64], {
+      stdio: ["ignore", "pipe", "pipe"],
+      windowsHide: true,
+    });
+    let out = "";
+    let err = "";
+    let settled = false;
+    const settle = (fn, v) => { if (!settled) { settled = true; signal?.removeEventListener("abort", onAbort); fn(v); } };
+    const killIt = () => {
+      if (child.pid) { try { spawnSync("taskkill", ["/PID", String(child.pid), "/T", "/F"], { stdio: "ignore", windowsHide: true }); } catch { /* 已退出 */ } }
+      try { child.kill("SIGKILL"); } catch { /* ignore */ }
+    };
+    const onAbort = () => { killIt(); settle(reject, Object.assign(new Error("已中止"), { name: "AbortError" })); };
+    if (signal) { if (signal.aborted) return onAbort(); signal.addEventListener("abort", onAbort, { once: true }); }
+    child.stdout?.on("data", (d) => { out += d.toString("utf8"); });
+    child.stderr?.on("data", (d) => { err += d.toString("utf8"); });
+    child.on("error", (e) => settle(reject, new Error(`弹不出选文件夹的窗口（${e?.message ?? e}）`)));
+    child.on("close", () => {
+      const picked = out.trim();
+      if (picked) return settle(resolve, picked);
+      const why = err.trim().split("\n")[0].trim();
+      if (why) return settle(reject, new Error(`弹不出选文件夹的窗口（${why}）`));
+      settle(resolve, null); // 点了取消：对话框没点确定，没有输出
+    });
+  });
+}
+
 // @意图#R639(2026-10-27): 配对时的 --dir 和网页上选的目录走同一套检查
 export async function checkDir(dir) {
   const real = await fs.realpath(path.resolve(dir)).catch(() => { throw new Error(`授权目录不存在：${dir}`); });
@@ -254,10 +301,26 @@ const wsUrlOf = (server) => `${server.replace(/^http/, "ws")}/devices/ws`;
 // @意图#R640(2026-10-27): 目录按 bot 分：call 按 bot_id 查对照表，没有就拒绝 NO_DIR；pick_dir 带 bot_id，选完检查后记进对照表、写回配置（600），
 // 回 dir_result {id, ok, bot_id, dir}；老配置的单一 dir 忽略
 // @意图#R639(2026-10-27已废弃): 目录不再是连接时固定的常量；没目录时 call 一律拒绝；pick_dir 选完检查、写回配置（600）、回 dir_result（R640 改成按 bot 分）
-export function createSession(cfg, { log = say, pickDir = pickDirMac, platform = process.platform, file = configPath() } = {}) {
+// @意图#R690(2026-11-01): write / edit 带 change_id（服务器记灰字时生成的 auto_id）就在写改成功后存一份改动记录（存失败只记日志）；
+// 新消息 change_get {id, change_id} → change_result {id, ok:true, found, record}，不看这个 bot 有没有目录（换了目录也能看旧记录）
+export function createSession(cfg, { log = say, platform = process.platform, pickDir = platform === "win32" ? pickDirWindows : pickDirMac, file = configPath(), changes } = {}) {
   let dirs = botDirsOf(cfg); // bot_id → 授权目录
   const jobs = new Map(); // 调用 id → AbortController
   const picks = new Map(); // 弹窗 id → AbortController
+  let store = changes; // 改动记录（R690），用到时才建
+  const changeStore = () => (store ??= createChangeStore(changesDirFor(file), { log }));
+  const recorder = (args) => {
+    const id = typeof args?.change_id === "string" ? args.change_id : "";
+    if (!CHANGE_ID_RE.test(id)) return undefined;
+    return async (info) => {
+      try { await changeStore().save(id, buildChangeRecord({ id, ...info })); } catch (e) { log(`改动记录没存上（不影响这次写改）：${e?.message ?? e}`); }
+    };
+  };
+
+  async function handleChangeGet(send, msg) {
+    const record = await changeStore().get(msg.change_id).catch(() => null);
+    send({ type: "change_result", id: msg.id, ok: true, found: !!record, ...(record ? { record } : {}) });
+  }
 
   async function handleCall(send, msg) {
     const { id, op, args } = msg;
@@ -268,7 +331,8 @@ export function createSession(cfg, { log = say, pickDir = pickDirMac, platform =
     jobs.set(id, ac);
     log(`[${bot}] ${op === "bash" ? `bash：${args?.command}` : `${op}：${args?.path}`}`);
     try {
-      const res = await runOp(op, args, dir, { signal: ac.signal, onData: (d) => send({ type: "output", id, data: Buffer.from(d).toString("base64") }) });
+      const onChange = op === "write" || op === "edit" ? recorder(args) : undefined;
+      const res = await runOp(op, args, dir, { signal: ac.signal, onChange, onData: (d) => send({ type: "output", id, data: Buffer.from(d).toString("base64") }) });
       if (ac.signal.aborted) send({ type: "result", id, ok: false, error: "已中止" });
       else send({ type: "result", id, ok: true, ...res });
     } catch (e) {
@@ -282,7 +346,7 @@ export function createSession(cfg, { log = say, pickDir = pickDirMac, platform =
     const { id } = msg;
     const bot = typeof msg.bot_id === "string" ? msg.bot_id : "";
     if (!bot) { send({ type: "dir_result", id, ok: false, error: "缺 bot_id" }); return; }
-    if (platform !== "darwin") { send({ type: "dir_result", id, ok: false, bot_id: bot, error: PICK_ONLY_MAC }); return; }
+    if (platform !== "darwin" && platform !== "win32") { send({ type: "dir_result", id, ok: false, bot_id: bot, error: PICK_ONLY_MAC }); return; }
     const ac = new AbortController();
     picks.set(id, ac);
     log(`网页上给 bot ${bot} 点了选择目录：请在弹出的窗口里选文件夹`);
@@ -307,9 +371,12 @@ export function createSession(cfg, { log = say, pickDir = pickDirMac, platform =
 
   return {
     get botDirs() { return { ...dirs }; },
+    /** R690：清掉 30 天前的改动记录（startRunner 启动时调一次） */
+    cleanChanges() { return changeStore().clean(true).catch(() => 0); },
     onMessage(msg, send) {
       if (msg.type === "call") return handleCall(send, msg);
       if (msg.type === "pick_dir") return handlePick(send, msg);
+      if (msg.type === "change_get") return handleChangeGet(send, msg);
       if (msg.type === "abort") { jobs.get(msg.id)?.abort(); picks.get(msg.id)?.abort(); }
       return undefined;
     },
@@ -332,10 +399,11 @@ export function createSession(cfg, { log = say, pickDir = pickDirMac, platform =
 // @意图#R640(2026-10-27): hello 报 bot→目录 对照表（bot_dirs），不再报单一 dir
 // @意图#R639(2026-10-27): 没目录也能连上；目录由 createSession 管（网页上选完马上生效），重连时 hello 带当前目录
 // @意图#R636(2026-10-27): 前台运行、心跳、执行工具调用；断线时杀掉正在跑的命令，重连后不重放
-export function startRunner(cfg, { log = say, retryMs = 2000, pickDir = pickDirMac, platform = process.platform, file = configPath(), background = process.env.AGENT_RUNNER_LAUNCHD === "1" } = {}) {
+export function startRunner(cfg, { log = say, retryMs = 2000, platform = process.platform, pickDir = platform === "win32" ? pickDirWindows : pickDirMac, file = configPath(), background = process.env.AGENT_RUNNER_LAUNCHD === "1" } = {}) {
   checkNode();
   let fails = 0;
   const session = createSession(cfg, { log, pickDir, platform, file });
+  void session.cleanChanges(); // R690：启动时清一次 30 天前的改动记录
   let ws = null;
   let stopped = false;
   let beat = null;
@@ -490,10 +558,11 @@ const usage = (prog) => `用法：
   ${prog} start              连上服务器（终端窗口别关；Ctrl-C 断开）
   ${prog} stop               停掉在跑的运行器
   ${prog} status             看配置、各 bot 的目录、在不在跑、开机自启
+  ${prog} set-dir <bot_id> <路径>   直接指定这个 bot 的授权目录（和网页上点「选择目录」走同一套检查；弹窗弹不出来时用）
   ${prog} autostart on|off|status   Mac 开机自启（on 也用来升级到新版本）
   ${prog} uninstall [--purge]       关掉自启、删掉本地副本和日志（--purge 连配置一起删）
   ${prog} --version
-目录请连上后在网页上每个 bot 的私聊里点输入框下面「我的电脑」那一行选，Mac 上会弹窗让你选。`;
+目录请连上后在网页上每个 bot 的私聊里点输入框下面「我的电脑」那一行选，Mac / Windows 上会弹窗让你选。`;
 
 // @意图#R666(2026-10-29): pair 默认配完直接 start（--no-start 只配对）；配完按 decideAutostart 问 / 提示 / 开启开机自启，开了就不在前台跑；
 // 新命令 stop、autostart on|off|status、uninstall、--version；status 多显示在不在跑、版本、开机自启；用法里的命令按运行方式写（npx 时写 npx 写法）
@@ -566,6 +635,26 @@ export async function main(argv, prog = progName(), deps = {}) {
     console.log(`已卸载：开机自启关了、本地副本和日志删了。${purge ? `配置也删了（${file}）；记得在网页「我的电脑」里点「断开」作废令牌。` : `配置留着（${file}）；连配置一起删：${prog} uninstall --purge`}`);
     return;
   }
+  if (a.cmd === "set-dir") {
+    // @意图#R716(2026-11-02): 不靠弹窗也能设目录（无桌面会话 / 弹不出来时应急），走和网页选目录同一套检查
+    const file = configPath();
+    const bot = a.positional[0];
+    const dir = a.positional[1];
+    if (!bot || !dir) { console.log(`用法：${prog} set-dir <bot_id> <路径>\n  bot_id 在网页这个 bot 的私聊里、输入框下面「我的电脑」那一行能看到`); process.exitCode = 1; return; }
+    let cfg;
+    try { cfg = loadConfig(file); } catch (e) { console.log(e?.message ?? String(e)); process.exitCode = 1; return; }
+    if (!cfg?.token) { console.log(`还没配对：${file} 里没有令牌。先在网页上配对：${prog} pair <配对码>@<服务器地址>`); process.exitCode = 1; return; }
+    let real;
+    try { real = await checkDir(dir); } catch (e) { console.log(e?.message ?? String(e)); process.exitCode = 1; return; }
+    cfg.bot_dirs = { ...botDirsOf(cfg), [bot]: real };
+    delete cfg.dir; // 老格式的单一 dir 不再写回
+    saveConfig(cfg, file);
+    const l = readLock(file);
+    const running = l && pidAlive(l.pid);
+    console.log(`已设：${bot} → ${real}`);
+    console.log(running ? `运行器正在跑（进程 ${l.pid}），重启后生效：${prog} stop && ${prog} start` : `配置文件：${file}`);
+    return;
+  }
   if (a.cmd === "status") {
     const file = configPath();
     const cfg = loadConfig(file);