Files
goodbuddy/docs/features/application-tool-navigation
mesalogo e84d7bd185 feat: retain completed project activity until viewed
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: 后台会话完成后保留已完成提示,进入对应聊天后自动清除,避免错过任务结果。
2026-09-16 12:51:58 +08:00
..

应用导航与系统工具入口

本功能整理 GoodBuddy 主侧栏的入口层级:系统入口保持固定,内置应用通过最底部应用中心 访问,并可常驻主导航;系统工具由右侧工作栏 Tab 承载。应用商店是后续功能,首期不提供 商店入口、推荐位或安装流程。

当前分期见 PRD 第 8 节,实施步骤见技术设计第 11 节。 本轮更新实施计划与范围,旧版功能要求、验收和配套设计仍需按新计划同步,此项列为实现前的第一步。

新增计划包括 私有化市场与 YAML 交换: 通过市场 URL 获取应用,支持 .yml 导入导出,未来由 ShareServer 提供私有目录与分发。 本机模型管理入口可独立于商店交付,拟作为 可常驻左侧的内置管理应用,区分受管进程、外部服务和进程内模型。两项均为需求记录, 未实现,相关后续验收见 User Stories。

项目活动汇总独立于上述应用中心计划,范围见 FR-14。 计数规则由活动逻辑定义,入口与级联菜单见 活动界面,数据加载与会话跳转见 技术设计。此处“活动”包括当前运行、待处理及本次客户端 会话内已完成但未查看的会话;完成提示在实际进入聊天后清除,不累计历史完成总数。

文档导航

文档 权威职责
PRD 用户问题、产品边界、功能要求与产品验收
User Stories 用户场景及 Given/When/Then 验收
功能逻辑设计 分类规则、入口状态、优先级与失败结果
UI 设计 侧栏信息架构、控件、文案、键盘和响应式行为
技术设计 现有模块映射、状态契约、持久化和实施顺序
实施进度 项目活动级联的生产实现与验证记录
应用中心交互 Demo 对比六个候选方案;配套 CSS 和 JS 仅服务原型

Demo 可直接在支持原生 dialog、popover 的现代浏览器中打开,无需依赖或构建。 六个方案共用本次页面会话内的配置,刷新后全部恢复默认,不持久化或修改真实设置。 A–E 仅展示内置应用,没有商店入口、推荐或安装操作;F 单独演示未来私有市场。 模型服务、资源指标和工具内容均为演示数据,不执行真实安装、模型加载或进程操作。 窄屏上下排列侧栏与主内容,应用页面隐藏输入区,对话页面显示输入区。 模型管理与 F 方案均为计划预览,不代表正式功能已交付,也不纳入首期验收。 底部输入区共用一个简化候选布局:附件、语音、Runtime、模式和发送位于主操作行,专家、 知识范围及 Runtime 专属选项通过“选项”展开,非默认选择显示为可移除标签。可体验文件名 附件、模拟语音、模板填入、原生命令选择、8 秒模拟回复、发送排队、立即插入、删除、停止, 以及上下文详情和模拟压缩。文件只读取名称,语音使用固定示例文本,不录音、不上传、不调用 AI。 这是输入区设计讨论用的原型,尚未改变正式产品或替代现有 UI 规范。 左上角项目选择器下方仅在有运行中或待处理会话时显示活动摘要,全部空闲时隐藏。点击摘要打开项目 列表,悬停或点击项目向右展开会话子菜单,点击会话才切换项目与对话。子菜单与项目列表 相接,项目行保留子菜单箭头,会话行只显示名称与状态。支持上下方向键选择、右键进入、左键或 Esc 返回,顶层 Esc 关闭;窄屏在同一浮层内 进入会话层,并提供返回按钮。页面上方可切换“有待处理、仅运行中、仅当前项目运行、全部 空闲”四种场景。项目与会话均为演示数据;该级联交互已接入正式产品活动入口,范围与 验证记录见实施进度。 按最新讨论,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 的搜索启动与扩展发现方式。早期方案参考过 Notion 收藏和 VS Code Profiles,当前版本已移除场景工具包与快捷区。 原型支持 URL 的 #launcher、#favorites、 #scenes 等片段直接打开指定方案。

术语

术语 定义
系统入口 GoodBuddy 工作流程或审计所必需的固定入口,用户不能卸载、隐藏或改变类型
应用 在主内容区打开完整一级页面的功能,可显示在“当前对话”所在的主导航区
系统工具 GoodBuddy 自带且不可卸载的辅助能力,包括文件、终端、浏览器和资源监控,由右侧助手工作栏 Tab 承载
插件应用 未来由插件提供的一级页面入口
插件工具 未来由插件提供的辅助面板或命令入口
快捷入口 只负责打开或聚焦能力,不复制该能力的界面和业务状态

相关文档