# 智能心跳 PRD

## 文档信息

| 项目 | 内容 |
| --- | --- |
| 状态 | 入口与范围已实现；未来分区记忆待独立设计 |
| 版本 | 0.5 |
| 日期 | 2026-08-19 |
| 适用产品 | GoodBuddy 桌面端 |
| 文档角色 | 智能心跳当前能力、权威入口、范围和长期边界 |
| 相关设计 | [统一界面设计系统](../../../UI-DESIGN.md) |
| 相关架构 | [自动化、监督与记忆平台总体设计](../../architecture/automation-platform-architecture.md) |
| 相关界面 | [通用助手工作栏与执行空间 PRD](../assistant-experience/assistant-workbar-and-execution-spaces-prd.md) |
| Task 模型 | [Task 与 Job 统一领域模型](../task-and-job/task-and-job-model.md) |

> 本文区分近期实施与长期方向。未完成设计的“未来分区记忆”不得转写为数据结构、状态机、
> 页面、迁移或验收条件。

## 1. 已确认的产品边界

### 1.1 智能心跳是独立能力

- “智能心跳”菜单入口是心跳配置、报告、建议和运行历史的权威位置。
- 任务中心和设置中心不复制完整心跳配置表单。
- 智能心跳不并入通用自动化中心，也不作为任务中心条目。
- 现有心跳报告、记忆建议、行动建议和审计历史在本轮继续保留。

### 1.2 长期方向：未来分区记忆

已确认的方向只有：

> 智能心跳未来应成为按范围隔离的未来记忆。

以下内容尚未设计：

- “未来记忆”的数据结构与存储方式。
- 与当前长期记忆、心跳报告和建议的关系。
- 唤起条件、状态和生命周期。
- 到期后的页面和交互。
- 是否以及如何创建 Task。
- 旧版心跳数据如何迁移。

本轮不得实现 `FutureMemory`、新增未来记忆数据库表，或制作“未来记忆 / 即将唤起 /
已唤起”等页面。后续需要独立 PRD 和用户确认。

## 2. 本轮实施范围

### 2.1 目标

1. 完整心跳配置统一到“智能心跳”菜单入口。
2. 心跳配置支持 `Global` 或指定一个、多个 Project。
3. 保留现有概览、待处理建议、运行历史和报告能力。
4. 新入口完整可用后，再移除任务中心和设置中心中的重复心跳配置。
5. 旧心跳配置、运行、报告、建议、记忆和任务数据不丢失。

### 2.2 非目标

- 不设计或实现未来分区记忆。
- 不修改 Task、Job 或 Task Center 模型。
- 不新增独立 Automation Center。
- 不移除定时任务现有入口。
- 不扩大智能心跳的工具、目录、网络或 Execute 权限。
- 不让智能心跳跨越配置范围读取数据。
- 不将现有心跳建议静默转换成 Task。

## 3. 智能心跳范围

### 3.1 范围选择

每条心跳配置必须明确选择：

| 范围 | 当前执行语义 |
| --- | --- |
| `Global` | 回顾所有 Project 中允许读取的有界会话和任务，并读取 Global 已确认记忆 |
| 指定 Project | 只回顾选中 Project 的有界会话和任务，并读取 Global 与选中 Project 的已确认记忆 |

指定 Project 可以选择一个或多个项目：

```text
范围
(•) Global
( ) 指定项目
    [✓] 网站重构
    [ ] 内容运营
    [✓] 客户研究
```

- `Global` 与指定 Project 互斥。
- 指定 Project 时至少选择一个项目。
- 多项目使用 Checkbox，不使用 Switch。
- 当前项目只可以作为创建表单的建议默认值，不能在保存时隐式覆盖用户选择。
- 切换当前项目不会改变已经保存的心跳范围。
- Main 必须重新验证所有 Project ID，Renderer 不能扩大范围。

### 3.2 多项目执行

多项目配置的一次心跳仍然是一次运行和一份报告：

- 将选中项目中允许读取的会话、任务和记忆汇总后，再执行现有全局输入上限。
- 不为每个 Project 分别创建 Run、报告、建议或 Task 副本。
- 心跳报告成果以无项目归属保存，并在成果元数据中冻结本次配置范围。
- 心跳产生的项目级记忆建议或行动建议必须明确目标 Project。
- 目标 Project 不明确时，只能生成 Global 记忆建议或不绑定项目的行动建议，不能猜测。

### 3.3 兼容现有配置

旧配置按现有 `projectId` 非破坏映射：

- `projectId` 为空的配置迁移为 `Global`。
- `projectId` 有值的配置迁移为“指定 Project”，且只绑定原项目。
- 迁移不修改启停状态、重复规则、时间、回顾窗口、保留期限、下次运行或历史。
- 项目删除时，只有该项目的配置按现有规则删除；多项目配置移除被删除项目并保留其他范围。

## 4. 权威入口

| 操作 | 权威入口 | 其他位置 |
| --- | --- | --- |
| 创建或编辑心跳配置 | 智能心跳 > 心跳计划 | 不复制表单 |
| 选择 Global / Project 范围 | 智能心跳 > 心跳计划 | 不依赖当前项目推断 |
| 暂停、恢复、立即心跳或删除 | 智能心跳 > 心跳计划 | 不复制操作 |
| 查看报告与待处理建议 | 智能心跳 | 主导航徽标和通知可触达 |
| 查看运行历史和失败 | 智能心跳 > 心跳轨迹 | 活动记录仅作审计补充 |
| 管理平台级默认值 | 设置中心 | 不显示单条计划 CRUD |

移除重复入口的顺序：

1. 先在智能心跳中支持完整创建、编辑、范围、暂停、恢复、立即运行和删除。
2. 验证旧数据与新范围均可管理。
3. 再从任务中心移除 `HeartbeatSettings`。
4. 再从设置中心移除重复 `HeartbeatSettings`，必要时保留“打开智能心跳”链接。
5. 任一步失败都不得造成用户没有可用配置入口。

## 5. 智能心跳页面

保留现有四个页面：

- **成长概览**：状态、成功率、记忆、洞察和行动统计。
- **待处理建议**：记忆建议和行动建议。
- **心跳轨迹**：报告与 Run 审计。
- **心跳计划**：唯一完整配置入口。

### 5.1 心跳计划

创建和编辑至少显示：

- 名称。
- `Global` 或指定 Project 范围。
- 每日或每周重复规则。
- 本地时间、星期与 IANA 时区。
- 回顾窗口。
- 保留期限。
- 启停状态。
- 下次运行与上次状态。

交互要求：

- 使用持久标签，不以 placeholder 代替。
- 编辑进入明确状态，支持保存或放弃。
- 保存失败保留草稿。
- 删除继续使用共享破坏性确认。
- 运行中禁用重复操作。
- 保存成功后由计划列表直接反映结果；失败保留草稿并在编辑区就地提示。

### 5.2 范围呈现

- 页面标题不再根据当前 Project 伪装成心跳实际范围。
- 每张计划卡片显示 `Global` 或完整 Project 摘要。
- 多项目过多时显示“项目 A、项目 B 等 N 个”，并提供完整可访问名称。
- 报告成果元数据保存配置冻结范围；计划卡片始终显示计划自身范围，不根据当前项目重新解释。
- 项目失效或删除后，界面准确显示剩余范围或配置已被移除。

### 5.3 响应式与无障碍

- 宽窗口使用 `dashboard` 壳层，创建和编辑区域保持单列。
- 窄窗口下计划列表和表单转为单列卡片。
- `Global / 指定项目` 使用共享分段选择控件，Project 多选使用 Checkbox。
- 范围、状态和失败不能只依赖颜色。
- 表单错误与字段程序化关联。
- 对话框或编辑区关闭后，焦点返回触发按钮。

## 6. 数据与安全要求

目标合同只扩展现有心跳范围，不引入 Future Memory：

```ts
type HeartbeatScope =
  | { kind: 'global' }
  | { kind: 'projects'; projectIds: string[] }
```

- 旧 `projectId` 只用于迁移兼容，不继续作为目标范围合同。
- Main 在创建、编辑、列出和执行时验证 Project 归属。
- Global 读取所有 Project 的有界会话和任务，但长期记忆仍只读取 Global。
- 指定 Project 读取选中项目的有界会话和任务，以及 Global 与选中项目记忆。
- 现有输入条数、字符预算、输出大小、超时、重试、租约和工具禁用边界继续生效。
- 多项目汇总后统一应用上限，不能按项目倍增预算。
- 心跳结果默认不在系统通知中暴露私人正文。
- 数据迁移必须使用 SQLite 事务，保留外键、级联删除和现有历史。

## 7. 实施状态与后续顺序

### 已完成：入口和范围

- 扩展共享 Schema、Preload 与 Main 数据合同。
- 增加 Global / 多 Project 持久化与旧数据迁移。
- 让心跳执行按冻结范围构建有界输入。
- 在“心跳计划”中完成创建、编辑和全部计划操作。
- 补齐范围、迁移、权限和界面测试。

### 已完成：移除重复配置

- 从 Task Center 移除心跳完整表单，保留 Task 和 Scheduled Task 现有行为。
- 从设置中心移除单条心跳 CRUD。
- 如需要，设置中心仅保留“打开智能心跳”导航。
- 验证应用内仍只有一个完整配置入口。

### 后续：独立设计

- 未来分区记忆。
- 与长期记忆的关系。
- 唤起模型与生命周期。
- 与 Task 的关系。

这些内容需要新的 PRD 和明确确认，不属于本轮实现。

## 8. 验收状态

- [x] 智能心跳菜单是完整配置的唯一权威入口。
- [x] 用户可以创建和编辑 `Global` 心跳。
- [x] 用户可以创建和编辑绑定一个或多个 Project 的心跳。
- [x] 切换当前 Project 不会改变已保存范围。
- [x] Main 拒绝不存在、已归档或超出配置范围的 Project ID。
- [x] Global 与多项目输入遵守现有总上限，不按项目倍增。
- [x] 多项目一次运行只产生一份 Run 和报告。
- [x] 旧 Global 和单 Project 配置无损迁移。
- [x] 旧运行、报告、建议、记忆和任务仍可查看。
- [x] 心跳计划支持创建、编辑、暂停、恢复、立即运行和删除。
- [x] 任务中心不再包含完整心跳配置表单。
- [x] 设置中心不再包含单条心跳 CRUD。
- [x] 任务中心本身以及定时任务现有行为没有被删除。
- [x] 智能心跳仍保持只读、禁用工具和有界输入输出。
- [x] 没有新增 Future Memory 表、状态机或未确认页面。
- [x] 加载失败、空状态、字段错误和危险操作满足统一设计与无障碍要求。