# 通用助手工作栏与执行空间 PRD

## 文档信息

| 项目 | 内容 |
| --- | --- |
| 状态 | 设计中 |
| 版本 | 0.3 |
| 日期 | 2026-08-19 |
| 适用产品 | GoodBuddy 桌面端 |
| 相关设计 | [统一界面设计系统](../../../UI-DESIGN.md) |
| 相关能力 | [会话监督](../supervision/conversation-supervision-prd.md)、[自动化平台](../../architecture/automation-platform-architecture.md)、[长期助手路线图](../../roadmap/long-term-assistant-roadmap.md) |

## 1. 背景

GoodBuddy 已经在聊天右侧提供上下文、工作区、浏览器和成果面板，也已经具备
Runtime 事件、Git 变更、文件预览、成果存储、受控浏览器和专家 Job 等基础能力。后续还
计划增加：

- Conversation 和 Task/Job Run 的独立监督。
- OpenCode、Continue 和 DeepSeek Harness 的 Runtime 生命周期监督。
- 用户可直接使用的终端和受管进程。
- HTML 等成果的即时安全预览。
- 本机与 SSH 远程主机上的工作区和 Agent Runtime。

这些能力不能被收束为只面向编程的工作台。监督、Runtime、终端、进程、浏览器、成果和
上下文都可以服务于普通问答、内容分析、自动化、数据处理、远程运维、知识整理和软件开发。
同时，能力目录也不能根据当前页面、项目类型或 Runtime 能力无提示地变化，否则用户无法在
需要时主动打开面板并选择目标、主机或运行环境。

本设计把右侧区域定义为应用级的“助手工作栏”，并把本机或远程的目录、终端、进程和
Runtime 统一抽象为“执行空间”。

## 2. 产品定义

### 2.1 助手工作栏

助手工作栏是 GoodBuddy 中始终可访问的应用级工具容器。它提供稳定能力目录，用户从中
查看任务中心，并按需打开一个或多个监督、Runtime、终端、进程、工作区、浏览器、成果和
上下文面板实例。稳定的是能力的可发现性，不是九个同时占据界面的固定面板。

工作栏不是：

- 只在编程项目中出现的 IDE 面板。
- 当前聊天消息的附属详情框。
- 根据能力探测结果自动增删入口的动态菜单。
- 绕过 Main、Preload、Ask/Execute 或审批边界的控制台。
- 全系统进程管理器、任意文件浏览器或无边界远程管理工具。

### 2.2 执行空间

执行空间描述工作区、终端、受管进程和 Agent Runtime 实际运行的位置：

```ts
type ExecutionSpace =
  | {
      kind: 'local'
      rootPath?: string
    }
  | {
      kind: 'ssh'
      hostId: string
      remoteRootPath?: string
    }
```

执行空间可以来自当前项目，也可以由用户在工作栏中临时选择。临时选择不会静默修改项目
设置，只有用户显式保存时才成为项目默认值。

## 3. 核心产品原则

### 3.1 能力目录稳定，面板实例由用户控制

工作栏能力目录提供以下标准能力：

```text
任务中心
监督
Runtime
终端
进程
工作区
浏览器
成果
上下文
```

- 应用不得根据当前项目、会话、Runtime、主机或探测结果无提示地增删能力目录项。
- 用户主动打开、关闭、排序和停靠面板实例；应用不默认同时挂载全部能力。
- Task Center 是 Task 的单例应用级索引。每个 Task 与唯一 Conversation 一对一；Task
  Center 不复制会话内容，也不显示普通 Conversation、Job、Run 或心跳事项。
- 当前能力、连接、数据和空状态可以动态变化。
- 能力不可用时，目录项或已打开面板显示原因、影响和可执行的配置或切换入口，不能只通过隐藏表示。
- 用户可以在设置中调整目录顺序；恢复默认布局恢复标准目录与默认打开面板，不强制打开全部能力。
- 同一能力需要并排比较不同目标时可以创建多个实例，每个实例拥有独立身份和范围绑定。

### 3.2 当前上下文只提供默认值

任务中心作为全局索引不跟随当前会话，也不支持为同一列表打开多个目标实例。其他可绑定
目标的能力使用当前会话、项目、Runtime 和主机帮助新面板实例初始定位，但这些上下文不是
使用门槛：

- 监督默认选择当前会话，用户可以改选其他 Conversation、Task、Job/Run 或实验 Run。
- Runtime 默认跟随当前会话，用户可以固定到其他活动或历史 Run。
- 终端默认使用当前项目执行空间，用户可以新建本机或远程终端。
- 工作区默认显示当前项目目录，用户可以打开其他本机目录或远程目录。
- 成果和上下文默认使用当前范围，用户可以切换到项目、全局或其他允许范围。

每个可切换目标的面板实例都提供一致的范围模式：

```text
跟随当前上下文
固定到指定对象
```

固定目标失效时，面板显示“目标不可用”和修复入口，不静默回到其他目标。

### 3.3 用户控制打开、切换和介入

- 后台事件可以更新目录徽标、面板状态和通知，但不得无条件抢占当前面板。
- 只有用户刚刚发起且明确需要面板完成的交互，才可以打开对应面板。
- 浏览器画面、审批、监督警告、Runtime 失败和终端退出默认通过徽标或通知提示。
- 高风险状态必须持续可见，但不以自动切页代替用户选择。
- 用户切换页面、会话或项目时，已固定的面板目标保持不变；跟随模式才更新目标。

### 3.4 入口稳定不等于虚假能力

稳定能力目录和已打开面板必须准确呈现能力差异：

- 当前 Runtime 不支持后台 Job 时，Runtime 能力仍可发现；打开后说明当前可监督的内容。
- 当前执行空间没有 Git 仓库时，工作区文件功能仍可使用，Git 区域显示不可用原因。
- 没有活动进程时，进程面板提供创建终端或启动 Runtime 的入口。
- 没有项目时，终端和工作区允许用户选择本机目录或远程主机。
- 监督未启用时，监督面板提供目标、模式和“开始监督”，而不是隐藏能力。

不得渲染成排没有解释的禁用按钮，也不得把“进程连通”描述为已经支持完整原生监督。

### 3.5 通用能力与领域能力分层

- 监督判断目标、证据、矛盾、遗漏、质量和风险，不假设目标一定是编程。
- Runtime 监督展示运行生命周期，不假设 Runtime 一定是 OpenCode。
- 终端和进程是通用执行能力，不只服务代码构建。
- 工作区可以是文档、数据、知识或代码目录；Git 是可选区域。
- HTML 预览属于通用成果能力，不只用于网页开发。
- SSH 主机可以承载 Agent、自动化、数据处理和工作区，不只代表远程代码仓库。

## 4. 目标

### 4.1 用户目标

- 从任意主要页面随时发现同一组稳定能力，并按需打开所需面板。
- 自主选择每个可绑定目标的面板实例跟随当前上下文还是固定到指定目标。
- 在不中断主任务的情况下观察监督意见、Runtime、进程和成果。
- 随时创建本机或远程终端，并理解其执行位置和权限。
- 查看 GoodBuddy 管理的进程及其来源、输出和停止状态。
- 对生成的 HTML、Markdown、JSON、图片等成果进行即时安全预览。
- 管理 SSH 主机，并在远程执行空间中运行受控 Agent Runtime。

### 4.2 产品目标

- 建立不依赖具体页面和 Runtime 的应用级工作栏、能力目录和面板实例壳层。
- 建立统一范围、执行空间、生命周期、成果和控制契约。
- 复用现有 Project、Conversation、Task、Artifact、Activity 和 Approval 数据。
- 保持 Renderer 无任意文件、进程、PTY、SSH 或 Electron API 能力。
- 保持 Ask 只读、Execute 审批、取消、超时、输出边界和活动审计。
- 为本机与远程能力提供一致 UI，同时准确表达能力差异。

## 5. 非目标

- 不把 GoodBuddy 改造成完整 IDE。
- 不提供全系统进程枚举和任意 PID 终止。
- 不默认扫描用户全部目录、远程主机或 SSH 配置。
- 不允许 Agent 未经现有 Runtime 边界直接向用户终端注入输入。
- 不自动执行 HTML 中的脚本或访问网络。
- 不让监督器自动替用户发言、批准工具、扩大范围或修改安全策略。
- 不在首期承诺网络断开后远程任务一定可恢复。
- 不在首期支持任意 ProxyCommand、任意端口转发或 SSH Agent Forwarding。
- 不要求所有 Runtime 提供相同的 Subagent、Job、Hook 或会话能力。

## 6. 信息架构

### 6.1 应用级位置

助手工作栏位于主窗口右侧，但不归属于聊天页面。聊天、知识、魔法笔记、自动化、活动记录
等主要页面都可以打开它。各页面可以提供默认范围，不能维护互不相容的右栏副本。

```text
┌──────────────┬──────────────────────────────┬────────────────────────┐
│ 主导航       │ 当前主任务                   │ 助手工作栏             │
│              │                              │                        │
│ 会话 / 知识  │ 聊天、文档、自动化或数据视图 │ 稳定能力目录           │
│ 自动化 / 活动│                              │ 用户打开的面板实例     │
│ 设置         │                              │ 各实例范围与执行空间   │
└──────────────┴──────────────────────────────┴────────────────────────┘
```

### 6.2 能力目录与面板实例

能力目录不等于同时打开九个面板。推荐使用工作栏内的纵向能力导航，并在旁边或停靠区域管理
用户已经打开的面板实例：

- 每项始终显示稳定图标，并提供可见标签或可持续查看的工具提示。
- 目录使用与其交互模型匹配的列表、工具栏或菜单语义；单实例切换使用 `tablist`、`tab`、
  `tabpanel`，多实例停靠区使用有名称的区域和明确面板标题。
- 支持方向键、Home、End、Enter、Space、关闭面板和正确焦点恢复。
- 徽标显示未解决数量、等待审批或失败状态，并同时提供文字或可访问名称。
- 用户调整目录顺序、打开实例、停靠位置和尺寸后持久化；关闭实例后能力仍可从目录重新打开。
- 默认布局只恢复经过产品确认的少量常用面板，不自动打开全部标准能力。
- 每个实例显示稳定实例 ID、能力名称、跟随或固定状态与当前目标；同能力多实例不能只靠位置区分。

当前聊天右栏过渡实现保留 Task Center、上下文、工作区、浏览器和成果五个横向页签时，必须
单行横向滚动，不能自动隐藏或缩写到不可辨认。Task Center 继续作为 Task 的现有入口；
审批定位到所属 Task、Job 或 Runtime。智能心跳不作为工作栏页签，其报告、建议、历史和完整配置统一归属
“智能心跳”菜单入口。当前阶段不新增独立自动化中心。

### 6.3 工作栏尺寸

- 宽窗口：工作栏停靠右侧，支持键盘和指针调整宽度。
- 中等窗口：可停靠或覆盖主内容，保持用户上次选择。
- 窄窗口：以全屏或接近全屏抽屉显示。
- 终端、宽日志和大型成果允许用户切换到底部停靠或独立窗口。
- 应用只建议适合的布局，不因面板内容自动改变用户已经选择的停靠位置。

## 7. 能力与面板定义

### 7.1 Task Center

Task Center 保留为工作栏中的稳定入口，并在现有基础上适度完善：

- 只索引 Task；每个 Task 与唯一 Conversation 一对一绑定。
- 显示名称、Global 或 Project 范围、状态、最近进展、真实活动时间和需要关注信息。
- 点击 Task 直接打开其 Conversation。
- 完整消息、Job、Run、工具、Subagent、审批和成果分别留在 Task Conversation、Runtime、活动记录和
  成果查看器中，不在窄栏复制。
- 智能心跳的报告、建议、历史和配置不进入任务中心。

任务中心是单例索引，不使用其他能力的“跟随 / 固定目标”多实例模型。后台状态可以更新
徽标和排序，但不能自动打开面板或抢占用户当前工作。

详细产品边界以 [Task Center PRD](../task-and-job/task-center-prd.md) 和
[Task 与 Job 统一领域模型](../task-and-job/task-and-job-model.md) 为准。

### 7.2 监督

监督是通用观察与评论入口，详细行为以
[会话监督 PRD](../supervision/conversation-supervision-prd.md) 为准。

监督能力在目录中稳定可发现；用户打开面板实例后可以选择：

- 普通会话。
- Task 或 Job/Run。
- 实验 Run 或实验整体。
- 后续支持的文档分析和其他可监督对象。

监督面板包含：

- 当前目标与范围。
- 开启状态、监督模式、触发方式和预算。
- 评论、警告、人工复核请求和证据。
- 未解决、已查看、已解决、忽略和误报状态。
- “带入输入框”“查看证据”“追问”“停止当前回复”等用户介入操作。

“采纳”只生成可编辑草稿或显式会话操作，不自动发送、执行、切换 Execute 或批准工具。

### 7.3 Runtime

Runtime 能力统一监督直连模型、OpenCode、Continue、DeepSeek Harness 和后续 Runtime。
能力在目录中稳定可发现，打开的面板实例依据所选 Runtime 的真实能力显示状态。

共同区域：

- Runtime、模型连接、会话或 Run 身份。
- 活动请求、状态、耗时、用量和取消。
- 工具、审批、问题、上下文压缩和错误。
- 跳转完整活动记录和持久设置。

可选区域：

- Subagent 父子关系和取消。
- 后台 Job 队列、进度、结果和终止。
- Todo、Workflow 和 Hook 运行。
- 原生会话、暂停、恢复、压缩或释放。

可选区域不可用时，用一段有操作路径的状态说明替代空卡片。用户可以在面板中切换 Runtime
或目标 Run，不要求先回到聊天 Composer。

### 7.4 终端

终端面板允许用户主动创建和管理本机或 SSH 终端：

- 新建、重命名、切换、关闭和重新连接终端。
- 选择执行空间、工作目录和 Shell。
- 显示本机或远程主机、目录、Shell 和连接状态。
- 支持复制、粘贴、搜索、清屏、滚动和调整终端尺寸。
- 支持将终端切换到右侧、底部或独立窗口。

终端属于用户交互表面。Agent 工具调用可以产生独立受管进程和日志，但不能伪装成用户终端，
也不能在没有明确授权的情况下向现有终端发送按键或命令。

### 7.5 进程

进程面板只展示 GoodBuddy 创建、托管或明确接管的进程：

- 用户终端 Shell。
- Runtime Host、Server、Utility 和远程 Helper。
- Runtime 后台 Job。
- 用户通过工作栏显式启动的长运行命令。
- 浏览器或自动化中属于 GoodBuddy 的受管子进程摘要。

每项显示：

- 名称和有界命令摘要。
- 来源、执行空间、项目或会话归属。
- 启动时间、状态、退出码和资源摘要。
- 有界 stdout/stderr 或结构化日志。
- 正常终止、必要时强制终止和打开关联对象。

Renderer 不接收任意系统 PID 控制能力。控制动作引用 Main 签发的受管进程 ID，并由 Main
重新验证所有权、当前状态和允许操作。

### 7.6 工作区

工作区面板允许用户选择：

- 当前项目目录。
- 其他本机目录。
- 已配置 SSH 主机上的远程目录。

面板提供：

- 有界目录树和文本文件预览。
- 当前选择、规范化路径和执行空间。
- 可选 Git 状态、Diff 和仓库信息。
- 显式打开、下载副本或在终端中打开。
- HTML 文件的源码与安全预览。

本机和远程访问都必须由 Main 或远程 Helper 在对应文件系统上执行路径规范化、相对路径和
符号链接边界检查。Renderer 只能提交受约束的相对路径和已授权范围 ID。

### 7.7 浏览器

浏览器能力在目录中稳定可发现，打开面板后允许用户：

- 创建新的 GoodBuddy 隔离浏览器会话。
- 选择当前会话或其他受控浏览器会话。
- 查看状态、当前 URL、有界画面和错误。
- 进入明确的交互模式或停止会话。

没有浏览器会话时显示“新建浏览器会话”，而不是隐藏能力。模型或后台浏览器活动可以更新
徽标，但不得无条件打开面板或切换用户当前面板。

浏览器面板只管理 GoodBuddy 受控浏览器，不表示可以控制用户已安装的浏览器。

### 7.8 成果

成果面板统一显示全局、项目、Conversation、Task/Job Run 和监督显式产生的独立成果：

- Markdown、纯文本和 JSON。
- 图片和图表。
- HTML 安全预览。
- 后续的 PDF、Office、表格和其他受支持格式。

普通聊天回复只保留在会话消息流中，不自动复制为成果。只有 Runtime 或受管工具显式声明的
Artifact、自动化和监督生成的独立输出，以及用户手动导入或明确保存的内容进入成果面板。
升级前已经自动保存的普通对话 Markdown 可以从成果列表中隐藏，但不应通过升级迁移物理
删除用户数据库内容。

用户可以切换范围、搜索、预览、查看来源、导出或打开关联对象。成果必须保留项目、会话、
Conversation、Run、创建者、MIME、大小、校验值和时间等可用归属。

#### HTML 即时预览

- Runtime 或受管工具通过显式 Artifact 事件声明成果，不能让 Renderer 猜测任意路径。
- Main 验证成果属于当前授权执行空间，限制大小、类型和读取范围后再持久化。
- HTML 使用 `iframe sandbox=""` 和严格 CSP 进行脚本关闭、网络关闭的静态预览。
- 清理脚本、事件属性、嵌套 frame、object、embed、base、link、meta refresh、表单和活动 URL。
- 提供“预览 / 源码”切换，并持续标注“静态安全预览，脚本和网络已禁用”。
- 不使用 `dangerouslySetInnerHTML`，不启用 Electron `webviewTag`。
- 外部打开是明确的用户操作，并说明外部浏览器可能执行脚本或联网。

### 7.9 上下文

上下文面板显示用户已选择或系统准备送入下一次模型请求的内容：

- 附件、图片和文档提取结果。
- 知识库、引用和检索范围。
- 已确认记忆。
- 浏览器、工作区文件和授权目录。
- Runtime、监督或自动化显式绑定的其他上下文。

每项显示来源、范围、大小、发送状态和用途。用户可以预览、移除或清空。固定到历史 Run
时，上下文只读展示不可变快照；跟随当前 Composer 时才允许编辑下一次请求的上下文。

## 8. 范围和选择模型

### 8.1 通用目标引用

各面板实例使用不包含敏感内容的目标引用：

```ts
type WorkbarCapabilityId =
  | 'supervision'
  | 'runtime'
  | 'terminal'
  | 'processes'
  | 'workspace'
  | 'browser'
  | 'results'
  | 'context'

type WorkbarTargetRef =
  | { type: 'conversation'; id: string }
  | { type: 'run'; id: string }
  | { type: 'project'; id: string }
  | { type: 'workspace'; id: string }
  | { type: 'runtime-session'; id: string }
  | { type: 'terminal'; id: string }
  | { type: 'managed-process'; id: string }
  | { type: 'browser-session'; id: string }
  | { type: 'artifact'; id: string }
```

Renderer 选择目标后，Main 必须重新验证对象存在、归属范围和当前用户可见性。不能把目标 ID
直接转换为文件、进程或远程控制权限。

### 8.2 跟随与固定

```ts
type WorkbarScopeBinding =
  | { mode: 'follow'; source: 'active-context' }
  | { mode: 'pinned'; target: WorkbarTargetRef }

type WorkbarPanelInstance = {
  id: string
  capability: WorkbarCapabilityId
  binding: WorkbarScopeBinding
  dock: 'right' | 'bottom' | 'window'
}
```

- 每个面板实例独立保存绑定方式；同一能力的多个实例不能共享可变选择状态。
- 绑定只包含公开 ID，不包含路径、凭据、Token 或日志。
- 删除固定目标后保留失效状态，直到用户选择新目标或恢复跟随。
- 工作栏重新打开、页面切换和窗口重建后恢复用户打开的实例与选择。

## 9. 主机管理与远程执行空间

### 9.1 设置入口

设置中心增加“主机与远程执行”分类，管理：

- 主机名称、地址、端口和用户名。
- 认证方式和凭据配置状态。
- Host Key 算法与 SHA-256 指纹。
- 连接测试、远程系统和架构。
- Helper、Runtime 和能力状态。
- 删除、重新验证或更新 Host Key。

主机配置是全局资源。项目或工作栏只引用主机 ID，不能复制凭据。

### 9.2 凭据和主机验证

- 优先支持系统 SSH Agent 或 OpenSSH 证书。
- 导入私钥或密码时使用 Electron `safeStorage` 加密。
- 凭据绑定主机 ID、地址、端口、用户名和认证类型。
- Renderer 只接收 `credentialConfigured`、来源和错误状态。
- 首次连接展示 Host Key 算法和 SHA-256 指纹，必须由用户显式接受。
- Host Key 变化硬失败，并通过独立高风险流程替换。
- 禁止 `StrictHostKeyChecking=no` 和默认 SSH Agent Forwarding。
- 命令参数、URL、日志、SQLite 和 IPC 中不得出现私钥或密码。

### 9.3 远程 Helper

远程能力通过版本化 GoodBuddy Helper 提供：

- 使用 SSH exec 或受控通道启动，不依赖字符串拼接 Shell 命令。
- 安装到远程用户级受管目录，不要求 root。
- 上传内容使用固定版本、大小和 SHA-256 校验，临时写入后原子替换。
- 握手报告协议版本、系统、架构和能力。
- 在远程执行路径规范化、Git、文件、PTY、进程组和 Runtime 管理。
- 对事件、日志、文件、帧、超时、并发和总传输量设置上限。
- 断开或租约过期后终止孤儿进程。

首期断线后把活动运行标记为 `interrupted`，撤销短期能力并要求用户重试；在事件序列、租约、
重放和幂等附加完成前，不宣称可以无损恢复。

### 9.4 远程 Runtime

- Runtime 在远程执行空间内运行，不能让本机 Runtime 对远程路径进行伪本地操作。
- Main 保持可信控制面，远程 Helper 只接受有范围、有期限的请求。
- Ask 的只读限制在远程 Helper 和 Runtime 适配层共同强制。
- Execute 继续经过 Runtime 工具策略、审批、取消、超时和审计。
- 模型凭据优先留在 Main，通过仅绑定远程回环的 SSH 隧道和请求级代理提供。
- 不向远程 Runtime 暴露通用本机 MCP、浏览器、文件系统或其他未分配能力。

## 10. Runtime 与进程统一生命周期

需要新增统一、受限的生命周期模型：

```ts
type ManagedLifecycleState =
  | 'starting'
  | 'running'
  | 'waiting_approval'
  | 'paused'
  | 'stopping'
  | 'completed'
  | 'failed'
  | 'cancelled'
  | 'interrupted'
```

每个 Runtime 会话、Job、终端或受管进程公开：

- GoodBuddy 受管 ID。
- 类型、来源和父子关系。
- 执行空间和范围。
- 状态、开始与结束时间。
- 支持的控制动作。
- 有界进度、用量和日志游标。

控制动作按能力声明：

```ts
type ManagedControl =
  | 'cancel'
  | 'terminate'
  | 'force-terminate'
  | 'pause'
  | 'resume'
  | 'reconnect'
  | 'release'
```

界面不能因为状态枚举中存在某个动作就假设所有 Runtime 都支持。Main 根据当前受管对象和
能力重新验证动作。

## 11. 数据与契约建议

### 11.1 共享 Zod 契约

建议新增：

- `workbar-contracts.ts`
- `managed-process-contracts.ts`
- `terminal-contracts.ts`
- `remote-host-contracts.ts`
- 通用 Artifact Event 和 Preview 契约
- Runtime Inspector Snapshot 和 Control 契约

所有输入严格限制字符串、数组、日志、帧、路径、端口和事件数量。公开快照不得包含：

- 凭据和认证头。
- 完整环境变量。
- 任意本机或远程绝对路径，除非该路径本身是用户当前可见对象。
- 未经限制的 stdout/stderr、文件或 Runtime 响应。
- 可直接传给系统 kill、spawn、Shell 或 SSH 的自由参数。

### 11.2 持久化

建议增加：

```text
workbar_preferences
remote_hosts
terminal_sessions
managed_processes
runtime_sessions
runtime_jobs
```

其中：

- 工作栏偏好只保存能力目录顺序、面板实例、停靠布局、尺寸和目标引用。
- 主机表只保存非敏感元数据和加密凭据引用。
- 活动终端和进程在应用重启时标记为中断，除非对应远程租约可验证恢复。
- 日志使用有界环形缓冲或分页持久化，不能无限写入 SQLite。
- Artifact 继续作为成果的权威实体，不把完整成果复制进工作栏状态。
- 当前 Renderer `localStorage` 活动记录不能作为 Runtime、监督或进程的权威来源。

### 11.3 IPC 与 Preload

Renderer 只通过显式方法访问：

- 工作栏偏好和目标绑定。
- 主机 CRUD、测试和 Host Key 确认。
- 终端创建、输入、调整大小、关闭和有界输出订阅。
- 受管进程列表、日志和允许的控制动作。
- Runtime Inspector 快照、事件和允许的控制动作。
- 工作区、成果、浏览器、监督和上下文的既有或扩展服务。

每个 Main Handler 都必须验证可信发送者、Zod 输入、对象归属和当前状态。不得暴露 raw
Electron、ChildProcess、PTY、SSH Client、Socket 或文件句柄。

## 12. 安全边界

1. 工作栏能力目录项和面板实例不授予任何能力；权限只由 Main 中的范围和控制契约产生。
2. Ask 在本机和远程 Runtime 边界保持只读。
3. Execute 继续经过现有 Runtime 和审批控制，工作栏不能直接放宽。
4. 用户终端和 Agent 工具执行使用不同身份和事件来源。
5. 进程面板只控制 GoodBuddy 受管对象，不接受任意 PID。
6. 本机和远程路径分别在对应文件系统上 canonicalize 并验证符号链接边界。
7. HTML 默认静态、无脚本、无网络、无 Electron API。
8. Supervisor 不接收授权回调，不能批准工具或替用户发送消息。
9. SSH Host Key 必须固定，凭据保留在 Main 加密存储。
10. 远程端只获得请求级、可撤销、最小范围能力。
11. 关闭面板或切换目标、主机或 Runtime 时，旧订阅必须取消；其他固定实例的订阅明确保留。
12. 通知、徽标和日志不得包含密钥、私人正文或未脱敏提供商响应。

## 13. 状态、错误和恢复

每个面板实例区分：

- 尚未选择目标。
- 目标为空。
- 正在连接或加载。
- 正常可用。
- 部分可用。
- 当前能力不支持。
- 连接失败。
- 权限不足或只读。
- 目标已失效。
- 操作已取消或中断。

错误必须保留用户选择、终端缓冲、输入草稿、范围和可重试上下文。短期成功和非局部错误使用
应用通知；预览失败、终端断线、Host Key 变化、监督证据失效等需要本地恢复的错误留在面板
内。同一事件不得同时重复显示为面板警告和应用通知。

## 14. 性能与资源边界

- 工作栏关闭或面板实例关闭时停止对应非必要画面和高频日志推送，但保留 Main 中的受管运行。
- 每个打开的面板实例只订阅其跟随或固定目标，不进行全局无界监听。
- 终端和日志使用增量序号、环形缓冲和背压。
- HTML、文件、目录、浏览器画面和远程传输沿用或收紧现有大小限制。
- Runtime Snapshot 与事件流分离，重新打开时先取权威快照，再接增量事件。
- 监督使用独立低优先级并发池和预算，不延迟前台回答。
- 应用退出时停止新操作，取消订阅，关闭终端、隧道和 Helper，并在期限内标记未完成对象。

## 15. 无障碍与响应式

- 能力目录、所有面板实例、目标选择器、终端控制和进程操作可用键盘完成。
- 能力目录与面板标题具有稳定可访问名称，徽标不是唯一状态信号。
- 终端需要独立可访问说明，并允许关闭动画和声音提示。
- 进程和 Runtime 高频日志不逐行进入实时区域，只播报重要状态变化。
- 监督证据定位后将焦点移动到对应对象，并提供返回监督记录的方式。
- HTML iframe 有明确标题、静态安全说明和源码替代视图。
- 窄窗口下能力目录仍完整可达，不因空间不足隐藏能力。
- 文字缩放到 200% 时，当前目标、执行空间、风险状态和停止操作不能被裁切。

## 16. 分阶段实施

### 阶段 0：应用级工作栏壳层

- 将当前聊天专属右栏提升为应用级壳层。
- 建立稳定能力目录和用户打开、关闭、排序、停靠的面板实例模型。
- 建立实例级跟随、固定和失效目标语义。
- 保留现有任务中心、上下文、工作区、浏览器和成果行为。
- 将 Task Center 明确为 Task 的单例索引，并补齐范围、状态、最近进展、需要关注和直接打开 Conversation。
- 审批在所属任务或 Runtime 中持续可见，不新增独立审批面板。
- 智能心跳菜单入口承接完整配置和范围后，再从任务中心移除重复表单；不得移除任务中心本身。

### 阶段 1：成果与 Runtime 可观测性

- 通用 Artifact Event。
- HTML 工作区和成果的静态即时预览。
- Runtime Inspector Snapshot 与事件。
- OpenCode 会话、子会话、Todo、工具、用量和取消。
- 直连模型及现有 GoodBuddy Subagent 的统一展示。

### 阶段 2：监督、终端与受管进程

- 普通会话手动监督和右栏评论流。
- 本机 PTY 终端。
- 受管进程注册、日志和终止。
- 自动回复后监督、节流和独立预算。
- 用户选择终端停靠位置。

### 阶段 3：Runtime 原生长期能力

- Continue 会话级 Host。
- Continue Background Job、Subagent 和 Hook 的有界适配。
- DeepSeek Harness 后续服务的能力握手。
- Runtime Job、Workflow 和会话恢复契约。

### 阶段 4：SSH 主机与远程执行空间

- 主机管理、加密凭据和 Host Key 固定。
- Linux x64/arm64 Helper 安装与握手。
- 远程工作区、Git、终端和受管进程。
- 远程 Runtime 执行、取消、超时和审计。
- 首期断线明确标记中断，不承诺恢复。

### 阶段 5：恢复与扩展

- 远程租约、事件重放和幂等重连。
- 更多远程系统和架构。
- PDF、Office 和数据成果预览。
- Conversation、Task/Job Run 和实验的完整监督。
- 用户可导入导出工作栏布局和主机非敏感配置。

## 17. 验收标准

### 17.1 稳定能力目录与用户控制

- [ ] 九个标准能力在所有主要页面的目录中始终可发现，但不会默认同时打开。
- [ ] Task Center 继续作为 Task 的单例索引，不删除入口、不复制会话，也不混入 Job、Run 或心跳事项。
- [ ] 项目、会话、Runtime 或主机变化不会无提示地增删能力目录项。
- [ ] 用户可以按需打开、关闭、排序和停靠面板实例。
- [ ] 用户可以独立设置每个可绑定目标的面板实例跟随或固定目标，并为同一能力打开多个目标实例。
- [ ] 固定目标失效后显示修复状态，不静默切换。
- [ ] 后台事件不会无条件打开面板或抢占用户当前实例。
- [ ] 用户可一键恢复标准能力目录和默认的少量打开面板。

### 17.2 通用使用

- [ ] 没有项目时仍可创建终端、选择工作区、打开浏览器和查看成果。
- [ ] 监督可以作用于普通 Conversation、Task、Job/Run 和后续实验对象，不假设编程语境。
- [ ] 工作区不是 Git 仓库时仍可浏览文件。
- [ ] Runtime 不支持某项原生能力时仍可从目录打开面板并获得准确说明。

### 17.3 安全与控制

- [ ] Renderer 没有任意文件、Shell、进程、PTY、SSH 或 Electron API。
- [ ] Agent 不能未经授权向用户终端注入命令。
- [ ] 进程面板不能枚举或终止任意系统进程。
- [ ] Ask 在本机和远程执行空间均无法调用写入或外部副作用工具。
- [ ] HTML 预览无法执行脚本、联网、打开窗口、提交表单或访问 Electron API。
- [ ] Supervisor 不能自动发送消息、批准工具、切换工作模式或扩大范围。
- [ ] SSH 首次连接和 Host Key 变化均经过明确验证流程。
- [ ] 凭据不进入 Renderer、日志、SQLite 明文或命令参数。

### 17.4 生命周期与恢复

- [ ] Runtime、终端、Job 和进程具有权威 Main 快照和有序增量事件。
- [ ] 取消、终止、失败、断线和应用退出都有确定终态。
- [ ] 切换跟随目标后不显示上一对象的过期状态。
- [ ] 固定目标的订阅在页面切换后保持，关闭时正确释放。
- [ ] 日志、终端、文件、成果和远程传输均有明确上限和背压。

### 17.5 可用性

- [ ] 宽、中、窄窗口均可访问完整能力目录和用户打开的面板实例。
- [ ] 仅使用键盘可以选择能力、面板实例、目标、执行空间和控制动作。
- [ ] 状态不只依赖颜色，徽标具有文字或可访问名称。
- [ ] 终端、HTML、监督证据和高频日志具有可访问替代或降噪行为。

## 18. 相关文档的职责

- 本文是助手工作栏稳定能力目录、用户面板实例、范围控制和执行空间的产品总契约。
- [Task 与 Job 统一领域模型](../task-and-job/task-and-job-model.md) 定义 Task、Conversation、
  Job、Subjob、Run 与 Subagent。
- [Task Center PRD](../task-and-job/task-center-prd.md) 定义应用级 Task 索引。
- [智能心跳 PRD](../smart-heartbeat/smart-heartbeat-prd.md) 定义心跳入口、范围和长期边界。
- [会话监督 PRD](../supervision/conversation-supervision-prd.md) 定义监督判断、证据、预算和介入边界。
- [自动化平台总体设计](../../architecture/automation-platform-architecture.md) 定义 Plan、Job、Run、监督、预算和记忆。
- [长期助手路线图](../../roadmap/long-term-assistant-roadmap.md) 记录整体长期能力与实施背景。
- [DeepSeek Harness Runtime 设计](../../architecture/deepseek-harness-runtime-design.md) 定义该 Runtime 的具体适配边界。
- [统一界面设计系统](../../../UI-DESIGN.md) 定义视觉、语义、响应式和无障碍规则。

若其他文档把工作栏描述为九个同时固定显示的栏目、根据项目或 Runtime 自动裁剪的动态入口，
或仅属于当前聊天的附属区域，以本文“能力目录稳定、面板实例由用户打开、当前上下文只提供
默认值”的产品决策为准。