川海智库

报告概述

该报告面向非技术背景的文科用户，系统介绍OpenAI Codex桌面应用的安装、配置、功能使用及插件集成。重点讲解AGENTS.md项目规则文件的编写方法，帮助用户规范AI Agent的行为边界，避免常见错误。此外，通过数字简谱测试示例、功能速查表、实用插件推荐以及PDF编辑器技术方案说明，让读者快速上手并实际应用Codex进行编程、文档处理、数据整理等任务。

报告的核心结论

AGENTS.md是AI Agent协作的核心规则文件

报告指出，AGENTS.md并非项目百科，而是明确项目边界、禁止行为、协作流程和验收方式的规则集。它能有效防止AI Agent过度重构、误删文件、恢复已删内容等常见问题，是确保项目长期稳定运行的关键。

使用工作树或Git保存点隔离大改动风险

报告强调，在让Codex执行大范围修改时，应优先使用工作树模式（隔离副本）或Git保存点。这样即使改动出现问题，也不会影响主项目文件，便于比对和回滚。

Codex具备处理非代码文件的完整能力

报告展示了Codex可以处理Markdown、PDF、Word、Excel、PPT、CSV、图片等非代码文件。用户只需明确文件位置、输出格式、结构要求和验收标准，即可让Codex完成整理、转换、生成等任务。

插件和MCP扩展了Codex的外部工具连接

报告推荐了Gmail、Google Drive、Slack、Notion、GitHub等插件，以及MCP和连接器。这些工具让Codex能够直接读取邮件、云盘文件、日程、团队聊天和代码仓库，大幅提升工作效率。

报告回答的关键问题

文科生如何快速上手Codex？

报告建议先安装Codex Desktop（图形界面），无需代码基础即可使用。通过案例演示，用户可学会用自然语言指令让Codex编写代码、整理文件、生成PPT等。重点掌握分叉、工作树、侧边对话等实用功能，以及AGENTS.md规则文件的编写方法。

AGENTS.md应该写哪些内容？

报告指出AGENTS.md应包含五类内容：项目目标、不能破坏的核心功能、禁止行为（如不要删除文件）、协作流程（大改前先给计划）、验收方式。规则要具体到能挡住一次实际翻车，避免空泛口号。根目录和项目目录可分层设置。

如何安全地让Codex修改项目文件？

报告推荐两种安全方式：使用工作树（隔离副本）或先通过Git创建保存点。大改动前让Codex先说明计划，修改后列出改动清单供验收。对于重要文件，可要求Codex先备份再修改。

Codex有哪些实用的插件？

报告推荐了9个实用插件：Gmail（处理邮件）、Google Drive（云盘文件）、Google Calendar（日程）、Slack（团队聊天）、Notion（知识库）、GitHub（代码仓库）、Documents（Word文档）、Spreadsheets（Excel/CSV）、Presentations（PPT）。每个插件都给出了适用场景和使用方法。

完整报告包含什么

  • 安装Codex的三种方式：桌面应用、命令行、VSCode插件，推荐新手使用桌面应用。
  • AGENTS.md规则说明：项目目标、边界、禁止行为、协作流程、验收方式，以及根目录与项目目录分层写法。
  • 数字简谱示例：提供《小星星》和《起风了》简谱，用于测试Codex的小钢琴自动演奏功能。
  • Codex实用功能速查：分叉、任务中补充要求、侧边对话、右侧侧边栏、新建任务时本地/工作树/云端的选择、Git保存点、内置终端、内置浏览器、浏览器操作、电脑操作、图片输入/生成、自动化、MCP/插件/连接器、权限提示、联网搜索、非代码文件处理。
  • Codex实用插件推荐：Gmail、Google Drive、Google Calendar、Slack、Notion、GitHub、Documents、Spreadsheets、Presentations的安装与使用指南。
  • PDF编辑器技术方案说明：Electron桌面外壳、React+TypeScript界面、PDF.js预览、MuPDF/MuPDF.js处理、Electron Forge打包，以及新手判断方案是否靠谱的要点。

本页内容由川海智库整理，用于帮助读者快速了解报告主题、核心观点和主要内容。由于报告量大、人工能力有限，部分观点、数据、统计口径或表述可能存在偏差，具体内容请以完整报告原文为准。

相关报告