将.env移动到XDG配置路径

将.env移动到XDG配置路径 | AI生成和翻译

首页 2026.07

总结

目标

将 ww 的规范 .env 文件从项目根目录（/Users/lzwjava/projects/ww/.env）迁移到集中的 XDG 风格配置路径（~/.config/ww/.env）。

已完成工作

1. 将 .env 复制到新位置

源文件：/Users/lzwjava/projects/ww/.env
目标文件：/Users/lzwjava/.config/ww/.env（相同 2194 字节，创建于 2026-07-02 03:07）
~/.config/ww/ 目录已存在（包含 note_queue.json 和 note_watch.pid）

2. 更新 ww/env/__init__.py — 加载顺序更改

load_env() 函数现在按以下优先级顺序从 4 个来源加载：

加载顺序	来源	override 参数	用途
第1（最低）	`~/.config/ww/.env`	`False`	规范基础配置 — 设置默认值
第2	`cwd/.env`	默认值	本地按目录的覆盖配置
第3	项目根目录 `.env`	`False`	向后兼容旧位置
第4（最高）	`BASE_PATH/.env`	`True`	显式覆盖机制

关键语义：

override=False = 仅在环境变量未设置时设置（加载顺序靠后的优先）
override=True = 无条件覆盖（最高优先级）
XDG 路径最先加载，以便 cwd/项目根目录可用于开发场景中的覆盖
项目根目录 .env 保留作为后退方案以保持向后兼容
BASE_PATH 仍然是最终覆盖项

3. Git 工作流程

拉取了 2 个新的远程提交（快速向前，无冲突）— 与我们的更改无关
提交了 feat(env): load canonical .env from ~/.config/ww/.env（3935a21）
成功推送到 origin/main
跳过了 pre-commit 单元测试钩子（因 torch 缺少 Python 3.14 wheels 而失败 — 已有问题）

验证

load_env() 运行干净 — 从新位置正确导入 MODEL_PROVIDER、MODEL、BASE_PATH
文件 /Users/lzwjava/.config/ww/.env 存在且内容正确

此更改带来的好处

集中的配置管理 — 一个 .env 文件在所有 ww 会话中共享，与 cwd 无关
配置与代码的清晰分离（遵循 XDG 规范模式）
确认一切正常工作后，后续可删除项目根目录下的 .env 文件

返回捐助