常见问题
安装问题
Q:安装扩展后找不到 @cooder 命令?
请确认已安装并启用 GitHub Copilot 扩展。Cooder 依赖 Copilot Chat 提供指令入口。在 VS Code 的扩展面板中搜索 "GitHub Copilot",确保状态为"已启用"。
Q:提示"GitHub Copilot 未授权"怎么办?
确认你的 GitHub 账号已激活 GitHub Copilot 订阅(或学生/开源开发者免费资格)。访问 github.com/settings/copilot 检查授权状态。
Q:扩展安装后没有任何反应?
尝试重启 VS Code。如果问题持续,前往 GitHub Issues 提交反馈,附上 VS Code 输出面板中的错误日志。
连接与配对
Q:扫码配对失败怎么办?
请确认:
- 手机与电脑处于同一网络(初次配对仅需互联网连接,Relay 服务器在云端)
- VS Code 中 Cooder 扩展显示为"已连接"状态
- 手机摄像头能清晰扫描到二维码
补充:PWA 与客户端都需要相机权限用于扫码登录、配对与支付。
或改用手动输入 Relay URL 与 Token 的方式配对。
Q:App 显示设备离线?
可能原因:VS Code 关闭、网络中断、或长时间未操作导致连接超时。重新打开 VS Code 并执行Cooder: 重新连接命令即可恢复。
Q:可以同时连接多台电脑吗?
可以,每台电脑作为一个独立设备在 App 中管理,设备数量上限取决于你的套餐。
Agent 行为
Q:Agent 执行到一半停下来了?
可能原因:
- 遇到需要你决策的问题(Agent 等待你的追加指令)
- 达到单次对话最大轮数限制(默认 20 轮)
- 网络中断
在手机 App 中查看最后一条日志,通常会有说明。可以发送追加指令让 Agent 继续,或点击重新开始。
Q:Agent 修改了我不希望修改的文件怎么办?
Cooder 不会自动提交 Git。你可以用 git diff 查看所有改动,用 git checkout 撤销不需要的修改。建议在开始重要任务前先 commit 当前工作,方便回滚。
Q:可以让 Agent 使用特定的 AI 模型吗?
Model 选择由 GitHub Copilot 控制。Copilot Chat 当前选定的模型即为 Agent 使用的模型,在 Copilot 面板切换即可。
计费与账号
Q:Free 套餐有什么限制?
Free 套餐支持 1 台设备、1 个并发 Agent、无限次使用,对话历史仅保存在本地(不同步到云端)。
Q:如何查看当前套餐?
在手机 App 左侧栏底部点击头像,可查看当前账号的套餐和配额信息。
Q:订阅后可以退款吗?
定价方案尚在完善中,正式上线后退款政策会在购买页面明确说明。
Q:如何注销账号?
在 App 设置 → 账号管理 中可申请注销。注销后账号数据将在 30 天内完全删除。
更多帮助
如果以上内容没有解决你的问题,请通过以下渠道获取支持:
- GitHub Issues — 提交 bug 或功能建议
- 邮箱支持:rainfu@outlook.com
- App 内反馈 — 设置 → 关于我们 → 发送反馈(需验证邮箱)
