anonsaber
4cf128fcc8
起因：用户反馈会临时改启动命令（比如给 start 加 --debug）。而 hoststack.yaml 声明的 start.command 优先级最高且每次部署都覆盖控制台旧值，所以每次开关调试面 都得改 YAML、提交、推送、部署——最麻烦的那条路。 改法：把双因子的「开启信号」从单一 argv 变成「argv 或 env 二者之一」： - --debug 保留，本地开发照旧用 - 新增 DEBUG_ENABLED（1/true/TRUE/True/yes/YES，精确匹配），生产走控制台环境变量 - DEBUG_TOKEN 仍然必须非空。刻意不让 token 单独生效——token 是平台上的长期 Secret，让它自己开门就等于把双因子退化成单因子 收益：生产开关调试面 = 控制台改一个 env + 重新部署，不改代码、不改 hoststack.yaml、 不重新构建。启动命令从此静态，顺带消解了"YAML 还是控制台"的争论——命令不再需要变， 放哪都无所谓。 实现：把判定抽成纯函数 debug_surface_requested(debug_arg, debug_enabled_var)， 不直接读全局 env。env 是进程级全局态，测试里读它会和同二进制内其他测试竞争； 调用方传入已取好的值，测试就能覆盖真值集合、假值集合（含 "TRUE " 带空格、 "debug" 这类近似值）与"开了开关但没 token 仍然关闭"。 文档：deployment.md §2.1 双因子条件重写 + 环境变量清单；§5 表格；§5.1 启动命令 说明；reference.md §3 表与调试面描述；design.md 架构图注与 LLM_ALLOW_NET 锚点； charter.md 两条 ID 描述。hoststack.yaml 的 start 注释从"临时加 --debug"改成 "用 DEBUG_ENABLED 切"。 顺带修掉加代码引发的锚点漂移（新代码把 main.rs 后面的行号整体后移 13）： design.md:366、design.md:739、reference.md:205/335/336/380 共 6 处。 验证：cargo test --bin message-weave = 65 passed / 0 failed（新增 4 个测试， 含真值集合、假值集合、无 token 仍关闭）。GATE-DOCS PASS 6/6，259 line-refs 全绿。 |
||
|---|---|---|
| .. | ||
| charter.md | ||
| deployment.md | ||
| design.md | ||
| reference.md | ||
| retired.md | ||
| roadmap.md | ||