技术笔记阅读目录
这里按问题组织源码研读,而不是按文件机械拆分。每篇说明实现、边界、验证方法及尚未完成的实验。
日期说明:本批文章于 2026-11-17 统一整理并发布。文章展示日期按专题归档到 2026-10-14 至 2026-11-16 的过去工作日,每天 1–2 篇,不代表当日真实发表或生产事故记录。
人脸识别服务源码笔记
固定源码提交:b85ee88017bc2ee287822287f01a9c3a45b6f545。
- 一次人脸对比请求如何走完 FastAPI 与 InsightFace
- Base64 图片上传:10MB 限制为什么不等于 10MB 请求体
- 文件头校验里的短路:为什么 RIFF 不足以证明是 WebP
- 余弦相似度被映射后,0.65 阈值究竟代表什么
- 多人照片只取最大人脸:隐藏在算法里的业务选择
- 无人脸、坏图片、模型故障,不应该共享一个失败值
- 人脸计数接口为什么会把推理失败包装成零个人脸
- 线程池不等于无限并发:人脸推理服务的排队边界
- 配置看起来兼容 Pydantic 两代,为什么仍要逐行核对
- 模型只加载一次,是每个进程一次而不是整台机器一次
- Prometheus 指标能被抓取,不代表指标语义正确
- 健康检查返回 200,为什么还不能证明模型服务可用
- 一个环境变量能修复 ONNX Runtime 的可执行栈问题吗
- Docker 代理排障要分层:构建容器不是镜像拉取器
- 接口加了 data 信封,测试脚本为什么还会误报失败
- 连续请求算出的 QPS,不是服务的最大吞吐量
- 写了 Redis 配置与图片哈希,为什么还不算实现缓存
- 从演示到公开服务:人脸 API 的最小上线清单
细胞分割工具链笔记
固定源码提交:fd43764aac2394d1fae8b1a1aa5bc86ff72f4aa0。
- 把细胞分割交给智能体:Skill、客户端与推理服务怎样分工
- 三层配置覆盖顺序:模板、本地文件与进程环境谁说了算
- 一边上传一边计算 SHA-256:流式保存到底保护了什么
- 三维数组不一定是三维细胞:图像轴语义不能靠 ndim 猜
- 单进程推理锁与 GPU 设备选择:服务到底串行到哪一层
- 请求取消后后台线程可能还在跑:推理锁的一个细微边界
- 标签掩膜不是彩色分类图:实例数量为什么不能取最大值
- 让 CSV、掩膜与元数据互相校验:分割结果的三个不变量
- 预览图做了强度拉伸,为什么不能拿它测荧光
- metadata.json 能追溯一次实验,但还不等于完全可复现
- 不用第三方 HTTP 库,怎样把 multipart 请求按块发出去
- 安全解压 ZIP 不只是拒绝 ../:结果包的信任边界
- 临时文件清理要覆盖整条失败路径,不只看 finally 是否存在
- 空 API Key 意味着关闭认证,不能只当成尚未配置
- Compose 的 .env 有两种用途,镜像里又是第三个配置现场
- 调整分割参数前,先证明你比较的是同一个实验
- 600 秒超时不一定是总任务截止时间,inference_ms 也不是总耗时
- 不装 GPU 也能先验收工具链:从小夹具到真实分割的分层测试
验证与写作原则
- 正文使用中文,保留必要技术名称、代码与配置键。
- 源码事实、已执行隔离检查、风险推断与改进建议分开描述。
- 保留固定提交及行号链接,避免后续仓库变更让证据漂移。
- 本次完成 17 项轻量检查;未运行真实模型推理、GPU 压测或准确率评估。
- 不编造上线经历、性能提升、生物学结论或历史事故。
后续专题
本地 LLM 项目尚未取得可访问源码,暂不发布该项目的文章。待源码接入后再阅读、验证和补充,不使用通用大模型文章冒充项目实践。