文科生拿到AI编程工具后最大的困境不是学不会，而是不知道从哪开始——安装完桌面应用后只会最简单的“帮我写”，不知道AGENTS.md能挡住翻车、不知道分叉和工作树的区别、不知道插件该怎么选、看不懂Codex规划PDF编辑器时冒出来的技术名词。这本Reference册就是为这些问题准备的。从安装配置到项目规则，从对话技巧到插件选择，再到PDF编辑器背后的技术名词拆解——它不是主线课程的复述，而是一套按需查阅的实操地图。

Codex是OpenAI官方推出的开源编程助手，个人强烈推荐Codex Desktop图形界面客户端，因为使用体验最好、更适合新手。官网下载安装后登录即可使用，免费用户也有一定额度。如果网络需要读者自己搞定。所有安装方式共用同一份配置（~/.codex/目录），可根据喜好任选。

AGENTS.md是给AI Agent看的项目工作规矩——任何AI Agent进项目干活以前都应该先看一眼。好规则要能挡住一次真实翻车，AGENTS.md最适合写五类内容：项目目标、不能破坏的核心功能、禁止行为、协作流程、验收方式。新手可以先写一个很短的版本，等项目推进再把真实踩过的坑补进去。

Codex四种使用入口各有适用场景。桌面应用适合做项目、看文件、改稿、做工具；命令行入口适合在终端快速处理；编辑器扩展适合边看代码边用；云端任务适合远端环境运行。分叉保护对话思路，适合尝试不同写法；工作树保护项目文件，适合大改动试错。新建任务时本地适合小改动，工作树适合大改动，云端适合远端执行。Git可理解为项目的保存点系统——改之前留存点、改完看改动、确认没问题提交。内置终端看运行结果，内置浏览器检查本地网页，浏览器操作让AI操作页面，电脑操作让AI操作桌面软件。

九款实用插件覆盖日常高频场景：Gmail读邮件、Google Drive翻云盘、Google Calendar整理日程、Slack总结群聊、Notion查知识库、GitHub看开源项目、Documents生成Word、Spreadsheets整理数据、Presentations做PPT。选插件不是越多越好，而是越精准越好。先装最刚需的一两个，不要一次装全。

PDF编辑技术方案中，Electron负责把网页变桌面软件，React+TypeScript负责界面，PDF.js负责预览（“看PDF的眼睛”），MuPDF负责实际处理（“动手处理PDF的工具箱”），Electron Forge负责打包。新手不需要判断技术栈谁更先进，需要判断的是：是否本地运行？是否把预览和修改分清楚？第一版是否先解决核心需求？是否先做可测试版本而不是一上来打包？

这份Reference不是主线课程的复述，而是给读者在实操中遇到问题时按需查阅的配套地图。建议顺序是：先熟悉Codex桌面应用、文件链接、内置终端；大改动前学会工作树或备份；做网页和工具时学会内置浏览器；做桌面软件时再用电脑操作；有周期任务时再学自动化；需要外部资料时再研究插件和连接器。真正有用的不是记住功能名，而是遇到问题时能判断：这个问题应该让AI用哪种能力来解决。

从安装配置到项目规则，从对话技巧到插件选择，从功能速查到技术名词拆解——当AI编程助手的能力边界、项目规则、对话技巧、工具生态和技术名词都被拆解成可查阅的参考页，文科生使用Codex就不再是碰运气，而是一步步按图索骥。这份Reference的价值不在于读完，而在于需要时能找到答案。