root/goodbuddy
1
0
Fork 0
Code Issues Pull Requests Actions 3 Packages Projects Releases Wiki Activity

feat: add app management, local inference controls, and task statistics

Browse Source
This commit is contained in:
mesalogo
2026-09-18 08:20:45 +08:00
parent 6dd6297414
commit bbae893c45
103 changed files with 7962 additions and 1490 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/features/application-tool-navigation/ui-design.md
+126 -72
View File
@@ -4,15 +4,16 @@
| 项目 | 内容 |
| --- | --- |
| 状态 | 设计中 |
| 版本 | 0.2 |
| 日期 | 2026-09-08 |
| 状态 | 应用中心与本机推理已接入源码，整体验收待完成 |
| 版本 | 0.4 |
| 日期 | 2026-09-17 |
| 关联 PRD | [应用导航与系统工具入口 PRD](./prd.md) |
| 功能逻辑 | [功能逻辑设计](./logic-design.md) |
| 全局规范 | [GoodBuddy 统一界面设计系统](../../../UI-DESIGN.md) |
本文定义入口、设置和轻量资源监控界面。文件、终端和浏览器的内容布局继续遵守助手工作栏
文档。
本文定义已接入的应用中心、共同设置和本机推理界面，以及待实现的右侧资源监控界面。
行为以[功能逻辑](./logic-design.md)为准，需求保留 FR-1 至 FR-16 与既有 US 编号。
根 UI 规范已同步应用中心与工具入口规则；共享控件、主题、设置 Modal 与工作栏布局遵守根规范。
## 1. 侧栏信息架构
@@ -24,110 +25,134 @@
搜索
当前对话
魔法笔记 3
知识库
智能心跳 1
知识库（固定显示）
智能心跳（固定显示，保留建议徽标）
可选应用（魔法笔记、本机推理，按保存顺序，仅显示启用且常驻项）
运行记录
最近对话
...
────────────────────────
[文件] [终端] [浏览器] [资源] [设置]
[应用中心] [设置]
```
“当前对话”和“运行记录”属于固定系统入口。三个内置应用位于二者之间。侧栏底部不再显示
“本地工作区”和 `platform · arch`；排障信息移至关于或诊断页面。
“当前对话”和“运行记录”属于固定系统入口，常驻应用位于二者之间。首期应用清单为魔法笔记、
知识库、智能心跳及本轮追加的本机推理，应用中心与设置始终可见。侧栏底部不再显示“本地工作区”和 `platform · arch`；
排障信息移至关于或诊断页面。左侧不再提供文件、终端、浏览器、资源监控的重复入口。
## 2. 底部系统工具栏
## 2. 底部应用中心入口
底部使用连续平整表面和顶部分隔线，不做成账户卡片或嵌套卡片。按钮顺序固定：
底部使用连续平整表面和顶部分隔线，应用中心在前，固定设置靠右，二者为独立按钮：
| 位置 | 图标 | 可见工具提示 | 点击结果 |
| --- | --- | --- | --- |
| 1 | `FolderOpen` | 文件 | 聚焦不可关闭的工作区面板 |
| 2 | `SquareTerminal` | 终端 | 打开或聚焦当前执行空间终端 |
| 3 | `Globe` | 浏览器 | 聚焦当前 Conversation 的匹配浏览器实例 |
| 4 | `Activity` | 资源监控 | 打开或聚焦本机资源监控面板 |
| 1 | `Grid2X2` | 应用中心 | 向上展开已启用应用菜单，底部“管理应用”进入管理 Modal |
| 末位 | `Settings` | 设置 | 在当前工作区上打开设置 Modal |
图标使用项目现有 Lucide 库。每个按钮采用统一的 `34px × 34px` 点击区域，内部图标建议
`16px`。工具栏使用 `8px` 内边距和 `4px` 间隔；设置按钮通过自动空白靠右，不添加第二条
视觉分隔线。
图标使用项目现有 Lucide 库。应用中心保留文字，设置图标采用统一的 `34px × 34px` 点击区域。
底部使用共享间距和焦点样式，设置通过弹性空白靠右；不得把整个容器做成设置按钮。
### 2.1 状态
- 默认：透明背景，图标使用次级文字色。
- 悬停：使用弱表面色，不能强于当前选中状态。
- 选中：使用强调选中背景，并提高图标对比度。
- 展开：应用中心按钮显示展开反馈，不能当作当前应用的选中状态。
- 键盘焦点：显示统一焦点环，不能被侧栏边缘裁切。
- 处理中：创建或激活请求未完成时暂时禁用对应按钮，保留尺寸并提供进行中名称。
- 徽标：只用于等待处理、错误或活动状态，不显示无意义的常驻绿色圆点。
- 加载：读取应用配置时保留入口，中心内显示加载状态；失败提供重试，不用默认值冒充已保存配置。
选中状态表达“对应工作栏面板正在显示”，不表达功能已安装或权限已授予。
应用中心入口不承载工具运行徽标。全部可选应用关闭时菜单仍显示知识库、智能心跳及“管理应用”，可进入 Modal 重新开启可选应用。
## 3. 主导航应用区
应用入口沿用现有 `nav-item` 行，不使用应用卡片。图标、名称和徽标保持单行：
```text
[图标] 魔法笔记 3
[图标] 知识库
[图标] 智能心跳 1
[图标] 魔法笔记 3
[图标] 本机推理
```
隐藏某个应用后，其余应用向上补位。运行记录始终位于最后一个可见应用之后，不因应用显隐
改变样式或归类为工具。
取消常驻或关闭可选应用后不留下空白。知识库、智能心跳固定在当前对话之后，始终启用并显示，不受可选顺序影响。运行记录始终位于应用区之后。
编辑常驻顺序提供拖动及“上移”“下移”按钮，首尾无可移动目标时禁用对应按钮；两种方式
提交相同可选应用顺序。知识库、智能心跳及固定系统入口不参与拖动，也不作为排序目标。保存成功后更新，重启保留。
设置页打开期间，主侧栏显示最后一次成功保存的导航状态。Switch 更新成功后导航立即变化，
失败时保持原导航。
取消常驻不关闭当前页面或本机推理 Modal。重新常驻按已保存顺序恢复，关闭应用保留常驻与顺序偏好。
主侧栏始终读取最后确认配置，不展示尚未保存成功的排序或开关目标值。
## 4. 应用与工具设置
## 4. 应用中心与共同设置
设置中心新增“应用与工具”分类，位于设置 Modal 的右侧内容区；容器与键盘规则遵守 [设置中心 UI 规范](../../../UI-DESIGN.md#138-设置中心)：
底部点击打开轻量菜单，锚定按钮向上展开，无模态遮罩、背景隔离或焦点循环。菜单依次列知识库、智能心跳和按保存顺序排列的已启用可选应用；不按打开历史或常驻状态过滤。点击应用行关闭菜单，本机推理打开独立 Modal，知识库、智能心跳和魔法笔记在主内容区打开页面。分隔线下的“管理应用”关闭菜单并打开既有管理 Modal。
菜单通过共享 `AnchoredMenu` 挂载到 body，宽度最多 `280px`，距窗口边缘至少 `16px`，与按钮上缘间隔 `8px`；短窗口限制高度并内部滚动，滚动、窗口和内容尺寸变化时重算位置。原生浏览器相交遮挡复用共享机制。
管理 Modal 沿用设置 Modal 的表面、遮罩和焦点规则，提供全部内置应用的名称及用途搜索、打开，以及可选应用的常驻和设置：
应用管理采用桌面双列卡片，窗口宽度不超过 `720px` 时改为单列。Modal 最大宽度 `960px`，
高度随内容增长并受窗口限制。卡片显示图标、名称、状态和用途，底部放置操作；名称旁区分
“固定入口”和“可选 · 已启用／已关闭”。长名称可换行，正文与控件均不可横向溢出。
```text
应用与工具
管理主导航中的应用。系统工具由 GoodBuddy 提供并固定在侧栏底部。
应用
魔法笔记 笔记、待办和评论 [显示在侧边栏 开]
知识库 管理和检索知识 [显示在侧边栏 开]
智能心跳 查看计划、建议和运行历史 [显示在侧边栏 开]
系统工具
文件 打开当前工作区 内置
终端 进入当前执行空间 内置
浏览器 打开 GoodBuddy 受控浏览器 内置
资源监控 查看本机 CPU、内存和磁盘 IO 内置
系统入口
当前对话、运行记录和设置位置固定，不参与上述配置。
应用中心
[搜索内置应用]
知识库 固定入口 [打开]
智能心跳 固定入口 [打开]
魔法笔记 可选 · 已启用 [打开] [设置]
本机推理 可选 · 已启用 [打开] [设置]
```
应用显隐使用共享 Switch，标签必须是“显示在侧边栏”，不能缩写为“启用”。切换时立即保存，
请求期间禁用三个应用显隐 Switch；失败后恢复原值，并在对应设置行显示可重试错误。系统工具
使用紧凑只读列表，不渲染禁用的卸载、停用或固定按钮。
已启用但未常驻的应用可以直接打开，打开不自动常驻。关闭的应用仍能被搜索和配置，
保留禁用的“打开”按钮，可通过“设置”重新开启。启用、常驻及上下移动放在设置详情中；无搜索词且未锁定修改时，可选卡片仍支持拖动排序。无搜索结果显示清除搜索入口。
首期不展示商店页签、推荐、安装按钮、市场 URL 或 YAML 操作，系统工具也不在此列出。
功能已停用时，对应应用行显示“功能已停用”和设置入口，保留显隐偏好但暂时禁用 Switch。
### 4.1 共同应用设置页
若某应用自身支持业务启停，应在该应用原有设置中保留“启用功能”开关，并用说明区分：
魔法笔记、本机推理的应用管理和应用页面入口定位到同一应用设置页，复用同一个表单及配置。知识库和智能心跳在管理 Modal 中仅提供“打开”，不提供启用、常驻、排序或通用空设置；原工作区实际配置入口保留。
共同页遵守[设置中心 UI 规范](../../../UI-DESIGN.md#138-设置中心)，不为每个入口建立一套设置。
全局设置移除魔法笔记页签及跳转入口。旧“显示魔法笔记入口”绑定业务启用值，迁为“启用应用”并保留原值；
“常驻左侧菜单”使用独立配置，只有已发布的独立显隐偏好才映射到常驻。
- “显示在侧边栏”只控制入口。
- “启用功能”控制该功能是否运行。
| 控件 | 表达含义 |
| --- | --- |
| 启用应用 | 控制业务可用性及主导航、会话等业务入口 |
| 常驻左侧菜单 | 仅控制主导航捷径，关闭应用时保留该偏好，并说明开启后才显示 |
| 显示未完成待办数量 | 仅控制魔法笔记导航徽标 |
| AI 评论方式 | 即时／保存后自动／保存后手动，单选 |
| AI 评论形式 | 长评 + 要点／长评／要点，单选 |
二元配置使用共享 Switch 和 `role="switch"`；评论选项使用共享单选控件。未配置布尔项
默认开启，评论默认值沿用既有值，已有明确的关闭或单选选择保留。启用与常驻不可合并。
设置详情最大宽度 `640px`，紧凑标题栏包含返回图标、应用名称、用途及关闭按钮。进入详情和
返回卡片时正文滚动位置重置到顶部；进入详情聚焦关闭按钮，返回后聚焦搜索框。
共同设置表单使用共享 Switch，相关字段分组，组间使用弱分隔线；说明沿用正文字号。
评论分段控件按内容占宽，窄窗口中标签与选项上下排列；上下移动按钮位于详情表单下方。
智能心跳单条计划 CRUD 及 enabled 仍由其业务页面负责，没有应用级心跳启用开关。
所有入口共享保存中状态。串行保存期间禁用相关启用、常驻、排序及笔记配置控件，保留
最后确认值；持久化成功后的设置事件同步中心、侧栏、会话、应用页及其他设置入口，包括工具配置写入。重开中心刷新期间锁定修改，迟到的旧读取不能覆盖更新快照。失败在发起操作
附近显示可重试错误并保留焦点；结果未知时显示“正在确认保存结果”，重读成功后再开放修改。
### 4.2 关闭后的页面与会话
关闭当前可选应用成功后，原页面或本机推理 Modal 显示“应用已关闭”和“前往应用设置”，保留草稿和内容状态，
暂停该页面的新业务操作。重新开启后恢复可用性，不自动跳到已离开的应用页或重放任务。
知识库和智能心跳不显示应用关闭状态；会话知识控件、历史引用、工作区配置及心跳计划遵守原功能规则。可选应用的已有请求和后台任务继续按功能生命周期展示，详细边界见[关闭应用与恢复](./logic-design.md#32-关闭应用与恢复)。
## 5. 助手工作栏反馈
点击系统工具后，右侧工作栏按现有布局回流打开。主内容页面保持不变，侧栏不渲染工具内容。
系统工具仅从右侧工作栏已有 Tab 或“+”目录进入，工作栏按现有布局回流，主内容页面保持不变。
- 文件：激活默认存在且不可关闭的“工作区”Tab，焦点进入目录区域或错误修复入口。
- 终端：激活匹配终端，焦点进入终端输入区；新建期间保留按钮宽度和进度状态。
- 浏览器：激活绑定当前 Conversation 的最近使用“浏览器”Tab；没有匹配实例时创建一个，
没有 Conversation 时按产品规则复用最近实例或进入待绑定空状态。
- 终端：选择已有 Tab 激活该确切终端并保留目标与历史状态；“+”每次创建额外终端，按当前
项目选择本机或托管 SSH，无项目时使用本机 Home。新建期间显示进度，失败保留诊断。
- 浏览器：选择已有 Tab 保留其 Conversation、页面及导航状态；“+”每次创建额外浏览器，
无活动 Conversation 时新建待绑定空实例。不会按当前会话改选其他 Tab 或重绑已有实例。
- 资源监控：激活“资源监控”Tab，焦点进入指标摘要；首个样本加载后开始绘制历史。
后台事件可以更新徽标，不能自动展开工作栏或切换当前 Tab。由用户点击快捷按钮触发的打开
属于显式操作，可以展开工作栏并切换 Tab。
文件和资源监控在“+”中按单实例规则聚焦或创建，终端和浏览器不按目标去重。
后台事件可以更新 Tab 徽标，不能自动展开工作栏或切换当前 Tab。
### 5.1 资源监控面板
@@ -167,7 +192,9 @@ CPU 4% · 内存 620 MB · 桌面进程 7
| 对象 | 文案 |
| --- | --- |
| 设置分类 | 应用与工具 |
| 底部入口 | 应用中心 |
| 菜单底部管理入口 | 管理应用 |
| 应用设置开关 | 启用应用 |
| 文件系统工具 | 文件 |
| 终端系统工具 | 终端 |
| 浏览器系统工具 | 浏览器 |
@@ -175,7 +202,8 @@ CPU 4% · 内存 620 MB · 桌面进程 7
| 资源系统工具 | 资源监控 |
| 资源范围 | 本机 |
| 指标缺失 | 不可用 |
| 应用显隐开关 | 显示在侧边栏 |
| 应用常驻开关 | 常驻左侧菜单 |
| 关闭的应用页 | 应用已关闭 |
| 内置来源 | 内置 |
不再使用“本地工作区”作为侧栏底部身份名称。项目和默认工作区的路径继续由项目选择器、页面
@@ -183,19 +211,22 @@ CPU 4% · 内存 620 MB · 桌面进程 7
## 7. 键盘和无障碍
- 底部按钮均为独立 `button`，不能嵌套在整行设置按钮中。
- Tab 顺序为文件、终端、浏览器、资源监控、设置。
- 底部应用中心和设置均为独立 `button`，Tab 顺序与视觉顺序一致，不嵌套按钮。
- 图标按钮通过 `aria-label` 提供名称，工具提示不能作为唯一可访问名称。
- 工作栏打开后按现有焦点策略聚焦目标面板；用户通过固定工作栏开关关闭时，焦点返回该开关。
- 选中按钮使用 `aria-pressed` 或等价的可访问状态，不能只依靠背景色。
- 徽标的数量或状态合并进按钮可访问名称，例如“终端，1 个等待处理”。
- 应用显隐 Switch 支持 Space 切换，保存失败后恢复原值并保留焦点。
- 应用中心按钮提供 `aria-haspopup="menu"`、`aria-expanded` 和控制关系；菜单使用 `menu`／`menuitem`，打开后聚焦首个可用项，上下方向键循环选择，Home、End 到首尾，Enter、Space 激活。
- Escape 关闭菜单并恢复入口焦点；Tab 关闭后继续正常焦点顺序，点击外部、焦点离开或再次点击入口也关闭。菜单不隔离背景，不增加遮罩。
- “管理应用”打开的 Modal 使用共享 Portal、整窗遮罩、原生浏览器遮挡、背景隔离和焦点循环，初始焦点进入搜索。卡片操作与详情控件按正常 Tab 顺序访问，不伪装成单个菜单项；详情切换焦点见共同应用设置页。
- 工作栏使用 `tablist`、`tab`、`tabpanel`、`aria-selected`、游标焦点和方向键、Home、End。
“+”使用普通按钮语义，同类型 Tab 仍按实例独立标记。
- 徽标数量或状态合并进可访问名称；Switch 支持 Space，失败保留焦点。排序按钮名称包含
应用名，操作结果通过 polite 状态区播报；拖动不是唯一排序方式。
## 8. 响应式
- 侧栏宽度 `220px` 至 `420px` 时，底部按钮尺寸不随宽度缩放。
- 窄窗口继续使用现有侧栏抽屉；工具栏不转为多行。
- 空间不足时缩小设置按钮前的弹性空白，不隐藏四个系统工具和设置。
- 侧栏宽度 `220px` 至 `420px` 时，应用中心与设置均可操作，不随宽度缩小点击区域。
- 窄窗口继续使用现有侧栏抽屉，底部入口不重叠；应用菜单向上展开并限制窗口边界、内部滚动。管理 Modal 的长名称可换行，搜索、设置与重新开启入口始终可达。
- 右侧 Tab 单行横向滚动，“+”持续可见；工作栏保持停靠回流，不遮罩主页面。
- 工具提示不得超出窗口；靠近底边时显示在按钮上方。
- 粗指针设备不依赖悬停，按钮的可访问名称和选中反馈保持有效。
@@ -219,8 +250,31 @@ CPU 4% · 内存 620 MB · 桌面进程 7
## 9. 未来插件入口
插件市场交付后另行定义插件区域、固定数量、溢出和权限界面。系统入口与四个系统工具的位置
保持保留，不向插件开放。
FR-15、US-F1／US-F2 的市场 URL、YAML 导入导出及 ShareServer 分发在后续设计中定义。
首期中心只浏览本地内置清单，不显示未来市场的空壳界面。
### 9.1 本机推理管理
FR-16 的 `local-inference` 入口已纳入本轮应用清单，可常驻主导航。从常驻入口、应用菜单和管理 Modal 的“打开”均进入同一本机推理 Modal，关闭来源菜单或管理 Modal，保留底层工作区、项目、会话和草稿。其他内置应用仍打开主内容区页面。
Modal 与真实执行模块已接入；支持清单及验证范围分别见技术设计和实施进度。
复用 `custom-task-dialog` 的整窗 body Portal、遮罩、背景隔离及浏览器遮挡机制。主 Modal 最大宽度 `960px`，高度随内容增长，最大高度为 `min(720px, 100dvh - 2 × --space-6)`；紧凑标题栏和关闭按钮固定在顶部，正文独立滚动。直接显示服务列表，没有页签或任务历史。工具栏显示“每 5 秒刷新 · CPU 100% = 一个逻辑核心”、模型与连接设置、刷新状态，窄屏可换行。服务行显示“服务进程 PID … · CPU …% · 工作集 … MiB”，预热时显示“正在建立采样基线”；共享进程的 worker 在该行显示无法独立统计的原因。
初始焦点进入“关闭本机推理”，Tab／Shift+Tab 在当前 Modal 内循环。没有影响确认且没有操作提交时，关闭按钮或 Escape 关闭 Modal；点击遮罩不关闭。关闭后优先恢复仍可用的原触发元素，入口已移除时回到应用中心，窄侧栏已隐藏时回到侧栏开关。
服务采用弱分隔列表；名称使用区块标题字号，状态及引擎元数据使用
辅助字号，状态与名称同组并与操作区分开，原因与操作说明使用正文字号。桌面操作独立位于右侧；
窗口宽度不超过 `720px` 时移到正文下方并左对齐，保留完整状态和原因。
- US-F3 每行显示服务名、简短状态、引擎、模型及错误。ASR 可用时显示“按需运行（状态未知）”；OCR 和向量使用执行模块的状态。TTS 显示不可用，外部连接不列入本机服务。
- US-F4 不再提供单任务取消入口；活动任务仅在服务操作的影响确认中出现。
- US-F5 服务行右侧保留实际支持的启动、停止、重启或模型加载、释放。
- 停止、重启、释放前打开最大宽度 `480px` 的紧凑嵌套确认，列出正在使用的任务与影响；无已登记任务时说明执行前再次核对。初始焦点进入“保留运行状态”，最终危险按钮写明“确认停止服务／重启服务／释放模型”；取消保留运行状态。
确认使用独立 body Portal，隔离底层管理 Modal，Tab／Shift+Tab 只在确认中循环；Escape 只关闭确认，关闭后恢复原服务操作按钮，按钮不可用时回到管理 Modal。确认存在时禁用主 Modal 关闭按钮；提交期间禁用确认和取消按钮，两层 Escape 均不能关闭，也不能重复执行。失败关闭旧确认，在服务列表显示错误并刷新；再次操作须重新确认当前影响。成功只关闭确认。
操作失败呈现实际状态和可重试错误，无法确认则显示未知。服务恢复不自动重放任务。
关闭 Modal、关闭管理应用或取消常驻不停止服务，模型文件卸载另行操作。
服务列表提供首次加载、无服务、加载失败重试及保留旧快照的刷新失败状态；刷新期间或失败时禁用服务操作。
OCR 忙碌或模型不可用时禁用加载与释放，并在执行模块再次检查。
页面不显示无来源的进度条或资源数值。US-B6 至 US-B9 的应用中心、顺序、启用联动、笔记共同设置映射见
[需求对应](./logic-design.md#6-与需求的对应关系)。
## 10. 项目活动汇总