> ## Documentation Index
> Fetch the complete documentation index at: https://docs.study.faroapi.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 遇到问题，先看这里

> 按你看到的情况，找到登录、视频整理、内容缺失、积分和插件问题的处理方法。

先找到最接近当前情况的问题。任务还在处理或显示 **结果未确认** 时，先刷新状态，不要反复提交同一链接。

## 登录与开始使用

<AccordionGroup>
  <Accordion title="没有注册入口，或忘记密码了怎么办？">
    注册和邮件找回密码可以分别关闭。登录页没有对应入口时，当前就不能使用这条路径；已有账号仍可按页面提示登录。

    先看[注册、登录与找回密码](/account/login)。需要协助时，查看[当前反馈与联系入口](/help/contact)，不用反复创建账号来尝试。
  </Accordion>

  <Accordion title="链接为什么无法整理？">
    当前只支持公开可访问的 B 站视频链接或 BV 号，不包含登录、会员、付费、地区、私密或已下架内容。

    先在未登录 B 站的浏览器窗口中打开链接，确认仍可公开访问。使用单个视频的完整链接，回到工作台选择 **查看整理内容**。具体格式见[支持的视频与内容](/getting-started/supported-content)。
  </Accordion>

  <Accordion title="一定要安装 Codex 插件才能用吗？">
    不需要。网站本身可以整理视频、阅读字幕和评论、查看来源状态，以及使用已开放的 AI 整理。

    Codex 是额外的对话入口。第一次使用可以先完成[网站快速上手](/getting-started/web)，再决定是否连接。
  </Accordion>
</AccordionGroup>

## 任务与结果

<AccordionGroup>
  <Accordion title="一直排队或处理中，任务是不是卡住了？">
    进入 **任务记录**，选择 **刷新**，再打开对应任务的 **查看详情**。处理中不等于失败，当前没有适用于所有视频的固定完成时间。

    状态长期没有变化时，保留任务编号、开始时间和错误文字，按[反馈说明](/help/contact)处理。不要用重复提交来检查进度。详见[任务记录](/workspace/tasks)。
  </Accordion>

  <Accordion title="显示“需检查”“部分完成”或“结果未确认”，该怎么办？">
    **需检查／部分完成**：先去资料库搜索标题或 BV 号，查看已经保存的部分和 **来源状态**。内容缺失不等于整份资料都不能用。任务已经结束且详情提供重试时，再按风险提示决定是否重试。

    **结果未确认**：先刷新并核对已有结果，不要立刻再提交一遍。它不等于肯定失败。

    [看懂这些状态和重试方式](/workspace/tasks)。
  </Accordion>

  <Accordion title="任务结束了，但资料库找不到视频？">
    先确认任务类型是 **视频整理**，清除资料库旧搜索条件，改用 BV 号查找，并确认登录的是同一账号。AI 分析不会另建一条视频资料。

    按[查找资料的检查顺序](/library/manage)处理；任务已结束仍找不到时，再反馈任务编号和 BV 号，不必先删除或重新整理。
  </Accordion>

  <Accordion title="为什么没有字幕、评论为空，或只显示一部分？">
    已有内容可能需要选择 **继续读取字幕／评论** 才能往下看。没有内容时，先分清来源显示 **没有可用内容** 还是 **获取失败**。

    当前正常网站和 Codex 整理流程不会自动下载音频转写。评论为空，也不能直接证明没有人讨论。

    [按当前情况处理缺失内容](/help/missing-content)。
  </Accordion>

  <Accordion title="AI 总结可以直接当作事实吗？">
    不可以。AI 依据已经取得的资料组织回答，不是独立事实核查。先区分字幕、观众评论和 AI 归纳，再搜索原话、打开已有时间点核对。不是所有生成文字都有时间点。

    [学习如何核对原话和来源](/library/read-evidence)。
  </Accordion>
</AccordionGroup>

## 积分与数据

<AccordionGroup>
  <Accordion title="视频整理消耗了积分，但任务失败了怎么办？">
    先等任务结束，再进入 **使用记录**，按任务编号或 BV 号查找这一条视频，核对费用或 **已退回** 标记。处理中或结果未确认时，先刷新，不要为了核对积分再提交任务。

    使用记录只覆盖视频整理，不能查齐 AI 整理、总结图和奖励等全部额度变化。记录与最终结果不一致时，保留对应时间和任务信息，按[积分与使用记录说明](/billing/credits-and-usage)处理。
  </Accordion>

  <Accordion title="钱包有钱，为什么还是积分不足？自动 AI 也会消耗吗？">
    人民币钱包与整理积分不是同一个额度，钱包不会自动补积分。AI 整理和总结图优先使用每月赠送的 AI 次数，用完后再使用整理积分。

    网站开放 AI 时，未保存过偏好的浏览器默认开启完成后自动生成。只想保存原始资料，可以在 **个人设置** 关闭 **整理完成后自动生成 AI 整理**。[查看消耗与关闭方法](/billing/credits-and-usage)。
  </Accordion>

  <Accordion title="怎样导出或删除资料？">
    账号菜单 → **个人设置** → **导出资料**，会下载账号与学习资料的 JSON 文件。删除单份资料时，从资料详情选择 **删除资料**，先读清影响范围再确认。

    导出不等于已经建立可一键恢复的备份，删除也没有恢复按钮。[先看导出和删除的完整说明](/account/data-controls)。
  </Accordion>
</AccordionGroup>

## Codex 插件

<AccordionGroup>
  <Accordion title="安装命令提示找不到 codex 或 python3？">
    安装脚本需要 Codex 命令行工具；macOS 和 Linux 还需要 Python 3。仅安装 Codex 桌面应用，不代表终端能运行这些命令。

    先完成[安装前检查](/connect-ai/install-codex)，再从解压后的插件包目录执行命令，不要重复安装到不同文件夹。
  </Accordion>

  <Accordion title="安装成功，为什么新对话仍没有 Open Study？">
    安装或更新后要新建 Codex 任务，原任务不会自动载入新插件。确认插件列表里有 `open-study` 且已启用。

    如果提示重复来源或旧 `bilistudy`，先看[更新与连接问题](/connect-ai/update-troubleshoot)，不要直接删除旧文件夹。
  </Accordion>

  <Accordion title="装了插件，为什么还显示未连接，或资料库为空？">
    安装和连接账号是两件事。新任务里让 Codex 检查 Open Study 连接，按提示在本站登录并选择 **允许连接**，然后查询已有资料。

    要确认它实际调用了 Open Study 并收到查询结果，不是只口头说“已连接”。真实查询返回空资料库也是正常结果；再确认网站与 Codex 使用同一账号。[按顺序检查连接](/connect-ai/update-troubleshoot)。
  </Accordion>

  <Accordion title="GitHub 安装不了，离线包怎么更新？">
    插件仓库仍处于私有预览，只有已授权的 GitHub 账号能使用 GitHub 安装。普通用户优先在网站 **连接 AI** 页面下载离线包。

    GitHub 更新器不能直接替换离线安装。当前没有已经验证的一键离线升级流程；不要搬走旧目录或照搬 GitHub 命令。网站服务更新通常也不需要重装插件。[按原安装方式查看更新说明](/connect-ai/update-troubleshoot)。
  </Accordion>
</AccordionGroup>

## 仍然无法解决

先记下发生时间、网站还是 Codex、任务编号或 BV 号、页面状态和错误文字。然后按[反馈问题需要准备什么](/help/contact)整理信息；不要公开发密码、授权链接、密钥或整份私人资料。

<Card title="不知道从哪里开始？" icon="rocket" href="/getting-started/web">
  从登录、粘贴链接到找到结果，按网站快速上手重新核对操作顺序。
</Card>