给文科生的AI蓝皮书

目录 AI蓝皮书reference 1 安装Codex2 安装Codex Desktop（强烈推荐）...........................2 AGENTS.md规则说明 4 AGENTS.md到底解决什么问题............................4它不只对Codex有用.................................5AGENTS.md不是百科全书..............................5好规则要能挡住一次翻车................................6根目录和项目目录可以分层...............................7哪些内容适合写进去..................................7哪些内容不要写进去..................................8一个实用写法：先写短，再慢慢长...........................9Karpathy式示范AGENTS.md .............................10 数字简谱示例13 一段《小星星》....................................13可以这样交给Codex ..................................13验收时看三件事....................................14进阶《起风了》（80bpm）...............................14 几种使用入口怎么选..................................16对话窗口里的实用功能.................................17分叉怎么用......................................17任务进行中怎么补充要求................................18侧边对话怎么用....................................19右侧侧边栏怎么看...................................20新建任务时，本地、工作树、云端怎么选........................21Git保存点怎么用...................................24 内置终端怎么用....................................25内置浏览器怎么用...................................26浏览器操作怎么用...................................27电脑操作怎么用....................................28图片输入怎么用....................................29图片生成怎么用....................................29自动化怎么用.....................................30MCP、插件、连接器怎么用..............................32权限提示怎么看....................................34联网搜索怎么用....................................35非代码文件怎么交给Codex..............................35这份速查怎么用....................................36 插件怎么安装和启用..................................38 推荐一：Gmail....................................39推荐二：Google Drive .................................40推荐三：Google Calendar ...............................41推荐四：Slack .....................................42推荐五：Notion....................................43推荐六：GitHub....................................45推荐七：Documents ..................................46推荐八：Spreadsheets................................47推荐九：Presentations................................49选插件的顺序.....................................50使用插件前的通用提示词................................51 PDF编辑器技术方案说明52 先把它想成一个软件工地................................52桌面外壳：Electron..................................53界面开发：React + TypeScript .............................53PDF页面预览：Mozilla PDF.js .............................54PDF实际处理引擎：MuPDF / MuPDF.js........................54打包安装：Electron Forge...............................55为什么不是一个工具包全包了..............................56你作为新手需要判断什么................................56 AI蓝皮书reference 这里收录的是主线课程之外的补充资料。 它们不是新的主线课程，而是给读者在安装、规则理解、素材测试、功能查阅、插件选择和技术名词理解时使用的参考页。阅读时可以按需要跳转，不必从头读到尾。 安装Codex Codex是OpenAI官方推出的开源编程助手，可以帮你编程写代码、处理日常的工作，甚至能直接操作你的电脑。 目前Codex提供了三种安装方式： •Codex Desktop：图形界面客户端，使用体验最好，个人推荐用这个 •Codex CLI：命令行客户端，灵活轻量，适合喜欢在终端开发的用户 •VSCode插件：直接在VSCode侧边栏唤起Codex对话面板，适合喜欢用vscode的用户任意安装方式的使用效果都是一样的，按自己的需求来安装即可。 所有安装方式共用同一份配置（都读~/.codex/目录下的配置文件），所以根据自己的喜好任选一个或多个安装即可。 安装Codex Desktop（强烈推荐） 在官网下载即可：https://openai.com/zh-Hans-CN/codex/get-started/ 网络需要读者自己搞定。 我个人感觉Codex Desktop使用体验比Codex CLI好，而且也更适合新手，所以推荐使用Codex Desktop。 安装完成后启动Codex Desktop会看到登录界面。 用你的ChatGPT账号登录，或者用Google邮箱登录都可以。 Codex给免费用户也提供了一定的使用额度，对于学习蓝皮书来说基本够用。 等你需要的时候再升级付费订阅就行了。 如果需要订阅，可以看这个文章：https://laowtzhou.github.io/happy-with-the-great-models.html AGENTS.md规则说明 如果你只把Codex当成一个聊天窗口，那你每次都要重新交代背景、边界和要求。 但如果你开始把它当成一个会进入项目目录、阅读文件、修改代码、整理资料的AI Agent，就会遇到一个很现实的问题：它怎么知道这个项目的规矩？ AGENTS.md就是为这个问题准备的。 它不是写给读者看的说明书，也不是写给老板看的项目介绍。它更像一张贴在项目门口的工作规矩：任何AI Agent进来干活以前，都应该先看一眼。 AGENTS.md到底解决什么问题 AI Agent很能干，但它有一个天然问题：它不知道你的项目“哪些地方不能碰”。 你让它“优化一下”，它可能顺手重构。 你让它“修一个小问题”，它可能顺手升级依赖。 你让它“整理一下文档”，它可能把你刚刚删掉的内容又补回来。 你让它“做得完整一点”，它可能把一个小工具扩成一个平台。 这些问题不一定是AI故意添乱。很多时候，它是在按照“把事情做完整”的方向努力。可真实项目里，做完整不等于做对。边界、历史、协作习惯、风险等级，往往比“多做一点”更重要。 AGENTS.md的作用，就是把这些长期规则提前写下来。 它告诉AI Agent： 1.这个项目是做什么的。2.当前最重要的边界是什么。3.哪些文件不能乱动。4.哪些行为必须先问人。5.修改以后怎样验收。 6.什么情况宁可停下来，也不要自作主张。 简单说，提示词管这一次任务，AGENTS.md管这个项目里的长期做事方式。 它不只对Codex有用 虽然这本书主要用Codex做案例，但AGENTS.md的思路不只适用于Codex。 只要一个AI工具开始具备Agent能力，它就会遇到类似问题：它能读文件、改文件、运行命令、创建内容、调用工具。能力越强，越需要项目级规则。 不同工具读取规则文件的名字可能不同。有的读AGENTS.md，有的读CLAUDE.md。 你不需要一开始就记住所有名字。你先理解这个核心思想： AI Agent需要一份稳定的项目上下文。 这份上下文不应该每次都靠你临时复制到聊天框里。临时提示词适合写“这次要做什么”，项目规则文件适合写“在这里一直要怎么做”。 AGENTS.md不是百科全书 很多人第一次写AGENTS.md，容易把它写成项目百科。 比如把项目背景、产品规划、用户画像、技术架构、所有目录说明、未来想法，全都塞进去。 这不是不能写，但要小心。 AGENTS.md最重要的不是“信息多”，而是“能改变AI的行为”。如果一条内容不会影响AI做事，它就不一定应该放在这里。 比如下面这些话，看起来很正确，但用处不大： ‐请认真完成任务。‐请保持专业。‐请写得高级一点。‐请尽量做得完整。 它们太虚。AI看了以后，仍然不知道具体该做什么、不该做什么。 更有用的是这种规则： ‐用户说只排版时，不扩写、不改写、不恢复旧内容。‐修改前先说明影响范围，涉及删除、移动、重命名时必须等待确认。‐不要引入新的外部依赖，除非用户明确同意。‐代码修改完成后，必须说明如何验证结果。 这些话会直接改变AI的动作。 好规则要能挡住一次翻车 判断一条规则有没有用，可以问自己一句话： 它能不能挡住一次真实翻车？ 比如你曾经遇到过AI把你删掉的段落又补回来，那就写： ‐当前文件内容是唯一有效基线。用户已经删除的内容，不要自动恢复。 比如你遇到过AI修一个按钮，顺手重构了全项目，那就写： ‐优先做最小改动。能局部修改，就不要重构全项目。 比如你遇到过AI把本地工具改成依赖在线接口，那就写： ‐本项目默认本地运行。不要引入线上服务、云端接口或上传流程，除非用户明确要求。 比如你遇到过AI还没问清楚就开始改，那就写： ‐当目标不清楚、边界不清楚、可能影响已有成果时，先提问，不要直接动手。 好规则不是摆在那里好看