1.7 KiB
1.7 KiB
agent-core
agent 仓库的 core 服务:Express + SQLite + 静态 H5 前端。
对外能力、部署与配置见仓库根 ../README.md;内部结构、数据模型与修改约束见 ../docs/ARCHITECTURE.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 可以留空,启动后到设置页添加模型并重启。
测试
npm test
端到端冒烟测试会启动 mock 模型上游(:9999)和真实 server(:8099),测试数据隔离在 test/tmp。
注意:
test/smoke.js仍有旧断言——排队已从运行期移除,且GET /api/sessions/:id不再直接返回role=tool行(改为按需加载)。当前会在[2] 工具调用与[5] 排队调度失败;修改相关路径时先同步测试,不要把它当作全绿基线。
其他测试:
node test/remote-exec.test.js # 远端 executor 集成
node test/trim-smoke.js # 历史裁剪
node test/dep-check.js # 依赖完整性
关键文件
| 文件 | 职责 |
|---|---|
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/ |
前端(无构建,按序加载脚本) |
修改前先读架构文档的「修改时必须遵守的约束」一节。