“余额不足”提示通常因credits冻结、待支付订单占用、本地缓存未同步或账户为试用权限所致；需依次核查冻结状态、清理待支付订单、清除credits.json缓存、确认并升级账户权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 WorkBuddy 过程中收到“余额不足”提示，但账户显示有可用 Credits，该异常通常并非由系统计费模块误判导致，而是因资金状态被冻结、待支付订单占用额度或本地缓存未同步所致。以下是排查此问题的具体步骤：
一、核查 Credits 是否处于冻结状态
腾讯云平台对部分 Credits 实施风控冻结机制，尤其在账号存在异常登录、多设备并发调用或触发安全策略时，系统会临时锁定对应额度，使其不可用于模型调用或技能执行。
1、打开 WorkBuddy 客户端，点击右上角个人头像，进入“账户中心”。
2、在“积分与配额”板块中，查找“冻结 Credits”字段，确认其数值是否大于零。
3、若显示冻结值，点击右侧“查看详情”链接，查看冻结原因及解冻时间（如：因连续3次Claw指令超时触发72小时冻结）。
4、冻结 Credits 不可手动解冻，需等待系统自动释放或联系 CodeBuddy 官方客服提交人工审核申请。
二、检查是否存在未完成的待支付订单
WorkBuddy 在执行高资源消耗任务（如批量PDF解析、远程桌面多窗口操作）前，会预先生成待支付订单并锁定等额 Credits，若任务中途异常中断或网络断连，该订单可能滞留为“待支付”状态，持续占用可用额度。
1、在“账户中心”页面，切换至“订单记录”标签页。
2、筛选状态为“待支付”或“处理中”的订单，重点关注创建时间在最近2小时内、且金额非零的条目。
3、对每条待支付订单，点击“操作”列中的“刷新状态”按钮，强制同步云端订单状态。
4、若刷新后仍显示“待支付”，请复制订单ID并拨打腾讯云CodeBuddy专线400-800-XXXX，提供ID以请求后台强制作废。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
三、清除本地 Credits 缓存数据
WorkBuddy 客户端会在本地存储 Credits 余额快照，当网络延迟或API响应超时时，该缓存可能未及时更新，导致界面显示与真实账户余额不一致。
1、关闭 WorkBuddy 客户端，包括系统托盘中残留进程（Windows 可通过任务管理器结束“WorkBuddy.exe”，macOS 可在活动监视器中终止“WorkBuddy”）。
2、定位本地缓存目录：Windows 路径为 %APPDATA%\Tencent\CodeBuddy\Cache\credits.json；macOS 路径为 ~/Library/Caches/com.tencent.codebuddy/credits.json。
3、删除该 credits.json 文件（如文件不存在，则跳过此步）。
4、重新启动 WorkBuddy，登录后客户端将强制从云端拉取最新 Credits 数据并重建缓存。
四、验证账户是否被降级为试用权限
部分用户在注册后未完成实名认证或企业绑定，系统会自动将其账户降级为“试用模式”，该模式下 Credits 仅可用于基础模型（如GLM-4），调用 Hunyuan 或 DeepSeek 等高级模型时将提示余额不足，即使账户总额充足。
1、在“账户中心”中，查看“权限等级”字段，确认是否显示“试用版”而非“正式版”或“企业版”。
2、若为试用版，点击“升级权限”按钮，按指引完成微信实名认证或上传企业营业执照。
3、认证提交后，等待约5分钟系统自动审核，审核通过后页面将刷新权限标识。
4、试用版用户调用高级模型时，系统不会弹出明确提示，仅返回余额不足错误，务必优先核验此状态。
