Files
agent/app/README.md
T
2026-08-31 16:44:02 +08:00

61 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Agent 任务台(app)
按仓库根目录 `README.md` 设计方案实现的自用通用 Agent 系统。
## 目录结构
```
app/
├── server/
│ ├── server.js # 入口:装配配置/DB/总线/路由/静态资源
│ ├── config.js # config.yml 加载与校验
│ ├── db.js # SQLite(better-sqlite3,WAL)
│ ├── engine.js # 会话管理 + 模型池 FIFO 调度 + Agent 主循环
│ ├── llm.js # OpenAI 兼容上游流式调用(SSE 解析/工具分片合并)
│ ├── sse.js # 按会话分组的 SSE 事件总线
│ ├── routes/
│ │ ├── sessions.js # 会话 CRUD(10.1)
│ │ ├── messages.js # 消息/SSE/start/stop(10.2)
│ │ └── files.js # 文件上传/列表/下载/删除(10.3)
│ ├── tools/
│ │ ├── definitions.json # 14 个工具的 JSON Schema
│ │ └── executor.js # 13 个工具执行器(任务目录沙箱)
│ ├── templates/system-prompt.txt # System prompt 模板(直接编辑)
│ └── public/ # H5 前端(Vanilla JS + SSE)
├── test/ # mock 上游 + 端到端冒烟测试
├── config.example.yml
├── Dockerfile / docker-compose.yml
```
## 本地运行
```bash
cd app
npm install
cp config.example.yml config.yml # 修改 models(每个模型独立 url/api_key)
npm start # http://localhost:8080
```
## 测试
```bash
cd app
npm test # 启动 mock 上游 + 真实 server 的端到端冒烟测试(25 项断言)
```
## 提示词与工具 schema
System prompt 模板在 `server/templates/system-prompt.txt`,工具定义在 `server/tools/definitions.json`,直接修改这两个文件即可(改完重启服务)。
模板中的 `{动态日期}`、`{任务目录路径}`、`{模型显示名}` 占位符由 `llm.js` 在每次请求时替换。
## 关键行为速查
- 会话创建即尝试绑定空闲模型;无空闲则进全局队列 FIFO。
- 每轮 AI 完成(无工具调)或用户终止后释放模型;新消息重新入队。
- 规划阶段点「开始执行」:追加固定模板消息并切 execution。
- 终止:置位标志 + kill 进程组 + 中止模型流,不再发新请求。
- 所有文件路径解析到任务目录内,拒绝越界。
- web_search 调用内网 MCP 服务(config.web_search.url/authorization,默认已内置);如服务不可用会返回错误文本。
部署见 `../docs/DEPLOY.md`。