给第一次使用 Codex 和 Obsidian 写毕设的人

Codex + Obsidian 论文提效教程

别把 AI 当枪手。把它当一个永远在线的论文助教：它先读你的材料，再帮你拆问题、搭结构、写初稿、查漏洞。真相先进文件夹，论文才会变快。

Codex 不是论文代写器 它必须先看到你的任务书、文献、实验记录和格式要求。没有证据，只能写空话。
Obsidian 不是网盘 它是你的证据仓库。每条结论都要能回到原始材料、文献笔记或实验数据。
正确顺序 材料进文件夹，证据进笔记，Codex 先盘点再写。不要跳过盘点。

0. 先看路线图

你要完成的不是“装几个软件”。你要搭一个论文生产系统。它只有七步。

1下载 Codex App，不装 CLI。
2下载 Obsidian，把毕设文件夹当 vault。
3下载 Chrome，用来访问 GitHub 和配置工具。
4搜索 cc-switch，下载安装到电脑。
5在 cc-switch 填入 sub2api 的 URL 和 key。
6把毕设文件夹设置成 Codex 项目。
7安装 Skills，用提示词写出可审查的初稿。
完成标志：Codex 能看到你的毕设文件夹，Obsidian 能打开同一个文件夹，cc-switch 当前 provider 已启用，Codex 能根据本地材料回答“我的论文现在缺什么”。

1. 安装三件套

先装基础工具。顺序不要乱。先把入口装干净，再谈写论文。

1.1 下载 Codex App

打开 OpenAI 的 Codex 页面，下载桌面版 Codex App。这里明确一点：本教程使用 Codex App，不要求安装 Codex CLI。

  • macOS：下载并打开 Codex App，登录 ChatGPT 账号。
  • Windows：下载 Windows 版本 Codex App，登录 ChatGPT 账号。
  • 不要从陌生网盘下载，不要跟着命令行教程装 CLI。

1.2 下载 Obsidian

Obsidian 用来管理论文材料。它直接读取本地文件夹里的 Markdown 文档，所以你的资料不会被锁死在某个网页工具里。

1.3 下载 Chrome

Chrome 用来访问 GitHub、下载 cc-switch、打开 Cloudflare 或其他配置页面。如果电脑已经有 Chrome，可以跳过安装。

工具 作用 下载入口 不要做什么
Codex App 让 AI 直接读取和修改你的毕设项目文件夹。 OpenAI Codex 不要装 CLI 当主入口。
Obsidian 把文献、任务书、实验记录变成可追踪的证据库。 Obsidian Download 不要只把它当文件预览器。
Chrome 下载工具、查资料、登录配置页面。 Google Chrome 不要从第三方下载站装捆绑包。
cc-switch 统一管理 Codex 等工具的模型服务地址和 key。 GitHub Releases 不要把 key 发到群里或写进论文项目。

2. 配置 cc-switch

cc-switch 的价值很简单：不要手改配置文件。用一个界面把模型服务地址和 key 填好，再让 Codex 使用它。

2.1 下载 cc-switch

  1. 打开 Chrome。
  2. 搜索 cc-switch。
  3. 进入 GitHub 仓库 farion1231/cc-switch。
  4. 打开 Releases，下载适合你电脑系统的安装包。

2.2 添加 sub2api provider

  1. 打开 cc-switch。
  2. 选择 Codex 对应的 provider 配置。
  3. 点击 Add Provider 或新建自定义 provider。
  4. 把服务地址填成 <SUB2API_BASE_URL>。
  5. 把密钥填成 <SUB2API_KEY>。
  6. 保存并启用这个 provider。
  7. 重启 Codex App，让配置生效。
密钥规则：教程里只出现占位符。每个人拿自己的 key。不要把真实 key 写进 Obsidian、AGENTS.md、论文文件夹、截图、微信群或网页。

2.3 常见错误

现象 通常原因 处理方式
401 或 Unauthorized key 填错、复制时多了空格、key 过期。 重新复制 key，只保留纯文本；仍失败就换新 key。
403 或 Forbidden key 没有权限或额度不可用。 确认账号权限、套餐状态和模型访问范围。
Codex 还是用旧配置 provider 没启用，或 Codex 没重启。 在 cc-switch 确认当前 provider，再完全退出并重开 Codex。
模型能聊但不能读文件 你没有把毕设文件夹设成项目。 回到 Codex 项目设置，选择正确的本地文件夹。

3. 建立毕设项目

所有人都用同一种文件夹结构。结构统一，后面才好教学、排错、互相复盘。

3.1 推荐目录

我的毕设/
  论文正文/
  文献笔记/
  数据与实验/
  图片表格/
  输出版本/
  任务书.md
  开题报告.md
  AGENTS.md

3.2 在 Obsidian 中打开

  1. 打开 Obsidian。
  2. 选择 Open folder as vault。
  3. 选择你的 我的毕设 文件夹。
  4. 新建 文献笔记/文献矩阵.md 和 论文正文/初稿计划.md。

3.3 在 Codex 中打开

  1. 打开 Codex App。
  2. 新建 Project 或选择 Add local folder。
  3. 选择同一个 我的毕设 文件夹。
  4. 新建一个 thread，先让 Codex 盘点文件，不要直接写正文。
完成标志：你问 Codex“请列出当前项目文件和论文材料缺口”，它能说出 任务书.md、开题报告.md、论文正文、文献笔记 这些真实路径。

4. 安装 Skills

Skills 是 Codex 的工作方法。没有 Skills，Codex 很容易变成一个会写漂亮废话的聊天框。有了 Skills，它会按流程做事。

4.1 推荐安装

  • Superpowers：用于头脑风暴、写计划、执行计划、调试、代码审查、完成前验证。
  • find-skills：用于搜索和安装更多技能。先学会找技能，再谈扩展。
  • Obsidian 相关 Skills：在 Skills 页面搜索 obsidian；如果老师提供 ZIP 或 GitHub 链接，就按提供的入口安装。
边界：这里不编造某个固定的 Obsidian skill 来源。每个班级、每台电脑、每个 Codex 版本可能显示不同。以你 Codex App Skills 页面和老师提供的链接为准。

4.2 安装后的检查

  • Codex 插件或 Skills 页面能看到 Superpowers。
  • 能搜索到 find-skills 或同等技能搜索入口。
  • Obsidian 相关技能已安装，或已经拿到老师提供的安装包。
  • 新 thread 中能要求 Codex “先使用计划模式拆解任务”。

5. 论文初稿工作流

论文初稿不是从第一章第一句话开始写。那是最慢的路。正确顺序是证据先行。

5.1 第一轮：材料盘点

让 Codex 读文件夹，列出已有材料、缺失材料和不能写的内容。不要让它直接写“研究背景”。

5.2 第二轮：论文骨架

把任务书、开题报告、老师要求、学校模板喂给 Codex，让它给出章节结构和每章证据需求。

5.3 第三轮：文献矩阵

每篇文献至少记录：研究对象、方法、数据、结论、局限、和你论文的关系。没有文献矩阵，综述会变成堆摘要。

5.4 第四轮：章节初稿

只写已经有证据支撑的段落。缺数据就标缺数据，缺实验就标缺实验，缺文献就标缺文献。

5.5 第五轮：审稿式自查

让 Codex 扮演严厉审稿人，检查问题是否清楚、缺口是否真实、贡献是否可见、证据是否闭环。

6. 可复制提示词

下面这些提示词可以直接复制到 Codex。第一次用的人，不要自由发挥。先按模板跑通一遍。

提示词 1：项目盘点 
请先不要写论文正文。

你现在是我的毕设项目助教。请读取当前项目文件夹，完成一次“论文材料盘点”：
1. 列出你能看到的关键文件和文件夹。
2. 判断这些材料分别支持论文的哪些部分。
3. 列出目前不能写、不能下结论、不能编造的内容。
4. 给出下一步我必须补充的材料清单。

输出要求：
- 只依据当前项目里真实存在的材料。
- 不要编造文献、数据、实验结果或老师要求。
- 缺什么就直接写“缺失”。
提示词 2：论文大纲 
请根据当前项目中的任务书、开题报告、已有文献笔记和学校格式要求，设计我的毕设论文大纲。

请按以下逻辑输出：
1. 论文核心问题是什么。
2. 研究缺口是什么。
3. 我的方法或设计要解决什么问题。
4. 每一章的章标题、核心论点、需要的证据。
5. 哪些章节现在可以写初稿，哪些章节必须等补充材料。

硬性要求：
- 不要写成泛泛的模板。
- 每一章都要说明“证据来源”。
- 没有证据的地方必须标注“待补充”，不要替我编。
提示词 3：文献矩阵 
请帮我建立“文献矩阵”，用于写论文综述。

请读取项目中的文献笔记或 PDF 摘要，按表格整理：
1. 文献题名
2. 研究对象
3. 方法
4. 数据或实验场景
5. 主要结论
6. 局限
7. 和我的毕设题目的关系
8. 适合放在论文哪一节

要求：
- 只整理你能看到的文献。
- 看不到全文就标注“仅基于摘要/文件名/已有笔记”。
- 不要伪造 DOI、作者、年份或结论。
提示词 4：章节初稿 
请为我的论文写【替换成章节名】初稿。

写作前请先列出：
1. 本章要回答的核心问题。
2. 当前项目中可用的证据。
3. 本章不能写或需要标注缺失的内容。

然后再写正文。

写作要求：
- 用正式、克制的学术中文。
- 每段围绕一个论点，按“论点 -> 证据 -> 分析”推进。
- 不要使用夸张词，不要写空泛意义。
- 没有数据、没有实验、没有文献支撑的地方，用【待补充：原因】标出。
提示词 5：审稿式自查 
请像严格的毕业论文评阅老师一样审查我的当前论文草稿。

请按以下维度给出问题清单：
1. 核心问题是否清楚。
2. 研究缺口是否真实。
3. 方法或设计贡献是否可见。
4. 证据链是否闭环。
5. 是否存在编造、过度承诺或没有依据的表述。
6. 哪些段落需要重写，哪些只需要补证据。

输出要求：
- 先列严重问题，再列一般问题。
- 每个问题要指出对应章节或文件位置。
- 不要安慰我。只说真实问题和修改动作。

7. 排错与验收

7.1 你是否真的跑通了

  • Codex App 已安装，并且不是 CLI 界面。
  • Obsidian 打开的是你的毕设文件夹。
  • Chrome 能访问 cc-switch GitHub Releases。
  • cc-switch 已启用 sub2api provider。
  • Codex 项目路径就是你的毕设文件夹。
  • Codex 能说出项目里真实存在的任务书、文献笔记或实验材料。
  • 至少跑过一次“项目盘点”提示词。
  • 第一章初稿中没有编造数据和文献。

7.2 不要犯的错

  • 不要把真实 key 截图发给别人。
  • 不要让 Codex 在没看材料前直接写完整论文。
  • 不要把文献综述写成“某某提出了某方法”的流水账。
  • 不要把 Obsidian 变成垃圾箱。每条笔记都要服务论文结构。
  • 不要让 AI 替你下没有实验支撑的结论。

参考来源

本教程使用官方或项目主页作为入口，不使用第三方下载站。核心参考包括： OpenAI Codex getting started、 Codex App announcement、 Obsidian Download、 Google Chrome Help、 cc-switch GitHub、 Cloudflare Pages Direct Upload。