[CodFrm]

背景

sctl 无法触发脚本猫的后台/定时脚本运行，也读不到脚本运行日志。这两类脚本跑在 offscreen/sandbox 里，不是网页，sctl 也不能 attach 扩展页面（PAGE_NOT_AUTOMATABLE），所以 AI 代理写完这类脚本后只能请用户去脚本列表里人工查看。

Spec：docs/specs/2026-11-04-script-run-logs.md（本 PR 前两个提交）。

改动

• 协议：新增 scripts.run、scripts.logs（peer scriptcat，无审批阻塞）。schemaVersion 保持 1.0.0：daemon 握手要求版本完全相等（conn.go:367），升版本会让旧版 ScriptCat 连不上，做法与 ✨ daemon 同时接入多个 ScriptCat 实例，修复普通与隐身进程互相顶替 (#14) #16 一致。protocol.md 中“scriptcat 定义会改变 schemaVersion”的说法已一并更正。生成给 ScriptCat 的 TS 不允许出现 level 子串，所以日志级别字段叫 severity。
• CLI：
  • sctl run <uuid>：默认等待本次运行结束，--timeout 默认 60s、上限 240s；--no-wait 触发后立即返回。
  • sctl logs <uuid>：支持 --since（默认 1h）、--level（映射到 severity）、--text、--limit（默认 100，范围 1..1000）。
  • 脚本运行结果是 error 时仍以 exit 0 退出，退出码表不变。Ctrl-C 和断开都是 exit 2。
  • 旧版 ScriptCat 返回 METHOD_NOT_FOUND 时附带升级提示，提示文案放在 internal/cli/upgradehint，供 MCP 复用。
  • 脚本可控的文本经过 terminalSafe 转义后才输出到终端。
• MCP：scripts_run / scripts_logs 的参数与 CLI 等价，不发“等待审批”进度，工具描述是静态文本。
• 文档：cli.md、mcp.md、architecture.md、README（中英）、skills/sctl 已同步。threat-model.md 把这两个操作列入未门控能力，并记录维护者于 2026-11-04 接受的残余风险：持有控制 token 的进程可以反复触发已安装的后台脚本，并读到 GM_log 过的内容。
• CI：SCRIPTCAT_REF 指向 ScriptCat 373a117c。

已知限制

• ScriptCat 的运行状态事件没有运行 id。外部运行和编辑器“运行”或 cron 触发交叠时仍可能误认状态（ScriptCat 侧已标注，根治需要 sandbox 发出运行 id）。
• 生产构建的 ScriptCat 不会把 GM_log 的 debug 级别写进日志库，run/logs 看不到 debug 日志。
• MCP 参数越界时，报错信息里带有本机的 file:// 路径，来自 jsonschema 的错误格式。

关联

• 配对 PR：✨ 外部接入：支持 sctl 触发后台/定时脚本运行并读取脚本运行日志 scriptcat#1825。先合 #1825，再合本 PR；CI 在 ScriptCat 分支已推送后才能取到 SCRIPTCAT_REF。

验证

base 2939485…head dc71bef，26 个文件。

• go test ./... -race exit 0；make protocol-check exit 0；golangci-lint run ./... 0 issues。
• 本地模拟 CI 的生成物字节比对：用旧的 SCRIPTCAT_REF 比对 exit 1，用 373a117c 比对 exit 0。
• 真实验证（按 docs/verification.md）：本分支构建的 daemon 隔离在 127.0.0.1:18643、使用临时 data dir，配对由 #1825 构建、在无头 Chromium 中运行的 ScriptCat。spec 的 18 项要求全部通过，包括：
  • complete、error、超时 running、--no-wait；
  • 页面脚本返回 INVALID_REQUEST，未知 uuid 返回 NOT_FOUND；
  • 各过滤条件和上下限，审计记录被排除且不含日志正文；
  • MCP 与 CLI 一致、没有审批进度；
  • Ctrl-C 和断开都是 exit 2，已触发的运行不被撤回；
  • 用 ScriptCat 基线 6c0459b8 构建的旧版收到 METHOD_NOT_FOUND 和升级提示，已有命令照常可用；
  • 多个实例在线时返回 SCRIPTCAT_AMBIGUOUS。
• 尚未经过人工审查。

审查修复（2026-11-05）

• 729a663 spec 修订：
  • run-in 不符立即返回 INVALID_REQUEST；
  • 排队时间计入超时；--no-wait 不排队；取消时放弃还在排队的运行；
  • 旧运行晚到的结束不得算作本次结果；日志字段编码容错；
  • MCP 运行等待期间发进度通知。
• 62ef80d：
  • MCP scripts_run 等待期间发中性进度（“Waiting for the script run to end…”），避免客户端 60 秒左右超时；wait:false 和 scripts_logs 不发。
  • sctl run 被 Ctrl-C 时，提示运行可能已在 ScriptCat 中进行，不再说“已作废”。
  • run 的日志被截断时，提示改用 sctl logs <uuid> 查看完整记录。
  • 升级提示同时覆盖旧版 ScriptCat 和旧版 daemon 两种情况。
• dc71bef：protocol.md、cli.md、mcp.md、skills/sctl 按修订后的 spec 更新。

验证（head dc71bef）：

• go test ./... -race exit 0（我修复后自己重跑的结果），golangci-lint 0 个问题，make protocol-check exit 0。
• 与 ScriptCat #1825 3b0038f5 联合做了真实验证。
• 生成文件没有改动，SCRIPTCAT_REF 不变。