goodbuddy/docs/features/task-and-job/README.md

Task 与 Job 文档集

本目录定义 GoodBuddy 的工作对象、内部执行单元和调度关系。

权威文档

1. Task 与 Job 统一领域模型：术语、身份和对象关系。
2. Task Center PRD：Task 的单实例项目跟随索引与范围切换。
3. Scheduled Task PRD：时间或事件触发的 Task。
4. Goal Task PRD：围绕可验证结果有界推进的 Task。
5. Job 与 Subjob PRD：Task 内部串行、并行和委派执行。
6. 技术设计：运行状态计时、快照订阅与不完整历史边界，以及立即创建的事务和入队规则。

共享存储、后台读取和 Renderer 调度的通用约束见运行时存储架构。

正式功能范围固定为当前项目：顶部显示当前会话消息总数和 Agent 累计回复时间，下方列出本项目全部会话的任务。创建默认立即执行并关联当前会话，可选择本项目其他会话、新会话或定时周期；产品与验收规则见 Task Center PRD 和 Scheduled Task PRD。

阅读顺序

当前会话统计 Demo 用于评审任务中心中的紧凑统计区：上方显示当前会话的消息数与 Agent 累计回复时长，下方管理当前项目全部会话的任务及用时。切换会话只更新会话统计，任务范围固定为当前项目，没有全局或所有项目入口。支持状态筛选、定位所属会话，以及暂停、继续和取消任务的模拟操作。新建任务支持填写内容、关联本项目已有或新建会话、立即或定时执行；仅在页面内模拟，刷新后恢复样例。 配套 hierarchy-demo.css 与 hierarchy-demo.js 仅服务于该静态原型；使用演示数据，未接入产品。 应用中的项目任务标题右侧仅保留 ＋ 新建按钮；展开列表后直接显示状态选项，默认选中“进行中”，收起后保留所选状态。静态 Demo 的筛选入口仍为旧交互。 时间为固定样例，Demo 从每次回复的起止秒数计算。正式功能由 Main 累计回复请求处于 running 状态的时间，暂停、等待审批和轮间空闲不计时；任务用时汇总到所属任务卡。旧历史和中断时未闭合的区间标为不完整，不查询历史消息重建。远程请求只统计桌面观察到的运行区间，断连期间的用时未知；具体规则见技术设计。

先阅读统一领域模型。其他功能文档不得重新定义 Task、Conversation、Job、Run 或 Subagent。 若实现与文档出现冲突，应先修正统一模型，再同步功能 PRD。

相关功能

• 本机专用推理架构与任务控制评估记录 ASR、OCR、embedding 的任务与服务状态、执行所有权、取消、超时、清理及观测待办；推理请求不自动等同于本目录的产品 Task，候选迁移尚未采用。
• 直连模型 Agent 能力 使用本目录定义的 Subagent 与 Job/Subjob 语义，为直连模型提供单层编程委派，但不重新定义产品对象层级。