# Phase TS-5：Commander 派发闭环

日期：2026-04-08
状态：待实施

---

## 1. 阶段目标

把“交给指挥官执行”从 UI 字段变成真实执行链路，并把执行状态回写到业务任务、Today Status 与 Schedule Center。

---

## 2. 详细任务

### 2.1 新增 dispatch API

**文件**：
- `backend/app/routers/task.py`
- `backend/app/schemas/task.py`
- `frontend/src/api/task.ts`

建议接口：
- `POST /api/tasks/{id}/dispatch`
- `POST /api/tasks/{id}/subtasks/{subtask_id}/dispatch`

### 2.2 业务 task -> commander payload 映射

需要定义 payload，建议至少包含：
- `business_task_id`
- `title`
- `description`
- `subtasks`
- `priority`
- `due_date`
- `conversation_id`
- `user_id`

### 2.3 commander 执行态回写

需要回写业务字段：
- `dispatch_status`
- `dispatch_run_id`
- `result_summary`
- 必要时同步 task / subtask 状态

### 2.4 前端状态展示

**文件**：
- `frontend/src/components/chat/KanbanDetail.vue`
- `frontend/src/pages/chat/composables/useSidebarPlan.ts`
- `frontend/src/pages/schedule-center/composables/useScheduleCenterPage.ts`

需要完成：
- 详情页显示 `queued / running / completed / failed`
- Today Status 聚合显示 `commander_summary`
- Schedule Center detail 可见调度状态

---

## 3. 设计原则

1. **assignee 与 dispatch 分离**
   - `assignee_type=commander` 不等于已经派发执行。
2. **业务层与 runtime 层分离**
   - runtime 负责执行，业务 task 负责长期状态。
3. **Today Status 与 Schedule Center 状态一致**
   - 不允许首页和调度页看到不同状态。

---

## 4. 核心文件清单

| 文件 | 操作 | 说明 |
|------|------|------|
| `backend/app/routers/task.py` | 修改 | 新增 dispatch API |
| commander / orchestration service | 修改 | 业务 task 派发到执行层 |
| `frontend/src/api/task.ts` | 修改 | dispatch API 封装 |
| `frontend/src/components/chat/KanbanDetail.vue` | 修改 | 派发入口与状态展示 |
| `frontend/src/pages/chat/composables/useSidebarPlan.ts` | 修改 | commander summary 展示 |
| `frontend/src/pages/schedule-center/composables/useScheduleCenterPage.ts` | 修改 | 调度状态联动 |

---

## 5. 验收标准

- [ ] 任务可派发给 commander
- [ ] 子任务可派发给 commander
- [ ] Today Status 能看到 commander 状态变化
- [ ] Schedule Center 与 Chat 首页状态一致
- [ ] 业务模型与 runtime 模型保持分层

---

## 6. 依赖关系

```text
依赖：Phase TS-1 / TS-2 / TS-4
```