苹果社区

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

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

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

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

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

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

建议填写内容：

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

图片处理说明：

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

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

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

追问会带上：

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

注意事项：

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

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

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

分享页会展示：

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

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

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

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

常见获取方式：

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

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

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

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

功能说明：

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

常见状态：

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

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

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

工单适合反馈：

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

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

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

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

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

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

系统支持接入 Chatwoot 客服。

管理员可在后台配置：

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

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

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

管理员后台可管理：

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

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

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

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

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

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

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

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

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

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

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

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

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