SuperAPI AI 工具集

desktop-commands-audit

编程与开发

查看项目

更新于 10-15 20:14

技能介绍

用途:检查某个分支或 PR 中 Hive Desktop 新增的功能是否应当出现在命令面板(⌘K)或可绑定按键,若缺失则指出。审计无发现也是有效结论。

主要能力:

  • 用 git diff main...HEAD --stat 等划定变更范围,PR 可用 gh pr diff <number>。
  • 盘点用户获得的新动词(可点击入口)、对象、位置、可配置项;纯重构、绘制改动、仅后端改动不产生条目。
  • 分类:稳定通用动词进 catalog;依赖对象状态的动词注册为 scope: 'actions' 行不可绑定;对象用 useCommands 注册为响应式数据源;组件本地导航、每次会话仅一次的设置项、launcher、编号变体等均不登记,并说明理由。
  • catalog 条目写入 cmd/desktop/frontend/src/keybindings/catalog.ts 的 commandCatalog,字段含 id(<area>.<verb>,永久不变)、title、group、keywords、icon、defaultCombos(默认空即未绑定)、context。
  • 在 App.vue 的 runMap 中以 id 为键接实现,否则静默失效。
  • 终端聚焦时可用 escapesPane(优选)或 piercesPane 取回按键。
  • 序列绑定形如 g <x>,序列起始不会在聚焦面板、可编辑目标或覆盖层上触发。
  • 确认行出现在面板、从冷启动即可见、标题与设置一致;对象行以对象自身命名并归入真实容器,ID 稳定,不可用时隐藏而非置灰。
  • 验证:mise run desktop:frontend:test,并手动在 mise run desktop:dev 中检查快捷键与冷启动行。

限制:只适用于 Hive Desktop 代码库;需先阅读 docs/architecture.md 与相关 ADR;未提供该技能的安装命令、收费与平台信息。