Appearance
FAQ 与踩坑
一、安装与入门
界面快速上手
打开 WorkBuddy，对话框底部有4个核心操作区，弄清楚这4个之后，基本就上手了。
① 工作模式（左下角）
三种模式适合不同节奏的任务：
- Craft：直接执行，不停下来等你确认。适合大多数日常任务——写文案、整理数据、出方案、跑脚本。
- Plan：先出计划再执行，中间有一个你确认的步骤。适合会改文件、操作系统、或者你不确定 AI 会做什么的任务——确认之后再动，结果更可控。
- Ask / 召唤专家：纯对话，不执行操作。适合问问题、头脑风暴、想清楚思路再行动。
💡 不是所有任务都要用 Plan。感觉 AI 要做什么你已经清楚、文件改了也没关系，就用 Craft。感觉任务复杂、结果不好撤回，就先用 Plan 看一遍。哪种顺手用哪种。
② 模型选择（底部中央）
点击底部的模型名称即可切换。模型配好后，日常就是手动选你想用的。WorkBuddy 执行复杂多步骤任务时会在内部自动调度子模型，这个过程你看不到，也不需要干预。
③ 技能（Skill）
技能是 WorkBuddy 的扩展能力包。每次你发消息，WorkBuddy 都会把所有已启用技能的描述放进上下文，再由模型判断要不要调用——不是"触发才加载"，而是每次都在判断。调用过某个技能之后，它的完整内容会留在这次对话的记忆里，直到对话结束。
技能装得越多，每次对话 AI 要处理的背景信息越多，判断越容易出偏差，上下文也会更快被填满。已启用技能的描述还有总量上限，装得太多会触及上限导致截断。
建议：只保持当前阶段用得到的技能处于启用状态。 可以安装 skill-toggle 技能——它专门管理其他技能的开关状态，不常用的直接禁用（从 AI 的视野里完全移除），需要时随时恢复，不影响已安装的内容。进阶用法：把相关技能打包成「集合」，比如「写作模式」「数据分析模式」，一句话整组切换。
④ 工作空间（选择文件夹）
工作空间决定了 WorkBuddy 能访问哪些本地文件。有两个常见的坑：
- 从不选文件夹：AI 只能靠你粘贴的内容工作，无法读取、整理或修改你的本地文件，很多任务做不了一半。
- 每次选同一个塞满文件的大文件夹：AI 每次都要"扫描"整个目录，消耗更多算力，而且不相关的文件会干扰判断，输出质量下降。
建议：按任务选文件夹。 这次做月报就选月报所在的目录，下次跑数据就选数据目录。不需要一个永久的"什么都有"的工作空间。
常见问题
Q：WorkBuddy 装好后打不开？
Mac：系统设置 → 隐私与安全性 → 点击「仍要打开」 Windows：检查安全软件是否拦截，加白名单
Q：登录不了？
用微信扫码。没反应就试手机号登录，或者刷新重试。
Q：文件夹授权授哪些？
桌面 + 文档目录即可，不需要全盘授权。
Q：积分不够用？
每天签到 100分 → 连续7天翻倍 → 腾讯云社区发心得 500-1000分 → 邀请新用户双方各500分
二、模型配置
Q：模型配置完成后，在哪里看到和切换模型？
配置完成后，对话框底部的模型选择区域会出现接入的模型名称，点击即可手动切换。如果没有出现，说明配置未完成——重新下载模型配置文档，拖给 WorkBuddy 按提示操作（见快速上车第2步）。
Q：配置文档拖进去了，AI 说需要 API Key，我去哪里拿？
连接公司内网（公司 WiFi 或 VPN）→ 访问 https://aihub.xiguacity.cn/ → 我的API → 创建或复制已有 Key → 把 Key 发给 AI。
Q：换了新电脑，需要重新配模型吗？
需要，但不用重新拿 Key。直接把配置文档拖给新设备的 WorkBuddy，它会自动检测并复用已有 Key。
Q：模型配好了，但感觉一直用同一个，有没有自动切换？
日常使用就是手动切换——在底部模型选择区选哪个就用哪个，这是正常的。自动切换发生在 WorkBuddy 执行多步骤任务时内部调度子模型，用户看不到也不需要操作。
如果想确认当前的模型配置和路由规则是否正确，发这句话给 WorkBuddy：
帮我查看当前已接入的模型列表和路由规则，确认配置是否正确。三、配置包与个人设置
Q：配置文件放对了但没生效？
一定要关闭 WorkBuddy 重新打开。配置在启动时读取，运行中放进去不会立即生效。
Q：USER.md 里要填什么？
姓名、岗位、公司背景、常用的业务术语、你希望 AI 记住的偏好（语气/格式等）。越具体，AI 越像你的专属助手。
Q：可以把配置包分享给同事吗？
可以，分享 .zip 文件即可。注意：不要在文件里包含 API Key 或邮箱密码。USER.md 里有占位符，同事自己填。
四、日常使用
Q：第一次用，不知道说什么？
直接扔一个真实工作任务：「我桌面上有5个部门的数据文件，帮我整合汇总」「帮我出一份活动策划的3种不同方向」。不需要练习，直接用。
Q：AI 的输出不理想怎么办？
直接说改，不用重开任务：「太啰嗦，精简到3段」「换表格格式」「语气更正式」「重新出一个更激进的方案」。
Q：可以同时做多个任务吗？
可以。侧边栏可以管理多个任务并行执行，一个在等待时可以开另一个。
Q：怎么设定时任务？
直接说：「每周一早上9点自动运行这个任务」「每天签到后提醒我」。WorkBuddy 会自动创建定时任务。
五、踩坑记录
坑1：指令太模糊，输出太泛
❌ 帮我分析一下这周的数据。
✅ 帮我分析这3个渠道的周数据（附件），跟上周对比，自动标出降幅超过15%的项，每个异常项给出2种可能原因。
💡 不需要懂分析方法——AI 会处理。但要告诉它：看什么文件、你想关注什么问题、输出什么结果。说得越具体，越不像通用回答。
坑2：邮箱配置用登录密码，报错
❌ 直接用邮箱登录密码配置 IMAP/SMTP → Login fail. Account is abnormal.
✅ 让 WorkBuddy 按官方引导完成邮箱配置，AI 会逐步提示如何在邮箱设置中开启 IMAP 并生成客户端专用密码。不要用登录密码替代这个步骤。
坑3：跨会话项目上下文断裂
❌ 项目做了3天，每天新开会话，AI 不记得之前的决策。
✅ 长期项目配记忆系统：会话结束时说「把今天的进展和决策写入记忆日志」，下次开始时说「先读最近的记忆日志再继续」。
坑4：配置放好了没重启
❌ 把文件拖进 .workbuddy/ 后直接问 AI，AI 不认识你。
✅ 放完文件必须重启 WorkBuddy，配置才生效。
坑5：一次改太多，不知道哪步改坏了
❌ 让 AI 一次修改5个文件，改完报错，不知道哪个出问题。
✅ 让 AI 先出修改计划，你确认后逐步执行，每步验证。
坑6：敏感信息写进了分享文档
❌ API Key 写进了配置文件，分享给同事时泄露。
✅ 分享模板统一用 ，API Key 只在对话中提供，不写入文件。