niuniu/sub2api-cn-relay-manager
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
83ee216a4dddbe69e7925db4f009cff577b84a5c
sub2api-cn-relay-manager/docs/EXECUTION_BOARD.md
phamnazage-jpg 83ee216a4d fix(provision): preserve channel model mapping on import
2026-05-19 22:24:32 +08:00

7.6 KiB
Raw Blame History

sub2api-cn-relay-manager 执行板

日期：2026-05-19 当前 Gate：CONDITIONAL_APPROVED（代码门禁通过；2026-05-18 fresh redeploy 验证确认 self_service / subscription 访问链路可打通；2026-05-19 current-code remote43 追踪后发现 DeepSeek/MiniMax 的 channel 创建请求漏传 model_mapping / restrict_models / billing_model_source，已补代码与测试，但真实宿主 access gate 仍需重新验收） 目标：实现独立控制面、零侵入宿主、可导入国产模型并具备可运维的导入/回滚/访问闭环。

本轮已完成

  1. 宿主身份模型统一
    • host 注册时持久化 auth_type/auth_token
    • import / reconcile / rollback-provider / access 运行时链路切换为 host_id 主键
    • provider status / resources / access status / import-batches 支持 host_id 查询维度
  2. managed_resources 宿主维度收口
    • 新增迁移 0004_host_identity_and_managed_resources.sql
    • managed_resources 唯一键提升为 (host_id, resource_type, host_resource_id)
    • 仓储与服务查询切换为 host-scoped 语义
  3. reconcile run 结果按批次收口
    • 新增迁移 0006_reconcile_runs_batch_scope.sql
    • reconcile_runs 补充 batch_id，batch detail 仅返回本批次 reconcile 记录
  4. capability probe 收敛为无副作用探测
    • 不再对真实创建接口发送空 POST
  5. rollback-provider 风险收敛
    • 改为优先按已记录批次资源 RollbackStoredResources() 回滚
    • 缺少已记录资源时拒绝危险删除
  6. 文档真相同步
    • 新增 docs/2026-05-18-PRODUCTION_REMEDIATION_TASK_BOARD.md
    • 下调 DEPLOYMENT.md 中未实现的 /metrics / 限流 / 监控承诺
  7. 真实宿主重新验收已执行
    • self_service 新 artifact：artifacts/real-host-acceptance/20260518_self_service_reaccept_v6
    • subscription 新 artifact：artifacts/real-host-acceptance/20260518_subscription_reaccept_v6
    • 两轮都完成了 preview-import / import / access-preview / status / reconcile / rollback 全链路落盘
  8. reconcile host-scope 证据已补强
    • self_service：artifacts/real-host-acceptance/20260518_reconcile_hostscope_self_service
    • subscription：artifacts/real-host-acceptance/20260518_reconcile_hostscope_subscription
    • 已补齐 status / resources / reconcile / batch detail / rollback 的 host-scoped artifact，验证 batch detail 的 reconcile 视图按 batch 收口
  9. current-code remote43 导入链路已补齐 tunnel-aware 验证能力
    • scripts/import_remote43_provider.sh 新增 CRM_HOST_BASE，允许把“operator 访问 host 地址”和“CRM 进程访问 host 地址”分离
    • latest artifact：/home/long/artifacts/real-host-acceptance/20260519_195827_remote43_deepseek_key_import
    • 结论：import / batch detail / managed resources 已真实落库；本轮定位到 channel 创建缺少 model_mapping / restrict_models / billing_model_source，已补齐实现与测试，待重新跑真实宿主验收

已验证门禁

  • gofmt -l . ✅ 空输出
  • go vet ./... ✅
  • go test ./... ✅
  • go test -race ./... ✅
  • go test -cover ./internal/... ✅
    • internal/access: 77.3%
    • internal/pack: 72.7%
    • internal/provision: 74.6%
    • internal/store/sqlite: 61.3%
  • go test ./tests/integration/... -count=1 ✅

本轮真实宿主复验结果

  1. self_service（最新 fresh redeploy 复验）
    • 证据目录：artifacts/real-host-acceptance/20260518_redeploy_matrix
    • 初始状态：普通用户 key 未绑定 group、用户余额为 0 时，/v1/models 返回 403
    • 修正后：对普通用户执行“key 绑定标准 group + 用户余额=10”后，04-self-after-balance.headers.txt 显示 HTTP/1.1 200 OK
    • 结论：self_service 主链路已在 fresh host 上真实打通；当前关键前置条件已收敛为 runbook 中明确记录的普通用户创建 / key-group 绑定 / 余额要求，而不是代码级阻塞。
  2. subscription（最新 fresh redeploy 复验）
    • 证据目录：artifacts/real-host-acceptance/20260518_redeploy_matrix
    • 修正后：创建 subscription 类型 group、完成普通用户订阅分配、并把普通用户 key 绑定到该 group 后，06-subscription-after-assign.headers.txt 显示 HTTP/1.1 200 OK
    • 结论：subscription 主链路也已在 fresh host 上真实打通；其可用前提不是“宿主自动初始化一切”，而是显式完成 subscription group / user subscription / key binding 这一套运营动作。

2026-05-19 current-code remote43 验收补充结论

  1. 验收入口
    • 证据目录：/home/long/artifacts/real-host-acceptance/20260519_195827_remote43_deepseek_key_import
    • 本地 CRM 通过隧道访问 remote host，CRM_HOST_BASE 指向 CRM 侧可达的 host 地址
  2. 导入链路结论
    • import 成功返回 batch_id=19
    • managed_resources 已包含 group/channel/plan/account
    • provider_status=partially_succeeded，说明已进入真实业务路径，不再是 host 注册/pack path/隧道前置问题
  3. access gate 失败结论
    • latest_access_status=broken
    • access preview available=false
    • reconcile status=drifted，其中 probe_failures=1
  4. 根因归类
    • 09-models.headers.txt / 10-models.body.json 显示普通用户实际看到的是 GPT 系模型，而非预期的 deepseek-v4-pro
    • 因此本轮 FAIL 应归类为“上游 key/模型能力不匹配或普通用户绑定命中了错误 group”，不是 current-code CRM bootstrap / import 主链路故障。

剩余项（含当前外部门禁）

  1. DeepSeek / MiniMax real-host access gate 仍需复验（外部门禁）
    • 真实宿主曾出现普通用户 /v1/models 暴露 GPT 系模型的漂移；本轮已补齐 channel 侧 model_mapping / restrict_models / billing_model_source 传参
    • 53hk 中转 key 当前未验证可用，不能当作主结论
    • 在 current-code remote43 路径上，这一项仍需重新跑真实验收
  2. 结构债务仍存在
    • access / reconcile 尚未完全按 implementation plan 物理拆分
    • 无内置 scheduler/jobs
  3. 运营前置动作需要 runbook 化执行
    • 真实宿主初始化不会自动创建普通用户；验收或上线前必须显式创建普通用户并留存可复用凭据
    • self_service 需要普通用户 key 绑定目标标准 group，且通常还需要可用余额
    • subscription 需要 subscription 类型 group + 普通用户订阅分配 + key/group 绑定
  4. 标准多阶段 Dockerfile 在受限网络环境下仍不稳
    • 当前推荐 scripts/build_local_image.sh + Dockerfile.local
  5. 真实宿主验收工具已补自动化闭环
    • scripts/real_host_acceptance.sh 支持 AFTER_IMPORT_HOOK_COMMAND，可把宿主侧 access 前置动作收敛进同一条 artifact 链
    • scripts/import_remote43_provider.sh 已内置 remote43 subscription 的“补余额 + key/group 绑定 + subscription upsert + 定向 Redis 缓存失效 + host state 落盘”

当前最短上线路径

  1. 按 docs/REAL_HOST_ACCEPTANCE_RUNBOOK.md 准备真实宿主普通用户与凭据
  2. 按目标模式完成必要的 key/group/billing(or subscription) 绑定
  3. 使用 scripts/build_local_image.sh 与 scripts/real_host_acceptance.sh 复跑并归档现场 artifact
  4. 若现场前置满足，本项目按 PRD 首版范围可直接上线

禁止错误结论

  • ❌ 历史失败 artifact ≠ 当前 fresh redeploy 仍失败
  • ❌ capability probe 无副作用 ≠ 所有宿主版本都已真实兼容
  • ❌ rollback-provider 已改安全路径 ≠ 历史脏资源自动消失
  • ❌ HTTP 200 ≠ 宿主初始化会自动准备普通用户/订阅/余额；这些仍是显式运营前置
Reference in New Issue View Git Blame Copy Permalink