docs: organize product design by feature
Define repository and feature-scoped documentation rules for PRDs, User Stories, logic, UI, technical design, and progress evidence. Move feature-owned documents under docs/features, add one entry point per feature, remove the redundant docs index, and update all affected cross-references. Expand the local tool environment design with explicit product, story, logic, UI, technical, and progress documents.
This commit is contained in:
mesalogo
@@ -0,0 +1,16 @@
|
||||
# Task 与 Job 文档集
|
||||
|
||||
本目录定义 GoodBuddy 的工作对象、内部执行单元和调度关系。
|
||||
|
||||
## 权威文档
|
||||
|
||||
1. [Task 与 Job 统一领域模型](./task-and-job-model.md)：术语、身份和对象关系。
|
||||
2. [Task Center PRD](./task-center-prd.md)：Task 的应用级索引。
|
||||
3. [Scheduled Task PRD](./scheduled-task-prd.md)：时间或事件触发的 Task。
|
||||
4. [Goal Task PRD](./goal-task-prd.md)：围绕可验证结果有界推进的 Task。
|
||||
5. [Job 与 Subjob PRD](./job-and-subjob-prd.md)：Task 内部串行、并行和委派执行。
|
||||
|
||||
## 阅读顺序
|
||||
|
||||
先阅读统一领域模型。其他功能文档不得重新定义 Task、Conversation、Job、Run 或 Subagent。
|
||||
若实现与文档出现冲突，应先修正统一模型，再同步功能 PRD。
|
||||
@@ -0,0 +1,55 @@
|
||||
# Goal Task PRD
|
||||
|
||||
## 文档信息
|
||||
|
||||
| 项目 | 内容 |
|
||||
| --- | --- |
|
||||
| 状态 | 设计中，未来能力 |
|
||||
| 版本 | 0.1 |
|
||||
| 日期 | 2026-08-19 |
|
||||
| 依赖 | [Task 与 Job 统一领域模型](./task-and-job-model.md) |
|
||||
|
||||
## 1. 产品定义
|
||||
|
||||
Goal Task 是围绕可验证结果持续推进的 Task。它只关联一条 Conversation，但该 Conversation
|
||||
也可以承载其他 Task；每轮观察、计划、行动和评估由内部 Job/Run 表达，不创建一串顶层 Task。
|
||||
|
||||
## 2. 必要配置
|
||||
|
||||
- 目标描述。
|
||||
- 至少一个成功标准。
|
||||
- 约束和停止条件。
|
||||
- 最大轮数、截止时间或预算。
|
||||
- 每轮评估方式。
|
||||
- 无进展处理。
|
||||
- Project、Runtime、知识、记忆、目录、工具和审批范围。
|
||||
|
||||
## 3. 有界循环
|
||||
|
||||
```text
|
||||
Observe Job
|
||||
→ Planning Job
|
||||
→ Permission and budget check
|
||||
→ Action Job / parallel Jobs
|
||||
→ Evaluation Job
|
||||
→ Complete, pause, revise or continue
|
||||
```
|
||||
|
||||
循环内的所有 Job 通过所属 Task 写入同一关联 Conversation。只有协调器把有意义的阶段进展
|
||||
写入消息时间线，避免每个内部步骤产生一条顶层 Task 或杂乱消息。当前 UI 只显示 Goal Task
|
||||
及其聚合状态，不显示 Job/Run 层级。
|
||||
|
||||
## 4. 完成和无进展
|
||||
|
||||
- 模型声明不能单独证明目标完成。
|
||||
- 成功标准必须可计算或可人工审查。
|
||||
- 连续两轮没有指标改善、重复下一步、连续失败、权限不可用或预算不足时暂停。
|
||||
- 修改范围、预算、Runtime、工作模式或权限必须用户确认。
|
||||
|
||||
## 5. 验收原则
|
||||
|
||||
- [ ] Goal Task 只关联一条 Conversation，Conversation 可以承载其他 Task。
|
||||
- [ ] 循环步骤以 Job 表达，不创建顶层子 Task。
|
||||
- [ ] 当前 UI 不展示 Goal Task 内部 Job/Run 层级。
|
||||
- [ ] 没有成功标准和停止条件时不能启用。
|
||||
- [ ] 无进展和预算耗尽不会伪装为成功。
|
||||
@@ -0,0 +1,102 @@
|
||||
# Job 与 Subjob PRD
|
||||
|
||||
## 文档信息
|
||||
|
||||
| 项目 | 内容 |
|
||||
| --- | --- |
|
||||
| 状态 | 设计中，未来能力 |
|
||||
| 版本 | 0.1 |
|
||||
| 日期 | 2026-08-19 |
|
||||
| 依赖 | [Task 与 Job 统一领域模型](./task-and-job-model.md) |
|
||||
|
||||
## 1. 目标
|
||||
|
||||
在不创建额外顶层 Task 或 Conversation 的前提下，让一个 Task 能够分解、串行、并行和委派
|
||||
多个执行单元，并将进展和结果有序汇入 Task 的同一 Conversation。
|
||||
|
||||
## 2. Job 类型
|
||||
|
||||
首期只使用有限类型：
|
||||
|
||||
- `step`：Task 内一个明确步骤。
|
||||
- `scheduled_occurrence`：Scheduled Task 的一次到期执行。
|
||||
- `delegated`：交给 Subagent 或远程执行器。
|
||||
- `parallel_branch`：并行方案或分工。
|
||||
- `aggregation`：汇总多个前置 Job。
|
||||
|
||||
类型描述执行方式，不创造新的产品对象层级。
|
||||
|
||||
## 3. 并行模型
|
||||
|
||||
```text
|
||||
关联 Conversation
|
||||
└─ Coordinating Job
|
||||
├─ Parallel Job A
|
||||
├─ Parallel Job B
|
||||
├─ Parallel Job C
|
||||
└─ Aggregation Job
|
||||
```
|
||||
|
||||
- 并行 Job 使用同一个 `taskId` 和 `conversationId`。
|
||||
- 每个 Job 有独立输入快照、状态、Run、预算和输出缓冲。
|
||||
- 并行 Job 不直接同时追加助手消息。
|
||||
- Aggregation Job 或 Task 协调器按确定顺序生成一条进展或结果消息。
|
||||
- 用户可以按 Task 查看有界活动和聚合状态，但不选择或展开单个 Job；主 Conversation
|
||||
保持可读。
|
||||
|
||||
## 4. Subjob
|
||||
|
||||
Job 可以创建有界 Subjob：
|
||||
|
||||
- 默认最大深度 2。
|
||||
- 默认最大并发 3。
|
||||
- 默认最大子项数、模型调用、Token、耗时和输出大小由父 Job 预算限制。
|
||||
- 子级只能使用父级已授权能力的子集。
|
||||
- 父级取消、失败或超时后，活动子级必须取消。
|
||||
|
||||
## 5. Subagent
|
||||
|
||||
Subagent 是 Job 的执行者：
|
||||
|
||||
- 专家选择和路由记录在 Job 上。
|
||||
- Subagent 的原始流式输出进入有界 Job 缓冲和活动记录。
|
||||
- 完成、失败和部分输出都返回父 Job。
|
||||
- Subagent 不获得独立 Task Center 条目或 Conversation。
|
||||
|
||||
## 6. 状态与恢复
|
||||
|
||||
Job 状态至少包括：
|
||||
|
||||
```text
|
||||
queued → running → waiting_approval → completed
|
||||
↘ failed | cancelled | interrupted | budget_exceeded
|
||||
```
|
||||
|
||||
- 重试创建新 Run，不覆盖失败 Run。
|
||||
- 应用退出将活动 Job 标记为 `interrupted`。
|
||||
- 有外部副作用且结果未知的 Job 不自动重试。
|
||||
- 聚合 Job 必须明确处理部分成功、全部失败和取消。
|
||||
|
||||
## 7. 界面
|
||||
|
||||
当前产品 UI 的对象层级止于 Task，不提供 Job/Subjob 树、独立页面或导航入口。
|
||||
|
||||
关联 Conversation 和 Task Center 只显示：
|
||||
|
||||
- 当前总体进展。
|
||||
- 并行执行数量和聚合状态。
|
||||
- 需要审批或用户输入的 Task 状态。
|
||||
- 完成后的统一结果。
|
||||
|
||||
活动与 Runtime 可以按 Task 显示执行者、工具、耗时、预算、错误、审批和成果事件，但不把
|
||||
Job、Subjob 或 Run 暴露为可选择、可展开或可操作的产品对象。内部标识只用于关联与审计。
|
||||
|
||||
## 8. 验收标准
|
||||
|
||||
- [ ] 并行 Job 通过所属 Task 写入同一关联 Conversation。
|
||||
- [ ] Job 不创建顶层 Task。
|
||||
- [ ] 并行输出不会无序污染消息时间线。
|
||||
- [ ] Subjob 深度、并发、预算和输出有界。
|
||||
- [ ] Subagent 失败能够返回部分输出和明确状态。
|
||||
- [ ] 父级取消传播到所有活动子级。
|
||||
- [ ] 当前 UI 只展示到 Task，不显示 Job/Subjob/Run 层级。
|
||||
@@ -0,0 +1,370 @@
|
||||
# Scheduled Task PRD
|
||||
|
||||
## 文档信息
|
||||
|
||||
| 项目 | 内容 |
|
||||
| --- | --- |
|
||||
| 状态 | 首期稳定 Task 生命周期、创建体验与 Conversation 输入仲裁已实现；高级触发和执行治理待实施 |
|
||||
| 版本 | 0.7 |
|
||||
| 日期 | 2026-08-19 |
|
||||
| 依赖 | [Task 与 Job 统一领域模型](./task-and-job-model.md) |
|
||||
| 相关架构 | [自动化平台总体设计](../../architecture/automation-platform-architecture.md) |
|
||||
|
||||
## 1. 产品定义
|
||||
|
||||
Scheduled Task 是带时间或事件触发器的 Task。每个 Scheduled Task 关联一条 Conversation；
|
||||
一条 Conversation 可以同时承载多个 Task。
|
||||
|
||||
创建 Scheduled Task 时：
|
||||
|
||||
1. 用户选择关联当前 Conversation 或创建新 Conversation。
|
||||
2. 系统创建一个 Task，并保存稳定 `conversationId` 和 Schedule/Trigger Binding。
|
||||
3. 每次触发在同一 Task 内创建新的 Job 和 Run。
|
||||
4. 面向用户的文本进展和结果写回关联 Conversation，并标明 Task 来源。
|
||||
5. 独立交付物保存为 Artifact，并由结果消息引用。
|
||||
|
||||
因此，一个每日任务在 Task Center 中始终是一条 Task，而不是每天新增一条 Task；左侧会话
|
||||
列表通过行首展开按钮和带任务图标的子项呈现其关联。
|
||||
|
||||
## 2. 当前能力与差距
|
||||
|
||||
GoodBuddy 当前已实现首期统一生命周期：
|
||||
|
||||
- 创建 Modal 可以关联当前 Conversation 或原子创建新 Conversation，不修改当前
|
||||
Conversation 的标题和既有消息。
|
||||
- 每个 Schedule 绑定一个稳定产品级 Task 和 Conversation；重复触发复用同一身份，不再
|
||||
为每次触发创建新的顶层 Task。
|
||||
- 默认选择 Execute，并允许用户主动切换 Ask；不支持工具执行时明确禁用 Execute。
|
||||
- 单次、每日和每周计划支持暂停、恢复、立即运行、应用重启恢复和最多 4 个独立计划并发。
|
||||
- 到期和手动运行先进入关联 Conversation 的持久输入队列，与回复期间继续发送的普通消息
|
||||
顺序仲裁；默认不打断当前回复，也不与其并发写入时间线。
|
||||
- Composer 上沿显示待发送项和来源。用户可以删除尚未执行的 occurrence，或选择“立即
|
||||
中断并插入”取消当前执行并将该项提升为下一项。
|
||||
- 文本结果和失败写回关联 Conversation 并带 Task 来源；独立文件和图片继续保存为 Artifact。
|
||||
- 左侧 Conversation 列表、Conversation Task 区和 Task Center 使用同一产品 Task；普通
|
||||
模型请求、Subagent、委派和 Smart Heartbeat 内部 Task 不进入产品索引。
|
||||
- v22 迁移保留 Schedule 配置和历史运行，并为旧计划补齐稳定 Task 与 Conversation；v23
|
||||
增加可恢复的统一 Conversation 输入队列。
|
||||
|
||||
尚未实现的高级能力包括 IANA 时区与 DST 墙上时间、每月/工作日/受限 Cron、事件触发、
|
||||
可配置错过执行策略、租约、重试与结果未知治理、完整预算和权限快照，以及面向内部
|
||||
Job/Subjob/Run 的统一持久化抽象。当前每日和每周按既有 UTC 间隔递推。
|
||||
|
||||
## 3. 目标
|
||||
|
||||
- 支持单次、每日、每周、每月、工作日和受限 Cron。
|
||||
- 支持 Task 完成、失败、Conversation 完成等内部事件触发。
|
||||
- 创建时明确选择当前或新 Conversation。
|
||||
- 默认使用 Execute，并允许用户主动切换到 Ask。
|
||||
- 冻结 Project、Runtime、工作目录、工具、知识、记忆和审批范围。
|
||||
- 提供时区、错过执行、幂等、租约、重试、恢复、取消、预算和审计。
|
||||
- 让所有重复触发复用同一 Task 和 Conversation 关联。
|
||||
- 为一次触发建立清晰 Job/Run，而不是创建新的顶层 Task。
|
||||
|
||||
## 4. 非目标
|
||||
|
||||
- 不提供任意脚本和循环的通用 DAG 编辑器。
|
||||
- 不允许模型生成并直接启用任意 Shell、SQL 或无限频率 Cron。
|
||||
- 不承诺应用退出后继续运行。
|
||||
- 不允许后台计划静默扩大权限、目录、知识、记忆或网络范围。
|
||||
- 不把 Smart Heartbeat 变成 Scheduled Task。
|
||||
- 不把每次触发、重试、Job 或 Run 显示为新的顶层 Task。
|
||||
- 不在左侧会话列表继续展开 Job、Subjob 或 Run。
|
||||
|
||||
## 5. 创建入口与 Modal
|
||||
|
||||
Task Center 和 Conversation 操作都可以提供“新建定制任务”，但共用同一个 Modal，不在
|
||||
窄侧栏长期展开完整表单。
|
||||
|
||||
```text
|
||||
新建定制任务
|
||||
创建一个可以按计划自动运行，并持续记录在会话中的任务
|
||||
|
||||
任务名称 *
|
||||
[ 每周项目总结 ]
|
||||
|
||||
任务要求 *
|
||||
[ 总结本周完成和失败的工作，并列出下周优先事项。 ]
|
||||
|
||||
关联会话
|
||||
◉ 当前会话
|
||||
产品发布讨论 · GoodBuddy Desktop · 已有 2 个任务
|
||||
|
||||
○ 新建会话
|
||||
为任务创建一条新会话，默认标题为任务名称
|
||||
|
||||
执行模式
|
||||
[ Execute ] [ Ask ]
|
||||
|
||||
运行频率
|
||||
[ 单次 ] [ 每日 ] [ 每周 ] [ 每月 ] [ 工作日 ] [ Cron ]
|
||||
|
||||
首次运行 [ 2026-08-21 ] [ 17:00 ]
|
||||
时区 [ Asia/Shanghai ▾ ]
|
||||
|
||||
执行范围
|
||||
GoodBuddy Desktop · OpenCode · 项目工作目录
|
||||
8 个工具可用 · 高风险操作需要审批 [编辑]
|
||||
|
||||
[取消] [创建任务]
|
||||
```
|
||||
|
||||
### 5.1 Conversation 选择
|
||||
|
||||
- 从当前聊天发起时默认选择当前 Conversation。
|
||||
- 从 Task Center 发起时默认选择新 Conversation。
|
||||
- 当前选择必须持续可见，不能根据入口静默决定后隐藏。
|
||||
- 关联当前 Conversation 不修改其标题、既有消息和普通聊天能力。
|
||||
- 当前 Conversation 已有关联 Task 时，显示 Task 数量和共享上下文说明。
|
||||
- 新 Conversation 默认使用 Task 名称作为标题，用户可以单独修改。
|
||||
- 远程通道、归档、正在删除或 Project 不匹配的 Conversation 不可选择，并显示原因。
|
||||
|
||||
### 5.2 创建摘要
|
||||
|
||||
提交前显示确定性摘要：
|
||||
|
||||
```text
|
||||
✓ 为当前 Conversation 新增一个 Task
|
||||
✓ 在左侧会话列表显示“任务 3”
|
||||
✓ 默认以 Execute 模式运行
|
||||
✓ 每周五 17:00 自动执行此 Task
|
||||
✓ 文本结果写入当前 Conversation
|
||||
✓ 独立交付物保存到成果
|
||||
```
|
||||
|
||||
创建 Task、可选新 Conversation、关联关系和 Schedule Binding 必须在 Main 中原子提交。
|
||||
失败时保持 Modal 和用户输入，不只显示短暂通知。提交期间锁定重复操作。
|
||||
|
||||
### 5.3 Modal 行为与无障碍
|
||||
|
||||
- 使用 `role="dialog"`、`aria-modal="true"`、稳定标题和说明关联。
|
||||
- 打开后聚焦首个必填字段，Tab 焦点限制在 Modal 内。
|
||||
- Escape 在未提交时关闭并恢复触发按钮焦点。
|
||||
- 窄窗口使用接近全宽布局，保留 `16px` 外边距。
|
||||
- 字段错误靠近字段；非字段异步错误保留在 Modal 内并提供重试。
|
||||
|
||||
## 6. 工作模式、Runtime 与工具
|
||||
|
||||
### 6.1 默认 Execute
|
||||
|
||||
创建 Modal 默认选择 Execute：
|
||||
|
||||
- Execute 可以调用当前 Runtime 与 Project 已启用、且被 Task 快照允许的工具。
|
||||
- Ask 保持 Runtime 边界只读，只能调用允许的只读能力。
|
||||
- 所选 Runtime 不支持工具执行时，不能静默降级为 Ask；用户必须更换 Runtime 或主动选择
|
||||
Ask。
|
||||
- Modal 持续显示实际 Runtime、Project、工作目录和权限摘要。
|
||||
|
||||
### 6.2 权限快照
|
||||
|
||||
Task 创建时冻结：
|
||||
|
||||
- Project 和工作目录。
|
||||
- Runtime 与模型选择。
|
||||
- 工作模式。
|
||||
- Skills、MCP、知识库、记忆和上下文范围。
|
||||
- 可用工具与审批策略。
|
||||
- 预算、并发和输出限制。
|
||||
|
||||
后续设置变化不修改已启动 Run。编辑 Task 配置只影响后续 Job。
|
||||
|
||||
### 6.3 审批
|
||||
|
||||
- Execute 继续遵守当前 Runtime、GoodBuddy 原生能力和工具审批控制。
|
||||
- 已启用且按现有策略允许自动执行的工具可以在后台运行。
|
||||
- 需要额外确认的动作进入 `waiting_approval`，暂停所属 Job 并发送应用内及桌面通知。
|
||||
- 用户批准后继续同一个 Job/Run；拒绝后按协议失败、跳过或请求调整。
|
||||
- 定时触发不能把高风险、越界或未授权动作转换成自动批准。
|
||||
- 结果未知的外部副作用进入 `outcome_unknown`，不得自动重试。
|
||||
|
||||
## 7. 触发器
|
||||
|
||||
### 7.1 时间触发
|
||||
|
||||
```ts
|
||||
type TimeTrigger =
|
||||
| { type: 'once'; at: string; timezone: string }
|
||||
| { type: 'daily'; localTime: string; timezone: string }
|
||||
| {
|
||||
type: 'weekly'
|
||||
weekdays: number[]
|
||||
localTime: string
|
||||
timezone: string
|
||||
}
|
||||
| {
|
||||
type: 'monthly'
|
||||
day: number | 'last'
|
||||
localTime: string
|
||||
timezone: string
|
||||
}
|
||||
| {
|
||||
type: 'cron'
|
||||
expression: string
|
||||
timezone: string
|
||||
}
|
||||
```
|
||||
|
||||
“工作日”是 `weekly` 的周一至周五预设，不增加新的持久化触发类型。
|
||||
|
||||
受限 Cron 使用五字段，不支持秒、年份、宏、`L`、`W`、`#` 或供应商扩展。Main 负责解析，
|
||||
默认最小间隔为 15 分钟，并展示未来五次触发时间。
|
||||
|
||||
### 7.2 事件触发
|
||||
|
||||
后续支持：
|
||||
|
||||
- `conversation.completed`
|
||||
- `task.completed`
|
||||
- `task.failed`
|
||||
- `artifact.created`
|
||||
- `knowledge.sync.completed`
|
||||
- `magic_note.updated`
|
||||
|
||||
事件触发配置来源范围、确定性过滤、去重窗口、冷却时间和并发上限。基础匹配不调用模型。
|
||||
|
||||
### 7.3 手动触发
|
||||
|
||||
“立即运行”在当前 Task 内创建独立 Job 和 Run，不改变下一次计划时间，不创建新 Task。
|
||||
重复点击使用调用级幂等键去重。
|
||||
|
||||
### 7.4 与普通消息的顺序
|
||||
|
||||
同一 Conversation 的普通消息和 Scheduled Task occurrence 使用同一 FIFO 队列。Agent
|
||||
正在回复时，到期 occurrence 只显示为待执行，不中断当前输出；当前执行结束后才认领下一项。
|
||||
用户显式选择“立即中断并插入”时，系统取消当前 Conversation 的活动请求，并让所选项成为
|
||||
下一项。删除待执行 occurrence 只取消该次运行，不删除稳定 Task、Conversation 或历史结果。
|
||||
|
||||
## 8. 一次触发的对象关系
|
||||
|
||||
```text
|
||||
Conversation
|
||||
└─ Scheduled Task
|
||||
├─ Schedule Binding
|
||||
└─ Job: scheduled_occurrence
|
||||
└─ Run
|
||||
```
|
||||
|
||||
- `scheduledFor` 和计划版本形成幂等键。
|
||||
- 同一 Scheduled Task 默认最多一个活动 occurrence Job。
|
||||
- 若允许并行 occurrence，它们仍属于同一 Task，并由协调器有序写回关联 Conversation。
|
||||
- 重试产生新 Run，不产生新 Task 或新 occurrence Job。
|
||||
|
||||
## 9. 左侧会话列表
|
||||
|
||||
普通 Conversation 保持单行。包含 Task 的 Conversation 显示行首展开按钮：
|
||||
|
||||
```text
|
||||
▾ 产品发布讨论 10:24
|
||||
|
||||
每周进度总结 每周 · Execute · 等待中 ●
|
||||
发布前检查 单次 · Execute ✓
|
||||
```
|
||||
|
||||
- 父会话行不重复显示任务标签或数量；Task 子项名称在左，模式、计划和状态标记收在右侧，
|
||||
与父会话的更新时间位置一致。
|
||||
- 点击 Conversation 标题打开聊天；点击 Task 子项打开同一 Conversation 并定位到该 Task。
|
||||
- 新建 Task 成功后首次自动展开。用户手动折叠后持久化其选择，后台运行不强制展开。
|
||||
- 默认最多直接显示 3 个 Task；“查看全部 N 个任务”打开该 Conversation 的完整 Task 区。
|
||||
- Task 子项显示本地化的模式、计划和非完成态状态文字；状态标记固定在行尾。已完成使用
|
||||
带勾成功点，并将完成文案保留给辅助技术，避免在紧凑元数据中重复显示且不只靠颜色表达。
|
||||
- 左侧只展开 Task；当前产品 UI 的其他区域也不提供 Job/Run 树或独立导航。
|
||||
|
||||
## 10. Conversation 内呈现
|
||||
|
||||
打开包含 Task 的 Conversation 后，顶部提供可折叠 Task 条：
|
||||
|
||||
```text
|
||||
本会话有 2 个任务
|
||||
[每周进度总结] [发布前检查] [管理任务]
|
||||
```
|
||||
|
||||
选中 Task 后显示：
|
||||
|
||||
- 名称、状态和模式。
|
||||
- 计划、下次执行和未来预览。
|
||||
- 最近一次执行结果。
|
||||
- “立即运行”“暂停”“编辑计划”等操作。
|
||||
- 需要审批时的明确恢复入口。
|
||||
|
||||
每条自动结果消息显示 Task 名称、触发来源和时间。普通文本作为消息保存；文件、图片、PDF 和
|
||||
其他独立交付物保存为 Artifact，并从消息引用。多个 Task 并发时，最终文本以完整消息写入，
|
||||
不能把流式 Token 无序混入同一消息时间线。
|
||||
|
||||
## 11. Task Center
|
||||
|
||||
Task Center 显示 Scheduled Task 的范围、关联 Conversation、状态、模式、最近进展、需要
|
||||
关注和下次触发时间：
|
||||
|
||||
- 点击条目打开关联 Conversation，并定位到该 Task。
|
||||
- “立即运行”在内部创建 Job/Run，但 UI 仍只呈现 Task，不改变计划时间。
|
||||
- 暂停只阻止新 Job，不取消已经完成的外部副作用。
|
||||
- Task Center 是完整索引；左侧展开列表只是最近 Conversation 下的轻量入口。
|
||||
- 不新增平行 Automation Center。
|
||||
|
||||
## 12. 错过执行
|
||||
|
||||
| 策略 | 行为 |
|
||||
| --- | --- |
|
||||
| `skip` | 记录跳过，不补跑 |
|
||||
| `run_once` | 无论错过多少次，只在当前 Task 内补一个 Job |
|
||||
| `catch_up_bounded` | 在数量和时间窗口上限内创建多个有界 Job |
|
||||
|
||||
默认补跑最多 3 次、最多回溯 7 天。补跑同样受 Task 的并发、权限和预算控制。
|
||||
|
||||
## 13. 时区和夏令时
|
||||
|
||||
- 保存 IANA 时区，不保存固定 UTC 偏移。
|
||||
- 春季不存在的本地时间在当日第一个有效分钟触发。
|
||||
- 秋季重复时间只触发一次。
|
||||
- 系统时区变化不自动修改计划时区。
|
||||
- UI 显示计划时区、本机时区差异和未来五次触发时间。
|
||||
|
||||
## 14. 预算、恢复和删除
|
||||
|
||||
每个 Scheduled Task 配置最大 Job 耗时、模型/Token/工具调用、成果大小、活动 Job 数和后台
|
||||
优先级。前台请求优先，后台达到上限时记录 `deferred`。
|
||||
|
||||
- 瞬时且没有未知副作用的失败可以有界重试。
|
||||
- 配置、权限和范围错误不重试。
|
||||
- 应用退出将活动 Job/Run 标记为 `interrupted`。
|
||||
- 取消 Task 必须传播到活动 Job、Subjob 和 Runtime。
|
||||
- 删除 Schedule 只停止后续触发，不删除 Task、Conversation 或历史。
|
||||
- 删除 Task 停止其计划并移除关联，默认保留 Conversation 和既有消息。
|
||||
- 删除 Conversation 前显示关联 Task 数量，并先处理活动 Job。
|
||||
|
||||
## 15. 兼容迁移
|
||||
|
||||
现有 Schedule、Schedule Run、Task 和 Conversation 数据渐进关联：
|
||||
|
||||
- 保留现有计划 ID、启停状态、下次时间和历史。
|
||||
- 为每个现有 Schedule 创建一个稳定产品级 Task。
|
||||
- 旧 Schedule 不猜测绑定已有用户 Conversation；为其创建新的关联 Conversation。
|
||||
- 历史每次执行映射为该 Task 下的 occurrence Job/Run。
|
||||
- 旧执行产生的 Task 行在映射成功后不再作为产品级 Task 索引，但其状态、活动和成果继续
|
||||
通过迁移后的 Job/Run 归属保留。
|
||||
- 旧文本 Artifact 可以保留，但迁移不得把它们重复写成新消息。
|
||||
- 迁移不得复制用户消息、独立成果或顶层 Task。
|
||||
|
||||
## 16. 验收标准
|
||||
|
||||
- [x] 创建 Scheduled Task 可以选择当前或新 Conversation。
|
||||
- [x] 关联当前 Conversation 不修改其标题、类型或既有消息。
|
||||
- [x] 一条 Conversation 可以在左侧展开一个或多个 Task。
|
||||
- [x] 默认工作模式为 Execute，且用户可以主动选择 Ask。
|
||||
- [ ] Execute 能调用快照允许的工具，但不能绕过 Runtime 和审批控制。
|
||||
- [x] 不支持工具的 Runtime 不会让 Execute 静默降级。
|
||||
- [x] 重复触发始终复用同一 Task 和 Conversation 关联。
|
||||
- [x] 每次触发创建内部运行记录，不创建新的顶层 Task。
|
||||
- [x] 内部运行记录只用于执行和审计，不在 UI 中显示为独立层级。
|
||||
- [ ] 支持单次、每日、每周、每月、工作日和受限 Cron。
|
||||
- [ ] UI 显示计划时区和未来五次触发时间。
|
||||
- [ ] 夏令时不会造成漂移或双跑。
|
||||
- [ ] 错过执行按配置跳过、补一次或有界补跑。
|
||||
- [x] 手动运行不改变下次计划时间。
|
||||
- [x] Scheduled Task 与普通消息共用 Conversation 级队列，不并发写入同一时间线。
|
||||
- [x] 当前回复期间可以继续发送普通消息，并在 Composer 上沿查看、删除或提升待发送项。
|
||||
- [x] 应用重启恢复尚未执行的队列项和有界附件上下文；已写入 Conversation 的用户输入
|
||||
通过队列项身份完成恢复对账，不会再次进入待发送队列。
|
||||
- [x] 文本结果只写入 Conversation，独立交付物才进入成果。
|
||||
- [ ] Task Center 和桌面通知可以打开正确 Conversation 并定位 Task。
|
||||
- [ ] 应用重启不自动重放结果未知的副作用。
|
||||
@@ -0,0 +1,245 @@
|
||||
# Task 与 Job 统一领域模型
|
||||
|
||||
## 文档信息
|
||||
|
||||
| 项目 | 内容 |
|
||||
| --- | --- |
|
||||
| 状态 | 产品边界与 Scheduled Task 首期已实现；通用 Job/Run 能力待实施 |
|
||||
| 版本 | 0.3 |
|
||||
| 日期 | 2026-08-19 |
|
||||
| 适用产品 | GoodBuddy 桌面端 |
|
||||
| 文档角色 | Task、Conversation、Job、Run 与 Subagent 的权威定义 |
|
||||
|
||||
## 1. 核心定义
|
||||
|
||||
### 1.1 Task
|
||||
|
||||
Task 是用户明确创建或确认的工作单位，也是 Task Center 的顶层对象。
|
||||
|
||||
- 每个 Task 必须关联且只关联一条 Conversation。
|
||||
- 创建 Task 时，用户可以关联当前 Conversation，也可以同时创建一条新 Conversation。
|
||||
- 关联当前 Conversation 不改变其对象类型、标题、既有消息或普通聊天能力，只增加 Task
|
||||
关联及其可见入口。
|
||||
- Task 的目标、状态、范围、计划、Job、审批、活动和成果使用独立 Task 身份保存。
|
||||
- 打开 Task 会打开关联的 Conversation，并定位或展开对应 Task。
|
||||
- 一个 Task 在生命周期内保持稳定的 `taskId` 和 `conversationId` 关联。
|
||||
- 删除 Task 默认停止其计划并移除关联，不删除 Conversation 或既有消息。
|
||||
|
||||
普通模型请求、工具调用或 Runtime Run 不自动成为产品级 Task。只有用户明确创建、确认或
|
||||
由已启用产品流程创建的工作，才进入 Task Center 和 Conversation 的 Task 列表。
|
||||
|
||||
### 1.2 Conversation
|
||||
|
||||
Conversation 是用户消息、助手消息和面向用户结果的内容容器，不因为关联 Task 而变成另一
|
||||
种 Conversation：
|
||||
|
||||
- 一条 Conversation 可以不关联 Task，也可以关联一个或多个 Task。
|
||||
- 多个 Task 可以共享同一 Conversation 的可见上下文，但各自拥有独立配置、计划、权限
|
||||
快照、状态、Job、Run 和成果引用。
|
||||
- Conversation 标题与 Task 名称相互独立。创建或重命名 Task 不静默修改现有会话标题。
|
||||
- 从稳定的本地 Conversation 创建分支会生成新的 Conversation 和消息 ID，并保存直接来源
|
||||
标识；它只复制可见聊天内容与会话级 Runtime/知识检索选择，不复制 Task、发送队列、Job、
|
||||
Run、记忆或 Artifact 归属。来源与分支后续独立更新，删除来源不删除已创建的分支。
|
||||
- 左侧会话列表根据显式 Task 关联显示行首展开按钮；父会话行不重复任务标签，展开后的
|
||||
Task 子项左侧显示名称，右侧显示状态标记，并只展开到 Task 层。
|
||||
- 并行 Job 不直接无序写入消息流；进度留在各自 Task/Job 状态中，最终文本以带来源元数据
|
||||
的完整消息写入 Conversation。
|
||||
- 删除 Conversation 前必须说明关联 Task 数量，并先停止或结算仍活动的 Job。
|
||||
|
||||
### 1.3 Job
|
||||
|
||||
Job 是 Task 内部的执行单位，不是新的顶层 Task：
|
||||
|
||||
- 一次计划触发、一个执行步骤、一项专家委派或一组并行工作都可以是 Job。
|
||||
- 一个 Task 可以串行或并行运行多个 Job。
|
||||
- 所有 Job 仍属于同一个 Task，并通过该 Task 关联的 Conversation 呈现用户可见结果。
|
||||
- Job 可以有自己的状态、预算、Runtime、执行者、输入快照和成果引用。
|
||||
- Job 不进入 Task Center、左侧会话列表或独立详情页。当前产品 UI 的对象层级止于 Task；
|
||||
活动和 Runtime 只按 Task 展示有界执行事件、工具、审批与错误，不呈现 Job 树。
|
||||
|
||||
### 1.4 Subjob
|
||||
|
||||
Subjob 是 Job 的子执行单元。它用于分解和并发，不创建新的 Task 或 Conversation。
|
||||
|
||||
- 父 Job 负责合并 Subjob 结果。
|
||||
- 取消父 Job 必须传播到仍活动的 Subjob。
|
||||
- Subjob 不能扩大父 Job 的 Project、目录、工具、知识、记忆或审批范围。
|
||||
- 深度、数量、并发、时间、Token 和输出大小必须有界。
|
||||
|
||||
### 1.5 Run
|
||||
|
||||
Run 是 Job 或 Subjob 的一次执行尝试和审计记录，不是用户工作对象：
|
||||
|
||||
- 重试、恢复或手动重新运行可以产生新的 Run。
|
||||
- Run 冻结当次配置、范围、预算、Runtime 和权限策略。
|
||||
- Run 进入内部审计；当前 UI 可以显示某次 Task 执行的时间、状态和活动，但不把 Run 呈现为
|
||||
可导航的产品对象。
|
||||
- `completed` 只表示该次执行按协议结束，不必然表示 Task 目标达成。
|
||||
|
||||
### 1.6 Subagent
|
||||
|
||||
Subagent 是执行 Job 或 Subjob 的受限执行者，不是对象层级：
|
||||
|
||||
- 专家、Agent Runtime 或其他执行器可以承担 Job。
|
||||
- Subagent 不自动拥有独立 Task 或 Conversation。
|
||||
- Subagent 输出先回到所属 Job，再由 Task 协调器写入关联 Conversation。
|
||||
|
||||
## 2. 对象关系
|
||||
|
||||
```text
|
||||
Conversation 1 ── 0..N Task
|
||||
│
|
||||
├─ Schedule / Trigger Binding（可选）
|
||||
├─ Job 1
|
||||
│ ├─ Run 0..N
|
||||
│ └─ Subjob 0..N
|
||||
│ └─ Run 0..N
|
||||
├─ Job 2（可与 Job 1 并行）
|
||||
└─ Artifact / Approval / Activity / Notification
|
||||
```
|
||||
|
||||
从 Task 方向看：
|
||||
|
||||
```text
|
||||
Task N ── 1 Conversation
|
||||
```
|
||||
|
||||
不允许：
|
||||
|
||||
```text
|
||||
Task → 没有关联 Conversation
|
||||
Task → 同时关联多条 Conversation
|
||||
Job → 新建顶层 Task
|
||||
Subagent → 自动新建 Conversation
|
||||
Job / Run → 成为可独立导航的 UI 对象
|
||||
```
|
||||
|
||||
## 3. 创建 Task
|
||||
|
||||
创建定制 Task 时必须明确选择 Conversation：
|
||||
|
||||
```text
|
||||
关联当前 Conversation
|
||||
或
|
||||
创建新 Conversation
|
||||
```
|
||||
|
||||
- 从当前聊天发起时，默认选择当前 Conversation。
|
||||
- 从 Task Center 发起时，默认选择新 Conversation。
|
||||
- 选择当前 Conversation 时持续显示会话标题、Project 和已有 Task 数量。
|
||||
- 选择新 Conversation 时，默认使用 Task 名称作为会话标题，但允许用户修改。
|
||||
- Task、Conversation 关联和可选 Schedule Binding 必须在 Main 中原子创建或回滚。
|
||||
|
||||
## 4. Scheduled Task
|
||||
|
||||
Scheduled Task 仍然是 Task，而不是 Schedule 定义和临时 Task 的松散组合：
|
||||
|
||||
1. 用户选择当前或新 Conversation。
|
||||
2. 系统创建一个 Task，建立稳定 `conversationId` 关联，并保存 Schedule/Trigger Binding。
|
||||
3. 到期时在该 Task 内创建新的 Job 和 Run。
|
||||
4. 每次触发的进展和文本结果写入同一关联 Conversation。
|
||||
5. 独立文件、图片和其他交付物保存为 Artifact，并从结果消息引用。
|
||||
6. 编辑计划影响后续 Job，不修改已经启动的 Run。
|
||||
|
||||
同一 Scheduled Task 默认串行触发。需要并行时，应显式允许多个 Job 并发，并继续使用同一
|
||||
Task 和 Conversation 关联，而不是复制顶层 Task。
|
||||
|
||||
## 5. 消息归属
|
||||
|
||||
Task 产生的用户可见消息至少记录：
|
||||
|
||||
```ts
|
||||
type TaskMessageMetadata = {
|
||||
taskId: string
|
||||
jobId: string
|
||||
runId: string
|
||||
trigger: 'manual' | 'scheduled' | 'event' | 'goal'
|
||||
}
|
||||
```
|
||||
|
||||
同一 Conversation 关联多个 Task 时：
|
||||
|
||||
- 消息持续显示来源 Task 名称。
|
||||
- 点击左侧展开项或 Task Center 条目可以定位对应 Task 和近期消息。
|
||||
- 任务筛选只改变定位和高亮，不隐藏用户未主动筛选的普通消息。
|
||||
- 多个活动 Job 的流式细节进入各自活动记录，最终文本有界持久化后再写入 Conversation。
|
||||
|
||||
## 6. 状态分层
|
||||
|
||||
| 层级 | 典型状态 | 用户在哪里看到 |
|
||||
| --- | --- | --- |
|
||||
| Task | idle、queued、running、waiting_approval、paused、completed、failed、cancelled、interrupted | Task Center、左侧会话展开项、Conversation |
|
||||
| Job | queued、running、waiting_approval、completed、failed、cancelled | 内部协调与审计，不作为 UI 对象 |
|
||||
| Run | claimed、running、completed、failed、cancelled、interrupted、budget_exceeded、outcome_unknown | 内部执行与审计，不作为 UI 对象 |
|
||||
|
||||
Task 状态由当前目标和所属 Job 聚合得出，但不能用“任一 Job 完成”直接推断 Task 完成。
|
||||
Conversation 折叠行只显示其关联 Task 中最高优先级的关注状态：
|
||||
|
||||
```text
|
||||
waiting_approval > failed > running > paused > idle
|
||||
```
|
||||
|
||||
## 7. UI 展示边界
|
||||
|
||||
当前产品 UI 的对象层级统一止于 Task：
|
||||
|
||||
- 左侧会话列表展开到 Task。
|
||||
- Task Center 只索引 Task。
|
||||
- Conversation 顶部任务区只选择和管理 Task。
|
||||
- 活动与 Runtime 可以展示 Task 的执行时间、工具、审批、错误、成果和状态事件，但不显示
|
||||
Job/Subjob 树，不提供 Job/Run 路由、列表或独立操作菜单。
|
||||
- “立即运行”“重试”和“恢复”在 UI 上都是 Task 操作；Job/Run 只在内部创建和审计。
|
||||
|
||||
## 8. 左侧 Conversation Task 列表
|
||||
|
||||
左侧最近会话列表是轻量发现入口，不替代 Task Center：
|
||||
|
||||
- 无 Task 的 Conversation 保持现有单行样式。
|
||||
- 有 Task 的 Conversation 显示行首展开按钮，父会话行不重复任务标签或数量。
|
||||
- 展开后只显示名称、本地化摘要和右侧状态标记，不继续显示 Job、Subjob 或 Run。
|
||||
- 新建 Task 成功后首次自动展开；用户手动折叠后保持选择，后台状态变化不强制展开。
|
||||
- 默认最多直接显示 3 个 Task；“查看全部 N 个任务”打开该 Conversation 的完整 Task 区。
|
||||
- Task 子项的状态标记固定在右侧；运行、审批、失败和暂停同时使用本地化状态文字。
|
||||
- 删除最后一个关联 Task 后，Conversation 的展开按钮自动消失。
|
||||
|
||||
## 9. 兼容映射
|
||||
|
||||
当前代码和旧文档中的对象按以下方式收敛：
|
||||
|
||||
| 旧概念 | 目标概念 |
|
||||
| --- | --- |
|
||||
| 自动任务 | Scheduled Task、Event Task 或 Goal Task |
|
||||
| 自动会话 | 删除该独立概念，使用关联 Conversation |
|
||||
| 子任务、Child Task | Job 或 Subjob |
|
||||
| 专家子任务 | 由专家 Subagent 执行的 Job/Subjob |
|
||||
| 多任务并行 | 一个或多个 Task 下的并行 Job；根据用户目标和 Conversation 归属明确建模 |
|
||||
| Schedule Run | Scheduled Task 内的 Job Run |
|
||||
| Automation Run | Task 所属 Job 或 Subjob 的 Run |
|
||||
| 普通请求 Task 行 | 内部执行/审计记录，不自动成为产品级 Task |
|
||||
|
||||
数据库字段可以在兼容期保留旧名称，但新产品文案、PRD 和新增契约必须使用本模型。
|
||||
|
||||
## 10. 安全和数据要求
|
||||
|
||||
- Main 验证 Conversation、Task、Job、Run 和 Project 的完整归属链。
|
||||
- Task 只能关联同一 Project 范围内允许使用的 Conversation。
|
||||
- Renderer 不能把任意 Task 或 Job 绑定到其他 Project 的 Conversation。
|
||||
- Job/Subjob 继承 Task 的能力上限，只能缩小，不能扩大。
|
||||
- Execute Task 冻结 Runtime、工作目录、工具和审批策略；后台触发不能扩大权限。
|
||||
- 并行输出先有界持久化，再按确定顺序汇总到 Conversation。
|
||||
- 取消、超时、审批和应用退出必须沿 Task → Job / Subjob → Run → Runtime 传播。
|
||||
- 删除 Task 默认保留 Conversation 和消息；删除 Conversation 必须处理其全部关联 Task。
|
||||
|
||||
## 11. 验收原则
|
||||
|
||||
- [ ] 每个 Task 只关联一条 Conversation。
|
||||
- [ ] 一条 Conversation 可以关联零个、一个或多个 Task。
|
||||
- [ ] 创建 Task 可以选择当前 Conversation 或新 Conversation，且不会改变当前会话类型。
|
||||
- [ ] 左侧会话列表通过行首按钮展开带任务图标和本地化摘要的 Task，但不展开 Job/Run。
|
||||
- [ ] 当前 UI 不提供 Job、Subjob 或 Run 的独立列表、树、路由或操作菜单。
|
||||
- [ ] Scheduled Task 的重复触发复用同一 Task 和 Conversation 关联。
|
||||
- [ ] 一个 Task 可以运行多个串行或并行 Job。
|
||||
- [ ] Job、Subjob、Run 和 Subagent 不进入 Task Center，也不成为其他可导航 UI 对象。
|
||||
- [ ] Task 消息可以通过 `taskId`、`jobId` 和 `runId` 追溯来源。
|
||||
- [ ] 并行 Job 不直接无序写入 Conversation。
|
||||
- [ ] 取消和权限范围能够沿层级正确传播。
|
||||
@@ -0,0 +1,120 @@
|
||||
# Task Center PRD
|
||||
|
||||
## 文档信息
|
||||
|
||||
| 项目 | 内容 |
|
||||
| --- | --- |
|
||||
| 状态 | Scheduled Task 首期已实现；Goal/Event Task 与完整操作待实施 |
|
||||
| 版本 | 0.3 |
|
||||
| 日期 | 2026-08-19 |
|
||||
| 依赖 | [Task 与 Job 统一领域模型](./task-and-job-model.md) |
|
||||
| 界面归属 | [通用助手工作栏与执行空间](../assistant-workbar/prd.md) |
|
||||
|
||||
## 1. 产品定义
|
||||
|
||||
Task Center 是所有产品级 Task 的应用级单例索引，不是 Automation Center，也不复制
|
||||
Conversation 内容。点击条目打开其关联 Conversation，并定位或展开对应 Task。
|
||||
|
||||
每个 Task 只关联一条 Conversation；一条 Conversation 可以关联零个、一个或多个 Task。
|
||||
Conversation 不因为关联 Task 而改变对象类型。
|
||||
|
||||
## 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 至少显示：
|
||||
|
||||
- 名称和 Global / Project 范围。
|
||||
- 关联 Conversation 标题。
|
||||
- Task 类型和触发来源。
|
||||
- Ask / Execute 模式。
|
||||
- 当前聚合状态。
|
||||
- 最近一次面向用户的进展。
|
||||
- 最近活动时间。
|
||||
- 等待审批、失败或需要关注状态。
|
||||
- 下次计划时间（如适用）。
|
||||
|
||||
Task 行只显示聚合后的用户状态，不要求用户理解内部 Job/Run。
|
||||
|
||||
## 4. 交互
|
||||
|
||||
- 点击条目打开关联 Conversation，并定位到该 Task。
|
||||
- 支持按需要关注、进行中、已暂停、已结束筛选。
|
||||
- 支持立即运行、暂停、恢复、取消、编辑和删除。
|
||||
- 后台变化更新状态和徽标，不自动抢占当前页面。
|
||||
- 立即运行、重试和恢复在 UI 上都是 Task 操作，内部 Job/Run 不单独显示。
|
||||
- 完整消息留在 Conversation；工具、审批和错误可以在活动或 Runtime 中按 Task 查看；
|
||||
独立交付物在成果中查看。
|
||||
|
||||
## 5. 左侧 Conversation Task 列表
|
||||
|
||||
左侧最近会话列表承担轻量 Task 发现，不替代 Task Center：
|
||||
|
||||
```text
|
||||
▾ 产品发布讨论 10:24
|
||||
|
||||
每周进度总结 每周 · Execute · 等待中 ●
|
||||
发布前检查 单次 · Execute ✓
|
||||
```
|
||||
|
||||
- 无 Task 的 Conversation 保持现有单行样式。
|
||||
- 有 Task 时在行最左侧显示独立展开按钮；父会话行不重复显示任务标签或数量。
|
||||
- 更新时间默认靠近行右侧，更多操作按钮不常驻占位；悬停会话行时，按钮替换右侧时间显示。
|
||||
键盘焦点进入会话行或操作菜单展开时，按钮仍保持可见。会话标题溢出时保持右侧区域固定，
|
||||
并在自身裁切区域内横向滑动展示完整名称。未溢出标题不滑动，减少动态效果偏好下使用完整
|
||||
标题提示而不产生位移。
|
||||
- 展开后每个 Task 子项左侧显示名称，右侧显示本地化的模式、计划和状态标记，与父会话
|
||||
更新时间对齐；已完成使用带勾成功点并将文案保留给辅助技术。列表不显示 Job、Subjob、
|
||||
Run 或工具步骤。
|
||||
- 点击 Conversation 标题打开聊天；点击 Task 打开同一 Conversation 并定位该 Task。
|
||||
- 新建 Task 后首次自动展开；用户手动折叠后保持选择。
|
||||
- 后台状态变化不强制展开；Task 状态持续显示在展开后的子项和 Task Center 中。
|
||||
- 默认最多显示 3 个 Task；“查看全部 N 个任务”打开该 Conversation 的完整任务区。
|
||||
|
||||
## 6. Conversation 任务区
|
||||
|
||||
包含 Task 的 Conversation 顶部显示可折叠任务区：
|
||||
|
||||
```text
|
||||
本会话有 2 个任务
|
||||
[每周进度总结] [发布前检查] [管理任务]
|
||||
```
|
||||
|
||||
选择 Task 后显示名称、模式、聚合状态、计划、下次执行、最近结果和 Task 级操作。工具、审批、
|
||||
错误和成果通过 Task 关联显示，但不暴露 Job/Run 层级。
|
||||
|
||||
## 7. 删除关系
|
||||
|
||||
- 删除 Schedule 只停止后续触发，不删除 Task、Conversation 或历史。
|
||||
- 删除 Task 停止其计划并移除关联，默认保留 Conversation 和既有消息。
|
||||
- 删除最后一个 Task 后，左侧 Conversation 的展开按钮消失。
|
||||
- 删除 Conversation 前必须显示关联 Task 数量，并先停止或结算活动执行。
|
||||
|
||||
## 8. 验收标准
|
||||
|
||||
- [x] Task Center 只展示产品级 Task。
|
||||
- [x] 一条 Conversation 可以关联并展开多个 Task。
|
||||
- [x] 点击 Task 打开正确 Conversation 并定位到对应 Task。
|
||||
- [x] 左侧会话列表通过独立展开按钮显示带任务图标和本地化摘要的 Task 子项。
|
||||
- [x] 当前 UI 不显示 Job/Subjob/Run 树或独立页面。
|
||||
- [x] Scheduled Task 显示下次时间，但每次触发不新增 Task 条目。
|
||||
- [x] 普通模型请求和工具调用不会误显示为 Task。
|
||||
- [ ] 删除 Task 默认保留 Conversation 和既有消息。
|
||||
- [x] Smart Heartbeat 不进入 Task Center。
|
||||
Reference in New Issue
Block a user