记一次：Blender GLB 加载成功，博客首页却坏了一半
把程序化 Three.js 房间替换成 Blender GLB 后，模型能显示，屏幕内容、热点、镜头和家具交互却集体消失。记录我如何用节点契约、运行时绑定和完整 UV 平面把它们重新接回来。
100
标签: 踩坑记录
共 13 篇文章
记一次：我为什么不再让 AI 直接生成博客里的赛博朋克家具
记录从 Meshy、混元多视图生成失败，到改用 Blender 模块化建模和 Three.js 交互的路线调整。
150
记一次 Prisma 6 升级 7 的评估与升级指南
对博客项目做了一次 Prisma 6→7 的升级评估，整理了所有 breaking changes、改动量和风险点，顺便记录了完整的升级步骤。
220
记一次 Docker 镜像拉不下来的坑：镜像代理 + HTTP 代理的组合拳
GitHub Actions 部署时服务器拉取自己推到 Docker Hub 的镜像失败，排查后发现镜像代理只代理白名单公开镜像，私有镜像得走 HTTP 代理。
100
MacBook Pro 2019 独显问题排查全记录：从 13 FPS 到 60 FPS 的完整诊断过程
详细记录 MacBook Pro 2019 (Intel UHD 630 + AMD Radeon Pro 5300M) 双显卡机型 WebGL 性能异常的完整排查过程。从最初怀疑博客 Three.js 代码问题，到逐一排除显卡切换、热降频、外接显示器、系统版本等变量，最终通过 `--force-high-performance-gpu` 启动参数找到根因，FPS 从 13 直接飙到 60。这是一份 Intel Mac 双显卡调度问题的实战诊断手册。
250
记一次 Codex 和 Claude Code 共用项目规范
记录一次把 Claude Code 的 skills 和 agents 同步给 Codex 使用的折腾过程，主要是 .claude、.codex、.agents 这些目录到底怎么分工。
1561
记一次给博客配置腾讯企业邮箱发信
记录给博客配置腾讯企业邮箱 noreply@nnnnzs.cn 发信的完整过程，包括 DNS 同步到 Cloudflare、公共邮箱创建、自定义域名验证踩坑。
140
记一次 MCP Streamable HTTP 和 OAuth 认证改造
记录一次把博客 MCP 接口改造成兼容 Streamable HTTP、Bearer token 和 OAuth discovery 的过程，顺手踩了 Nginx .well-known 和公网 host 的坑。
510
从零搭建 K3s 混合集群：云服务器+NAS+PC 的踩坑实录
详细记录在腾讯云服务器、零刻 NAS 和 PC 之间搭建 K3s 集群的完整过程，包括版本兼容性、内存管理、网络打通、cgroup 冲突等多个踩坑和解决方案
440
记一次本地大模型部署踩坑：N200 + 4060Ti 的 7B 终局
从 N200 到 4060Ti，探索本地大模型部署的最佳方案
1560
谈谈项目文档和代码不同步这件小事
校对项目文档与实际代码的差异，更新了配置管理、向量检索、MCP认证、目录结构等文档
180
记一次 ZeroTier + Tailscale 双开导致内网穿透失败的排查
ping 得通但网页打不开？可能是 MTU 的问题。记录一次 ZeroTier + Tailscale 双开导致内网穿透 HTTP 失败的完整排查过程，顺便科普 MTU 和两款穿透工具的区别。
1680
记一次Home Assistant自定义集成开发踩坑
记录开发Home Assistant自定义集成时遇到的Python版本兼容、服务注册、asyncio、EntityCategory等各种坑
360