AI 代码调试系统使用文档

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

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

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

建议填写内容：

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

图片处理说明：

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

代码调试页提供 OJ 数据导入能力，可用于快速填充题目、评测记录和提交代码。

支持平台：

• VJudge
• 洛谷
• Hydro

使用方式：

1. 进入“代码调试”。
2. 在“OJ 数据导入”区域选择平台，或保持“自动识别”。
3. 填写题目链接 / ID，例如 `P1001`、`HDU-1000`、`CodeForces-1095F`、`cf-1095F`、`洛谷-P9218`。
4. 如需导入提交记录，填写评测记录链接或记录号，例如 VJudge 的 `solution` 编号、洛谷记录号、Hydro record 链接。
5. 点击“开始导入”，系统会将可解析内容自动填入标题、题面、代码和评测结果。

• 公开题面通常不需要 Cookie。
• VJudge 读取私有提交代码通常需要 `JSESSIONID`；如果遇到 Cloudflare 拦截，再补充 `cf_clearance`。
• 洛谷读取自己的提交源码通常需要 `__client_id` 和 `_uid`，其他 Cookie 有就补充。
• Hydro 只需要当前 Hydro 站点下的 `sid` 和 `sid.sig`。
• Cookie 仅随本次导入请求转发，不保存到服务器配置。

• VJudge 的洛谷题目 ID 请使用 `洛谷-Pxxxx`，系统也兼容 `lg-Pxxxx` / `Luogu-Pxxxx` 并会自动转换。
• VJudge 提交记录会通过 `solution/data/{runId}` 读取评测信息。
• 如果返回代码未公开，需要填写提交者账号的有效 Cookie，且该账号必须有查看源码的权限。
• 如果目标 OJ 返回登录跳转或权限不足，请重新复制对应站点当前域名下的 Cookie。

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

追问会带上：

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

注意事项：

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

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

分享页会展示：

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

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

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

常见获取方式：

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

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

侧边栏已新增“充值”入口，点击后会在新窗口打开爱发电商品页：

• https://ifdian.net/item/b885f22c7b7f11f1a63f52540025c377

如果充值后积分没有及时到账，请保存支付记录并通过“工单中心”联系管理员处理。

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

功能说明：

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

常见状态：

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

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

工单适合反馈：

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

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

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

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

系统支持接入 Chatwoot 客服。

管理员可在后台配置：

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

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

管理员后台可管理：

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

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

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

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

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

1. 先用模型状态检测确认模型可用。
2. 提交代码分析时尽量提供完整题目、代码、错误信息和截图。
3. 如果题目或提交记录来自 OJ，可优先使用 OJ 数据导入减少手动粘贴。
4. 阅读 AI 分析后再追问具体细节。
5. 需要他人协助时创建分享链接。
6. 遇到系统问题时提交工单。

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