排错与错误码
排错的通用顺序
遇到问题先按这个顺序试，能解决八成：
- 换个模型重试——错误码里一半以上都指向这一条
- 把任务拆小——复杂的复合任务失败率高得多
- 确认网络——公司网络先找 IT，家庭网络查代理
- 重开会话——上下文太长导致的怪异行为，开新任务最快
- 跑一遍诊断工具——上面都不行时，让它自己体检
保留证据
提交排查前先备齐：错误码、报错截图、系统版本、网络环境、发生时间。有这几样，排查速度差一个量级。
错误码速查
| 错误码 | 常见判断 | 处理方案 |
|---|---|---|
| 1001 | 多与模型侧状态有关 | 优先切换模型重试 |
| 3002 | 多与网络环境有关 | 见下方网络问题 |
| 3003 | 多与网络环境有关 | 见下方网络问题 |
| 3007 | 多与网络环境有关 | 见下方网络问题 |
| 6003 | 请求频率受限（专业版也可能出现） | 优先切换模型重试 |
| 6004 | 请求频率受限（专业版也可能出现） | 优先切换模型重试 |
| 11115 | 输入内容过长 | 精简输入，或切换为支持更大上下文的模型 |
| 11133 | 多与模型侧状态有关 | 新开会话或切换模型重试 |
| 11134 | 多与模型侧状态有关 | 新开会话或切换模型重试 |
| 14003 | 多与模型侧状态有关 | 优先切换模型重试 |
一半的错误码都是「换个模型」
1001、6003、6004、11133、11134、14003 都指向模型侧的临时状态，和你的提示词、账号、网络无关。
换一个模型再跑一遍，通常就好了。这是成本最低的排错动作。
网络问题
3002 / 3003 / 3007 都属于网络类。处理顺序：
- 先确认当前使用的是公司网络还是家庭网络
- 公司网络——建议联系企业 IT 协助排查。企业网关、代理、白名单策略都可能拦住
- 家庭网络——按官网网络排查流程逐项处理
- 关掉网络代理——见下方
网络代理配置
WorkBuddy 从 5.3.0 版本之后内置了网络代理切换功能，在设置里可以配置。
不确定就选「跟随系统」
三个选项如果你分不清区别，选「跟随系统」。
如果怀疑是代理导致的问题，关掉系统代理再试：
- macOS：系统设置 → 网络 → 选中当前网络 → 详细信息 → 代理
- Windows：设置 → 网络和 Internet → 代理
登录失败
点了登录没反应，三个原因。
原因一：没设默认浏览器
客户端要靠系统默认浏览器打开登录页。
Windows：
- 系统设置 → 默认应用 → 把 Chrome 设为默认浏览器
- 回到 WorkBuddy，选「在浏览器中打开」重试
- 或者选「复制链接」，自己打开浏览器
Ctrl + V粘贴完成验证
macOS：
- 系统偏好设置 → 通用 → 设默认浏览器为 Chrome 或 Safari
- 重启应用后重新登录
原因二：账号目录权限不足
先确认目录权限。
macOS 终端里执行：
ls -la ~/Library/Application\ Support/CodeBuddyExtension/ls -la ~/Library/Application\ Support/CodeBuddyExtension/Data/Public/auth/如果目录 owner 不是当前用户（用 whoami 确认当前用户名），需要授权。
Windows PowerShell 里执行：
Get-Acl "$env:APPDATA\CodeBuddyExtension" | Format-List确认 Owner 和 Access 列表中包含当前用户。
然后授权给当前用户。
macOS 终端：
sudo chown -R $(whoami) ~/Library/Application\ Support/CodeBuddyExtensionWindows 以管理员身份打开 PowerShell：
$user = [System.Security.Principal.WindowsIdentity]::GetCurrent().Name
$path = "$env:APPDATA\CodeBuddyExtension"
takeown /F $path /R /D Y
icacls $path /grant "${user}:(OI)(CI)F" /T最后退出 WorkBuddy 并重新打开，重新登录。
这几条命令会改文件权限
sudo chown -R 和 takeown /R 都是递归操作。确认路径完全正确再执行——路径写错的话，你会把一个不相干目录的所有权改掉。
原因三：安全软件拦截
WorkBuddy 常被误拦。临时退出以下安全软件后重试：
- 火绒
- 360 安全卫士
- 电脑管家
- Windows 安全中心
成功了就把 WorkBuddy 加进白名单，别一直关着安全软件。
诊断工具
WorkBuddy 内置「诊断工具」，一键检测网络、系统资源、安全软件、环境信息与崩溃日志，结果可视化展示并自动生成诊断报告。
遇到无法登录、连接失败、客户端异常等问题时，建议先运行自检。
怎么用
- 打开 WorkBuddy，点顶部帮助 → 诊断工具
- 点「开始检测」，逐项执行，实时显示进度与结果
- 检测过程中关闭弹窗不影响检测进行，重新打开可恢复查看
- 完成后自动生成
.txt报告，保存在日志目录logs/self-check/下（保留最近 10 份） - 可在弹窗底部点「导出报告」或「定位文件」获取，提交反馈时一并提供
检查什么
| 大类 | 检查内容 |
|---|---|
| 网络 | API 连通性、DNS、TCP 端口、代理检测、丢包率 |
| 系统资源 | 磁盘剩余空间（低于 1GB 报失败、低于 3GB 告警）、内存使用 |
| 安全软件 | EDR / 杀毒软件识别、文件读写监控检测 |
| 环境信息 | 系统信息、客户端版本、安装日志 |
| 崩溃日志 | 崩溃历史摘要 |
报告已脱敏，可以放心提供
IP 仅保留前两段、用户名替换为 ***，可以安全提供给支持团队。
另外注意：个人账号与海外版仅展示「网络」分组；企业账号及内网版 / iOA 版 / 专享版展示全部检查项。
检测到安全软件拦截时，会展示需要加入白名单的路径；失败项会给出方向性修复建议。
日志在哪
macOS：打开 WorkBuddy → 顶部帮助 → 打开日志文件夹，找到对应的 .zip 日志包。
Windows：打开 WorkBuddy → 左上角帮助下拉框 → 打开日志目录，里面的压缩包就是日志文件。
日志可能包含对话记录
日志仅用于排查问题，可能包含对话记录、设备信息等数据。提交前如果涉及敏感内容，先确认一下。
提交反馈
两个入口：
- 右上角帮助下拉框 →
helpFeedback - 右下角头像 → 设置 → 帮助与反馈 → 意见反馈
在意见反馈页面描述问题、上传截图并勾选上传日志后提交。
磁盘空间
诊断工具的判定标准：磁盘剩余低于 1GB 报失败，低于 3GB 告警。
这条值得单独说，因为它导致的症状很迷惑——任务莫名失败、产物写不出来、客户端卡顿，看起来像别的问题。
跑大任务前先看一眼磁盘。特别是用了很多 Worktree 并行任务 的时候，每个 worktree 都是一份完整的工作目录副本。
按症状查
| 症状 | 先看这里 |
|---|---|
| 装不上、起不来 | 系统要求 |
| 点登录没反应 | 登录失败 |
| 读不了某类文件 | 换支持该类型的模型；装办公文档四件套 |
| 生成的文件打不开 | 提示词里明确指定输出格式 |
| 回复乱码、跑偏 | 换模型；拆小任务；开新会话 |
| 卡住不动 | 停止 → 换模型 → 重新执行 |
| 很慢 | 查网络；拆任务；并行处理 |
| 助理 / Bot 不回话 | FAQ - Bot 与助理 |
| 积分异常 | 积分与套餐 |
| 工作空间不见了 | FAQ - 升级后工作空间不见了 |
| 文件被改坏了 | 安全中心 - 自动备份 |
还是不行
发邮件到 workbuddy@tencent.com，附上：
- 诊断工具生成的报告
- 错误码和报错截图
- 系统版本和客户端版本
- 网络环境（公司 / 家庭 / 是否用代理）
- 发生时间和复现步骤