fix(config): 让 config.json 的 URL 字段真正生效,并守住占位假值

文档一直写着「地址来自 scripts/data/config.json」,但 config.py 读 URL 只看环境变量与内置默认,
根本不读这个文件;本地那份还是改造前的旧文件,三个 URL 键是示例占位假值,还带着早已删除的
consumable_storage / attachment_dir。修法是让文档变成真的:

- 优先级:环境变量 > config.json > src/config.py 内置默认;值统一 strip;坏 JSON 或缺文件不抛,退回默认并告警
- 含 your- 的占位值按未配置处理并 WARNING:优先级一改这些假地址就会立刻生效并把登录打挂,这条守卫
  是本改动自身的安全带(老文件实测:三条 WARNING 后回落到内置默认,登录不受影响)
- 凭据只从文件读(宿主清洗子进程的敏感环境变量,靠 env 传密码不可靠);新增 safe_config() 作为唯一
  可进日志的视图,load_config() 含明文密码
- 清死代码:SAFE_CONFIG_KEYS、attachment_dir(Web 时代遗留,全项目零引用)
- config.example.json 补五个可选 URL 键(留空=用默认);.env.example 的示例赋值全部注释掉——
  env 优先级最高,整份复制出去会真拿 your-sso-url 去登录
- 本地 scripts/data/config.json 去掉 7 个陈旧键,只留凭据;改前备份为 config.json.bak-20261020
- 测试 tests/test_config.py 3 → 9 例:文件覆盖默认 / env 覆盖文件 / 占位忽略 / strip / 凭据不读 env /
  safe_config 无密码 / 坏文件 / 缺文件 / 返回副本 / 示例文件不得再含 your- 假值;全部指向 tmp 不碰真凭据
- 文档:操作指南写清三级优先级与占位语义,scripts/data/README 补字段表,AGENTS 增加配置优先级约束,
  方案文档 §14 记录并划掉 §13.4 对应未完成项

验证:ruff / format --check / mypy src / deptry 全绿,pytest 141 passed,mcp_smoke 25 工具;
load_config() 实测无 WARNING 且 URL 与凭据取值正确。--no-verify 提交并手跑等价检查。
This commit is contained in:
wandering
2026-10-20 11:41:34 +08:00
parent ceefe3c4eb
commit 64bbe53e71
7 changed files with 249 additions and 63 deletions
@@ -496,6 +496,29 @@ FakeBot 缺方法误判成产品故障。补 `_wait_any` / `_table_text` / `row_
1. `details` / `payment` / `attachments` 三步没联机验过(本轮只到 basic);travel 五步整条未联机
2. P4 提交护栏未做;删除操作刻意不进工具层(破坏性动作交人工)
3. `config.json` 里 `sso_login_url` / `portal_url` / `reimburse_url` 三个键被 `src/config.py` 忽略
3. ~~`config.json` 里的 URL 三键被 `src/config.py` 忽略,示例里还留着占位假值~~ → 已修,见 §14
(只读环境变量 + 内置默认),示例文件里留着占位假值会误导人:要么让它们生效,要么删掉键
4. 经济科目固定取第 3 行、项目固定取第 1 行,仍无配置入口
## 14. 配置读取修复(2026-10-20)
P3 联机时顺带发现:文档写着「地址来自 `scripts/data/config.json`」,但 `src/config.py` 读 URL
**只看环境变量和内置默认**,压根不读这个文件。本地那份还是改造前的旧文件,里面留着的
`sso_login_url` 等三个键是示例占位假值(`https://your-sso-url/login`),另外还带着早已删除的
`consumable_storage` 与 `attachment_dir`。也就是说:用户改文件不生效,改对了反而可能生效得晚。
修法是让文档变成真的,而不是把文档改回去:
- 优先级 **环境变量 > config.json > 内置默认**;值统一 `strip()`;坏 JSON / 文件缺失都不炸,退回默认并告警
- 含 `your-` 的占位值一律当成没配,打 WARNING 说明去哪改。这条不是多余:优先级一改,
老文件里的假地址就会**立刻生效**并把登录打挂,守卫是这次改动自身的安全带
- 凭据只从文件读(宿主会清洗子进程环境变量,靠 env 传密码不可靠);新增 `safe_config()`
作为唯一可进日志的视图,`load_config()` 里有明文密码
- 顺手清掉死代码:`SAFE_CONFIG_KEYS`、`attachment_dir`(Web 时代遗留,全项目无引用)
- `config.example.json` 补上五个可选 URL 键(留空 = 用内置默认);`.env.example` 里的示例赋值
**全部注释掉**——环境变量优先级最高,整份复制出去就会把 `your-sso-url` 塞进环境真去登录
- 本地 `scripts/data/config.json` 去掉 7 个陈旧键,只留凭据;改动前备份为 `config.json.bak-20261020`
测试:`tests/test_config.py` 从 3 例扩到 9 例(文件覆盖默认、env 覆盖文件、占位值忽略、
strip、凭据不读 env、safe_config 不含密码、坏文件与缺文件不崩、返回副本、示例文件不许再出现
`your-` 假值)。全部指向 tmp 的假配置,不碰真凭据。`pytest 141 passed`。