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
+6 -5
View File
@@ -25,19 +25,20 @@ platforms: []
log_level: info
mcp_servers:
# 四个同栈 MCP 由启动器在本机拉起,端口与 start.sh 里的常量对应。
# 四个同栈 MCP 由启动器在本机拉起,端口与 start.sh 里的默认值对应(8091~8094,
# 紧跟在 core 的 8090 后面;改 PORT 时别撞上这四个)。
# web_search 不需要任何密钥(内置免费后端);其余三个的上游参数在设置页卡片里填,
# 会写进对应条目的 headers。
- name: web_search
url: "http://127.0.0.1:3101/"
url: "http://127.0.0.1:8091/"
- name: image_task
url: "http://127.0.0.1:3102/mcp"
url: "http://127.0.0.1:8092/mcp"
mode: skill
- name: video_task
url: "http://127.0.0.1:3103/mcp"
url: "http://127.0.0.1:8093/mcp"
mode: skill
- name: asr
url: "http://127.0.0.1:3104/mcp"
url: "http://127.0.0.1:8094/mcp"
mode: skill
# 例:填了这两项才算启用语音(缺 X-ASR-Base-Url 时 /api/asr/status 返回 enabled:false,麦克风自动隐藏)
# headers: