feat(docs): add development documentation, prototypes, and war-room components

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
2026-04-11 08:49:41 +08:00
parent 1ca8855751
commit 21c869db62
1218 changed files with 11858 additions and 0 deletions
--- a/development-doc/plan/today-status-update/README.md
+++ b/development-doc/plan/today-status-update/README.md
@@ -0,0 +1,122 @@
+# Today Status 完整化实施计划索引
+
+本目录用于存放首页 `Today Status` 完整化的分阶段规划文档，目标是先完成文档拆解，再交给 Codex 按阶段实施。
+
+## 文档说明
+
+| 文件 | 说明 |
+|------|------|
+| `README.md` | 总览、阶段关系、实施顺序、关键文件 |
+| `phase-ts-0-current-state.md` | 当前现状、问题、目标架构 |
+| `phase-ts-1-business-task-model.md` | 业务 Task / SubTask / 分配模型扩展 |
+| `phase-ts-2-task-api-and-schedule-aggregation.md` | Task API 与 Schedule Center 聚合扩展 |
+| `phase-ts-3-chat-today-status-integration.md` | Chat 首页 Today Status 接真实数据 |
+| `phase-ts-4-manual-create-and-detail-editor.md` | 手动创建与详情编辑器 |
+| `phase-ts-5-commander-dispatch.md` | Commander 派发闭环 |
+| `checklist.md` | 给 Codex 使用的可勾选执行清单 |
+
+## 推荐阅读顺序
+
+1. 先阅读 `phase-ts-0-current-state.md`
+2. 再按顺序阅读 `phase-ts-1` ~ `phase-ts-5`
+3. 实施时严格按阶段推进
+
+---
+
+## 总体设计原则
+
+1. **业务任务与执行态分层**
+   - 业务 Task / SubTask 不直接等于 runtime task graph。
+2. **Today Status 复用 Schedule Center 真实聚合**
+   - 不新增第二套聚合真源。
+3. **Chat 创建先走显式入口**
+   - 第一版优先 `/task`、`/task@commander` 之类显式方式。
+4. **先数据闭环，后体验增强**
+   - 先打通 CRUD / 聚合 / dispatch，再补评论、自动识别、实时推送。
+5. **文档先行，代码交给 Codex**
+   - 这组文档的目标是让 Codex 可以按阶段稳定实施。
+
+---
+
+## 阶段总览图
+
+```text
+Phase TS-0 ───────────────────────────────────────────────────────────┐
+│ 当前现状与目标                                                      │
+│ - 真实数据流盘点                                                    │
+│ - mock 边界盘点                                                     │
+│ - 目标三层架构                                                      │
+└───────────────────────────────────────────────────────────────────┘
+         │
+         ▼
+Phase TS-1 ───────────────────────────────────────────────────────────┐
+│ 业务任务模型扩展                                                    │
+│ - Task 扩字段                                                       │
+│ - 新增业务级 TaskSubTask                                            │
+│ - TaskHistory 动作扩展                                              │
+└───────────────────────────────────────────────────────────────────┘
+         │
+         ▼
+Phase TS-2 ───────────────────────────────────────────────────────────┐
+│ Task API 与 Schedule 聚合扩展                                       │
+│ - task detail / subtasks / dispatch                                 │
+│ - schedule-center/date 扩展 focus/quadrants/commander summary       │
+└───────────────────────────────────────────────────────────────────┘
+         │
+         ▼
+Phase TS-3 ───────────────────────────────────────────────────────────┐
+│ Chat 首页 Today Status 接真实数据                                   │
+│ - useSidebarPlan 去 mock                                            │
+│ - KanbanPanel 真实化                                                │
+│ - Chat 首页联动刷新                                                 │
+└───────────────────────────────────────────────────────────────────┘
+         │
+         ▼
+Phase TS-4 ───────────────────────────────────────────────────────────┐
+│ 手动创建与详情编辑器                                                │
+│ - KanbanDetail 真实 create/edit                                     │
+│ - Schedule Center 手动创建增强                                      │
+│ - 象限快捷新建                                                      │
+└───────────────────────────────────────────────────────────────────┘
+         │
+         ▼
+Phase TS-5 ───────────────────────────────────────────────────────────┐
+│ Commander 派发闭环                                                  │
+│ - task/subtask dispatch API                                         │
+│ - commander 执行态回写                                              │
+│ - Today Status / Schedule Center 状态一致                           │
+└───────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 关键文件总览
+
+### Backend
+- `backend/app/models/task.py`
+- `backend/app/schemas/task.py`
+- `backend/app/routers/task.py`
+- `backend/app/routers/schedule_center.py`
+- `backend/app/schemas/schedule_center.py`
+- commander / orchestration service 相关文件
+
+### Frontend
+- `frontend/src/api/task.ts`
+- `frontend/src/api/scheduleCenter.ts`
+- `frontend/src/pages/chat/composables/useSidebarPlan.ts`
+- `frontend/src/pages/chat/index.vue`
+- `frontend/src/components/chat/KanbanPanel.vue`
+- `frontend/src/components/chat/KanbanDetail.vue`
+- `frontend/src/pages/schedule-center/composables/useScheduleCenterPage.ts`
+- `frontend/src/pages/schedule-center/index.vue`
+- Chat 输入 / 发送消息相关 composable
+
+---
+
+## 实施顺序
+
+```text
+TS-0 → TS-1 → TS-2 → TS-3 → TS-4 → TS-5
+```
+
+不建议跳阶段。尤其是 `TS-1` 与 `TS-2` 是后续前端改造和 commander 派发的共同前提。
--- a/development-doc/plan/today-status-update/checklist.md
+++ b/development-doc/plan/today-status-update/checklist.md
@@ -0,0 +1,92 @@
+# Today Status 完整化执行清单（可勾选版）
+
+日期：2026-04-08
+状态：执行清单
+适用范围：基于 `phase-ts-0` ~ `phase-ts-5` 整理，最终交给 Codex 执行
+
+---
+
+## 使用说明
+
+- 完成前使用 `- [ ]`
+- 完成后改成 `- [x]`
+- 实施顺序：`TS-0 → TS-1 → TS-2 → TS-3 → TS-4 → TS-5`
+- 不建议跳阶段
+
+---
+
+## Phase TS-0：当前现状与目标
+
+- [x] 盘点 `useSidebarPlan.ts` 中真实数据与 mock 数据边界
+- [x] 盘点 `KanbanPanel.vue` 的硬编码四象限
+- [x] 盘点 `KanbanDetail.vue` 的 mock task / subtasks / comments / history
+- [x] 盘点 `backend/app/models/task.py` 缺失字段
+- [x] 输出业务层 / 聚合层 / commander 执行层三层架构说明
+
+---
+
+## Phase TS-1：业务任务模型扩展
+
+- [x] 扩展 `Task` 模型字段
+- [x] 新增业务级 `TaskSubTask` 模型
+- [x] 扩展 `TaskHistory` 动作类型
+- [x] 编写对应 migration
+- [x] 更新 `backend/app/schemas/task.py`
+
+---
+
+## Phase TS-2：Task API 与 Schedule 聚合扩展
+
+- [x] 扩展 `/api/tasks` create / update / list
+- [x] 新增 `GET /api/tasks/{task_id}`
+- [x] 新增 subtasks CRUD / reorder API
+- [x] 新增 dispatch API
+- [x] 扩展 `schedule-center/date` 返回 `focus_tasks`
+- [x] 扩展 `schedule-center/date` 返回 `quadrants`
+- [x] 扩展 `schedule-center/date` 返回 `commander_summary`
+- [x] 更新 `frontend/src/api/task.ts`
+- [x] 更新 `frontend/src/api/scheduleCenter.ts`
+
+---
+
+## Phase TS-3：Chat 首页 Today Status 接真实数据
+
+- [x] 删除 `useSidebarPlan.ts` 中 `mockFocusItems`
+- [x] 让 `sidebarFocusItems` 接真实 `focus_tasks`
+- [x] 新增 `todayStatusQuadrants`
+- [x] 改造 `KanbanPanel.vue` 为真实展示组件
+- [x] 在 chat 首页接入真实象限与刷新逻辑
+
+---
+
+## Phase TS-4：手动创建与详情编辑器
+
+- [x] 改造 `KanbanDetail.vue` 为 create / edit 真实面板
+- [x] 打通任务详情读取与保存
+- [x] 打通子任务增删改排序
+- [x] 打通分配字段编辑
+- [x] 扩展 Schedule Center 的 `addTask()`
+- [x] 支持象限内快捷新建
+
+---
+
+## Phase TS-5：Commander 派发闭环
+
+- [x] 新增 task dispatch API
+- [x] 新增 subtask dispatch API
+- [x] 建立业务 task -> commander payload 映射
+- [x] commander 结果回写业务 task
+- [x] 在 Today Status 展示 commander summary
+- [x] 在详情页展示 dispatch 状态
+
+---
+
+## 验证清单
+
+- [x] Chat 中 `/task` 可创建任务
+- [x] Chat 中 `/task@commander` 可创建并派发任务
+- [x] Schedule Center 手动创建任务后，Today Status 同步更新
+- [x] Today Status 中创建任务后，Schedule Center 同步可见
+- [x] 子任务刷新后仍保持一致
+- [x] commander 状态可从 `queued -> running -> completed/failed` 更新
+- [x] 回归确认现有 `todo / task / reminder / goal` 主路径不受影响
--- a/development-doc/plan/today-status-update/phase-ts-0-current-state.md
+++ b/development-doc/plan/today-status-update/phase-ts-0-current-state.md
@@ -0,0 +1,144 @@
+# Phase TS-0：当前现状与目标
+
+日期：2026-04-08
+状态：待实施
+
+---
+
+## 1. 阶段目标
+
+先把当前代码里的真实能力、mock 能力、缺口和目标架构写清楚，避免后续实现直接在错误抽象上继续堆功能。
+
+本阶段不改业务代码，重点是：
+- 盘点真实数据流
+- 盘点 mock 边界
+- 明确业务 task 与 commander runtime task 的边界
+- 输出目标三层架构
+
+---
+
+## 2. 当前代码现状
+
+### 2.1 Chat 首页 Today Status
+
+当前文件：
+- `frontend/src/pages/chat/composables/useSidebarPlan.ts`
+- `frontend/src/pages/chat/index.vue`
+
+已真实存在的能力：
+- `useSidebarPlan.ts` 已通过 `scheduleCenterApi.date()` 和 `scheduleCenterApi.month()` 加载真实数据
+- `todayPlanCounters` 已基于真实 `todos / tasks / reminders / goals` 聚合统计
+- Chat 首页已能打开 Today Status 抽屉
+
+当前缺口：
+- `sidebarFocusItems` 仍强制返回 `mockFocusItems`
+- Today Status 的重点区、四象限、详情编辑并未接真实任务模型
+
+### 2.2 Kanban UI
+
+当前文件：
+- `frontend/src/components/chat/KanbanPanel.vue`
+- `frontend/src/components/chat/KanbanDetail.vue`
+
+当前状态：
+- `KanbanPanel.vue` 的四象限任务列表完全硬编码
+- `KanbanDetail.vue` 的 task / subtasks / comments / history / assignee 都是本地 mock
+- 子任务拖拽、完成状态、评论等均未持久化
+
+### 2.3 业务任务模型
+
+当前文件：
+- `backend/app/models/task.py`
+- `backend/app/routers/task.py`
+- `frontend/src/api/task.ts`
+
+当前状态：
+- 只有基础 `Task`
+- 只有简单 CRUD
+- 没有业务级 `SubTask`
+- 没有 `assignee` / `quadrant` / `conversation_id` / `dispatch_status`
+
+### 2.4 Schedule Center
+
+当前文件：
+- `backend/app/routers/schedule_center.py`
+- `frontend/src/pages/schedule-center/composables/useScheduleCenterPage.ts`
+
+当前状态：
+- 已经是当前最真实的日程聚合入口
+- 已支持 todo / task / reminder / goal 的真实新增与刷新
+- 但 `date` 聚合结果还不够直接支撑 Today Status 四象限与 commander 状态
+
+### 2.5 Commander / Agent runtime
+
+当前文件：
+- `backend/app/agents/schemas/task.py`
+- `backend/app/routers/agent.py`
+
+当前状态：
+- runtime 中已有 `owner_agent_id / parent_task_id / child_task_ids` 等执行态字段
+- 更适合做执行态拓扑和可视化
+- 不适合直接作为业务 Task / SubTask 主模型
+
+---
+
+## 3. 目标架构
+
+建议采用三层结构：
+
+### 3.1 业务任务层
+面向用户的长期任务实体：
+- Task
+- TaskSubTask
+- assignee
+- quadrant
+- source
+- conversation_id
+- dispatch 状态
+
+### 3.2 调度聚合层
+通过 `schedule-center` 提供：
+- 今日统计
+- focus tasks
+- quadrants
+- commander summary
+
+### 3.3 执行层
+保留现有 commander / runtime：
+- 接收业务任务派发
+- 内部做 task graph 执行
+- 把状态回写业务 task/subtask
+
+---
+
+## 4. 核心文件清单
+
+| 文件 | 操作 | 说明 |
+|------|------|------|
+| `frontend/src/pages/chat/composables/useSidebarPlan.ts` | 盘点 | 真实统计 + mock focus 边界 |
+| `frontend/src/components/chat/KanbanPanel.vue` | 盘点 | 四象限 mock |
+| `frontend/src/components/chat/KanbanDetail.vue` | 盘点 | 详情页 mock |
+| `backend/app/models/task.py` | 盘点 | Task 字段缺口 |
+| `backend/app/routers/task.py` | 盘点 | 仅简单 CRUD |
+| `backend/app/routers/schedule_center.py` | 盘点 | 聚合能力现状 |
+
+---
+
+## 5. 验收标准
+
+- [ ] 明确 Today Status 中哪些数据是真实的
+- [ ] 明确哪些能力仍是 mock
+- [ ] 明确业务 task 与 runtime task 的边界
+- [ ] 给出业务层 / 聚合层 / 执行层三层架构
+
+---
+
+## 6. 依赖关系
+
+```text
+本阶段 → Phase TS-1
+       → Phase TS-2
+       → Phase TS-3
+```
+
+本阶段是后续所有实现文档的共识基础。
--- a/development-doc/plan/today-status-update/phase-ts-1-business-task-model.md
+++ b/development-doc/plan/today-status-update/phase-ts-1-business-task-model.md
@@ -0,0 +1,111 @@
+# Phase TS-1：业务任务模型扩展
+
+日期：2026-04-08
+状态：待实施
+
+---
+
+## 1. 阶段目标
+
+补齐业务级 Task / SubTask / 分配 / 派发字段，为 Today Status、Schedule Center、Chat 创建、Commander 派发提供统一的数据主模型。
+
+本阶段重点是“把业务模型补齐”，而不是直接接 commander runtime。
+
+---
+
+## 2. 详细任务
+
+### 2.1 扩展 Task 模型
+
+**文件**：
+- `backend/app/models/task.py`
+- `backend/app/schemas/task.py`
+
+建议新增字段：
+- `source`
+- `conversation_id`
+- `quadrant`
+- `assignee_type`
+- `assignee_id`
+- `dispatch_status`
+- `dispatch_run_id`
+- `result_summary`
+- `started_at`
+- `last_synced_at`
+
+### 2.2 新增业务级 TaskSubTask
+
+**文件**：
+- 新增 TaskSubTask 模型文件或在任务模型模块中补充
+- `backend/app/schemas/task.py`
+
+建议字段：
+- `task_id`
+- `title`
+- `description`
+- `status`
+- `order_index`
+- `assignee_type`
+- `assignee_id`
+- `dispatch_status`
+- `dispatch_run_id`
+- `completed_at`
+
+### 2.3 扩展 TaskHistory 语义
+
+建议新增 action：
+- `created_from_chat`
+- `assigned`
+- `subtask_created`
+- `subtask_reordered`
+- `dispatched_to_commander`
+- `dispatch_status_changed`
+
+### 2.4 设计 migration
+
+需要新增 migration，确保：
+- 旧 task 可兼容新字段
+- 新 subtasks 表可按 task_id 关联
+- 必要索引可支撑按日期 / 象限 / assignee / dispatch 状态查询
+
+---
+
+## 3. 设计原则
+
+1. **业务 task 与 runtime task 分层**
+   - 不能直接把 runtime 的 `owner_agent_id / parent_task_id` 作为业务主模型。
+2. **SubTask 必须是业务实体**
+   - 不能继续停留在前端本地数组。
+3. **先支持显式字段，再做自动推导**
+   - `quadrant`、`assignee_type` 等优先用显式字段，不做复杂推断。
+
+---
+
+## 4. 核心文件清单
+
+| 文件 | 操作 | 说明 |
+|------|------|------|
+| `backend/app/models/task.py` | 修改 | 扩展 Task 字段 |
+| `backend/app/schemas/task.py` | 修改 | 扩展 TaskCreate/TaskUpdate/TaskOut/SubTask schema |
+| migration 文件 | 新增 | 数据库结构迁移 |
+
+---
+
+## 5. 验收标准
+
+- [ ] Task 可表达来源、象限、分配对象、派发状态
+- [ ] 有独立的业务级 SubTask 模型
+- [ ] TaskHistory 能记录关键业务动作
+- [ ] migration 方案清晰且可兼容旧数据
+
+---
+
+## 6. 依赖关系
+
+```text
+本阶段 → Phase TS-2（API）
+       → Phase TS-4（详情编辑器）
+       → Phase TS-5（Commander 派发）
+```
+
+本阶段是后续所有真实任务操作的基础。
--- a/development-doc/plan/today-status-update/phase-ts-2-task-api-and-schedule-aggregation.md
+++ b/development-doc/plan/today-status-update/phase-ts-2-task-api-and-schedule-aggregation.md
@@ -0,0 +1,106 @@
+# Phase TS-2：Task API 与 Schedule 聚合扩展
+
+日期：2026-04-08
+状态：待实施
+
+---
+
+## 1. 阶段目标
+
+扩展后端 Task API 与 Schedule Center 聚合，让前端可以真实创建、读取、编辑、分配任务，并让 Today Status 直接消费真实聚合视图。
+
+---
+
+## 2. 详细任务
+
+### 2.1 扩展 Task API
+
+**文件**：
+- `backend/app/routers/task.py`
+- `backend/app/schemas/task.py`
+- `frontend/src/api/task.ts`
+
+建议接口：
+- `GET /api/tasks`
+- `POST /api/tasks`
+- `GET /api/tasks/{task_id}`
+- `PATCH /api/tasks/{task_id}`
+- `DELETE /api/tasks/{task_id}`
+- `POST /api/tasks/{task_id}/subtasks`
+- `PATCH /api/tasks/{task_id}/subtasks/{subtask_id}`
+- `DELETE /api/tasks/{task_id}/subtasks/{subtask_id}`
+- `POST /api/tasks/{task_id}/subtasks/reorder`
+- `POST /api/tasks/{task_id}/dispatch`
+- `POST /api/tasks/{task_id}/subtasks/{subtask_id}/dispatch`
+
+### 2.2 Task detail 输出
+
+`GET /api/tasks/{task_id}` 建议返回：
+- task 基础字段
+- subtasks
+- history
+- dispatch 摘要
+
+### 2.3 扩展 Schedule Center 聚合
+
+**文件**：
+- `backend/app/routers/schedule_center.py`
+- `backend/app/schemas/schedule_center.py`
+- `frontend/src/api/scheduleCenter.ts`
+
+建议在 `ScheduleCenterDateOut` 增加：
+- `focus_tasks`
+- `quadrants`
+- `commander_summary`
+
+### 2.4 前端 API 同步
+
+`frontend/src/api/task.ts` 需要扩展：
+- detail 方法
+- subtask CRUD / reorder
+- dispatch 方法
+
+`frontend/src/api/scheduleCenter.ts` 需要扩展：
+- `focus_tasks`
+- `quadrants`
+- `commander_summary` 类型
+
+---
+
+## 3. 设计原则
+
+1. **复用现有 task router，不另开 taskV2**
+2. **复用现有 schedule-center 聚合，不另开第二套 today-status API**
+3. **dispatch 是显式动作，不隐含在普通 update 里**
+
+---
+
+## 4. 核心文件清单
+
+| 文件 | 操作 | 说明 |
+|------|------|------|
+| `backend/app/routers/task.py` | 修改 | 扩展任务、子任务、派发 API |
+| `backend/app/schemas/task.py` | 修改 | detail/subtask/dispatch schema |
+| `backend/app/routers/schedule_center.py` | 修改 | 扩展今日聚合 |
+| `backend/app/schemas/schedule_center.py` | 修改 | 扩展 response model |
+| `frontend/src/api/task.ts` | 修改 | 前端任务 API 能力补齐 |
+| `frontend/src/api/scheduleCenter.ts` | 修改 | 前端聚合类型补齐 |
+
+---
+
+## 5. 验收标准
+
+- [ ] Task detail 能返回 subtasks / history / dispatch 信息
+- [ ] 子任务 CRUD / reorder API 设计明确
+- [ ] dispatch API 明确独立
+- [ ] `schedule-center/date` 可直接供 Today Status 使用
+- [ ] 前端 API 类型已同步
+
+---
+
+## 6. 依赖关系
+
+```text
+依赖：Phase TS-1
+输出给：Phase TS-3 / TS-4 / TS-5
+```
--- a/development-doc/plan/today-status-update/phase-ts-3-chat-today-status-integration.md
+++ b/development-doc/plan/today-status-update/phase-ts-3-chat-today-status-integration.md
@@ -0,0 +1,86 @@
+# Phase TS-3：Chat 首页 Today Status 接真实数据
+
+日期：2026-04-08
+状态：待实施
+
+---
+
+## 1. 阶段目标
+
+把 Chat 首页 Today Status 从“真实统计 + mock 内容”升级为完整真实视图，让 Today Status 与 Schedule Center 使用同一份聚合真源。
+
+---
+
+## 2. 详细任务
+
+### 2.1 useSidebarPlan 去 mock
+
+**文件**：
+- `frontend/src/pages/chat/composables/useSidebarPlan.ts`
+
+需要完成：
+- 删除 `mockFocusItems`
+- `sidebarFocusItems` 改为基于真实 `focus_tasks`
+- 新增 `todayStatusQuadrants`
+- 新增 `commanderSummary`
+- 保留当前 `todayPlanCounters` 的真实聚合逻辑
+
+### 2.2 KanbanPanel 真实化
+
+**文件**：
+- `frontend/src/components/chat/KanbanPanel.vue`
+
+需要完成：
+- 去掉硬编码四象限数据
+- 改为接收真实 `quadrants`
+- emit 真实事件：
+  - `create-task`
+  - `open-task`
+  - `close`
+- 页脚统计改为真实任务统计
+
+### 2.3 chat 首页联动
+
+**文件**：
+- `frontend/src/pages/chat/index.vue`
+
+需要完成：
+- Today Status 打开后加载真实 Kanban
+- 任务创建 / 编辑 / 派发后触发 `loadSidebarPlanSnapshot()`
+- 保持当前抽屉体验，不额外再造入口
+
+---
+
+## 3. 设计原则
+
+1. **Today Status 与 Schedule Center 同源**
+2. **KanbanPanel 做纯展示，不承载业务状态真源**
+3. **以刷新真实聚合为准，不保留本地 fake 数据**
+
+---
+
+## 4. 核心文件清单
+
+| 文件 | 操作 | 说明 |
+|------|------|------|
+| `frontend/src/pages/chat/composables/useSidebarPlan.ts` | 修改 | 删除 focus mock，接真实聚合 |
+| `frontend/src/components/chat/KanbanPanel.vue` | 修改 | 改成真实展示组件 |
+| `frontend/src/pages/chat/index.vue` | 修改 | 连接 Today Status、Kanban、刷新逻辑 |
+
+---
+
+## 5. 验收标准
+
+- [ ] Today Status 重点列表不再使用 mock
+- [ ] Kanban 四象限显示真实任务
+- [ ] 统计、重点、象限来自同一份聚合结果
+- [ ] Chat 首页可以稳定刷新任务状态
+
+---
+
+## 6. 依赖关系
+
+```text
+依赖：Phase TS-2
+输出给：Phase TS-4 / TS-5
+```
--- a/development-doc/plan/today-status-update/phase-ts-4-manual-create-and-detail-editor.md
+++ b/development-doc/plan/today-status-update/phase-ts-4-manual-create-and-detail-editor.md
@@ -0,0 +1,99 @@
+# Phase TS-4：手动创建与详情编辑器
+
+日期：2026-04-08
+状态：待实施
+
+---
+
+## 1. 阶段目标
+
+补齐“手动创建任务”和“详情编辑”链路，让用户可以在 Today Status 与 Schedule Center 中真实创建、编辑任务与子任务。
+
+---
+
+## 2. 详细任务
+
+### 2.1 改造 KanbanDetail 为真实编辑器
+
+**文件**：
+- `frontend/src/components/chat/KanbanDetail.vue`
+
+需要完成：
+- 支持 `create | edit`
+- 接 task detail API
+- 编辑字段：
+  - `title`
+  - `description`
+  - `status`
+  - `priority`
+  - `quadrant`
+  - `assignee_type`
+  - `assignee_id`
+- 子任务增删改排序接真实 API
+- 历史接 `TaskHistory`
+- 评论如果后端暂无支持，本阶段不强做真实化
+
+### 2.2 Schedule Center 手动创建增强
+
+**文件**：
+- `frontend/src/pages/schedule-center/composables/useScheduleCenterPage.ts`
+- `frontend/src/pages/schedule-center/index.vue`
+
+需要完成：
+- `addTask()` 支持：
+  - `quadrant`
+  - `description`
+  - `assignee_type`
+  - `assignee_id`
+  - `dispatch_to_commander`
+- 保持 `loadDateDetail()` + `loadMonth()` 刷新闭环
+
+### 2.3 象限内快捷新建
+
+**文件**：
+- `frontend/src/components/chat/KanbanPanel.vue`
+- `frontend/src/components/chat/KanbanDetail.vue`
+- `frontend/src/pages/chat/index.vue`
+
+需要完成：
+- 点击象限 `+` 打开 `KanbanDetail(create)`
+- 自动预填 `quadrant`
+- 保存后刷新 Today Status
+
+---
+
+## 3. 设计原则
+
+1. **KanbanDetail 是真实任务编辑器，不再保留 mock 状态真源**
+2. **Schedule Center 是最完整的手动创建页面**
+3. **Today Status 提供快捷创建，不与 Schedule Center 竞争真源**
+
+---
+
+## 4. 核心文件清单
+
+| 文件 | 操作 | 说明 |
+|------|------|------|
+| `frontend/src/components/chat/KanbanDetail.vue` | 修改 | 真实 create/edit 详情面板 |
+| `frontend/src/pages/schedule-center/composables/useScheduleCenterPage.ts` | 修改 | 手动创建增强 |
+| `frontend/src/pages/schedule-center/index.vue` | 修改 | 表单与详情联动 |
+| `frontend/src/pages/chat/index.vue` | 修改 | Today Status 快捷创建联动 |
+
+---
+
+## 5. 验收标准
+
+- [ ] 用户可从 Today Status 手动创建任务
+- [ ] 用户可从 Schedule Center 手动创建任务
+- [ ] 用户可编辑任务、子任务、分配信息
+- [ ] 刷新后数据保持一致
+
+---
+
+## 6. 依赖关系
+
+```text
+依赖：Phase TS-2
+建议在：Phase TS-3 后整合
+输出给：Phase TS-5
+```
--- a/development-doc/plan/today-status-update/phase-ts-5-commander-dispatch.md
+++ b/development-doc/plan/today-status-update/phase-ts-5-commander-dispatch.md
@@ -0,0 +1,99 @@
+# 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
+```