The Garden / Blog

Blogs, page 2

2026-08-31 · blog

从 B 树页分裂到 UNIQUE 索引：主键设计的两个侧面

从一个真实问题出发——随机 code 能不能做主键——讲清 B 树页分裂的机制、自增主键为何免于分裂、自增主键加 UNIQUE 索引的回表查询链路，以及 UNIQUE 冲突的四种解决策略。技术原理与实践 · 7 min read 2026-08-31 · blog

mini-agent 数据库现状梳理：四个 SQLite 文件与十张表的关系图景

从数据表关系梳理 mini-agent：4 个 SQLite 库、10 张业务表，覆盖待办同步、多租户认证配额、幂等任务与记忆压缩，并给出主键设计取舍与迁移优先级。架构与系统 · 8 min read 2026-08-30 · blog

Tomcat到底是什么？——一个“翻译官”的自我修养

解读 Tomcat 在网页应用中的位置与作用，以及为什么 Spring Boot 打包的 Jar 可以直接启动 Web 服务。技术原理与实践 · 8 min read 2026-08-23 · blog

MiniAgent Session 校验优化：把每次请求写库改成按窗口刷新

复盘 MiniAgent 多租户认证中的一次性能优化：为什么同步 SQLite 的每请求 Session 写入会成为瓶颈，如何在不牺牲密码重置、封禁和滑动有效期语义的前提下，把写入频率降到每个 Session 每 5 分钟一次。技术原理与实践 · 16 min read 2026-08-13 · blog

生成式引擎优化（GEO）详解：从方法论到 Claude Code 的分发级打法

拆解生成式引擎优化（GEO）的完整方法论：与传统 SEO 的本质差异、三大量化实践案例，以及为什么 Claude Code 能'总推荐自家商品'——从源码泄漏、自我偏置研究到执行层分发协议的分层剖析。技术原理与实践 · 20 min read 2026-08-13 · blog

LangGraph Checkpoint 深度解析：存储原理、常见坑点与生产实践

基于 LangChain 官方文档与源码，详解 LangGraph checkpoint 的持久化原理（版本号驱动的状态机）、四大核心能力、内置后端选型，以及 thread_id、并发安全、存储膨胀等 21 个生产常见坑点。技术原理与实践 · 28 min read 2026-08-13 · blog

Python 库 pydantic 详解与实践：从核心概念到项目落地

深入解析 Pydantic v2：Rust 内核的校验器、BaseModel 与字段约束、四种 field_validator 模式、模型级验证、ConfigDict 配置，以及在一个 FastAPI LLM 网关项目中的实际应用。技术原理与实践 · 20 min read 2026-08-12 · blog

OpenTelemetry 与 OTLP 详解：从协议规范到遥测技术原理再到 36 个实战坑点

系统拆解 OpenTelemetry 的核心定位与组成、OTLP 协议的编码传输与错误语义、从 API/SDK 分离到上下文传播和采样器的遥测技术原理，以及埋点、指标、采集器、成本等六层 36 个实战坑点。技术原理与实践 · 22 min read 2026-08-11 · blog

网络 API 接口协议详解：aiohttp、FastAPI 与 ASGI/WSGI

从 aiohttp 与 FastAPI 的本质差异出发，拆解 ASGI/WSGI 协议、Starlette 的分层关系，以及服务器-框架-协议之间的完整调用链路。技术原理与实践 · 9 min read 2026-08-10 · blog

面试中被嘲笑 Token 放在 Redis 里？——JWT 无状态的四个致命场景与解法

整理 JWT 无状态设计的边界：主动吊销、封禁、改密踢人与 token 过期吞表单四个致命场景，以及黑名单、白名单和双 Token 续期的对应解法与面试应答思路。专题系列 · 6 min read 2026-08-09 · blog

给 mini-agent 重做意图识别：规则、Judge 与一次不完美的模型选型

记录 mini-agent 如何把自然语言路由改成规则、LLM 和 policy 的三层链路，并用 train/test 评测在速度、参数准确率和安全边界之间选择 qwen3.5-27b。技术原理与实践 · 9 min read 2026-08-08 · blog

一次 aiosqlite 警告背后的资源生命周期漏洞

一次 pytest 非致命 aiosqlite 告警的完整复盘：从偶发的事件循环关闭报错，定位到 ConversationManager 未持有并关闭 checkpoint 连接，再用事务式启动、逆序释放和测试夹具修正资源所有权。技术原理与实践 · 10 min read