反馈与排障信息模板

适用对象：配置 Agent 工具遇到问题，需要向连接AI求助的用户。

预计耗时：3-5 分钟。

先读安全提醒

提交反馈前，建议先看 安全与隐私。

不要发送这些信息

不要发送完整 API Key、Token、Cookie、SSH Key、服务器登录信息、私人项目代码或完整 .env 文件。

可以发送：

• API Key 前 4 位和后 4 位。
• 报错截图，但要遮挡密钥和邮箱。
• 工具名称、系统、模型名、Base URL 是否带 /v1。

快速反馈模板

复制下面模板，填好后发给连接AI：

【问题类型】
例如：401、404、连接超时、模型不存在、CC Switch 切换不生效

【使用的系统】
例如：Windows 11 / macOS / Linux / WSL

【使用的工具】
例如：Claude Code / Codex / DeepSeek Harness / WorkBuddy / OpenCode / Pi / CC Switch

【工具版本】
例如：codex --version 输出，或应用的版本号

【Base URL 是否带 /v1】
例如：带 /v1 / 不带 /v1 / 不确定

【模型名】
例如：你实际选择的完整模型 ID

【API Key 前后几位】
例如：前 4 位 xxxx，后 4 位 yyyy
不要填写完整 API Key

【完整错误信息】
粘贴错误文字，或上传已遮挡敏感信息的截图

【你已经试过什么】
例如：核对 Key、模型及该工具的接口地址，重启工具或换网络

【发生时间】
例如：2026-08-27 10:30

截图脱敏检查

截图前检查：

• API Key 已遮挡。
• 邮箱已遮挡。
• 用户名已遮挡。
• 项目路径已遮挡。
• 服务器地址和后台地址已遮挡。
• 截图中没有私人代码。

常见问题对应信息

现象	额外提供
401	API Key 前后几位、是否重新复制过
403	使用的工具、发生时间
404	Base URL 是否带 /v1
429	发生时间、模型名
连接超时	网络环境、是否使用代理
模型不存在	完整模型名
CC Switch 不生效	是否重启目标 CLI 工具

完成检查

• 没有发送完整 API Key。
• 已说明系统和工具名称。
• 已说明 Base URL 是否带 /v1。
• 已提供模型名和错误信息。
• 截图已经脱敏。