coding-proxy 配置解析与存储

coding-proxy 配置解析与存储 由 Archify 生成的数据流图。 01 / 写入路径 02 / 校验与门禁 03 / 配置源(config.db) 04 / 解析合并 05 / 展开校验与运行时 Dashboard Config 页 · PUT /api/config · 01 / 写入路径 · X-Coding-Proxy-Admin Dashboard Config 页 PUT /api/config X-Coding-Proxy-Admin CLI config 命令 · set / reset / set-secret · 01 / 写入路径 · 可改 bootstrap CLI config 命令 set / reset / set-secret 可改 bootstrap config import · 旧 YAML 一次性导入 · 01 / 写入路径 · 幂等 marker config import 旧 YAML 一次性导入 幂等 marker ConfigService · 边界校验 · 乐观并发 · 02 / 校验与门禁 · 最小化写入 ConfigService 边界校验 · 乐观并发 最小化写入 等价校验门 · verify_equivalence · 02 / 校验与门禁 · 失败即拒写 等价校验门 verify_equivalence 失败即拒写 旧 YAML 只读 · load_config 直读 · 02 / 校验与门禁 · legacy_readonly 旧 YAML 只读 load_config 直读 legacy_readonly secret 表 · 按路径独立存放 · 03 / 配置源(config.db) · stored/env/empty secret 表 按路径独立存放 stored/env/empty master.key · Fernet 主密钥 · 03 / 配置源(config.db) · env 可覆写 master.key Fernet 主密钥 env 可覆写 config_section 表 · 行存在=覆盖 · 删行=默认 · 03 / 配置源(config.db) · JSON 覆盖 config_section 表 行存在=覆盖 · 删行=默认 JSON 覆盖 config.default.yaml · 随包默认基线 · 03 / 配置源(config.db) · $tmpl 节点 config.default.yaml 随包默认基线 $tmpl 节点 密钥注入 · stored 解密·env·empty · 04 / 解析合并 · 三态解析 密钥注入 stored 解密·env·empty 三态解析 compose_raw · defaults ⊕ 覆盖 · 04 / 解析合并 · 深度合并 compose_raw defaults ⊕ 覆盖 深度合并 $tmpl 展开 · ${VAR} 递归展开 · 05 / 展开校验与运行时 · 未定义→空串 $tmpl 展开 ${VAR} 递归展开 未定义→空串 ProxyConfig 校验 · pydantic 构建 · 05 / 展开校验与运行时 · 失败→degraded ProxyConfig 校验 pydantic 构建 失败→degraded GenerationManager · generation 热切换 · 05 / 展开校验与运行时 · 排空旧实例 GenerationManager generation 热切换 排空旧实例 PUT /api/config admin 头鉴权 set / reset 含 bootstrap 导入计划 plan_import 写入覆盖 最小化 diff put_secret Fernet 加密 apply_import 单事务写入 等价校验失败 只读回退 默认值 随包基线 覆盖 行存在即覆盖 合并后文档 compose_raw 三态记录 Fernet 加解密 stored 密文 注入后文档 密钥已就位 展开后文档 待校验 ProxyConfig build + activate 图例 主要数据 策略 / PII 异步批处理 数据存储 数据流