feat: `bili daemon` 子命令——每会话动态端口起代理（native 模式 A）

[ranxianglei]

来源: #513 分析 native 模式时拆出的子任务（owner 已确认方案）。

新增薄子命令 bili daemon：供 agent 侧插件动态启动每会话专属代理。

需求:

• 复用 src/launcher.ts 现有 ensureProxyRunning 流程（probe/spawn/launch token 握手/EADDRINUSE 重试）；--fresh 语义：跳过 attach，总是新起实例（每会话隔离，探索如何发布为native模式 #513 owner 拍板）
• 端口动态分配（bind-0 试探或 EADDRINUSE 回退），不用静态端口
• per-session 结果文件：父进程建临时路径经 env（如 BILI_RESULT_FILE）传给 child；child 绑定成功后原子写 {origin, pid, launchToken}；父进程只轮询自己的文件。全局 instance file 照写（MCP shell/install 用，last-writer-wins 可接受）
• 传 BILI_PARENT_PID=<宿主进程pid>，复用现有 Windows 上 launcher 子代理从无优雅退出:stopProxy 直接 TerminateProcess,SIGBREAK-flush 全史 0 次触发,防抖窗状态+进行中轮被拦腰 #414 父进程监视机制在 agent 退出时自动回收代理
• 启动成功后向 stdout 输出单行 JSON {origin, port, pid, logPath} 并 exit 0；失败 exit 非零 + stderr 说明
• 测试：单测（沿用 launcher 测试的 deps 注入模式）+ 集成测试（真起进程、解析 JSON、清理）

[ranxianglei]

🤖 ework agent · qwen3.8-27b

收到。查重：无重复（#519 是 native 模式 B 的 fetch 拦截层，互补不重叠）。方案即 #513 floor 18 你拍板的形态，开工。

实现要点（对照 issue 逐条）：

• LaunchOptions 加 fresh（跳过 attach 分支，强制新起）、resultFile、parentPid 三个可选字段，ensureProxyRunning 主流程不动；
• 动态端口：新增 allocateDynamicPort()（bind-0），findFreePort 复用之；child 侧 EADDRINUSE 重试照旧（launcher 端口 TOCTOU(探测-释放-重bind 无重试):可静默挂上陌生 bili 或 20s 挂死;且被启动代理强制 --debug 制造 12MB/天日志 #407 机制天然兜住 bind-0 与 child 绑定之间的竞态）；
• child 绑定成功后在 announceListening 里除全局 instance file 外再原子写一份到 BILI_RESULT_FILE（同一份完整记录，含 origin/pid/launchToken）；父进程轮询只读自己的文件；
• BILI_PARENT_PID：--parent-pid <N> 优先，其次继承 env，都没有则告警且不装监视器（否则 bili daemon 自己一退出代理就自杀——这是坑点，默认不能是自己的 pid）；
• 成功后 stdout 单行 JSON {origin, port, pid, logPath} + exit 0；失败 exit 非零 + stderr。用 process.exitCode 而非 process.exit(0)，避免 pipe 下 stdout 未刷完被截断。

测试：单测走 launcher 同款 deps 注入（fake spawn 写 result file）+ 集成测试真起进程解析 JSON、验证 parent-gone 自动回收。完成后 PR。

[ranxianglei]

🤖 ework agent · qwen3.8-27b

完成，PR: #523 （分支 2026-09-04_bili-daemon-subcommand）

实现（对照需求逐条）：

• bili daemon [--parent-pid N] 薄子命令，复用 ensureProxyRunning 全流程（launch-token 握手 / health 轮询 / launcher 端口 TOCTOU(探测-释放-重bind 无重试):可静默挂上陌生 bili 或 20s 挂死;且被启动代理强制 --debug 制造 12MB/天日志 #407 EADDRINUSE 重试链）；新增 fresh 选项跳过 attach 分支——每会话强制新实例；
• 动态端口：新增导出 allocateDynamicPort()（bind-0 试探），显式 --port/ACP_PORT 仍优先、冲突自动回退；findFreePort 重构为复用它；
• per-session 结果文件：父进程建 tmp/bili-daemon-<uuid>.json 经 BILI_RESULT_FILE 传给 child；child 在 announceListening 绑定成功后除全局 instance file（照写，last-writer-wins）外再原子写一份完整记录到该文件；父进程轮询只读自己的文件，并行 daemon 互不干扰；
• BILI_PARENT_PID 三态：--parent-pid flag > 继承 env > 不装监视器 + stderr 告警。特意不默认成 daemon CLI 自身 pid——CLI 打完 JSON 就退出，默认自身 pid 会让代理在第一个 2s tick 内自杀（Windows 上 launcher 子代理从无优雅退出:stopProxy 直接 TerminateProcess,SIGBREAK-flush 全史 0 次触发,防抖窗状态+进行中轮被拦腰 #414 机制反向利用的坑点）；
• 成功 stdout 单行 JSON {origin, port, pid, logPath} + exit 0（用 process.exitCode 而非 process.exit(0)，防 pipe 下截断）；失败 exit 1 + stderr 说明。

测试：

• 单测 tests/daemon.test.ts（8 个，launcher 同款 deps 注入）：fresh 跳过 attach（对照组验证）、env 三态传递、只轮询 resultFile（全局 decoy 实例证明）、超时路径、动态端口可用、runDaemon stdout/exitCode/tmpdir 清理、env 回退与无 parent 告警；
• parseArgs 用例（含非法 pid → exit 2）；
• 集成 tests/e2e-daemon.test.ts：真起进程 → 解析 JSON → health OK → kill 宿主 → 代理 ~2s 内自回收（实测通过）。

Pre-flight：typecheck 干净；npm test 958/959——唯一失败是 resolveClientCommand: codex/claude resolve to themselves，存量环境问题（本沙箱 PATH 上有真实 /usr/bin/codex，PATH 解析返回绝对路径），已在 pristine master 干净 worktree 复现同样失败，与本改动无关；build 干净，且用构建产物 node dist/index.js daemon --parent-pid <pid> 做了端到端 smoke（握手 → health → parent-gone 回收 2.0s）。

README 加了简短的 Per-session proxy (bili daemon) 小节。无 version bump（content branch）。