做过产品文档的人都知道，编写用户手册是多么耗费精力——不是技术细节难以描述，而是从零搭建结构、统一术语、反复调整格式、再到最后把截图一张张插入，光是回想那套流程就让人头疼。尤其是内部新工具刚上线，效率要求高，还得保证文档质量和版本一致性，这时候如果能有一双手代劳初稿，那就太理想了。

Codex 恰好可以胜任这个角色。它能够直接接入你的代码仓库或本地工程目录，也能根据你提供的 UI 描述，自动提取功能点、操作路径、界面元素，然后生成一份结构完整的技术文档初稿。相当于让产品代码自己开口说话，帮你清晰说明它的使用方法。

先让 Codex 理解你的产品

Codex 生成手册的前提非常简单直接：它需要能够“理解”你的产品是什么样子。至于PDF说明书或者一堆散装截图，抱歉，那不是它能处理的内容。你需要给它可以解析的原始输入，说白了就是结构化的代码或描述。

具体有三种方法可以做到这一点。

方法一：直接接入 Git 仓库（推荐）
在 Codex 项目创建页面选择「Connect to Git」，输入 GitHub 或 GitLab 仓库的 HTTPS 地址，粘贴个人访问令牌（PAT），然后点击「Sync now」。仓库同步完成后，Codex 就能自动读取代码结构和关键文件。

方法二：拖入本地工程文件夹
点击左侧「+ New Project」，选择「Local folder」，然后浏览并选中包含 src/、public/ 或 docs/ 目录的根文件夹。需要特别注意：该文件夹下必须至少有一个 package.json、README.md 或 index.html 文件，否则 Codex 无法识别项目类型，不会触发任何文档解析逻辑。

方法三：直接粘贴 UI 描述文本
如果没有代码资产，那就直接在对话框中描述你的页面。比如这样写：“这是我们的数据看板页面：顶部有时间筛选器（下拉单选）、中间是折线图（X轴为日期，Y轴为请求数），右上角有导出按钮（图标为↓箭头）。” 这种方式纯粹是应急之举，生成内容的准确性会比前两种方法低不少。

触发文档生成的指令组合

确保你当前处于已连接项目的对话窗口内（而不是全局聊天页）。然后按顺序发送下面三句话，一次性搞定。

第一句：明确输出格式与受众。输入：“请为普通业务人员编写一份用户手册，用中文，按功能模块分章节，每章包含操作步骤、界面截图位置说明、常见问题提示，不要出现代码片段。”

第二句：限定文档范围，防止泛化。补充一句：“只覆盖 dashboard 页面和 settings > notification 子页面，忽略 login 和 admin 模块。”

第三句：启用截图标注支持。输入：“所有提到的按钮、输入框、图表区域，请在对应文字后用【截图标注：A】【截图标注：B】形式标记，我后续会插入真实截图替换。”

这三句话直接连续发送即可，不用分段操作。Codex 通常在 10～45 秒内就会返回一份 Markdown 格式的初稿，包含标题层级、列表和标注占位符。

术语与风格的人工修正，一步都不能省

Codex 默认会使用通用技术文档的语气和措辞，但你的团队肯定有自己的命名习惯。比如你们管“导出按钮”叫“下载快照”，管“时间筛选器”叫“时段滑块”。这时候必须手动干预一次，别指望它自己能学会。

操作很简单：全选生成的文档内容，Ctrl+F 查找“导出按钮”并替换为“下载快照”。同理查找“时间筛选器”并替换为“时段滑块”。

这一步骤绝对别跳过。Codex 不会主动记忆你替换后的术语，下次生成时仍会复用旧词。如果不做统一，多份手册之间就会出现理解上的歧义，越往后越混乱。

还有一个容易忽略的细节：检查一下 H2 标题是否全部以动词开头，比如“配置通知渠道”而不是“通知渠道设置”。不符合的立即手动调整。Codex 生成的标题偶尔会偏静态，而用户手册的规范要求行为导向，这个习惯值得养成。

截图换上去，PDF导出来

打开你的产品网页或本地预览服务，截取 dashboard 页面全图。用 Snipaste 或系统自带工具，在图中标出 A、B、C 区域（对应文档中【截图标注：A】等位置），保存为 PNG 格式。

回到 Codex 对话页，点击右侧「Attachments」面板，把刚才保存的 PNG 拖进去。Codex 会自动识别图中带字母标注的区域，并在文档对应位置插入图片链接。

最后一步：点击右上角「Export」，选择「PDF (with styling)」，勾选「Include cover page」，然后点击「Download」。文件会按当前项目名加日期自动命名，直接下载到默认目录。

整套流程走下来，原本可能折腾大半天的工作，现在压缩到半小时内就能完成。当然，核心价值不在于快，而在于让文档编写变得更可控、更可重复——每次产品迭代后，同样的方法再来一遍，版本一致性自然就有了保障。