feat(admin): 站点外观 - 支持 Tab 分类与主题渐变按钮配置

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

@@ -5,6 +5,51 @@ description: 当前项目已实现功能的手工验证清单与未确认边界
 
 # 待测试
 
+## 站点皮肤、控件焦点与外观分类
+
+主按钮填充改为主题参数统一管理，经典黑白采用黑白基础色与 115° 紫蓝渐变；复制主题后可分别编辑明暗模式的纯色/渐变、角度、常态/悬停/按下双色和文字色。创作页“开始创作”与前后台主按钮使用相同参数，危险、幽灵和禁用按钮不套用渐变。后台隔离用户工作台外壳与浮层样式。输入、选择、日期和搜索控件移除重复焦点阴影，保留键盘焦点与错误状态。站点及外观按品牌、登录页、欢迎页、SEO、页尾备案、皮肤六个 Tab 展示，页面草稿统一保存，欢迎页开关继续独立即时保存。
+
+- [x] 前端生产构建、后续类型检查及 9 项主题/渐变专项通过，覆盖主按钮状态、纯色切换清理、复制隔离和非法参数降级。后端外观专项通过，覆盖保存/读取/公开投影、旧数据补齐、非法参数拒绝及经典主题保护。外观 JSON 升为版本 8，无表结构迁移。
+- [x] 隔离浏览器在真实外观路由验证跨 Tab 草稿保留、撤销、校验定位、隐藏视频卸载，以及明暗模式下经典/自定义按钮常态和悬停颜色、输入框无阴影、键盘焦点可见及 390px 无横向溢出。会话与配置使用测试状态，未保存真实站点设置。
+- [x] 渐变扩展后，真实创作页和插件页验证经典主按钮明暗配色；后台编辑器验证纯色/渐变切换、角度修改、跨 Tab 草稿保留、撤销后保存按钮禁用、危险按钮不套用渐变。修复旧配置归一化后误报未保存状态；选择框键盘导航使用可见外框。浏览器 API 为隔离测试配置，持久化由后端临时 SQLite 服务测试验证。
+- [ ] 用真实管理账号保存主题并刷新前后台，确认常态、悬停、按下、禁用、危险操作和浮层控件配色一致；验证媒体文件跨 Tab 选择后保存与刷新回填。
+- [ ] 渐变相关三文件回归为 16 通过、1 失败，失败为原有后台旧警告色别名断言。上一轮完整相关回归还发现模型编辑器网格 CSS 顺序、首屏内置 Logo 引用、BrandLogo 旧主题 hook 三项原有失败；未修改这些无关实现。
+
+## 模型描述与稳定悬浮
+
+后台渠道模型编辑的“模型身份”区新增“模型描述”，公开目录和会话配置透传到二级选项。说明行预留固定高度，一级菜单取消悬浮位移，二级选项取消高度动画；选中、悬浮及键盘聚焦仍显示说明。系统模型未填写描述时不生成名称推测文案。
+
+- [x] 前端 21 项专项测试及含类型检查的生产构建通过；后端保存/公开投影/描述长度专项、数据库包全套迁移回归及接口路由/OpenAPI 冒烟通过。
+- [x] 隔离浏览器加载真实选择器，连续六次切换悬浮的位置和尺寸一致；已配置/空描述、聚焦显示、渠道选择、键盘、明暗图标及 390px 无横向溢出通过。真实编辑组件验证描述回填、修改后提交去空白文本、清空后提交空字符串；接口被测试拦截，未写真实模型。
+- [ ] 在真实管理账号下保存、重新打开并清空描述，刷新创作端确认内容同步；在画布与创作页确认长描述、明暗主题与键盘选择。
+- [ ] PostgreSQL 部署验证 schema v26。此次迁移只添加默认空字符串列；关闭自动迁移时先执行 `migrate-schema up` 和 `migrate-schema verify`。不提供降级迁移，回退使用匹配的数据库备份与二进制版本；未操作实际部署数据库。
+
+## 产品模型分组与渠道展示名
+
+系统渠道目录按能力与产品模型标识分组，二级展示独立渠道名称和价格；后台新增“渠道展示名”，留空使用渠道公开名称。选中值仍为渠道 ID 与模型标识，逻辑模型及个人渠道保持原选择合同。模型 Logo 按需加载原色版本，移除菜单位置染色。
+
+- [x] 前端专项覆盖同产品多个渠道、价格透传、名称变化不改调用身份、能力隔离、排序时元数据稳定，以及逻辑模型和个人渠道边界。
+- [x] 后端 SQLite 专项覆盖字段保存、公开目录及会话投影、长度与管理员校验；版本 24 迁移重复执行保留旧记录的身份和价格。
+- [x] 前端构建与类型检查通过；隔离浏览器在现有应用中加载真实选择器组件，验证 3 个渠道及 0.3/0.3/0.2 积分单价、鼠标和键盘选中身份、Esc 关闭、390px 无横向溢出，以及明暗主题下图标原色保持一致。使用测试配置，未修改真实渠道。
+- [x] 数据库包全套回归通过；旧迁移测试夹具补齐基线应有的 `billing_orders`，覆盖 v24、v25 连续升级。
+- [ ] 使用实际配置确认跨渠道的产品模型标识、展示名和 Logo 一致，填写各渠道展示名后验证画布、创作页与 Agent 模型入口。
+- [ ] 在 PostgreSQL 部署执行版本 24 迁移并验证目录；迁移只新增默认空字符串列，不自动规范化现有产品模型标识。关闭自动迁移的部署先运行 `migrate-schema up` 与 `migrate-schema verify`；没有降级迁移，回退需匹配数据库备份与二进制版本。
+
+## 全协议视频 Token 计费闭环
+
+所有视频协议开放 Token 价格，包含 NewAPI 通道 2；系统渠道和前台逻辑模型共用报价与火山式 24 FPS 公式。平台额外预留 10%，成功后优先有效上游用量，无有效用量时按提交的公式快照结算并退回余量，账单标注公式来源。schema v25 新增公式快照和来源列，不重算历史订单。方案与回滚边界见[视频 Token 计费](/docs/backend/video-token-billing)。
+
+- [x] 后端专项覆盖官方公式、不同代际像素、4K、参考时长非法值、音频分档、免费价、真实用量严格解析、账单退差和补扣。
+- [x] SQLite 集成测试覆盖系统渠道报价与任务预留一致、两种逻辑模型价格策略、报价无账户/账本/任务写入、不可用渠道拒绝与非法素材数量拒绝。
+- [x] 收尾回归覆盖内部模型别名下的报价/预留一致、统一价格保存强校验，以及最高合法单价、倍率、最终金额溢出和汇总后一次取整；预估与结算共用精确金额算法。
+- [x] 前端专项覆盖表单保存/回填、音频 false 匹配、Token 单价摘要、新旧报价接口与预估边界文案。
+- [x] NewAPI 通道 2、NewAPI 视频及自定义视频的 SQLite 集成覆盖报价、预留、无上游用量公式结算、退回 10% 余量和重复结算幂等；v25 迁移重复执行保留历史账单。
+- [x] 最新后端 app/repository/database 视频计费专项、数据库包全套回归通过；前端 41 项计费测试、`bun run build` 和文档 `bun run types:check` 通过。未执行真实收费生成或真实数据库迁移。
+- [ ] 登录管理端配置有声/无声及参考视频价格档，在模型菜单、画布与短剧生产页变更时长/清晰度/音频，确认当前参数报价更新，切换免费档显示 0。
+- [ ] 用真实方舟与 Agent Plan 渠道完成视频任务，核对上游 `completion_tokens`、账单实际金额及退补差额；参考视频最低消耗可能高于公式预估，确认用户能查看预估边界说明。
+- [ ] 使用 Artbox 的 NewAPI 通道 2 保存“视频 Token”，完成无用量视频任务后确认公式结算、10% 余量退回、来源标注；重复轮询/回调不重复扣费。
+- [ ] PostgreSQL 部署验证 schema v25；新代码未启动或未迁移时不要用旧后端保存非 Ark Token 价格。历史无公式快照的收费订单缺少用量仍进入待核对。
+
 ## Agent 历史事件重放导致画布反复冲突
 
 旧会话的画布增量可能缺少版本号。页面刷新重放事件时，原实现先标记冲突；后续完整快照即使确认内容一致，也提前返回而不清除冲突。现在增量拒绝只触发快照校准，由完整快照确认真实冲突；内容一致时更新同步基线并恢复已同步状态。云端仍为已核对的同一基线时，保留待保存的本地编辑，不误判为并发修改。真实冲突继续保留草稿并阻止覆盖，不重放无版本增量，不修改历史数据。