进阶能力
让 Codex 在明确的范围内协助你
连接服务、指定当前文档与引用资料，先审阅计划，再检查 AI 实际修改的内容。
Refinex（沉默的老李）读完这篇，你可以
完成一次有明确上下文和权限范围的 AI 请求，并学会检查输出与文件变更。
开始之前
已打开工作区；可使用的 ChatGPT 账户或兼容的自定义模型服务。第三方服务可能收费并处理你发送的内容。
连接账户或自定义服务
打开 Codex 入口
从左侧 Codex 入口进入工作区 AI 界面。没有连接时会显示账户或服务配置入口。
选择一种连接方式
可以使用“使用 ChatGPT 登录”，也可以进入“配置自定义 API”，按服务要求填写兼容端点与凭据。不要把 API Key 粘贴进普通聊天消息。
确认可用状态
完成配置后检查模型和会话是否可用。登录、服务地址、余额或网络问题可能导致发送失败，应先处理明确的错误提示。
先选择合适的权限范围
第一次使用，先让 AI 理解一篇笔记或一个目录，并选择与任务匹配的权限。只需要阅读时，可以使用“只读访问”；需要编辑时，再按提示授权相应动作。
默认工作区权限、只读访问和完全访问具有不同边界。“完全访问权限”可能允许访问工作区外文件与互联网，并减少审批，不应仅因为一次工具失败就直接启用。
| 检查项 | 需要确认的内容 |
|---|---|
| 工作区 | 左上角目录是否是这次任务要处理的目录。 |
| 上下文 | 当前打开的文档、显式 @ 引用和附件是否正确。 |
| 权限 | 任务只需读取，还是确实需要写入、命令或联网。 |
说清楚“当前文档”和参考资料
在文档标签中打开并选中目标笔记，再提出“当前文档”相关请求。使用 @ 菜单显式引用其他资料时，请写清它们只是参考，还是也需要修改。
Markune 会在发送前处理当前草稿保存，并把活动文档与显式引用交给工作区任务。保存失败或活动文档尚未就绪时，先解决问题再发送；不要依靠标题相同、最近访问或日期猜测目标。
请阅读当前文档，检查：
1. 标题层级是否清晰
2. 哪些描述缺少必要解释
3. 有没有前后矛盾的内容
先给出问题清单和建议，不修改文件。
其他引用的文档只作为背景资料。先确认方案，再执行修改
复杂任务可以先要求给出方案；运行时支持计划模式时，也可以从输入区进入计划模式。先确定修改目标、范围和预期结果，再决定是否实施。
把大任务拆成能检查的小步骤，例如先整理一篇文档的结构，再补充另一节。任务结束后查看实际文件变更，不要只根据助手回复判断修改正确。
请只调整当前文档的标题层级和段落顺序。
保留原有技术结论、链接与代码示例。
不要修改其他文件，也不要删除原文内容。
完成后说明改动了哪些部分，并列出需要我确认的地方。检查变更并处理编辑冲突
查看本轮修改摘要
任务结束后展开已编辑文件列表与差异，逐项确认路径、新增内容和删除内容。
在编辑器里复核
打开对应文档检查排版、链接和实际文本。对有执行意义的代码、命令与配置，另外验证它们是否正确。
遇到冲突时保留两边内容
AI 写入期间如果你也修改了同一文档，可能出现“加载 AI 版本”或“用我的版本覆盖”的选择。先备份和比较，再决定；不要把任一按钮当作无损合并。
会话历史与工作区文件分开管理
AI 会话由 Codex 运行时管理，不是普通笔记，也不保存在工作区的 .markune 目录中。复制工作区不能视为完成了 AI 会话历史迁移。
历史恢复以运行时实际返回的信息为准，某些旧任务不一定能回放完整的工具细节。需要长期保留的结论，请审阅后写回正式 Markdown 笔记。