A1:link_skills 恒指向仓库 skills。原来没有 python3 就把 skills_root 指到空目录, 把所有技能一起藏掉——但技能不一定是 Python 的(office 是 SKILL.md + terminal 里调 officecli,跟 python3 无关),一刀切会误伤。而 run.py 类技能缺解释器时 skills.js 的 runEntry 对 spawn error 有处理,模型拿到「技能入口启动失败:spawn python3 ENOENT」, 干净可读,不需要靠藏清单避险。状态页/终端文案同步改成「python3 未安装:Python 技能 会失败,非 Python 技能不受影响」。 B2:env-local 允许模型装运行时,但必须先问用户;仍禁止 sudo 与装系统包。 macOS 的 /usr/bin/python3 是 CLT 桩,真装要走 brew 或官方安装器,耗时长且可能改 PATH / 要管理员权限,这种改动不能默许自主执行。 文档同步:docs/local-mode 4.4 重写(记录为什么不再切换)、4.13 补 B2 理由、 验证表该行标为待复测;local/README 的可选能力表与已知限制同步。
agent-core
agent 仓库的 core 服务:Express + SQLite + 静态 H5 前端。
对外能力、部署与配置见仓库根 ../README.md。
本地运行
cd app
npm install
cp config.example.yml config.yml
# 本地调试时把 workspace_root / data_root 改到仓库内可写目录
AGENT_CONFIG=./config.yml node server/server.js
默认监听 8090。platforms 可以留空,启动后到设置页添加模型并重启。
关键文件
| 文件 | 职责 |
|---|---|
server/server.js |
装配配置、DB、SSE、路由与启动顺序 |
server/engine.js |
会话、模型池、Agent 主循环、压缩、标题、日记收口 |
server/llm.js |
消息组装与上游流式调用 |
server/tools/executor.js |
内置工具与路径沙箱 |
server/tools/definitions.json |
内置工具 schema |
server/routes/ |
HTTP API |
server/public/ |
前端(无构建,按序加载脚本) |