goodbuddy/docs/features/application-tool-navigation/prd.md

应用导航与系统工具入口 PRD

文档信息

项目	内容
状态	设计中
版本	0.2
日期	2026-09-08
适用产品	GoodBuddy 桌面端
关联设计	统一界面设计系统、助手工作栏 PRD

1. 背景

计划修订说明：当前实施范围以第 8 节为准。本文其余章节仍包含 v0.2 的 左下角系统工具方案；启动实现前须同步功能要求、验收及配套设计，旧快捷工具条不再列入实施。

主侧栏当前把“当前对话”“魔法笔记”“知识库”“智能心跳”和“运行记录”放在同一导航组， 底部长期显示“GB 本地工作区”和平台架构。底部信息不能反映用户可以执行的操作，文件、终端 和浏览器则需要先找到右侧助手工作栏后才能打开。

后续插件可能提供完整页面，也可能只提供辅助面板或命令。若不先区分系统入口、应用和工具， 插件接入后会同时争用主导航、侧栏底部和助手工作栏，用户也无法判断入口会切换页面还是打开 辅助面板。

2. 产品定义

2.1 三类入口

类型	首期成员	默认位置	用户控制范围
系统入口	当前对话、运行记录、设置	主导航固定位置或侧栏底部	不可隐藏、卸载或改变类型
应用	魔法笔记、知识库、智能心跳	主导航应用区	可控制是否显示；隐藏不删除数据
系统工具	文件浏览器、终端、浏览器、资源监控	侧栏底部快捷工具栏	首期固定提供，不可卸载

运行记录是系统审计页面，不属于工具。文件浏览器、终端、浏览器和资源监控是系统工具；它们 的快捷入口位于左下角，实际界面继续由右侧助手工作栏承载。

2.2 后续插件类型

插件市场开放后，插件可以贡献“插件应用”或“插件工具”。插件不能注册、覆盖或替换系统入口， 也不能冒充系统工具。内置应用继续标记为“内置”，不因采用统一注册协议而显示成待安装商品。

3. 目标

• 用户从侧栏底部一次点击即可打开文件、终端、浏览器或资源监控。
• 主导航只承载完整页面，辅助工具不占用一级页面位置。
• 运行记录始终可发现，不受应用显示设置和插件状态影响。
• 内置应用可以从一个设置位置控制主导航可见性，隐藏后仍可恢复。
• 为插件应用和插件工具保留明确的入口契约，不提前建设插件安装能力。

4. 非目标

• 首期不提供应用商店页面、商店导航、推荐位或安装按钮，也不提供第三方插件搜索、下载、 安装、更新、签名验证或卸载。内置应用的浏览、搜索与打开属于应用中心，不依赖商店。
• 不把文件树、终端或浏览器重新实现到左侧栏。
• 不改变助手工作栏的面板实例、停靠、执行空间和安全边界。
• 不允许隐藏运行记录、当前对话或设置。
• 不因隐藏应用而删除魔法笔记、知识库或智能心跳数据。
• 不把“显示在侧边栏”解释为停止智能心跳计划或后台任务。
• 不提供任意本机程序启动器。
• 首期资源监控不采集远程主机、GPU、显存或网络吞吐，不提供后台告警和历史持久化。

5. 功能要求

FR-1 入口分类

系统必须为每个可见入口声明稳定类型：system-entry、application 或 system-tool。界面位置、 设置项和点击结果均以该类型为准，不根据当前页面临时改变类型。

FR-2 固定系统入口

“当前对话”固定在主导航首位；“运行记录”固定在应用区之后；“设置”固定在侧栏底部。 这些入口不出现在应用显隐、工具固定或插件管理设置中。

FR-3 内置应用区

魔法笔记、知识库和智能心跳显示在当前对话与运行记录之间。应用入口打开对应一级页面，保留 现有徽标、范围和页面状态。用户可以在设置中控制其主导航可见性。

FR-4 隐藏应用

隐藏应用只移除主导航入口，不删除数据、不修改业务启停状态，也不终止正在进行的操作。显隐 Switch 更新成功后主导航立即生效；更新失败时恢复原状态并允许重试。用户可从设置恢复入口。

FR-5 系统工具快捷栏

侧栏底部提供文件浏览器、终端、浏览器和资源监控四个图标按钮，并保留独立设置按钮。每个 按钮具有可见工具提示和可访问名称。首期系统工具顺序固定为文件、终端、浏览器、资源监控。

FR-6 文件浏览器入口

点击文件按钮时展开助手工作栏，并聚焦默认存在且不可关闭的“工作区”单实例。该实例保持 “跟随当前上下文”或“固定到指定对象”状态；迁移或布局修复发现实例缺失时补回，并默认跟随 当前项目。没有项目时使用已配置的默认工作区。跟随上下文所需的路径不可用时，面板显示修复 入口；已有有效固定目标不受当前项目和默认工作区状态影响。

FR-7 终端入口

点击终端按钮时展开助手工作栏。当前执行空间有正在启动或运行中的终端时聚焦最近使用的实例； 没有时创建一个绑定当前执行空间的新终端，已退出、已中断或失败的历史 Tab 保持不变。没有 项目时当前执行空间为本机 Home。创建额外并行终端继续使用工作栏现有的“+”目录入口。

FR-8 浏览器入口

点击浏览器按钮时展开助手工作栏，并优先聚焦绑定当前 Conversation 的最近使用浏览器实例； 没有匹配实例时创建一个。没有活动 Conversation 时聚焦最近使用的浏览器实例；完全不存在时 创建待绑定空实例。该快捷入口不会因连续点击创建重复实例；用户通过工作栏“+”选择浏览器时 则始终创建新实例。入口不打开系统默认浏览器，也不创建旁路 WebView。

FR-9 资源监控入口

点击资源监控按钮时展开助手工作栏，并打开或聚焦单实例的本机“资源监控”面板。面板显示 整机 CPU 使用率、内存使用量与总量、磁盘读写速率，以及 GoodBuddy 桌面进程的 CPU、内存 和进程数摘要。指标不可用时显示具体项目和原因，不能显示为 0。

资源面板处于可见活动状态、工作栏已展开且应用窗口未隐藏或最小化时，每 2 秒采样一次，在 Renderer 内存中最多保留最近 5 分钟。任一条件不满足时停止采样；首期不在后台持续监控， 也不据此产生侧栏告警。首次采样及停止后恢复的首次采样只建立 CPU 和磁盘 IO 速率基线， 不显示伪造的 0 值。

FR-10 快捷入口状态

工具面板已激活时，对应按钮显示选中状态；面板存在但未激活时保持普通状态。运行中、错误或 等待用户处理可以显示徽标，但必须有可访问文字，且不得自动抢占当前面板。

FR-11 应用导航设置

设置页提供“应用与工具”管理入口。首期“应用”区域列出三个内置应用并提供“显示在侧边栏” Switch，切换后立即持久化。系统工具区域列出四项内置固定能力，不提供虚假的卸载或停用按钮。

FR-12 偏好持久化

应用可见性按设备持久化。升级时保留当前行为：已有可用内置应用继续显示；魔法笔记原有功能 启停设置保持原意，不由新的导航可见性覆盖。

FR-13 窄窗口行为

窄窗口下主侧栏仍按现有抽屉方式显示。系统工具按钮保持单行且不与设置按钮重叠；空间不足时 收起文字和非必要分隔，不隐藏四个系统工具或设置。

FR-14 项目活动汇总

用户在任一项目中都能查看跨项目的运行中与待处理会话，并从活动列表直接进入所选会话。 汇总入口仅在有运行中或待处理会话时显示在项目选择器下方，无活动时整行隐藏。点击后先显示有活动会话的项目， 悬停或点击项目展开会话子菜单，点击会话进入该条对话。项目菜单保留原有分组与顺序，并显示 各项目的活动数量；级联菜单内的项目顺序不随待处理或运行中数量变化。 汇总不受当前项目、搜索条件或最近历史条数限制。计数与排除规则见 活动逻辑，交互见活动界面。

验收覆盖跨项目后台运行、同会话多任务去重、提问与审批优先、较早的仍在运行或等待处理的 会话可见，以及从带搜索条件的页面或有未保存修改的设置页跳转。结束后仅有未读标记的 会话不保留在活动汇总中；已完成未读面板不属于本项交付。

6. 权限与安全

• 快捷入口不授予新的文件、命令、网络或浏览器权限。
• 系统工具继续使用 Main、Preload、执行空间 Grant、Ask/Execute 和现有审批边界。
• Renderer 不因新增入口获得任意文件系统、PTY、进程或 Electron API。
• 资源指标由 Main 采集并以有界结构返回；Renderer 不接收进程命令行、环境变量或任意 PID。
• 资源样本只保存在当前 Renderer 内存中，不写入运行记录、SQLite 或遥测服务。
• 插件贡献类型只是界面与导航声明，不能代替权限清单、用户授权和运行隔离。
• 运行记录继续记录由系统工具触发的受审计操作。

7. 产品验收

• 主导航能明确区分固定系统入口和可配置内置应用。
• 运行记录在所有应用显隐组合下保持可见并可打开。
• 左下角不再用“本地工作区”与系统架构占据主要空间。
• 文件、终端、浏览器和资源监控均可从左下角打开正确的工作栏面板，且不产生第二套内容界面。
• 连续点击系统工具不会无意创建重复的浏览器或终端实例；工作区始终复用不可关闭的固定实例。 用户通过工作栏“+”可以显式创建额外浏览器或终端实例。
• 资源监控以 2 秒间隔更新，保留不超过 150 个样本；面板不活动、工作栏收起或窗口隐藏、 最小化后停止请求新样本。
• CPU、内存、磁盘 IO 或 GoodBuddy 指标不可用时，页面区分部分可用与整体失败。
• 隐藏内置应用不删除数据、不停止后台计划，并能从设置恢复；保存失败时入口保持原状。
• 键盘、屏幕阅读器、浅色主题、深色主题和窄窗口均可完成相同操作。

8. 分期

首期

• 将侧栏最底部改为内置应用中心入口，设置按钮保持独立；具体列表、宫格或卡片样式从 Demo 中收敛确定。
• 应用中心提供魔法笔记、知识库、智能心跳的浏览、搜索与打开，不要求安装。
• 支持应用常驻主导航、取消常驻和排序；未常驻应用仍可从应用中心打开，隐藏不删除数据或停止后台任务。
• 应用中心和应用页面就近提供已有功能设置，共享真实设置来源；已有全局设置入口定位到同一界面。 魔法笔记优先接入待办数量、AI 评论方式和评论形式，入口显示与常驻控制统一，避免重复开关。
• 文件、终端、浏览器保留在右侧工作栏 Tab，不在左下角复制入口，也不纳入应用中心。
• 原计划的本机资源监控仍作为系统工具交付项，在右侧增加单实例面板；与应用中心分别实现和验证。
• 保持运行记录为固定系统入口。

首期验收需覆盖：无商店入口时可以访问全部内置应用；取消常驻后仍可重新打开和配置； 不同设置入口状态一致；常驻排序重启后保留；右侧工具切换不改变当前应用页面。 本节是范围调整，Demo 交互通过不代表正式功能已经实现。

补充要求：魔法笔记迁移与入口联动

• 将现有魔法笔记设置迁入应用中心的应用设置界面，笔记页面内的设置入口访问同一份配置。 魔法笔记可常驻主导航；原全局设置位置如保留入口，应定位到共同设置界面。
• 魔法笔记相关布尔开关默认全部开启，包括入口显示（常驻）和未完成待办数量显示。 AI 评论方式、评论形式是单选项，沿用现有默认值，不把“全部开启”解释为同时选中多个模式。 新默认值适用于未配置状态，迁移时保留用户已明确保存的选择。
• 应用关闭后的入口联动必须覆盖主导航和会话页面，不能只更新应用中心卡片或一个菜单。 知识库关闭后，左侧知识库菜单及会话中的知识库入口按钮同步移除；重新开启后按配置恢复。
• “取消常驻”只移除主导航捷径；“关闭应用”移除该应用在主导航、会话等业务界面的入口。 应用中心保留管理和重新开启入口。原型中仅有常驻控制，正式设计需补齐这两种状态，避免混用。
• 入口变化不删除已有笔记或知识数据。知识库已打开页面、会话已关联知识以及后台任务的处理， 在详细逻辑同步时分别定义，不能仅凭隐藏按钮推断功能或后台行为已经停用。

补充验收：从任一配置入口关闭知识库，主导航和当前会话按钮立即同步移除，切换会话、 重启后也不重新出现；重新开启后恢复相应入口。验证魔法笔记未配置时的默认开启，以及 已有关闭选择在迁移后保留。设置保存失败时各入口保持原状态，不能出现互相矛盾的显示。

后续：应用商店与扩展

• 单独设计应用商店的目录、搜索、推荐、详情及安装管理，时间与具体范围另行确定。
• 插件应用和插件工具注册，以及安装、更新、卸载与权限说明。
• 插件应用可常驻主导航；插件工具按工作栏扩展设计接入，不恢复左下角重复系统工具条。
• 用户级快捷键与命令面板接入同一贡献命令。

现有 Demo 的商店页、项目管理和阅读空间安装流程仅保留为未来交互参考，不纳入首期验收， 也不作为已有商店能力的说明。首期实现不预建插件安装服务或远程目录协议。