feat: unify app ordering and simplify app settings access

2026-09-18 15:29:00 +08:00
parent bbae893c45
commit ca3c919a34
26 changed files with 543 additions and 332 deletions
@@ -4,7 +4,7 @@

 | 项目 | 内容 |
 | --- | --- |
-| 状态 | 应用中心与本机推理已接入源码，整体验收待完成 |
+| 状态 | 应用中心与本机推理监控已接入源码，整体验收待完成 |
 | 版本 | 0.4 |
 | 日期 | 2026-09-17 |
 | 适用产品 | GoodBuddy 桌面端 |
@@ -29,8 +29,8 @@
 | 类型 | 首期成员 | 默认位置 | 用户控制范围 |
 | --- | --- | --- | --- |
 | 系统入口 | 当前对话、运行记录、设置 | 主导航固定位置或侧栏底部 | 不可隐藏、卸载或改变类型 |
-| 固定内置应用 | 知识库、智能心跳 | 主导航固定位置及应用中心 | 始终启用并显示，不可启停、取消常驻或排序；保留工作区实际配置及心跳单条计划 enabled |
-| 可选内置应用 | 魔法笔记、本机推理 | 应用中心及主导航常驻区 | 独立控制启用、常驻与排序；保留数据 |
+| 始终显示的内置应用 | 知识库、智能心跳 | 主导航应用区及应用中心 | 始终启用并常驻，可排序，不提供启用或常驻开关；保留工作区实际配置及心跳单条计划 enabled |
+| 可选内置应用 | 魔法笔记、本机推理监控 | 应用中心及主导航常驻区 | 独立控制启用、常驻与排序；保留数据 |
 | 系统工具 | 文件浏览器、终端、浏览器、资源监控 | 右侧助手工作栏 Tab 和“+”目录 | 自带且不可卸载，按工作栏规则管理实例 |

 运行记录是系统审计页面，不属于工具。文件浏览器、终端、浏览器和资源监控是系统工具；它们
@@ -44,9 +44,9 @@
 ## 3. 目标

 - 用户从侧栏底部进入应用中心，查找、打开和配置内置应用。
- 主导航承载应用入口，本机推理打开 Modal，其余内置应用打开完整页面；辅助工具由工作栏承载。
+- 主导航承载应用入口，本机推理监控打开 Modal，其余内置应用打开完整页面；辅助工具由工作栏承载。
 - 运行记录始终可发现，不受应用显示设置和插件状态影响。
- 可选内置应用可独立设置启用与常驻，支持排序；知识库和智能心跳始终显示，未常驻的已启用应用仍可从应用菜单打开。
+- 四个内置应用均支持排序；可选应用可独立设置启用与常驻，知识库和智能心跳始终显示，未常驻的已启用应用仍可从应用菜单打开。
 - 为插件应用和插件工具保留明确的入口契约，不提前建设插件安装能力。

 ## 4. 非目标
@@ -75,7 +75,7 @@

 ### FR-3 内置应用区

-主导航在当前对话之后依次显示固定知识库、智能心跳，再按用户顺序显示已启用且常驻的可选应用，运行记录位于应用区之后。两个固定应用不参与排序。本机推理入口打开独立 Modal，其余应用打开对应一级页面，保留
+主导航在当前对话之后按共享保存顺序显示应用，知识库和智能心跳始终显示，可选应用仅显示已启用且常驻项；运行记录位于应用区之后。四个应用均可排序。本机推理监控入口打开独立 Modal，其余应用打开对应一级页面，保留
 现有徽标、范围和页面状态。管理 Modal 列出全部内置应用，知识库和智能心跳只提供“打开”。

 ### FR-4 隐藏应用
@@ -86,7 +86,7 @@

 ### FR-5 应用中心入口

-侧栏底部提供应用中心和独立设置入口。点击应用中心向上展开锚定按钮的轻量菜单，无模态遮罩。菜单列出已启用应用，不按是否打开过、历史记录或常驻状态筛选；点击应用行关闭菜单，本机推理打开 Modal，其余应用在主内容区打开页面。
+侧栏底部提供应用中心和独立设置入口。点击应用中心向上展开锚定按钮的轻量菜单，无模态遮罩。菜单列出已启用应用，不按是否打开过、历史记录或常驻状态筛选；点击应用行关闭菜单，本机推理监控打开 Modal，其余应用在主内容区打开页面。
 菜单底部“管理应用”关闭菜单并打开既有管理 Modal，在其中浏览、搜索全部内置应用，为已关闭的可选应用提供设置与重新开启入口。无搜索结果时显示空状态并可清除搜索。
 首期不展示商店、安装、推荐或系统工具清单。入口具有可访问名称，Escape 关闭后恢复触发位置的焦点。

@@ -127,16 +127,16 @@ Renderer 内存中最多保留最近 5 分钟。任一条件不满足时停止

 ### FR-11 应用导航设置

-管理 Modal 为魔法笔记和本机推理提供应用设置、常驻管理和排序。知识库和智能心跳只提供“打开”，不添加通用空设置页；原工作区配置入口及心跳单条计划 enabled 保持不变。设置中“启用应用”与“常驻左侧菜单”分别保存，
+管理 Modal 的四张卡片均提供上下移动和拖动排序，不受启用或常驻状态限制；卡片、菜单和侧栏共用一份顺序。箭头边界按完整顺序计算，搜索过滤不丢失隐藏项。魔法笔记和本机推理监控另提供应用设置、常驻管理；知识库和智能心跳提供“打开”和排序，不添加通用空设置页或开关。原工作区配置入口及心跳单条计划 enabled 保持不变。设置中“启用应用”与“常驻左侧菜单”分别保存，
 修改即时提交；请求期间串行处理并禁用会修改同一配置的控件，失败就地反馈。
-魔法笔记设置迁入共同设置界面，应用中心与笔记页访问同一份配置，全局设置不再提供魔法笔记入口。持久化成功后的设置变更同步覆盖工具配置写入；每次重开中心先刷新并锁定修改，较新的确认快照优先于迟到的读取结果。
+魔法笔记设置统一从应用中心卡片进入，笔记页与全局设置不再提供重复入口。持久化成功后的设置变更同步覆盖工具配置写入；每次重开中心先刷新并锁定修改，较新的确认快照优先于迟到的读取结果。

 ### FR-12 偏好持久化

-可选应用启用、常驻和顺序按设备持久化，重启后恢复。未配置的启用与常驻默认开启；
-魔法笔记待办数量默认显示，评论方式与形式沿用现有默认值。迁移保留已明确保存的关闭和排序选择，
+四个应用的顺序及可选应用启用、常驻按设备持久化，重启后恢复。默认顺序为知识库、智能心跳、魔法笔记、本机推理监控。未配置的应用默认启用，魔法笔记默认常驻，本机推理监控默认不常驻；
+魔法笔记待办数量默认显示，评论方式与形式沿用现有默认值。迁移保留已保存的启用、常驻和排序选择，
 旧魔法笔记入口开关绑定业务启用值，迁为“启用应用”并保留原值；常驻使用独立配置，
-只有已发布的独立显隐偏好才映射到常驻，不能由常驻推导业务启停。偏好仅包含 `magic-notes` 和 `local-inference`；未发布草案中的 `knowledgeEnabled`、`heartbeatEnabled` 已删除，不增加迁移或兼容读取。
+只有已发布的独立显隐偏好才映射到常驻，不能由常驻推导业务启停。旧可选应用顺序补入知识库、智能心跳默认位置并保留已有相对顺序，具体补齐规则见[技术设计](./technical-design.md#43-持久化与-ipc)。未发布草案中的 `knowledgeEnabled`、`heartbeatEnabled` 已删除，不增加开关键兼容读取。

 ### FR-13 窄窗口行为

@@ -173,7 +173,7 @@ Renderer 内存中最多保留最近 5 分钟。任一条件不满足时停止
 - 主导航能明确区分固定系统入口和可配置内置应用。
 - 运行记录在所有应用显隐组合下保持可见并可打开。
 - 左下角不再用“本地工作区”与系统架构占据主要空间。
- 应用菜单只列已启用应用，点击行关闭菜单；本机推理打开保留底层工作区的 Modal，其余应用进入主内容区。“管理应用”打开可搜索的既有 Modal。知识库和智能心跳固定可用，只有两个可选应用可管理启用、常驻与顺序，首期无商店入口。
+- 应用菜单只列已启用应用，点击行关闭菜单；本机推理监控打开保留底层工作区的 Modal，其余应用进入主内容区。“管理应用”打开可搜索的既有 Modal。四个应用均可排序，知识库和智能心跳始终可用，只有两个可选应用可管理启用与常驻，首期无商店入口。
 - 系统工具仅从右侧 Tab 与“+”访问；选择 Tab 不创建或改绑实例，“+”可显式创建额外浏览器或终端。
 - 资源监控以 2 秒间隔更新，保留不超过 150 个样本；面板不活动、工作栏收起或窗口隐藏、
  最小化后停止请求新样本。
@@ -187,9 +187,9 @@ Renderer 内存中最多保留最近 5 分钟。任一条件不满足时停止
 ### 首期

 - 侧栏最底部应用中心打开向上锚定的轻量菜单，无模态遮罩；底部“管理应用”进入与设置相同的整窗 Modal 和可搜索应用列表，设置按钮保持独立。
- 应用中心提供魔法笔记、知识库、智能心跳及本轮追加的本机推理入口，不要求安装。本机推理 Modal 与服务单独实现和验证。
- 支持魔法笔记、本机推理常驻主导航、取消常驻和排序；知识库和智能心跳固定显示，已启用未常驻应用仍可从菜单打开，隐藏不删除数据或停止后台任务。
- 应用中心和应用页面就近提供已有功能设置，共享真实设置来源；已有全局设置入口定位到同一界面。
+- 应用中心提供魔法笔记、知识库、智能心跳及本轮追加的本机推理监控入口，不要求安装。本机推理监控 Modal 与服务单独实现和验证。
+- 四个应用共享排序；支持魔法笔记、本机推理监控常驻主导航及取消常驻，知识库和智能心跳始终显示。已启用未常驻应用仍可从菜单打开，隐藏不删除数据或停止后台任务。
+- 通用应用设置统一从应用中心卡片进入；应用页面保留实际业务配置，本机推理监控保留“模型与连接设置”。
  魔法笔记优先接入待办数量、AI 评论方式和评论形式，入口显示与常驻控制统一，避免重复开关。
 - 文件、终端、浏览器保留在右侧工作栏 Tab，不在左下角复制入口，也不纳入应用中心。
 - 原计划的本机资源监控仍作为系统工具交付项，在右侧增加单实例面板；与应用中心分别实现和验证。
@@ -201,18 +201,18 @@ Renderer 内存中最多保留最近 5 分钟。任一条件不满足时停止

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

- 将现有魔法笔记设置迁入应用中心的应用设置界面，笔记页面内的设置入口访问同一份配置。
+- 将现有魔法笔记设置迁入应用中心卡片的设置界面，移除笔记页面内的重复入口。
  魔法笔记可常驻主导航；移除原全局设置入口，保留已有配置值和业务数据。
 - 魔法笔记相关布尔开关默认全部开启，包括入口显示（常驻）和未完成待办数量显示。
  AI 评论方式、评论形式是单选项，沿用现有默认值，不把“全部开启”解释为同时选中多个模式。
  新默认值适用于未配置状态，迁移时保留用户已明确保存的选择。
- 知识库和智能心跳为固定内置应用，侧栏入口始终存在；会话知识范围、检索方式、标签及请求行为继续遵守知识库自身规则，心跳单条计划 enabled 仍由心跳页面管理。
+- 知识库和智能心跳侧栏入口始终存在且可调整位置；会话知识范围、检索方式、标签及请求行为继续遵守知识库自身规则，心跳单条计划 enabled 仍由心跳页面管理。
 - 可选应用“取消常驻”只移除主导航捷径；“关闭应用”移除该应用在业务界面的入口。
  应用中心保留管理和重新开启入口，重新开启沿用常驻偏好，不自动导航。
 - 入口变化不删除已有数据。关闭后已打开的可选应用页显示不可用状态及恢复设置入口。
  已发出的请求和后台任务沿用各功能的生命周期规则，关闭入口不新增强制取消或重放行为。

-补充验收：关闭全部可选应用后，知识库和智能心跳侧栏入口仍可用，知识会话入口及心跳计划状态不变；管理 Modal 的两个固定应用行仅有“打开”，不能启停、取消常驻或排序。验证魔法笔记未配置时的默认开启，以及
+补充验收：关闭全部可选应用后，知识库和智能心跳侧栏入口仍可用，知识会话入口及心跳计划状态不变；管理 Modal 的两个始终显示应用提供“打开”和排序，不能启停或取消常驻。验证魔法笔记未配置时的默认开启，以及
 已有关闭选择在迁移后保留。设置保存失败时各入口保持原状态，不能出现互相矛盾的显示。

 ### 后续：应用商店与扩展
@@ -249,7 +249,7 @@ YAML 描述文件不能代替模型权重或插件程序包。有外部依赖时

 ### FR-16 本机模型管理入口（新增计划项）

-应用中心提供“本机推理”内置管理应用，可选择常驻左侧。从常驻入口、应用菜单或管理 Modal 的“打开”均进入同一独立管理 Modal；来源菜单或管理 Modal 关闭，底层工作区、当前项目、会话及草稿保持不变。该入口统一
+应用中心提供“本机推理监控”内置管理应用，可选择常驻左侧。从常驻入口、应用菜单或管理 Modal 的“打开”均进入同一独立管理 Modal；来源菜单或管理 Modal 关闭，底层工作区、当前项目、会话及草稿保持不变。该入口统一
 查看本机语音识别、OCR、向量生成等服务的运行状态与可用资源指标。

 Modal 只有服务列表，显示名称、简短状态、引擎、模型、资源和错误，不显示任务历史、任务页签、单任务取消或外部连接列表。独立向量进程显示 CPU 与工作集内存，并标明进程范围；CPU 预热、采样失败和共享进程 worker 无法独立统计时说明原因，不能用零或整个应用进程占用代替服务指标。活动请求可能仍在排队或加载，不能据此宣称服务正在运行。ASR 当前仅显示按需运行且状态未知；OCR 和向量服务使用各自执行模块的状态。
@@ -261,6 +261,6 @@ Modal 只有服务列表，显示名称、简短状态、引擎、模型、资
 启动进程。隐藏管理入口、关闭管理 Modal 或取消应用常驻均不停止模型；卸载模型文件是独立操作。
 确认打开时不能关闭底层管理 Modal；Escape 只关闭最上层，提交期间禁止关闭及重复执行。关闭后恢复可用入口焦点，具体规则见 [UI 设计](./ui-design.md#91-本机推理管理)。

-资源监控仍是只读系统工具，本机推理聚焦本地服务状态。该项独立于商店接入生产源码，支持 OCR 空闲加载与释放、内置向量进程启动／停止／重启；TTS 显示不可用。后端保留请求登记及原有取消能力，供执行路径和服务影响校验使用。各引擎边界见
+资源监控仍是只读系统工具，本机推理监控聚焦本地服务状态。该项独立于商店接入生产源码，支持 OCR 空闲加载与释放、内置向量进程启动／停止／重启；TTS 显示不可用。后端保留请求登记及原有取消能力，供执行路径和服务影响校验使用。各引擎边界见
 [技术清单](./technical-design.md#111-本机推理任务与执行服务)，验证范围见[实施进度](./progress.md)。
 原首期资源监控的 GoodBuddy 桌面进程统计范围不因此扩大。