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

feat: unify app ordering and simplify app settings access

Browse Source
This commit is contained in:
mesalogo
2026-09-18 15:29:00 +08:00
parent bbae893c45
commit ca3c919a34
26 changed files with 543 additions and 332 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/features/application-tool-navigation/ui-design.md
+23 -26
View File
@@ -4,14 +4,14 @@
| 项目 | 内容 |
| --- | --- |
| 状态 | 应用中心与本机推理已接入源码，整体验收待完成 |
| 状态 | 应用中心与本机推理监控已接入源码，整体验收待完成 |
| 版本 | 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 与工作栏布局遵守根规范。
@@ -25,9 +25,7 @@
搜索
当前对话
知识库（固定显示）
智能心跳（固定显示，保留建议徽标）
可选应用（魔法笔记、本机推理，按保存顺序，仅显示启用且常驻项）
应用（按保存顺序；知识库、智能心跳始终显示，可选应用仅显示启用且常驻项）
运行记录
最近对话
@@ -38,7 +36,7 @@
```
“当前对话”和“运行记录”属于固定系统入口，常驻应用位于二者之间。首期应用清单为魔法笔记、
知识库、智能心跳及本轮追加的本机推理，应用中心与设置始终可见。侧栏底部不再显示“本地工作区”和 `platform · arch`；
知识库、智能心跳及本轮追加的本机推理监控，应用中心与设置始终可见。侧栏底部不再显示“本地工作区”和 `platform · arch`；
排障信息移至关于或诊断页面。左侧不再提供文件、终端、浏览器、资源监控的重复入口。
## 2. 底部应用中心入口
@@ -71,44 +69,43 @@
[图标] 知识库
[图标] 智能心跳 1
[图标] 魔法笔记 3
[图标] 本机推理
[图标] 本机推理监控
```
取消常驻或关闭可选应用后不留下空白。知识库、智能心跳固定在当前对话之后，始终启用并显示，不受可选顺序影响。运行记录始终位于应用区之后。
编辑常驻顺序提供拖动及“上移”“下移”按钮，首尾无可移动目标时禁用对应按钮；两种方式
提交相同可选应用顺序。知识库、智能心跳及固定系统入口不参与拖动，也不作为排序目标。保存成功后更新，重启保留。
取消常驻或关闭可选应用后不留下空白。知识库、智能心跳始终启用并显示，位置遵守共享应用顺序。运行记录始终位于应用区之后。
四个应用均在管理卡片上通过拖动及“上移”“下移”按钮排序；首尾无目标时禁用对应按钮。两种方式提交完整应用顺序，保存成功后更新，重启保留。当前对话、运行记录和底部系统入口不参与排序。
取消常驻不关闭当前页面或本机推理 Modal。重新常驻按已保存顺序恢复，关闭应用保留常驻与顺序偏好。
取消常驻不关闭当前页面或本机推理监控 Modal。重新常驻按已保存顺序恢复，关闭应用保留常驻与顺序偏好。
主侧栏始终读取最后确认配置，不展示尚未保存成功的排序或开关目标值。
## 4. 应用中心与共同设置
底部点击打开轻量菜单，锚定按钮向上展开，无模态遮罩、背景隔离或焦点循环。菜单依次列知识库、智能心跳和按保存顺序排列的已启用可选应用；不按打开历史或常驻状态过滤。点击应用行关闭菜单，本机推理打开独立 Modal，知识库、智能心跳和魔法笔记在主内容区打开页面。分隔线下的“管理应用”关闭菜单并打开既有管理 Modal。
底部点击打开轻量菜单，锚定按钮向上展开，无模态遮罩、背景隔离或焦点循环。菜单按共享保存顺序列出已启用应用，不按打开历史或常驻状态过滤。点击应用行关闭菜单，本机推理监控打开独立 Modal，知识库、智能心跳和魔法笔记在主内容区打开页面。分隔线下的“管理应用”关闭菜单并打开既有管理 Modal。
菜单通过共享 `AnchoredMenu` 挂载到 body，宽度最多 `280px`，距窗口边缘至少 `16px`，与按钮上缘间隔 `8px`；短窗口限制高度并内部滚动，滚动、窗口和内容尺寸变化时重算位置。原生浏览器相交遮挡复用共享机制。
管理 Modal 沿用设置 Modal 的表面、遮罩和焦点规则，提供全部内置应用的名称及用途搜索、打开，以及可选应用的常驻和设置：
应用管理采用桌面双列卡片，窗口宽度不超过 `720px` 时改为单列。Modal 最大宽度 `960px`，
应用管理采用 `auto-fit/minmax` 网格，卡片最小宽度 `260px`，不足时收缩为容器宽度；按 Modal 可用宽度排列三列及以上、双列或单列。Modal 最大宽度保持 `960px`，当前最大宽度可容纳三列，
高度随内容增长并受窗口限制。卡片显示图标、名称、状态和用途，底部放置操作；名称旁区分
“固定入口”和“可选 · 已启用／已关闭”。长名称可换行，正文与控件均不可横向溢出。
“始终显示”（英文 `Always shown`）和“可选 · 已启用／已关闭”。长名称可换行，正文与控件均不可横向溢出。
```text
应用中心
[搜索内置应用]
知识库 固定入口 [打开]
智能心跳 固定入口 [打开]
魔法笔记 可选 · 已启用 [打开] [设置]
本机推理 可选 · 已启用 [打开] [设置]
知识库 始终显示 [打开] [上移] [下移]
智能心跳 始终显示 [打开] [上移] [下移]
魔法笔记 可选 · 已启用 [打开] [设置] [上移] [下移]
本机推理监控 可选 · 已启用 [打开] [设置] [上移] [下移]
```
已启用但未常驻的应用可以直接打开，打开不自动常驻。关闭的应用仍能被搜索和配置，
保留禁用的“打开”按钮，可通过“设置”重新开启。启用、常驻及上下移动放在设置详情中；无搜索词且未锁定修改时，可选卡片仍支持拖动排序。无搜索结果显示清除搜索入口。
保留禁用的“打开”按钮，可通过“设置”重新开启。启用、常驻放在设置详情中；每张卡片底部提供成组的上下箭头，与打开、设置操作按空间换行。箭头使用共享图标按钮，名称和提示包含方向及应用名；目标取完整保存顺序中的相邻应用，仅首尾无目标或修改锁定时禁用对应箭头。无搜索词且未锁定修改时，所有卡片均支持拖动排序，包括关闭或未常驻的应用；搜索时禁用拖动，箭头仍按完整保存顺序操作，未命中的应用保留在顺序中。无搜索结果显示清除搜索入口。
首期不展示商店页签、推荐、安装按钮、市场 URL 或 YAML 操作，系统工具也不在此列出。
### 4.1 共同应用设置页
魔法笔记、本机推理的应用管理和应用页面入口定位到同一应用设置页，复用同一个表单及配置。知识库和智能心跳在管理 Modal 中仅提供“打开”，不提供启用、常驻、排序或通用空设置；原工作区实际配置入口保留。
魔法笔记、本机推理监控的通用应用设置统一从应用中心卡片的“设置”进入；应用页面不再提供重复快捷入口。本机推理监控保留“模型与连接设置”。知识库和智能心跳在管理 Modal 中提供“打开”和排序，不提供启用、常驻开关或通用空设置；原工作区实际配置入口保留。
共同页遵守[设置中心 UI 规范](../../../UI-DESIGN.md#138-设置中心)，不为每个入口建立一套设置。
全局设置移除魔法笔记页签及跳转入口。旧“显示魔法笔记入口”绑定业务启用值，迁为“启用应用”并保留原值；
“常驻左侧菜单”使用独立配置，只有已发布的独立显隐偏好才映射到常驻。
@@ -121,12 +118,12 @@
| AI 评论方式 | 即时／保存后自动／保存后手动，单选 |
| AI 评论形式 | 长评 + 要点／长评／要点，单选 |
二元配置使用共享 Switch 和 `role="switch"`；评论选项使用共享单选控件。未配置布尔项
默认开启，评论默认值沿用既有值，已有明确的关闭或单选选择保留。启用与常驻不可合并。
二元配置使用共享 Switch 和 `role="switch"`；评论选项使用共享单选控件。本机推理监控
默认启用但不常驻，其余未配置布尔项默认开启；评论默认值沿用既有值，已有保存的选择保留。启用与常驻不可合并。
设置详情最大宽度 `640px`，紧凑标题栏包含返回图标、应用名称、用途及关闭按钮。进入详情和
返回卡片时正文滚动位置重置到顶部；进入详情聚焦关闭按钮，返回后聚焦搜索框。
共同设置表单使用共享 Switch，相关字段分组，组间使用弱分隔线；说明沿用正文字号。
评论分段控件按内容占宽，窄窗口中标签与选项上下排列；上下移动按钮位于详情表单下方。
评论分段控件按内容占宽，窄窗口中标签与选项上下排列；详情不提供排序控件。
智能心跳单条计划 CRUD 及 enabled 仍由其业务页面负责，没有应用级心跳启用开关。
所有入口共享保存中状态。串行保存期间禁用相关启用、常驻、排序及笔记配置控件，保留
@@ -135,7 +132,7 @@
### 4.2 关闭后的页面与会话
关闭当前可选应用成功后，原页面或本机推理 Modal 显示“应用已关闭”和“前往应用设置”，保留草稿和内容状态，
关闭当前可选应用成功后，原页面或本机推理监控 Modal 显示“应用已关闭”，重新启用通过应用中心卡片设置完成；本机推理监控需先关闭 Modal。保留草稿和内容状态，
暂停该页面的新业务操作。重新开启后恢复可用性，不自动跳到已离开的应用页或重放任务。
知识库和智能心跳不显示应用关闭状态；会话知识控件、历史引用、工作区配置及心跳计划遵守原功能规则。可选应用的已有请求和后台任务继续按功能生命周期展示，详细边界见[关闭应用与恢复](./logic-design.md#32-关闭应用与恢复)。
@@ -255,10 +252,10 @@ FR-15、US-F1／US-F2 的市场 URL、YAML 导入导出及 ShareServer 分发在
### 9.1 本机推理管理
FR-16 的 `local-inference` 入口已纳入本轮应用清单，可常驻主导航。从常驻入口、应用菜单和管理 Modal 的“打开”均进入同一本机推理 Modal，关闭来源菜单或管理 Modal，保留底层工作区、项目、会话和草稿。其他内置应用仍打开主内容区页面。
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；点击遮罩不关闭。关闭后优先恢复仍可用的原触发元素，入口已移除时回到应用中心，窄侧栏已隐藏时回到侧栏开关。
初始焦点进入“关闭本机推理监控”，Tab／Shift+Tab 在当前 Modal 内循环。没有影响确认且没有操作提交时，关闭按钮或 Escape 关闭 Modal；点击遮罩不关闭。关闭后优先恢复仍可用的原触发元素，入口已移除时回到应用中心，窄侧栏已隐藏时回到侧栏开关。
服务采用弱分隔列表；名称使用区块标题字号，状态及引擎元数据使用
辅助字号，状态与名称同组并与操作区分开，原因与操作说明使用正文字号。桌面操作独立位于右侧；
窗口宽度不超过 `720px` 时移到正文下方并左对齐，保留完整状态和原因。