框架师

摘要： 用 AI 编程助手这半年多，我最大的体会是：工具的上限取决于你给它立的规矩。裸奔状态的 agent 又快又莽——改代码顺手重构半个仓库、写库不看环境、上下文动辄几十万 token。这篇把我沉淀在 ~/.zcode/AGENTS.md 里的全局规则、配置的 MCP server 和常用 Skills 阅读全文

摘要： 上个月帮一个做即时通信的项目排查内存问题。监控显示服务启动后内存一直缓慢上涨，起初以为是堆内存泄漏，用 JProfiler 抓了 Heap Dump 对比，对象分布看起来很正常——没有明显的大对象滞留，HashMap 和 List 的容量也和预期一致。 但进程 RSS 确实在涨，而且 CPU 占用率 阅读全文

摘要： 上个月帮一个做即时消息的项目排查问题。服务上线一周后，运营反馈有部分用户收不到推送通知。一开始以为是消息队列堆积或者 Redis 挂了，查了一圈都没问题。最后用 Wireshark 抓包，才发现是 Netty 服务端把两条消息拼在一起发出去，客户端解析到一半数据，状态全乱了。 TCP 是流式协议，没 阅读全文

摘要： 上个月凌晨两点，监控群里弹出一条告警：核心服务 CPU 使用率飙到 95% 以上，持续了将近二十分钟。值班同事第一时间 ssh 上了机器，top 一跑，看到 Java 进程 PID 排第一，二话不说直接重启。服务确实短暂恢复，但第二天同一时间段，同样的告警又响了。 重启解决不了的问题，得换个思路查。 阅读全文

摘要： 上个月帮一个项目做性能诊断，场景不算复杂：一个内部管理系统，用 SQLite 做本地缓存和元数据存储。SQLite 的优势在这里是实打实的——没有独立数据库进程、部署零配置、查询延迟低。但问题出在并发写入上。 业务本身是单用户场景，某个定时任务会批量更新配置数据，同时前台页面偶尔会发起查询请求。理论 阅读全文

摘要： 背景 我们项目最近做了从 Session 到 JWT 的迁移。原来的系统用 Spring Session 把用户信息存 Redis，网关层校验 token，逻辑简单清晰。改成 JWT 之后，服务确实轻松了不少——每个节点都能独立验签，不需要 Redis 参与鉴权链路，水平扩展时也不用担心 Sessi 阅读全文

摘要： 接口协议一旦上线就不能随便改，这是常识。但 Protobuf 因为本身支持向前向后兼容，很多人在 schema 更新时习惯比较随意——今天加个字段，明天改下类型，直到出线上问题才发现踩了坑。 我们项目里就有过这样的经历。一次迭代里把某个字段的类型从 string 改成 int32，旧客户端没有这个字 阅读全文

摘要： 上个月帮一个项目做内部知识库的问答系统，用的是 LangChain 搭的 RAG 流程：用户提问 → 向量检索 → 拼接 prompt → 大模型生成回答。看起来是一个标准范式，但上线后出了个问题——模型回答的"自信程度"明显超过了它实际掌握的信息。 更诡异的是，同样的问题，不带检索直接问模型，它反 阅读全文

摘要： 背景 我们有个项目上线后第一个月就经历了一次严重的数据库故障。主库所在服务器因为磁盘故障直接宕机，应用端报错一片，整个服务停了将近四十分钟才恢复。复盘的时候发现几个问题： 一是之前没做过高可用架构，单纯依赖单节点 PostgreSQL，没有任何容灾方案；二是即使后来补了主从复制，故障切换的过程也相当 阅读全文

摘要： 最近把一个中型 Java 项目从 Jenkins 迁到 GitHub Actions，本以为能少操不少心，结果第一条流水线跑了四十几分钟。其中拉 Maven 依赖就花了二十分钟，而且每次 Push 都重新拉，缓存形同虚设。排查后发现，自己在 actions/cache 的用法上漏了一个关键细节：ke 阅读全文