docs: design application and system tool navigation

2026-09-08 12:35:00 +08:00
parent 25e897c22b
commit 451b30d434
9 changed files with 323 additions and 67 deletions
@@ -5,13 +5,14 @@
 | 项目 | 内容 |
 | --- | --- |
 | 状态 | 设计中 |
-| 版本 | 0.1 |
+| 版本 | 0.2 |
 | 日期 | 2026-09-08 |
 | 关联 PRD | [应用导航与系统工具入口 PRD](./prd.md) |
 | 功能逻辑 | [功能逻辑设计](./logic-design.md) |
 | 全局规范 | [GoodBuddy 统一界面设计系统](../../../UI-DESIGN.md) |

-本文只定义入口和设置界面。文件、终端、浏览器的内容布局继续遵守助手工作栏文档。
+本文定义入口、设置和轻量资源监控界面。文件、终端和浏览器的内容布局继续遵守助手工作栏
+文档。

 ## 1. 侧栏信息架构

@@ -31,7 +32,7 @@
 ...

 ────────────────────────
-[文件] [终端] [浏览器]             [设置]
+[文件] [终端] [浏览器] [资源]      [设置]
 ```

 “当前对话”和“运行记录”属于固定系统入口。三个内置应用位于二者之间。侧栏底部不再显示
@@ -46,6 +47,7 @@
 | 1 | `FolderOpen` | 文件 | 打开或聚焦工作区面板 |
 | 2 | `SquareTerminal` | 终端 | 打开或聚焦当前执行空间终端 |
 | 3 | `Globe` | 浏览器 | 打开或聚焦受控浏览器面板 |
+| 4 | `Activity` | 资源监控 | 打开或聚焦本机资源监控面板 |
 | 末位 | `Settings` | 设置 | 打开设置页面 |

 图标使用项目现有 Lucide 库。每个按钮采用统一的 `34px × 34px` 点击区域，内部图标建议
@@ -96,6 +98,7 @@
 文件           打开当前工作区                   内置
 终端           进入当前执行空间                 内置
 浏览器         打开 GoodBuddy 受控浏览器         内置
+资源监控       查看本机 CPU、内存和磁盘 IO       内置

 系统入口
 当前对话、运行记录和设置位置固定，不参与上述配置。
@@ -119,10 +122,43 @@
 - 文件：激活“工作区”Tab，焦点进入目录区域或错误修复入口。
 - 终端：激活匹配终端，焦点进入终端输入区；新建期间保留按钮宽度和进度状态。
 - 浏览器：激活“浏览器”Tab，焦点进入工具栏；没有会话时进入空状态主操作。
+- 资源监控：激活“资源监控”Tab，焦点进入指标摘要；首个样本加载后开始绘制历史。

 后台事件可以更新徽标，不能自动展开工作栏或切换当前 Tab。由用户点击快捷按钮触发的打开
 属于显式操作，可以展开工作栏并切换 Tab。

+### 5.1 资源监控面板
+
+资源监控使用紧凑单列，不使用指标卡片墙：
+
+```text
+资源监控                                      本机
+
+CPU                                  18%
+[最近 5 分钟折线图]
+
+内存                         9.6 / 32 GB
+[使用量进度条]
+
+磁盘 IO                 读 12 MB/s · 写 3 MB/s
+
+GoodBuddy
+CPU 4% · 内存 620 MB · 桌面进程 7
+
+更新于 14:32:08
+```
+
+- CPU 折线纵轴固定为 `0%` 至 `100%`，不能根据当前低负载动态放大波动。
+- 内存同时显示使用量、总量和百分比；进度条不代替文字数值。
+- 磁盘 IO 使用每秒读写字节并按统一单位格式化，不显示累计设备字节数。
+- GoodBuddy 摘要只显示聚合值，不列 PID、命令行或环境变量。
+- 首次加载或停止后恢复时，CPU 和磁盘 IO 显示“正在建立采样基线”，不先渲染 `0%`；内存
+  等瞬时指标可以立即显示。
+- 部分可用时只在对应指标行显示“不可用”和简短原因；全部失败时显示重试入口。
+- 图表不使用动效平移；`prefers-reduced-motion` 下行为不变。
+- 面板失去活动状态、工作栏收起或窗口隐藏、最小化时停止更新；返回后重新建立区间指标基线，
+  不填补离开期间的历史。
+
 ## 6. 文案

 固定使用以下名称：
@@ -134,6 +170,9 @@
 | 终端系统工具 | 终端 |
 | 浏览器系统工具 | 浏览器 |
 | 浏览器说明 | GoodBuddy 受控浏览器 |
+| 资源系统工具 | 资源监控 |
+| 资源范围 | 本机 |
+| 指标缺失 | 不可用 |
 | 应用显隐开关 | 显示在侧边栏 |
 | 内置来源 | 内置 |

@@ -143,7 +182,7 @@
 ## 7. 键盘和无障碍

 - 底部按钮均为独立 `button`，不能嵌套在整行设置按钮中。
- Tab 顺序为文件、终端、浏览器、设置。
+- Tab 顺序为文件、终端、浏览器、资源监控、设置。
 - 图标按钮通过 `aria-label` 提供名称，工具提示不能作为唯一可访问名称。
 - 工作栏打开后按现有焦点策略聚焦目标面板；用户通过固定工作栏开关关闭时，焦点返回该开关。
 - 选中按钮使用 `aria-pressed` 或等价的可访问状态，不能只依靠背景色。
@@ -154,11 +193,11 @@

 - 侧栏宽度 `220px` 至 `420px` 时，底部按钮尺寸不随宽度缩放。
 - 窄窗口继续使用现有侧栏抽屉；工具栏不转为多行。
- 空间不足时缩小设置按钮前的弹性空白，不隐藏三个系统工具和设置。
+- 空间不足时缩小设置按钮前的弹性空白，不隐藏四个系统工具和设置。
 - 工具提示不得超出窗口；靠近底边时显示在按钮上方。
 - 粗指针设备不依赖悬停，按钮的可访问名称和选中反馈保持有效。

 ## 9. 未来插件入口

-插件市场交付后另行定义插件区域、固定数量、溢出和权限界面。系统入口与三个系统工具的位置
+插件市场交付后另行定义插件区域、固定数量、溢出和权限界面。系统入口与四个系统工具的位置
 保持保留，不向插件开放。