workbuddy工作台搭建教程的关键不在装多少东西，而在把配置放对层级。WorkBuddy 配置分用户级与项目级两档，同名时项目级优先；项目级配置有 5 个固定位置，MCP 另走一套路径。配置生效的规则、存放的位置、任务里的可选范围，本文一次说清。 动手前先看设置面板：3个分组各管什么
搭建的开关集中在一个地方。点击左侧边栏底部的头像，在用户菜单里选「设置」，就打开了设置面板。
用户菜单本身也带六个快捷入口：企业版、查看积分余额、记忆与进化、外观、帮助与反馈、检查更新，加上退出登录。想快速切主题或看积分余额，不必进设置面板。
面板是左侧导航加右侧内容区，官方写明修改即时生效、无需重启。左侧导航按三组排列，另加一项关于：
- 设置组：通用（语言、字体大小、锁屏运行、开机自启、网络代理）、个人主页、快捷键。
- 功能组：个性化（回复风格、加载欢迎语、自定义指令、称呼与身份）、记忆与进化、智能体、模型、助理设置、Buddy 应用。
- 数据与安全组：数据管理与已归档任务查看、安全中心（安全策略与权限）。
「个性化」里的自定义指令是全局行为规则的入口，写在这里的规则对所有任务生效，不用每条任务重复交代。官方另说明，外观、记忆、模型、助理、数据管理这些设置项各自有独立文档，面板里给的是入口。
配置分两档：项目级和用户级谁优先
装完技能、写好规则之后，最常遇到的困惑是「我明明改了，怎么没生效」。官方对这个问题的答案只有一句：代理、技能、规则按「项目级 > 用户级」的优先级生效，同名时项目级优先。
两档的差别不只在谁赢，还在存放位置与可见范围。用户级配置放在个人环境里，跟随账号走；项目级配置保存在云端，项目成员共享，也可以提交到版本控制随项目分发。各项目之间互相隔离，切换项目后加载结果自动跟随当前项目。
| | | |
|---|
| | 项目工作目录下的 .codebuddy 对应子目录 | |
| 用户主目录下的 .workbuddy/mcp.json | 项目目录下的 .workbuddy/mcp.json | |
| | | |
个人授权连接器的票据仅保存在成员本地，不上传云端。所以同一套项目配置，在不同成员的机器上能调用的连接器并不完全一样。
项目级配置放在哪：5个目录位置与MCP路径
项目级配置的目录结构是固定的，五个位置各有分工：
这套目录不是另起一套。官方写明它与 CODEBUDDY.md、.codebuddy/CODEBUDDY.md、AGENTS.md 以及用户级 ~/.codebuddy/ 配置兼容，可以并存使用。手里已有的项目说明文件不必搬位置，放进去就能被读到。
MCP 走的是另一套路径，官方把它的配置文件位置分成两级：用户级放在用户主目录下的 .workbuddy/mcp.json，配置一次所有项目复用；项目级放在项目目录下的 .workbuddy/mcp.json，仅当前项目生效。选型建议是：频繁跨项目使用的能力配用户级，仅特定项目需要的专属服务配项目级。
规则与技能走 .codebuddy/，MCP 走 .workbuddy/，两个目录名只差一个字母，归的却是不同的配置体系。填错位置的表现是文件写了却完全没反应，排查时先确认放的是哪一个。
配置怎么进任务：3类可选项的来源与排序
配好的东西不会自动全部塞进任务。每一类可选项的来源范围与排序规则都不一样：
| | |
|---|
| | |
| | |
| 已连接的公共授权 + 项目个人授权 + 连接器管理页 | |
除了手动挑，创建任务时另有三项内容会自动注入上下文：项目指令拼入模型上下文，项目资料库以引用形式进入，个人记忆同样拼入上下文。这也是同一个项目里不同成员发起同一个任务、得到的回答不一样的原因，注入的个人记忆是各人自己的。
斜杠命令是这套机制里唯一会自动刷新的部分。命令文件新增、修改或删除后，补全列表自动更新，不需要重启；切换项目或新建会话后，列表里只保留当前项目可用的命令，不会串项目。
怎么确认配上了：4处自检信号
配置有没有生效，看四个地方就够了。
- 设置面板的改动：修改即时生效、无需重启。如果某项设置看起来没起作用，先看当前项目有没有同名的项目级配置把它覆盖了。
- MCP 服务器状态：界面上有状态指示灯，绿色表示连接成功可以正常使用，红色表示配置异常，需要检查配置内容、命令环境或地址。
- 技能开关：关闭后技能仍留在已安装列表中，重新开启立即恢复。关闭只暂停模型自动调用，卸载才会彻底删除技能文件与开关记录。
- 加载失败的提示：配置加载失败时官方会给出清晰提示，且不影响主流程。看到提示就去核对该位置的写法，不要先怀疑文件本身。
技能开关状态记录在用户全局配置中，可随账号在不同设备间同步；并且不会改动技能包自身的 SKILL.md 文件，开关开合几次之后原文件仍是原样。
双端与协作场景下的3个差异
同一套配置在不同端、不同协作方式下的表现并不一致。Web 端和客户端的个人技能库互不相通，云上任务里选不到客户端个人库里的技能，反过来也一样。但项目级技能不受影响，它在云端统一管理，双端表现一致。所以想让技能在别处的任务里也能用，项目级目录才是正确位置。
协作任务里的连接器会被收窄。项目的连接器按授权方式分两类：公共授权由管理员配置一次、全员共用同一套票据，适合团队共享的服务账号；个人授权由每位成员各自授权、票据不共享，适合个人私有服务。同一个连接器可以同时以两种方式存在。而协作任务中个人授权连接器全部禁用，只有公共授权可用，开启协作前要先确认项目里配了必要的公共授权连接器。
任务列表的显示规则也不一样。侧边栏任务列表只展示有任务的项目，项目下没有任务时不出现，新增任务后实时出现，删到 0 个又自动隐藏。任务是成员在项目中创建的会话，一个任务对应一个对话和一个工作空间。
自动化任务属于个人级别，只对创建者本人可见和可管理，不会因为放进了项目就变成团队共享。当前自动化只支持定时执行一种触发形态。
workbuddy工作台搭建教程的注意事项
- 同名时项目级覆盖用户级。在用户级改完没反应，第一件事是看当前项目里有没有同名配置。
- 项目配置保存在云端、成员共享。往项目里写指令、技能、专家和连接器之前，先确认没有不该进团队的内容。
- 票据不上云意味着换台机器要重连。个人授权连接器只在授权的那台设备上可用，团队场景请先确认公共授权是否已配齐。
- 技能「关闭」不等于「卸载」。不用的技能建议关闭而不是删除，关闭只暂停调用，需要时随时开回来。
- 技能开关随账号同步，但个人技能库双端不通。在客户端装好的个人技能，Web 端任务的候选里选不到。
- 升级或重启后工作空间可能出问题。官方常见问题里列过工作空间在界面中消失、目录下文件缺失的情况，重要文件建议另存一份到独立目录。
- 不要把用户项目目录放进应用安装目录。更新或重装时安装目录会被清空并重新写入，官方在更新时会对此给出提示。
- 记忆是模型自动抽取的，可能有偏差。官方提示存在概括偏差或时效性问题，拿记忆做重要判断前先核验一遍。
- 关掉记忆不会追溯撤回已有输出。关闭功能或删除条目后数据停止用于后续对话，但此前已经生成的输出不会因此变化。
workbuddy工作台搭建教程常见问题
Q：搭建工作台第一步做什么？
A：先打开设置面板看一眼三组导航，知道自己这台机器上有哪些开关，再决定配什么。所有改动即时生效，试错成本很低。
Q：用户级和项目级配置冲突按谁执行？
A：项目级优先。代理、技能、规则统一按「项目级大于用户级」的优先级合并，同名时项目级生效。
Q：明明改了配置为什么没生效？
A：先查两件事，是不是被同名项目级配置覆盖了，以及文件放的位置对不对。规则与技能放 .codebuddy 目录，MCP 放 .workbuddy 目录。
Q：项目里配的东西会共享给同事吗？
A：会。项目的指令、技能、专家、连接器保存在云端，项目成员共享；项目级配置也可以提交到版本控制随项目分发。
Q：技能关掉会丢吗？
A：不会。关闭只是暂停模型自动调用，技能文件与开关记录都保留，重新开启立即恢复。只有卸载才会彻底删除。
Q：电脑上装的技能在网页端能用吗？
A：个人技能库双端互不相通，网页端任务里选不到客户端个人库的技能。项目级技能不受影响，在云端统一管理，两端一致。
Q：配好的连接器协作时还能用吗？
A：看授权方式。协作任务中个人授权连接器全部禁用，只有公共授权可用，团队场景要提前配置公共授权连接器。
Q：工作空间突然不见了怎么办？
A：官方常见问题里列过升级或重启后工作空间消失的情况，先在目录里找历史文件夹，同时建议把重要文件同步保存到独立目录。
Q：记忆内容会记错吗？
A：记忆由模型从会话内容自动抽取，官方明确提示可能存在概括偏差或时效性问题。依赖记忆做重要判断前建议先核验，也可以随时在设置里编辑或删除条目。
搭建顺序就一条主线：先看清设置面板这个总控，再分清用户级与项目级两档的覆盖关系，把规则、技能、命令放进对应目录，最后用状态灯和补全列表确认生效。把 workbuddy工作台搭建教程 里的这几步走完，往后换项目、换设备都只是重复这套动作。想继续跟进 WorkBuddy 的配置体系与版本更新，可以关注本站的 AI 工具栏目。
AI 速览
