企业官网建设流程全解析

如何一键导入 .md 提示词：让 Codex-X 替你管 Codex 的指令文件

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

还在手动改config.toml、追着model_instructions_file的指向来回切换？用过 Codex-X 的提示词一键导入功能后，你只需要选一个 .md 文件、翻开一个开关，导入、去重、备份、写入配置就全部自动完成。读完这篇，你能把任意 .md 文件变成一条可反复启用的可视化提示词。

环境确认与前置条件

开始之前，确认四件事：

• 已安装 Codex-X 桌面端，应用能正常启动
• 本机装有 OpenAI Codex，桌面端或 CLI 均可
• 手头有一个.md文件，内容即指令正文
• 无需任何账号，导入与启用全程离线

如果你还没装 Codex-X，先从官方渠道获取安装包；仓库自带的示例提示词可以直接拿来试手：examples/gpt5.5-unrestricted.md、examples/writing-technical-docs.md。

一键导入 .md 提示词的完整流程

第 1 步｜选择你的 md 文件

打开 Codex-X，进入左侧的「提示词」页面。页面右上角有三个按钮：同步、导入 md、添加。点「导入 md」，弹出系统文件选择器，挑中你的 .md 文件。前端会先校验文件名，不是 .md 直接提示「请选择 .md 提示词文件」。校验通过，页面顶部弹出已导入提示词：xxx.md，列表里多出一条新记录，来源标记为「本地自定义」。

第 2 步｜选择注入方式

每条提示词有一个「启用方式」选项，只有两个：

• 追加模式：把内容作为管理区块写进AGENTS.md，你原来的model_instructions_file保持不动
• 替换模式：把 Codex 的指令入口整体指向这份提示词

选哪个，取决于你下一条提示词想和旧指令共存，还是独占舞台。

第 3 步｜翻开开关一键启用

回到列表，找到刚导入的条目，翻开它的开关。页面随后给出结果提示，例如「已用追加模式启用 xxx（来源：本地自定义）」。到这一步，Codex 下一次会话就会按新指令行事，全程没有动过一行配置文件。

它到底在背后干了什么

先看文件从哪来。你选中的 .md 文件由前端读取全文，随后调用save_prompt传给 Rust 后端，这一步只做一件事：原样保存内容。

接下来是文件名规范化。后端会把文件名转小写、把非法字符替换成-、补齐.md后缀，逻辑写在apps/desktop/src-tauri/src/prompts/store.rs里。这样「My Prompt 破甲.md」和「my-prompt-破甲.md」最终会落成同一个规范文件名。

最后落到本地 SQLite。记录以id / title / filename / content四元组入库。重复导入时，按「文件名相同」或「内容相同」识别为同一条，只更新、不新增；列表接口也会再做一遍去重，保证你看到的始终是一条干净记录。

💡 还有个隐藏机制：如果你之前手动把 Codex 配置的model_instructions_file指向过某个外部 .md 文件，Codex-X 启动时会自动把它收编为「外部提示词」，逻辑在apps/desktop/src-tauri/src/prompts/mod.rs。也就是说，旧习惯不用清理，打开应用就自动进库了。

两种典型用法

叠加式（追加模式）适合在默认指令之上叠一层通用规则，比如团队规范、输出格式要求。它会往AGENTS.md里插入一段带标记的 Codex-X 管理区块，禁用时只摘除自己这段，原有指令文件一个字都不碰。

整替式（替换模式）适合在不同任务风格间完整切换：今天写代码用调试提示词，明天写文档用写作提示词。启用后 Codex 的指令入口直接指向这份文件，旧入口会被切走；再启用别的提示词时，当前这份自动让位。

两种方式共用同一套备份与回滚逻辑，随时可以来回切，不用担心切不回去。

常见问题与踩坑记录

Q：我的文件名带空格或中文标点，导入后显示不一样？这是预期行为。后端会把非法字符替换为-并统一转小写，正文内容不受影响。

Q：同一个文件导入两次，会不会出现两条记录？不会。文件名或内容相同即视为同一条，第二次导入只更新内容，不会新增记录。

Q：启用开关没反应或报错，怎么排查？先看页面反馈里的具体提示，再到 Codex 配置目录的备份位置找最近一份备份，对照config.toml确认model_instructions_file当前指向哪里。启用失败时写入会自动回滚，原始配置不会被改坏。

Q：提示词存在哪？重装 Codex 会丢吗？存在 Codex-X 的本地 SQLite 数据库里，与 Codex 原始文件分离，升级或重装 Codex 都不受影响。但注意它不随系统迁移，换电脑需要重新导入一次。

接下来可以做什么

提示词列表里还有一批官方模板，点「同步」拉取最新版，或直接编辑已有条目改写内容。库大了之后，用分类功能把「破甲 / 逆向」「软件开发」「写作辅助」归拢起来，浏览起来更顺手。想深挖备份与回滚的设计，可以看 docs/PROJECT_LOG.md。

现在，你的提示词已经和插件一样被管起来了：随时导入、随时切换、随时回滚。

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