feat: unify app ordering and simplify app settings access
This commit is contained in:
mesalogo
@@ -4,7 +4,7 @@
|
||||
|
||||
| 项目 | 内容 |
|
||||
| --- | --- |
|
||||
| 状态 | 应用中心与本机推理已接入源码，整体验收待完成 |
|
||||
| 状态 | 应用中心与本机推理监控已接入源码，整体验收待完成 |
|
||||
| 版本 | 0.4 |
|
||||
| 日期 | 2026-09-17 |
|
||||
| 关联 PRD | [应用导航与系统工具入口 PRD](./prd.md) |
|
||||
@@ -31,7 +31,7 @@ type WorkspaceView =
|
||||
实现以[浏览器多实例技术设计](../assistant-workbar/browser-tabs-technical-design.md)为准。代码中尚无资源指标采集和资源监控
|
||||
面板。侧栏底部已替换为应用中心与独立设置按钮。
|
||||
|
||||
应用中心、可选应用常驻及排序、启用联动、共同设置页和本机推理已接入生产源码；本机资源监控的
|
||||
应用中心、四应用共享排序、可选应用常驻及启用联动、共同设置页和本机推理监控已接入生产源码；本机资源监控的
|
||||
Main/Preload/Renderer 实现仍待交付。系统工具只使用右侧工作栏已有 Tab 和“+”链路。
|
||||
行为由[功能逻辑](./logic-design.md)定义，验证范围见[实施进度](./progress.md)。
|
||||
|
||||
@@ -42,7 +42,7 @@ Main/Preload/Renderer 实现仍待交付。系统工具只使用右侧工作栏
|
||||
| `App.tsx` | 组合主导航、应用中心、固定设置，持有确认配置及页面离开检查 |
|
||||
| `ApplicationMenu.tsx` / `AnchoredMenu.tsx` | 底部向上锚定的已启用应用菜单；关闭后导航，或打开既有管理 Modal；共享几何定位与键盘行为 |
|
||||
| `ApplicationCenter.tsx` | 浏览、搜索内置清单，调用既有页面导航及共同设置入口，编辑常驻和顺序；复用设置 Modal 样式和焦点工具 |
|
||||
| `ApplicationSettingsView` | 位于 `ApplicationCenter.tsx`，应用中心、应用页面、全局设置共用的应用配置表单 |
|
||||
| `ApplicationSettingsView` | 位于 `ApplicationCenter.tsx`，由应用中心卡片进入的应用配置表单 |
|
||||
| `RightAssistantSidebar.tsx` | 保留右侧工具 Tab 和“+”目录调用链路 |
|
||||
| `WorkbarShell.tsx` | 继续负责实例策略、Tab、目录和焦点行为 |
|
||||
| `workbar-contracts.ts` | 继续作为工作栏应用 ID 和实例布局的权威契约 |
|
||||
@@ -80,9 +80,9 @@ type BuiltInApplicationDefinition = {
|
||||
### 3.2 应用与设置导航
|
||||
|
||||
应用中心调用既有 `navigateFromSidebar` 或同一页面导航函数，沿用未保存离开检查和焦点
|
||||
策略。打开前检查确认的启用值；未常驻但已启用的应用不附带常驻写入。本机推理从常驻入口、菜单及管理 Modal 均经 `setView('local-inference')` 打开独立 Modal，保留底层工作区与设置草稿；其他应用继续页面导航。
|
||||
`ApplicationMenu` 按知识库、智能心跳及可选顺序派生清单，仅按启用过滤，不读取常驻或打开历史。应用行先关闭菜单再导航；底部“管理应用”关闭菜单、恢复锚点焦点并打开既有 `ApplicationCenter` Modal。
|
||||
中心和应用页的设置操作仅接受 `EditableApplicationId`，全局设置旧入口定位同一个共同页。知识库和智能心跳的管理行仅提供“打开”，原工作区实际配置保留，不添加通用空设置页。
|
||||
策略。打开前检查确认的启用值；未常驻但已启用的应用不附带常驻写入。本机推理监控从常驻入口、菜单及管理 Modal 均经 `setView('local-inference')` 打开独立 Modal，保留底层工作区与设置草稿；其他应用继续页面导航。
|
||||
`ApplicationMenu` 按四个应用共用的持久化顺序派生清单，仅按启用过滤，不读取常驻或打开历史。应用行先关闭菜单再导航；底部“管理应用”关闭菜单、恢复锚点焦点并打开既有 `ApplicationCenter` Modal。
|
||||
应用中心卡片的设置操作仅接受 `EditableApplicationId`；应用页和全局设置不提供重复入口。知识库和智能心跳的管理卡片提供“打开”和排序，原工作区实际配置保留，不添加通用空设置页。
|
||||
共同页复用设置 Modal 容器、配置读取及更新方法，不建立独立配置存储或重复表单。
|
||||
|
||||
### 3.3 工作栏选择与创建
|
||||
@@ -119,26 +119,26 @@ Conversation，无 Conversation 时创建待绑定空实例。同一 Conversatio
|
||||
|
||||
```ts
|
||||
type ApplicationNavigationSettings = {
|
||||
order: EditableApplicationId[]
|
||||
order: BuiltInApplicationId[]
|
||||
pinned: Record<EditableApplicationId, boolean>
|
||||
}
|
||||
```
|
||||
|
||||
`applicationNavigation` 仅保存可选应用顺序和常驻布尔值。默认顺序为
|
||||
`magic-notes`、`local-inference`，两项常驻默认 `true`。Zod 验证顺序恰好包含
|
||||
两个可选 ID 各一次，`pinned` 仅接受这两个键。知识库和智能心跳不进入导航 schema；Renderer 将它们固定置于可选应用之前，再按启用和常驻过滤可选项。取消常驻或关闭可选应用不删顺序。
|
||||
`applicationNavigation` 保存四个应用的完整顺序和两个可选应用的常驻布尔值。默认顺序为
|
||||
`knowledge`、`heartbeat`、`magic-notes`、`local-inference`；可选应用常驻分别默认 `true`、`false`。
|
||||
权威返回 schema 和更新 schema 均要求四个 ID 各出现一次，拒绝重复、未知和缺失 ID；`pinned` 仅接受两个可选应用的完整布尔映射。Renderer 直接读取该顺序，再按各入口的可见性过滤。知识库和智能心跳始终启用、常驻，无可写开关键。
|
||||
按[排序规则](./logic-design.md#3-主导航组合规则)提交完整顺序；不持久化可推导的可见 ID 列表。
|
||||
首期不预建插件字段，也不为未发布的旧隐藏 ID 草案增加迁移读取器。
|
||||
|
||||
### 4.2 与现有开关组合
|
||||
|
||||
可选应用侧栏入口可见条件如下，知识库和智能心跳固定显示：
|
||||
可选应用侧栏入口可见条件如下，知识库和智能心跳按保存位置始终显示：
|
||||
|
||||
```ts
|
||||
const visible = featureEnabled && applicationNavigation.pinned[id]
|
||||
```
|
||||
|
||||
`magicNotesEnabled` 保留为笔记启用的唯一权威键，`localInferenceEnabled` 为本机推理应用启用键，默认 `true`，不在导航配置再复制 enabled map。心跳没有应用级启用字段，单条计划 enabled 的业务含义和存储不变。关闭可选应用时保留常驻控件和恢复入口。
|
||||
`magicNotesEnabled` 保留为笔记启用的唯一权威键，`localInferenceEnabled` 为本机推理监控应用启用键，默认 `true`，不在导航配置再复制 enabled map。心跳没有应用级启用字段，单条计划 enabled 的业务含义和存储不变。关闭可选应用时保留常驻控件和恢复入口。
|
||||
|
||||
笔记配置继续使用 `magicNotesShowIncompleteTodoCount`、`magicNoteCommentMode` 和
|
||||
`magicNoteCommentFormat`，应用中心与笔记页使用同一 schema 和更新链路。未配置的笔记
|
||||
@@ -161,9 +161,13 @@ Renderer
|
||||
|
||||
Main 继续校验可信 sender、Zod 输入，复用 `ApplicationSettingsStore` 的更新队列，读取最新
|
||||
确认值后合并本次 patch、原子写入并返回完整 `ApplicationSettings`。写入失败不发布目标值。
|
||||
存储版本 12 补充可选应用导航和启用字段，仅为缺失笔记字段补新默认值；保留已有
|
||||
`false`、单选值和无关设置，不迁移或清理笔记、知识及会话业务数据。
|
||||
版本 12 属于未发布的分支格式，原草案 `knowledgeEnabled`、`heartbeatEnabled` 已移除；不为它们或旧三项／四项导航草案增加兼容读取器或迁移。
|
||||
存储版本 12 补充可选应用导航和启用字段，为缺失字段补默认值；保留已有
|
||||
`true`、`false`、单选值和无关设置，不迁移或清理笔记、知识及会话业务数据。
|
||||
新安装和升级时缺失整个 `applicationNavigation` 均使用共享默认值，本机推理监控启用但不常驻；本次不增加存储版本。已保存的常驻值均保留，无法区分旧默认 `true` 与用户主动固定，不强制改为 `false`。
|
||||
|
||||
仅存储读取允许补齐旧数据：缺失的 `knowledge`、`heartbeat` 按此顺序前置，再保留已有 ID 的相对顺序，最后按默认顺序追加缺失的可选应用。旧 `[local-inference, magic-notes]` 因此变为 `[knowledge, heartbeat, local-inference, magic-notes]`；完整四项顺序原样保留。缺失或空顺序采用默认顺序，部分 `pinned` 映射仅补缺失键，显式 `false` 保留。重复或未知 ID 仍按现有损坏文件处理规则处理，不静默去重或丢弃。版本 11 迁移时写入归一化结果；版本 12 读取时归一化，下一次设置保存时写入完整结果。IPC 和配置工具写入不接受这些部分数据。
|
||||
|
||||
版本 12 属于未发布的分支格式，原草案 `knowledgeEnabled`、`heartbeatEnabled` 已移除，不为这些开关键增加兼容读取器。
|
||||
|
||||
## 5. 侧栏底部重构
|
||||
|
||||
@@ -191,11 +195,11 @@ KeepAlive 缓存；`settingsOpen` 独立管理打开状态。关闭后卸载设
|
||||
## 6. 应用可用性与知识请求
|
||||
|
||||
Renderer 从同一确认快照派生可选应用主导航、中心状态和页面可用性，依赖只包含相应
|
||||
字段。keep-alive 页挂载不代表应用仍启用；禁用后在原位置渲染不可用状态和共同设置恢复入口，
|
||||
字段。keep-alive 页挂载不代表应用仍启用；禁用后在原位置渲染不可用状态，
|
||||
保留页面草稿及业务数据，阻止新的页面操作。重新启用不触发导航或业务重放。
|
||||
|
||||
`ApplicationAvailability` 隐藏并设置业务内容为 inert，保留挂载的页面实例；恢复入口由
|
||||
`ApplicationSettingsNavigation` Context 定位同一中心表单。笔记页面直接消费确认的评论配置，
|
||||
`ApplicationAvailability` 隐藏并设置业务内容为 inert，保留挂载的页面实例；重新启用从
|
||||
应用中心卡片设置进入。笔记页面直接消费确认的评论配置，
|
||||
不因修改评论方式而重建编辑器。
|
||||
|
||||
知识库和智能心跳不经过 `ApplicationAvailability`；会话知识按钮、范围、检索方式和标签继续遵守原知识库规则，心跳计划 enabled 保持不变。
|
||||
@@ -329,10 +333,10 @@ resourceMonitor.getLocalSnapshot(input: {
|
||||
|
||||
- 固定入口不受应用启用、常驻和顺序组合影响，应用中心及设置始终可达；左侧没有重复系统工具。
|
||||
- US-B6：底部菜单向上锚定且无遮罩，只列已启用应用，不受常驻或打开历史影响；点击行关闭菜单并导航，“管理应用”进入既有可搜索 Modal，包含关闭及未常驻应用。
|
||||
- US-F3／US-F5：三个入口均打开本机推理 Modal 并保留底层工作区；覆盖嵌套确认的焦点循环、逐层 Escape、提交期间禁止关闭与重复执行、关闭后的入口及后备焦点恢复，以及停用内容后的键盘焦点。
|
||||
- US-F3／US-F5：三个入口均打开本机推理监控 Modal 并保留底层工作区；覆盖嵌套确认的焦点循环、逐层 Escape、提交期间禁止关闭与重复执行、关闭后的入口及后备焦点恢复，以及停用内容后的键盘焦点。
|
||||
- US-B7：常驻、取消常驻、键盘及拖动排序成功后同步，重新开启及重启保留原偏好和顺序。
|
||||
- US-B8：知识库和智能心跳始终启用且位置稳定，管理行只有打开操作，心跳计划 enabled 不变；可选应用关闭后的不可用页保留草稿，重新开启不自动导航或重放。
|
||||
- US-B9：应用中心与笔记页定位同一笔记表单，启用、常驻、待办数量、评论方式及形式共用配置；全局设置无笔记入口。
|
||||
- US-B8：知识库和智能心跳始终启用且常驻，卡片提供打开与排序，不提供启用或常驻开关，心跳计划 enabled 不变；可选应用关闭后的不可用页保留草稿，重新开启不自动导航或重放。
|
||||
- US-B9：应用中心卡片进入笔记表单，管理启用、常驻、待办数量、评论方式及形式；笔记页和全局设置无重复入口。
|
||||
- US-B5：所有入口共享 pending，保存失败保留相同确认值；重开刷新期间锁定修改，较新事件使旧读取失效；结果未知时重读，不自动重发。
|
||||
- 文件复用不可关闭单实例；选择任一已有终端或浏览器 Tab 保留确切目标，“+”每次创建额外实例。
|
||||
- 已退出、失败的终端 Tab 不因选中而重建；工具切换不改变主页面，后台状态不抢占 Tab。
|
||||
@@ -343,8 +347,8 @@ resourceMonitor.getLocalSnapshot(input: {
|
||||
|
||||
### 10.2 Main 与契约测试
|
||||
|
||||
- 顺序包含两个可选 ID 各一次；拒绝知识库、智能心跳、重复、缺失、未知 ID 及无效常驻字段；不为未发布的两个旧启用键添加迁移。
|
||||
- 未配置布尔项默认开启；已保存的 `false` 和评论单选值经迁移及重启保留。
|
||||
- 顺序包含四个应用 ID 各一次；公开写入拒绝重复、缺失、未知 ID 及无效常驻字段；旧存储顺序按迁移规则补齐，不为未发布的两个旧启用键添加迁移。
|
||||
- 未配置启用及笔记布尔项默认开启，本机推理监控默认不常驻；已保存的常驻值和评论单选值经迁移及重启保留。
|
||||
- 更新常驻或顺序不修改启用、计划或业务数据；笔记既有配置键保持语义。
|
||||
- 串行 patch 在 Main 最新快照上合并，原子写入失败不发布目标状态；响应丢失后重读实际结果。
|
||||
- Store 持久化后才发布变更，工具配置写入使用同一通知链路；知识库和智能心跳不受可选应用偏好影响。
|
||||
@@ -379,12 +383,12 @@ FR-16 单独覆盖 US-F3 概览去重、未知指标、US-F4 单任务取消与
|
||||
US-B6 应用中心、US-B7 顺序、US-B8 启用联动、US-B9 笔记迁移，以及 US-F3 概览、
|
||||
US-F4 取消、US-F5 服务生命周期。PRD、User Stories、配套设计与根 UI 规范已同步入口及持久化规则。
|
||||
|
||||
以下为实施阶段划分，应用中心及本机推理已接入源码，验证状态以进度记录为准。
|
||||
以下为实施阶段划分，应用中心及本机推理监控已接入源码，验证状态以进度记录为准。
|
||||
|
||||
1. 底部入口使用向上锚定的轻量菜单，通过“管理应用”进入既有整窗 Modal；核对已发布配置的迁移来源。
|
||||
2. 接入现有内置应用页面与最底部应用中心入口，保留独立设置和固定运行记录入口。
|
||||
3. 实现常驻、完整顺序及启用契约，迁移时保留明确旧值，通过串行保存与确认快照同步所有界面。
|
||||
4. 迁移魔法笔记共同设置，保留知识库、智能心跳固定入口及原工作区配置、单条计划 enabled，验证可选应用关闭和重新开启。
|
||||
4. 迁移魔法笔记共同设置，保留知识库、智能心跳始终可用及原工作区配置、单条计划 enabled，验证可选应用关闭和重新开启。
|
||||
5. 验证右侧现有文件、终端、浏览器 Tab 的确切目标与“+”额外实例行为，不实现左侧重复工具条。
|
||||
6. 单独实现资源快照契约、Main 采集服务、Preload API 与右侧 `resources` 单实例面板。
|
||||
7. 验证键盘、焦点、浅深主题、窄窗口、设置失败、重启持久化和跨平台行为。
|
||||
|
||||
Reference in New Issue
Block a user