mesalogo
e89db96b85
Replace separate project and activity navigation with a fixed-height two-line button and a shared workspace menu. Browse local, remote and channel projects, preview sessions on hover, restore the last opened conversation, and show ten recent conversations alongside active work. Preserve project settings, recovery actions, draft leave guards and completion reminders. Reuse conversation summaries and windowed lists without hover fetches or polling. Validation: focused component and App tests, real Electron layout and interaction checks, typecheck and lint passed. The earlier full suite timed out and reported Supervisor settings/layout failures. Release note: 左上角统一项目与活动入口，支持分类查找、悬停预览和最近 10 个会话；双行按钮整体点击，保留项目设置与跨项目会话切换。
146 lines
16 KiB
Markdown
146 lines
16 KiB
Markdown
# 应用导航与系统工具入口
|
||
|
||
本功能整理 GoodBuddy 主侧栏的入口层级：系统入口保持固定，五个内置应用共用可调整的保存顺序，知识库始终启用并常驻；
|
||
智能心跳、魔法笔记和本机推理监控可通过应用管理控制启用和常驻。底部“应用”向上展开轻量锚定菜单，列出已启用应用；底部“管理应用”打开既有“应用中心”管理 Modal。系统工具由右侧工作栏 Tab 承载。应用商店是后续功能，首期不提供
|
||
商店入口、推荐位或安装流程。
|
||
|
||
设备共享作为第五项追加到原有应用顺序，测试阶段默认关闭，启用后可从菜单和管理 Modal 打开，不提供常驻
|
||
开关；服务地址与设备名称在其页面保存。首期仅支持本地服务的设备注册与元数据目录，详见
|
||
[设备共享](../device-sharing/README.md)。
|
||
|
||
当前分期见 [PRD 第 8 节](./prd.md#8-分期)，实施步骤见[技术设计第 11 节](./technical-design.md#11-实施顺序)。
|
||
本轮 A–D 已接入生产源码：应用菜单、应用管理 Modal、共享应用设置、持久化偏好及本机推理监控。菜单不按打开历史或常驻状态筛选，无模态遮罩；点击应用行关闭菜单，知识库、智能心跳和魔法笔记打开主内容区页面。本机推理监控从菜单、常驻入口或管理 Modal 打开时均使用独立 Modal，保留底层工作区。管理列表、菜单和侧栏按同一保存顺序排列，侧栏按启用和常驻过滤。知识库在管理 Modal 中提供“打开”和排序，不提供启用、常驻开关或通用空设置；原工作区配置及心跳单条计划 enabled 保持原义。验证范围及集成缺口见[实施进度](./progress.md)。
|
||
|
||
新增计划包括 [私有化市场与 YAML 交换](./prd.md#fr-15-私有化市场与-yaml-交换后续)：
|
||
通过市场 URL 获取应用，支持 `.yml` 导入导出，未来由 ShareServer 提供私有目录与分发。
|
||
[本机模型管理入口](./prd.md#fr-16-本机模型管理入口新增计划项)已独立于商店接入，作为
|
||
可常驻左侧的“本机推理监控”（英文 Local Inference Monitor）内置应用，直接查看语音、OCR、向量等本机服务状态与可用资源指标，不显示任务历史。向量服务显示独立进程的 CPU 和工作集内存；ASR、OCR 与宿主共享进程，逐行说明无法独立统计的原因。
|
||
本轮已接入 `local-inference` 管理 Modal、类型化 IPC、真实请求登记及引擎管理；实际支持清单见
|
||
[技术设计](./technical-design.md#111-本机推理任务与执行服务)，市场仍为后续需求。
|
||
相关验收见 [User Stories](./user-stories.md#7-后续需求场景)。
|
||
|
||
项目活动汇总独立于上述应用中心计划，范围见 [FR-14](./prd.md#fr-14-项目活动汇总)。
|
||
生产项目入口是一个固定双行按钮：第一行显示项目名，第二行显示全局活动或“暂无活动”，点击任一行都打开统一工作空间菜单并默认预览当前项目。项目分类依次为“全部项目、本地、远程、消息通道”，点击“全部项目”切换全局范围，悬停预览会话，点击项目直接进入。生产最近会话上限为 10 条，验证状态见实施进度。
|
||
计数规则由[活动逻辑](./logic-design.md#9-项目活动汇总)定义，统一菜单见
|
||
[活动界面](./ui-design.md#10-项目活动汇总)，数据加载与会话跳转见
|
||
[技术设计](./technical-design.md#12-项目活动汇总)。此处“活动”包括当前运行、待处理及本次客户端
|
||
会话内已完成但未查看的会话；完成提示在实际进入聊天后清除，不累计历史完成总数。
|
||
|
||
## 文档导航
|
||
|
||
待实现的应用扩展见 [FR-17](./prd.md#fr-17-主机管理与云环境管理待实现)：
|
||
主机管理从设置中心迁入独立工作页面，云环境管理作为同级应用；业务定义由
|
||
[远程主机功能文档](../remote-host/README.md)维护。该计划不包含已接入的设备共享元数据页面。
|
||
|
||
现有 `heartbeat` 入口承载监督者工作回顾与故事线图谱，可管理启用、常驻和排序。应用默认关闭；完整执行边界见[应用启停与执行](../conversation-supervision/logic-design.md#应用启停与执行)。未来市场复用同一应用身份，不增加平级重复入口，目标定义见[监督者产品设计](../conversation-supervision/supervisor-prd.md)。
|
||
|
||
| 文档 | 权威职责 |
|
||
| --- | --- |
|
||
| [PRD](./prd.md) | 用户问题、产品边界、功能要求与产品验收 |
|
||
| [User Stories](./user-stories.md) | 用户场景及 Given/When/Then 验收 |
|
||
| [功能逻辑设计](./logic-design.md) | 分类规则、入口状态、优先级与失败结果 |
|
||
| [UI 设计](./ui-design.md) | 侧栏信息架构、控件、文案、键盘和响应式行为 |
|
||
| [技术设计](./technical-design.md) | 现有模块映射、状态契约、持久化和实施顺序 |
|
||
| [实施进度](./progress.md) | 应用中心、设置及统一工作空间菜单的实现与验证记录 |
|
||
| [应用中心交互 Demo](./navigation-demo.html) | 对比六个候选方案；配套 CSS 和 JS 仅服务原型 |
|
||
| [工作空间交互 Demo](./workspace-demo.html) | 左上角开始菜单式项目与并发会话候选方案；配套 `workspace-demo.css` 与 `workspace-demo.js` 仅服务原型 |
|
||
|
||
以下保留工作空间 Demo 的历史原型说明，包括最近 5 条的旧上限。生产实现已接入独立的 `WorkspaceMenu`，以功能设计和实施进度为准；Demo 的分类布局、排序、快捷键及模拟设置不作为生产契约。
|
||
|
||
工作空间 Demo 可直接打开，展示项目工作空间、会话窗口、全局活动、状态筛选、待办处理与完成待查看。
|
||
左上角项目和活动摘要打开同一个锚定下拉菜单，没有独立总览页面或全屏遮罩。左栏筛选项目，右栏按状态分组显示紧凑会话列表，列表在菜单内滚动。
|
||
菜单桌面宽度扩至 920px、高度至 640px，并受视口约束；左栏按本地项目、远程项目、消息通道分组。远程项目按主机归属展示，主机连接状态与会话活动计数分开；分组、主机和通道均使用演示数据。
|
||
左侧通过本地、远程、消息通道 Tab 点击切换分类，项目悬停预览；演示包含 20 个本地项目、20 个远程项目和 3 个消息通道。搜索跨分类匹配项目名、主机及类型，远程主机分组支持折叠。“全部项目”、搜索和分类固定，项目列表独立滚动。
|
||
项目行最小高度 52px，无活动时显示名称、工作目录两行；有活动时显示名称、活动状态、工作目录三行，高度随内容增长。当前项目以勾选区分于悬停预览。设置按钮独立，悬停或聚焦显示，触屏常显。设置弹窗可修改演示名称、说明、目录、默认模式及 Runtime；通道名称只读，执行空间不可修改。所有目录均为示例路径，不访问文件系统；原型未模拟真实目录选择、归档删除或远程恢复流程。
|
||
点击项目入口默认筛选当前项目，点击活动摘要查看全部项目；悬停左侧项目只预览右侧会话。点击项目直接进入并恢复上次打开的会话，尚无会话则创建新会话；点击右侧会话直接进入指定会话。设置按钮独立，不触发项目切换，会话草稿保留。
|
||
支持浅深主题、窄屏、点击外部关闭、Escape 关闭及 `Ctrl/Command+Shift+K` 切换菜单。
|
||
菜单底部“新建项目”展开名称表单，创建后进入新项目的首个会话；“新建会话”与状态筛选同排，在所选项目创建会话，全部项目视图下使用当前项目。窄屏状态筛选横向滚动，创建按钮保持可见。均只修改演示数据，重置后清除。
|
||
页面顶部可模拟后台完成，进入会话后清除该会话的完成提醒；已查看会话仍保留在最近会话中，不额外标记状态。
|
||
状态沿用正式活动入口：待处理、运行中、已完成；待处理会话区分“等待你的回答”和“等待审批”。不提供“可继续”状态或筛选。“已完成”仍表示完成未查看提醒，不是全部历史完成会话。
|
||
默认列表将待处理、运行中置顶，其余会话归入“最近会话”，按最近进入、发送或状态更新排序，最多显示 5 条；完成未查看在会话行标注。待处理和运行中不受此上限限制，也不重复列入最近会话。“已完成”筛选展示全部未查看结果，不受最近 5 条限制。没有活动时仍显示最近会话。
|
||
所有执行、审批和消息均为内存中的模拟，不访问真实项目、不调用 AI；该候选方案尚未接入正式产品。
|
||
|
||
Demo 可直接在支持原生 dialog、popover 的现代浏览器中打开，无需依赖或构建。
|
||
六个方案共用本次页面会话内的配置，刷新后全部恢复默认，不持久化或修改真实设置。
|
||
A–E 仅展示内置应用，没有商店入口、推荐或安装操作；F 单独演示未来私有市场。
|
||
模型服务、资源指标和工具内容均为演示数据，不执行真实安装、模型加载或进程操作。
|
||
窄屏上下排列侧栏与主内容，应用页面隐藏输入区，对话页面显示输入区。
|
||
Demo 的模型管理和 F 方案均使用模拟数据；正式本机推理监控 Modal 的交付范围以技术清单和实施进度为准，旧页面原型不作为 Modal 验收依据。
|
||
底部输入区共用一个简化候选布局：附件、语音、Runtime、模式和发送位于主操作行，专家、
|
||
知识范围及 Runtime 专属选项通过“选项”展开，非默认选择显示为可移除标签。可体验文件名
|
||
附件、模拟语音、模板填入、原生命令选择、8 秒模拟回复、发送排队、立即插入、删除、停止，
|
||
以及上下文详情和模拟压缩。文件只读取名称，语音使用固定示例文本，不录音、不上传、不调用 AI。
|
||
这是输入区设计讨论用的原型，尚未改变正式产品或替代现有 UI 规范。
|
||
左上角项目选择器下方仅在有运行中或待处理会话时显示活动摘要，全部空闲时隐藏。点击摘要打开项目
|
||
列表，悬停或点击项目向右展开会话子菜单，点击会话才切换项目与对话。子菜单与项目列表
|
||
相接，项目行保留子菜单箭头，会话行只显示名称与状态。支持上下方向键选择、右键进入、左键或 Esc 返回，顶层 Esc 关闭；窄屏在同一浮层内
|
||
进入会话层，并提供返回按钮。页面上方可切换“有待处理、仅运行中、仅当前项目运行、全部
|
||
空闲”四种场景。项目与会话均为演示数据；该旧级联交互已由生产统一工作空间菜单替代，范围与
|
||
验证记录见[实施进度](./progress.md)。
|
||
Demo 已移除左侧系统工具快捷区：文件、终端、浏览器和资源监控只在右侧
|
||
工作栏 Tab 中演示，不列入应用中心。旧原型仍直接打开整窗 Modal，其中使用可搜索应用列表。
|
||
|
||
Demo 待同步更正：本节仅描述旧原型，不是生产行为或验收依据。原型直接打开 Modal、知识库的启停设置，以及心跳默认启用和关闭仅隐藏入口的说明均已过时；原型的常驻排序也不代表生产中四个应用的共享顺序。生产规则见上述说明及 UI 设计。Demo 已同步“本机推理监控”名称及其默认不常驻状态。
|
||
|
||
六个方案共用“我的应用”区：通过 ＋ 或“全部应用”选择常驻应用，编辑时可拖动或使用
|
||
上下箭头排序、移除入口。内置应用默认全部启用；魔法笔记、知识库、智能心跳默认常驻，计划预览“本机推理监控”默认不常驻。
|
||
取消常驻仅移除导航捷径，仍可从应用中心打开；关闭应用隐藏业务入口，应用中心保留设置与
|
||
重新开启入口，并记住常驻偏好。当前应用页关闭后显示不可用状态，重新启用从应用中心卡片设置进入。
|
||
知识库关闭时同步隐藏侧栏入口、会话选项中的知识范围和检索方式、已选知识标签；重新开启
|
||
恢复原来的选择。以上操作不删除数据，也不表示停止后台任务或模型服务。
|
||
“恢复默认应用”重置应用安装、启用、常驻和笔记设置，返回对话页；模型服务模拟状态保留至刷新。
|
||
|
||
通用应用设置统一从应用中心卡片进入，应用页面和全局设置不提供重复入口，分别控制
|
||
启用与常驻。魔法笔记面板另含显示未完成待办数量、AI 评论方式
|
||
（即时／保存后自动／保存后手动）、AI 评论形式（长评 + 要点／长评／要点）。现有“显示
|
||
魔法笔记入口”不在原型中重复提供。正式迁移保留其业务启用值，常驻使用独立配置。启用、常驻、待办数量显示默认开启；
|
||
评论方式默认即时，评论形式默认长评 + 要点。侧栏待办数为固定的 3 项演示数据。
|
||
修改即时生效于原型，不调用 AI 或写入真实应用设置。
|
||
|
||
此 Demo 中的任务、进度、使用方与服务内存为旧方案模拟内容；正式 Modal 已收窄为服务状态列表，见 [FR-16](./prd.md#fr-16-本机模型管理入口新增计划项)。
|
||
引擎和管理方式收进详情；受管进程模拟启动、停止、重启，进程内模型模拟加载与释放。
|
||
服务停止或重启后任务标为中断，重新启动不自动恢复任务；任务级取消仍待实际引擎接入。
|
||
影响使用方的操作先显示就地确认，取消保留原状态；隐藏或关闭管理应用不改变服务状态。
|
||
|
||
F 提供私有市场 URL、模拟获取目录、模拟不可达与重试，不发起网络请求或切换公共来源。
|
||
目录包含项目管理和阅读空间示例，可模拟安装或安装并常驻。YAML 文本支持导入预览和导出
|
||
预览，明确标为 mock schema，仅识别示例中的七个扁平字段，尚非通用 YAML 解析器。
|
||
导入列出依赖、外部资源和同标识冲突：缺少依赖或资源时不允许安装；内置应用不允许覆盖；
|
||
已安装扩展须显式确认更新定义，保留启用与常驻偏好。导入新应用在目录中以标识显示，原始名称
|
||
保留在定义及导出预览中。修改输入会使旧预览失效，取消不修改安装状态。
|
||
导出仅显示定义文本，不写文件，不包含凭据、会话、笔记、知识数据、程序包或模型权重。
|
||
|
||
| 方案 | 讨论重点 |
|
||
| --- | --- |
|
||
| A：紧凑入口 | 从底部向上展开应用列表 |
|
||
| B：应用宫格 | 在展开面板中展示应用图标、名称和常驻操作 |
|
||
| C：应用预览 | 用卡片说明应用用途 |
|
||
| D：搜索启动台 | 搜索打开能力，支持 Ctrl / Command K、方向键与 Enter |
|
||
| E：常驻管理 | 已常驻应用优先排列，可取消常驻或打开 |
|
||
| F：私有市场预览（未来） | URL 模拟获取、YAML 导入导出与显式模拟安装，不纳入首期 |
|
||
|
||
D 参考 [Raycast](https://www.raycast.com/) 的搜索启动与扩展发现方式。早期方案参考过
|
||
Notion 收藏和 VS Code Profiles，当前版本已移除场景工具包与快捷区。
|
||
原型支持 URL 的 `#launcher`、`#favorites`、
|
||
`#scenes` 等片段直接打开指定方案。
|
||
|
||
## 术语
|
||
|
||
| 术语 | 定义 |
|
||
| --- | --- |
|
||
| 系统入口 | GoodBuddy 工作流程或审计所必需的固定入口，用户不能卸载、隐藏或改变类型 |
|
||
| 应用 | 可显示在主导航区的功能；知识库、智能心跳和魔法笔记打开一级页面，本机推理监控打开保留底层工作区的 Modal |
|
||
| 系统工具 | GoodBuddy 自带且不可卸载的辅助能力，包括文件、终端、浏览器和资源监控，由右侧助手工作栏 Tab 承载 |
|
||
| 插件应用 | 未来由插件提供的一级页面入口 |
|
||
| 插件工具 | 未来由插件提供的辅助面板或命令入口 |
|
||
| 快捷入口 | 只负责打开或聚焦能力，不复制该能力的界面和业务状态 |
|
||
|
||
## 相关文档
|
||
|
||
- [GoodBuddy 统一界面设计系统](../../../UI-DESIGN.md)
|
||
- [通用助手工作栏与执行空间 PRD](../assistant-workbar/prd.md)
|
||
- [助手工作栏多终端页签 PRD](../assistant-workbar/terminal-tabs-prd.md)
|
||
- [智能心跳 PRD](../smart-heartbeat/prd.md)
|
||
- [知识库功能文档](../knowledge-base/README.md)
|
||
- [文档解析入口与职责](../document-processing/ui-design.md#11-入口与职责)：全局 OCR 配置、附件与知识文档操作的目标分工；不新增应用中心成员，本机推理监控不管理 HTTP OCR 服务。
|