文档
03 平台04 媒体供应03_设计

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。

固定交互

  1. 渠道列表:搜索、排序、分页、模型大类与按条/按秒/Token 筛选;展示 24h 样本数、成功率、平均完成耗时及检查时间。少于 20 个终态样本不评稳定性;不以成功率冒充画面质量。
  2. 渠道详情默认渠道模型清单;另有上游变化与导入、插件与更新、接入设置,共四个标签。
  3. 渠道模型清单:标准大类 × 计费方式交叉筛选,保留原始型号/参数/采购价格;型号行直接测试。上游变化页保留分类、差异与批量导入。
  4. 插件:总览入口管理不可变版本;详情绑定执行器对应的插件并配置定期/手动检查。本机 Skill/MCP 为 AI 接入主入口,站内不另建聊天。
  5. 测试侧栏:固定目标、图/视频/音频 URL、素材角色与排序、手动预览、参数与费用确认。关闭取消不发生成请求;尚不支持文件上传。
  6. 视频供给路由:每个标准模型分别展开全部已绑定型号(包括停用项);就地优先级/人工启停、自动健康保护原因、原子保存并生效。未绑定供给通过添加/移除入口维护。
  7. 接入设置:地址、类型、凭据状态、并发;编辑、轮换凭据、连接测试、移除。移除使用 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。隔离浏览器证据不代表真实上游生成成功; 重大协议变化自动停用待确认、单供给自动保护开关、素材上传仍未完成。

On this page