Files
agent/app/README.md
T

68 lines
2.7 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 # 由 README 7.2 生成(npm run gen)
│ │ └── executor.js # 13 个工具执行器(任务目录沙箱)
│ ├── templates/system-prompt.txt # 由 README 7.1 生成
│ └── public/ # H5 前端(Vanilla JS + SSE)
├── test/ # mock 上游 + 端到端冒烟测试
├── scripts(在上层仓库根目录)gen-from-readme.js # README → 提示词/工具 schema
├── config.example.yml
├── Dockerfile / docker-compose.yml
```
## 本地运行
```bash
cd app
npm install
cp config.example.yml config.yml # 修改 upstream_url / models
npm start # http://localhost:8080
```
## 测试
```bash
cd app
npm test # 启动 mock 上游 + 真实 server 的端到端冒烟测试(25 项断言)
```
## 从 README 重新生成提示词与工具 schema
README 是 system prompt 与工具 JSON schema 的唯一事实来源(与 Zed 逐字一致以利用前缀缓存):
```bash
cd app
npm run gen # 读 ../README.md → templates/system-prompt.txt + tools/definitions.json
```
修改 `README.md` 第七章节后必须重跑 `npm run gen` 并重启服务。
## 关键行为速查
- 会话创建即尝试绑定空闲模型;无空闲则进全局队列 FIFO。
- 每轮 AI 完成(无工具调)或用户终止后释放模型;新消息重新入队。
- 规划阶段点「开始执行」:追加固定模板消息并切 execution。
- 终止:置位标志 + kill 进程组 + 中止模型流,不再发新请求。
- 所有文件路径解析到任务目录内,拒绝越界。
- web_search 调用内网 MCP 服务(config.web_search.url/authorization,默认已内置);如服务不可用会返回错误文本。
部署见 `../docs/DEPLOY.md`。