feat: bootstrap boss control plane prototype
This commit is contained in:
Codex
5
.gitignore
vendored
Normal file
5
.gitignore
vendored
Normal file
@@ -0,0 +1,5 @@
|
||||
node_modules
|
||||
dist
|
||||
.boss-data
|
||||
npm-debug.log*
|
||||
|
||||
63
README.md
Normal file
63
README.md
Normal file
@@ -0,0 +1,63 @@
|
||||
# Boss
|
||||
|
||||
Boss 是一个面向多设备开发协作的 agent control plane。
|
||||
|
||||
它的目标是让用户通过对话入口或独立控制台，持续管理多台 Windows、Mac 上的编码代理，支持任务拆分、实时进度、需求变更、审批和审计。
|
||||
|
||||
## 当前状态
|
||||
|
||||
当前仓库已经完成第一轮产品设计文档：
|
||||
|
||||
- [文档总览](./docs/README.md)
|
||||
- [竞品对比](./docs/competitor-comparison.md)
|
||||
- [系统架构](./docs/system-architecture.md)
|
||||
- [MVP 功能清单](./docs/mvp-feature-plan.md)
|
||||
- [技术选型](./docs/technical-selection.md)
|
||||
- [消息协议与状态机](./docs/message-protocol-and-state-machine.md)
|
||||
- [实施路线图](./docs/implementation-roadmap.md)
|
||||
|
||||
并且已经补入首版可运行原型：
|
||||
|
||||
- Fastify API
|
||||
- 文件持久化状态存储
|
||||
- SSE 实时事件流
|
||||
- Web 控制台
|
||||
- `boss-worker` 模拟执行器
|
||||
|
||||
## 当前推荐方向
|
||||
|
||||
- 主控面：Web 为主，聊天入口为辅
|
||||
- Manager：Codex
|
||||
- 设备侧 worker：Codex CLI + Claude Code
|
||||
- 工具层：MCP
|
||||
- 调度：持久队列或工作流引擎
|
||||
|
||||
## 下一步
|
||||
|
||||
建议直接开始：
|
||||
|
||||
1. 建立 Web 控制台和后端骨架
|
||||
2. 实现 `boss-worker` 注册与心跳
|
||||
3. 打通会话、任务树和子任务分发
|
||||
4. 接入审批和中途重规划
|
||||
|
||||
## 本地运行
|
||||
|
||||
```bash
|
||||
npm install
|
||||
npm run dev
|
||||
```
|
||||
|
||||
浏览器打开：
|
||||
|
||||
```bash
|
||||
http://127.0.0.1:43210
|
||||
```
|
||||
|
||||
另开终端启动 worker：
|
||||
|
||||
```bash
|
||||
npm run worker -- --name win-a --os windows --capability terminal --capability browser
|
||||
npm run worker -- --name win-b --os windows --capability terminal --capability test
|
||||
npm run worker -- --name mac-a --os macos --capability terminal --capability test --capability browser
|
||||
```
|
||||
42
docs/README.md
Normal file
42
docs/README.md
Normal file
@@ -0,0 +1,42 @@
|
||||
# Boss 项目设计文档
|
||||
|
||||
更新日期：2026-03-23
|
||||
|
||||
## 文档导航
|
||||
|
||||
- [竞品对比](./competitor-comparison.md)
|
||||
- [系统架构](./system-architecture.md)
|
||||
- [MVP 功能清单](./mvp-feature-plan.md)
|
||||
- [技术选型](./technical-selection.md)
|
||||
- [消息协议与状态机](./message-protocol-and-state-machine.md)
|
||||
- [实施路线图](./implementation-roadmap.md)
|
||||
|
||||
## 项目一句话定义
|
||||
|
||||
`Boss` 是一个面向多设备开发协作的 agent control plane。
|
||||
|
||||
它让用户通过对话入口或独立 App，持续管理多台 Windows、Mac 上的编码代理，支持：
|
||||
|
||||
- 协同开发
|
||||
- 独立开发
|
||||
- 子任务拆分
|
||||
- 实时进度播报
|
||||
- 中途变更需求
|
||||
- 审批高风险操作
|
||||
- 审计和会话恢复
|
||||
|
||||
## 当前建议的产品定位
|
||||
|
||||
- 不是单一编码助手
|
||||
- 不是单机 IDE 插件
|
||||
- 不是单纯云端沙箱代理
|
||||
- 而是“主控端 + 多设备 worker + 对话式任务系统”
|
||||
|
||||
## 建议阅读顺序
|
||||
|
||||
1. [竞品对比](./competitor-comparison.md)
|
||||
2. [系统架构](./system-architecture.md)
|
||||
3. [MVP 功能清单](./mvp-feature-plan.md)
|
||||
4. [技术选型](./technical-selection.md)
|
||||
5. [消息协议与状态机](./message-protocol-and-state-machine.md)
|
||||
6. [实施路线图](./implementation-roadmap.md)
|
||||
216
docs/competitor-comparison.md
Normal file
216
docs/competitor-comparison.md
Normal file
@@ -0,0 +1,216 @@
|
||||
# 多设备编码代理主控平台竞品对比
|
||||
|
||||
更新日期：2026-03-23
|
||||
|
||||
## 目标定义
|
||||
|
||||
本对比只关注和下面目标相关的产品或框架：
|
||||
|
||||
- 主控端统一管理多个编码代理
|
||||
- 支持多入口触发，如聊天工具、Web、IDE、CLI
|
||||
- 能把任务拆成子任务并持续回传进度
|
||||
- 最好能兼容或借鉴本地设备 worker，而不只是云沙箱
|
||||
|
||||
不纳入重点范围的产品：
|
||||
|
||||
- 只做本地单机结对编程
|
||||
- 只做代码补全
|
||||
- 只做通用办公 agent，不强调编码任务编排
|
||||
|
||||
## 一页结论
|
||||
|
||||
- 最接近企业级成品中控：Devin、Factory
|
||||
- 最适合搬运和二次开发：OpenHands
|
||||
- 最适合作为主账号大脑：OpenAI Codex
|
||||
- 最适合作为设备侧 worker：Claude Code、Codex CLI、Aider、Cline、Roo Code
|
||||
- 最适合作为协议层：MCP
|
||||
- 最适合作为 agent-to-agent 通信层：A2A
|
||||
|
||||
## 竞品对比表
|
||||
|
||||
| 产品/方案 | 类型 | 中控能力 | 子任务/多代理 | 多设备本地 worker 适配 | 聊天入口 | 自建/二开友好度 | 适合借鉴的点 | 主要短板 | 结论 |
|
||||
|---|---|---|---|---|---|---|---|---|---|
|
||||
| Devin Enterprise | 商业成品 | 很强 | 强 | 弱到中 | 强 | 低 | 企业级组织管理、RBAC、API、调度、外部集成 | 更偏云环境，不是为本地多设备编队设计 | 可参考“成品控制台” |
|
||||
| OpenAI Codex | 商业成品 + 平台能力 | 强 | 强 | 中 | 强 | 中 | 主账号统一对话、多入口、云并行任务 | 不是现成的多物理设备 fleet 管理器 | 可作为 manager brain |
|
||||
| Factory | 商业成品 | 很强 | 很强 | 中 | 很强 | 低到中 | Subagents、Missions、多入口控制 | 生态较新，闭源较重 | 值得重点借鉴交互与控制面 |
|
||||
| OpenHands Cloud / SDK | 开源平台 + 托管服务 | 强 | 强 | 中到强 | 强 | 很高 | Cloud UI、SDK、远程沙箱、权限、可自建 | 仍需自己补产品化细节 | 最适合做底座 |
|
||||
| GitHub Copilot coding agent | 商业成品 | 中到强 | 中 | 弱 | 中 | 低 | Issue/PR 驱动、GitHub 闭环、组织策略 | 太 GitHub-centric | 只适合借鉴局部流程 |
|
||||
| Cursor Background Agents | 商业成品 | 中 | 中 | 中 | 强 | 低 | 远程 agent + Slack 入口 | 更偏账号级，不像团队总控台 | 值得借鉴轻量远程协作 |
|
||||
| Claude Code | 本地 agent | 弱 | 中 | 很强 | 中 | 中 | 本地终端执行、开发体验强 | local-first，不是中控台 | 非常适合当 worker |
|
||||
| Sourcegraph + Batch Changes + MCP | 平台底座 | 中 | 弱到中 | 弱 | 弱 | 中 | 批量改仓、代码搜索、分析能力 | 不是 agent control plane | 可作为代码情报层 |
|
||||
| LangGraph | 编排框架 | 中到强 | 很强 | 中 | 弱 | 很高 | 状态机、工作流、持久状态 | UI、权限、执行层都要自建 | 适合完全自研时使用 |
|
||||
| AutoGen | 多代理框架 | 中 | 很强 | 中 | 弱 | 高 | 多代理协作范式成熟 | 产品化要自己做 | 适合研究协作逻辑 |
|
||||
| CrewAI | 工作流框架 | 中 | 很强 | 中 | 弱 | 中到高 | Flow、观测、流程编排 | 编码执行层不够强 | 可借鉴业务流程层 |
|
||||
| MCP | 工具协议 | 不适用 | 不适用 | 强 | 不适用 | 很高 | 工具统一接入标准 | 不是 agent 调度协议 | 必须纳入架构 |
|
||||
| A2A | agent 通信协议 | 不适用 | 强 | 强 | 不适用 | 高 | 跨 agent 通信和任务协作 | 生态仍在发展 | 建议前瞻纳入 |
|
||||
|
||||
## 重点产品拆解
|
||||
|
||||
### 1. Devin Enterprise
|
||||
|
||||
适合借鉴：
|
||||
|
||||
- 企业级组织、权限、审计、API
|
||||
- 从 Slack、Teams、GitHub、Linear、Jira 等入口发起任务
|
||||
- 定时 session 和共享工作流
|
||||
|
||||
不完全适合直接照搬的点：
|
||||
|
||||
- 更偏云端 Devin machine
|
||||
- 对本地 Windows/Mac 设备级 agent 编队支持不是它的核心卖点
|
||||
|
||||
适合你们的参考角色：
|
||||
|
||||
- 作为“企业中控台形态”参考
|
||||
|
||||
来源：
|
||||
|
||||
- https://docs.devin.ai/enterprise/get-started
|
||||
- https://docs.devin.ai/release-notes
|
||||
|
||||
### 2. OpenAI Codex
|
||||
|
||||
适合借鉴：
|
||||
|
||||
- 主账号统一发起和跟踪任务
|
||||
- 跨 App、CLI、IDE、GitHub、Slack、Linear 协作
|
||||
- 云端并行任务和账户级工作台体验
|
||||
|
||||
不完全适合直接照搬的点：
|
||||
|
||||
- 更像围绕账户和任务的 agent 工作台
|
||||
- 不是专门面向“多台真实开发设备”的设备编排系统
|
||||
|
||||
适合你们的参考角色：
|
||||
|
||||
- 作为 manager brain
|
||||
- 作为主对话入口和任务拆分层
|
||||
|
||||
来源：
|
||||
|
||||
- https://openai.com/index/codex-now-generally-available/
|
||||
- https://help.openai.com/en/articles/11369540-codex-in-chatgpt
|
||||
|
||||
### 3. Factory
|
||||
|
||||
适合借鉴：
|
||||
|
||||
- Missions 和 Custom Droids 的任务拆解思路
|
||||
- Slack、Teams、GitHub App、IDE、CLI、Web 的多入口控制
|
||||
- 远程和本地结合的控制面叙事
|
||||
|
||||
不完全适合直接照搬的点：
|
||||
|
||||
- 闭源较重
|
||||
- 需要较多逆向产品层理解，难直接搬运技术实现
|
||||
|
||||
适合你们的参考角色：
|
||||
|
||||
- 作为“多入口 + 子代理协同”交互范式参考
|
||||
|
||||
来源：
|
||||
|
||||
- https://docs.factory.ai/
|
||||
- https://docs.factory.ai/user-guides/droids/creating-custom-droids
|
||||
|
||||
### 4. OpenHands Cloud / SDK
|
||||
|
||||
适合借鉴：
|
||||
|
||||
- OpenHands SDK 已经是 CLI 和 Cloud 的底层引擎
|
||||
- 有 Cloud UI、Cloud API、权限、预算、远程沙箱
|
||||
- 自建和二开空间大
|
||||
|
||||
不完全适合直接照搬的点：
|
||||
|
||||
- 如果要做极强的多设备本地 worker 编排，仍需扩展 agent server 和 worker registry
|
||||
|
||||
适合你们的参考角色：
|
||||
|
||||
- 最优先底座候选
|
||||
|
||||
来源：
|
||||
|
||||
- https://docs.openhands.dev/sdk
|
||||
- https://docs.openhands.dev/usage/cloud/cloud-ui
|
||||
|
||||
### 5. Claude Code
|
||||
|
||||
适合借鉴：
|
||||
|
||||
- 本地执行体验强
|
||||
- 非常适合挂在 Windows/Mac 上做 worker
|
||||
- 终端型编码任务执行成熟
|
||||
|
||||
不完全适合直接照搬的点：
|
||||
|
||||
- 官方定位是 local-first，不是统一云端中控
|
||||
|
||||
适合你们的参考角色：
|
||||
|
||||
- 设备侧 worker 执行器
|
||||
|
||||
来源：
|
||||
|
||||
- https://claude.com/product/claude-code
|
||||
|
||||
## 我们的推荐路线
|
||||
|
||||
### 路线 A：最快做出产品
|
||||
|
||||
- 底座：OpenHands SDK
|
||||
- Manager：Codex
|
||||
- 设备侧 worker：Claude Code / Codex CLI
|
||||
- 对话入口：Web 为主，Slack/Telegram 为辅
|
||||
|
||||
适合：
|
||||
|
||||
- 先把真实可用的多设备协作跑起来
|
||||
|
||||
### 路线 B：完全自研控制面
|
||||
|
||||
- 编排：LangGraph 或 AutoGen
|
||||
- Manager：Codex
|
||||
- 工具层：MCP
|
||||
- agent 协作层：A2A
|
||||
- 设备侧 worker：你们自己的 daemon，内部再调 Claude Code / Codex CLI
|
||||
|
||||
适合：
|
||||
|
||||
- 你们希望最终拥有自己的协议、调度和产品层壁垒
|
||||
|
||||
### 路线 C：先验证，再重构
|
||||
|
||||
- 第一阶段用 OpenHands 风格快速拼装 MVP
|
||||
- 第二阶段把设备注册、任务队列、审计、聊天入口收回自研
|
||||
|
||||
适合：
|
||||
|
||||
- 你们既想快，又不想被单一底座绑死
|
||||
|
||||
## 对你这个产品最关键的判断
|
||||
|
||||
如果目标是：
|
||||
|
||||
- 主账号持续对话
|
||||
- 实时调整需求
|
||||
- 控制多台真实 Windows/Mac
|
||||
- 支持协同开发和独立开发两种模式
|
||||
|
||||
那么最好的产品结构不是“一个超强 agent”，而是：
|
||||
|
||||
- 一个 control plane
|
||||
- 一个 manager agent
|
||||
- 多个设备侧 worker
|
||||
- 一套可中断、可续跑、可审计的任务系统
|
||||
|
||||
也就是说，真正应该对标的不是“谁最会写代码”，而是“谁最会调度一群会写代码的代理”。
|
||||
|
||||
## 下一步建议
|
||||
|
||||
完成第 1 项后，建议继续做：
|
||||
|
||||
1. 系统架构图
|
||||
2. MVP 功能清单
|
||||
3. 技术选型建议
|
||||
4. 消息协议与任务状态机
|
||||
174
docs/implementation-roadmap.md
Normal file
174
docs/implementation-roadmap.md
Normal file
@@ -0,0 +1,174 @@
|
||||
# Boss 实施路线图
|
||||
|
||||
更新日期：2026-03-23
|
||||
|
||||
## 路线目标
|
||||
|
||||
把 Boss 从概念验证推进到可长期迭代的产品原型。
|
||||
|
||||
## 阶段划分
|
||||
|
||||
### Phase 0：项目底座
|
||||
|
||||
目标：
|
||||
|
||||
- 建立基础仓库结构
|
||||
- 搭建前后端骨架
|
||||
- 建立数据库和基础实体
|
||||
|
||||
完成标准：
|
||||
|
||||
- 有 Web 控制台壳子
|
||||
- 有后端 API 壳子
|
||||
- 有 Postgres 和 Redis
|
||||
- 能创建 session
|
||||
|
||||
### Phase 1：多设备接入
|
||||
|
||||
目标：
|
||||
|
||||
- 让 2 台 Windows 和 1 台 Mac 成为可调度 worker
|
||||
|
||||
完成标准：
|
||||
|
||||
- worker 可以注册
|
||||
- worker 有心跳
|
||||
- 控制台能看到在线状态
|
||||
- 可以手工下发简单任务
|
||||
|
||||
### Phase 2：对话驱动任务拆分
|
||||
|
||||
目标：
|
||||
|
||||
- 用户一句话创建任务
|
||||
- manager 生成任务树
|
||||
|
||||
完成标准：
|
||||
|
||||
- 对话生成主任务和子任务
|
||||
- 子任务可以指派到不同 worker
|
||||
- UI 能看到任务树
|
||||
|
||||
### Phase 3：执行、事件和审批
|
||||
|
||||
目标：
|
||||
|
||||
- worker 真正执行开发动作
|
||||
- 中途回传结构化进度
|
||||
- 高风险动作需要审批
|
||||
|
||||
完成标准：
|
||||
|
||||
- worker 能跑 git、terminal、测试
|
||||
- 进度能在 UI 和聊天入口显示
|
||||
- 审批可以打断并恢复流程
|
||||
|
||||
### Phase 4：中途变更需求和重规划
|
||||
|
||||
目标：
|
||||
|
||||
- 支持用户实时改变需求
|
||||
- manager 能生成新计划
|
||||
|
||||
完成标准：
|
||||
|
||||
- 用户可在原会话继续说话
|
||||
- 系统可 pause/cancel/replan
|
||||
- 能展示计划差异
|
||||
|
||||
### Phase 5：协同开发增强
|
||||
|
||||
目标：
|
||||
|
||||
- 支持研究、实现、测试分工协作
|
||||
|
||||
完成标准：
|
||||
|
||||
- 一个任务可以拆成研究和实现链路
|
||||
- 子任务之间可引用共享上下文
|
||||
- manager 能输出阶段性总结
|
||||
|
||||
## 推荐开发顺序
|
||||
|
||||
1. 建库和实体
|
||||
2. worker daemon
|
||||
3. Web 控制台基础页
|
||||
4. manager 集成
|
||||
5. 子任务调度
|
||||
6. 事件流和实时订阅
|
||||
7. 审批
|
||||
8. 聊天入口
|
||||
9. 需求变更与重规划
|
||||
|
||||
## 每阶段产物
|
||||
|
||||
### Phase 0 产物
|
||||
|
||||
- API skeleton
|
||||
- DB schema
|
||||
- 基础 UI
|
||||
|
||||
### Phase 1 产物
|
||||
|
||||
- `boss-worker`
|
||||
- worker registry
|
||||
- 设备管理页
|
||||
|
||||
### Phase 2 产物
|
||||
|
||||
- manager planning adapter
|
||||
- task tree UI
|
||||
- assignment service
|
||||
|
||||
### Phase 3 产物
|
||||
|
||||
- executor adapter
|
||||
- event stream
|
||||
- approval flow
|
||||
|
||||
### Phase 4 产物
|
||||
|
||||
- plan diff engine
|
||||
- pause/resume/cancel controls
|
||||
- session replay
|
||||
|
||||
### Phase 5 产物
|
||||
|
||||
- collaborative mode
|
||||
- shared artifacts
|
||||
- richer progress summaries
|
||||
|
||||
## 里程碑定义
|
||||
|
||||
### 里程碑 A：可看见
|
||||
|
||||
- 能看到 3 台机器在线
|
||||
- 能创建任务
|
||||
|
||||
### 里程碑 B：可调度
|
||||
|
||||
- 能把任务分发给不同设备
|
||||
- 能看到执行状态
|
||||
|
||||
### 里程碑 C：可对话改需求
|
||||
|
||||
- 执行中可重规划
|
||||
- 任务不会失控
|
||||
|
||||
### 里程碑 D：可协同开发
|
||||
|
||||
- 多台设备能并行分工
|
||||
- 主控端能统一总结
|
||||
|
||||
## 当前最建议的首版交付
|
||||
|
||||
如果你现在就准备开工，建议首版目标定成：
|
||||
|
||||
- Web 控制台
|
||||
- 3 台 worker
|
||||
- manager 拆分最多 3 个子任务
|
||||
- worker 支持 git、terminal、test
|
||||
- 支持审批
|
||||
- 支持需求变更后重规划
|
||||
|
||||
做到这里，这个产品就已经不是 demo，而是一个真正可试用的原型。
|
||||
419
docs/message-protocol-and-state-machine.md
Normal file
419
docs/message-protocol-and-state-machine.md
Normal file
@@ -0,0 +1,419 @@
|
||||
# Boss 消息协议与任务状态机
|
||||
|
||||
更新日期：2026-03-23
|
||||
|
||||
## 设计目标
|
||||
|
||||
这份文档定义 Boss 内部最小可用消息模型，确保系统支持：
|
||||
|
||||
- 实时对话
|
||||
- 子任务拆分
|
||||
- 中途改需求
|
||||
- 暂停和恢复
|
||||
- 审批
|
||||
- 事件回放
|
||||
|
||||
## 核心原则
|
||||
|
||||
- 所有关键变化都事件化
|
||||
- 会话状态来自事件流和状态快照
|
||||
- 用户消息和系统动作统一进入同一条项目时间线
|
||||
- worker 回传必须结构化，不能只传纯文本
|
||||
|
||||
## 会话模型
|
||||
|
||||
### 层级
|
||||
|
||||
```text
|
||||
Project Session
|
||||
-> Conversation Thread
|
||||
-> Task Tree
|
||||
-> Worker Assignments
|
||||
-> Approval Requests
|
||||
-> Artifacts
|
||||
```
|
||||
|
||||
### 对象定义
|
||||
|
||||
#### project_session
|
||||
|
||||
```json
|
||||
{
|
||||
"id": "ps_001",
|
||||
"title": "修复登录与缓存问题",
|
||||
"status": "active",
|
||||
"active_objective": "先定位根因，再决定是否修改代码",
|
||||
"created_at": "2026-03-23T12:00:00Z"
|
||||
}
|
||||
```
|
||||
|
||||
#### message
|
||||
|
||||
```json
|
||||
{
|
||||
"id": "msg_001",
|
||||
"session_id": "ps_001",
|
||||
"role": "user",
|
||||
"channel": "web",
|
||||
"content": "先排查登录失败，不要急着改代码",
|
||||
"created_at": "2026-03-23T12:00:05Z"
|
||||
}
|
||||
```
|
||||
|
||||
#### task
|
||||
|
||||
```json
|
||||
{
|
||||
"id": "task_001",
|
||||
"session_id": "ps_001",
|
||||
"parent_task_id": null,
|
||||
"title": "定位登录失败根因",
|
||||
"kind": "investigation",
|
||||
"status": "planning",
|
||||
"priority": "high",
|
||||
"risk_level": "medium"
|
||||
}
|
||||
```
|
||||
|
||||
#### worker_assignment
|
||||
|
||||
```json
|
||||
{
|
||||
"id": "wa_001",
|
||||
"task_id": "task_002",
|
||||
"worker_id": "worker_win_a",
|
||||
"status": "assigned"
|
||||
}
|
||||
```
|
||||
|
||||
## 事件模型
|
||||
|
||||
### 统一事件格式
|
||||
|
||||
```json
|
||||
{
|
||||
"id": "evt_001",
|
||||
"session_id": "ps_001",
|
||||
"task_id": "task_002",
|
||||
"source": "worker",
|
||||
"type": "task.step.started",
|
||||
"timestamp": "2026-03-23T12:10:00Z",
|
||||
"payload": {
|
||||
"step": "run_tests",
|
||||
"summary": "开始运行登录相关测试"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
字段说明：
|
||||
|
||||
- `source` 可取 `user`, `manager`, `system`, `worker`
|
||||
- `type` 是事件名
|
||||
- `payload` 是结构化内容
|
||||
|
||||
### 推荐事件类型
|
||||
|
||||
#### 会话事件
|
||||
|
||||
- `session.created`
|
||||
- `session.objective.updated`
|
||||
- `session.message.added`
|
||||
|
||||
#### 规划事件
|
||||
|
||||
- `plan.created`
|
||||
- `plan.updated`
|
||||
- `plan.diff.generated`
|
||||
|
||||
#### 任务事件
|
||||
|
||||
- `task.created`
|
||||
- `task.assigned`
|
||||
- `task.started`
|
||||
- `task.progress`
|
||||
- `task.blocked`
|
||||
- `task.paused`
|
||||
- `task.resumed`
|
||||
- `task.cancelled`
|
||||
- `task.completed`
|
||||
- `task.failed`
|
||||
|
||||
#### worker 事件
|
||||
|
||||
- `worker.heartbeat`
|
||||
- `worker.capabilities.updated`
|
||||
- `worker.assignment.accepted`
|
||||
- `worker.assignment.rejected`
|
||||
|
||||
#### 执行步骤事件
|
||||
|
||||
- `task.step.started`
|
||||
- `task.step.finished`
|
||||
- `task.step.failed`
|
||||
- `tool.call.requested`
|
||||
- `tool.call.finished`
|
||||
|
||||
#### 审批事件
|
||||
|
||||
- `approval.requested`
|
||||
- `approval.approved`
|
||||
- `approval.rejected`
|
||||
|
||||
## 任务状态机
|
||||
|
||||
### 主状态机
|
||||
|
||||
```mermaid
|
||||
stateDiagram-v2
|
||||
[*] --> planning
|
||||
planning --> queued
|
||||
queued --> assigned
|
||||
assigned --> running
|
||||
running --> blocked
|
||||
running --> paused
|
||||
running --> waiting_approval
|
||||
running --> completed
|
||||
running --> failed
|
||||
running --> cancelled
|
||||
blocked --> running
|
||||
paused --> running
|
||||
waiting_approval --> running
|
||||
waiting_approval --> cancelled
|
||||
failed --> queued
|
||||
```
|
||||
|
||||
### 状态说明
|
||||
|
||||
| 状态 | 含义 |
|
||||
|---|---|
|
||||
| `planning` | manager 正在生成任务计划 |
|
||||
| `queued` | 已创建，等待调度 |
|
||||
| `assigned` | 已分配给某个 worker |
|
||||
| `running` | worker 正在执行 |
|
||||
| `blocked` | 因外部条件缺失而卡住 |
|
||||
| `paused` | 被用户或系统暂停 |
|
||||
| `waiting_approval` | 等待用户审批 |
|
||||
| `completed` | 成功完成 |
|
||||
| `failed` | 执行失败 |
|
||||
| `cancelled` | 被取消 |
|
||||
|
||||
## 需求变更协议
|
||||
|
||||
### 为什么需要单独协议
|
||||
|
||||
用户在对话里改需求，不应该等于简单新增一句聊天消息。系统需要知道这条消息是否会：
|
||||
|
||||
- 改变当前目标
|
||||
- 废弃现有子任务
|
||||
- 新增任务
|
||||
- 触发审批
|
||||
|
||||
### 建议流程
|
||||
|
||||
1. 用户消息进入 session
|
||||
2. manager 判断该消息是否属于 `objective change`
|
||||
3. 如果是，生成 `plan.diff`
|
||||
4. Task Service 根据 diff 执行状态迁移
|
||||
|
||||
### plan diff 示例
|
||||
|
||||
```json
|
||||
{
|
||||
"session_id": "ps_001",
|
||||
"change_reason": "用户要求先修接口重试，不处理缓存",
|
||||
"cancel_tasks": ["task_cache_001"],
|
||||
"pause_tasks": ["task_ui_003"],
|
||||
"continue_tasks": ["task_api_002"],
|
||||
"create_tasks": [
|
||||
{
|
||||
"title": "修复接口重试逻辑",
|
||||
"kind": "implementation",
|
||||
"priority": "high"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
## 审批协议
|
||||
|
||||
### 审批请求格式
|
||||
|
||||
```json
|
||||
{
|
||||
"id": "apr_001",
|
||||
"session_id": "ps_001",
|
||||
"task_id": "task_009",
|
||||
"kind": "dangerous_command",
|
||||
"summary": "准备执行 rm -rf build-cache",
|
||||
"risk_level": "high",
|
||||
"status": "pending"
|
||||
}
|
||||
```
|
||||
|
||||
### 审批动作
|
||||
|
||||
支持：
|
||||
|
||||
- `approve`
|
||||
- `reject`
|
||||
- `approve_once`
|
||||
- `approve_for_session`
|
||||
|
||||
MVP 建议只做：
|
||||
|
||||
- `approve`
|
||||
- `reject`
|
||||
|
||||
## Worker 协议
|
||||
|
||||
### worker 注册
|
||||
|
||||
```json
|
||||
{
|
||||
"worker_id": "worker_mac_001",
|
||||
"hostname": "mac-studio",
|
||||
"os": "macos",
|
||||
"shell": "zsh",
|
||||
"capabilities": [
|
||||
"git",
|
||||
"terminal",
|
||||
"playwright",
|
||||
"xcode"
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
### heartbeat
|
||||
|
||||
```json
|
||||
{
|
||||
"worker_id": "worker_mac_001",
|
||||
"status": "idle",
|
||||
"current_task_id": null,
|
||||
"load": 0.25,
|
||||
"timestamp": "2026-03-23T12:15:00Z"
|
||||
}
|
||||
```
|
||||
|
||||
### 任务执行请求
|
||||
|
||||
```json
|
||||
{
|
||||
"task_id": "task_102",
|
||||
"session_id": "ps_001",
|
||||
"workspace": {
|
||||
"repo": "git@github.com:org/repo.git",
|
||||
"branch": "boss/task-102",
|
||||
"worktree_path": "/workers/worktrees/task-102"
|
||||
},
|
||||
"execution_mode": "independent",
|
||||
"goal": "排查登录失败，输出根因和修复建议",
|
||||
"constraints": [
|
||||
"先不要改代码",
|
||||
"优先跑测试和读日志"
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
## 进度摘要协议
|
||||
|
||||
worker 和 manager 都不应该只回长文本。
|
||||
|
||||
推荐维护一份结构化摘要：
|
||||
|
||||
```json
|
||||
{
|
||||
"task_id": "task_102",
|
||||
"summary": "已定位到接口重试在 401 时进入死循环",
|
||||
"progress_percent": 60,
|
||||
"current_step": "analyze_retry_logic",
|
||||
"next_step": "补充最小修复方案并跑测试",
|
||||
"risk": "medium"
|
||||
}
|
||||
```
|
||||
|
||||
这个结构化摘要可以直接喂给：
|
||||
|
||||
- Web 控制台右侧面板
|
||||
- 聊天入口状态播报
|
||||
- manager 汇总器
|
||||
|
||||
## 协同开发协议
|
||||
|
||||
### 模式字段
|
||||
|
||||
任务可声明：
|
||||
|
||||
- `independent`
|
||||
- `collaborative`
|
||||
- `research_only`
|
||||
|
||||
### collaborative 模式下增加字段
|
||||
|
||||
```json
|
||||
{
|
||||
"shared_context_refs": [
|
||||
"artifact_001",
|
||||
"task_202.summary"
|
||||
],
|
||||
"handoff_expected": true
|
||||
}
|
||||
```
|
||||
|
||||
用于支持：
|
||||
|
||||
- 研究任务把结论交给实现任务
|
||||
- 后端任务把 API 变更交给前端任务
|
||||
|
||||
## UI 实时订阅模型
|
||||
|
||||
控制台建议订阅三个流：
|
||||
|
||||
- `session_feed`
|
||||
- `task_feed`
|
||||
- `worker_feed`
|
||||
|
||||
这样可以避免一个超大流承载所有内容。
|
||||
|
||||
## 失败处理策略
|
||||
|
||||
### 可重试失败
|
||||
|
||||
- 网络抖动
|
||||
- worker 短时离线
|
||||
- tool call 超时
|
||||
|
||||
### 不可重试失败
|
||||
|
||||
- 权限不足
|
||||
- 任务目标冲突
|
||||
- 用户明确取消
|
||||
|
||||
### 推荐策略
|
||||
|
||||
- 每个任务记录 `retry_count`
|
||||
- 重试必须带原因
|
||||
- 多次失败要自动升级为 `blocked`
|
||||
|
||||
## MVP 最小协议集
|
||||
|
||||
第一版只需要支持这些事件：
|
||||
|
||||
- `session.message.added`
|
||||
- `plan.created`
|
||||
- `task.created`
|
||||
- `task.assigned`
|
||||
- `task.started`
|
||||
- `task.progress`
|
||||
- `task.paused`
|
||||
- `task.cancelled`
|
||||
- `task.completed`
|
||||
- `task.failed`
|
||||
- `worker.heartbeat`
|
||||
- `approval.requested`
|
||||
- `approval.approved`
|
||||
- `approval.rejected`
|
||||
|
||||
## 一句话总结
|
||||
|
||||
Boss 的协议核心不是“消息收发”，而是“让对话、任务、worker、审批都落在同一个可追踪状态机里”。
|
||||
269
docs/mvp-feature-plan.md
Normal file
269
docs/mvp-feature-plan.md
Normal file
@@ -0,0 +1,269 @@
|
||||
# Boss MVP 功能清单
|
||||
|
||||
更新日期：2026-03-23
|
||||
|
||||
## MVP 目标
|
||||
|
||||
用最小可用范围验证下面三件事：
|
||||
|
||||
- 用户能持续通过对话管理一个项目
|
||||
- 主控端能把任务拆给多台设备并持续汇报进度
|
||||
- 用户能在中途改变需求，系统能安全重规划
|
||||
|
||||
MVP 不追求：
|
||||
|
||||
- 多租户企业 SaaS
|
||||
- 完整计费系统
|
||||
- 支持所有聊天平台
|
||||
- 自动解决所有冲突
|
||||
|
||||
## MVP 范围定义
|
||||
|
||||
### 必须有
|
||||
|
||||
- 单用户项目会话
|
||||
- 3 台设备接入
|
||||
- manager 拆任务
|
||||
- worker 在线心跳
|
||||
- 实时进度事件
|
||||
- 任务暂停、继续、取消
|
||||
- 高风险审批
|
||||
- Git worktree 隔离
|
||||
- 测试结果回传
|
||||
- 基础审计
|
||||
|
||||
### 可以延后
|
||||
|
||||
- 多组织管理
|
||||
- 向量记忆优化
|
||||
- 多模型自动路由
|
||||
- 自动 PR 审核
|
||||
- 自动成本优化
|
||||
- 丰富报表
|
||||
|
||||
## 用户故事
|
||||
|
||||
### 用户故事 1：发起项目任务
|
||||
|
||||
作为用户，我希望在一个对话里描述需求，让系统自动拆任务给不同设备执行。
|
||||
|
||||
验收标准：
|
||||
|
||||
- 用户说一句自然语言需求即可创建 project session
|
||||
- manager 能生成主任务和子任务
|
||||
- 子任务能分配到不同设备
|
||||
|
||||
### 用户故事 2：查看实时进度
|
||||
|
||||
作为用户，我希望随时看到每台设备当前做到了哪里，而不是只在结束时知道结果。
|
||||
|
||||
验收标准：
|
||||
|
||||
- 每个子任务有状态、最近一步、最近日志摘要
|
||||
- UI 能看到设备在线状态
|
||||
- 聊天入口能返回汇总版进度
|
||||
|
||||
### 用户故事 3：中途改需求
|
||||
|
||||
作为用户，我希望在任务执行中直接说“改一下方向”，系统就能调整任务，而不是重新开一个新会话。
|
||||
|
||||
验收标准：
|
||||
|
||||
- 新需求追加到同一个 session
|
||||
- manager 能触发 replan
|
||||
- 正在运行的子任务可安全暂停或取消
|
||||
- 用户能看到新旧计划差异
|
||||
|
||||
### 用户故事 4：审批危险操作
|
||||
|
||||
作为用户，我希望对删文件、强推分支、运行危险命令等行为进行确认。
|
||||
|
||||
验收标准：
|
||||
|
||||
- worker 可发起审批请求
|
||||
- 控制台和聊天入口都能完成审批
|
||||
- 审批前任务挂起
|
||||
- 审批结果可审计
|
||||
|
||||
### 用户故事 5：协同开发
|
||||
|
||||
作为用户，我希望多台设备能分别做调研、编码和测试，并由主账号统一汇总。
|
||||
|
||||
验收标准：
|
||||
|
||||
- 至少支持 2 个并行子任务
|
||||
- manager 可汇总结果
|
||||
- 同一项目下子任务之间可引用共享上下文
|
||||
|
||||
## MVP 模块清单
|
||||
|
||||
### 1. Web 控制台
|
||||
|
||||
必须页面：
|
||||
|
||||
- 会话页
|
||||
- 任务树页
|
||||
- 设备页
|
||||
- 审批页
|
||||
|
||||
最小功能：
|
||||
|
||||
- 发消息
|
||||
- 看任务树
|
||||
- 看设备在线状态
|
||||
- 审批和取消任务
|
||||
|
||||
### 2. 聊天入口
|
||||
|
||||
第一阶段建议只接一个平台：
|
||||
|
||||
- Slack 或 Telegram 二选一
|
||||
|
||||
最小功能：
|
||||
|
||||
- 新建任务
|
||||
- 查看状态
|
||||
- 审批
|
||||
- 取消任务
|
||||
|
||||
不建议第一阶段做：
|
||||
|
||||
- 复杂文件浏览
|
||||
- 终端实时流
|
||||
|
||||
### 3. Session Service
|
||||
|
||||
最小职责：
|
||||
|
||||
- 创建会话
|
||||
- 保存消息
|
||||
- 返回会话历史
|
||||
- 标记当前 active objective
|
||||
|
||||
### 4. Task Service
|
||||
|
||||
最小职责：
|
||||
|
||||
- 创建任务树
|
||||
- 更新任务状态
|
||||
- 管理依赖关系
|
||||
- 触发重规划
|
||||
|
||||
### 5. Scheduler
|
||||
|
||||
最小职责：
|
||||
|
||||
- 根据能力分配 worker
|
||||
- 处理重试和超时
|
||||
- 维护 assignment 状态
|
||||
|
||||
### 6. Worker Daemon
|
||||
|
||||
最小职责：
|
||||
|
||||
- 注册设备
|
||||
- 心跳
|
||||
- 拉取任务
|
||||
- 执行命令
|
||||
- 回传结构化事件
|
||||
|
||||
### 7. 审批系统
|
||||
|
||||
最小职责：
|
||||
|
||||
- 定义危险动作
|
||||
- 创建审批请求
|
||||
- 接收审批结果
|
||||
- 恢复或终止工作流
|
||||
|
||||
## MVP 页面草图
|
||||
|
||||
### 会话页
|
||||
|
||||
区域：
|
||||
|
||||
- 左侧项目和会话列表
|
||||
- 中间对话流
|
||||
- 右侧任务树与设备执行摘要
|
||||
|
||||
### 任务页
|
||||
|
||||
区域：
|
||||
|
||||
- 主任务卡片
|
||||
- 子任务列表
|
||||
- 当前负责设备
|
||||
- 状态与最近事件
|
||||
|
||||
### 设备页
|
||||
|
||||
区域：
|
||||
|
||||
- 设备名称
|
||||
- OS
|
||||
- 在线状态
|
||||
- 当前任务
|
||||
- 最近心跳
|
||||
- 工具能力
|
||||
|
||||
## MVP 指标
|
||||
|
||||
### 产品指标
|
||||
|
||||
- 任务可创建成功率
|
||||
- 子任务成功分配率
|
||||
- 需求变更后的重规划成功率
|
||||
- 审批往返耗时
|
||||
|
||||
### 系统指标
|
||||
|
||||
- worker 心跳在线率
|
||||
- 事件回传延迟
|
||||
- 任务平均完成时间
|
||||
- 失败重试成功率
|
||||
|
||||
### 体验指标
|
||||
|
||||
- 用户查看进度时的响应时间
|
||||
- 对话到任务树生成耗时
|
||||
- 需求变更到新计划生效耗时
|
||||
|
||||
## MVP 版本边界
|
||||
|
||||
### V0.1
|
||||
|
||||
- Web 控制台
|
||||
- 单聊天入口
|
||||
- 3 台设备
|
||||
- manager 拆 2 到 3 个子任务
|
||||
- 手动审批
|
||||
|
||||
### V0.2
|
||||
|
||||
- 任务模板
|
||||
- 更细的设备能力调度
|
||||
- GitHub PR 集成
|
||||
- 更丰富的任务摘要
|
||||
|
||||
### V0.3
|
||||
|
||||
- 协同开发模式增强
|
||||
- 共享上下文管理
|
||||
- 更细粒度权限
|
||||
|
||||
## MVP 不做清单
|
||||
|
||||
- 不做跨团队权限模型
|
||||
- 不做复杂订阅体系
|
||||
- 不做自动跨仓库大规模变更
|
||||
- 不做完整 IDE 插件矩阵
|
||||
- 不做长周期自主运行无需监督的全自动模式
|
||||
|
||||
## 开工优先级
|
||||
|
||||
1. 设备接入和心跳
|
||||
2. 对话到任务树
|
||||
3. 子任务分发
|
||||
4. worker 执行与事件回传
|
||||
5. 审批与中断恢复
|
||||
6. 聊天入口
|
||||
342
docs/system-architecture.md
Normal file
342
docs/system-architecture.md
Normal file
@@ -0,0 +1,342 @@
|
||||
# Boss 系统架构
|
||||
|
||||
更新日期：2026-03-23
|
||||
|
||||
## 架构目标
|
||||
|
||||
Boss 要解决的问题不是“如何让一个 agent 写代码”，而是“如何让一个主控端持续调度多个运行在不同设备上的编码 agent，并保持对话、状态和审计一致”。
|
||||
|
||||
核心目标：
|
||||
|
||||
- 用户始终只和一个主账号对话
|
||||
- 主账号能把任务拆给多个 worker
|
||||
- 每个 worker 可以运行在真实 Windows 或 Mac 设备上
|
||||
- 用户可以随时改变需求
|
||||
- 系统支持中断、续跑、审批、回滚、审计
|
||||
|
||||
## 总体架构图
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
User["用户"] --> Chat["聊天入口<br/>Slack / Telegram / 飞书 / 企业微信"]
|
||||
User --> App["独立控制台<br/>Web / Desktop"]
|
||||
|
||||
Chat --> Gateway["API Gateway"]
|
||||
App --> Gateway
|
||||
|
||||
Gateway --> Session["Session Service"]
|
||||
Gateway --> Task["Task Service"]
|
||||
Gateway --> Notify["Notification Service"]
|
||||
|
||||
Session --> Planner["Manager Agent<br/>Codex"]
|
||||
Task --> Planner
|
||||
Planner --> Queue["Queue / Workflow Engine"]
|
||||
Queue --> Scheduler["Scheduler"]
|
||||
|
||||
Scheduler --> Worker1["Windows Worker A"]
|
||||
Scheduler --> Worker2["Windows Worker B"]
|
||||
Scheduler --> Worker3["Mac Worker"]
|
||||
|
||||
Worker1 --> Runtime1["Agent Runtime<br/>Codex CLI / Claude Code / MCP Tools"]
|
||||
Worker2 --> Runtime2["Agent Runtime<br/>Codex CLI / Claude Code / MCP Tools"]
|
||||
Worker3 --> Runtime3["Agent Runtime<br/>Codex CLI / Claude Code / MCP Tools"]
|
||||
|
||||
Session --> Store["Postgres"]
|
||||
Task --> Store
|
||||
Queue --> Store
|
||||
Worker1 --> EventBus["Event Bus"]
|
||||
Worker2 --> EventBus
|
||||
Worker3 --> EventBus
|
||||
EventBus --> Notify
|
||||
EventBus --> Store
|
||||
|
||||
Planner --> Memory["Project Memory / Vector Store"]
|
||||
Worker1 --> Git["Git Provider"]
|
||||
Worker2 --> Browser["Browser / Playwright"]
|
||||
Worker3 --> IDE["Local IDE / Terminal / Filesystem"]
|
||||
```
|
||||
|
||||
## 分层设计
|
||||
|
||||
### 1. 入口层
|
||||
|
||||
职责：
|
||||
|
||||
- 接收用户自然语言
|
||||
- 展示项目进度、任务树、审批请求
|
||||
- 承载多端对话入口
|
||||
|
||||
组成：
|
||||
|
||||
- Web 控制台
|
||||
- Desktop 控制台
|
||||
- Slack / Telegram / 飞书 / 企业微信 Bot
|
||||
|
||||
设计原则：
|
||||
|
||||
- 独立 App 是主控制面
|
||||
- 聊天工具只做轻入口和通知审批
|
||||
- 所有入口共享同一个会话和任务状态
|
||||
|
||||
### 2. 会话与任务层
|
||||
|
||||
职责：
|
||||
|
||||
- 维护项目级会话
|
||||
- 存储用户意图、任务树、依赖关系
|
||||
- 接收需求变更并触发重规划
|
||||
|
||||
核心对象：
|
||||
|
||||
- `project_session`
|
||||
- `task`
|
||||
- `subtask`
|
||||
- `message`
|
||||
- `approval_request`
|
||||
- `worker_assignment`
|
||||
|
||||
设计原则：
|
||||
|
||||
- 任何需求变更都不是覆盖旧状态，而是追加一条事件
|
||||
- 主控 agent 根据最新状态决定继续、暂停、取消还是重规划
|
||||
|
||||
### 3. Manager Agent 层
|
||||
|
||||
职责：
|
||||
|
||||
- 读取当前上下文
|
||||
- 把用户自然语言翻译成任务树
|
||||
- 给不同 worker 分派工作
|
||||
- 汇总各 worker 回传结果
|
||||
- 把技术执行过程重新组织成面向用户的进度播报
|
||||
|
||||
建议实现：
|
||||
|
||||
- 首选 Codex 作为 manager brain
|
||||
- manager 不直接执行重活，主要负责规划、协调和总结
|
||||
|
||||
为什么 manager 要单独存在：
|
||||
|
||||
- 用户说的是需求语言，不是底层执行语言
|
||||
- 设备 worker 报的是技术状态，不是业务状态
|
||||
- manager 负责在这两者之间做翻译
|
||||
|
||||
### 4. 调度与工作流层
|
||||
|
||||
职责：
|
||||
|
||||
- 排队
|
||||
- 优先级控制
|
||||
- 并发控制
|
||||
- 超时重试
|
||||
- 中断恢复
|
||||
- 审批等待
|
||||
|
||||
设计原则：
|
||||
|
||||
- 长任务必须通过工作流引擎或持久队列驱动
|
||||
- 不能靠单个进程中的内存状态维持任务
|
||||
|
||||
推荐能力：
|
||||
|
||||
- 任务可挂起
|
||||
- 任务可人工恢复
|
||||
- 子任务状态独立
|
||||
- 支持依赖关系图
|
||||
|
||||
### 5. Worker 层
|
||||
|
||||
职责：
|
||||
|
||||
- 在真实设备上执行具体开发动作
|
||||
- 拉代码、建 worktree、改文件、跑测试、创建 PR
|
||||
- 上报结构化事件和心跳
|
||||
|
||||
部署方式：
|
||||
|
||||
- 每台设备安装一个 `boss-worker`
|
||||
- worker 持久连接到 control plane
|
||||
- worker 内部再调用 Codex CLI、Claude Code、Playwright、MCP 工具等
|
||||
|
||||
为什么 worker 必须是 daemon：
|
||||
|
||||
- 需要持续在线状态
|
||||
- 需要接收取消和暂停命令
|
||||
- 需要中途回传事件
|
||||
- 需要在主控端丢线后继续执行
|
||||
|
||||
### 6. 工具层
|
||||
|
||||
职责：
|
||||
|
||||
- 提供标准化工具访问
|
||||
- 屏蔽不同设备的具体环境差异
|
||||
|
||||
建议接入：
|
||||
|
||||
- Git
|
||||
- Filesystem
|
||||
- Terminal
|
||||
- Browser automation
|
||||
- Issue tracker
|
||||
- Chat connector
|
||||
- CI / Test runner
|
||||
|
||||
建议协议：
|
||||
|
||||
- 工具接入优先使用 MCP
|
||||
- agent-to-agent 通信前瞻引入 A2A
|
||||
|
||||
### 7. 存储与审计层
|
||||
|
||||
职责：
|
||||
|
||||
- 保存消息、任务、事件、状态快照
|
||||
- 为用户提供会话恢复与审计追踪
|
||||
|
||||
必须保存的内容：
|
||||
|
||||
- 用户消息
|
||||
- manager 规划结果
|
||||
- worker 事件流
|
||||
- 审批记录
|
||||
- 高风险工具调用
|
||||
- Git 变更摘要
|
||||
|
||||
## 关键交互路径
|
||||
|
||||
### 路径 1：用户发起新任务
|
||||
|
||||
1. 用户在 Web 或聊天入口发起需求
|
||||
2. Session Service 追加消息
|
||||
3. Manager 生成任务树
|
||||
4. Task Service 创建主任务和子任务
|
||||
5. Scheduler 根据设备能力分配 worker
|
||||
6. worker 执行并回传事件
|
||||
7. manager 定期汇总进度给用户
|
||||
|
||||
### 路径 2：用户中途改需求
|
||||
|
||||
1. 用户说“先暂停 A，改成先修登录问题”
|
||||
2. 新消息进入当前 project session
|
||||
3. manager 读取活动中的任务树
|
||||
4. manager 标记哪些子任务失效，哪些继续保留
|
||||
5. Task Service 下发 `pause / cancel / replan`
|
||||
6. worker 接收并安全停止当前步骤
|
||||
7. manager 输出新的计划和最新进度
|
||||
|
||||
### 路径 3：高风险审批
|
||||
|
||||
1. worker 申请执行高风险操作
|
||||
2. control plane 生成审批请求
|
||||
3. 用户在 App 或聊天入口确认
|
||||
4. 工作流恢复执行或终止
|
||||
|
||||
## 协同开发模式
|
||||
|
||||
### 模式 A：独立开发
|
||||
|
||||
- 一个子任务绑定一个 worker
|
||||
- worker 自己完成从理解、编码到测试的闭环
|
||||
- manager 只做验收和汇总
|
||||
|
||||
适合：
|
||||
|
||||
- 低耦合功能开发
|
||||
- 单一 bug 修复
|
||||
|
||||
### 模式 B：协同开发
|
||||
|
||||
- manager 先做任务拆解
|
||||
- 不同 worker 分别负责不同模块或阶段
|
||||
- 通过 shared context 和中间产物衔接
|
||||
|
||||
适合：
|
||||
|
||||
- 横跨前后端的需求
|
||||
- 需要并行研究和实现
|
||||
|
||||
### 模式 C：研究先行
|
||||
|
||||
- 多个 worker 先做调研、复现、定位
|
||||
- manager 再决定由哪台设备进入实现
|
||||
|
||||
适合：
|
||||
|
||||
- 不确定问题根因
|
||||
- 风险较高的问题
|
||||
|
||||
## 设备调度策略
|
||||
|
||||
推荐调度维度：
|
||||
|
||||
- OS 能力
|
||||
- 当前负载
|
||||
- 工具能力
|
||||
- 项目亲和性
|
||||
- 上下文热度
|
||||
- 风险等级
|
||||
|
||||
示例：
|
||||
|
||||
- 需要 Xcode 的任务优先给 Mac
|
||||
- 需要 Windows 原生应用自动化的任务优先给 Windows
|
||||
- 同一 repo 的后续任务优先分给最近处理过该 repo 的 worker
|
||||
|
||||
## 为什么不建议一开始就做的东西
|
||||
|
||||
- 不建议一开始做跨团队多租户 SaaS
|
||||
- 不建议一开始做复杂计费系统
|
||||
- 不建议一开始就做完整 A2A 联邦网络
|
||||
- 不建议一开始支持太多聊天平台
|
||||
|
||||
第一阶段只要把下面几件事跑通：
|
||||
|
||||
- 主账号持续对话
|
||||
- 三台机器在线
|
||||
- 子任务拆分
|
||||
- 实时进度回传
|
||||
- 可暂停、可继续、可取消
|
||||
- 可审批高风险操作
|
||||
|
||||
## 当前推荐架构决策
|
||||
|
||||
- 主控面：Web 优先，后续补 Desktop
|
||||
- Manager：Codex
|
||||
- Worker runtime：Codex CLI + Claude Code 混合
|
||||
- 工具协议：MCP
|
||||
- 任务编排：持久队列或工作流引擎
|
||||
- 存储：Postgres
|
||||
- 事件流：Redis Streams 或消息队列
|
||||
|
||||
## 架构风险
|
||||
|
||||
### 风险 1：多个 worker 改同一仓库互相踩踏
|
||||
|
||||
规避方式：
|
||||
|
||||
- 每个任务独立 worktree
|
||||
- 每个任务独立分支
|
||||
- 合并前必须做 diff 汇总和冲突检查
|
||||
|
||||
### 风险 2：需求变化导致长任务上下文混乱
|
||||
|
||||
规避方式：
|
||||
|
||||
- 所有需求变化事件化
|
||||
- manager 在重规划前必须读取当前状态快照
|
||||
|
||||
### 风险 3：聊天入口承载太多复杂交互
|
||||
|
||||
规避方式：
|
||||
|
||||
- 长会话、文件树、终端流只放在独立 App
|
||||
- 聊天入口只承担轻操作
|
||||
|
||||
### 风险 4：worker 执行权限过大
|
||||
|
||||
规避方式：
|
||||
|
||||
- 把危险命令纳入审批
|
||||
- 工具分级授权
|
||||
- 关键操作记录审计日志
|
||||
314
docs/technical-selection.md
Normal file
314
docs/technical-selection.md
Normal file
@@ -0,0 +1,314 @@
|
||||
# Boss 技术选型建议
|
||||
|
||||
更新日期：2026-03-23
|
||||
|
||||
## 选型原则
|
||||
|
||||
- 先保证系统能跑，再追求最优雅
|
||||
- 持久状态优先于纯内存编排
|
||||
- 结构化事件优先于拼字符串日志
|
||||
- 尽量复用成熟 agent 运行时，而不是自己重写编码 agent
|
||||
|
||||
## 总体选型建议
|
||||
|
||||
| 层 | 推荐 | 备选 | 原因 |
|
||||
|---|---|---|---|
|
||||
| 前端控制台 | Next.js | Remix, Nuxt | 适合快速做管理台和流式 UI |
|
||||
| Desktop | Tauri | Electron | 后续需要时再补，Tauri 更轻 |
|
||||
| 后端 API | NestJS 或 Fastify | Express, Go Fiber | 结构清晰，适合长期维护 |
|
||||
| 工作流引擎 | Temporal | Inngest, BullMQ + 自建状态机 | 长任务、中断、审批、恢复是核心需求 |
|
||||
| 队列/事件 | Redis Streams | NATS, Kafka | MVP 阶段足够轻，开发快 |
|
||||
| 主数据库 | Postgres | MySQL | 事务、JSON、查询能力更适合控制平面 |
|
||||
| 缓存 | Redis | KeyDB | 用于会话热数据、限流、事件流 |
|
||||
| Manager Agent | Codex | Claude API, GPT-5.x Responses | 适合做规划、汇总、重规划 |
|
||||
| Worker Runtime | Codex CLI + Claude Code | OpenHands agent runtime | 直接复用成熟编码 agent |
|
||||
| 工具协议 | MCP | 自定义 tool API | 标准化工具接入 |
|
||||
| 浏览器自动化 | Playwright | Puppeteer | 成熟稳定，适合 agent 使用 |
|
||||
| 聊天入口 | Slack 或 Telegram | 飞书, 企业微信 | 文档、生态和迭代速度更合适 |
|
||||
| 身份认证 | Clerk 或 Auth.js | 自建 OAuth | MVP 快速起步 |
|
||||
| 监控 | OpenTelemetry + Grafana | Datadog, Sentry | 方便追踪任务链路 |
|
||||
|
||||
## 为什么推荐这个技术组合
|
||||
|
||||
### 1. Next.js 作为控制台前端
|
||||
|
||||
原因：
|
||||
|
||||
- 适合做 dashboard、对话界面、任务树、设备面板
|
||||
- 容易做流式更新和服务端渲染
|
||||
- 与 TypeScript 一体化
|
||||
|
||||
不建议现在单独起 React Native：
|
||||
|
||||
- 当前核心不是移动端，而是 control plane
|
||||
|
||||
### 2. NestJS 或 Fastify 作为后端
|
||||
|
||||
如果团队偏工程化：
|
||||
|
||||
- 选 NestJS
|
||||
|
||||
如果你想更轻更快：
|
||||
|
||||
- 选 Fastify
|
||||
|
||||
建议：
|
||||
|
||||
- 先用 Fastify 或 NestJS 中你更熟的那个
|
||||
- 关键是把服务边界拆干净
|
||||
|
||||
### 3. Temporal 作为工作流引擎
|
||||
|
||||
这是当前最关键的选型之一。
|
||||
|
||||
Boss 不是短请求系统，而是长任务系统。你需要天然支持：
|
||||
|
||||
- 几分钟到几小时的任务
|
||||
- 中途暂停
|
||||
- 审批等待
|
||||
- worker 断线重连
|
||||
- 任务恢复
|
||||
|
||||
如果不用工作流引擎，后面会自己补很多分布式状态机逻辑。
|
||||
|
||||
如果 MVP 阶段不想上 Temporal：
|
||||
|
||||
- 可以先用 `BullMQ + Postgres 状态表`
|
||||
- 但要尽快收敛到真正可恢复的工作流模型
|
||||
|
||||
### 4. Postgres 作为主数据库
|
||||
|
||||
Boss 的核心不是海量日志，而是：
|
||||
|
||||
- 会话
|
||||
- 任务树
|
||||
- 审批
|
||||
- worker 注册
|
||||
- 状态快照
|
||||
|
||||
这些都非常适合 Postgres。
|
||||
|
||||
### 5. Codex 作为 manager
|
||||
|
||||
原因：
|
||||
|
||||
- 你希望主账号持续对话和重规划
|
||||
- manager 不需要最强本地执行，它更需要任务理解、拆解和汇总
|
||||
- Codex 在多入口和云任务语境里更契合 manager 角色
|
||||
|
||||
推荐职责：
|
||||
|
||||
- 规划
|
||||
- 重规划
|
||||
- 汇总
|
||||
- 风险解释
|
||||
|
||||
不建议让 manager 干太多底层执行：
|
||||
|
||||
- 容易把规划和执行耦合死
|
||||
|
||||
### 6. Claude Code / Codex CLI 作为 worker runtime
|
||||
|
||||
原因：
|
||||
|
||||
- 本地设备执行体验成熟
|
||||
- 适合接 terminal、filesystem、git、browser
|
||||
- 真实开发环境兼容性更好
|
||||
|
||||
建议策略：
|
||||
|
||||
- Mac 和 Windows worker 都先抽象成统一 `executor`
|
||||
- 底层可配置使用 `codex` 或 `claude`
|
||||
|
||||
## 服务拆分建议
|
||||
|
||||
### 第一阶段服务
|
||||
|
||||
- `api-gateway`
|
||||
- `session-service`
|
||||
- `task-service`
|
||||
- `scheduler-service`
|
||||
- `worker-gateway`
|
||||
- `notification-service`
|
||||
|
||||
### 第二阶段可拆
|
||||
|
||||
- `approval-service`
|
||||
- `memory-service`
|
||||
- `git-integration-service`
|
||||
- `chat-connector-service`
|
||||
|
||||
## 数据存储建议
|
||||
|
||||
### Postgres 表
|
||||
|
||||
建议至少有：
|
||||
|
||||
- `users`
|
||||
- `project_sessions`
|
||||
- `messages`
|
||||
- `tasks`
|
||||
- `task_dependencies`
|
||||
- `worker_nodes`
|
||||
- `worker_capabilities`
|
||||
- `worker_assignments`
|
||||
- `task_events`
|
||||
- `approval_requests`
|
||||
- `artifacts`
|
||||
|
||||
### Redis 用途
|
||||
|
||||
- worker 在线状态
|
||||
- 事件总线
|
||||
- UI 实时订阅
|
||||
- 节流和限流
|
||||
|
||||
## Worker 设计建议
|
||||
|
||||
### worker 进程结构
|
||||
|
||||
组成：
|
||||
|
||||
- `boss-worker` 守护进程
|
||||
- `executor` 适配层
|
||||
- `tool adapters`
|
||||
- `sandbox policy`
|
||||
- `event reporter`
|
||||
|
||||
### worker 本地目录策略
|
||||
|
||||
建议：
|
||||
|
||||
- 一个统一工作根目录
|
||||
- 每个任务一个独立 workspace
|
||||
- 每个任务一个独立 git worktree
|
||||
|
||||
示例：
|
||||
|
||||
```text
|
||||
~/boss-worker/
|
||||
repos/
|
||||
worktrees/
|
||||
cache/
|
||||
artifacts/
|
||||
```
|
||||
|
||||
### worker 能力声明
|
||||
|
||||
每个 worker 启动时上报：
|
||||
|
||||
- OS
|
||||
- shell
|
||||
- 是否支持浏览器自动化
|
||||
- 是否支持特定 IDE
|
||||
- 是否有移动端模拟器
|
||||
- 是否具备 repo 热缓存
|
||||
|
||||
## 协议选型建议
|
||||
|
||||
### MCP
|
||||
|
||||
用途：
|
||||
|
||||
- 统一工具调用
|
||||
|
||||
适合接：
|
||||
|
||||
- Git
|
||||
- 文件系统
|
||||
- 浏览器
|
||||
- Issue 系统
|
||||
- CI
|
||||
|
||||
### A2A
|
||||
|
||||
用途：
|
||||
|
||||
- 中长期用于 agent 之间通信
|
||||
|
||||
建议：
|
||||
|
||||
- MVP 不强依赖
|
||||
- 但内部消息模型尽量向 agent-to-agent 协作靠拢
|
||||
|
||||
## 前后端通信建议
|
||||
|
||||
### 控制台实时能力
|
||||
|
||||
推荐：
|
||||
|
||||
- WebSocket 或 Server-Sent Events
|
||||
|
||||
用途：
|
||||
|
||||
- 推送任务状态
|
||||
- 推送审批请求
|
||||
- 推送设备在线变化
|
||||
|
||||
### worker 连接方式
|
||||
|
||||
推荐：
|
||||
|
||||
- WebSocket 长连接
|
||||
|
||||
原因：
|
||||
|
||||
- 需要双向通信
|
||||
- 需要下发中断和恢复命令
|
||||
|
||||
## 安全建议
|
||||
|
||||
### 最小权限原则
|
||||
|
||||
- worker 不要默认拥有所有仓库权限
|
||||
- 每种工具调用都要有权限分级
|
||||
|
||||
### 高风险动作审批
|
||||
|
||||
必须纳入审批的动作：
|
||||
|
||||
- 删除大量文件
|
||||
- 强推分支
|
||||
- 执行危险 shell
|
||||
- 访问敏感路径
|
||||
|
||||
### 审计
|
||||
|
||||
必须记录：
|
||||
|
||||
- 谁发起了什么
|
||||
- 哪个 worker 执行了什么
|
||||
- 哪个 agent 建议了什么
|
||||
- 审批前后状态
|
||||
|
||||
## 推荐的 MVP 技术栈
|
||||
|
||||
### MVP 最稳组合
|
||||
|
||||
- 前端：Next.js
|
||||
- 后端：NestJS
|
||||
- 数据库：Postgres
|
||||
- 缓存和事件：Redis
|
||||
- 工作流：BullMQ，后续升级 Temporal
|
||||
- Manager：Codex
|
||||
- Worker：Codex CLI + Claude Code
|
||||
- 聊天入口：Telegram 或 Slack
|
||||
|
||||
### 如果你要一步到位更稳
|
||||
|
||||
- 前端：Next.js
|
||||
- 后端：NestJS
|
||||
- 数据库：Postgres
|
||||
- 缓存：Redis
|
||||
- 工作流：Temporal
|
||||
- Manager：Codex
|
||||
- Worker：Codex CLI + Claude Code
|
||||
- 监控：OpenTelemetry
|
||||
|
||||
## 不推荐的坑
|
||||
|
||||
- 不要一开始就全微服务
|
||||
- 不要一开始就自研完整 agent runtime
|
||||
- 不要把聊天平台当成主控制台
|
||||
- 不要让多个任务共用一个工作目录
|
||||
- 不要把审批做成“日志里提示一下”而不是显式状态
|
||||
1618
package-lock.json
generated
Normal file
1618
package-lock.json
generated
Normal file
File diff suppressed because it is too large
Load Diff
23
package.json
Normal file
23
package.json
Normal file
@@ -0,0 +1,23 @@
|
||||
{
|
||||
"name": "boss",
|
||||
"version": "0.1.0",
|
||||
"private": true,
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
"dev": "tsx watch src/server.ts",
|
||||
"build": "tsc -p tsconfig.json",
|
||||
"start": "node dist/server.js",
|
||||
"check": "tsc --noEmit -p tsconfig.json",
|
||||
"worker": "tsx src/worker.ts"
|
||||
},
|
||||
"dependencies": {
|
||||
"@fastify/static": "^8.2.0",
|
||||
"fastify": "^5.6.1"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@types/node": "^24.0.0",
|
||||
"tsx": "^4.20.6",
|
||||
"typescript": "^5.9.2"
|
||||
}
|
||||
}
|
||||
|
||||
333
public/app.js
Normal file
333
public/app.js
Normal file
@@ -0,0 +1,333 @@
|
||||
const state = {
|
||||
sessions: [],
|
||||
messages: [],
|
||||
tasks: [],
|
||||
approvals: [],
|
||||
workers: [],
|
||||
events: [],
|
||||
selectedSessionId: null,
|
||||
};
|
||||
|
||||
const elements = {
|
||||
sessionList: document.querySelector("#session-list"),
|
||||
workerList: document.querySelector("#worker-list"),
|
||||
messageList: document.querySelector("#message-list"),
|
||||
taskList: document.querySelector("#task-list"),
|
||||
approvalList: document.querySelector("#approval-list"),
|
||||
eventList: document.querySelector("#event-list"),
|
||||
sessionTitleDisplay: document.querySelector("#session-title-display"),
|
||||
sessionSummary: document.querySelector("#session-summary"),
|
||||
createSessionForm: document.querySelector("#create-session-form"),
|
||||
sessionTitleInput: document.querySelector("#session-title"),
|
||||
messageForm: document.querySelector("#message-form"),
|
||||
messageInput: document.querySelector("#message-input"),
|
||||
resetDemo: document.querySelector("#reset-demo"),
|
||||
};
|
||||
|
||||
function escapeHtml(input) {
|
||||
return input
|
||||
.replaceAll("&", "&")
|
||||
.replaceAll("<", "<")
|
||||
.replaceAll(">", ">")
|
||||
.replaceAll('"', """)
|
||||
.replaceAll("'", "'");
|
||||
}
|
||||
|
||||
async function request(url, options = {}) {
|
||||
const response = await fetch(url, {
|
||||
headers: { "Content-Type": "application/json" },
|
||||
...options,
|
||||
});
|
||||
|
||||
if (!response.ok) {
|
||||
throw new Error(`${response.status} ${response.statusText}`);
|
||||
}
|
||||
|
||||
return response.json();
|
||||
}
|
||||
|
||||
function selectedSession() {
|
||||
return state.sessions.find((session) => session.id === state.selectedSessionId) ?? null;
|
||||
}
|
||||
|
||||
function tasksForSelectedSession() {
|
||||
return state.tasks.filter((task) => task.sessionId === state.selectedSessionId);
|
||||
}
|
||||
|
||||
function messagesForSelectedSession() {
|
||||
return state.messages.filter((message) => message.sessionId === state.selectedSessionId);
|
||||
}
|
||||
|
||||
function approvalsForSelectedSession() {
|
||||
return state.approvals.filter((approval) => approval.sessionId === state.selectedSessionId);
|
||||
}
|
||||
|
||||
function eventsForSelectedSession() {
|
||||
return state.events
|
||||
.filter((event) => event.sessionId === null || event.sessionId === state.selectedSessionId)
|
||||
.slice(-50)
|
||||
.reverse();
|
||||
}
|
||||
|
||||
function renderSessions() {
|
||||
elements.sessionList.innerHTML = state.sessions
|
||||
.map((session) => {
|
||||
const active = session.id === state.selectedSessionId ? "active" : "";
|
||||
return `
|
||||
<button class="session-item ${active}" data-session-id="${session.id}">
|
||||
<strong>${escapeHtml(session.title)}</strong>
|
||||
<span>${escapeHtml(session.activeObjective || "暂无目标")}</span>
|
||||
</button>
|
||||
`;
|
||||
})
|
||||
.join("");
|
||||
|
||||
elements.sessionList.querySelectorAll("[data-session-id]").forEach((button) => {
|
||||
button.addEventListener("click", async () => {
|
||||
state.selectedSessionId = button.dataset.sessionId;
|
||||
await loadSession(state.selectedSessionId);
|
||||
render();
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
function renderWorkers() {
|
||||
elements.workerList.innerHTML = state.workers
|
||||
.map(
|
||||
(worker) => `
|
||||
<div class="card">
|
||||
<div class="row between">
|
||||
<strong>${escapeHtml(worker.name)}</strong>
|
||||
<span class="badge ${worker.status}">${escapeHtml(worker.status)}</span>
|
||||
</div>
|
||||
<div class="muted">${escapeHtml(worker.os)}</div>
|
||||
<div class="tags">
|
||||
${worker.capabilities.map((capability) => `<span>${escapeHtml(capability)}</span>`).join("")}
|
||||
</div>
|
||||
</div>
|
||||
`,
|
||||
)
|
||||
.join("");
|
||||
}
|
||||
|
||||
function renderSessionHeader() {
|
||||
const session = selectedSession();
|
||||
if (!session) {
|
||||
elements.sessionTitleDisplay.textContent = "选择一个项目会话";
|
||||
elements.sessionSummary.textContent = "创建会话后，在这里持续对话并观察任务状态。";
|
||||
return;
|
||||
}
|
||||
|
||||
elements.sessionTitleDisplay.textContent = session.title;
|
||||
elements.sessionSummary.textContent =
|
||||
session.lastPlannerSummary || session.activeObjective || "等待用户输入。";
|
||||
}
|
||||
|
||||
function renderMessages() {
|
||||
const messages = messagesForSelectedSession();
|
||||
elements.messageList.innerHTML = messages.length
|
||||
? messages
|
||||
.map(
|
||||
(message) => `
|
||||
<article class="message ${message.role}">
|
||||
<header>
|
||||
<strong>${escapeHtml(message.role)}</strong>
|
||||
<span>${new Date(message.createdAt).toLocaleTimeString()}</span>
|
||||
</header>
|
||||
<p>${escapeHtml(message.content)}</p>
|
||||
</article>
|
||||
`,
|
||||
)
|
||||
.join("")
|
||||
: `<p class="muted">当前没有消息。</p>`;
|
||||
}
|
||||
|
||||
function renderTasks() {
|
||||
const tasks = tasksForSelectedSession();
|
||||
elements.taskList.innerHTML = tasks.length
|
||||
? tasks
|
||||
.map(
|
||||
(task) => `
|
||||
<div class="card">
|
||||
<div class="row between">
|
||||
<strong>${escapeHtml(task.title)}</strong>
|
||||
<span class="badge ${task.status}">${escapeHtml(task.status)}</span>
|
||||
</div>
|
||||
<p>${escapeHtml(task.description)}</p>
|
||||
<div class="muted">worker: ${escapeHtml(task.assignedWorkerId || "未分配")}</div>
|
||||
<div class="muted">progress: ${task.progressPercent}%</div>
|
||||
<div class="muted">summary: ${escapeHtml(task.summary || "暂无")}</div>
|
||||
<div class="actions">
|
||||
<button data-action="pause" data-task-id="${task.id}" class="ghost">暂停</button>
|
||||
<button data-action="cancel" data-task-id="${task.id}" class="ghost danger">取消</button>
|
||||
</div>
|
||||
</div>
|
||||
`,
|
||||
)
|
||||
.join("")
|
||||
: `<p class="muted">当前没有任务。</p>`;
|
||||
|
||||
elements.taskList.querySelectorAll("[data-action]").forEach((button) => {
|
||||
button.addEventListener("click", async () => {
|
||||
const taskId = button.dataset.taskId;
|
||||
const action = button.dataset.action;
|
||||
await request(`/api/tasks/${taskId}/${action}`, { method: "POST", body: "{}" });
|
||||
await loadSession(state.selectedSessionId);
|
||||
render();
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
function renderApprovals() {
|
||||
const approvals = approvalsForSelectedSession();
|
||||
elements.approvalList.innerHTML = approvals.length
|
||||
? approvals
|
||||
.map(
|
||||
(approval) => `
|
||||
<div class="card">
|
||||
<div class="row between">
|
||||
<strong>${escapeHtml(approval.summary)}</strong>
|
||||
<span class="badge ${approval.status}">${escapeHtml(approval.status)}</span>
|
||||
</div>
|
||||
<div class="muted">risk: ${escapeHtml(approval.riskLevel)}</div>
|
||||
<div class="actions">
|
||||
<button data-approval-id="${approval.id}" data-approved="true">批准</button>
|
||||
<button data-approval-id="${approval.id}" data-approved="false" class="ghost danger">拒绝</button>
|
||||
</div>
|
||||
</div>
|
||||
`,
|
||||
)
|
||||
.join("")
|
||||
: `<p class="muted">当前没有待审批项。</p>`;
|
||||
|
||||
elements.approvalList.querySelectorAll("[data-approval-id]").forEach((button) => {
|
||||
button.addEventListener("click", async () => {
|
||||
const approvalId = button.dataset.approvalId;
|
||||
const approved = button.dataset.approved === "true";
|
||||
await request(`/api/approvals/${approvalId}/respond`, {
|
||||
method: "POST",
|
||||
body: JSON.stringify({ approved, responder: "web-user" }),
|
||||
});
|
||||
await loadSession(state.selectedSessionId);
|
||||
render();
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
function renderEvents() {
|
||||
const events = eventsForSelectedSession();
|
||||
elements.eventList.innerHTML = events.length
|
||||
? events
|
||||
.map(
|
||||
(event) => `
|
||||
<article class="event">
|
||||
<header>
|
||||
<strong>${escapeHtml(event.type)}</strong>
|
||||
<span>${new Date(event.timestamp).toLocaleTimeString()}</span>
|
||||
</header>
|
||||
<pre>${escapeHtml(JSON.stringify(event.payload, null, 2))}</pre>
|
||||
</article>
|
||||
`,
|
||||
)
|
||||
.join("")
|
||||
: `<p class="muted">当前没有事件。</p>`;
|
||||
}
|
||||
|
||||
function render() {
|
||||
renderSessions();
|
||||
renderWorkers();
|
||||
renderSessionHeader();
|
||||
renderMessages();
|
||||
renderTasks();
|
||||
renderApprovals();
|
||||
renderEvents();
|
||||
}
|
||||
|
||||
async function loadBootstrap() {
|
||||
const bootstrap = await request("/api/bootstrap");
|
||||
state.sessions = bootstrap.sessions;
|
||||
state.messages = bootstrap.messages;
|
||||
state.tasks = bootstrap.tasks;
|
||||
state.workers = bootstrap.workers;
|
||||
state.approvals = bootstrap.approvals;
|
||||
state.events = bootstrap.events;
|
||||
if (!state.selectedSessionId && state.sessions[0]) {
|
||||
state.selectedSessionId = state.sessions[0].id;
|
||||
}
|
||||
}
|
||||
|
||||
async function loadSession(sessionId) {
|
||||
if (!sessionId) return;
|
||||
const details = await request(`/api/sessions/${sessionId}`);
|
||||
state.sessions = state.sessions.map((session) => (session.id === sessionId ? details.session : session));
|
||||
state.messages = [
|
||||
...state.messages.filter((message) => message.sessionId !== sessionId),
|
||||
...details.messages,
|
||||
];
|
||||
state.tasks = [
|
||||
...state.tasks.filter((task) => task.sessionId !== sessionId),
|
||||
...details.tasks,
|
||||
];
|
||||
state.approvals = [
|
||||
...state.approvals.filter((approval) => approval.sessionId !== sessionId),
|
||||
...details.approvals,
|
||||
];
|
||||
}
|
||||
|
||||
elements.createSessionForm.addEventListener("submit", async (event) => {
|
||||
event.preventDefault();
|
||||
const title = elements.sessionTitleInput.value.trim();
|
||||
const details = await request("/api/sessions", {
|
||||
method: "POST",
|
||||
body: JSON.stringify({ title }),
|
||||
});
|
||||
state.sessions.unshift(details.session);
|
||||
state.selectedSessionId = details.session.id;
|
||||
await loadSession(details.session.id);
|
||||
elements.sessionTitleInput.value = "";
|
||||
render();
|
||||
});
|
||||
|
||||
elements.messageForm.addEventListener("submit", async (event) => {
|
||||
event.preventDefault();
|
||||
if (!state.selectedSessionId) return;
|
||||
const content = elements.messageInput.value.trim();
|
||||
if (!content) return;
|
||||
await request(`/api/sessions/${state.selectedSessionId}/messages`, {
|
||||
method: "POST",
|
||||
body: JSON.stringify({ content, channel: "web" }),
|
||||
});
|
||||
elements.messageInput.value = "";
|
||||
await loadSession(state.selectedSessionId);
|
||||
await loadBootstrap();
|
||||
render();
|
||||
});
|
||||
|
||||
elements.resetDemo.addEventListener("click", async () => {
|
||||
await request("/api/demo/reset", { method: "POST", body: "{}" });
|
||||
state.sessions = [];
|
||||
state.messages = [];
|
||||
state.tasks = [];
|
||||
state.workers = [];
|
||||
state.approvals = [];
|
||||
state.events = [];
|
||||
state.selectedSessionId = null;
|
||||
render();
|
||||
});
|
||||
|
||||
const stream = new EventSource("/api/events/stream");
|
||||
stream.onmessage = async (event) => {
|
||||
const payload = JSON.parse(event.data);
|
||||
state.events.push(payload);
|
||||
if (payload.sessionId) {
|
||||
await loadSession(payload.sessionId);
|
||||
}
|
||||
await loadBootstrap();
|
||||
render();
|
||||
};
|
||||
|
||||
loadBootstrap().then(render).catch((error) => {
|
||||
console.error(error);
|
||||
elements.sessionSummary.textContent = error.message;
|
||||
});
|
||||
|
||||
92
public/index.html
Normal file
92
public/index.html
Normal file
@@ -0,0 +1,92 @@
|
||||
<!doctype html>
|
||||
<html lang="zh-CN">
|
||||
<head>
|
||||
<meta charset="UTF-8" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||
<title>Boss Control Plane</title>
|
||||
<link rel="stylesheet" href="/styles.css" />
|
||||
</head>
|
||||
<body>
|
||||
<div class="shell">
|
||||
<aside class="sidebar">
|
||||
<div class="panel">
|
||||
<div class="panel-header">
|
||||
<h1>Boss</h1>
|
||||
<button id="reset-demo" class="ghost">重置 Demo</button>
|
||||
</div>
|
||||
<p class="caption">多设备开发代理控制台</p>
|
||||
</div>
|
||||
|
||||
<div class="panel">
|
||||
<div class="panel-header">
|
||||
<h2>项目会话</h2>
|
||||
</div>
|
||||
<form id="create-session-form" class="stack">
|
||||
<input id="session-title" placeholder="新项目标题" />
|
||||
<button type="submit">创建会话</button>
|
||||
</form>
|
||||
<div id="session-list" class="list"></div>
|
||||
</div>
|
||||
|
||||
<div class="panel">
|
||||
<div class="panel-header">
|
||||
<h2>设备</h2>
|
||||
</div>
|
||||
<div id="worker-list" class="list"></div>
|
||||
</div>
|
||||
</aside>
|
||||
|
||||
<main class="content">
|
||||
<section class="panel hero">
|
||||
<div>
|
||||
<h2 id="session-title-display">选择一个项目会话</h2>
|
||||
<p id="session-summary" class="muted">创建会话后，在这里持续对话并观察任务状态。</p>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<section class="grid">
|
||||
<div class="panel">
|
||||
<div class="panel-header">
|
||||
<h2>对话</h2>
|
||||
</div>
|
||||
<div id="message-list" class="timeline"></div>
|
||||
<form id="message-form" class="stack">
|
||||
<textarea
|
||||
id="message-input"
|
||||
rows="4"
|
||||
placeholder="输入需求。示例：先调研登录失败根因，不要急着改代码。"
|
||||
></textarea>
|
||||
<button type="submit">发送消息</button>
|
||||
</form>
|
||||
</div>
|
||||
|
||||
<div class="panel">
|
||||
<div class="panel-header">
|
||||
<h2>任务树</h2>
|
||||
</div>
|
||||
<div id="task-list" class="list"></div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<section class="grid">
|
||||
<div class="panel">
|
||||
<div class="panel-header">
|
||||
<h2>审批</h2>
|
||||
</div>
|
||||
<div id="approval-list" class="list"></div>
|
||||
</div>
|
||||
|
||||
<div class="panel">
|
||||
<div class="panel-header">
|
||||
<h2>事件流</h2>
|
||||
</div>
|
||||
<div id="event-list" class="timeline compact"></div>
|
||||
</div>
|
||||
</section>
|
||||
</main>
|
||||
</div>
|
||||
|
||||
<script type="module" src="/app.js"></script>
|
||||
</body>
|
||||
</html>
|
||||
|
||||
219
public/styles.css
Normal file
219
public/styles.css
Normal file
@@ -0,0 +1,219 @@
|
||||
:root {
|
||||
color-scheme: light;
|
||||
--bg: #f3efe4;
|
||||
--panel: rgba(255, 252, 245, 0.88);
|
||||
--line: rgba(43, 40, 35, 0.12);
|
||||
--text: #1d1c19;
|
||||
--muted: #716c61;
|
||||
--accent: #1f6feb;
|
||||
--danger: #b42318;
|
||||
--shadow: 0 18px 48px rgba(31, 28, 25, 0.08);
|
||||
}
|
||||
|
||||
* {
|
||||
box-sizing: border-box;
|
||||
}
|
||||
|
||||
body {
|
||||
margin: 0;
|
||||
font-family: "IBM Plex Sans", "Source Han Sans SC", sans-serif;
|
||||
background:
|
||||
radial-gradient(circle at top left, rgba(31, 111, 235, 0.12), transparent 24rem),
|
||||
linear-gradient(180deg, #f8f5ec 0%, var(--bg) 100%);
|
||||
color: var(--text);
|
||||
}
|
||||
|
||||
button,
|
||||
input,
|
||||
textarea {
|
||||
font: inherit;
|
||||
}
|
||||
|
||||
button {
|
||||
border: 0;
|
||||
border-radius: 12px;
|
||||
background: var(--accent);
|
||||
color: white;
|
||||
padding: 0.75rem 1rem;
|
||||
cursor: pointer;
|
||||
}
|
||||
|
||||
button.ghost {
|
||||
background: transparent;
|
||||
color: var(--text);
|
||||
border: 1px solid var(--line);
|
||||
}
|
||||
|
||||
button.danger {
|
||||
color: var(--danger);
|
||||
}
|
||||
|
||||
input,
|
||||
textarea {
|
||||
width: 100%;
|
||||
border-radius: 12px;
|
||||
border: 1px solid var(--line);
|
||||
background: white;
|
||||
padding: 0.75rem 0.875rem;
|
||||
}
|
||||
|
||||
.shell {
|
||||
min-height: 100vh;
|
||||
display: grid;
|
||||
grid-template-columns: 320px 1fr;
|
||||
}
|
||||
|
||||
.sidebar,
|
||||
.content {
|
||||
padding: 1.5rem;
|
||||
}
|
||||
|
||||
.content {
|
||||
display: grid;
|
||||
gap: 1rem;
|
||||
}
|
||||
|
||||
.panel {
|
||||
background: var(--panel);
|
||||
border: 1px solid var(--line);
|
||||
border-radius: 24px;
|
||||
box-shadow: var(--shadow);
|
||||
padding: 1rem;
|
||||
backdrop-filter: blur(12px);
|
||||
}
|
||||
|
||||
.panel-header,
|
||||
.row {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 0.75rem;
|
||||
}
|
||||
|
||||
.between {
|
||||
justify-content: space-between;
|
||||
}
|
||||
|
||||
.hero {
|
||||
padding: 1.5rem;
|
||||
}
|
||||
|
||||
.grid {
|
||||
display: grid;
|
||||
gap: 1rem;
|
||||
grid-template-columns: repeat(2, minmax(0, 1fr));
|
||||
}
|
||||
|
||||
.stack {
|
||||
display: grid;
|
||||
gap: 0.75rem;
|
||||
}
|
||||
|
||||
.list,
|
||||
.timeline {
|
||||
display: grid;
|
||||
gap: 0.75rem;
|
||||
max-height: 32rem;
|
||||
overflow: auto;
|
||||
}
|
||||
|
||||
.timeline.compact {
|
||||
max-height: 24rem;
|
||||
}
|
||||
|
||||
.session-item,
|
||||
.card,
|
||||
.message,
|
||||
.event {
|
||||
border: 1px solid var(--line);
|
||||
border-radius: 18px;
|
||||
background: rgba(255, 255, 255, 0.82);
|
||||
padding: 0.875rem;
|
||||
}
|
||||
|
||||
.session-item {
|
||||
text-align: left;
|
||||
display: grid;
|
||||
gap: 0.35rem;
|
||||
width: 100%;
|
||||
background: white;
|
||||
color: var(--text);
|
||||
}
|
||||
|
||||
.session-item.active {
|
||||
outline: 2px solid rgba(31, 111, 235, 0.2);
|
||||
}
|
||||
|
||||
.message header,
|
||||
.event header {
|
||||
display: flex;
|
||||
justify-content: space-between;
|
||||
font-size: 0.85rem;
|
||||
color: var(--muted);
|
||||
margin-bottom: 0.5rem;
|
||||
}
|
||||
|
||||
.message.manager {
|
||||
background: rgba(31, 111, 235, 0.08);
|
||||
}
|
||||
|
||||
.badge {
|
||||
border-radius: 999px;
|
||||
padding: 0.2rem 0.55rem;
|
||||
font-size: 0.8rem;
|
||||
border: 1px solid var(--line);
|
||||
background: white;
|
||||
}
|
||||
|
||||
.badge.running,
|
||||
.badge.busy {
|
||||
color: var(--accent);
|
||||
}
|
||||
|
||||
.badge.failed,
|
||||
.badge.cancelled,
|
||||
.badge.rejected {
|
||||
color: var(--danger);
|
||||
}
|
||||
|
||||
.badge.completed,
|
||||
.badge.approved,
|
||||
.badge.idle {
|
||||
color: #0f7b55;
|
||||
}
|
||||
|
||||
.tags,
|
||||
.actions {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
gap: 0.5rem;
|
||||
margin-top: 0.75rem;
|
||||
}
|
||||
|
||||
.tags span {
|
||||
border-radius: 999px;
|
||||
padding: 0.18rem 0.5rem;
|
||||
background: rgba(31, 111, 235, 0.1);
|
||||
color: var(--accent);
|
||||
font-size: 0.82rem;
|
||||
}
|
||||
|
||||
.caption,
|
||||
.muted {
|
||||
color: var(--muted);
|
||||
}
|
||||
|
||||
pre {
|
||||
margin: 0;
|
||||
white-space: pre-wrap;
|
||||
word-break: break-word;
|
||||
}
|
||||
|
||||
@media (max-width: 1100px) {
|
||||
.shell {
|
||||
grid-template-columns: 1fr;
|
||||
}
|
||||
|
||||
.grid {
|
||||
grid-template-columns: 1fr;
|
||||
}
|
||||
}
|
||||
656
src/engine.ts
Normal file
656
src/engine.ts
Normal file
@@ -0,0 +1,656 @@
|
||||
import { resolve } from "node:path";
|
||||
import type {
|
||||
ApprovalRequest,
|
||||
AppState,
|
||||
BossEvent,
|
||||
Message,
|
||||
Session,
|
||||
SessionDetails,
|
||||
Task,
|
||||
WorkerNode,
|
||||
} from "./types.js";
|
||||
import { EventBroker } from "./event-broker.js";
|
||||
import { createPlan, buildPlannerMessage, materializeTasks } from "./planner.js";
|
||||
import { chooseAssignmentCandidates } from "./scheduler.js";
|
||||
import { FileStore } from "./store.js";
|
||||
import { createId, now } from "./utils.js";
|
||||
|
||||
const DATA_FILE = resolve(process.cwd(), ".boss-data", "store.json");
|
||||
|
||||
function isActiveTask(task: Task): boolean {
|
||||
return !["completed", "failed", "cancelled"].includes(task.status);
|
||||
}
|
||||
|
||||
export class BossEngine {
|
||||
readonly store = new FileStore(DATA_FILE);
|
||||
readonly events = new EventBroker();
|
||||
|
||||
getState(): AppState {
|
||||
return this.store.snapshot;
|
||||
}
|
||||
|
||||
bootstrap(): AppState {
|
||||
return this.getState();
|
||||
}
|
||||
|
||||
createSession(title?: string): SessionDetails {
|
||||
const timestamp = now();
|
||||
const session: Session = {
|
||||
id: createId("session"),
|
||||
title: title?.trim() || "未命名项目",
|
||||
status: "active",
|
||||
activeObjective: "",
|
||||
lastPlannerSummary: "",
|
||||
createdAt: timestamp,
|
||||
updatedAt: timestamp,
|
||||
};
|
||||
|
||||
this.store.mutate((state) => {
|
||||
state.sessions.unshift(session);
|
||||
state.events.push(
|
||||
this.makeEvent({
|
||||
sessionId: session.id,
|
||||
taskId: null,
|
||||
source: "system",
|
||||
type: "session.created",
|
||||
payload: { title: session.title },
|
||||
}),
|
||||
);
|
||||
});
|
||||
|
||||
this.publishLatestEvent();
|
||||
return this.getSession(session.id);
|
||||
}
|
||||
|
||||
getSession(sessionId: string): SessionDetails {
|
||||
const state = this.getState();
|
||||
const session = state.sessions.find((candidate) => candidate.id === sessionId);
|
||||
if (!session) {
|
||||
throw new Error(`Session not found: ${sessionId}`);
|
||||
}
|
||||
|
||||
return {
|
||||
session,
|
||||
messages: state.messages.filter((message) => message.sessionId === sessionId),
|
||||
tasks: state.tasks.filter((task) => task.sessionId === sessionId),
|
||||
approvals: state.approvals.filter((approval) => approval.sessionId === sessionId),
|
||||
};
|
||||
}
|
||||
|
||||
listSessions(): Session[] {
|
||||
return this.getState().sessions;
|
||||
}
|
||||
|
||||
addMessage(sessionId: string, content: string, channel = "web"): SessionDetails {
|
||||
const session = this.getSession(sessionId).session;
|
||||
const message: Message = {
|
||||
id: createId("msg"),
|
||||
sessionId,
|
||||
role: "user",
|
||||
channel,
|
||||
content: content.trim(),
|
||||
createdAt: now(),
|
||||
};
|
||||
|
||||
if (!message.content) {
|
||||
throw new Error("Message content is required.");
|
||||
}
|
||||
|
||||
this.store.mutate((state) => {
|
||||
const mutableSession = state.sessions.find((candidate) => candidate.id === sessionId);
|
||||
if (!mutableSession) {
|
||||
throw new Error(`Session not found: ${sessionId}`);
|
||||
}
|
||||
|
||||
mutableSession.activeObjective = message.content;
|
||||
mutableSession.updatedAt = message.createdAt;
|
||||
if (!mutableSession.title || mutableSession.title === "未命名项目") {
|
||||
mutableSession.title = message.content.slice(0, 32);
|
||||
}
|
||||
state.messages.push(message);
|
||||
state.events.push(
|
||||
this.makeEvent({
|
||||
sessionId,
|
||||
taskId: null,
|
||||
source: "user",
|
||||
type: "session.message.added",
|
||||
payload: {
|
||||
channel,
|
||||
content: message.content,
|
||||
},
|
||||
}),
|
||||
);
|
||||
});
|
||||
|
||||
this.publishLatestEvent();
|
||||
this.applyPlan(session, message.content);
|
||||
return this.getSession(sessionId);
|
||||
}
|
||||
|
||||
registerWorker(input: {
|
||||
name: string;
|
||||
os: WorkerNode["os"];
|
||||
capabilities: string[];
|
||||
}): WorkerNode {
|
||||
const timestamp = now();
|
||||
const existing = this.getState().workers.find((worker) => worker.name === input.name);
|
||||
if (existing) {
|
||||
return this.updateWorker(existing.id, {
|
||||
os: input.os,
|
||||
capabilities: input.capabilities,
|
||||
status: "idle",
|
||||
load: 0,
|
||||
});
|
||||
}
|
||||
|
||||
const worker: WorkerNode = {
|
||||
id: createId("worker"),
|
||||
name: input.name,
|
||||
os: input.os,
|
||||
capabilities: Array.from(new Set(input.capabilities)),
|
||||
status: "idle",
|
||||
currentTaskId: null,
|
||||
load: 0,
|
||||
lastSeenAt: timestamp,
|
||||
createdAt: timestamp,
|
||||
updatedAt: timestamp,
|
||||
};
|
||||
|
||||
this.store.mutate((state) => {
|
||||
state.workers.push(worker);
|
||||
state.events.push(
|
||||
this.makeEvent({
|
||||
sessionId: null,
|
||||
taskId: null,
|
||||
source: "system",
|
||||
type: "worker.registered",
|
||||
payload: {
|
||||
workerId: worker.id,
|
||||
name: worker.name,
|
||||
os: worker.os,
|
||||
capabilities: worker.capabilities,
|
||||
},
|
||||
}),
|
||||
);
|
||||
});
|
||||
|
||||
this.publishLatestEvent();
|
||||
this.syncAssignments();
|
||||
return worker;
|
||||
}
|
||||
|
||||
updateWorker(
|
||||
workerId: string,
|
||||
input: Partial<Pick<WorkerNode, "os" | "capabilities" | "status" | "load">>,
|
||||
): WorkerNode {
|
||||
let updated!: WorkerNode;
|
||||
this.store.mutate((state) => {
|
||||
const worker = state.workers.find((candidate) => candidate.id === workerId);
|
||||
if (!worker) {
|
||||
throw new Error(`Worker not found: ${workerId}`);
|
||||
}
|
||||
|
||||
if (input.os) worker.os = input.os;
|
||||
if (input.capabilities) worker.capabilities = Array.from(new Set(input.capabilities));
|
||||
if (input.status) worker.status = input.status;
|
||||
if (typeof input.load === "number") worker.load = input.load;
|
||||
worker.updatedAt = now();
|
||||
worker.lastSeenAt = worker.updatedAt;
|
||||
updated = { ...worker };
|
||||
});
|
||||
return updated;
|
||||
}
|
||||
|
||||
heartbeat(workerId: string, load = 0): WorkerNode {
|
||||
let updated!: WorkerNode;
|
||||
this.store.mutate((state) => {
|
||||
const worker = state.workers.find((candidate) => candidate.id === workerId);
|
||||
if (!worker) {
|
||||
throw new Error(`Worker not found: ${workerId}`);
|
||||
}
|
||||
|
||||
worker.lastSeenAt = now();
|
||||
worker.updatedAt = worker.lastSeenAt;
|
||||
worker.load = load;
|
||||
if (!worker.currentTaskId && worker.status !== "offline") {
|
||||
worker.status = "idle";
|
||||
}
|
||||
|
||||
state.events.push(
|
||||
this.makeEvent({
|
||||
sessionId: null,
|
||||
taskId: worker.currentTaskId,
|
||||
source: "worker",
|
||||
type: "worker.heartbeat",
|
||||
payload: {
|
||||
workerId: worker.id,
|
||||
status: worker.status,
|
||||
load: worker.load,
|
||||
},
|
||||
}),
|
||||
);
|
||||
|
||||
updated = { ...worker };
|
||||
});
|
||||
|
||||
this.publishLatestEvent();
|
||||
this.syncAssignments();
|
||||
return updated;
|
||||
}
|
||||
|
||||
claimNextTask(workerId: string): Task | null {
|
||||
let claimedTask: Task | null = null;
|
||||
|
||||
this.store.mutate((state) => {
|
||||
const worker = state.workers.find((candidate) => candidate.id === workerId);
|
||||
if (!worker) {
|
||||
throw new Error(`Worker not found: ${workerId}`);
|
||||
}
|
||||
|
||||
const task = state.tasks.find(
|
||||
(candidate) => candidate.assignedWorkerId === workerId && candidate.status === "assigned",
|
||||
);
|
||||
if (!task) {
|
||||
return;
|
||||
}
|
||||
|
||||
task.status = "running";
|
||||
task.currentStep = "start";
|
||||
task.summary = "任务已被 worker 接收。";
|
||||
task.updatedAt = now();
|
||||
worker.status = "busy";
|
||||
worker.currentTaskId = task.id;
|
||||
worker.updatedAt = task.updatedAt;
|
||||
worker.lastSeenAt = task.updatedAt;
|
||||
|
||||
claimedTask = { ...task };
|
||||
state.events.push(
|
||||
this.makeEvent({
|
||||
sessionId: task.sessionId,
|
||||
taskId: task.id,
|
||||
source: "worker",
|
||||
type: "task.started",
|
||||
payload: {
|
||||
workerId,
|
||||
title: task.title,
|
||||
},
|
||||
}),
|
||||
);
|
||||
});
|
||||
|
||||
if (claimedTask) {
|
||||
this.publishLatestEvent();
|
||||
}
|
||||
|
||||
return claimedTask;
|
||||
}
|
||||
|
||||
reportProgress(
|
||||
taskId: string,
|
||||
workerId: string,
|
||||
input: {
|
||||
progressPercent: number;
|
||||
summary: string;
|
||||
currentStep: string;
|
||||
nextStep: string;
|
||||
},
|
||||
): Task {
|
||||
let updated!: Task;
|
||||
this.store.mutate((state) => {
|
||||
const task = state.tasks.find((candidate) => candidate.id === taskId);
|
||||
if (!task) {
|
||||
throw new Error(`Task not found: ${taskId}`);
|
||||
}
|
||||
|
||||
task.progressPercent = Math.max(0, Math.min(100, input.progressPercent));
|
||||
task.summary = input.summary;
|
||||
task.currentStep = input.currentStep;
|
||||
task.nextStep = input.nextStep;
|
||||
task.updatedAt = now();
|
||||
if (task.status === "assigned") {
|
||||
task.status = "running";
|
||||
}
|
||||
|
||||
state.events.push(
|
||||
this.makeEvent({
|
||||
sessionId: task.sessionId,
|
||||
taskId: task.id,
|
||||
source: "worker",
|
||||
type: "task.progress",
|
||||
payload: {
|
||||
workerId,
|
||||
progressPercent: task.progressPercent,
|
||||
summary: task.summary,
|
||||
currentStep: task.currentStep,
|
||||
nextStep: task.nextStep,
|
||||
},
|
||||
}),
|
||||
);
|
||||
updated = { ...task };
|
||||
});
|
||||
|
||||
this.publishLatestEvent();
|
||||
return updated;
|
||||
}
|
||||
|
||||
completeTask(taskId: string, workerId: string, summary: string): Task {
|
||||
let updated!: Task;
|
||||
|
||||
this.store.mutate((state) => {
|
||||
const task = state.tasks.find((candidate) => candidate.id === taskId);
|
||||
const worker = state.workers.find((candidate) => candidate.id === workerId);
|
||||
if (!task) {
|
||||
throw new Error(`Task not found: ${taskId}`);
|
||||
}
|
||||
if (!worker) {
|
||||
throw new Error(`Worker not found: ${workerId}`);
|
||||
}
|
||||
|
||||
task.status = "completed";
|
||||
task.progressPercent = 100;
|
||||
task.summary = summary;
|
||||
task.currentStep = "done";
|
||||
task.nextStep = "";
|
||||
task.updatedAt = now();
|
||||
worker.status = "idle";
|
||||
worker.currentTaskId = null;
|
||||
worker.updatedAt = task.updatedAt;
|
||||
worker.lastSeenAt = task.updatedAt;
|
||||
|
||||
state.events.push(
|
||||
this.makeEvent({
|
||||
sessionId: task.sessionId,
|
||||
taskId: task.id,
|
||||
source: "worker",
|
||||
type: "task.completed",
|
||||
payload: {
|
||||
workerId,
|
||||
summary,
|
||||
},
|
||||
}),
|
||||
);
|
||||
updated = { ...task };
|
||||
});
|
||||
|
||||
this.publishLatestEvent();
|
||||
this.syncAssignments();
|
||||
return updated;
|
||||
}
|
||||
|
||||
failTask(taskId: string, workerId: string, errorMessage: string): Task {
|
||||
let updated!: Task;
|
||||
|
||||
this.store.mutate((state) => {
|
||||
const task = state.tasks.find((candidate) => candidate.id === taskId);
|
||||
const worker = state.workers.find((candidate) => candidate.id === workerId);
|
||||
if (!task) {
|
||||
throw new Error(`Task not found: ${taskId}`);
|
||||
}
|
||||
if (!worker) {
|
||||
throw new Error(`Worker not found: ${workerId}`);
|
||||
}
|
||||
|
||||
task.status = "failed";
|
||||
task.summary = errorMessage;
|
||||
task.currentStep = "failed";
|
||||
task.nextStep = "";
|
||||
task.updatedAt = now();
|
||||
worker.status = "idle";
|
||||
worker.currentTaskId = null;
|
||||
worker.updatedAt = task.updatedAt;
|
||||
worker.lastSeenAt = task.updatedAt;
|
||||
|
||||
state.events.push(
|
||||
this.makeEvent({
|
||||
sessionId: task.sessionId,
|
||||
taskId: task.id,
|
||||
source: "worker",
|
||||
type: "task.failed",
|
||||
payload: {
|
||||
workerId,
|
||||
errorMessage,
|
||||
},
|
||||
}),
|
||||
);
|
||||
updated = { ...task };
|
||||
});
|
||||
|
||||
this.publishLatestEvent();
|
||||
this.syncAssignments();
|
||||
return updated;
|
||||
}
|
||||
|
||||
pauseTask(taskId: string): Task {
|
||||
return this.transitionTask(taskId, "paused", "system", "task.paused", {
|
||||
summary: "任务已被暂停。",
|
||||
});
|
||||
}
|
||||
|
||||
cancelTask(taskId: string): Task {
|
||||
return this.transitionTask(taskId, "cancelled", "system", "task.cancelled", {
|
||||
summary: "任务已被取消。",
|
||||
});
|
||||
}
|
||||
|
||||
respondApproval(approvalId: string, approved: boolean, responder: string): ApprovalRequest {
|
||||
let updatedApproval!: ApprovalRequest;
|
||||
|
||||
this.store.mutate((state) => {
|
||||
const approval = state.approvals.find((candidate) => candidate.id === approvalId);
|
||||
if (!approval) {
|
||||
throw new Error(`Approval not found: ${approvalId}`);
|
||||
}
|
||||
|
||||
const task = state.tasks.find((candidate) => candidate.id === approval.taskId);
|
||||
if (!task) {
|
||||
throw new Error(`Task not found for approval: ${approval.taskId}`);
|
||||
}
|
||||
|
||||
const timestamp = now();
|
||||
approval.status = approved ? "approved" : "rejected";
|
||||
approval.responder = responder;
|
||||
approval.updatedAt = timestamp;
|
||||
task.approvalStatus = approval.status;
|
||||
task.updatedAt = timestamp;
|
||||
task.status = approved ? "queued" : "cancelled";
|
||||
task.summary = approved ? "审批已通过，重新进入队列。" : "审批被拒绝，任务已取消。";
|
||||
|
||||
state.events.push(
|
||||
this.makeEvent({
|
||||
sessionId: approval.sessionId,
|
||||
taskId: approval.taskId,
|
||||
source: "system",
|
||||
type: approved ? "approval.approved" : "approval.rejected",
|
||||
payload: {
|
||||
approvalId,
|
||||
responder,
|
||||
},
|
||||
}),
|
||||
);
|
||||
updatedApproval = { ...approval };
|
||||
});
|
||||
|
||||
this.publishLatestEvent();
|
||||
this.syncAssignments();
|
||||
return updatedApproval;
|
||||
}
|
||||
|
||||
private applyPlan(session: Session, content: string): void {
|
||||
const sessionDetails = this.getSession(session.id);
|
||||
const result = createPlan(sessionDetails.session, content, sessionDetails.tasks.filter(isActiveTask));
|
||||
const tasks = materializeTasks(session.id, result);
|
||||
const plannerMessage = buildPlannerMessage(result.summary);
|
||||
const timestamp = now();
|
||||
|
||||
this.store.mutate((state) => {
|
||||
const mutableSession = state.sessions.find((candidate) => candidate.id === session.id);
|
||||
if (!mutableSession) {
|
||||
throw new Error(`Session not found: ${session.id}`);
|
||||
}
|
||||
|
||||
mutableSession.activeObjective = content;
|
||||
mutableSession.lastPlannerSummary = plannerMessage;
|
||||
mutableSession.updatedAt = timestamp;
|
||||
|
||||
if (result.pauseExistingTasks) {
|
||||
for (const task of state.tasks.filter(
|
||||
(candidate) => candidate.sessionId === session.id && isActiveTask(candidate),
|
||||
)) {
|
||||
if (["running", "assigned", "queued", "planning", "blocked"].includes(task.status)) {
|
||||
task.status = "paused";
|
||||
task.updatedAt = timestamp;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
state.tasks.push(...tasks);
|
||||
for (const task of tasks) {
|
||||
if (task.approvalStatus === "pending") {
|
||||
state.approvals.push({
|
||||
id: createId("approval"),
|
||||
sessionId: session.id,
|
||||
taskId: task.id,
|
||||
kind: "dangerous_action",
|
||||
summary: `任务 "${task.title}" 包含高风险关键词，需要审批后才能执行。`,
|
||||
riskLevel: "high",
|
||||
status: "pending",
|
||||
requester: "manager",
|
||||
responder: null,
|
||||
createdAt: timestamp,
|
||||
updatedAt: timestamp,
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
const managerMessage: Message = {
|
||||
id: createId("msg"),
|
||||
sessionId: session.id,
|
||||
role: "manager",
|
||||
channel: "system",
|
||||
content: plannerMessage,
|
||||
createdAt: timestamp,
|
||||
};
|
||||
state.messages.push(managerMessage);
|
||||
|
||||
state.events.push(
|
||||
this.makeEvent({
|
||||
sessionId: session.id,
|
||||
taskId: null,
|
||||
source: "manager",
|
||||
type: "plan.created",
|
||||
payload: {
|
||||
summary: result.summary,
|
||||
taskIds: tasks.map((task) => task.id),
|
||||
},
|
||||
}),
|
||||
);
|
||||
});
|
||||
|
||||
this.publishLatestEvent();
|
||||
this.syncAssignments();
|
||||
}
|
||||
|
||||
private transitionTask(
|
||||
taskId: string,
|
||||
status: Task["status"],
|
||||
source: BossEvent["source"],
|
||||
eventType: string,
|
||||
payload: Record<string, unknown>,
|
||||
): Task {
|
||||
let updated!: Task;
|
||||
this.store.mutate((state) => {
|
||||
const task = state.tasks.find((candidate) => candidate.id === taskId);
|
||||
if (!task) {
|
||||
throw new Error(`Task not found: ${taskId}`);
|
||||
}
|
||||
|
||||
task.status = status;
|
||||
task.updatedAt = now();
|
||||
task.summary = typeof payload.summary === "string" ? payload.summary : task.summary;
|
||||
|
||||
if (task.assignedWorkerId) {
|
||||
const worker = state.workers.find((candidate) => candidate.id === task.assignedWorkerId);
|
||||
if (worker && worker.currentTaskId === task.id) {
|
||||
worker.currentTaskId = null;
|
||||
worker.status = "idle";
|
||||
worker.updatedAt = task.updatedAt;
|
||||
worker.lastSeenAt = task.updatedAt;
|
||||
}
|
||||
}
|
||||
|
||||
state.events.push(
|
||||
this.makeEvent({
|
||||
sessionId: task.sessionId,
|
||||
taskId: task.id,
|
||||
source,
|
||||
type: eventType,
|
||||
payload,
|
||||
}),
|
||||
);
|
||||
updated = { ...task };
|
||||
});
|
||||
|
||||
this.publishLatestEvent();
|
||||
this.syncAssignments();
|
||||
return updated;
|
||||
}
|
||||
|
||||
private syncAssignments(): void {
|
||||
const candidates = chooseAssignmentCandidates(this.getState());
|
||||
if (candidates.length === 0) {
|
||||
return;
|
||||
}
|
||||
|
||||
this.store.mutate((state) => {
|
||||
for (const candidate of candidates) {
|
||||
const task = state.tasks.find((item) => item.id === candidate.taskId);
|
||||
const worker = state.workers.find((item) => item.id === candidate.workerId);
|
||||
if (!task || !worker || task.status !== "queued" || worker.status !== "idle") {
|
||||
continue;
|
||||
}
|
||||
|
||||
const timestamp = now();
|
||||
task.status = "assigned";
|
||||
task.assignedWorkerId = worker.id;
|
||||
task.updatedAt = timestamp;
|
||||
task.summary = `已分配给 ${worker.name}`;
|
||||
worker.status = "busy";
|
||||
worker.currentTaskId = task.id;
|
||||
worker.updatedAt = timestamp;
|
||||
worker.lastSeenAt = timestamp;
|
||||
|
||||
state.events.push(
|
||||
this.makeEvent({
|
||||
sessionId: task.sessionId,
|
||||
taskId: task.id,
|
||||
source: "system",
|
||||
type: "task.assigned",
|
||||
payload: {
|
||||
workerId: worker.id,
|
||||
workerName: worker.name,
|
||||
},
|
||||
}),
|
||||
);
|
||||
}
|
||||
});
|
||||
|
||||
this.publishLatestEvent();
|
||||
}
|
||||
|
||||
private publishLatestEvent(): void {
|
||||
const state = this.getState();
|
||||
const latestEvent = state.events[state.events.length - 1];
|
||||
if (latestEvent) {
|
||||
this.events.publish(latestEvent);
|
||||
}
|
||||
}
|
||||
|
||||
private makeEvent(input: Omit<BossEvent, "id" | "timestamp">): BossEvent {
|
||||
return {
|
||||
id: createId("evt"),
|
||||
timestamp: now(),
|
||||
...input,
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
19
src/event-broker.ts
Normal file
19
src/event-broker.ts
Normal file
@@ -0,0 +1,19 @@
|
||||
import type { BossEvent } from "./types.js";
|
||||
|
||||
type Listener = (event: BossEvent) => void;
|
||||
|
||||
export class EventBroker {
|
||||
private readonly listeners = new Set<Listener>();
|
||||
|
||||
subscribe(listener: Listener): () => void {
|
||||
this.listeners.add(listener);
|
||||
return () => this.listeners.delete(listener);
|
||||
}
|
||||
|
||||
publish(event: BossEvent): void {
|
||||
for (const listener of this.listeners) {
|
||||
listener(event);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
181
src/planner.ts
Normal file
181
src/planner.ts
Normal file
@@ -0,0 +1,181 @@
|
||||
import type { Session, Task } from "./types.js";
|
||||
import { containsKeyword, createId, now } from "./utils.js";
|
||||
|
||||
interface DraftTask {
|
||||
title: string;
|
||||
description: string;
|
||||
kind: string;
|
||||
requiredOs: Task["requiredOs"];
|
||||
requiredCapabilities: string[];
|
||||
priority: Task["priority"];
|
||||
dependencyIndexes: number[];
|
||||
approvalStatus: Task["approvalStatus"];
|
||||
}
|
||||
|
||||
export interface PlannerResult {
|
||||
summary: string;
|
||||
tasks: DraftTask[];
|
||||
pauseExistingTasks: boolean;
|
||||
}
|
||||
|
||||
function inferRequiredOs(content: string): Task["requiredOs"] {
|
||||
if (containsKeyword(content, ["mac", "macos", "xcode", "ios", "swift"])) {
|
||||
return "macos";
|
||||
}
|
||||
|
||||
if (containsKeyword(content, ["windows", "win", "powershell", ".exe", "注册表"])) {
|
||||
return "windows";
|
||||
}
|
||||
|
||||
return "any";
|
||||
}
|
||||
|
||||
function inferCapabilities(content: string): string[] {
|
||||
const capabilities = ["terminal"];
|
||||
|
||||
if (containsKeyword(content, ["ui", "browser", "web", "playwright", "页面", "前端"])) {
|
||||
capabilities.push("browser");
|
||||
}
|
||||
|
||||
if (containsKeyword(content, ["test", "测试", "验证", "ci"])) {
|
||||
capabilities.push("test");
|
||||
}
|
||||
|
||||
return Array.from(new Set(capabilities));
|
||||
}
|
||||
|
||||
function requiresApproval(content: string): boolean {
|
||||
return containsKeyword(content, [
|
||||
"rm -rf",
|
||||
"delete",
|
||||
"删除",
|
||||
"force push",
|
||||
"强推",
|
||||
"drop database",
|
||||
]);
|
||||
}
|
||||
|
||||
export function createPlan(session: Session, content: string, activeTasks: Task[]): PlannerResult {
|
||||
const baseOs = inferRequiredOs(content);
|
||||
const baseCapabilities = inferCapabilities(content);
|
||||
const approvalStatus = requiresApproval(content) ? "pending" : "not_required";
|
||||
const pauseExistingTasks = activeTasks.some((task) =>
|
||||
["planning", "queued", "assigned", "running", "paused", "blocked"].includes(task.status),
|
||||
);
|
||||
const replan = pauseExistingTasks;
|
||||
|
||||
if (containsKeyword(content, ["调研", "研究", "定位", "排查", "分析"])) {
|
||||
return {
|
||||
summary: replan
|
||||
? `已根据新要求重排调研任务：${content}`
|
||||
: `已生成调研型任务树：${content}`,
|
||||
pauseExistingTasks: replan,
|
||||
tasks: [
|
||||
{
|
||||
title: "并行收集线索与上下文",
|
||||
description: `围绕目标开展初步调研：${content}`,
|
||||
kind: "research",
|
||||
requiredOs: "any",
|
||||
requiredCapabilities: ["terminal"],
|
||||
priority: "high",
|
||||
dependencyIndexes: [],
|
||||
approvalStatus,
|
||||
},
|
||||
{
|
||||
title: "定位问题根因或约束",
|
||||
description: `在合适设备上并行定位问题：${content}`,
|
||||
kind: "investigation",
|
||||
requiredOs: baseOs,
|
||||
requiredCapabilities: baseCapabilities,
|
||||
priority: "high",
|
||||
dependencyIndexes: [],
|
||||
approvalStatus,
|
||||
},
|
||||
{
|
||||
title: "整理结论与执行建议",
|
||||
description: "汇总两条并行调研结果，并输出下一步建议。",
|
||||
kind: "summary",
|
||||
requiredOs: "any",
|
||||
requiredCapabilities: ["terminal"],
|
||||
priority: "medium",
|
||||
dependencyIndexes: [0, 1],
|
||||
approvalStatus: "not_required",
|
||||
},
|
||||
],
|
||||
};
|
||||
}
|
||||
|
||||
return {
|
||||
summary: replan
|
||||
? `已根据最新需求重排执行计划：${content}`
|
||||
: `已生成执行型任务树：${content}`,
|
||||
pauseExistingTasks: replan,
|
||||
tasks: [
|
||||
{
|
||||
title: "分析需求并准备执行环境",
|
||||
description: `分析用户目标并确认执行边界：${content}`,
|
||||
kind: "planning",
|
||||
requiredOs: "any",
|
||||
requiredCapabilities: ["terminal"],
|
||||
priority: "high",
|
||||
dependencyIndexes: [],
|
||||
approvalStatus: "not_required",
|
||||
},
|
||||
{
|
||||
title: "实现核心变更",
|
||||
description: `在匹配设备上执行主任务：${content}`,
|
||||
kind: "implementation",
|
||||
requiredOs: baseOs,
|
||||
requiredCapabilities: baseCapabilities,
|
||||
priority: "high",
|
||||
dependencyIndexes: [0],
|
||||
approvalStatus,
|
||||
},
|
||||
{
|
||||
title: "验证结果并整理回报",
|
||||
description: "运行验证步骤，输出风险和下一步建议。",
|
||||
kind: "validation",
|
||||
requiredOs: "any",
|
||||
requiredCapabilities: Array.from(new Set([...baseCapabilities, "test"])),
|
||||
priority: "medium",
|
||||
dependencyIndexes: [1],
|
||||
approvalStatus: "not_required",
|
||||
},
|
||||
],
|
||||
};
|
||||
}
|
||||
|
||||
export function materializeTasks(sessionId: string, result: PlannerResult): Task[] {
|
||||
const createdAt = now();
|
||||
const placeholders = result.tasks.map((draft) => ({
|
||||
id: createId("task"),
|
||||
draft,
|
||||
}));
|
||||
|
||||
return placeholders.map(({ id, draft }) => ({
|
||||
id,
|
||||
sessionId,
|
||||
parentTaskId: null,
|
||||
title: draft.title,
|
||||
description: draft.description,
|
||||
kind: draft.kind,
|
||||
status: draft.approvalStatus === "pending" ? "waiting_approval" : "queued",
|
||||
priority: draft.priority,
|
||||
requiredOs: draft.requiredOs,
|
||||
requiredCapabilities: draft.requiredCapabilities,
|
||||
dependencyIds: draft.dependencyIndexes.map((index) => placeholders[index].id),
|
||||
assignedWorkerId: null,
|
||||
approvalStatus: draft.approvalStatus,
|
||||
progressPercent: 0,
|
||||
summary: "",
|
||||
currentStep: "",
|
||||
nextStep: "",
|
||||
createdAt,
|
||||
updatedAt: createdAt,
|
||||
}));
|
||||
}
|
||||
|
||||
export function buildPlannerMessage(summary: string): string {
|
||||
return `${summary}。系统会继续调度可执行子任务，并在需要审批时暂停。`;
|
||||
}
|
||||
|
||||
64
src/scheduler.ts
Normal file
64
src/scheduler.ts
Normal file
@@ -0,0 +1,64 @@
|
||||
import type { AppState, Task, WorkerNode } from "./types.js";
|
||||
|
||||
function dependenciesSatisfied(task: Task, state: AppState): boolean {
|
||||
return task.dependencyIds.every((dependencyId) => {
|
||||
const dependency = state.tasks.find((candidate) => candidate.id === dependencyId);
|
||||
return dependency?.status === "completed";
|
||||
});
|
||||
}
|
||||
|
||||
function workerIsIdle(worker: WorkerNode): boolean {
|
||||
return worker.status === "idle" && !worker.currentTaskId;
|
||||
}
|
||||
|
||||
function scoreWorker(task: Task, worker: WorkerNode): number {
|
||||
let score = 0;
|
||||
|
||||
if (task.requiredOs === "any" || task.requiredOs === worker.os) {
|
||||
score += 10;
|
||||
}
|
||||
|
||||
for (const capability of task.requiredCapabilities) {
|
||||
if (worker.capabilities.includes(capability)) {
|
||||
score += 4;
|
||||
}
|
||||
}
|
||||
|
||||
return score - worker.load;
|
||||
}
|
||||
|
||||
export function chooseAssignmentCandidates(state: AppState): Array<{
|
||||
taskId: string;
|
||||
workerId: string;
|
||||
}> {
|
||||
const tasks = state.tasks
|
||||
.filter((task) => task.status === "queued" && dependenciesSatisfied(task, state))
|
||||
.sort((left, right) => left.createdAt.localeCompare(right.createdAt));
|
||||
const availableWorkers = new Map(
|
||||
state.workers.filter(workerIsIdle).map((worker) => [worker.id, worker]),
|
||||
);
|
||||
const assignments: Array<{ taskId: string; workerId: string }> = [];
|
||||
|
||||
for (const task of tasks) {
|
||||
let bestWorker: WorkerNode | null = null;
|
||||
let bestScore = Number.NEGATIVE_INFINITY;
|
||||
|
||||
for (const worker of availableWorkers.values()) {
|
||||
const score = scoreWorker(task, worker);
|
||||
if (score > bestScore) {
|
||||
bestScore = score;
|
||||
bestWorker = worker;
|
||||
}
|
||||
}
|
||||
|
||||
if (!bestWorker || bestScore < 0) {
|
||||
continue;
|
||||
}
|
||||
|
||||
assignments.push({ taskId: task.id, workerId: bestWorker.id });
|
||||
availableWorkers.delete(bestWorker.id);
|
||||
}
|
||||
|
||||
return assignments;
|
||||
}
|
||||
|
||||
153
src/server.ts
Normal file
153
src/server.ts
Normal file
@@ -0,0 +1,153 @@
|
||||
import path from "node:path";
|
||||
import Fastify from "fastify";
|
||||
import fastifyStatic from "@fastify/static";
|
||||
import { BossEngine } from "./engine.js";
|
||||
|
||||
const engine = new BossEngine();
|
||||
const app = Fastify({ logger: true });
|
||||
|
||||
await app.register(fastifyStatic, {
|
||||
root: path.resolve(process.cwd(), "public"),
|
||||
prefix: "/",
|
||||
});
|
||||
|
||||
function ok() {
|
||||
return { ok: true };
|
||||
}
|
||||
|
||||
app.get("/api/health", async () => ({
|
||||
status: "ok",
|
||||
sessions: engine.getState().sessions.length,
|
||||
workers: engine.getState().workers.length,
|
||||
}));
|
||||
|
||||
app.get("/api/bootstrap", async () => engine.bootstrap());
|
||||
|
||||
app.get("/api/sessions", async () => engine.listSessions());
|
||||
|
||||
app.post("/api/sessions", async (request) => {
|
||||
const body = (request.body ?? {}) as { title?: string };
|
||||
return engine.createSession(body.title);
|
||||
});
|
||||
|
||||
app.get("/api/sessions/:sessionId", async (request) => {
|
||||
const params = request.params as { sessionId: string };
|
||||
return engine.getSession(params.sessionId);
|
||||
});
|
||||
|
||||
app.post("/api/sessions/:sessionId/messages", async (request) => {
|
||||
const params = request.params as { sessionId: string };
|
||||
const body = (request.body ?? {}) as { content?: string; channel?: string };
|
||||
return engine.addMessage(params.sessionId, body.content ?? "", body.channel ?? "web");
|
||||
});
|
||||
|
||||
app.get("/api/events/stream", async (_request, reply) => {
|
||||
reply.raw.setHeader("Content-Type", "text/event-stream");
|
||||
reply.raw.setHeader("Cache-Control", "no-cache");
|
||||
reply.raw.setHeader("Connection", "keep-alive");
|
||||
reply.raw.flushHeaders?.();
|
||||
|
||||
const unsubscribe = engine.events.subscribe((event) => {
|
||||
reply.raw.write(`data: ${JSON.stringify(event)}\n\n`);
|
||||
});
|
||||
|
||||
const interval = setInterval(() => {
|
||||
reply.raw.write(": ping\n\n");
|
||||
}, 15_000);
|
||||
|
||||
reply.raw.on("close", () => {
|
||||
clearInterval(interval);
|
||||
unsubscribe();
|
||||
reply.raw.end();
|
||||
});
|
||||
});
|
||||
|
||||
app.get("/api/workers", async () => engine.getState().workers);
|
||||
|
||||
app.post("/api/workers/register", async (request) => {
|
||||
const body = request.body as {
|
||||
name?: string;
|
||||
os?: "windows" | "macos" | "linux";
|
||||
capabilities?: string[];
|
||||
};
|
||||
return engine.registerWorker({
|
||||
name: body.name ?? "worker",
|
||||
os: body.os ?? "linux",
|
||||
capabilities: body.capabilities ?? ["terminal"],
|
||||
});
|
||||
});
|
||||
|
||||
app.post("/api/workers/:workerId/heartbeat", async (request) => {
|
||||
const params = request.params as { workerId: string };
|
||||
const body = (request.body ?? {}) as { load?: number };
|
||||
return engine.heartbeat(params.workerId, body.load ?? 0);
|
||||
});
|
||||
|
||||
app.post("/api/workers/:workerId/claim-next", async (request) => {
|
||||
const params = request.params as { workerId: string };
|
||||
return {
|
||||
task: engine.claimNextTask(params.workerId),
|
||||
};
|
||||
});
|
||||
|
||||
app.post("/api/tasks/:taskId/progress", async (request) => {
|
||||
const params = request.params as { taskId: string };
|
||||
const body = request.body as {
|
||||
workerId: string;
|
||||
progressPercent: number;
|
||||
summary: string;
|
||||
currentStep: string;
|
||||
nextStep: string;
|
||||
};
|
||||
return engine.reportProgress(params.taskId, body.workerId, {
|
||||
progressPercent: body.progressPercent,
|
||||
summary: body.summary,
|
||||
currentStep: body.currentStep,
|
||||
nextStep: body.nextStep,
|
||||
});
|
||||
});
|
||||
|
||||
app.post("/api/tasks/:taskId/complete", async (request) => {
|
||||
const params = request.params as { taskId: string };
|
||||
const body = request.body as {
|
||||
workerId: string;
|
||||
summary: string;
|
||||
};
|
||||
return engine.completeTask(params.taskId, body.workerId, body.summary);
|
||||
});
|
||||
|
||||
app.post("/api/tasks/:taskId/fail", async (request) => {
|
||||
const params = request.params as { taskId: string };
|
||||
const body = request.body as {
|
||||
workerId: string;
|
||||
errorMessage: string;
|
||||
};
|
||||
return engine.failTask(params.taskId, body.workerId, body.errorMessage);
|
||||
});
|
||||
|
||||
app.post("/api/tasks/:taskId/pause", async (request) => {
|
||||
const params = request.params as { taskId: string };
|
||||
return engine.pauseTask(params.taskId);
|
||||
});
|
||||
|
||||
app.post("/api/tasks/:taskId/cancel", async (request) => {
|
||||
const params = request.params as { taskId: string };
|
||||
return engine.cancelTask(params.taskId);
|
||||
});
|
||||
|
||||
app.post("/api/approvals/:approvalId/respond", async (request) => {
|
||||
const params = request.params as { approvalId: string };
|
||||
const body = request.body as {
|
||||
approved: boolean;
|
||||
responder?: string;
|
||||
};
|
||||
return engine.respondApproval(params.approvalId, body.approved, body.responder ?? "user");
|
||||
});
|
||||
|
||||
app.post("/api/demo/reset", async () => {
|
||||
engine.store.reset();
|
||||
return ok();
|
||||
});
|
||||
|
||||
const port = Number(process.env.PORT ?? 43210);
|
||||
await app.listen({ port, host: "0.0.0.0" });
|
||||
61
src/store.ts
Normal file
61
src/store.ts
Normal file
@@ -0,0 +1,61 @@
|
||||
import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
|
||||
import { dirname } from "node:path";
|
||||
import type { AppState } from "./types.js";
|
||||
|
||||
function defaultState(): AppState {
|
||||
return {
|
||||
sessions: [],
|
||||
messages: [],
|
||||
tasks: [],
|
||||
workers: [],
|
||||
approvals: [],
|
||||
events: [],
|
||||
};
|
||||
}
|
||||
|
||||
export class FileStore {
|
||||
private state: AppState;
|
||||
|
||||
constructor(private readonly filePath: string) {
|
||||
this.ensureDirectory();
|
||||
this.state = this.load();
|
||||
}
|
||||
|
||||
get snapshot(): AppState {
|
||||
return structuredClone(this.state);
|
||||
}
|
||||
|
||||
mutate<T>(mutator: (state: AppState) => T): T {
|
||||
const result = mutator(this.state);
|
||||
this.save();
|
||||
return result;
|
||||
}
|
||||
|
||||
reset(): AppState {
|
||||
this.state = defaultState();
|
||||
this.save();
|
||||
return this.snapshot;
|
||||
}
|
||||
|
||||
private ensureDirectory(): void {
|
||||
mkdirSync(dirname(this.filePath), { recursive: true });
|
||||
}
|
||||
|
||||
private load(): AppState {
|
||||
if (!existsSync(this.filePath)) {
|
||||
return defaultState();
|
||||
}
|
||||
|
||||
try {
|
||||
const raw = readFileSync(this.filePath, "utf8");
|
||||
return { ...defaultState(), ...(JSON.parse(raw) as AppState) };
|
||||
} catch {
|
||||
return defaultState();
|
||||
}
|
||||
}
|
||||
|
||||
private save(): void {
|
||||
writeFileSync(this.filePath, `${JSON.stringify(this.state, null, 2)}\n`, "utf8");
|
||||
}
|
||||
}
|
||||
|
||||
110
src/types.ts
Normal file
110
src/types.ts
Normal file
@@ -0,0 +1,110 @@
|
||||
export type SessionStatus = "active" | "archived";
|
||||
export type TaskStatus =
|
||||
| "planning"
|
||||
| "queued"
|
||||
| "assigned"
|
||||
| "running"
|
||||
| "blocked"
|
||||
| "paused"
|
||||
| "waiting_approval"
|
||||
| "completed"
|
||||
| "failed"
|
||||
| "cancelled";
|
||||
export type WorkerStatus = "idle" | "busy" | "offline";
|
||||
export type ApprovalStatus = "pending" | "approved" | "rejected";
|
||||
export type RiskLevel = "low" | "medium" | "high";
|
||||
|
||||
export interface Session {
|
||||
id: string;
|
||||
title: string;
|
||||
status: SessionStatus;
|
||||
activeObjective: string;
|
||||
lastPlannerSummary: string;
|
||||
createdAt: string;
|
||||
updatedAt: string;
|
||||
}
|
||||
|
||||
export interface Message {
|
||||
id: string;
|
||||
sessionId: string;
|
||||
role: "user" | "manager" | "system";
|
||||
channel: string;
|
||||
content: string;
|
||||
createdAt: string;
|
||||
}
|
||||
|
||||
export interface Task {
|
||||
id: string;
|
||||
sessionId: string;
|
||||
parentTaskId: string | null;
|
||||
title: string;
|
||||
description: string;
|
||||
kind: string;
|
||||
status: TaskStatus;
|
||||
priority: "low" | "medium" | "high";
|
||||
requiredOs: "any" | "windows" | "macos" | "linux";
|
||||
requiredCapabilities: string[];
|
||||
dependencyIds: string[];
|
||||
assignedWorkerId: string | null;
|
||||
approvalStatus: "not_required" | ApprovalStatus;
|
||||
progressPercent: number;
|
||||
summary: string;
|
||||
currentStep: string;
|
||||
nextStep: string;
|
||||
createdAt: string;
|
||||
updatedAt: string;
|
||||
}
|
||||
|
||||
export interface WorkerNode {
|
||||
id: string;
|
||||
name: string;
|
||||
os: "windows" | "macos" | "linux";
|
||||
capabilities: string[];
|
||||
status: WorkerStatus;
|
||||
currentTaskId: string | null;
|
||||
load: number;
|
||||
lastSeenAt: string;
|
||||
createdAt: string;
|
||||
updatedAt: string;
|
||||
}
|
||||
|
||||
export interface ApprovalRequest {
|
||||
id: string;
|
||||
sessionId: string;
|
||||
taskId: string;
|
||||
kind: string;
|
||||
summary: string;
|
||||
riskLevel: RiskLevel;
|
||||
status: ApprovalStatus;
|
||||
requester: string;
|
||||
responder: string | null;
|
||||
createdAt: string;
|
||||
updatedAt: string;
|
||||
}
|
||||
|
||||
export interface BossEvent {
|
||||
id: string;
|
||||
sessionId: string | null;
|
||||
taskId: string | null;
|
||||
source: "user" | "manager" | "system" | "worker";
|
||||
type: string;
|
||||
timestamp: string;
|
||||
payload: Record<string, unknown>;
|
||||
}
|
||||
|
||||
export interface AppState {
|
||||
sessions: Session[];
|
||||
messages: Message[];
|
||||
tasks: Task[];
|
||||
workers: WorkerNode[];
|
||||
approvals: ApprovalRequest[];
|
||||
events: BossEvent[];
|
||||
}
|
||||
|
||||
export interface SessionDetails {
|
||||
session: Session;
|
||||
messages: Message[];
|
||||
tasks: Task[];
|
||||
approvals: ApprovalRequest[];
|
||||
}
|
||||
|
||||
15
src/utils.ts
Normal file
15
src/utils.ts
Normal file
@@ -0,0 +1,15 @@
|
||||
import { randomUUID } from "node:crypto";
|
||||
|
||||
export function createId(prefix: string): string {
|
||||
return `${prefix}_${randomUUID().replace(/-/g, "").slice(0, 12)}`;
|
||||
}
|
||||
|
||||
export function now(): string {
|
||||
return new Date().toISOString();
|
||||
}
|
||||
|
||||
export function containsKeyword(input: string, keywords: string[]): boolean {
|
||||
const normalized = input.toLowerCase();
|
||||
return keywords.some((keyword) => normalized.includes(keyword.toLowerCase()));
|
||||
}
|
||||
|
||||
130
src/worker.ts
Normal file
130
src/worker.ts
Normal file
@@ -0,0 +1,130 @@
|
||||
import { setTimeout as delay } from "node:timers/promises";
|
||||
|
||||
interface Task {
|
||||
id: string;
|
||||
title: string;
|
||||
description: string;
|
||||
kind: string;
|
||||
}
|
||||
|
||||
function parseArgs(argv: string[]) {
|
||||
const options = {
|
||||
name: "",
|
||||
os: "linux",
|
||||
capabilities: ["terminal"],
|
||||
server: "http://127.0.0.1:43210",
|
||||
};
|
||||
|
||||
for (let index = 0; index < argv.length; index += 1) {
|
||||
const token = argv[index];
|
||||
if (token === "--name") {
|
||||
options.name = argv[index + 1] ?? "";
|
||||
index += 1;
|
||||
} else if (token === "--os") {
|
||||
options.os = argv[index + 1] ?? "linux";
|
||||
index += 1;
|
||||
} else if (token === "--capability") {
|
||||
options.capabilities.push(argv[index + 1] ?? "terminal");
|
||||
index += 1;
|
||||
} else if (token === "--server") {
|
||||
options.server = argv[index + 1] ?? options.server;
|
||||
index += 1;
|
||||
}
|
||||
}
|
||||
|
||||
if (!options.name) {
|
||||
throw new Error("Usage: npm run worker -- --name <worker-name> [--os windows|macos|linux]");
|
||||
}
|
||||
|
||||
options.capabilities = Array.from(new Set(options.capabilities));
|
||||
return options;
|
||||
}
|
||||
|
||||
async function postJson(url: string, body: unknown) {
|
||||
const response = await fetch(url, {
|
||||
method: "POST",
|
||||
headers: { "Content-Type": "application/json" },
|
||||
body: JSON.stringify(body),
|
||||
});
|
||||
|
||||
if (!response.ok) {
|
||||
throw new Error(`Request failed: ${response.status} ${response.statusText}`);
|
||||
}
|
||||
|
||||
return response.json();
|
||||
}
|
||||
|
||||
async function simulateTask(server: string, workerId: string, task: Task) {
|
||||
const steps = [
|
||||
{
|
||||
progressPercent: 20,
|
||||
summary: `${task.title}: 收集上下文和工作目录`,
|
||||
currentStep: "prepare",
|
||||
nextStep: "inspect",
|
||||
},
|
||||
{
|
||||
progressPercent: 55,
|
||||
summary: `${task.title}: 正在执行主要步骤`,
|
||||
currentStep: "execute",
|
||||
nextStep: "verify",
|
||||
},
|
||||
{
|
||||
progressPercent: 85,
|
||||
summary: `${task.title}: 正在整理结果`,
|
||||
currentStep: "summarize",
|
||||
nextStep: "complete",
|
||||
},
|
||||
];
|
||||
|
||||
for (const step of steps) {
|
||||
await delay(1_500);
|
||||
await postJson(`${server}/api/tasks/${task.id}/progress`, {
|
||||
workerId,
|
||||
...step,
|
||||
});
|
||||
}
|
||||
|
||||
await delay(1_000);
|
||||
await postJson(`${server}/api/tasks/${task.id}/complete`, {
|
||||
workerId,
|
||||
summary: `${task.title} 已完成。`,
|
||||
});
|
||||
}
|
||||
|
||||
async function main() {
|
||||
const options = parseArgs(process.argv.slice(2));
|
||||
const worker = (await postJson(`${options.server}/api/workers/register`, {
|
||||
name: options.name,
|
||||
os: options.os,
|
||||
capabilities: options.capabilities,
|
||||
})) as { id: string; name: string };
|
||||
|
||||
console.log(`worker ready: ${worker.name} (${worker.id})`);
|
||||
|
||||
for (;;) {
|
||||
await postJson(`${options.server}/api/workers/${worker.id}/heartbeat`, { load: 0 });
|
||||
const response = (await postJson(`${options.server}/api/workers/${worker.id}/claim-next`, {})) as {
|
||||
task: Task | null;
|
||||
};
|
||||
|
||||
if (response.task) {
|
||||
console.log(`claimed task: ${response.task.title}`);
|
||||
try {
|
||||
await simulateTask(options.server, worker.id, response.task);
|
||||
} catch (error) {
|
||||
const message = error instanceof Error ? error.message : "unknown error";
|
||||
await postJson(`${options.server}/api/tasks/${response.task.id}/fail`, {
|
||||
workerId: worker.id,
|
||||
errorMessage: message,
|
||||
});
|
||||
}
|
||||
} else {
|
||||
await delay(2_500);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
main().catch((error) => {
|
||||
console.error(error);
|
||||
process.exit(1);
|
||||
});
|
||||
16
tsconfig.json
Normal file
16
tsconfig.json
Normal file
@@ -0,0 +1,16 @@
|
||||
{
|
||||
"compilerOptions": {
|
||||
"target": "ES2022",
|
||||
"module": "NodeNext",
|
||||
"moduleResolution": "NodeNext",
|
||||
"lib": ["ES2022", "DOM"],
|
||||
"outDir": "dist",
|
||||
"rootDir": "src",
|
||||
"strict": true,
|
||||
"esModuleInterop": true,
|
||||
"forceConsistentCasingInFileNames": true,
|
||||
"skipLibCheck": true
|
||||
},
|
||||
"include": ["src/**/*.ts"]
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user