功能介绍
模板中心
内置示例提示词库, 用户挑一条就能套用; 站长在后台增删改
模板中心是 v0.2.0 加进来的, 让不会写提示词的新手也能直接出活。
用户视角
入口: 左侧 sidebar → 模板中心 (桌面) / 创造页"模板"按钮
列表页
- 桌面端: 左侧二级筛选栏 (场景分类 + 仅看收藏) + 顶部搜索框 + 排序下拉 + 卡片网格
- 移动端: 顶部搜索 + 横向场景胶囊 + 卡片瀑布流
- 每张卡显示缩略图 + 标题 + 提示词预览 + 使用次数 + 心形收藏按钮 + 数字
- 排序: 默认 / 使用次数 / 收藏数
详情页 (/templates/detail/?slug=xxx)
- 大图 + 完整提示词 (可一键复制)
- 用此提示词创作 主按钮 — 跳创造页, 提示词已自动填好
- 收藏 按钮 — 标星之后在筛选栏 "仅看收藏" 里能直接找回
URL 自带 slug 参数, 用户可以分享链接给朋友。
收藏
每个用户独立的收藏列表, 不限数量, 跨设备同步 (登录态走后端表)。 模板被站长下架后, 用户的收藏关系仍保留, 但筛选时该模板不再出现。
站长视角
入口: 管理后台 → 模板中心
看得到 / 改得到什么
| 字段 | 含义 |
|---|---|
| Slug | URL 友好短串, 唯一; 一旦发布不可改 (会破坏分享链接) |
| 标题 | 用户列表卡上显示的名字 |
| 分类 | 场景分类 (人像 / 摄影 / 游戏 / UI / 海报 / 信息图...) |
| 提示词 | 完整 prompt, 用户点"用此提示词创作"会原样填到创造页 |
| 缩略图 | 列表卡的封面图; 通过通用上传接口上传后自动填入 URL |
| 排序 | 数字越小越靠前; 同分类内按这个排 |
| 状态 | 上架 / 下架; 下架后不在用户端显示 |
| 落地页 | 是否在落地页 hero 轮播展示 (与下面"首页轮播"配合) |
行内快捷操作
- ★ 星标 — 一键 toggle 是否上首页轮播 (不必进编辑页)
- 上下架 — 一键 toggle 状态
- 编辑 / 删除 — 前者打开表单, 后者物理删除 + 级联清理用户收藏
首页轮播 (Hero Ring)
落地页大圈轮播展示哪些模板, 由两件事决定:
- 模板自身勾选了 落地页展示 (上面表里的"落地页"字段)
- 受 运行时设置 里的
landing.featured_limit数量上限约束 (默认 12, 范围 4-20)
勾选数量超过上限时, 按 sort 升序取前 N 个; 取消勾选不影响该模板自身上架状态。
默认数据
首次启动 imagic 时, 如果 templates 表为空, 系统会自动写入 12 条内置模板
(覆盖人像 / 摄影 / 游戏 / UI / 海报 / 信息图等场景), 全部默认勾选"上落地页"。
升级后如果你想换掉这批默认数据:
- 想全清空: admin 端逐条删
- 想换一批: 自己先新建几条, 把旧的下架或删除即可
已有任何模板时整段跳过, 不会覆盖你的运营数据。
接口 (面向 API 调用方)
只读接口都是公开的:
GET /api/v1/templates/featured— 落地页 hero 轮播数据 (受 featured_limit 约束)GET /api/v1/templates/categories— 全量分类 + 计数GET /api/v1/templates/random?n=3— 随机抽 N 条 (创造页"推荐胶囊"用)
需登录的:
GET /api/v1/templates?category=&keyword=&favorite=&sort=&page=&page_size=— 列表GET /api/v1/templates/by-slug/:slug— 详情POST /api/v1/templates/by-slug/:slug/favorite— 切换收藏POST /api/v1/templates/by-slug/:slug/use— 打点 +1 (用户点 "用此提示词创作")
管理端 (admin only):
GET/POST /api/v1/admin/templatesPATCH/DELETE /api/v1/admin/templates/:idPATCH /api/v1/admin/templates/:id/featured— 行内 toggle 上首页PATCH /api/v1/admin/templates/:id/status— 行内 toggle 上下架