https://blog.huoke.me/tags/agents.md/Recent content in AGENTS.md on Huoke.Me - 跨境生活，从理财开始！HugocnSat, 05 Sep 2026 17:41:00 +0800https://blog.huoke.me/posts/codex-memory/Sat, 05 Sep 2026 17:41:00 +0800https://blog.huoke.me/posts/codex-memory/<blockquote> <p>🎯 Astra在Codex里增加了实验性上下文管理：跨窗口维护笔记，同时保留可搜索的早期消息与工具结果。它主要解决长任务的细节丢失，Token是否下降仍取决于检索量、笔记长度和工作流设计。</p></blockquote> <p><img src="https://blog.huoke.me/img/posts/codex-memory/hero.webp" alt="Codex笔记与可搜索历史上下文管理" title="Codex实验性上下文管理" width="1200" height="630" loading="lazy" decoding="async"> </p> <p>传统compaction会把较早的对话压成一份摘要。任务持续数小时后，同一份历史可能被重复压缩，错误日志、失败原因和早期约束会逐渐变模糊。</p> <p>Astra的新模式把“保留什么”和“在哪里找细节”拆成两层：当前窗口携带精简笔记，旧窗口继续可检索。模型需要某个测试结果时，可以回查原消息和工具输出。</p> <hr> <h2 id="-新模式改变了什么">📌 新模式改变了什么</h2> <p>OpenAI在<a href="https://openai.com/index/gpt-6-astra/" target="_blank" rel="noopener noreferrer">Astra发布说明</a> 中确认了三点：</p> <ol> <li>Astra可以跨上下文窗口维护笔记；</li> <li>更早的上下文窗口保持可搜索；</li> <li>搜索范围包含历史消息和工具结果。</li> </ol> <table> <thead> <tr> <th>方式</th> <th>当前窗口携带内容</th> <th>早期细节</th> </tr> </thead> <tbody> <tr> <td>传统反复摘要</td> <td>一份持续压缩的摘要</td> <td>依赖摘要是否保留</td> </tr> <tr> <td>笔记 + 可搜索历史</td> <td>结构化笔记</td> <td>需要时回查原记录</td> </tr> <tr> <td>全量上下文</td> <td>大量原始消息</td> <td>直接存在窗口内，Token占用高</td> </tr> </tbody> </table> <p>这套机制适合复杂调试、大规模重构、跨阶段研究和多轮工具任务。短小、边界清楚的修改通常在单个上下文窗口内结束，收益有限。</p> <p>该功能仍处于实验阶段，当前默认关闭。OpenAI计划在后续数周内把它设为Astra的默认方式，实际时间以Codex版本和账户开放状态为准。</p> <hr> <h2 id="-如何开启实验功能">⚙️ 如何开启实验功能</h2> <p>官方配置项是<code>features.context_management.experimental_mode</code>。编辑<code>~/.codex/config.toml</code>：</p> <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:2;-o-tab-size:2;tab-size:2;"><code class="language-toml" data-lang="toml"><span style="display:flex;"><span><span style="color:#000;font-weight:bold">[</span><span style="color:#000">features</span><span style="color:#000;font-weight:bold">.</span><span style="color:#000">context_management</span><span style="color:#000;font-weight:bold">]</span> </span></span><span style="display:flex;"><span><span style="color:#000">experimental_mode</span> <span style="color:#000;font-weight:bold">=</span> <span style="color:#204a87;font-weight:bold">true</span> </span></span></code></pre></div><p>也可以使用完整键写法理解其层级：</p> <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:2;-o-tab-size:2;tab-size:2;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>features.context_management.experimental_mode = true </span></span></code></pre></div><p>配置完成后启动一个新任务。Codex通常在新会话开始时重新构建模型、功能和项目指令环境。</p> <p>检查清单：</p> <ol> <li>Codex客户端已更新到支持Astra与该配置项的版本；</li> <li>使用ChatGPT账户登录，套餐具备对应功能权限；</li> <li>模型选择器中能看到并使用Astra；</li> <li><code>config.toml</code>的TOML层级和布尔值正确；</li> <li>工作区管理员没有通过受管配置关闭实验功能。</li> </ol> <p>官方配置参考把该功能标为“under development / off by default”，并列出ChatGPT登录与套餐要求。Business、Enterprise等受管账户还会受到工作区策略影响。</p> <hr> <h2 id="-agentsmd最小模板">📝 AGENTS.md最小模板</h2> <p><img src="https://blog.huoke.me/img/posts/codex-memory/workflow.webp" alt="Codex长任务上下文工作流与AGENTS.md内容边界" title="Codex长任务上下文工作流" width="1200" height="760" loading="lazy" decoding="async"> </p> <p>新记忆机制负责保留任务过程，<code>AGENTS.md</code>负责提供稳定规则。两者承担不同角色。</p> <p>官方文档说明，Codex会在开始工作前读取<code>AGENTS.md</code>。全局文件通常位于<code>~/.codex/AGENTS.md</code>，项目文件放在仓库根目录；更接近当前工作目录的文件拥有更高优先级。</p> <p>一个够用的项目模板：</p> <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:2;-o-tab-size:2;tab-size:2;"><code class="language-markdown" data-lang="markdown"><span style="display:flex;"><span><span style="color:#000080;font-weight:bold"># Project instructions </span></span></span><span style="display:flex;"><span><span style="color:#000080;font-weight:bold"></span> </span></span><span style="display:flex;"><span>Repository: </span></span><span style="display:flex;"><span><span style="color:#204a87;font-weight:bold">-</span> Application code: <span style="color:#4e9a06">`src/`</span> </span></span><span style="display:flex;"><span><span style="color:#204a87;font-weight:bold">-</span> Tests: <span style="color:#4e9a06">`tests/`</span> </span></span><span style="display:flex;"><span><span style="color:#204a87;font-weight:bold">-</span> Documentation: <span style="color:#4e9a06">`docs/`</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span>Commands: </span></span><span style="display:flex;"><span><span style="color:#204a87;font-weight:bold">-</span> Install: <span style="color:#4e9a06">`npm ci`</span> </span></span><span style="display:flex;"><span><span style="color:#204a87;font-weight:bold">-</span> Test: <span style="color:#4e9a06">`npm test`</span> </span></span><span style="display:flex;"><span><span style="color:#204a87;font-weight:bold">-</span> Lint: <span style="color:#4e9a06">`npm run lint`</span> </span></span><span style="display:flex;"><span><span style="color:#204a87;font-weight:bold">-</span> Build: <span style="color:#4e9a06">`npm run build`</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span>Engineering rules: </span></span><span style="display:flex;"><span><span style="color:#204a87;font-weight:bold">-</span> Keep changes scoped to the requested feature or bug. </span></span><span style="display:flex;"><span><span style="color:#204a87;font-weight:bold">-</span> Preserve public API compatibility unless the task requires a breaking change. </span></span><span style="display:flex;"><span><span style="color:#204a87;font-weight:bold">-</span> Add or update tests for behavior changes. </span></span><span style="display:flex;"><span><span style="color:#204a87;font-weight:bold">-</span> Never print secrets, tokens, customer data, or production credentials. </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span>Done: </span></span><span style="display:flex;"><span><span style="color:#204a87;font-weight:bold">-</span> Required tests pass. </span></span><span style="display:flex;"><span><span style="color:#204a87;font-weight:bold">-</span> Changed files are reviewed for security and error handling. </span></span><span style="display:flex;"><span><span style="color:#204a87;font-weight:bold">-</span> Report modified files, verification commands, and remaining risks. </span></span></code></pre></div><p>模板里的命令必须换成项目真实命令。Codex官方建议让<code>AGENTS.md</code>保持简短、准确，把架构长文、计划和专项规范放到独立文件中引用。</p>