摘要： 训练/推理分辨率不一致问题：GSD 对齐与切图推理方案 背景问题 训练数据集分辨率为 512×512，实际部署时希望用 2048×2048 摄像头拍摄，并通过调整摄像头高度让目标物体在图像中保持与训练时一致的物理尺度（即固定 GSD，Ground Sample Distance，每像素对应的实际物理 阅读全文

摘要： print / 断点(debugger) / logging 使用场景对比 核心定位 工具 本质 一句话定位 print 最原始的输出手段 临时看一眼某个值,跑完就完事 断点(debugger) 交互式运行时检查工具 暂停程序,深入检查/修改运行时状态 logging 分级、可持久化的输出系统 长期 阅读全文

摘要： FastAPI 路径参数 与 查询参数 1. 基本概念 路径参数 定义方式:在路径字符串中用 {} 包裹 是 URL 路径的一部分,用于标识"具体访问的资源" 语义上通常表示资源的唯一标识符(REST 风格) 必填,路径中少了这一段,路由直接匹配不上(404) 不能设置默认值 查询参数 定义方式:出 阅读全文

摘要： 视频传输基础概念 三层核心概念 视频从摄像头到最终被处理,涉及三个相互独立、可以自由组合的层面： 层面 解决的问题 常见例子 编码格式(Codec) 画面本身怎么被压缩 H.264、H.265、MJPEG、VP9 封装/容器格式(Container) 压缩后的数据怎么打包组织 MP4、FLV、TS 阅读全文

摘要： Chroma 向量数据库概念 层级对应关系(类比 MySQL) Chroma MySQL 说明 persist_dir(存储实例) database 整个数据存放的根目录 collection table 检索的基本单位,一次 similarity_search 只能在一个 collection 内 阅读全文

摘要： 目标检测中高分辨率小目标检测训练总结 核心原则 训练时目标有多少像素，推理时尽量保持目标像素接近。 模型学习的是目标的像素特征，而不是现实中的实际大小。 例如： 训练： 1024×1024 虫子：40×40 pixel 推理： 1024×1024 虫子：38×38 pixel 效果通常最好。 而不是 阅读全文

摘要： dataclass / pydantic BaseModel / TypedDict 跨进程传递 背景 langgragh项目中中有个字段使用 @dataclass 定义，嵌套在 State（TypedDict）里。 该 State 会通过 AsyncRedisSaver 序列化并跨进程（API ↔ 阅读全文

摘要： 分层架构设计原则 原则一:先画依赖方向图,再定目录结构 在写任何目录之前,先明确一条单向依赖链,例如: api → application → domain(workflows/models) → infra(外部服务客户端) 规则: 箭头只能从左指向右,右边的模块永远不知道左边模块的存在。 dom 阅读全文

摘要： LangGraph 图初始化 & app.state 图初始化：两种写法 写法1：跟 lifespan/ctx 绑定 优点：启动即校验连接。 缺点：新增图要同步改 4 处（lifespan、路由、worker startup、handler）。 写法2：模块级异步单例 优点：随处 await get 阅读全文

摘要： @lru_cache装饰器； 核心概念 缓存的是函数调用后的返回值（一个具体对象），不是函数本身。 第一次调用真正执行函数体；之后所有调用直接返回同一个缓存对象。 maxsize=1 如果函数无参数、只有一种调用方式，写不写效果一样，但写出来更能表达"这是当单例用的"这个意图。 装饰在类上：可行，效 阅读全文