新增本地端(local 模式):同一份代码直接跑在本机,不起 Docker / executor

后端只改两处,都靠 env 开关,不设置时服务器行为与 v2.5.0 完全一致:
- server.js:支持 HOST,本地注入 127.0.0.1(不设仍是 0.0.0.0)
- tools/executor.js:AGENT_FILE_SCOPE=workspace 把文件工具的根从会话目录放宽到
  workspace_root,并关掉 /tmp 重定向(本地 terminal 写的是真 /tmp,重定向会造成
  AI 自己写的东西自己读不到);recordFile 跳过会话外文件,避免附件表存 ../ 路径。
  路由层、@历史会话、mint_public_link 仍按会话目录校验,不变。

新增 local/:start.sh(探测 → 首次生成配置 → 装依赖 → 起 core +4 个 MCP → 守护重启)、
start.command(mac 双击)、config.example.yml(参考)、README.md。
能力按需:node 必需,ffmpeg 决定语音(靠 ASR_URL 注入)、python3 决定技能(靠
.runtime/skills 软链切换),两者都不写进配置——配置首次生成后永不覆盖,避免冲掉
用户在网页里配的模型与密钥。

另加 docs/local-mode.md:设计决定、验证状态与 mac 上的逐项验证清单(含重启按钮
守护、/tmp 一致性两个关键项)。
This commit is contained in:
2026-11-11 10:25:33 +08:00
parent 62e5902834
commit 8a5c8b1547
8 changed files with 909 additions and 19 deletions
+46
View File
@@ -0,0 +1,46 @@
# 本机 local 模式的配置参考。
#
# ⚠️ 这个文件不会被读取,只是给人看的样板:真正的配置由 local/start.sh 首次运行时
# 生成到 local/config.local.yml(含你选的工作目录与分配好的端口)。
# 想看自己机器上实际生成成什么样,启动一次后直接打开 local/config.local.yml。
#
# 字段含义与服务器版完全一致(见 app/config.example.yml);下面只列 local 模式实际用到的那部分。
port: 8090
# AI 的工作根。local 模式注入 AGENT_FILE_SCOPE=workspace 后,文件工具可读写这个目录下任何位置。
workspace_root: /Users/you/AgentWork
# SQLite(.agent.db)与启动 prompt dump。默认指到仓库里的 data/(已在 .gitignore)。
data_root: /path/to/agent/data
skills:
# 指向 local/.runtime/skills —— 启动脚本按「python3 是否可用」把它软链到真技能目录或空目录,
# 因此装不装 python3 都不需要改这里,改完重跑启动脚本即生效。
skills_root: /path/to/agent/local/.runtime/skills
# 留空:启动后到设置页添加平台与 API Key,再点「重启」(启动器负责把进程拉起来)。
platforms: []
log_level: info
mcp_servers:
# 四个同栈 MCP 由启动器在本机拉起,端口与 start.sh 里的常量对应。
# web_search 不需要任何密钥(内置免费后端);其余三个的上游参数在设置页卡片里填,
# 会写进对应条目的 headers。
- name: web_search
url: "http://127.0.0.1:3101/"
- name: image_task
url: "http://127.0.0.1:3102/mcp"
mode: skill
- name: video_task
url: "http://127.0.0.1:3103/mcp"
mode: skill
- name: asr
url: "http://127.0.0.1:3104/mcp"
mode: skill
# 例:填了这两项才算启用语音(缺 X-ASR-Base-Url 时 /api/asr/status 返回 enabled:false,麦克风自动隐藏)
# headers:
# Authorization: Bearer <key>
# X-ASR-Base-Url: "https://<host>/v1"
# X-ASR-Model: "whisper-1"