ARTICLE DETAIL

资讯详情

深耕编程入门与网站建设的一线实战洞察。

Claude Code 更新插件后 /planning-with-files 报 “template files not found in cache“ 怎么解决?

Claude Code 更新插件后 /planning-with-files 报 “template files not found in cache“ 怎么解决? Claude Code 更新插件后 /planning-with-files 报 template files not found in cache 怎么解决【免费下载链接】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在 Claude Code 中以插件方式安装了 planning-with-files执行/plugin update planning-with-filesplanning-with-files升级到新版本后再调用/planning-with-files时报出template files not found in cache或类似的模板缺失错误。这是 docs/troubleshooting.md 收录的已知问题Claude Code 会缓存插件文件更新后缓存可能没有正确刷新导致插件仍然从旧缓存里找模板。按照下面的步骤做干净重装并重启 Claude Code即可恢复。先确认安装状态别直接改缓存处理之前先用 Claude Code 自带的插件命令确认当前装了什么版本、包含哪些组件claude plugin list claude plugin details文档同时指出Claude Code 把已安装的插件文件放在~/.claude/plugins/cache/目录下统一管理不要直接编辑缓存中的那份副本docs/troubleshooting.md。缓存里内容不对时的正确做法是下面这一步的整体重装而不是手动往缓存目录里补文件。干净重装官方推荐解法在 Claude Code 会话中按顺序执行以下三条命令先卸载、重新添加 marketplace、再安装/plugin uninstall planning-with-filesplanning-with-files /plugin marketplace add OthmanAdi/planning-with-files /plugin install planning-with-filesplanning-with-files这三条命令与 docs/installation.md 中的标准插件安装流程一致区别只是前面多了一步卸载用以确保旧缓存被清掉。重装完成后必须完全退出并重启 Claude Code再重新进入会话测试。文档明确写了 Restart Claude Code completely after reinstalling只重开会话而不重启客户端缓存可能仍未刷新。为什么更新后会出这个问题CHANGELOG.md 记录了这个问题的来龙去脉也解释了为什么更新 重装能治本v2.1.1 修复了插件市场安装时找不到模板的问题因为插件缓存期望在仓库根目录有planning-with-files/templates/v2.1.2 进一步修复了根因${CLAUDE_PLUGIN_ROOT}解析到仓库根目录但模板当时只放在子目录里。修复方式是同时在仓库根层级添加templates/和scripts/目录使模板无论CLAUDE_PLUGIN_ROOT如何解析都能被找到。修复后模板存在于三处位置位置服务对象templates/仓库根${CLAUDE_PLUGIN_ROOT}/templates/的直接引用planning-with-files/templates/插件市场安装skills/planning-with-files/templates/旧的~/.claude/skills/手动安装也就是说只要重装拉到的版本包含根级templates/v2.1.2 及以后缓存重建后路径就能对上。这也是文档建议干净重装而不是其他操作的原因。重装后如何验证按 docs/installation.md 的验证流程确认插件恢复正常运行claude plugin list在/plugin或/hooks中检查该插件确认安装状态正常在一个有活跃 plan 的项目里启动新会话确认 planning 上下文能被恢复在没有活跃 plan 的项目里启动时预期没有提示消息这是设计行为不代表异常再次执行/planning-with-files确认不再出现template files not found in cache错误。如果之前是通过npx skills add或手动拷贝到~/.claude/skills/安装的独立 skill 而非插件/plugin系列命令不适用这条错误本身也是插件缓存路径特有的问题——这类安装请参考 docs/installation.md 中对应路线的更新方式进入~/.claude/skills/planning-with-files目录执行git pull origin master。仍然报错时如果干净重装并完全重启后依旧报错docs/troubleshooting.md 给出的兜底路径是提交 issue并附带Claude Code 版本claude --version输出操作系统执行的命令实际现象与预期结果的差异完整的报错信息。这样维护者能基于版本和安装路线定位是缓存刷新问题还是新版本本身的回归。【免费下载链接】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),仅供参考
返回列表