报告概述

《给文科生的AI蓝皮书》是一本面向非技术背景读者的AI Agent实操指南。报告以OpenAI推出的开源编程助手Codex为核心工具,系统讲解从安装配置到高级功能的完整使用链路。内容覆盖AGENTS.md项目规则文件的编写方法、Codex桌面应用的对话分叉与工作树机制、内置终端与浏览器操作、插件生态接入(Gmail/Google Drive/Slack等),并通过一个PDF编辑器技术方案案例,展示如何与AI协作完成真实项目规划。报告全程采用文科生友好的平实语言,每一步提供可直接复制的提示词模板,旨在让没有编程经验的人也能安全、高效地利用AI Agent完成文字处理、文件整理、数据汇总等日常任务。

报告的核心结论

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

报告指出,AGENTS.md并非一次性提示词,而是为AI Agent提供稳定的项目上下文,明确修改边界、禁止行为和验收方式。好的规则应来自真实翻车经历,能挡住一次具体错误,如禁止自动恢复已删内容或未经确认重构全项目。它采用分层写法,根目录管底线,项目目录管具体施工说明,两者叠加使用。

Codex适合文科生通过自然语言指令完成非代码工作。

报告强调,Codex桌面应用是推荐入口,可处理Markdown、PDF、Word、Excel等非代码文件。用户只需用中文描述需求,无需掌握命令行。关键在于学会使用工作树隔离大改动、分叉保护对话思路、任务中补充要求、以及让Codex操作内置浏览器验证结果。非代码文件交付前必须人工验收文字溢出、图片清晰度等细节。

分叉保护对话思路,工作树保护项目文件。

报告清晰区分两种隔离机制:分叉复制对话上下文,适合尝试不同写法或方案;工作树复制项目文件环境,适合大改文件或试错开发。两者非替代关系,分叉解决思路风险,工作树解决文件风险。建议用户大改动前先让Codex通过Git创建保存点,无Git时手动备份关键文件。

插件扩展了Codex的能力边界,需按需启用并明确授权范围。

报告推荐了Gmail、Google Drive、Slack、Notion、GitHub、Documents、Spreadsheets、Presentations等实用插件,并给出安装和提示词模板。强调使用前先让Codex确认插件可用性,避免它绕路胡编。涉及私人数据时需限定范围,高风险操作(如发送邮件、修改财务表)必须人工复核。插件不是越多越好,每增加一个授权就多一层数据边界。

报告回答的关键问题

AGENTS.md到底解决什么问题?

AGENTS.md解决AI Agent进入项目后不知道边界的问题。它告诉Agent哪些文件不能动、哪些行为必须先问人、修改后如何验收。它不像一次性提示词只管当前任务,而是管这个项目里长期稳定的做事方式,防止Agent在追求“做完”时无意中破坏已有成果,比如顺手重构、升级依赖或恢复已删内容。

文科生如何零基础开始用Codex?

报告建议从Codex桌面应用开始,用ChatGPT或Google邮箱登录即可。不用学命令行,直接在对话框用中文描述需求。关键步骤:先熟悉文件链接和内置终端;大改动前使用工作树或备份;做网页时学会内置浏览器预览和批注;有周期任务再学自动化;需要外部资料时再研究插件。每步只学当下需要的功能,避免一次性学全。

Codex的电脑操作和浏览器操作有什么区别?

两者使用场景不同。浏览器操作只操作Codex内置浏览器,适合检查本地网页、预览和测试按钮;电脑操作可以操作你电脑上的任意桌面软件,需在Windows/macOS上授权。报告强调安全边界:电脑操作前应关闭无关软件,只给明确目标,不让它处理支付、密码等敏感操作。发现它点错窗口立即停止。

完整报告包含什么

  • Codex的三种安装方式详细对比(桌面应用/命令行/VSCode插件),并附官网下载链接和免费额度说明,帮助读者快速搭建环境。
  • AGENTS.md从零到进阶的完整编写指南,包括项目目标、修改边界、协作流程、禁止行为、验收方式五类内容,提供Karpathy式示范模板,并说明根目录与项目目录的分层策略。
  • 数字简谱测试素材(《小星星》《起风了》)及交付验收三步骤,让读者通过小钢琴自动演奏功能,体验将AI生成创作导出为可分享文件的全流程。
  • Codex桌面应用所有实用功能的详细速查,包括分叉、任务中补充要求、侧边对话、右侧侧边栏、工作树与云端模式选择、Git保存点、内置终端/浏览器、电脑操作、图片输入/生成、自动化、MCP/插件/连接器、联网搜索、非代码文件处理等,每题附具体提示词模板。
  • 九大实用插件推荐(Gmail、Google Drive、Google Calendar、Slack、Notion、GitHub、Documents、Spreadsheets、Presentations),含安装步骤、使用场景、提示词示例和注意事项,提供选插件顺序建议。
  • PDF编辑器技术方案说明,用软件工地比喻解释Electron、React+TypeScript、PDF.js、MuPDF/MuPDF.js、Electron Forge各自角色,强调技术分层的原因,并给出新手判断方案是否靠谱的五个核心问题。

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

相关报告