Quick Command Deck

把 VS Code 的常用命令与键位做成侧边栏里的一长列清单：上面一个搜索框，下面「名字 + 键位」，点一下就执行。

• 点击即执行真实命令：走 vscode.commands.executeCommand()，不是模拟按键；你改过键位也照样能用
• 不依赖任何私有 CSS / DOM 类名：用的是扩展公开 API，VS Code 升级后依然有效（不像 CSS 注入那样每次升级都要重修）
• 搜索即过滤：输入名称、键位（如 ctrl+shift+p）或命令 ID 都能匹配
• 键盘可用：↑ ↓ 选择、Enter 执行、Esc 清空搜索
• 可用性体检：核对已注册命令；扩展声明的命令允许点击以触发懒激活，执行失败会提示。注册状态不等于当前上下文一定可执行。
• 自动收录扩展键位：读取已安装扩展声明的键位，搜索框为空时附在列表下方，方便直接抄命令 ID
• 快捷键文件可手选：你自定义的键位来自 keybindings.json，自动探测不准时（portable / 远程 / 机器上放了多份变体）可以手动指定读哪一个
• 四种排序：默认顺序 / 按点击次数 / 按名称 / 按来源分组（点击次数只统计面板内点击，快捷键不计，原因见下）
• 状态栏快捷入口：点击状态栏中的 Command Deck 按钮即可打开侧边栏命令面板

安装

从 VSIX 安装

code --install-extension quick-command-deck-<version>.vsix

或在 VS Code 里：扩展 视图 → 右上角 ... → Install from VSIX... → 选中 .vsix

从市场安装

在扩展市场搜索 Quick Command Deck。

使用

1. 安装后，右侧辅助侧边栏会出现 Command Deck 图标（容器 Command Deck，视图 快捷命令）
2. 也可以点击 VS Code 状态栏中的 Command Deck 快捷入口打开面板
3. 没看到侧边栏的话：Ctrl+Alt+B 切换辅助侧边栏，或命令面板执行 Quick Command Deck: 打开命令面板（侧边栏）
4. 视图打开后搜索框会自动聚焦，直接打字即可筛；↑/↓ 选择，Enter 执行
5. 想把容器拖到左侧活动栏也完全可以，位置随意

设置

自定义命令清单

{
  "quickCommandDeck.commands": [
    { "label": "转到文件", "command": "workbench.action.quickOpen", "keys": "Ctrl+P" },
    { "label": "切换终端", "command": "workbench.action.terminal.toggleTerminal", "keys": "Ctrl+`" },
    { "label": "禅模式",   "command": "workbench.action.toggleZenMode",   "keys": "Ctrl+Alt+Z" }
  ]
}

• command 必须是命令 ID。不知道 ID？在视图里清空搜索框，最下方「来自已安装扩展」那一段就是可直接抄的 ID
• keys 只用于显示提示，写不写都行；明确填写时优先使用（空字符串表示隐藏提示），否则优先显示用户绑定，再使用扩展默认或内置提示。

为什么键位要手写？VS Code 没有公开 API 能查询"某个命令的默认键位"——默认键位表是编译进 bundle 的私有格式。所以内置清单里的键位是人工维护的，它只影响显示，不影响执行。

手动指定快捷键文件

面板里显示"你自定义的键位"时，扩展是直接读 keybindings.json 文件的（VS Code 同样没有 API 能读到"当前生效的键位"）。默认按下列顺序自动探测，取第一个存在的：

1. 由扩展 globalStorage 路径上推的 <User>\keybindings.json（portable / 远程 / --user-data-dir 场景下准确）
2. %APPDATA%\Code\User\keybindings.json
3. %APPDATA%\Code - Insiders\User\keybindings.json
4. ~/.config/Code/User/keybindings.json
5. ~/Library/Application Support/Code/User/keybindings.json

探测不准时（比如你在别处放了一份专用键位表）用命令覆盖：

也可以直接写设置（支持绝对路径、file:/// URI、~ 前缀）：

{
  "quickCommandDeck.keybindingsPath": "C:\\Users\\你\\.vscode\\extras\\keybindings.latex.json"
}

行为细节：

• 手动指定优先；若该文件不存在或路径不合法，会提示一次并回退自动探测（不会让面板突然丢掉所有键位）
• 视图标题右侧的小字会显示当前在用哪个文件：手动：xxx.json / xxx.json / 未找到快捷键文件
• 使用 jsonc-parser 读取注释与尾随逗号，保留字符串原文；同一命令的多个用户绑定均展示，带 when 的绑定会显示条件。解绑按命令、键位和条件匹配默认提示；不求值当前上下文，也不宣称这些提示就是运行时生效键位。扩展声明的键位采用当前平台覆盖值。
• 自动监听文件变化：探测路径及手动路径约每秒检查一次，文件修改、创建或删除后自动刷新。扩展列表变化会清理缓存。手动刷新也会清理缓存。不同命令即使键位相同也会保留。
• 连续刷新会合并，过期请求不会覆盖新结果；排序和数据更新通过消息完成，保留搜索词、滚动位置及选中命令。隐藏后重建面板时也会尝试恢复状态。
• 点击次数串行保存，保存失败会记录日志，不阻断命令执行。

排序与「点击次数」

工具栏右上有 4 种排序，会记在 globalState 里（跨工作区保留）：

⚠️ 「点击次数」只统计你在面板里点击行（行内悬停提示写作「面板内点击 N 次」）。 用键盘快捷键执行命令不会被统计，原因是：快捷键由 VS Code 的键位服务在主线程直接执行，扩展宿主完全不在链路上——公开 API 里没有"命令被执行"这类事件（commands 命名空间里没有 onDidExecuteCommand），也没有 API 能在运行时注册键位去拦截。 所以：想让排序反映你的真实习惯，就多点几次面板；敲快捷键按多少次都不会计入。 （理论上可以给每个想统计的键做一个"转调命令"代理——键位指向扩展、扩展计数后再转调真实命令——但那样这些键就依赖本扩展，且每个键都要改一次 keybindings.json，暂未实现。）

一键诊断

命令面板执行 Quick Command Deck: 一键诊断，可查看快捷键文件来源、路径或 JSONC 解析问题、记录及条件绑定数量、扩展命令数量，以及清单中尚未注册的命令。诊断不会执行列表中的命令，也不会修改快捷键文件。

内置命令（36 条）

与「CSS 注入水印」方案的区别

原本这套命令列表是靠 custom-css 注入 JS、往水印 DOM 里塞节点实现的，问题是：

开发

npm install
npm run compile      # 编译到 out/
npm run watch        # 增量编译
npm run check        # compile + webview 内联脚本自检 + 行为回归检查（改完 buildHtml 后先跑这个）
npm run package      # 生成 .vsix

npm run check 会重新生成 webview 的 HTML、校验内联脚本语法，并检查模板内是否混入了会被外层模板字符串吃掉的反斜杠转义——这类错误 tsc 不会报，但会让面板整个白屏。改完 src/extension.ts 里的 buildHtml() 一定要跑一次，看到「结果：通过」再重载窗口。

调试：用 VS Code 打开本目录，按 F5 启动「扩展开发主机」。

本地联调（不用反复打包）也可以直接把工程目录做成扩展目录的 junction：

cmd /c mklink /J "%USERPROFILE%\.vscode\extensions\<publisher>.quick-command-deck" "<你的工程目录>"

许可

MIT

运行时依赖 jsonc-parser 必须包含在 VSIX 中。发布脚本和流水线会收集生产依赖，请勿加回 --no-dependencies。

发布流程（不依赖 Azure 学生订阅）

GitHub Actions 自动检查并打包，版本标签须与 package.json 一致。下载运行产物 marketplace-vsix，在 Marketplace 管理页执行 Update 上传；标签不再自动上架。也可本地运行 node tools/prepare-release.cjs。无需 Azure 订阅、PAT 或 Bitwarden。详细步骤见 发布说明。