docs: 路线图冲刺清单细化为两轨排期(守印后端/倩倩姐前端双线)+风险对策
Some checks failed
Clover CI / backend (push) Has been cancelled
Clover CI / frontend (push) Has been cancelled
Clover CI / python-audit (push) Has been cancelled

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
yangqianqian
2026-07-01 19:16:19 +08:00
parent de6466737b
commit 97cdba4f74
2 changed files with 35 additions and 208 deletions

View File

@@ -1,197 +0,0 @@
# 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。
- 能完整跑通一条任务:建产品 → 生成 → 选择 → 审核 → 下载交付包。

View File

@@ -70,18 +70,42 @@
**终点**7/15 孙总讲。**产品要"做出来"不是"定下来"**(孙总:"定下来就太晚了"),冻结点 7/10-7/12。
**可用工作日**7/2(四)、7/3(五)、7/6(一)、7/7(二)、7/8(三)、7/9(四)、7/10(五) = **7 个工作日**
| 时间 | 里程碑 | 关键动作 | 负责 |
|---|---|---|---|
| 7/1 今晚 | 框架就位 | 孙总出"壳"框架和逻辑(小红书先,跨境后);倩倩姐约北哥对内容板块 | 孙总/倩倩姐 |
| 7/1-7/2 | 内容板块对齐 | 倩倩姐与北哥对齐:还差什么、素材库要不要加、看板要不要加。对完告诉孙总"差什么" | 倩倩姐 |
| 7/2-7/3 | P0 修复 | 守印修新建产品链路(#2);文案数量语义对齐(#3 | 守印+倩倩姐 |
| 7/6-7/8 | P1 主攻 | 门禁可配置化(#4)、飞轮呈现(#6)、素材库(#8)、裂变体感(#10)——按北哥对齐结果定取舍 | 两人 |
| 7/8-7/9 | 壳套上 | 把高大上外壳套到真系统上见第5节 | 倩倩姐+孙总 |
| 7/10 | 冻结+联调 | 产品做出来,端到端跑通,北哥可访问测试 | 两人 |
| 7/11-7/12 | 演示准备 | 确定 7/15 是现场演示还是录视频;壳+PPT 方向定 | 孙总+倩倩姐 |
| 7/15 | 讲 | 孙总正式讲 | 孙总 |
### 关键约束
- **守印**7/1 今晚上手(读 HANDOVER+CLAUDE.md、clone、跑通本地环境7/2 起全职后端。
- **倩倩姐(瓶颈)**一人扛两条前端线——目标A真系统前端 + 目标B壳的完整呈现孙总只给框架前端呈现要倩倩姐做。计划围绕给倩倩姐减压设计。
> **占位符策略**(孙总认可):想到但来不及做的功能,先以占位符/禁用按钮放上去,"看起来丰满",后端能不能实现后面再说。这是撑"目标B壳"的合法手段,但**目标A真系统的按钮必须真能用**,两者别混。
### 守印(后端轨)
| 日 | 任务 |
|---|---|
| 7/1晚 | 上手读文档、clone、跑通本地环境用自己的 key |
| 7/2 | **P0** 修新建产品链路(#2)——先诊断"线上失败 vs 本地OK"的差异;当天验证中转站生图是否稳(会议提到几乎全挂) |
| 7/3 | 收尾 #2 + 文案数量语义后端(#3) |
| 7/6-7/7 | **P1** 门禁可配置化(#4)——7维权重/门禁做成可配置合格线80不动 |
| 7/8 | 素材库后端(#8,若北哥确认要) |
| 7/9-7/10 | 联调 + 部署上线供北哥测 |
### 倩倩姐(前端轨,双帽子)
| 日 | 任务 |
|---|---|
| 7/2 | 上午约北哥对齐内容板块 + 文案数量语义前端措辞(#3) |
| 7/3 | 飞轮呈现(#6,轻量节点提示"已学习偏好") |
| 7/6 | 拿孙总壳框架 → 壳呈现开工目标B |
| 7/7-7/8 | 壳呈现 + 裂变体感(#10) |
| 7/9 | 壳套到真系统 + 素材库/看板前端 |
| 7/10 | 联调 |
### 同步/决策点
- **7/2 收工**:北哥对齐结果 → 定 P1 取舍(素材库/看板做不做)→ 告诉孙总"内容板块差什么"
- **7/6**:孙总壳框架到手 → 倩倩姐壳呈现启动
- **7/10**:冻结,端到端跑通,北哥可访问
- **7/12**:定 7/15 现场演示 or 录屏
### 三个风险 + 对策
1. **倩倩姐双线过载(最大风险)**:守印后端尽量自主少等;壳大量用占位符不求真实现(孙总认可"看起来丰满"即可)。
2. **北哥对齐延迟 → P1范围不定**P0 是确认的 bug7/2 无条件先跑P1 全挂在 7/2 对齐后再定。
3. **生图挂(会议提到几乎全挂)**:守印上手第一天就验证中转站生图稳定性,不稳早暴露。
> **占位符策略**(孙总认可):想到但来不及做的功能,先以占位符/禁用按钮放上去,"看起来丰满",后面再迭代。这是撑"目标B壳"的合法手段,但**目标A真系统的按钮必须真能用**,两者别混。
## 5. 高大上界面解法(孙总要求)