解决了什么问题 GitHub 官方 runner 免费额度有限，自建 self-hosted runner 可以突破时间限制、访问内网资源。搭好 runner 后遇到三个新问题：Runner 注册 token 会过期、私有镜像拉取认证失败...

问题：压缩后 Embedding 变了 给 RAG 对话系统加上上下文压缩（对话历史摘要化）后，向量检索缓存命中率从 60% 跌到接近 0。这不是缓存本身坏了，而是压缩改变了对话历史的向量空间：同一个问题...

# git submodule 三个真实踩坑： detached HEAD、commit 不一致、CI 认证失败 git submodule 是管理多仓库依赖的标准工具，但在团队协作中它有三个高频踩坑点，每一个都让人浪费数小时排查。本...

解决什么问题 每天凌晨自动跑「Python 3.10 / 3.11 / 3.12 × Ubuntu / Windows / macOS」共 9 个组合的测试，或者每周一检查依赖有没有安全更新。GitHub Actions schedule 触发器配合矩阵策略...

上周发完 token 预算告警文章后，有读者问：'用 tiktoken 统计了，但 API 还是爆了预算，为什么？'我复盘发现——不同模型用的编码器不同，同一段文字，token 数可以差 1 倍。中文场景尤其明显...

用 GitHub Actions 的 workflow_dispatch 配合 environment 字段，蓝绿部署、灰度发布都能搭。但跑起来有两个容易踩的坑：inputs 的默认值在特定触发方式下不生效，以及 environment secrets 在...

问题：私有镜像构建每次都从零开始 自建 runner 团队（5台机器）部署后，发现一个诡异现象：每次触发 workflow，明明镜像层缓存应该命中，Docker 构建却总是从第一条指令重新执行。日志里没有任...

很多团队第一次用 Docker 部署应用，打出来的镜像少说 800MB，大的直奔 2GB。push 慢、pull 慢、服务器硬盘被吃光。 本文解决：如何用 Docker 多阶段构建，把镜像体积压缩到原来的 1/5。有具体...

结论：GitHub Actions 缓存失效的4种真实原因，附可复现的配置方案 GitHub Actions 跑 CI 时，依赖缓存总是莫名其妙 miss。明明没改 requirements.txt，缓存却废了；或者改了注释，缓存全失效。...

问题现象 私有镜像每次构建都从零开始，Docker log 只报 warning 但不报错。 配了 cache-from: type=local，明明什么都没改，缓存命中率却一直是 0%。明明跟着官方文档配的，怎么就不生效？ 根...

客服机器人上线 3 个月后，用户开始反馈'答非所问'。查日志发现：单会话 token 数突破 18 万，关键信息被截断，模型拿到的上下文全是碎片。这就是上下文窗口溢出的威力——它不是慢慢来的，是突...

前言 FastAPI 的依赖注入用起来很顺手——路径函数参数里加个 Depends(get_current_user)，认证就自动做了。但我用了一年多，真踩过三个让我debug到凌晨的坑：Depends 的参数在路由匹配前就解析...