1. 为什么新手第一次打开 WorkBuddy 会卡在“不会用”很多人装完 WorkBuddy 的第一反应是界面挺干净然后呢鼠标在侧边栏点来点去找不到“新建对话”在哪想切换模型翻了三个菜单最后干脆关掉去用网页版。问题不在工具在于没人告诉你基本指令和快捷键这两套“键盘外挂”怎么落地。WorkBuddy 的操作逻辑其实就两条线一条是输入框里的斜杠指令管理对话本身一条是全局快捷键管理窗口和动作。把这两条线跑通你就能做到手不离键盘完成八成日常操作。这篇不聊虚的直接给你一份可复制的settings.json配置骨架加上命令面板的快捷键绑定示例再带你一步步验证请求是否真的生效。适合刚装好 WorkBuddy、想一次性把基础操作流程跑顺的新手。我试过把快捷键和指令分开练先记/clear和CtrlK两个一周后手指自己就记住了。下面按“配置→绑定→验证→排障”的顺序来你跟着敲就行。2. TaoToken 前置给 WorkBuddy 接上模型能力WorkBuddy 本身是操作壳真正干活的是背后的大模型。你得先有一个能调模型的入口这里用 TaoToken 来做。它的作用是提供统一的模型调用地址和密钥WorkBuddy 通过配置里的baseURL和apiKey指向它就能在对话里切换不同模型。你需要准备两样东西一个 API Key一个接入地址。Key 在控制台的 API Keys 页面生成地址用https://taotoken.net/api注意这个地址不带任何参数。生成 Key 的时候建议起个能认出来的名字比如workbuddy-dev方便以后区分。注意Key 只显示一次生成后立刻复制存到密码管理器里。别直接写进会提交到 Git 的配置文件。拿到这两样就可以进入下一步写配置了。如果你还没生成先去 API Keys 页面 建一个再回来继续。3. 可复制配置settings.json 骨架与快捷键绑定WorkBuddy 的配置分两块一块是模型接入settings.json一块是快捷键绑定keybindings.json。两个文件都在用户配置目录下路径因系统而异但内容结构一致。3.1 settings.json 配置骨架先看模型接入部分。下面这份骨架你可以直接复制把apiKey换成你自己的{ models: { default: claude-sonnet, providers: { taotoken: { baseURL: https://taotoken.net/api, apiKey: sk-你的Key粘贴在这里, models: [ { id: claude-sonnet, name: Claude Sonnet, contextWindow: 200000 }, { id: gpt-4o-mini, name: GPT-4o mini, contextWindow: 128000 } ] } } }, ui: { commandPalette: { enabled: true, recentLimit: 10 }, sidebar: { defaultOpen: true } }, instructions: { slashMenu: true, autoComplete: true } }几个字段说明一下。default决定你打开新对话时默认用哪个模型新手建议先设成轻量模型响应快、试错成本低。contextWindow是上下文窗口大小填错不影响调用但会影响 WorkBuddy 对长对话的截断判断。ui.commandPalette.recentLimit控制命令面板里“最近使用”显示几条设成 10 够用。3.2 keybindings.json 快捷键绑定快捷键绑定单独一个文件结构是“命令 ID → 按键组合”的映射。下面这份覆盖了最常用的几个动作[ { command: workbench.action.newChat, key: ctrlshiftl, mac: cmdshiftl }, { command: workbench.action.showCommands, key: ctrlk, mac: cmdk }, { command: workbench.action.toggleSidebar, key: ctrlb, mac: cmdb }, { command: workbench.action.sendMessage, key: enter }, { command: workbench.action.insertNewline, key: shiftenter }, { command: workbench.action.clearContext, key: ctrlshiftbackspace, mac: cmdshiftbackspace } ]command字段是 WorkBuddy 内部的动作 ID不同版本可能略有差异但上面这几个是长期稳定的。key和mac分开写Windows/Linux 用keymacOS 用mac。如果你只想改一个平台另一个留空也行。提示改完keybindings.json要重启 WorkBuddy 才生效。改settings.json里的模型配置一般热加载但快捷键绑定是启动时读取的。3.3 斜杠指令速查配置写好后输入框里敲/会弹出指令菜单。高频的几个先记牢指令作用什么时候用/help查看全部指令忘了有什么命令/new新建对话想开干净窗口/clear清空当前上下文AI 答偏了、换主题/model临时切换模型简单任务换轻量模型/export导出当前对话归档重要结论/skill列出已装技能调起画图、总结等能力/clear和/model是新手最该先形成肌肉记忆的两个。聊偏了先/clear再问比反复纠正省时间同一个问题轻量模型更快、重型模型更准按需切不浪费。4. 验证请求确认配置真的生效配置写完不代表跑通得验证。分三步先验证模型能调通再验证快捷键响应最后验证命令面板能搜到动作。4.1 验证模型调用打开 WorkBuddy新建一个对话输入一句最简单的/help如果指令菜单正常弹出说明斜杠指令系统加载成功。接着输入你好请回复“配置成功”四个字发送后看返回。如果返回了“配置成功”说明baseURL和apiKey都对了。如果报 401是 Key 错了报 404是baseURL写错了检查是不是漏了/api或者多写了斜杠。你也可以用命令行直接验证接口通不通排除 WorkBuddy 本身的干扰curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d { model: claude-sonnet, messages: [{role: user, content: 回复接口正常}] }返回 JSON 里choices[0].message.content有内容就说明接口层没问题。这一步能帮你快速定位是配置问题还是网络问题。4.2 验证快捷键按CtrlShiftLMac 是CmdShiftL看是否新建了一个对话。再按CtrlK命令面板应该弹出来。在面板里输入“新对话”看能不能搜到对应动作。如果快捷键没反应先确认 WorkBuddy 窗口是激活状态再检查keybindings.json有没有语法错误JSON 不允许尾逗号。改完记得重启。4.3 验证命令面板命令面板是“万能入口”。呼出后输入动作名就能执行不用翻菜单。试试搜这几个新建对话、切换模型、导出、设置。能搜到并执行说明ui.commandPalette.enabled生效了。命令面板的优势是“按名索骥”你只管想“我要干嘛”不必想“它在哪个菜单”。对记不住快捷键的人它是顶级平替。5. 本篇常见错排查配置过程中最容易踩的坑集中在这几个地方对照着查。Key 无效或 401最常见的是复制 Key 时带了空格或者把 Key 写进了会同步到云端的文件。重新生成一个粘贴时注意首尾不要有空白字符。另外确认Authorization头是Bearer加 Key中间一个空格。baseURL 写错有人写成https://taotoken.net漏了/api有人多写一个斜杠变成//api。正确就是https://taotoken.net/api不带任何查询参数。快捷键冲突CtrlK在某些系统里被输入法或其他软件占用。如果按了没反应去命令面板搜“键盘快捷方式”看有没有冲突提示或者临时换一个组合验证。斜杠指令不弹出检查settings.json里instructions.slashMenu是不是true。如果还是不行看输入法是不是处于中文状态有些输入法会拦截/键。改了配置不生效settings.json的模型部分一般热加载但keybindings.json必须重启。养成改完快捷键就重启的习惯省得怀疑人生。命令面板搜不到动作确认commandPalette.enabled为true且recentLimit不是 0。如果某个动作搜不到可能是该版本还没注册这个命令 ID以实际菜单为准。排障时如果怀疑是接入层的问题可以去 接入文档 核对最新的参数格式或者到 API Keys 页面 重新生成一个 Key 交叉验证。6. 把指令和快捷键串成日常流程配置跑通只是起点真正提效靠组合。给你一条可以立刻练的流程按CtrlK呼出命令面板输入“新对话”回车直接开干全程不碰鼠标。聊到一半发现答偏了敲/clear清上下文再问。需要换模型时敲/model选轻量模型快速试确认方向后再切回重型模型精修。每天刻意用快捷键代替一次点击一周就形成肌肉记忆。想验证不同模型的实际表现可以到 模型对话 里直接对比如果你打算长期用 WorkBuddy 做编码或跑 Agent 任务Coding Plan 会更合适额度和管理都更省心。配置和 Key 的管理统一在 控制台 里做别把 Key 散落在多个文件里。下一篇进入模型与专家系统讲怎么根据任务选对模型。你先把这篇的settings.json和keybindings.json落地指令和快捷键形成下意识后面切换模型时才有对比的基准。
