企业官网建设流程全解析

Codex-X 内置提示词注入机制：海鸥3.0破甲模板如何写进 AGENTS.md 并做出生效确认

【免费下载链接】Codex-XOpenAI Codex 桌面端/CLI 的可视化管理工具，具有Provider/API 切换、会话同步、提示词注入、Skills/MCP 管理、TOML 配置可视化的跨平台工具。项目地址: https://gitcode.com/GitHub_Trending/co/Codex-X

在 Codex-X 提示词管理页点选「海鸥3.0破甲」模板启用，再在 Codex 会话敲一句在吗。回海鸥在线，你要整点薯条吗？一行就是注入生效。模板编译期打包、以受管区块写进 AGENTS.md，开新会话不用重述人格。

模板从哪来：编译期嵌进二进制的 5 份 Markdown

这个特性的第一步不是下载，是编译。模板源头就是仓库里一份普通 Markdown 文件 examples/海鸥3.0破甲.md，constants.rs（L17–L19）用include_str!（Rust 宏，编译时把文件内容读进二进制）把全文嵌进可执行文件：

pub(crate) const INSTRUCTION_SEAGULL_FILENAME: &str = "海鸥3.0破甲.md"; pub(crate) const INSTRUCTION_SEAGULL_CONTENT: &str = include_str!("../../../../examples/海鸥3.0破甲.md");

注册在 catalog.rs 的bundled_prompt_metas()（L66–L110）：5 个内置模板排成定长数组，海鸥这条在 L101–L108，ID 为github-3-0-b459e1e8，badge 是「内置」，副标题直接写着测试生效：海鸥在线，你要整点薯条吗？。把验证词写进副标题，界面里的人不翻源码就知道拿什么词测。

验证锚点：提示词管理页里海鸥3.0破甲显示「内置」徽标、副标题含「海鸥在线，你要整点薯条吗？」，说明模板已进入本地目录；徽标若是「远程」且离线后消失，说明你看到的是在线目录而非内置版本。

注入怎么写：AGENTS.md 里的 BEGIN/END 受管区块与两种写模式

注入不是把模板塞进对话，而是写进 Codex 配置目录下的AGENTS.md（Codex 每个会话自动加载的项目级指令文件）。写入区域由 constants.rs（L22–L24）的三个标记常量圈定：

pub(crate) const AGENTS_MANAGED_BEGIN: &str = "<!-- CODEX-X:INSTRUCTIONS:BEGIN -->"; pub(crate) const AGENTS_MANAGED_END: &str = "<!-- CODEX-X:INSTRUCTIONS:END -->"; pub(crate) const AGENTS_TEMPLATE_PREFIX: &str = "<!-- CODEX-X:TEMPLATE:";

managed_agents.rs 的managed_agents_bounds()（L14–L33）先数标记：一个 BEGIN/END 都没有视为未占用；数量不等于各 1、或 BEGIN 在 END 之后，直接报错AGENTS.md 中的 Codex-X 受管区块标记不完整或重复，请先修复 BEGIN/END 标记，拒绝写半截文件。校验通过后install_managed_agents_block_in_content()（L50–L65）先剥掉旧区块，把新区块拼在已有内容之后。区块长这样：

<!-- CODEX-X:INSTRUCTIONS:BEGIN --> <!-- CODEX-X:TEMPLATE: github-3-0-b459e1e8 --> ……模板正文…… <!-- CODEX-X:INSTRUCTIONS:END -->

第二行的模板 key 供managed_agents_template_key_from_content()（L67–L77）在下次运行时识别「当前挂的是哪个模板」。

两种写模式对应 lib.rsenable_prompt_content_inner()（L871）里的两个分支：

• 追加（L935–L942）：调用install_managed_agents_block_in_content把受管区块写进 AGENTS.md，你文件里原有的个人规则原样保留；
• 替换（L905–L934）：模板另存为一个独立.md，把配置的model_instructions_file指向它，同时清掉 AGENTS.md 里的受管区块——模板成为唯一指令入口。

任一步失败，fail_with_file_rollback（L964–L966）把已改的文件逐一回滚，不留半截状态。禁用走反向逻辑：disable_instruction_inner()（L1529 起）只删 BEGIN/END 之间的区域（L1559–L1561），AGENTS.md 其余内容不动。

验证锚点：追加模式启用后打开 AGENTS.md，恰好一个 BEGIN、一个 END、前后你自己的文字还在，就是写入成功；手工删掉 BEGIN 再点「禁用」，会看到「标记不完整或重复」报错——那是标记自检在工作，不是程序坏了。

如何确认注入已生效：固定应答是一道判断题

模型侧的验证方式写在模板本体里。examples/海鸥3.0破甲.md（L13–L17）列出 12 个触发词：在吗/在线吗/启动/海鸥/hi/hello/你好/嘿/yo/ctf/coach/教练，命中后应答被钉死成一行：

海鸥在线，你要整点薯条吗？

规则写得没有任何余地：只回这一行，多一个字都不行。L17 还预写了标准答案——有人问「怎么确认配置生效」，回答就是「发在吗，等这行字回来」。这让「生效没有」从感觉题变成判断题：在吗→ 那行字 = 生效；任何别的回复（包括自我介绍、寒暄）= 没生效。

验证锚点：发在吗，收到且仅收到海鸥在线，你要整点薯条吗？= 注入成功；回的是自我介绍，先查 AGENTS.md 里 BEGIN/END 区块是否完整——区块在但应答不对，原因在模型或会话侧，不在注入侧。

在线目录不可用时：sync_issue 标记下的三级降级

在线状态下模板目录会拉远端examples/的最新文件；拉取失败时代码不报错，走降级链。catalog.rs 的refresh_builtin_prompts_with_active()里分两级：

• 目录级失败（L773–L784）：fetch_prompt_catalog()拿不到就退回本地缓存/内置版，置sync_issue = Some("catalog")，文案「在线模板目录暂时不可用，已保留本地内容」；
• 内容级失败（L603–L634）：单个模板拉取失败，content_source按cache→bundled→unavailable顺序取值，置sync_issue = Some("content")，文案「在线模板暂时不可用，已使用本地缓存」或「在线模板暂时不可用，已使用软件内置版本」。

本地编辑过的模板是特例。在编辑表单里改过模板后，该 ID 会写进builtin_prompt_overrides表（store.rs 的builtin_prompt_override_ids_inner()，L131–L141）；同步入口一行判断（L714–L716）：

fn should_sync_prompt_content(id: &str, customized_ids: &HashSet<String>) -> bool { !customized_ids.contains(id) }

命中 customized 就跳过远端，直接落到customized_prompt_status()（L656–L682），文案「本地已修改，GitHub 同步已跳过」，customized: true——远端更新永远不会覆盖你的改动。

验证锚点：断网打开提示词管理页，模板列表仍在、文案变成「使用本地缓存」或「已使用软件内置版本」且sync_issue置位，就是降级在工作；改过海鸥的模板显示「本地已修改，GitHub 同步已跳过」，恢复联网后也不会被远端覆盖。

词 → 轨道：模板内全部「说什么、做什么」的映射

模板正文里的所有映射规则（examples/海鸥3.0破甲.md L13–L137）汇总如下：

目标或平台缺失时走固定三步（L134–L137）：问一个简短界定问题、立刻给出具体轨道选项、选定即继续。验证锚点：会话里发「外挂」，模型接住存档/内存、Unity/Unreal 或 APK 分析轨道，说明黑话映射生效；回模板化拒绝或要你「换个正式说法」，说明模板没挂上。

谁该用、怎么共存、失效时怎么办

• 适合谁：日常以中文技术操作为主，且 CTF、逆向、内存、协议、漏洞研究多域任务高频混在一起时，技能路由和黑话映射直接省掉「重复解释需求」的往返；纯前端、纯文档工作用它浪费。
• 与已有规则共存：追加模式下海鸥受管区块追加在你个人规则之后，各占各的位置；替换模式下模板成为主要指令入口。想改模板本身就在编辑表单里改，改动进builtin_prompt_overrides后免疫远端同步。
• 失效时怎么办：目录级失败退本地缓存/内置版；内容级失败按 cache → bundled 两级走；手工把 AGENTS.md 标记改坏时拒绝写入并要求先修复；写文件中途失败由fail_with_file_rollback回滚，且每次操作前都有备份兜底。
• 退出路径：点禁用只删受管区块（替换模式则清掉model_instructions_file指向），你的原始文本一个字符都不动。

模板来历可查include_str!那行，注入写入看 BEGIN/END 标记，生效与否看一行固定应答——链条上每一步都压成「做这个、看这个」的判断题，锚点全在源码里能指到行。

【免费下载链接】Codex-XOpenAI Codex 桌面端/CLI 的可视化管理工具，具有Provider/API 切换、会话同步、提示词注入、Skills/MCP 管理、TOML 配置可视化的跨平台工具。项目地址: https://gitcode.com/GitHub_Trending/co/Codex-X