服务端和客户端各有一份内容相同的配置加载器。它不是完整 dotenv 实现,而是一套刻意简化的 KEY=VALUE 解析与覆盖逻辑。
真实优先级
加载顺序为 .env.example、同目录 .env、进程环境;后面的同名键覆盖前面。客户端再由命令行参数覆盖部分推理默认值。文件位置由配置模块自身路径决定,不依赖当前工作目录。
模板默认值 < 本地 .env < 进程环境
客户端可调参数:再叠加命令行选项本次隔离执行确认:值中的等号会保留,成对引号会去除,空直径会转为 None,字符串 false 会严格转为 False。这样避免了直接 bool('false') 得到真值的常见陷阱。
不能当成任意 shell 文件
解析器不执行变量替换,也不解析行尾注释。MIN_SIZE=15 # comment 的值会包含注释文本,后续整数转换就可能失败。支持开头的 export,并不意味着支持 shell 的全部语法。
推荐:
# 最小面积,单位为像素
CELLPOSE_MIN_SIZE=15
不应假定支持:
CELLPOSE_MIN_SIZE=15 # 行尾说明缺失检测只看键是否存在,不判断内容是否适合业务。空 API Key 有明确含义,空端口则通常不是有效部署配置;这两类空值不能统一处理。
配置审计不要输出密钥
排查“改了不生效”时,应逐层确认真实来源:文件是否位于对应安装目录,是否被进程环境覆盖,客户端是否又传入命令行参数。可输出经过脱敏的有效配置摘要,但绝不能把完整 API Key 写进日志。
两份加载器允许组件独立交付,也带来同步维护成本。建议对二者运行同一组解析测试,避免一侧升级语法而另一侧仍按旧规则理解。配置优先级写清楚,实验记录才能解释“到底用了什么参数”。
源码与阅读导航
本文属于「细胞分割工具链笔记」第 02 篇。依据固定提交 fd43764aac23 研读,后续版本可能不同。
- cellpose-server/cellpose_config.py,第 1–66 行
- cellpose-segmentation/cellpose_config.py,第 1–66 行
- cellpose-segmentation/scripts/segment.py,第 129–180 行
全部专题与阅读顺序 · 上一篇:把细胞分割交给智能体:Skill、客户端与推理服务怎样分工 · 下一篇:一边上传一边计算 SHA-256:流式保存到底保护了什么
还没有评论
欢迎留下你的观点,保持交流的清晰和友好。