苹果社区

本页面只读。您可以查看源文件，但不能更改它。如果您觉得这是系统错误，请联系管理员。
====== AI 代码调试系统使用文档 ======

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

===== 快速开始 =====

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

===== 代码调试 =====

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

建议填写内容：

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

图片处理说明：

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

===== OJ 数据导入 =====

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

支持平台：

  * VJudge
  * 洛谷
  * Hydro

使用方式：

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

==== Cookie 说明 ====

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

==== VJudge 注意事项 ====

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

===== 追问 AI =====

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

追问会带上：

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

注意事项：

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

===== 分享记录 =====

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

分享页会展示：

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

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

===== 积分系统 =====

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

常见获取方式：

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

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

==== 充值入口 ====

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

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

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

===== 模型状态检测 =====

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

功能说明：

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

常见状态：

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

===== 工单中心 =====

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

工单适合反馈：

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

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

===== 系统公告 =====

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

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

===== 客服功能 =====

系统支持接入 Chatwoot 客服。

管理员可在后台配置：

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

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

===== 管理员功能 =====

管理员后台可管理：

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

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

===== 常见问题 =====

==== AI 返回空内容怎么办？ ====

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

==== Grok 或中转站显示 JSON 格式错误怎么办？ ====

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

==== 追问为什么不理解图片？ ====

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

===== 建议使用流程 =====

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

===== 更新维护 =====

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