本地没有 agent-executor-init,技能的 requirements.txt 从来没人读: document-photo-to-pdf(numpy/Pillow/pymupdf)与 image-process(Pillow) 在本机只是碰巧用户的 python 里已经装了。 - 两个技能补 requirements.txt,一律不写版本号:服务端 init 用 pip install --no-index --dry-run 探测,pin 到与镜像不同的版本会让探测失败, 反而往 skills/deps 装一份旧的(PYTHONPATH 优先级高于系统 site-packages) - start.sh 起 core 时注入 AGENT_SKILLS_DEPS(该目录本来就在 PYTHONPATH 里), 把路径交给模型;terminal 与技能子进程都继承 core 的 env,装完下次运行即生效 - env-local.txt 把「永远不要自己装任何东西」换成「缺包时 --target 装进共享依赖层, 别动系统 Python」。用 --target 是因为 pip 对它的 PEP 668 拦截明确豁免, Homebrew 那种 externally-managed 解释器也能装 - 文档同步:local/README 已知限制、docs/local-mode.md 新增 4.13 记录取舍 服务端不受影响:这三行在 executor 镜像里都已满足(实测 --no-index --dry-run 均 exit 0),init 只写一个 gitignore 里的 .deps_installed 就跳过。
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/ |
前端(无构建,按序加载脚本) |