Skip to Content
管理员后台模板管理

模板管理

配图占位：本节用于在后续视觉评审中插入「模板管理」列表页截图（表格列：名称 / 描述 / 分类 / 作用域 / 启用 / 排序 / 缩略图 / 可注入字段）。

用途

/admin/templates 用于维护「模板」——系统或用户创建项目时可一键带入的预设参数集合。管理员可在此新建 / 编辑 / 删除系统模板；用户模板仅展示不可编辑。

主要场景：

  • 新建系统模板：填写名称、描述、分类、可注入字段 JSON，启用后立即出现在用户可见列表。
  • 编辑已有模板：修改名称、描述、可注入字段等，保存即生效。
  • 停用模板：关闭启用开关，模板从用户可见列表中隐藏（不会删除数据）。
  • 删除模板：仅 system 模板可删除；删除前系统弹出确认提示。

使用前准备

  • 仅管理员账号可见；登录态与会话由 AdminGuard 守护。
  • 「可注入字段」必须是合法 JSON 对象，例如 { "ratio": "9:16", "durationSec": 30 }；留空表示无。
  • 「推荐位」由首页调用 /api/templates?recommended=true&limit=3，按 usageCount 倒序返回启用中的 system 模板。
  • 「缩略图 URL」需为可公网访问的图片资源；建议使用相对路径 /docs/screenshots/... 避免污染 CDN。

操作步骤

  1. 打开 /admin/templates。
  2. 点击「新建模板」。
  3. 填写名称、描述、分类。
  4. 在「可注入字段」中粘贴合法 JSON 对象。
  5. 启用 / 排序按需调整。
  6. 保存。
  7. 编辑：点击行内「编辑」打开抽屉，修改后保存。
  8. 启用 / 停用：点击行内按钮快速切换。
  9. 删除：仅 system 模板可删除；删除前系统弹出确认提示。

结果与状态

  • 新建成功：模板行出现在列表中，按 usageCount 与 sortOrder 排序；启用后立即出现在用户首页推荐位。
  • 编辑保存：变更立即生效，所有引用该模板的工作区会按新参数重新带入。
  • 停用：模板行内启用列切换为灰色「已停用」tag；用户可见列表不再展示，但保留数据。
  • 删除：仅 system 模板可删除；删除后 usageCount 历史保留，但前端不再可访问。
  • 推荐位更新：首页「推荐模板」面板会按 usageCount 倒序实时重排，无需手动刷新。

权限和边界

  • 仅管理员账号可见；登录态与会话由 AdminGuard 守护。
  • 系统（system）模板可编辑、删除；用户（user）模板只读，不允许通过此页面改动。
  • 「可注入字段」必须为合法 JSON 对象；非法 JSON 会被服务端拒绝。
  • 「缩略图 URL」必须为可公网访问的图片资源；不可使用 localhost 或内网地址。
  • 「启用」关闭后模板从用户可见列表中隐藏，但不会删除数据；停用操作可随时回滚。
  • 删除操作不可恢复（数据库硬删）；建议先停用观察一段时间再决定是否删除。

常见问题

  • Q：保存时报「可注入字段不是合法 JSON」？ A：检查 JSON 是否漏掉引号、逗号或多了一个尾逗号；推荐用编辑器的 JSON 校验功能确认格式。
  • Q：模板已启用，但首页推荐位没出现？ A：确认 /api/templates?recommended=true 实际返回该模板；可能是 usageCount 为 0 时被其他高用量模板挤掉。调整排序或增加调用即可上推荐位。
  • Q：删除模板提示「存在关联项目」？ A：这是保护性提示；先到「工作区」侧查询引用该模板的项目，迁移或下线后再尝试删除。
  • Q：缩略图不显示？ A：检查 URL 是否可公网访问；浏览器开发工具 Network 面板确认图片实际下载成功。

相关文档

Last updated on
AI 价格中心管理员后台（Dramagon 暗色主题）