fix(models): 系统渠道模型 - 上游 ID 重命名级联价格档并补管理端可见性 (#514)

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/content/docs/backend/backend-database.mdx

@@ -172,7 +172,7 @@ docker compose -f docker-compose.deploy.yml up -d backend web
 | --- | --- | --- |
 | `model_channels` | 保存系统渠道与用户渠道的连接配置，以及系统渠道前台别名和排序 | 系统渠道密钥不进入公开目录；公开名称优先使用 `public_alias`，为空时使用原名；按 `sort_order, created_at, id` 升序展示 |
 | `channel_models` | 保存系统渠道中的产品模型标识、上游模型 ID、显示名称、模型 Logo、排序、能力、协议和版本状态 | 模型排序独立保存，不递增价格或能力版本；能力、协议、启用状态和价格仍由 service 强校验 |
-| `channel_model_price_tiers` | 保存系统模型按规格匹配的上游 SKU 与价格 | 价格档与渠道模型同事务保存；未启用或未完成定价的规格不进入普通用户目录 |
+| `channel_model_price_tiers` | 保存系统模型按规格匹配的上游 SKU 与价格 | 价格档与渠道模型同事务保存；未启用或未完成定价的规格不进入普通用户目录。档位 `provider_model_key` 非空时优先于渠道模型上游键发往供应商；管理端修改模型级上游 ID 时，与旧值相同的档位键自动级联跟随，其余显式 SKU 保持不变 |
 | `logical_models` | 保存前台模型的公开名称、Logo、能力类型和归档状态 | 前台模型与系统渠道模型分别维护展示信息；供应线路通过 revision 和 route 关联；`code` 仅在 `archived_at IS NULL` 的活动记录中唯一，归档后可用同 code 重建目录项 |
 
 图片分档尺寸保存在现有模型能力 JSON 的 `image.size.presets` 中，不新增表、列或 SQL 迁移。每项结构为 `{ tier, ratio, size, width, height }`，例如 `{ "tier": "1k", "ratio": "16:9", "size": "1824x1024", "width": 1824, "height": 1024 }`。

docs/content/docs/progress/pending-test.mdx

@@ -79,6 +79,13 @@ description: 当前项目已实现功能的手工验证清单与未确认边界
 - [ ] 在 1200px、1440px、390px 视口核对侧栏、顶栏、Composer、画布 Dock、卡片裁切和横向溢出。
 - [ ] 登录后检查浏览器控制台、保存/恢复、生成失败重试、画布拖拽缩放连线及账号切换后的缓存隔离。
 
+## 价格档上游键级联与重命名告警
+
+- 修复“管理端重命名渠道模型的产品标识 / 显示名称 / 上游模型 ID 后，任务请求仍把旧上游键发给供应商”的问题：价格档 `provider_model_key` 非空时优先于模型级上游键，此前统一价格档会把当时的顶层上游键固化为档位显式值，重命名后被旧值静默遮蔽。
+- `SaveAdminChannelModel` 现在在模型级上游键变更时，把与旧值相同的档位键级联更新为新值；管理员显式配置的其他上游 SKU 不受影响。前端编辑无价格档的旧模型时不再预填顶层上游键，统一价格档检测到与模型级不一致的存量上游键时展示告警并支持一键清除恢复“跟随模型默认”，模型级字段提示存在独立档位上游键。
+- 已通过后端 app 包级联与请求解析回归测试、前端价格档表单单测和生产构建；生产已验证：清除浏览器缓存并强刷后重新保存模型配置，后续请求实际发往新上游 ID。排查过程确认级联盲区符合设计——档位上游键若早于当前模型键谱系（改名发生在线上旧代码时期），来回改名需经过"改回旧键再改回新键"一轮才会被级联覆盖，期间需依赖管理端"清除并跟随模型"告警或直接修库；浏览器缓存的模型目录与 Agent 会话选中值在管理员改名后不会自动刷新，需重新登录或清缓存才会重建。
+- 已知未覆盖：前台逻辑模型（`price_policy=channel`）的路由快照同样会固化档位上游键（`applyRoutedProviderSelection`），本次级联只在渠道模型保存路径生效；逻辑模型路由如出现同类旧键残留，需重新保存对应渠道模型或后续单独处理。
+
 ## 欢迎页开放开关
 
 - 管理员在 `/admin/settings/appearance` 的英文品牌标识下方切换欢迎页，立即保存，沿用功能配置保存及审计流程，默认开启；功能开放页不再编辑该字段。