工具匠

工具匠是 VS Code 的底部面板扩展：在面板里放一排可点击的胶囊按钮，一键运行工作区里的文件、向 Copilot Chat 输入框追加提示词、执行 VS Code 命令。界面和文字全部为中文。

安装

• 环境：VS Code 1.95 及以上。
• 运行项由 PowerShell 启动：Windows 自带的 Windows PowerShell 即可；macOS、Linux 需要安装 PowerShell 7，并能在命令行里用 pwsh 启动。
• 消息项需要安装 GitHub Copilot Chat。
• 安装：在扩展视图中安装“工具匠”（发布者 sungbin），或用“Extensions: Install from VSIX...”安装 .vsix 文件。

使用

打开底部面板的“工具匠”页签，也可以点状态栏右侧的“工具匠”，或在命令面板中运行“工具匠：显示或隐藏面板”。面板分三行，点击按钮即执行。

• 编辑与删除：在按钮上右键，选择“编辑”或“删除”。运行项只能改名称。
• 调整顺序：按住按钮拖动，被让开的按钮会自动挪位，按 Esc 取消；也可以聚焦按钮后按 Alt+←、Alt+→。顺序只在同一行内调整。
• 新增与编辑：在面板上沿的小窗口里填写，Enter 保存（正文里用 Ctrl+Enter），Esc 取消。名称同一行内不能重复；填写有误的输入框边框变红。
• 命令 ID：输入时下方列出 VS Code 里已注册的命令，用 ↑、↓ 选择、Enter 填入，也可以直接输入列表之外的命令 ID。命令列表在面板加载时读取一次。
• 运行结果记在“输出”面板的“工具匠”里；运行失败时 VS Code 会弹出通知说明原因。

填写提交消息

扩展提供一个语言模型工具“填写提交消息”（工具名 set_commit_message，聊天里可用 #set_commit_message 引用）：Copilot 的智能体改完代码后，可以把提交消息直接填进源代码管理视图的提交输入框，你确认后自己点“提交”。

• 工具只填写，不暂存、不提交、不推送。
• 每次调用前 VS Code 会弹出确认，写明仓库、提交消息和是否会覆盖输入框里已有的内容；选“始终允许”后不再询问，已有内容会直接被覆盖。
• 工作区有多个 Git 仓库时，由智能体传入仓库路径；没有传时用活动文件所在的仓库，还确定不了就报错。
• 需要 VS Code 内置的 Git 扩展保持启用。

限制与常见问题

• 快捷操作保存在当前工作区，各工作区互相独立，不跨设备同步。
• 运行项只能是本地工作区内的文件。文件被删除、移动，或经链接指向工作区之外时无法运行，需要删除后重新添加。
• 运行项通过 PowerShell 的调用运算符 & 启动文件：脚本和可执行文件直接运行，其他类型的文件由系统决定怎么处理。文件以非零退出码结束时，终端会暂停，按回车关闭，方便查看错误。
• 消息项借剪贴板粘贴到聊天输入框，粘贴后恢复你原来的剪贴板内容；输入框已有的文字不受影响。
• 命令超过 30 秒没有返回，会停止等待；命令本身不会被取消。
• 一行里的按钮超过两行时，在该行内滚动。

许可证

Apache-2.0，见 LICENSE。扩展使用的第三方开源代码及其许可全文见安装包里的 dist/THIRD_PARTY_NOTICES.txt。