mesalogo
c71da4b6ae
Replace the production activity dialog with anchored project and conversation menus, preserving exact conversation navigation and adding keyboard and narrow-window coverage. Include the interactive demo and design documentation. The demo hides idle activity and removes conversation arrows; production still retains those two elements. Validation: typecheck, lint and 11 ProjectActivity tests passed. The full suite timed out after 240 seconds with an agent-package offline inventory test failure.
91 lines
6.8 KiB
Markdown
91 lines
6.8 KiB
Markdown
# 应用导航与系统工具入口
|
|
|
|
本功能整理 GoodBuddy 主侧栏的入口层级：系统入口保持固定，内置应用通过最底部应用中心
|
|
访问，并可常驻主导航；系统工具由右侧工作栏 Tab 承载。应用商店是后续功能，首期不提供
|
|
商店入口、推荐位或安装流程。
|
|
|
|
当前分期见 [PRD 第 8 节](./prd.md#8-分期)，实施步骤见[技术设计第 11 节](./technical-design.md#11-实施顺序)。
|
|
本轮更新实施计划与范围，旧版功能要求、验收和配套设计仍需按新计划同步，此项列为实现前的第一步。
|
|
|
|
项目活动汇总独立于上述应用中心计划，范围见 [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 可直接在浏览器中打开，支持方案切换、浅深主题、添加、移除、排序和商店模拟。
|
|
六个方案共用本次页面会话内的应用配置，刷新后恢复默认。商店、资源指标和工具内容均为
|
|
演示数据，不执行真实安装或本机操作。窄屏上下排列侧栏与输入区，桌面展示完整应用布局。
|
|
这些方案用于讨论最底部应用中心；其中商店页、商店应用安装与 F 方案属于未来交互参考，
|
|
不纳入首期实现或验收。首期产品只提供内置应用；Demo 暂保留远期示例以便后续讨论。
|
|
底部输入区共用一个简化候选布局：附件、语音、Runtime、模式和发送位于主操作行，专家、
|
|
知识范围及 Runtime 专属选项通过“选项”展开，非默认选择显示为可移除标签。可体验文件名
|
|
附件、模拟语音、模板填入、原生命令选择、8 秒模拟回复、发送排队、立即插入、删除、停止，
|
|
以及上下文详情和模拟压缩。文件只读取名称，语音使用固定示例文本，不录音、不上传、不调用 AI。
|
|
这是输入区设计讨论用的原型，尚未改变正式产品或替代现有 UI 规范。
|
|
左上角项目选择器下方仅在有运行中或待处理会话时显示活动摘要，全部空闲时隐藏。点击摘要打开项目
|
|
列表，悬停或点击项目向右展开会话子菜单，点击会话才切换项目与对话。子菜单与项目列表
|
|
相接，项目行保留子菜单箭头，会话行只显示名称与状态。支持上下方向键选择、右键进入、左键或 Esc 返回，顶层 Esc 关闭；窄屏在同一浮层内
|
|
进入会话层，并提供返回按钮。页面上方可切换“有待处理、仅运行中、仅当前项目运行、全部
|
|
空闲”四种场景。项目与会话均为演示数据；该级联交互已接入正式产品活动入口，范围与
|
|
验证记录见[实施进度](./progress.md)。
|
|
按最新讨论，Demo 已移除左侧系统工具快捷区：文件、终端、浏览器和资源监控只在右侧
|
|
工作栏 Tab 中演示，不列入应用中心。上方正式文档仍保留原设计，待方案确定后同步。
|
|
|
|
六个方案共用“我的应用”区：通过 ＋ 或“全部应用”选择常驻应用，编辑时可拖动或使用
|
|
上下箭头排序、移除入口。未常驻的已安装应用仍可从“全部应用”打开。商店包含“项目管理”
|
|
和“阅读空间”应用示例，支持仅安装或安装并常驻左侧菜单，常驻不表示后台运行。
|
|
常驻应用在本次页面会话内跨方案保持一致；“恢复默认应用”重置安装与常驻配置。
|
|
移除入口不会卸载应用或关闭当前页面，刷新后恢复默认。
|
|
|
|
魔法笔记提供应用中心“设置”、笔记页面“笔记设置”和全局设置演示入口，均打开同一设置
|
|
面板，共用本次页面会话内的配置。面板沿用现有选项：显示未完成待办数量、AI 评论方式
|
|
（即时／保存后自动／保存后手动）、AI 评论形式（长评 + 要点／长评／要点）。现有“显示
|
|
魔法笔记入口”在原型中与“常驻左侧菜单”统一，不额外增加功能启停开关。侧栏待办数为
|
|
固定的 3 项演示数据。修改即时生效于原型，不调用 AI 或写入真实应用设置。
|
|
|
|
| 方案 | 讨论重点 |
|
|
| --- | --- |
|
|
| A：紧凑入口 | 从底部向上展开应用列表 |
|
|
| B：应用宫格 | 在展开面板中展示应用图标、名称和常驻操作 |
|
|
| C：应用预览 | 用卡片说明应用用途 |
|
|
| D：搜索启动台 | 搜索打开能力，支持 Ctrl / Command K、方向键与 Enter |
|
|
| E：常驻管理 | 已常驻应用优先排列，可取消常驻或打开 |
|
|
| F：商店发现（未来） | 默认展开模拟商店，不纳入首期 |
|
|
|
|
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)
|