MG-03-011 shadcn管理端
用户指定 satnaing/shadcn-admin 为后台结构与交互基线。 当前基线为 MG-PLUGIN-01 首版,不集成已暂停的 MG-UX-01。保留既有选路内核,增加按模型展开的维护入口。
复用范围
- shadcn-admin 的 Slate 主题、Sidebar/Header/Main、TanStack 表格工具栏/排序/分页和行操作结构。
- 官方 shadcn CLI 生成组件,配置为 new-york / Radix / Slate / Lucide;源码在 web/src/components/ui。
- 网关继续使用现有 React、TanStack Router、Bun、Rsbuild;不搬入模板的 Clerk、客户、团队或演示业务。
- 来源提交、路径、改编说明与 MIT 授权保留在 THIRD_PARTY_NOTICES.md。
固定交互
- 渠道列表:搜索、排序、分页、模型大类与按条/按秒/Token 筛选;展示 24h 样本数、成功率、平均完成耗时及检查时间。少于 20 个终态样本不评稳定性;不以成功率冒充画面质量。
- 渠道详情默认渠道模型清单;另有上游变化与导入、插件与更新、接入设置,共四个标签。
- 渠道模型清单:标准大类 × 计费方式交叉筛选,保留原始型号/参数/采购价格;型号行直接测试。上游变化页保留分类、差异与批量导入。
- 插件:总览入口管理不可变版本;详情绑定执行器对应的插件并配置定期/手动检查。本机 Skill/MCP 为 AI 接入主入口,站内不另建聊天。
- 测试侧栏:固定目标、图/视频/音频 URL、素材角色与排序、手动预览、参数与费用确认。关闭取消不发生成请求;尚不支持文件上传。
- 视频供给路由:每个标准模型分别展开全部已绑定型号(包括停用项);就地优先级/人工启停、自动健康保护原因、原子保存并生效。未绑定供给通过添加/移除入口维护。
- 接入设置:地址、类型、凭据状态、并发;编辑、轮换凭据、连接测试、移除。移除使用 AlertDialog,提交中阻止重复提交与关闭。
插件检查可新增停用草稿与更新自动管理的采购资料;不覆盖人工参数/价格、执行成本和启停。If-Match 版本保护不变。 管理密钥只在页面内存;侧栏偏好 Cookie 不包含身份或凭据。 移除仍为归档,不是硬删除;恢复仍保持停用。截图/测试夹具不代表真实渠道接入成功。
后续维护约束
- 优先组合 components/ui 已有组件,不能重新绘制同名按钮、输入框、弹窗和表格。
- 新组件通过官方 CLI 添加;检查生成文件的 cn 导入路径为 @/lib/utils,不覆盖本地修改。
- 使用语义颜色与组件 variant;业务代码只负责数据和交互,不另起视觉主题。
- 可排序分页列表使用 DataTable;行内编辑路由使用 shadcn Table,确保输入不因单元格重建丢失焦点。
- 登录页、共享外壳、渠道维护和按模型路由列表沿用现有 shadcn 组件,不另起 UI 体系。
- 本轮不启用夜间切换、模板全局搜索或多团队系统,避免仅有外观而无真实功能的入口。
参考差异记录
| 模板 | 网关 | 原因 |
|---|---|---|
| TeamSwitcher、NavUser、演示账号 | 固定内部服务标识与退出 | 不引入客户/团队身份体系 |
| Tasks 表格 | 渠道与上游模型表格 | 保留模式,替换业务列与操作 |
| URL 同步筛选 | 页面本地筛选 | 沿用现有路由契约,不扩散本轮 API 变更 |
| Vite、模板授权集成 | Rsbuild、原管理 Key | 不重写运行环境与安全边界 |
验收状态
验证与剩余范围见 tasks/MG-PLUGIN-01.md。隔离浏览器证据不代表真实上游生成成功; 重大协议变化自动停用待确认、单供给自动保护开关、素材上传仍未完成。