feat(local): 本地端可用化收尾:后台启动 + stop.sh + 状态页修复

后台化与停止
- start.sh 默认后台启动(AGENT_LOCAL_DETACH=1):拉起真正的启动器后 1 秒返回,
  终端窗口可以关掉;停止统一走新增的 local/stop.sh(pid 文件 → core 父进程 → 占端口
  三级兜底,幂等)。保留 AGENT_LOCAL_DETACH=0 前台模式。
- 「已在运行」改看 supervisor.pid(kill -0 + 命令行校验),health 只做兜底。
  原来只看 health 时,core 尚未就绪的几秒内连跑两次会拉起两个启动器抢同一端口。

启动失败与首装体验
- 没 node 时在入口就拦下(生成配置之前),终端打出安装方式,不再让用户白选目录。
- 首次安装停在状态页等点击,后续启动才 2 秒自动跳转;状态页同一轮只开一个标签。
- 后台子进程秒退时改为指向状态页与日志路径,不再打印两行无意义的启动横幅。

其他修正
- MCP 默认端口 3101~3104 → 8091~8094;PORT 撞 MCP 端口直接拒绝启动。
- 没 ffmpeg 时不启动 mcp_asr(配置条目保留,装好后重跑即生效)。
- 依赖检测改为逐包检查 + .agent-installed 时间戳;npm install 输出落盘进状态页。
- app/package-lock.json 的 resolved 从腾讯云内网镜像改为公共 registry。
- 删除 local/start.command(Finder 双击常被当文本预览,入口统一为 start.sh)。
- 文档:docs/local-mode.md 补验证结果与新设计说明;local/README.md 改为启动/停止用法。
This commit is contained in:
2026-11-11 11:22:15 +08:00
parent 8a5c8b1547
commit f451027729
10 changed files with 931 additions and 374 deletions
+13 -4
View File
@@ -66,6 +66,15 @@ function relOf(taskDir, abs) {
return path.relative(path.resolve(taskDir), abs) || '.';
}
// 展示用路径:会话目录内保持相对(跟以前一致,省 token);
// 宽根模式下文件可能在会话目录外,那就回绝对路径——否则模型看到的是
// ../../../../tmp/x 这种既难读、又容易被它当成会话内路径去二次拼接的名字。
function dispPath(ctx, abs) {
const rel = relOf(ctx.taskDir, abs);
if (rel === '..' || rel.startsWith('..' + path.sep)) return abs;
return rel;
}
// ---------- 跨会话路径:@<会话id>/<rel>(历史只读,「看一眼」可过墙,「字节落地」只走 copy_path) ----------
// 背景:terminal 在远端 executor 容器里跑(compose:wrapper 启动即 unmount host-tasks),
// 别的会话目录在 shell 物理视图里根本不存在;core 进程内的文件工具又被 resolveInTask
@@ -459,12 +468,12 @@ async function toolCopyPath(ctx, args) {
}
let exists = true;
try { await fsp.stat(dst); } catch (_) { exists = false; }
if (exists) throw new Error('目标已存在, 拒绝覆盖: ' + relOf(ctx.taskDir, dst));
if (exists) throw new Error('目标已存在, 拒绝覆盖: ' + dispPath(ctx, dst));
await fsp.mkdir(path.dirname(dst), { recursive: true });
await fsp.cp(src, dst, { recursive: true });
recordFile(ctx, dst); // 文件表只记普通文件(目录自然跳过),供前端/微信附件展示
const sizeNote = budget ? ' (' + budget.files + ' files, ' + Math.round(budget.bytes / 1024) + ' KB)' : '';
return '已复制 ' + sp + ' -> ' + relOf(ctx.taskDir, dst) + sizeNote;
return '已复制 ' + sp + ' -> ' + dispPath(ctx, dst) + sizeNote;
}
async function toolWriteFile(ctx, args) {
@@ -480,7 +489,7 @@ async function toolWriteFile(ctx, args) {
await fsp.writeFile(abs, String(args.content), 'utf8');
recordFile(ctx, abs);
const nbytes = Buffer.byteLength(String(args.content), 'utf8');
const rel = relOf(ctx.taskDir, abs);
const rel = dispPath(ctx, abs);
// 区分新建/覆盖:「原 M 字节」是给模型的止损信号(盲覆盖大文件时能立刻察觉)。
return st
? '已覆盖文件 ' + rel + '(' + nbytes + ' 字节,原 ' + st.size + ' 字节)'
@@ -735,7 +744,7 @@ async function toolEditFile(ctx, args) {
? '(前 ' + applied + ' 处编辑已应用并保存,文件已变化,请重新 read_file 后再继续)'
: '(文件未改动)'));
}
return '已成功应用 ' + applied + ' 处编辑到 ' + relOf(ctx.taskDir, abs);
return '已成功应用 ' + applied + ' 处编辑到 ' + dispPath(ctx, abs);
}
// 对齐 Zed select_terminal_output_lines:head/tail 各自取行;同时给时中间空一行;不去重叠;0 合法。