mesalogo
e84d7bd185
Keep successful background conversations in project activity until their chat is visible and loaded. Track completion in memory for the current client session; initial history, failures and cancellations do not create completion notices. Include whole-file companion changes already present in App and shared UI: preserve the workspace beneath Settings, show inline reply-copy feedback, and keep project settings inside the project menu. Include their component tests and documentation; navigation demo source changes remain unstaged. Validation: 77 focused activity tests, typecheck and lint passed; Electron component fixtures passed 112 checks. Full suite: 4365 passed, 3 failed, 67 skipped (offline inventory timeout and two heartbeat migration failures). Commit-time staged whitespace check passed; tests were not rerun. Release note: 后台会话完成后保留已完成提示，进入对应聊天后自动清除，避免错过任务结果。
113 lines
9.0 KiB
Markdown
113 lines
9.0 KiB
Markdown
# 应用导航与系统工具入口
|
||
|
||
本功能整理 GoodBuddy 主侧栏的入口层级：系统入口保持固定，内置应用通过最底部应用中心
|
||
访问，并可常驻主导航；系统工具由右侧工作栏 Tab 承载。应用商店是后续功能，首期不提供
|
||
商店入口、推荐位或安装流程。
|
||
|
||
当前分期见 [PRD 第 8 节](./prd.md#8-分期)，实施步骤见[技术设计第 11 节](./technical-design.md#11-实施顺序)。
|
||
本轮更新实施计划与范围，旧版功能要求、验收和配套设计仍需按新计划同步，此项列为实现前的第一步。
|
||
|
||
新增计划包括 [私有化市场与 YAML 交换](./prd.md#fr-15-私有化市场与-yaml-交换后续)：
|
||
通过市场 URL 获取应用，支持 `.yml` 导入导出，未来由 ShareServer 提供私有目录与分发。
|
||
[本机模型管理入口](./prd.md#fr-16-本机模型管理入口新增计划项)可独立于商店交付，拟作为
|
||
可常驻左侧的内置管理应用，区分受管进程、外部服务和进程内模型。两项均为需求记录，
|
||
未实现，相关后续验收见 [User Stories](./user-stories.md#7-后续需求场景)。
|
||
|
||
项目活动汇总独立于上述应用中心计划，范围见 [FR-14](./prd.md#fr-14-项目活动汇总)。
|
||
计数规则由[活动逻辑](./logic-design.md#9-项目活动汇总)定义，入口与级联菜单见
|
||
[活动界面](./ui-design.md#10-项目活动汇总)，数据加载与会话跳转见
|
||
[技术设计](./technical-design.md#12-项目活动汇总)。此处“活动”包括当前运行、待处理及本次客户端
|
||
会话内已完成但未查看的会话；完成提示在实际进入聊天后清除，不累计历史完成总数。
|
||
|
||
## 文档导航
|
||
|
||
| 文档 | 权威职责 |
|
||
| --- | --- |
|
||
| [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 可直接在支持原生 dialog、popover 的现代浏览器中打开，无需依赖或构建。
|
||
六个方案共用本次页面会话内的配置，刷新后全部恢复默认，不持久化或修改真实设置。
|
||
A–E 仅展示内置应用，没有商店入口、推荐或安装操作；F 单独演示未来私有市场。
|
||
模型服务、资源指标和工具内容均为演示数据，不执行真实安装、模型加载或进程操作。
|
||
窄屏上下排列侧栏与主内容，应用页面隐藏输入区，对话页面显示输入区。
|
||
模型管理与 F 方案均为计划预览，不代表正式功能已交付，也不纳入首期验收。
|
||
底部输入区共用一个简化候选布局：附件、语音、Runtime、模式和发送位于主操作行，专家、
|
||
知识范围及 Runtime 专属选项通过“选项”展开，非默认选择显示为可移除标签。可体验文件名
|
||
附件、模拟语音、模板填入、原生命令选择、8 秒模拟回复、发送排队、立即插入、删除、停止，
|
||
以及上下文详情和模拟压缩。文件只读取名称，语音使用固定示例文本，不录音、不上传、不调用 AI。
|
||
这是输入区设计讨论用的原型，尚未改变正式产品或替代现有 UI 规范。
|
||
左上角项目选择器下方仅在有运行中或待处理会话时显示活动摘要，全部空闲时隐藏。点击摘要打开项目
|
||
列表，悬停或点击项目向右展开会话子菜单，点击会话才切换项目与对话。子菜单与项目列表
|
||
相接，项目行保留子菜单箭头，会话行只显示名称与状态。支持上下方向键选择、右键进入、左键或 Esc 返回，顶层 Esc 关闭；窄屏在同一浮层内
|
||
进入会话层，并提供返回按钮。页面上方可切换“有待处理、仅运行中、仅当前项目运行、全部
|
||
空闲”四种场景。项目与会话均为演示数据；该级联交互已接入正式产品活动入口，范围与
|
||
验证记录见[实施进度](./progress.md)。
|
||
按最新讨论，Demo 已移除左侧系统工具快捷区：文件、终端、浏览器和资源监控只在右侧
|
||
工作栏 Tab 中演示，不列入应用中心。上方正式文档仍保留原设计，待方案确定后同步。
|
||
|
||
六个方案共用“我的应用”区：通过 ＋ 或“全部应用”选择常驻应用，编辑时可拖动或使用
|
||
上下箭头排序、移除入口。魔法笔记、知识库、智能心跳及计划预览“本机模型”默认全部启用且常驻。
|
||
取消常驻仅移除导航捷径，仍可从应用中心打开；关闭应用隐藏业务入口，应用中心保留设置与
|
||
重新开启入口，并记住常驻偏好。当前应用页关闭后显示不可用状态及设置恢复按钮。
|
||
知识库关闭时同步隐藏侧栏入口、会话选项中的知识范围和检索方式、已选知识标签；重新开启
|
||
恢复原来的选择。以上操作不删除数据，也不表示停止后台任务或模型服务。
|
||
“恢复默认应用”重置应用安装、启用、常驻和笔记设置，返回对话页；模型服务模拟状态保留至刷新。
|
||
|
||
所有内置应用提供应用中心、应用页面和全局设置入口，均打开同一应用设置面板，分别控制
|
||
启用与常驻。魔法笔记面板另含显示未完成待办数量、AI 评论方式
|
||
（即时／保存后自动／保存后手动）、AI 评论形式（长评 + 要点／长评／要点）。现有“显示
|
||
魔法笔记入口”在原型中与“常驻左侧菜单”统一。启用、常驻、待办数量显示默认开启；
|
||
评论方式默认即时，评论形式默认长评 + 要点。侧栏待办数为固定的 3 项演示数据。
|
||
修改即时生效于原型，不调用 AI 或写入真实应用设置。
|
||
|
||
本机模型主内容区展示紧凑服务列表，包含模型、用途、引擎、管理方式、状态、占用和使用方。
|
||
受管进程模拟启动、停止、重启；外部服务仅提供连接配置预览；进程内模型模拟加载与释放。
|
||
影响使用方的操作先显示就地确认，取消保留原状态；隐藏或关闭管理应用不改变服务状态。
|
||
|
||
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 工作流程或审计所必需的固定入口，用户不能卸载、隐藏或改变类型 |
|
||
| 应用 | 在主内容区打开完整一级页面的功能，可显示在“当前对话”所在的主导航区 |
|
||
| 系统工具 | 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)
|