Skip to content

[Dogfooding] 重构 Dashboard:围绕高频任务统一入口,减少操作并提升视觉体验 #129

Description

@Disdjj

目标

把 Dashboard 做成每天愿意打开的工具工作台:打开后知道能做什么,常用操作容易找到,再次使用不必重新沿树定位;同时统一视觉层级,让桌面和手机上都清楚、好看、顺手。

这是基于日常自用诉求和当前 main 代码审阅整理的产品改进 issue。本轮未做实机 UI 测试,下面的操作量是待验证的验收目标,不是已有测量结果。

当前基础与摩擦

当前已经有能力树画布、全局跳转、工具搜索、添加工具向导、Schema 表单和本机调用记录,应复用这些基础。

  • 首页以能力树和节点 Inspector 为中心。它适合理解结构,但“再次用某个工具”仍缺少清晰的任务入口。
  • 顶栏全局面板搜索节点、页面和少量动作;命令级搜索在独立搜索页。用户需要先判断该用哪个入口。
  • 最近调用记录已有按 profile/gateway 隔离的元数据,但节点详情主要展示次数与最近一次状态,没有在此提供跨节点的最近使用入口。
  • 添加工具已有统一向导和预填配置。下一步应让它成为各页面一致可达的常用动作,并衔接挂载后的使用,而不是再造一套表单。

代码依据(审阅基线 7201827):
WorkspaceShell
CommandPalette
NodeInspector
AddToolWizard

建议范围

1. 按任务组织主入口

提供日常工作区,优先呈现常用/收藏、最近使用、可用设备和明确的下一步动作。能力树继续作为结构浏览入口。最终布局可在设计阶段确定,不预先绑定某一种卡片或导航方案。

首批高频任务:找工具并调用、再次打开最近工具、添加工具、连接/查看设备、管理相关凭证。根据真实自用记录确定排序。

2. 一个通用入口覆盖发现与动作

扩展现有全局面板,统一发现工具命令、节点、页面和常用动作;搜索结果清楚标注类型、所属连接/设备与可用状态。命令结果直接打开对应调用表单,页面结果正常跳转。保留独立搜索页的高级筛选。

“添加工具”“连接设备”等动作从工作区、全局面板和相关空态复用同一流程;带入当前上下文,避免重复选择节点或设备。

3. 缩短再次使用和完成后的路径

  • 收藏和最近使用支持直接打开工具;历史明确标注“本机 / 当前连接档案”。
  • 挂载成功后提供“查看可用工具 / 开始使用”;失败就地给出可执行的修复入口。
  • 工具调用的参数、结果和错误有稳定的展示位置;从搜索进入后能返回原搜索上下文。
  • 通用快捷入口遵守实时契约、权限和确认要求;再次打开表单不等于自动重放请求,不持久化敏感参数。

4. 统一视觉与交互

统一排版、间距、表单、按钮主次、状态颜色和空/加载/错误态。常用功能优先用易懂名称,路径和协议细节按需展开。桌面侧栏、窄屏和矮屏均有可用布局;键盘操作、焦点、Escape、深链接和前进后退行为一致。视觉稿需要覆盖完整任务和异常态。

验收标准

  • 记录改造前后同一组任务的导航动作数、重复输入项与完成时间;至少覆盖“查找并打开工具、再次使用、添加工具、进入设备”四条路径,并附交互录像或可复现记录。
  • 从任意主要页面,全局面板可直接到命令表单;选择搜索结果后无需再选一遍节点和命令。
  • 从工作区的收藏/最近使用区,已知工具最多两次导航动作即可打开表单(参数输入和必要确认单独计量,不能为了达标省掉)。
  • 添加工具从主要页面最多两次导航动作可进入统一向导;成功后可直接进入新工具的使用流程,失败时能定位并修正当前步骤。
  • 桌面、手机和矮屏完成上述任务,附浅/深主题关键页面截图;没有阻断任务的遮挡、滚动或焦点问题。
  • 切换 profile、工具被移除/权限撤销、空数据、加载失败时入口行为清楚;收藏/历史不串连接,不存参数或凭证明文。
  • 复用现有 SDK/管理契约;新增或改变管理接口时同轮交付对应 tb 命令。实现须通过 pnpm verifypnpm turbo run build

与设备体验 issue 的分工

本 issue 负责跨页面导航、通用入口、工作区和视觉交互。#130 负责接入、能力就绪、首次任务、日常使用与恢复;在本 issue 的通用入口中接入该流程。按上述四块拆交付,避免把重构做成一次不可验收的大改。

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions