AI 代码调试系统使用文档

欢迎使用 AI 代码调试系统。本页面用于说明常用功能、使用流程和注意事项。

1. 登录系统后进入“代码调试”。
2. 填写问题标题、题目描述、代码和评测结果。
3. 选择可用模型，如有需要可开启深度思考或联网搜索。
4. 可上传截图、图片或 PDF 作为补充材料。
5. 提交后系统会调用 AI 生成分析结果，并扣除对应积分。
6. 分析完成后可进入记录详情查看结果、继续追问或创建分享链接。

代码调试用于让 AI 分析题目、代码和评测结果。

建议填写内容：

• 标题：简短描述问题。
• 题目描述：说明预期行为、输入输出、限制条件。
• 代码：粘贴需要分析的完整代码。
• 评测结果：粘贴报错、运行结果、错误用例或 OJ 反馈。
• 附件：可上传图片、截图或 PDF。

图片处理说明：

• 支持 PNG、JPG、GIF、WebP。
• 题目描述中的 Markdown 图片也会尝试读取。
• 支持图片的模型会直接接收图片。
• 不支持图片的模型会尽量通过 OCR 文本补充上下文。

记录详情页支持继续追问。

追问会带上：

• 原始题目
• 原始代码
• 初始 AI 分析
• 历史追问和回答
• 原始图片或 PDF 上下文

注意事项：

• 追问按模型价格的一部分计费，最低 1 积分。
• 多轮追问会保存上下文。
• 如果原始记录包含图片，新记录会在追问时继续携带图片上下文。
• 老记录如果没有保存图片内容，无法自动恢复已上传图片。

在记录详情页可以创建分享链接。

分享页会展示：

• 题目
• 代码
• 评测结果
• AI 分析结果
• 追问记录

分享链接可设置有效期，也可创建长期有效链接。

积分用于代码分析和追问。

常见获取方式：

• 每日签到
• 邀请好友
• 兑换码
• 管理员发放

积分历史页面可以查看收入和支出明细。

模型状态检测用于查看各 AI 模型是否可用。

功能说明：

• 所有登录用户都可以访问状态页。
• 系统会缓存模型检测状态。
• 检测使用最短消息 hi，减少 token 消耗。
• 检测支持失败重试。
• 管理员可以一键刷新全部模型。
• 每个模型也支持单独刷新。
• 历史状态保留约 1 个月，并以日历方式展示。

常见状态：

• 可用：模型正常响应。
• 不可用：请求失败、上游限流、鉴权失败或返回异常。
• 未知：还没有检测记录。

用户可以通过工单中心提交问题。

工单适合反馈：

• 账户问题
• 积分问题
• 模型异常
• 使用问题
• Bug 反馈

管理员可以在后台回复和关闭工单。

系统公告用于展示站内通知、更新说明和维护信息。

侧边栏中的“系统公告”入口会进入公告页面。

系统支持接入 Chatwoot 客服。

管理员可在后台配置：

• Chatwoot 地址
• Website Token
• 客服模式
• AI 客服入口
• 人工客服入口
• 默认欢迎消息

说明：代码侧提供入口和默认消息；AI 客服或人工分配需要在 Chatwoot 后台继续配置。

管理员后台可管理：

• 用户
• 积分
• 模型和供应商
• 系统设置
• 公告
• 工单
• 兑换码
• 商店/权益

权限说明：取消管理员权限后，旧会话会在下次请求时同步失效。

先查看错误提示。如果是模型状态异常，可进入模型状态检测页单独刷新对应模型。

系统已兼容普通 JSON 和 data: 开头的 SSE 流式响应。如果仍失败，请查看返回信息，常见原因包括上游限流 429、模型名错误、Key 无权限或中转站异常。

新记录会保存图片上下文并在追问时复用。旧记录如果创建时没有保存图片内容，需要重新提交一次带图分析。

1. 先用模型状态检测确认模型可用。
2. 提交代码分析时尽量提供完整题目、代码、错误信息和截图。
3. 阅读 AI 分析后再追问具体细节。
4. 需要他人协助时创建分享链接。
5. 遇到系统问题时提交工单。

本文档会随着系统功能更新持续维护。