> **来源：[研报客](https://pc.yanbaoke.cn)** # 给文科生的 AI 蓝皮书 总结 ## 核心内容 《给文科生的 AI 蓝皮书》是一本面向非技术背景读者的参考手册，旨在帮助用户更好地理解和使用 AI 工具，如 Codex，进行项目协作、内容创作和文件处理。书中主要围绕以下内容展开： - **AI Agent 的使用规范**：通过编写 `AGENTS.md` 文件，定义项目规则，帮助 AI Agent 明确任务边界，防止误操作。 - **Codex 的使用方法**：介绍 Codex 的安装方式、功能使用、插件管理、权限处理等。 - **非代码文件的处理**：包括 PDF、Word、Excel、PPT、图片等文件的生成、编辑和整理。 - **协作与验收机制**：强调在使用 AI 工具时，如何确保修改符合预期，以及如何进行有效沟通和协作。 - **技术方案与工具选择**：讲解 PDF 编辑器的开发方案，包括 Electron、React + TypeScript、PDF.js、MuPDF / MuPDF.js、Electron Forge 等。 --- ## 主要观点 1. **AGENTS.md 的作用**： - 它是 AI Agent 的“项目规矩”，不是百科全书。 - 它帮助 AI 明确边界，防止误操作。 - 它适合写项目目标、协作流程、禁止行为、验收方式等，而非泛泛的“高级”“专业”等口号。 - 它不是一劳永逸，而是随着项目推进不断优化。 2. **Codex 的使用原则**： - 避免一次性任务写入长期规则，避免冲突。 - 小改优先，不乱重构。 - 大改前需确认影响范围。 - 验收时关注修改内容、如何检查、是否影响已有成果。 3. **协作方式**： - 分叉用于尝试不同方案，不干扰当前进度。 - 任务中补充要求需明确、具体，避免混淆。 - 侧边对话用于询问状态，不打断主任务。 - 侧边栏用于查看终端输出、浏览器操作、文件修改等。 4. **非代码文件的处理**： - 需明确文件位置、格式、结构、验收方式。 - 每个任务要指定具体目标，如“整理成 PDF”“生成 PPT”“检查表格数据”等。 - 验收时要检查文件是否可用、内容是否符合要求。 5. **插件与工具的选择**： - 插件用于连接外部工具（如 Gmail、Google Drive、GitHub 等），实现更高效的内容处理。 - 插件安装前需确认授权和权限，避免隐私泄露。 - 插件使用顺序建议按需求优先级安排。 6. **技术方案的判断**： - 作为新手，无需精通技术细节，但需判断方案是否满足本地运行、是否区分预览与编辑、是否满足核心需求等。 - 技术选型应分阶段进行，避免急于打包安装。 --- ## 关键信息 ### 1. **AGENTS.md 写法建议** - 项目目标、边界、禁止行为、协作流程、验收方式是重点。 - 写规则时要具体、可执行，避免空泛。 - 保持规则简洁，避免噪音。 ### 2. **Codex 安装方式** - **Codex Desktop**：推荐新手使用，图形界面友好。 - **Codex CLI**：适合命令行用户。 - **VSCode 插件**：适合在编辑器内使用。 ### 3. **Codex 的功能速查** - **分叉**：用于尝试不同方案，不破坏当前任务。 - **任务中补充要求**：用 `Esc` 暂停，输入新要求。 - **侧边对话**：适合问状态、解释、确认问题。 - **侧边栏**：查看终端输出、浏览器操作、文件修改等。 - **工作树**：隔离修改，适合大改或试错。 - **自动化**：设置定时任务，适合周期性操作。 - **内置终端、浏览器、电脑操作**：用于查看结果、测试功能、操作桌面软件。 - **图片输入与生成**：用于测试功能或生成视觉内容。 ### 4. **插件推荐与使用** - **Gmail**：用于邮件总结、回复起草。 - **Google Drive**：用于云盘资料整理、提取信息。 - **Google Calendar**：用于日程管理。 - **Slack**：用于团队沟通、提取讨论结论。 - **Notion**：用于知识库整理、笔记提取。 - **GitHub**：用于查看开源项目、处理协作信息。 - **Documents**：用于生成 Word 文档。 - **Spreadsheets**：用于数据整理、异常项检查。 - **Presentations**：用于生成 PPT、检查排版。 ### 5. **PDF 编辑器技术方案** - **Electron**：将网页界面打包成桌面软件。 - **React + TypeScript**：构建用户可见的界面。 - **PDF.js**：用于预览 PDF 页面。 - **MuPDF / MuPDF.js**：用于处理 PDF 文件内容。 - **Electron Forge**：用于打包安装，适合后期使用。 --- ## 重要提示 - **权限与安全**：使用 Codex 时，注意权限提示，避免误操作或隐私泄露。 - **验收流程**：修改完成后，要明确验收方式，如测试播放、检查文件是否可打开、确认内容是否符合预期。 - **避免混淆**：区分“提示词”与“长期规则”，避免 AI 误操作。 - **分层处理**：根目录与项目目录的 AGENTS.md 分别负责不同层级的规则。 - **逐步优化**：AGENTS.md 不是一次写完，而是随着项目发展逐步完善。 --- ## 结语 《给文科生的 AI 蓝皮书》不是教你怎么写代码，而是教你怎么与 AI 合作，让 AI 成为你的助手。核心是**规则先行**，**分层处理**，**明确验收**，**合理使用插件**，**逐步优化**。这些原则能帮助你更安全、高效地使用 AI 工具，实现你的目标。