Codex 教程维护与发布规则

使用约定

本教程主要记录三类内容:

  • Codex 的基础概念、日常用法和项目协作方法。
  • 在实际使用中形成的个人规则、触发词和安全边界。
  • 重要问题的排查过程,例如 Notion 归档、发布流程、自动化和全局指令生效问题。

安全规则:

  • 不在教程、Notion 记录或网页发布副本中保存 token、UID、webhook、密码、密钥等敏感凭据明文。
  • 涉及账号、服务器、自动化、邮箱、Notion、GitHub 等连接能力时,只记录用途、路径、状态和维护说明。
  • 如果某个主题变复杂,可以拆成独立章节或单独文件,再从本教程链接过去。

文档维护与发布规则

这份教程采用“源文档 + 发布副本”的方式维护。

源文档:

1
C:\Users\Lenovo\OneDrive\Codex使用学习教程.md

发布副本:

1
C:\Users\Lenovo\OneDrive\网页发布文档\Codex使用教程.md

维护规则:

  • 源文档是长期维护的母版。
  • 源文件名固定为 Codex使用学习教程.md,不因发布模板变化而改名。
  • 教程正文以后按“搭建个人网站”对话里确认过的发布文章模板组织:标题、使用约定、维护与发布规则、学习路线、章节正文、个人规则、待补充主题、更新记录。
  • 这个模板是为了方便网页发布和阅读,不代表源文档要改成发布副本的文件名。
  • 发布副本只是投递给网页发布自动化的最新版文件。
  • 每次学习对话形成新结论后,先更新源文档,再用源文档直接覆盖发布副本。
  • 不管发布目录里是否已经存在 Codex使用教程.md,都直接覆盖。
  • 如果发布自动化把发布副本移动到“已发布”目录,下次更新时重新生成发布副本即可。

自动发布规则:

  • 发布目录中的 Codex使用教程.md 永远视为最新完整版,而不是增量补丁。
  • 自动化巡检到该文件后,以它为准同步整组“Codex 使用教程”WIKI 页面。
  • 章节标题变化时,网站左侧菜单名同步变化。
  • 章节正文变化时,对应三级页面正文完整覆盖为最新内容。
  • 新增章节时,新增对应三级页面和菜单。
  • 删除或合并章节时,网站对应结构也应同步调整。
  • 自动化不做增量比对、不追加内容、不新建重复文章。
  • 自动化不保留旧正文,不只改菜单名;正文和结构都以本文件最新版为准。
  • 自动化只做必要的安全检查、格式转换、构建和部署。
  • 成功后移动到“已发布”目录。
  • 成功发布不需要通知 Codex。

本学习对话中的触发规则:

  • 用户说“总结”“更新教程”“发布教程”时,立刻执行三件事:更新源文档、覆盖发布副本、归档到 Notion 对话记录库。
  • 其他普通对话中,用户说“总结”“NOTION对话”“notion对话”“复盘”“提炼”“整理”或类似表达时,只默认归档当前对话到 Notion 对话记录库;除非单独说明,不更新本教程。