Appearance
FAQ 与踩坑
一、安装与入门
Q：WorkBuddy 装好后打不开？
Mac：系统设置 → 隐私与安全性 → 点击「仍要打开」 Windows：检查安全软件是否拦截，加白名单
Q：登录不了？
用微信扫码。没反应就试手机号登录，或者刷新重试。
Q：文件夹授权授哪些？
桌面 + 文档目录即可，不需要全盘授权。
Q：积分不够用？
每天签到 100分 → 连续7天翻倍 → 腾讯云社区发心得 500-1000分 → 邀请新用户双方各500分
二、模型配置
Q：模型配置完成后，界面上看不到模型名字，是没配好吗？
正常现象。WorkBuddy 默认隐藏模型细节。只要 ~/.workbuddy/models.json 里4个模型都存在，就是配好了。
Q：配置文档拖进去了，AI 说需要 API Key，我去哪里拿？
连接公司内网（公司 WiFi 或 VPN）→ 访问 https://aihub.xiguacity.cn/ → 我的API → 创建或复制已有 Key → 把 Key 发给 AI。
Q：换了新电脑，需要重新配模型吗？
需要，但不用重新拿 Key。直接把配置文档拖给新设备的 WorkBuddy，它会自动找到已有 Key 并复用（如果旧设备上配过同一个 Key）。
Q：模型配好了，但感觉 AI 没有自动切换，一直用同一个？
检查 models.json 里 relatedModels 字段是否存在。如果只是「添加了模型」但没有配置路由，AI 不会自动切换。重新走一遍配置文档流程即可。
三、配置包与个人设置
Q：配置文件放对了但没生效？
一定要关闭 WorkBuddy 重新打开。配置在启动时读取，运行中放进去不会立即生效。
Q：USER.md 里要填什么？
姓名、岗位、公司背景、常用的业务术语、你希望 AI 记住的偏好（语气/格式等）。越具体，AI 越像你的专属助手。
Q：可以把配置包分享给同事吗？
可以，分享 .zip 文件即可。注意：不要在文件里包含 API Key 或邮箱密码。USER.md 里有占位符，同事自己填。
四、日常使用
Q：第一次用，不知道说什么？
直接扔一个真实工作任务：「我桌面上有5个部门的数据文件，帮我整合汇总」「帮我出一份活动策划的3种不同方向」。不需要练习，直接用。
Q：AI 的输出不理想怎么办？
直接说改，不用重开任务：「太啰嗦，精简到3段」「换表格格式」「语气更正式」「重新出一个更激进的方案」。
Q：可以同时做多个任务吗？
可以。侧边栏可以管理多个任务并行执行，一个在等待时可以开另一个。
Q：怎么设定时任务？
直接说：「每周一早上9点自动运行这个任务」「每天签到后提醒我」。AI 会自动创建定时任务。
五、踩坑记录
坑1：指令太模糊，输出太泛
❌ 帮我分析一下这周的数据。
✅ 帮我分析这3个渠道的周数据（附件），跟上周对比，自动标出降幅超过15%的项，每个异常项给出2种可能原因。
💡 告诉 AI：看什么文件 / 怎么分析 / 输出什么格式 / 重点是什么。
坑2：模型没配路由，任务不自动选最优模型
❌ 在设置里只「添加了模型」，没有配 relatedModels。
✅ 用配置文档完整走一遍，里面包含路由规则。
坑3：邮箱配置用登录密码，报错
❌ 直接用邮箱登录密码配置 IMAP/SMTP → Login fail. Account is abnormal.
✅ 企业邮箱网页端 → 设置 → 开启 IMAP → 生成「客户端专用密码」（16位）→ 用专用密码配置。
坑4：跨会话项目上下文断裂
❌ 项目做了3天，每天新开会话，AI 不记得之前的决策。
✅ 长期项目配记忆系统：会话结束时说「把今天的进展和决策写入记忆日志」，下次开始时说「先读最近的记忆日志再继续」。
坑5：配置放好了没重启
❌ 把文件拖进 .workbuddy/ 后直接问 AI，AI 不认识你。
✅ 放完文件必须重启 WorkBuddy，配置才生效。
坑6：一次改太多，不知道哪步改坏了
❌ 让 AI 一次修改5个文件，改完报错，不知道哪个出问题。
✅ 让 AI 先出修改计划，你确认后逐步执行，每步验证。
坑7：敏感信息写进了分享文档
❌ API Key 写进了配置文件，分享给同事时泄露。
✅ 分享模板统一用 ，API Key 只在对话中提供，不写入文件。
六、团队推广
Q：同事说「效果不好」，怎么排查？
三步检查：① 模型路由有没有配好 → ② 指令够不够具体 → ③ 配置文件有没有放好并重启
Q：领导问「推广这个有什么 ROI」？
以质检岗为例：手动出质检报告原来需要2小时 → 现在 AI 3分钟出初稿，人工10分钟审核。每周省1h47m，每月省7+小时。5个岗位推广 ≈ 每月节省1个人力。
Q：同事问「这个 AI 会替代我吗」？
AI 替代的是：整理数据、出报表、写初稿这类重复执行。你做的是：判断哪个方案对、修改完善、推动落地。AI 帮你省掉搬砖的时间，让你集中在更有价值的事上。