diff --git a/docs/user/使用说明.md b/docs/user/使用说明.md deleted file mode 100644 index c9b84ea..0000000 --- a/docs/user/使用说明.md +++ /dev/null @@ -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。 -- 能完整跑通一条任务：建产品 → 生成 → 选择 → 审核 → 下载交付包。 diff --git a/路线图.md b/路线图.md index cbefd3f..cacc383 100644 --- a/路线图.md +++ b/路线图.md @@ -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 是确认的 bug，7/2 无条件先跑；P1 全挂在 7/2 对齐后再定。 +3. **生图挂（会议提到几乎全挂）**：守印上手第一天就验证中转站生图稳定性，不稳早暴露。 + +> **占位符策略**（孙总认可）：想到但来不及做的功能，先以占位符/禁用按钮放上去，"看起来丰满"，后面再迭代。这是撑"目标B壳"的合法手段，但**目标A真系统的按钮必须真能用**，两者别混。 ## 5. 高大上界面解法（孙总要求）