> ## 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.

# 在 Codex 中整理和查询资料

> 新建 Codex 任务，发送公开 B 站链接，等待 Open Study 返回最终资料。

插件加载并完成 OAuth 后，Codex 可以使用你的 Open Study 账号整理链接、查找资料、回看来源和继续学习。

## 第一次发送链接

<Steps>
  <Step title="新建 Codex 任务">
    安装或更新插件后必须新建任务。不要继续使用安装前已经打开的对话。
  </Step>

  <Step title="发送明确请求">
    发送一个公开 B 站链接，并写“请用 Open Study 整理这个视频”。
  </Step>

  <Step title="完成授权">
    如出现 Open Study 登录页，确认正式域名与权限后选择 **允许连接**。
  </Step>

  <Step title="等待最终结果">
    Agent 会在后台提交一次整理请求并等待网站给出的最终结果，不需要你手动反复查询。
  </Step>

  <Step title="检查云端资料">
    回到 Open Study 网站，在资料库按标题或 BV 号查找，确认内容确实保存到同一账号。
  </Step>
</Steps>

## 直接复制这些请求

把方括号里的内容换成你自己的链接、标题或主题，再发送。它们是请求模板，不是已经执行过的整理结果。

### 整理一条新视频

<Prompt description="请用 Open Study 整理这个视频：【粘贴一个公开 B 站视频链接】。等网站返回最终结果后，给我三条核心要点和能核对的原话时间点。没有取得的内容请直接说明，不要补写。" actions={["copy"]}>
  请用 Open Study 整理这个视频：【粘贴一个公开 B 站视频链接】。
  等网站返回最终结果后，给我三条核心要点和能核对的原话时间点。没有取得的内容请直接说明，不要补写。
</Prompt>

### 从保存过的资料里找内容

<Prompt description="在我的 Open Study 资料库里，查找标题、作者或简介中与【填写主题】相关的视频。告诉我标题、BV 号和为什么相关。没找到就说没找到，不要自动整理新链接。" actions={["copy"]}>
  在我的 Open Study 资料库里，查找标题、作者或简介中与【填写主题】相关的视频。告诉我标题、BV 号和为什么相关。没找到就说没找到，不要自动整理新链接。
</Prompt>

资料库搜索不是所有视频字幕的全文搜索。先找到相关视频，再让 Codex 读取它的字幕；关键词过宽时，补充标题、作者或 BV 号会更容易定位。

### 把一份资料变成实践步骤

<Prompt description="请读取 Open Study 中【填写视频标题或 BV 号】的已保存资料。根据字幕，为我整理三个可执行步骤，每个步骤尽量附上原话时间点。视频里的说法、观众评论和你的补充建议请分开写；没有依据的地方直接标明。" actions={["copy"]}>
  请读取 Open Study 中【填写视频标题或 BV 号】的已保存资料。
  根据字幕，为我整理三个可执行步骤，每个步骤尽量附上原话时间点。视频里的说法、观众评论和你的补充建议请分开写；没有依据的地方直接标明。
</Prompt>

这类回答由 Codex 根据读到的资料组织，不代表已在网站生成或保存了一份新的 **AI 整理**。如果你要使用网站配置的 AI 服务，请明确提出，并先了解[网站 AI 功能的额度](/ai/organize)。

### 只讨论链接，不整理

<Prompt description="这个链接只是讨论示例：【粘贴链接】。不要整理它，不要创建新任务。我只想了解 Open Study 能从这种视频里取得哪些内容。" actions={["copy"]}>
  这个链接只是讨论示例：【粘贴链接】。不要整理它，不要创建新任务。我只想了解 Open Study 能从这种视频里取得哪些内容。
</Prompt>

当消息主要就是一个 B 站链接，或你明确要求整理、分析它时，Skill 会使用 Open Study。链接只是例子、讨论对象，或你明确说“不要整理”时，不应创建任务。

## 回答里应该看到什么

* 对应的是哪条视频、哪份资料；
* 你要的总结、要点或实践步骤；
* 能找到时提供原话时间点，并区分字幕与评论；
* 缺少的来源，以及它会怎样影响结论。

如果只回复“任务已提交”，可以让 Codex **继续查看这一个任务的结果，不要新建任务**。不需要重新发送链接启动另一遍。

## 积分和使用记录去哪里看

为了让流程简洁，正常整理不会在回答里展开价格预检、余额、缓存、调用日志或计费细节。积分和使用情况仍以 Open Study 网站为准。

## 失败或状态不明时

* Agent 不应自行重复提交失败任务；
* “结果未确认”时先让它刷新状态；
* 无字幕时当前不会自动下载音频转写；
* 需要核对时，让 Agent 给出资料标题、BV 号、已有时间点或来源状态。

如果旧版插件让你通过人民币钱包解决“积分不足”，请以[积分说明](/billing/credits-and-usage)和网站当前提示为准；人民币钱包不会替代整理积分。

## 怎样算整条链路成功

下面四项都满足，才算真实可用：

1. Codex 能识别并调用 Open Study；
2. OAuth 连接到正确的 Open Study 账号；
3. Agent 收到网站的最终结果，而不是只返回“任务已提交”；
4. 同一条资料能在网站资料库里找到并打开。

<Card title="插件更新或连接失败" icon="wrench" href="/connect-ai/update-troubleshoot">
  查看更新后插件没有出现、OAuth 未完成和来源冲突的处理方法。
</Card>