苹果社区

苹果社区 - mc服务器

用户工具

站点工具


docs:aidebug:start

AI 代码调试系统使用文档

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

快速开始

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

代码调试

代码调试用于让 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 无权限或中转站异常。

追问为什么不理解图片?

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

建议使用流程

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

更新维护

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

docs/aidebug/start.txt · 最后更改: admin