# Clover 用户操作手册

适用对象：运营、组长、管理员。  
访问地址：由管理员提供；本机预览地址为 `http://localhost:3001`。

## 1. 登录与首次改密

1. 打开平台地址。
2. 输入管理员提供的账号和初始密码。
3. 首次登录会进入「修改密码」页面。
4. 输入当前密码、新密码、确认新密码。
5. 修改成功后，系统会按角色进入对应页面。

角色入口：

- 管理员：进入「系统管理」，可维护产品、标杆笔记、违禁词。
- 组长：进入「审核台」，负责通过或打回内容。
- 运营：进入「开新任务」，负责生成内容和提交审核。

## 2. 录入自己的 API Key

进入「工作配置」或「设置」→「API Key」。

1. 选择 Provider。
2. 粘贴自己的 API Key。
3. 点击「测试」。
4. 提示测试通过后，点击「保存」。

Provider 说明：

- 主通道 apiports：必填，用于文案和图片生成。
- 备用通道 codeproxy：选填，主通道繁忙时自动兜底。
- Gemini：选填，作为备用能力。

注意：

- 系统只显示 Key 后 4 位，不展示完整 Key。
- 每个账号使用自己录入的 Key。
- 后续换 Key 时，点击对应通道的「修改」，重新填写后保存即可覆盖。

## 3. 新建或维护产品

进入「开新任务」。

1. 在产品区域选择已有产品，或点击新建产品。
2. 填写产品名称、品牌词、卖点。
3. 上传产品参考图。
4. 如果要让产品出现在生成图片中，必须至少上传一张清晰产品图。
5. 可给产品图选择场景角色，例如主图、细节、使用场景等。

产品图建议：

- 图片清晰，瓶身或包装完整。
- 不要使用过度裁切、遮挡、强滤镜图片。
- 同一个产品可上传多张图，方便系统按分镜自动选择参考图。

## 4. 创建生成任务

进入「开新任务」。

1. 选择产品。
2. 填写本次内容主题。
3. 选择是否「产品入镜」。
4. 设置每套图片数量。
5. 点击生成。

系统会生成 A/B/C 三套不同叙事：

- A：痛点先行。
- B：场景先行。
- C：成分背书。

生成过程中不要关闭页面。若页面刷新，可回到「历史归档」或当前任务继续查看。

## 5. 选择文案

进入文案选择页后：

1. 分别查看 A/B/C 三套文案。
2. 每套选择 1 条文案。
3. 注意查看质量分和合规提示。
4. 三套都选完后，进入图片选择。

如果文案不满意，可以重新生成。

## 6. 选择图片

进入图片选择页后：

1. 图片按 A/B/C 三套分组展示。
2. 每套需要选满任务设置的图片数量。
3. 点击图片可放大查看。
4. 不满意的图片可重生单张或整套。
5. 如果某批图片失败，页面会显示失败原因，可点击重试。

选图完成后，进入确认预览页。

## 7. 提交审核

在确认预览页：

1. 检查已选文案、图片、标签和标题。
2. 确认无误后点击「提交审核」。
3. 任务会进入「待审核」状态。

被打回后：

1. 在任务页查看打回原因。
2. 按组长意见调整文案或图片。
3. 再次提交审核。

## 8. 组长审核

组长或管理员进入「审核台」。

1. 查看待审核任务。
2. 检查 A/B/C 三套内容、图片和质量分。
3. 通过：内容进入可打包状态。
4. 打回：必须填写打回原因，运营会在任务页看到原因。

## 9. 下载交付包

进入「历史归档」。

1. 找到已通过审核的任务。
2. 点击生成或下载交付包。
3. 下载 zip 文件。

交付包通常包含：

- 每套笔记文案。
- 已选图片。
- 发布清单。
- 合规说明。

下载后请抽查压缩包内容是否完整。

## 10. 裂变扩散

进入「裂变扩散」。

1. 选择一个已经通过审核的源任务。
2. 选择参考程度。
3. 设置裂变套数。
4. 点击开始裂变。
5. 完成后进入裂变结果页查看多套笔记包。

如果系统提示使用了兜底草稿，需要人工复核标题、正文和分镜后再交付。

## 11. 常见问题

提示未配置 API Key：

- 到「设置」→「API Key」录入并测试 Key。

API Key 测试失败：

- 检查 Key 是否复制完整。
- 检查中转站余额和模型权限。
- 检查是否选择了正确 Provider。

产品入镜失败：

- 检查产品是否上传参考图。
- 换更清晰、无遮挡的产品图后重试。

生成进度不动：

- 先刷新页面或回到「历史归档」查看任务状态。
- 若仍无变化，联系管理员检查 worker、SSE 和上游中转站。

图片不符合预期：

- 优先更换更清晰的产品图。
- 对单张图片使用重生。
- 必要时调整主题表达后重新生成。

被组长打回：

- 查看打回原因。
- 按原因修改后重新提交审核。

下载包打不开或内容缺失：

- 重新生成交付包。
- 若仍失败，联系管理员检查 uploads 持久化目录和打包任务日志。

## 12. 客户交付前检查

正式交付客户使用前，管理员需要确认：

- 客户访问域名可打开。
- HTTPS 证书正常。
- 三类账号可登录。
- 首次登录会强制改密。
- 客户账号可以录入并测试 API Key。
- 能完整跑通一条任务：建产品 → 生成 → 选择 → 审核 → 下载交付包。