个人技术学习分享 | 站点：woqu.fun

🐾

你好，欢迎来到 WoQu.fun 站点专属

一名深耕AI编程、大模型工程化的开发者，日常折腾Claude Code、提示词缓存优化、MCP工具开发。 把踩过的坑、验证过的实战方案整理成可视化教程，方便自己复盘，也分享给同路人。

大模型开发 Claude Code 提示词工程 前端可视化 MCP工具

WoQu.fun 站点内容方向

技术专栏 · 实战踩坑合集 woqu.fun
Claude Prompt Cache 完整工作原理可视化解析
拆解缓存hash计算链条，tools/system/messages分层失效规则，搭配交互式示意图直观理解缓存失效根源。
分类：大模型优化 | 本站演示页面专属内容
Session切换模型导致缓存全部重建避坑指南
Opus/Sonnet缓存隔离机制，中途切换/model带来的成本暴涨问题与解决方案。
分类：计费优化 | 发布时间：2026-06
tools数组作为缓存最前置分段，修改后整条缓存链作废，正确工程化使用规范。
分类：MCP开发 | 阅读：高实用
默认5分钟过期机制，环境变量一键开启长时效缓存，长会话大幅降低token开销。
分类：省钱技巧
Prompt Cache 实战避坑 可视化详解 WoQu.fun 教程
tools
所有工具定义
含MCP
system
Claude Code身份+行为准则
启动参数注入
CLAUDE.md / skills
+ hooks / MCP指南
启动时注入 messages
messages
对话历史+工具调用
+你刚刚发的那句
← 一动全塌 · · · · 一动只伤自己 →
核心原理
把请求想成一根从左到右的链条：tools → system → CLAUDE.md/skills → messages。Anthropic的cache系统按这个顺序逐段计算hash。修改链条左侧分段，该分段右侧所有缓存全部失效；仅修改最右侧messages，只会销毁当前对话缓存。越靠左的层级改动，重建成本越高。

五大核心避坑总结（WoQu.fun 整理）

开源工具 & 配置脚本 woqu.fun

缓存优化脚本

export ENABLE_PROMPT_CACHING_1H=1

终端执行该环境变量，缓存闲置过期时间从5分钟延长至1小时，长对话大幅降低重复写入成本。本站 woqu.fun 实测有效。

本站开源页面

本可视化页面完整开源，可直接复制部署、二次修改自定义展示内容
线上访问：woqu.fun

关于本站 WoQu.fun & 作者


技术栈：HTML/CSS原生实现、无第三方JS依赖，轻量无打包，静态页面直接部署GitHub Pages、Vercel、Nginx，适配 WoQu.fun 静态站点。


本站 WoQu.fun 持续更新AI编程干货