小破站建设

一次 Next.js Docker 镜像体积与文章预生成取舍的实测

针对Next.js生产镜像优化，通过修复.dockerignore排除开发文件并改进Dockerfile.prod的权限处理，将镜像体积从852MB降至551MB，同时保留文章详情页预生成以确保源站响应稳定。

Git Submodule 不好用：用 GitHub Actions 同步管理多个 Skills 仓库

记录如何用 GitHub Actions 自动同步独立的 Skills 仓库到汇总仓库，解决 Git Submodule 在 npx skills add 场景下的痛点。

记一次：Blender GLB 加载成功，博客首页却坏了一半

把程序化 Three.js 房间替换成 Blender GLB 后，模型能显示，屏幕内容、热点、镜头和家具交互却集体消失。记录我如何用节点契约、运行时绑定和完整 UV 平面把它们重新接回来。

记一次把两个 Agent 页面的流式展示统一了，顺带挖出一个隐形 bug

把 /chat 和 /create 两个 Agent 页面的流式展示统一时，发现工具调用被思考盖住、草稿回填事件名对不上等一堆问题，最终把流式协议下沉成共享层的故事

给小破站加了个 Prompt 模板管理系统

从 content_templates 表迁移到独立的 AI Template 系统，支持版本管理、@ 引用和 LangChain mustache 变量

记一次 Prisma 6 升级 7 的评估与升级指南

对博客项目做了一次 Prisma 6→7 的升级评估，整理了所有 breaking changes、改动量和风险点，顺便记录了完整的升级步骤。

记一次 Docker 镜像拉不下来的坑：镜像代理 + HTTP 代理的组合拳

GitHub Actions 部署时服务器拉取自己推到 Docker Hub 的镜像失败，排查后发现镜像代理只代理白名单公开镜像，私有镜像得走 HTTP 代理。

博客CDN缓存自动化：从发现到修复

给博客加了部署后自动刷新CDN缓存的能力，支持按变更范围精准刷新

为 AI Agent 配置邮件全文搜索索引

为AI Agent配置SQLite FTS5邮件全文搜索索引的完整方案，包括技术选型、数据库设计、增量更新和性能优化。

记一次 acme.sh 证书自动同步腾讯云 CDN 的踩坑

记一次搭建 API 中转站的过程

把家里 NAS 上散落的 API 代理服务统一整合到 NewAPI 中转站，Docker 部署 + frp 穿透 + 独立域名，记录选型、部署和踩坑过程。

记一次给博客配置腾讯企业邮箱发信

记录给博客配置腾讯企业邮箱 noreply@nnnnzs.cn 发信的完整过程，包括 DNS 同步到 Cloudflare、公共邮箱创建、自定义域名验证踩坑。

记一次 MCP Streamable HTTP 和 OAuth 认证改造

记录一次把博客 MCP 接口改造成兼容 Streamable HTTP、Bearer token 和 OAuth discovery 的过程，顺手踩了 Nginx .well-known 和公网 host 的坑。

我用 Three.js 给博客首页造了一个赛博朋克房间

用 Three.js + React Three Fiber 给博客首页做了一个赛博朋克风格的 3D 小公寓，包括程序化纹理、粒子雨滴、动态灯光系统和完整的性能优化方案。

谈谈 API 接口自描述与权限配置系统

介绍 API 接口自描述系统的设计与实现，包括 descriptor 导出、扫描脚本、后台权限配置等功能

谈谈我用 LangChain 重构聊天系统这件事

用手写 ReAct 循环换成 LangGraph createReactAgent，代码少一半，维护成本低很多。

纸上余温 - 聊天系统流程图详解

纸上余温聊天系统的完整流程图，包含前后端交互、大模型调用、向量检索等各个环节的详细说明

谈谈项目文档和代码不同步这件小事

校对项目文档与实际代码的差异，更新了配置管理、向量检索、MCP认证、目录结构等文档

记一次 Telegram Bot 不回复的调试过程

配置缺失引发Bot沉默，双重token冲突，终断一者通灵。

博客数据统计系统重构：增加IP防刷和GA4 事件追踪实践

我在完善博客的数据统计功能，解决了点赞防刷和Google Analytics 4接入的问题。用IP限制防刷，Redis缓存提速，GA4追踪用户行为，还踩了不少坑。

MCP 服务认证优化：移除自定义头部，统一 OAuth 2.0

我舍弃了自定义认证头部，统一使用标准OAuth 2.0，两种认证方式并存，博客MCP服务焕然一新。

深入理解 OAuth 2.0：从原理到实践

深入解析 OAuth 2.0 协议原理、授权流程和 PKCE 安全机制，结合项目实践分享实现经验和安全最佳实践。

Next.js 管理后台性能优化：从 SSR 到接近 SPA 的体验

详细记录 Next.js 管理后台性能优化的完整过程，从问题分析、架构理解、解决方案到实施步骤，实现了路由切换速度提升 70% (600ms → 200ms)，接近 Vue SPA 的用户体验。

从增量向量化到异步队列：RAG 系统架构演进之路

详细记录从复杂的增量向量化方案到异步队列系统的架构演进过程，包括问题分析、设计决策和实施细节。代码量减少 57%，功能增强，质量提升。

Next.js 博客系统权限设计：从零到完整的 RBAC 实现

详细记录了 Next.js 博客系统权限设计的完整实现过程，从问题背景、权限模型设计、多层防护架构、权限工具库实现、API 权限验证、服务层过滤到前端权限控制，提供了完整的 RBAC 权限系统最佳实践。

Next.js 博客构建优化：从按需渲染到静态生成，聊聊文章预渲染改造实践

记录博客从动态渲染改为静态生成的改造过程，介绍 Next.js 的按需重新验证机制以及后续优化方向

博客文章增量向量化与版本管理：从全量更新到智能增量优化的实践

介绍博客系统中实现的增量向量化和版本管理功能，从问题背景、设计思路、技术实现到性能优化，全面解析从全量更新到智能增量优化的实践过程。

自动化部署方案：基于Git监控的后端服务动态部署实践

介绍一套创新的自动化部署脚本，通过Git监控实现后端代码自动拉取、构建、部署，并结合Nginx实现端口动态代理，无需修改前端配置即可灵活切换后端服务端口。