goodbuddy/docs/features/task-and-job/task-center-prd.md

Task Center PRD

文档信息

项目	内容
状态	Scheduled Task 与项目范围跟随已实现；Goal/Event Task 与完整操作待实施
版本	0.4
日期	2026-09-10
依赖	Task 与 Job 统一领域模型
界面归属	通用助手工作栏与执行空间

1. 产品定义

Task Center 是工作栏中的单实例 Task 索引，默认跟随当前项目。它不是 Automation Center， 也不复制 Conversation 内容。点击条目打开其关联 Conversation，并定位或展开对应 Task。

每个 Task 只关联一条 Conversation；一条 Conversation 可以关联零个、一个或多个 Task。 Conversation 不因为关联 Task 而改变对象类型。

“单实例”和“项目范围”是两个独立属性：应用内只有一个 Task Center Tab，但该 Tab 默认展示 当前项目的 Task。用户可以在同一 Tab 内切换到“所有项目”，不能为每个项目创建 独立 Task Center 实例。

2. 收录边界

收录：

• 用户明确创建或确认的 Task。
• Scheduled Task、Event Task 和 Goal Task。
• 未来由用户确认创建的其他顶层 Task。

不收录：

• 没有显式 Task 关联的普通 Conversation。
• 普通模型请求或工具调用产生的内部执行记录。
• Job、Subjob、Run、工具步骤或 Subagent。
• Smart Heartbeat 配置、报告和建议。
• 仅用于审计的活动记录。

当前产品 UI 的对象层级止于 Task。Task Center、左侧会话列表和 Conversation 任务区都不显示 Job/Subjob/Run 树、独立详情或路由。

3. 列表信息

每条 Task 至少显示：

• 名称和所属项目；无项目时标注“未绑定项目”。
• 关联 Conversation 标题。
• Task 类型和触发来源。
• Ask / Execute 模式。
• 当前聚合状态。
• 最近一次面向用户的进展。
• 最近活动时间。
• 等待审批、失败或需要关注状态。
• 下次计划时间（如适用）。

Task 行只显示聚合后的用户状态，不要求用户理解内部 Job/Run。

4. 范围

范围控件提供：

• 当前项目：默认值，跟随活动项目变化，只显示 projectId 匹配的 Task。
• 所有项目：显示当前用户可见的项目 Task 和没有 projectId 的历史 Task，后者标注“未绑定项目”。

没有活动项目时，“当前项目”显示明确空状态，并允许切换到“所有项目”；系统不 自动改变用户已经选择的范围。范围模式作为工作栏公开偏好持久化，但“当前项目”模式不保存 具体项目 ID；重启后继续跟随届时的活动项目。旧布局保存的 global 范围在 UI 恢复时映射为 all-projects，后续保存使用新值；不修改任务数据或后端项目绑定规则。

5. 交互

• 点击条目打开关联 Conversation，并定位到该 Task。
• 状态筛选仅保留进行中、暂停、已结束，默认选择进行中。
• 进行中包含 idle、queued、running、waiting_approval、failed 和 interrupted； 暂停对应 paused，已结束包含 completed 和 cancelled。分类只影响列表筛选， 不改变任务状态语义；任务行保留具体状态、错误信息和原有操作。
• 关联当前范围内顶层任务的审批直接显示在任务卡内，可拒绝或仅此次允许；有待审批的任务 归入“进行中”，审批随任务卡参与状态筛选，不再重复显示独立审批分类或区域。
• 普通会话或无法关联到当前范围内任务的审批保留独立处理区域，不受任务状态筛选影响； 该区域仅在存在此类审批时显示。没有审批时不显示审批标题、空提示或徽标。
• 审批徽标统计当前项目范围内全部待审批请求，不受状态筛选影响。
• 支持立即运行、暂停、恢复、取消、编辑和删除。
• 后台变化更新状态和徽标，不自动抢占当前页面。
• 立即运行、重试和恢复在 UI 上都是 Task 操作，内部 Job/Run 不单独显示。
• 完整消息留在 Conversation；工具、审批和错误可以在活动或 Runtime 中按 Task 查看； 独立交付物在成果中查看。

6. 左侧 Conversation Task 列表

左侧最近会话列表承担轻量 Task 发现，不替代 Task Center：

▾ 产品发布讨论                           10:24

   每周进度总结       每周 · Execute · 等待中 ●
   发布前检查                     单次 · Execute ✓

• 无 Task 的 Conversation 保持现有单行样式。
• 有 Task 时在行最左侧显示独立展开按钮；父会话行不重复显示任务标签或数量。
• 更新时间默认靠近行右侧，更多操作按钮不常驻占位；悬停会话行时，按钮替换右侧时间显示。 键盘焦点进入会话行或操作菜单展开时，按钮仍保持可见。会话标题溢出时保持右侧区域固定， 并在自身裁切区域内横向滑动展示完整名称。未溢出标题不滑动，减少动态效果偏好下使用完整 标题提示而不产生位移。
• 展开后每个 Task 子项左侧显示名称，右侧显示本地化的模式、计划和状态标记，与父会话 更新时间对齐；已完成使用带勾成功点并将文案保留给辅助技术。列表不显示 Job、Subjob、 Run 或工具步骤。
• 点击 Conversation 标题打开聊天；点击 Task 打开同一 Conversation 并定位该 Task。
• 新建 Task 后首次自动展开；用户手动折叠后保持选择。
• 后台状态变化不强制展开；Task 状态持续显示在展开后的子项和 Task Center 中。
• 默认最多显示 3 个 Task；“查看全部 N 个任务”打开该 Conversation 的完整任务区。

7. Conversation 任务区

包含 Task 的 Conversation 顶部显示可折叠任务区：

本会话有 2 个任务
[每周进度总结] [发布前检查]                         [管理任务]

选择 Task 后显示名称、模式、聚合状态、计划、下次执行、最近结果和 Task 级操作。工具、审批、 错误和成果通过 Task 关联显示，但不暴露 Job/Run 层级。

模式来源遵循Scheduled Task 的执行时配置： 未运行计划跟随会话当前有效模式，已执行 Task 保留实际模式；计划旧值不得覆盖展示。

8. 删除关系

• 删除 Schedule 只停止后续触发，不删除 Task、Conversation 或历史。
• 删除 Task 停止其计划并移除关联，默认保留 Conversation 和既有消息。
• 删除最后一个 Task 后，左侧 Conversation 的展开按钮消失。
• 删除 Conversation 前必须显示关联 Task 数量，并先停止或结算活动执行。

9. 验收标准

• Task Center 只展示产品级 Task。
• 一条 Conversation 可以关联并展开多个 Task。
• 点击 Task 打开正确 Conversation 并定位到对应 Task。
• 左侧会话列表通过独立展开按钮显示带任务图标和本地化摘要的 Task 子项。
• 当前 UI 不显示 Job/Subjob/Run 树或独立页面。
• Scheduled Task 显示下次时间，但每次触发不新增 Task 条目。
• 普通模型请求和工具调用不会误显示为 Task。
• 删除 Task 默认保留 Conversation 和既有消息。
• Smart Heartbeat 不进入 Task Center。
• Task Center 默认只显示当前项目的 Task，切换项目后在同一 Tab 更新列表。
• 仅提供“当前项目”和“所有项目”；后者保留无项目 Task，并标注“未绑定项目”。
• 范围切换不创建第二个 Task Center Tab；任务中心保持默认存在且不可关闭。