docs: sync truth docs, frontend audits, and runbooks

This commit is contained in:
phamnazage-jpg
2026-06-04 20:00:03 +08:00
parent 4b743848bc
commit 7ce72cbc35
20 changed files with 2228 additions and 95 deletions

View File

@@ -274,15 +274,22 @@
- `GET /api/admin/session`
- `POST /api/admin/session/login`
- `POST /api/admin/session/logout`
- 最近真实回读:
- 最近真实回读2026-06-03
- 页面动作验收:`bash ./scripts/acceptance/verify_provider_admin_actions.sh`
- 前端统一入口:`bash ./scripts/acceptance/verify_frontend_acceptance_matrix.sh`
- 浏览器 smoke`bash ./scripts/test/verify_frontend_smoke.sh`
- 本机真实页面级 artifact`artifacts/provider-admin-matrix/1780278231_provider_admin_actions/99-summary.json`
- **远端真实宿主 import 闭环验证**`openai-zhongzhuan` 真实导入成功
- batch_id=2, batch_status=succeeded, access_status=subscription_ready, provider_status=active
- gateway ok=true, status_code=200, has_expected_model=true, completion_ok=true, completion_status=200
- provider_accounts 已创建id=3, host_account_id=7, status=active, binding_state=unassigned
- batch_detail 返回 4 个 managed_resourcesgroup, channel, plan, account
- provider_status API 返回 latest_access_status=subscription_ready
- access_status API 返回 latest_access_status=subscription_ready, closure_type=subscription
- 测试垃圾:
- 本机/远端 provider 验收需要显式清理临时 draft、provider、测试导入资源发布验证若产生真实 git 提交,必须在记录里说明
- **本次验证遗留**batch_id=2 及相关 provider_accountsid=3、managed_resources 为真实生产数据,非临时测试垃圾
- 当前结论:
- `已闭环`
- `已闭环` — providers.html 完整链路draft → import → batch → accounts → status已在 remote43 真实宿主验证通过
### `/portal/admin-batch-import.html`
@@ -2808,3 +2815,57 @@
**更新目标**: 综合评级 A + 符合行业最佳实践
完成补充任务后,项目将完全符合生产级上线运营标准。
## 2026-06-04: 生产宿主默认数据 & OpenClaw 默认模型切换
### 生产宿主 (sub2api on remote43) 操作
- **新建用户**: `long2026` (id=10, balance=100, role=user)
- **新建国产模型分组**: GPT 中转(id=6), DeepSeek(id=7), MiniMax(id=8), Kimi(id=9), GLM 智谱(id=10)
- **新建 API Keys**: 每个分组 1 个 key (sk-long2026-xxxx, 共 10 个)
- **新建 provider 线路**: 6 个 account + 4 个 channel (GPT/GPT-ASXS, DeepSeek 官方+全富力, MiniMax-M3 官方+53hk, Kimi A7M)
- **状态**: 初始导入后 /v1/models 全部 200 OK但 /v1/chat/completions 全部 503进一步排查发现根因不是单纯 upstream 宕机,而是新建 channel 缺失 `channel_model_pricing``model_mapping` 未按宿主真实契约使用 `openai` 嵌套结构,导致 `channel pricing restriction blocked request`
- **修正后结果**: 仅保留当前真实可用供应链DeepSeek 官方、MiniMax 官方),并修复 channel 4/5/6/7 的 `model_mapping` + `channel_model_pricing`
- **普通用户验收**: long2026 经 tksea 普通用户 key 验证后,`tksea-deepseek/deepseek-chat` = 200`tksea-minimax/MiniMax-M3` = 200`tksea-gpt/gpt-5.4` = 503`tksea-kimi/kimi-k2.6` = 503
- **剩余缺口**: GLM 智谱无 upstream key 未导入GPT 组仅 asxs不可用Kimi 组仅 a7m不可用codex2api/xuansuan-kimi 待导入
### OpenClaw 配置变更
- **新增 tksea-\* provider**: tksea-deepseek, tksea-kimi (指向 sub.tksea.top); tksea-gpt, tksea-minimax 更新 models 列表
- **默认模型**: `tksea-minimax/MiniMax-M3` (primary)
- **Fallback 链**: `tksea-deepseek/deepseek-chat``deepseek-official/deepseek-chat`
- **所有 8 个 agent** 统一使用上述 primary/fallback
- **Gateway 已重启并热加载验证通过**
- **可用性测试结果**:
- `tksea-minimax/MiniMax-M3` ✓ 可用(普通用户 long2026 经 tksea 200
- `tksea-deepseek/deepseek-chat` ✓ 可用(普通用户 long2026 经 tksea 200
- `tksea-gpt/gpt-5.4` ❌ 503组内仅 asxs不可用
- `tksea-kimi/kimi-k2.6` ❌ 503组内仅 a7m不可用
- `deepseek-official/deepseek-chat` ✓ 保留为最后兜底 fallback
### 可用线路排名 (按响应测试)
1. **tksea-minimax / MiniMax-M3** — 已通过普通用户 long2026 经 tksea 验收
2. **tksea-deepseek / deepseek-chat** — 已通过普通用户 long2026 经 tksea 验收
3. **deepseek-official / deepseek-chat** — 作为 OpenClaw 最后兜底 fallback
4. **tksea-gpt / tksea-kimi** — 当前未通过普通用户链路验收,不进入默认链路
## 2026-06-04 补充GPT/Kimi 中转复核(第二轮)
- 本机实时直连复测:
- codex2api `/v1/models`=200`/v1/chat/completions`(gpt-5.4)=200
- asxs `/v1/models`=403`/v1/chat/completions`=403Cloudflare 1010
- a7m `/v1/models`=200`/v1/chat/completions`(kimi-k2.6)=429 overloaded
- 生产宿主按真实 schema 复核GPT/Kimi 绑定关系来自 `account_groups` / `channel_groups`,不是旧假设的绑定表。
- 已幂等新增账号 `GPT-Codex2API-中转` 到 GPT 组group_id=6base_url=`https://www.codex2api.com/v1`priority=40schedulable=true。
- long2026 的 GPT 分组 key 经 tksea `POST /v1/chat/completions``gpt-5.4` 实测 200宿主日志确认命中 `account_id=15`
- 本轮未恢复 asxs / a7m原因分别为 403/1010 与 429 overloaded未达到“本机直连 chat=200”门槛。
### 第二轮补充结论修正asxs
- 用户反馈 asxs 在 Hermes/Codex 真实使用中可用,随后按 `curl --noproxy '*'` 复测确认:本机直连 asxs 的 `gpt-5.4` / `gpt-5.5` / `gpt-5.4-mini` 均 HTTP 200。
- 之前用 Python `urllib` 得到的 `403 error code: 1010` 属于验证路径假阴性,不能据此判定 asxs 全局不可用。
- 但当生产宿主 remote43 强制仅命中 `account_id=9 (GPT-ASXS-中转)` 时,`long2026` 的 GPT 分组 key 经 tksea 调用返回 502宿主日志确认上游 asxs 实际返回 `403 error code: 1010`
- 因此当前真相应拆分为:
- **asxs 对本机 CLI 使用链路可用**
- **asxs 对 remote43 生产宿主出口不可用Cloudflare 1010**
- 已恢复 `account_id=15 (GPT-Codex2API-中转)` 为 schedulable=true保证 GPT 组生产可用性asxs 不再作为“已通过生产宿主验收”的线路宣称完成。