从 v3.10.0 或更早版本升级 planning-with-files 后Codex 的 SessionStart 等钩子不运行怎么办【免费下载链接】planning-with-filesPersistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. Install from npm, the Claude Code plugin marketplace, or npx skills. Codex, Cursor, OpenCode, 60 agents.项目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files如果你把 planning-with-files 从 v3.10.0 或更早的版本升级到新版本发现 Codex 的SessionStart、UserPromptSubmit或PreCompact钩子不再触发问题的原因和修复路径在 docs/codex.md 中有明确说明这次升级改变了.codex/hooks.json中这三条事件钩子的命令定义而 Codex 对新增或变更的钩子定义要求先经过/hooks审查并信任未信任前它们不会运行。本文按“更新钩子文件 → 重启 → 信任新定义 → 验证”的顺序给出文档中的完整处理路径。升级到底改了什么v3.10.1 修复了一个 Codex 在 Linux 和 macOS 上的问题旧版 POSIX 钩子命令直接调用 shell 脚本其输出以[planning-with-files]开头而 Codex 会把以[开头的输出当作 JSON 解析并拒绝CHANGELOG.md v3.10.1 条目修复 issue #220。修复方式是让SessionStart、UserPromptSubmit、PreCompact这三个 shell 承载的上下文事件全部改经run_sh.py路由由它输出符合事件的 JSON。也就是说从 v3.10.0 或更早版本升级后.codex/hooks.json里这三条钩子的command定义发生了变化。docs/codex.md 的原文结论是Upgrading from v3.10.0 or earlier changes three command definitions in.codex/hooks.json. Review and trust the updated definitions with/hooksbefore expectingSessionStart,UserPromptSubmit, orPreCompactto run.同时Codex 当前版本默认启用钩子但“新增或变更的非托管钩子仍必须通过/hooks审查并信任”。所以升级后钩子静默不运行最常见的直接原因就是变更后的定义还没有被信任。第一步把新版钩子文件更新到位升级的前提是项目里实际生效的钩子文件已经是新版本的内容。按你当初的安装方式选择对应路径docs/codex.md Installation 一节工作区安装.codex/推荐路径仓库文档给出的是把克隆到/tmp/planning-with-files的新版内容复制到项目根目录的命令克隆命令见 docs/codex.md仓库要求先获取新版本源码# Copy the standalone hook integration mkdir -p .codex cp /tmp/planning-with-files/.codex/hooks.json .codex/hooks.json cp -r /tmp/planning-with-files/.codex/hooks .codex/hooks团队共享的场景下文档要求把更新提交到仓库git add .agents/skills/planning-with-files .codex/hooks.json .codex/hooks后提交更新随正常的 git review 发布。个人安装~/.codex/可选分支如果钩子装在用户目录文档明确警告不要盲目覆盖已有的~/.codex/hooks.json而是手动合并全部七条条目SessionStart、UserPromptSubmit、PreToolUse、PermissionRequest、PostToolUse、PreCompact、Stop。Codex 插件安装可选分支仓库还附带 Codex 插件包其清单 .codex-plugin/plugin.json 当前版本为 3.17.0选中 hooks/codex-hooks.json插件内的命令通过${PLUGIN_ROOT}解析。注意插件模式和独立的.codex/hooks.json模式是互斥的替代方案同一安装不要两者都启用否则 Codex 会从每个活动来源执行匹配到的钩子产生重复提醒。第二步重启 Codex 并通过 /hooks 信任新定义docs/codex.md 的 “Hooks Not Running?” 排查清单给出了四项检查升级后按顺序执行确认用户配置和托管配置managed configuration都没有显式设置[features] hooks false确认.codex/hooks.json项目根目录、~/.codex/hooks.json全局或已启用的插件描述符存在添加或变更钩子之后重启 Codex通过/hooks审查并信任新增或变更的定义。第 4 步就是这次升级的关键动作/hooks可以查看每个已加载钩子的来源、matcher 和解析后的命令。信任变更后的三条定义之前SessionStart、UserPromptSubmit、PreCompact不会运行。验证钩子是否恢复正常文档给出的验证命令个人安装路径codex --version ls -la ~/.agents/skills/planning-with-files/SKILL.md ls -la ~/.codex/hooks.json ~/.codex/hooks/工作区安装则检查项目根目录的.codex/hooks.json与.codex/hooks/。然后在 Codex 中用/hooks确认每个钩子的来源、matcher 和解析后的命令都已加载。一个具体的核对点升级成功后SessionStart、UserPromptSubmit、PreCompact三条事件命令应该都经过run_sh.py分别调用session-start.sh、user-prompt-submit.sh、pre-compact.sh例如插件版清单hooks/codex-hooks.json中的写法python3 ${PLUGIN_ROOT}/.codex/hooks/run_sh.py session-start.sh独立安装版.codex/hooks.json对应使用相对或$HOME路径。如果你看到的仍是旧版直接调用 shell 脚本的形式说明第一步的文件更新没有落到实际被 Codex 读取的位置。平台相关前提macOS 和 LinuxPOSIX 钩子命令要求python3和sh在 PATH 上四个 Python 钩子本来就使用python3因此完整的集成需要一个可用的 Python 3 安装。WindowsCodex 在 Windows 上读取每条钩子的commandWindows覆盖项。三条 shell 承载的钩子SessionStart、UserPromptSubmit、PreCompact经run_sh.py定位 Git for Windows 的sh.exe后运行与 macOS/Linux 相同的 shell 脚本没有安装 Git for Windows 时这三条钩子保持静默而四条 Python 钩子仍然工作。Windows 上建议使用工作区安装Method 1因为commandWindows条目使用相对项目目录的.codex\...路径全局~/.codex安装需要写绝对路径。如果确认三条钩子已加载但仍没有计划上下文注入还有一条边界要知道没有活动计划时钩子按设计保持静默先确认项目里存在task_plan.md或.planning/.active_plan指向的计划再怀疑钩子本身通用排查见 docs/troubleshooting.md。小结升级后 Codex 钩子不运行的处理路径是更新.codex/hooks.json与.codex/hooks/或合并全局配置、更新插件→ 确认[features] hooks未被禁用 → 重启 Codex → 用/hooks审查并信任变更后的SessionStart、UserPromptSubmit、PreCompact定义 → 用codex --version、ls和/hooks核对加载状态与命令解析结果。信任步骤完成前这三个钩子不运行是预期行为不是安装损坏。【免费下载链接】planning-with-filesPersistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. Install from npm, the Claude Code plugin marketplace, or npx skills. Codex, Cursor, OpenCode, 60 agents.项目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 从 v3.10.0 或更早版本升级 planning-with-files 后，Codex 的 SessionStart 等钩子不运行怎么办？
从 v3.10.0 或更早版本升级 planning-with-files 后Codex 的 SessionStart 等钩子不运行怎么办【免费下载链接】planning-with-filesPersistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. Install from npm, the Claude Code plugin marketplace, or npx skills. Codex, Cursor, OpenCode, 60 agents.项目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files如果你把 planning-with-files 从 v3.10.0 或更早的版本升级到新版本发现 Codex 的SessionStart、UserPromptSubmit或PreCompact钩子不再触发问题的原因和修复路径在 docs/codex.md 中有明确说明这次升级改变了.codex/hooks.json中这三条事件钩子的命令定义而 Codex 对新增或变更的钩子定义要求先经过/hooks审查并信任未信任前它们不会运行。本文按“更新钩子文件 → 重启 → 信任新定义 → 验证”的顺序给出文档中的完整处理路径。升级到底改了什么v3.10.1 修复了一个 Codex 在 Linux 和 macOS 上的问题旧版 POSIX 钩子命令直接调用 shell 脚本其输出以[planning-with-files]开头而 Codex 会把以[开头的输出当作 JSON 解析并拒绝CHANGELOG.md v3.10.1 条目修复 issue #220。修复方式是让SessionStart、UserPromptSubmit、PreCompact这三个 shell 承载的上下文事件全部改经run_sh.py路由由它输出符合事件的 JSON。也就是说从 v3.10.0 或更早版本升级后.codex/hooks.json里这三条钩子的command定义发生了变化。docs/codex.md 的原文结论是Upgrading from v3.10.0 or earlier changes three command definitions in.codex/hooks.json. Review and trust the updated definitions with/hooksbefore expectingSessionStart,UserPromptSubmit, orPreCompactto run.同时Codex 当前版本默认启用钩子但“新增或变更的非托管钩子仍必须通过/hooks审查并信任”。所以升级后钩子静默不运行最常见的直接原因就是变更后的定义还没有被信任。第一步把新版钩子文件更新到位升级的前提是项目里实际生效的钩子文件已经是新版本的内容。按你当初的安装方式选择对应路径docs/codex.md Installation 一节工作区安装.codex/推荐路径仓库文档给出的是把克隆到/tmp/planning-with-files的新版内容复制到项目根目录的命令克隆命令见 docs/codex.md仓库要求先获取新版本源码# Copy the standalone hook integration mkdir -p .codex cp /tmp/planning-with-files/.codex/hooks.json .codex/hooks.json cp -r /tmp/planning-with-files/.codex/hooks .codex/hooks团队共享的场景下文档要求把更新提交到仓库git add .agents/skills/planning-with-files .codex/hooks.json .codex/hooks后提交更新随正常的 git review 发布。个人安装~/.codex/可选分支如果钩子装在用户目录文档明确警告不要盲目覆盖已有的~/.codex/hooks.json而是手动合并全部七条条目SessionStart、UserPromptSubmit、PreToolUse、PermissionRequest、PostToolUse、PreCompact、Stop。Codex 插件安装可选分支仓库还附带 Codex 插件包其清单 .codex-plugin/plugin.json 当前版本为 3.17.0选中 hooks/codex-hooks.json插件内的命令通过${PLUGIN_ROOT}解析。注意插件模式和独立的.codex/hooks.json模式是互斥的替代方案同一安装不要两者都启用否则 Codex 会从每个活动来源执行匹配到的钩子产生重复提醒。第二步重启 Codex 并通过 /hooks 信任新定义docs/codex.md 的 “Hooks Not Running?” 排查清单给出了四项检查升级后按顺序执行确认用户配置和托管配置managed configuration都没有显式设置[features] hooks false确认.codex/hooks.json项目根目录、~/.codex/hooks.json全局或已启用的插件描述符存在添加或变更钩子之后重启 Codex通过/hooks审查并信任新增或变更的定义。第 4 步就是这次升级的关键动作/hooks可以查看每个已加载钩子的来源、matcher 和解析后的命令。信任变更后的三条定义之前SessionStart、UserPromptSubmit、PreCompact不会运行。验证钩子是否恢复正常文档给出的验证命令个人安装路径codex --version ls -la ~/.agents/skills/planning-with-files/SKILL.md ls -la ~/.codex/hooks.json ~/.codex/hooks/工作区安装则检查项目根目录的.codex/hooks.json与.codex/hooks/。然后在 Codex 中用/hooks确认每个钩子的来源、matcher 和解析后的命令都已加载。一个具体的核对点升级成功后SessionStart、UserPromptSubmit、PreCompact三条事件命令应该都经过run_sh.py分别调用session-start.sh、user-prompt-submit.sh、pre-compact.sh例如插件版清单hooks/codex-hooks.json中的写法python3 ${PLUGIN_ROOT}/.codex/hooks/run_sh.py session-start.sh独立安装版.codex/hooks.json对应使用相对或$HOME路径。如果你看到的仍是旧版直接调用 shell 脚本的形式说明第一步的文件更新没有落到实际被 Codex 读取的位置。平台相关前提macOS 和 LinuxPOSIX 钩子命令要求python3和sh在 PATH 上四个 Python 钩子本来就使用python3因此完整的集成需要一个可用的 Python 3 安装。WindowsCodex 在 Windows 上读取每条钩子的commandWindows覆盖项。三条 shell 承载的钩子SessionStart、UserPromptSubmit、PreCompact经run_sh.py定位 Git for Windows 的sh.exe后运行与 macOS/Linux 相同的 shell 脚本没有安装 Git for Windows 时这三条钩子保持静默而四条 Python 钩子仍然工作。Windows 上建议使用工作区安装Method 1因为commandWindows条目使用相对项目目录的.codex\...路径全局~/.codex安装需要写绝对路径。如果确认三条钩子已加载但仍没有计划上下文注入还有一条边界要知道没有活动计划时钩子按设计保持静默先确认项目里存在task_plan.md或.planning/.active_plan指向的计划再怀疑钩子本身通用排查见 docs/troubleshooting.md。小结升级后 Codex 钩子不运行的处理路径是更新.codex/hooks.json与.codex/hooks/或合并全局配置、更新插件→ 确认[features] hooks未被禁用 → 重启 Codex → 用/hooks审查并信任变更后的SessionStart、UserPromptSubmit、PreCompact定义 → 用codex --version、ls和/hooks核对加载状态与命令解析结果。信任步骤完成前这三个钩子不运行是预期行为不是安装损坏。【免费下载链接】planning-with-filesPersistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. Install from npm, the Claude Code plugin marketplace, or npx skills. Codex, Cursor, OpenCode, 60 agents.项目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考