一刻工坊｜产品书 V2.0

文档状态：Production Ready
最后更新：2025-12-21
依据：Based on docs/_source_of_truth/ (SSOT)
目标读者：产品经理、投资人、合作伙伴

目录 (Table of Contents)

品牌与定位体系
用户画像与场景
核心用户旅程 (User Journey)
产品信息架构 (IA)
核心功能模块详解
- 5.1 灵感广场与智能喂料
- 5.2 账号诊断与策略蓝图
- 5.3 项目管理中心与资产闭环
- 5.4 智能知识库与文本处理
- 5.5 批量采集与自动化中心
- 5.6 创作工作坊与执行引擎
- 5.7 多端协同与移动生产
管理员后台与企业级特性
系统边界与非目标
FAQ & 常见问题
附录：产品要点速览

1. 品牌与定位体系

1.1 品牌分层说明

明确"一刻工坊"、"趣美丽"、"刻流星"三者的逻辑关系，确保内外认知一致。

层级	名称	定义/职责	适用场景
产品品牌 (对外)	一刻工坊 (YiKe)	面向用户的 SaaS/工具平台名称。包含前端界面、小程序。用户认知中的"软件"。	官网、Logo、销售话术、UI
业务主体 (商业)	趣美丽 (QuMeiLi)	运营主体/母体。承载商业变现与账号矩阵运营。	合同、发票、内部团队归属
技术内核 (对内)	刻流星 (KeLiuXing)	底层 AI 调度引擎/Agent 系统代号。指后端工作流流水线。	技术文档、API前缀、架构图

1.2 竞品差异化矩阵

与市面主流工具的核心差异对比：

维度	剪映 (Jianying)	快影 (QuickCut)	秒剪 (MiaoCut)	一刻工坊 (YiKe)
核心定位	C端创作工具	快速剪辑工具	AI生成工具	企业级内容生产基础设施
主要用户	个人创作者	短视频小白	个人/小团队	MCN机构、品牌方、内容工厂
生产模式	手工剪辑	半自动剪辑	AI单点生成	工业化流水线生产
产能上限	1-2 条/天	3-5 条/天	5-10 条/天	50+ 条/天（矩阵号运营）
内容复用	❌ 无	⚠️ 弱	⚠️ 弱	✅ 强（灵感库+知识库+资产闭环）
标准化能力	❌ 依赖个人	⚠️ 模板化	⚠️ 单任务	✅ SOP流程化+质量可控
多端协同	❌ 无	❌ 无	❌ 无	✅ PC策划+手机拍摄+离线队列
企业级特性	❌ 无	❌ 无	❌ 无	✅ 审计日志+权限管理+API编排
核心竞争力	易用性	速度	AI辅助	规模化+标准化+可追溯性

1.3 品牌架构图

mermaid

graph TB
    subgraph ExternalBrand [对外品牌层]
        YiKe[一刻工坊 YiKe<br/>SaaS产品]
        QuMeiLi[趣美丽 QuMeiLi<br/>美业垂类子品牌]
    end
    
    subgraph BusinessLayer [商业运营层]
        Company[趣美丽公司<br/>Business Entity]
        Revenue[营收模式：SaaS订阅 + 陪跑交付]
        Customer[客户：MCN/品牌方/创作者]
    end
    
    subgraph TechCore [技术内核层]
        KeLiuXing[刻流星引擎 KeLiuXing<br/>AI Workflow Orchestrator]
        Agents[Agent矩阵：策略/文案/视觉/配音/合成]
        Engines[外部引擎：Suno/ComfyUI/Fish Audio/Jianying]
    end
    
    YiKe -->|品牌承载| Company
    QuMeiLi -->|垂类深耕| Company
    Company -->|商业变现| Revenue
    Revenue -->|服务交付| Customer
    YiKe -->|技术底座| KeLiuXing
    KeLiuXing -->|调度| Agents
    Agents -->|接入| Engines

2. 用户画像与场景

2.1 核心用户画像

画像 A：个人创作者（小白向）

典型代表：李晓雨，27岁，美妆博主
背景痛点：

有镜头表现力，但不会剪辑，依赖外包（成本高、沟通累）
账号断更频繁，粉丝增长停滞
想做矩阵号但没时间，一个号都更不过来

核心诉求：

降低门槛：不用学剪辑，会拍就行
提升产能：从周更 1 条到日更 1 条
保证质量：AI 生成的内容不能"一眼假"

使用场景：

早上拍摄 3 条口播素材上传到灵感广场
AI 自动生成 3 种不同风格的成片
下午挑选最满意的 1 条发布

画像 B：MCN 运营（专业向）

典型代表：张运营，32岁，MCN 内容总监
背景痛点：

管理 20+ 个账号，剪辑师产能跟不上
新人培训周期长（2周），质量不稳定
爆款经验无法复用，每次都从头来

核心诉求：

规模化生产：50 条/天的工业化产能
标准化质量：新人也能产出及格线作品
资产复用：爆款结构沉淀为模板，可批量应用

使用场景：

在"策略中心"配置 20 个账号的差异化定位
批量采集器抓取 100 条对标案例
AI 根据各账号定位自动匹配灵感并生成排期
剪辑师只需审核而非从头制作

画像 C：品牌方市场部（企业向）

典型代表：王总监，38岁，连锁美容品牌市场总监
背景痛点：

20 家门店各自为战，内容质量参差不齐
总部统一制作成本高，本地化不足
无法追踪哪家店的视频带来了实际转化

核心诉求：

总部管控：统一审美标准与品牌调性
本地执行：门店长只需拍摄，总部统一剪辑
数据追溯：知道每条视频的播放量、到店率

使用场景：

总部在"知识库"上传品牌手册（颜色/字体/Slogan）
门店长用小程序每天拍摄 3 段顾客对比视频
AI 自动套用品牌模板生成统一风格成片
后台看板实时追踪 20 家店的内容表现

2.2 用户痛点拆解表

痛点维度	具体表现	传统解决方案	一刻工坊解决方案	ROI 提升
产能瓶颈	人工剪辑 1-2 条/天，无法满足日更需求	招更多剪辑师	AI 流水线 50+ 条/天	产能提升 25 倍
标准不一	新人上手慢，成片质量波动大	长周期培训（2周）	SOP 模板化，1 天上手	培训时间缩短 90%
资产浪费	优质素材/文案散落，无法复用	Excel 表格管理	灵感库+知识库统一管理	素材复用率提升 300%
协同困难	PC 策划 -> 手机拍摄 -> PC 剪辑，环节断裂	微信/钉钉传文件	多端实时同步+离线队列	协同效率提升 5 倍
成本失控	外包剪辑 50 元/条，月成本 1.5 万	持续外包	SaaS 订阅 99 元/月	成本降低 99%

2.3 场景化用例矩阵

6 大垂直赛道应用场景：

垂类	典型场景	核心痛点	一刻工坊价值	案例参考
美妆护肤	产品测评、化妆教程	需要统一产品色号/型号表述	知识库强制引用产品参数	趣美丽子品牌
本地探店	餐厅/酒店探访	20 家店各自拍，总部统一剪	移动端拍摄+总部批量生成	连锁美容院案例
知识科普	法律/健康/育儿	AI 容易"一本正经胡说八道"	RAG 强制引用权威文档	律师事务所科普号
音乐混剪	翻唱/二创音乐视频	需要配音+视觉+节奏卡点	Suno音乐+ComfyUI视觉+自动卡点	音乐博主矩阵
产品带货	商品展示/对比评测	需要精准的产品规格描述	结构化 Facts 管理商品库	电商团队
剧情短剧	情感故事/段子	需要分镜脚本+演员台词	AI 剧本生成+智能提词器	短剧 MCN

3. 核心用户旅程 (User Journey)

3.1 完整旅程序列图

从注册到首次发布的端到端流程：

mermaid

sequenceDiagram
    actor User as 用户
    participant Web as 一刻工坊 Web
    participant Mobile as 小程序（拍摄端）
    participant AI as 刻流星引擎
    participant Platform as 发布平台

    Note over User,Platform: 阶段 1：注册与诊断 (Day 1, 30min)
    User->>Web: 注册账号
    Web->>User: 引导进入"账号诊断"
    User->>AI: 回答 20 个诊断问题
    Note right of AI: AI 识别：美妆赛道<br/>真人出镜<br/>目标受众 18-25 岁女性
    AI-->>User: 生成《账号分析报告》
    User->>Web: 确认报告，点击"开始创作"
    
    Note over User,Platform: 阶段 2：灵感采集 (Day 1, 10min)
    User->>Web: 粘贴对标账号链接（3条）
    Web->>AI: 调用解析器提取文案+结构
    AI-->>Web: 返回结构化灵感卡片
    User->>Web: 点击"一键复刻"
    
    Note over User,Platform: 阶段 3：移动拍摄 (Day 2, 20min)
    User->>Mobile: 打开小程序拍摄任务
    Mobile->>User: 显示脚本提词器
    User->>Mobile: 拍摄 3 段口播素材
    Mobile->>AI: 上传素材（离线队列支持）
    
    Note over User,Platform: 阶段 4：AI 生成 (Day 2, 5min 自动)
    AI->>AI: 自动匹配素材+生成配音+合成字幕
    AI-->>Web: 通知"成片已就绪"
    
    Note over User,Platform: 阶段 5：审核发布 (Day 2, 5min)
    User->>Web: 预览 3 种风格成片
    User->>Web: 选择 1 条，点击"下载"
    User->>Platform: 手动发布到抖音/小红书
    Platform-->>User: 获得播放/互动数据

3.2 关键决策点与系统响应

旅程阶段	用户决策点	系统智能响应	预期耗时	效率提升对比
注册诊断	是否需要填写详细信息？	AI 根据回答自动补全，减少 60% 输入	30 分钟	传统问卷需 1 小时
灵感采集	如何找到对标案例？	智能推荐同赛道爆款+Viral Score 评分	10 分钟	人工筛选需 2 小时
拍摄执行	忘词怎么办？	智能提词器自动滚动+语速自适应	20 分钟	人工记词需重拍 3-5 次
AI 生成	如何选择合适风格？	自动生成 3 种风格供对比（活泼/专业/剧情）	5 分钟（后台）	人工剪辑需 2-4 小时
审核发布	如何确保质量？	内置审核 checklist：字幕/音量/比例/水印	5 分钟	传统审核需 30 分钟

3.3 效率提升对比（人工 vs AI）

任务	人工操作耗时	一刻工坊耗时	效率提升	成本节约
账号定位	3 天（市场调研+竞品分析）	30 分钟（AI 诊断）	144 倍	节省 ¥1,500（外包咨询费）
脚本创作	2 小时（构思+改稿）	3 分钟（AI 改写）	40 倍	节省 ¥100（文案外包）
素材拍摄	1 小时（反复重拍）	20 分钟（提词器辅助）	3 倍	节省 ¥50（演员时间成本）
剪辑合成	3 小时（剪辑+调色+配乐）	5 分钟（AI 自动）	36 倍	节省 ¥150（剪辑外包）
批量生产	1 条/天（人工极限）	50 条/天（AI 流水线）	50 倍	月节省 ¥7,500

4. 产品信息架构 (IA)

4.1 左侧导航栏完整层级

基于 frontend/src/router/index.js 的真实路由结构：

一刻工坊 (Root)
├── 🏠 今日中心 (/studio/today)
│   └── 今天要干嘛：快速入口 + 待办任务
├── 📁 项目中心 (/studio/projects)
│   ├── 我的项目列表
│   ├── 项目控制台 (/studio/projects/:id)
│   │   ├── 设置模式（首次配置）
│   │   ├── 执行模式（内容生产）
│   │   └── 项目资产卡片
│   └── 项目回收站
├── 🎯 策略规划 (Strategy)
│   ├── 账号诊断 (/onboarding/diagnosis)
│   ├── 30 天内容蓝图 (/projects/:id/strategy-plan)
│   └── 策略中心（历史策略管理）
├── 💡 内容池 (/studio/content-pool)
│   ├── 📌 全部内容（统一视图）
│   ├── 🎨 灵感笔记（外部采集）
│   ├── 📂 媒体素材（本地上传）
│   └── 🤖 智能喂料（AI 推荐）
├── 🧠 知识中心 (/knowledge)
│   ├── 文档上传（PDF/Docx/MD）
│   ├── 检索实验室（测试召回效果）
│   ├── AI 问答台（RAG 引用）
│   ├── 结构化数据（Facts 管理）
│   └── 知识图谱（可视化）
├── 🎬 创作工坊 (Creative Studios)
│   ├── 脚本引擎（AI 文案生成）
│   ├── 视觉设计（分镜+Prompt）
│   ├── 配音工作流（Fish Audio）
│   ├── ComfyUI 执行器（图像生成）
│   └── 合成实验室（最终成片）
├── ⚙️ 自动化中心 (/automation)
│   ├── 批量采集器（大规模抓取）
│   ├── 定时任务（Cron 触发）
│   └── 工作流市场（预设模板）
├── 📊 任务中心 (/tasks)
│   └── 待处理/进行中/已完成任务
├── 📱 移动端 (/mobile) 【小程序】
│   ├── 今日拍摄（沉浸式相机）
│   ├── 智能提词器（脚本同步）
│   ├── 素材相册（拍摄历史）
│   └── 我的（个人中心）
└── 👤 个人中心 (User)
    ├── 账户设置
    ├── 会员订阅
    └── 我的作品

--- 以下仅管理员可见 ---
🔒 管理后台 (/admin)
├── 数据统计（用户/订单/收入）
├── 用户管理（封禁/权限）
├── AI 模型配置（OpenAI/甄甄）
├── Agent 编排（System Prompt 管理）
├── 审计日志（全站操作记录）
└── 风控中心（内容审核/限流）

4.2 核心页面跳转关系图

mermaid

flowchart TD
    Start([用户登录]) --> TodayHub[今日中心]
    
    TodayHub -->|新用户引导| Diagnosis[账号诊断]
    TodayHub -->|老用户入口| Projects[项目中心]
    
    Diagnosis -->|诊断完成| Blueprint[生成 30 天蓝图]
    Blueprint -->|确认计划| ProjectConsole[项目控制台]
    
    Projects -->|选择项目| ProjectConsole
    ProjectConsole -->|"设置模式"| ProjectSettings[项目配置]
    ProjectConsole -->|"执行模式"| ContentProd[内容生产流]
    
    ContentProd -->|采集灵感| ContentPool[内容池]
    ContentPool -->|解析链接| ParseLink[链接解析器]
    ParseLink -->|生成卡片| Inspiration[灵感笔记]
    
    Inspiration -->|一键复刻| ScriptGen[脚本生成]
    ScriptGen -->|发送脚本| Mobile[小程序拍摄]
    Mobile -->|上传素材| TaskQueue[任务队列]
    
    TaskQueue -->|AI 处理| Workflow[创作工作坊]
    Workflow -->|配音| FishAudio[Fish Audio]
    Workflow -->|视觉| ComfyUI[ComfyUI 执行]
    Workflow -->|合成| FinalStudio[合成实验室]
    
    FinalStudio -->|成片就绪| Preview[预览下载]
    Preview -->|发布| Platform([抖音/小红书])
    
    ContentPool -.->|辅助决策| Knowledge[知识中心]
    Knowledge -.->|强制引用| ScriptGen

4.3 权限分级说明

功能模块	免费用户 (Free)	付费用户 (Paid)	管理员 (Admin)
项目数量	最多 1 个	无限制	N/A
AI 生成次数	每日 3 次	每日 50 次	不受限
知识库容量	10 MB	1 GB	N/A
批量采集	❌ 不可用	✅ 可用	✅ 可用
移动端拍摄	✅ 可用	✅ 可用	✅ 可用
成片水印	✅ 强制叠加	❌ 无水印	❌ 无水印
工作流市场	⚠️ 仅预设模板	✅ 可导入自定义	✅ 可发布到市场
数据看板	⚠️ 基础统计	✅ 完整 Analytics	✅ 全站数据
审计日志	❌ 不可见	❌ 不可见	✅ 可见
Agent 编排	❌ 不可用	❌ 不可用	✅ 可编辑 System Prompt

5. 核心功能模块详解

5.1 灵感广场与智能喂料 (Content Pool & Smart Feed)

对应代码：ContentPool.vue & PoolTabSmartFeed.vue & backend/src/routes/inspiration.js

5.1.1 链接解析器技术实现

支持平台：抖音、TikTok、小红书、B站、快手
调用接口：POST /api/inspiration/parse

解析流程：

链接识别：通过正则匹配识别平台类型（如 douyin.com -> 抖音）
元数据提取：调用第三方 API（TikHub/自研爬虫）获取视频标题/描述/标签/播放数据
文案结构化：通过 LLM 将原始文案拆解为：开头钩子 + 正文逻辑 + 结尾 CTA
封面截图：自动提取视频第 1、3、5 秒关键帧作为封面候选

核心代码片段（inspiration.js）：

javascript

// POST /api/inspiration/parse
const parseLink = async (url) => {
  const platform = detectPlatform(url); // douyin/tiktok/xiaohongshu
  const metadata = await fetchMetadata(url, platform);
  
  // LLM 结构化文案
  const structuredScript = await llm.analyze({
    prompt: `将以下文案拆解为：【开头】【正文】【结尾】\n\n${metadata.description}`,
    model: 'gpt-4o-mini'
  });
  
  return {
    title: metadata.title,
    script: structuredScript,
    viral_score: calculateViralScore(metadata), // 见下节
    tags: metadata.hashtags
  };
};

5.1.2 Viral Score 算法公式

爆款指数（0-100 分）综合以下维度：

公式：

Viral Score = (播放量权重 × 40%) + (互动率权重 × 30%) + (匹配度权重 × 30%)

其中：
- 播放量权重 = min(100, (播放量 / 100万) × 100)
- 互动率权重 = ((点赞数 + 评论数 × 3 + 分享数 × 5) / 播放量) × 100
- 匹配度权重 = 余弦相似度(视频标签, 项目定位标签) × 100

示例计算：

某视频：100万播放，5万点赞，2000评论，500分享
用户项目定位：美妆护肤
视频标签：#护肤 #精华液 #敏感肌

- 播放量权重 = min(100, (100/100) × 100) = 100
- 互动率权重 = ((50000 + 2000×3 + 500×5) / 1000000) × 100 = 5.85
- 匹配度权重 = 0.92（高度匹配） × 100 = 92

最终 Viral Score = 100×0.4 + 5.85×0.3 + 92×0.3 = 40 + 1.76 + 27.6 = 69.36 分

5.1.3 一键复刻的 Prompt 工程机制

核心逻辑：不是简单的"换词"，而是深度理解原视频结构 + 结合用户项目背景进行"二创"。

Prompt 模板（backend/src/services/agents/WritingAgent.js）：

typescript

const rewritePrompt = `
你是一位资深内容策划。现在需要参考以下爆款视频结构，为用户改写脚本。

【原视频结构】
开头：${originalScript.opening}
正文：${originalScript.body}
结尾：${originalScript.ending}

【用户项目背景】
行业：${project.industry}
目标受众：${project.audience}
内容风格：${project.style}
出镜偏好：${project.on_camera ? '真人口播' : '画外音'}

【改写要求】
1. 保留原视频的"情绪曲线"和"逻辑结构"
2. 替换具体案例/产品/场景，使其符合用户行业
3. 语气风格对齐用户项目定位（专业/活泼/剧情）
4. 控制时长在 60 秒内（约 180 字）

请输出改写后的完整脚本：
`;

5.2 账号诊断与策略蓝图 (Diagnosis & Blueprint)

对应代码：AccountDiagnosis.vue & backend/src/routes/strategy.js

5.2.1 AI 问答逻辑

诊断问题设计（共 20 个问题，分 4 个维度）：

维度 1：基础画像（5题）

你的行业/赛道是？（下拉选择：美妆/探店/知识科普/...）
目标受众性别？（男性/女性/不限）
目标受众年龄段？（18-25/26-35/36-45/...）
你是否愿意出镜？（愿意/不愿意/看情况）
你的账号当前状态？（新账号/1000粉以下/1万粉以下/...）

维度 2：内容偏好（5题） 6. 你更喜欢哪种内容形式？（口播/剧情/图文/混剪） 7. 你希望视频时长？（15秒/30秒/60秒/3分钟+） 8. 你希望更新频率？（日更/隔日更/周更） 9. 你有对标账号吗？（粘贴 3 个链接） 10. 你的核心竞争力是？（专业知识/颜值/幽默感/...）

维度 3：痛点挖掘（5题） 11. 你目前最大的困扰？（不知道拍什么/不会剪辑/没时间/...） 12. 你之前尝试过哪些方法？（外包剪辑/模仿爆款/...) 13. 你的预算范围？（<500元/月 / 500-2000 / 不限） 14. 你对 AI 生成内容的接受度？（完全接受/需要人工审核/不接受） 15. 你最关注哪个指标？（播放量/涨粉数/带货转化）

维度 4：资源盘点（5题） 16. 你是否有现成素材？（有大量/有一些/没有） 17. 你是否有专业设备？（有/没有/用手机） 18. 你是否有团队？（solo/2-5人/5人以上） 19. 你是否有品牌合作？（有/没有/计划中） 20. 你的长期目标？（做大做强/变现为主/兴趣为主）

AI 辅助填充逻辑：

javascript

// 当用户选择"美妆"赛道后，AI 自动推断：
if (industry === '美妆') {
  suggested_audience = '18-35岁女性';
  suggested_style = '活泼亲和';
  suggested_tags = ['护肤', '化妆教程', '产品测评'];
}

5.2.2 30 天蓝图生成的 Multi-Step Reasoning

生成流程图：

mermaid

stateDiagram-v2
    [*] --> Step1_Positioning: 诊断数据输入
    Step1_Positioning --> Step2_TopicPool: 账号定位确认
    Step2_TopicPool --> Step3_WeeklyThemes: 生成选题池 (100+)
    Step3_WeeklyThemes --> Step4_DailySchedule: 划分周主题 (4周×7天)
    Step4_DailySchedule --> Step5_ScriptOutline: 每日排期生成
    Step5_ScriptOutline --> [*]: 输出 30 天蓝图
    
    note right of Step1_Positioning
        输入：诊断结果
        输出：核心定位标签
        LLM: gpt-4o-mini
    end note
    
    note right of Step2_TopicPool
        基于定位生成 100+ 选题
        去重/聚类/优先级排序
        LLM: doubao-pro-32k
    end note
    
    note right of Step3_WeeklyThemes
        Week 1: 账号介绍+信任建立
        Week 2: 干货输出+专业展示
        Week 3: 互动引流+粉丝粘性
        Week 4: 转化变现+商业合作
    end note
    
    note right of Step4_DailySchedule
        周一三五：硬核干货
        周二四六：轻松互动
        周日：复盘+预告
    end note

代码实现（backend/src/services/strategyService.js）：

javascript

const generateBlueprint = async (diagnosisData) => {
  // Step 1: 账号定位
  const positioning = await strategyAgent.analyze({
    prompt: `根据诊断数据，总结账号核心定位（3个关键词）\n\n${JSON.stringify(diagnosisData)}`,
    model: 'gpt-4o-mini'
  });
  
  // Step 2: 选题池生成
  const topicPool = await strategyAgent.generateTopics({
    positioning,
    count: 100,
    model: 'doubao-pro-32k'  // 使用大容量模型处理复杂推理
  });
  
  // Step 3: 周主题划分
  const weeklyThemes = [
    { week: 1, theme: '账号介绍+信任建立', topics: topicPool.slice(0, 7) },
    { week: 2, theme: '干货输出+专业展示', topics: topicPool.slice(7, 14) },
    { week: 3, theme: '互动引流+粉丝粘性', topics: topicPool.slice(14, 21) },
    { week: 4, theme: '转化变现+商业合作', topics: topicPool.slice(21, 28) }
  ];
  
  // Step 4: 生成每日排期
  const dailySchedule = weeklyThemes.flatMap(week => 
    week.topics.map((topic, idx) => ({
      date: calculateDate(week.week, idx),
      topic,
      format: determineFormat(idx), // 周一三五硬核，周二四六轻松
      estimated_duration: '60s'
    }))
  );
  
  return {
    positioning,
    weeklyThemes,
    dailySchedule
  };
};

5.2.3 断点续传的状态持久化机制

问题背景：蓝图生成耗时 3-5 分钟，若中途浏览器崩溃或网络中断，需支持"从上次中断处继续"。

Redis 缓存 Key 设计：

blueprint:generate:{user_id}:{project_id}
├── status: 'step_2_topic_pool'  // 当前进度
├── progress: 0.4  // 完成度 40%
├── data: { positioning, topicPool }  // 已生成的中间结果
└── ttl: 3600  // 1小时过期

前端轮询逻辑（StrategyPlan.vue）：

javascript

const pollBlueprintStatus = async () => {
  const { status, progress, data } = await api.get(`/api/strategy/blueprint/status/${projectId}`);
  
  if (status === 'completed') {
    blueprint.value = data;
    stopPolling();
  } else if (status === 'failed') {
    showError('生成失败，请重试');
  } else {
    // 显示进度条
    progressPercent.value = progress * 100;
    // 继续轮询
    setTimeout(pollBlueprintStatus, 2000);
  }
};

5.3 项目管理中心与资产闭环 (Project Console & Asset Loop)

对应代码：ProjectConsole.vue & backend/src/utils/diagnosisMapper.js

5.3.1 Hot-Sync 同步机制的冲突解决算法

核心问题：诊断结果需要同步到项目配置，但要避免覆盖用户手动修改的字段。

解决方案：field_sources 标签保护机制

数据结构（Project 模型）：

javascript

{
  id: 'uuid-xxx',
  name: '我的美妆账号',
  industry: '美妆护肤',  // 来自诊断
  audience_age: '18-25',   // 用户手动修改过
  field_sources: {
    industry: 'diagnosis',     // 标记来源为诊断
    audience_age: 'manual'     // 标记来源为手动
  }
}

同步逻辑（diagnosisMapper.js）：

javascript

const syncDiagnosisToProject = (diagnosisData, existingProject) => {
  const updates = {};
  
  for (const [field, value] of Object.entries(diagnosisData)) {
    const currentSource = existingProject.field_sources[field];
    
    // 规则：只同步"来自诊断"或"尚未填写"的字段
    if (currentSource === 'diagnosis' || currentSource === undefined) {
      updates[field] = value;
      updates[`field_sources.${field}`] = 'diagnosis';
    } else if (currentSource === 'manual') {
      console.log(`字段 ${field} 已被用户手动修改，跳过同步`);
    }
  }
  
  return updates;
};

冲突提示 UI（DiagnosisSyncAlert.vue）：

⚠️ 检测到诊断结果更新

以下字段将同步：
✅ 行业标签：「美妆护肤」
✅ 内容风格：「活泼亲和」

以下字段已被您手动修改，不会同步：
🔒 目标受众：「18-25岁女性」（您的设置：18-30岁女性）

[ 立即同步 ]  [ 忽略 ]

5.3.2 项目回收站的软删除实现

软删除标志位（is_deleted + deleted_at）：

javascript

// 删除项目（软删除）
const deleteProject = async (projectId) => {
  await Project.update({
    is_deleted: true,
    deleted_at: new Date()
  }, {
    where: { id: projectId }
  });
};

// 恢复项目
const restoreProject = async (projectId) => {
  await Project.update({
    is_deleted: false,
    deleted_at: null
  }, {
    where: { id: projectId }
  });
};

定时清理任务（30 天后永久删除）：

javascript

// backend/src/cron/cleanupProjects.js
const cleanupDeletedProjects = async () => {
  const thirtyDaysAgo = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000);
  
  const projectsToDelete = await Project.findAll({
    where: {
      is_deleted: true,
      deleted_at: { [Op.lt]: thirtyDaysAgo }
    }
  });
  
  for (const project of projectsToDelete) {
    // 级联删除关联资产
    await UnifiedAsset.destroy({ where: { project_id: project.id } });
    await Task.destroy({ where: { project_id: project.id } });
    await UserCorpus.destroy({ where: { project_id: project.id } });
    
    // 永久删除项目
    await project.destroy();
  }
  
  console.log(`清理了 ${projectsToDelete.length} 个过期项目`);
};

// Cron: 每天凌晨 3 点执行
cron.schedule('0 3 * * *', cleanupDeletedProjects);

5.3.3 资产闭环的数据库关联查询

目标：在"项目资产"卡片中汇总该项目下产生的所有内容。

SQL 查询示例：

sql

-- 查询项目的完整资产清单
SELECT 
  'inspiration' AS type,
  id,
  title,
  created_at
FROM user_corpus
WHERE project_id = '项目ID' AND is_deleted = false

UNION ALL

SELECT 
  'material' AS type,
  id,
  file_name AS title,
  created_at
FROM unified_assets
WHERE project_id = '项目ID' AND is_deleted = false

UNION ALL

SELECT 
  'task' AS type,
  id,
  CONCAT('任务-', type) AS title,
  created_at
FROM tasks
WHERE project_id = '项目ID' AND status = 'success'

ORDER BY created_at DESC
LIMIT 50;

前端展示（ProjectAssetsCard.vue）：

vue

<template>
  <el-card class="project-assets-card">
    <template #header>
      <span>项目资产</span>
      <el-tag>{{ assets.length }} 项</el-tag>
    </template>
    
    <el-timeline>
      <el-timeline-item 
        v-for="asset in assets" 
        :key="asset.id"
        :timestamp="formatDate(asset.created_at)"
      >
        <el-icon v-if="asset.type === 'inspiration'">📌</el-icon>
        <el-icon v-else-if="asset.type === 'material'">📂</el-icon>
        <el-icon v-else>✅</el-icon>
        {{ asset.title }}
        <el-button link @click="preview(asset)">查看</el-button>
      </el-timeline-item>
    </el-timeline>
  </el-card>
</template>

5.4 智能知识库与文本处理 (Knowledge Center & Text processing)

对应代码：backend/src/services/knowledge/

5.4.1 核心服务矩阵

KnowledgeIngestService：负责文件解析（PDF/Docx/MD）与向量化入库。
KnowledgeAskService (RAG)：执行"强制引用"问答，确保每一个 AI 结论都有据可查。
KnowledgeRerankService：对召回的文档片段进行二次排序，提升精准度。
KnowledgeConflictDetector：自动检测知识库内部的矛盾或冲突。
KnowledgeGapAnalyzer：根据用户查询频率识别知识盲区。

5.4.2 知识库处理流程与文本切片策略

本系统采用自研的 Markdown-Aware Sliding Window (标题感知滑动窗口) 算法，由 KnowledgeTextUtils.js 实现：

标准化 (Normalization)：统一换行符，移除冗余空格与连续空行。
分段 (Sectioning)：识别 Markdown 各级标题（# 到 ######），将文档拆分为逻辑段落，确保标题 context 始终伴随内容。
切片 (Chunking)：
- 窗口大小 (Chunk Size)：1000 字符。确保单个片段包含足够完整的语义。
- 重叠跨度 (Overlap)：180 字符。在相邻切片间保留重叠部分，防止长难句在边界处被生硬切断导致语义丢失。
Token 估算：针对中英混合文本，采用 3.5 字符/Token 的保守估算逻辑，辅助模型进行上下文窗口管理。

5.4.3 RAG 问答的 Rerank 机制

问题背景：向量检索（Embedding Similarity）容易召回"表面相似但语义无关"的文档。

解决方案：二次排序（Rerank）

流程（KnowledgeRerankService.js）：

javascript

const rerank = async (query, retrievedChunks) => {
  // Step 1: 向量检索（粗排）召回 Top 20
  const candidates = retrievedChunks.slice(0, 20);
  
  // Step 2: LLM 精排（细排）
  const rerankedChunks = await llm.rerank({
    query,
    candidates,
    prompt: `
      请为以下文档片段的相关性评分（0-100）：
      
      查询：${query}
      
      候选片段：
      ${candidates.map((c, i) => `[${i}] ${c.text}`).join('\n\n')}
      
      输出格式：[索引:分数, 索引:分数, ...]
    `,
    model: 'gpt-4o-mini'
  });
  
  // Step 3: 按分数排序，返回 Top 5
  return rerankedChunks
    .sort((a, b) => b.score - a.score)
    .slice(0, 5);
};

5.4.4 强制引用的实现原理

核心约束：AI 回答必须携带 chunk_id 数组，前端据此渲染"引用编号"。

Prompt 约束（KnowledgeAskService.js）：

typescript

const askWithCitation = async (question, context) => {
  const prompt = `
你是一位专业的知识助手。请严格基于以下文档片段回答问题，不得杜撰任何内容。

【重要规则】
1. 每一个结论都必须标注来源编号，格式：[1]、[2]
2. 如果文档中没有答案，明确回复"文档中未提及相关信息"
3. 不得使用任何未在文档中出现的知识

【文档片段】
${context.map((chunk, i) => `[${i+1}] ${chunk.text}`).join('\n\n')}

【用户问题】
${question}

【你的回答】
`;

  const answer = await llm.chat({ prompt, model: 'gpt-4o-mini' });
  
  // 解析引用编号
  const citations = extractCitations(answer);  // 正则提取 [1] [2]
  
  return {
    answer,
    citations: citations.map(idx => context[idx - 1].chunk_id)
  };
};

前端渲染（CitationsPanel.vue）：

vue

<template>
  <div class="answer-with-citations">
    <p v-html="highlightCitations(answer)"></p>
    
    <el-divider />
    
    <h4>引用来源</h4>
    <el-collapse>
      <el-collapse-item 
        v-for="(cit, idx) in citations" 
        :key="cit.chunk_id"
        :title="`[${idx + 1}] ${cit.heading}`"
      >
        <pre>{{ cit.text }}</pre>
        <el-button link @click="viewFullDoc(cit.document_id)">
          查看完整文档
        </el-button>
      </el-collapse-item>
    </el-collapse>
  </div>
</template>

5.4.5 知识冲突检测的语义相似度阈值

应用场景：当用户上传多份文档时，系统自动检测"矛盾表述"。

示例：

文档A：「敏感肌推荐使用烟酰胺浓度 2% 以下」
文档B：「烟酰胺浓度建议 5% 最佳」

检测逻辑（KnowledgeConflictDetector.js）：

javascript

const detectConflicts = async (newChunk, existingChunks) => {
  const conflicts = [];
  
  for (const existing of existingChunks) {
    // 1. 计算语义相似度（Embedding Cosine）
    const similarity = cosineSimilarity(
      newChunk.embedding,
      existing.embedding
    );
    
    // 2. 仅对"高度相似"的片段进行冲突检测
    if (similarity > 0.85) {  // 相似度阈值
      const isConflict = await llm.checkConflict({
        text1: newChunk.text,
        text2: existing.text,
        prompt: `
          判断以下两段文字是否存在逻辑矛盾：
          
          文本1：${newChunk.text}
          文本2：${existing.text}
          
          输出格式：{ "is_conflict": true/false, "reason": "..." }
        `,
        model: 'gpt-4o-mini'
      });
      
      if (isConflict.is_conflict) {
        conflicts.push({
          chunk_id_1: newChunk.id,
          chunk_id_2: existing.id,
          reason: isConflict.reason
        });
      }
    }
  }
  
  return conflicts;
};

5.5 批量采集与自动化中心 (Batch & Automation)

对应代码：backend/src/routes/batch.js & backend/src/routes/automation.js

5.5.1 批量采集器的并发控制

支持输入：CSV/Excel 文件，格式如下：

csv

关键词,平台,数量
护肤精华推荐,douyin,10
敏感肌救星,xiaohongshu,15
祛痘神器,bilibili,20

并发策略：使用 p-limit 控制并发数，避免触发平台反爬虫。

代码实现（BatchCollector.js）：

javascript

const pLimit = require('p-limit');

const batchCollect = async (keywords, options = {}) => {
  const { platform = 'douyin', concurrency = 3 } = options;
  const limit = pLimit(concurrency);  // 最多同时 3 个请求
  
  const tasks = keywords.map(keyword => 
    limit(async () => {
      try {
        const results = await fetchVideos(keyword, platform);
        await saveToDatabase(results);
        return { keyword, status: 'success', count: results.length };
      } catch (err) {
        return { keyword, status: 'failed', error: err.message };
      }
    })
  );
  
  const summary = await Promise.all(tasks);
  return summary;
};

5.5.2 自动化中心的 Cron 触发器配置

支持规则：

定时触发：每天 10:00 执行
事件触发：项目创建后自动执行
手动触发：用户点击"立即执行"

数据结构（Automation 表）：

javascript

{
  id: 'uuid-xxx',
  name: '每日追踪热点',
  trigger_type: 'cron',  // cron / event / manual
  cron_expression: '0 10 * * *',  // 每天 10:00
  workflow_id: 'collect-trending',
  enabled: true,
  retry_policy: {
    max_attempts: 3,
    backoff: 'exponential'
  }
}

执行引擎（backend/src/services/AutomationEngine.js）：

javascript

const cron = require('node-cron');

const setupAutomations = async () => {
  const automations = await Automation.findAll({ where: { enabled: true } });
  
  for (const auto of automations) {
    if (auto.trigger_type === 'cron') {
      cron.schedule(auto.cron_expression, async () => {
        console.log(`执行自动化任务: ${auto.name}`);
        await runWorkflow(auto.workflow_id, auto.retry_policy);
      });
    }
  }
};

5.6 创作工作坊与执行引擎 (Creative Studios & Workflows)

对应代码：VisualAgent.js, voiceoverWorkflow.js, ComfyUIFormGenerator.vue

5.6.1 视觉设计 Agent

功能：生成分镜构图描述、转场建议及针对 SD/Flux 优化的英文 Prompt。

Prompt 工程示例（VisualAgent.js）：

javascript

const generateVisualPrompt = async (sceneDescription) => {
  const prompt = `
你是一位专业的视觉导演。请为以下场景生成高质量的图像生成 Prompt。

【场景描述】
${sceneDescription}

【输出要求】
1. 使用英文，符合 Stable Diffusion/Flux 语法
2. 包含：主体/构图/光线/风格/质量标签
3. 避免负面提示词（如 low quality, blurry）

【输出格式】
{
  "positive": "...",
  "negative": "...",
  "style": "..."
}
`;

  return await llm.chat({ prompt, model: 'gpt-4o-mini' });
};

5.6.2 自动化配音流（Fish Audio 集成）

API 调用流程（voiceoverWorkflow.js）：

javascript

const generateVoiceover = async (text, voice_id, options = {}) => {
  const { speed = 1.0, volume = 1.0, emotion = 'neutral' } = options;
  
  // 调用 Fish Audio API
  const response = await fetch('https://api.fish.audio/v1/tts', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.FISH_API_TOKEN}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      text,
      voice_id,
      speed,
      volume,
      emotion
    })
  });
  
  const { audio_url, billing } = await response.json();
  
  // 下载音频到本地
  const audioPath = await downloadAudio(audio_url);
  
  return { audioPath, billing };
};

5.6.3 ComfyUI 动态执行器

核心逻辑：解析 JSON 工作流模板，动态生成可视化表单。

JSON 模板示例：

json

{
  "workflow_id": "flux-image-gen",
  "nodes": [
    {
      "id": "1",
      "type": "PromptInput",
      "params": {
        "positive": { "type": "string", "required": true },
        "negative": { "type": "string", "required": false }
      }
    },
    {
      "id": "2",
      "type": "KSampler",
      "params": {
        "seed": { "type": "number", "default": -1 },
        "steps": { "type": "number", "default": 20 },
        "cfg_scale": { "type": "number", "default": 7.5 }
      }
    }
  ]
}

动态表单生成（ComfyUIFormGenerator.vue）：

vue

<template>
  <el-form :model="formData">
    <el-form-item 
      v-for="param in flattenParams" 
      :key="param.key"
      :label="param.label"
    >
      <el-input v-if="param.type === 'string'" v-model="formData[param.key]" />
      <el-input-number v-else-if="param.type === 'number'" v-model="formData[param.key]" />
    </el-form-item>
    
    <el-button @click="runWorkflow">执行</el-button>
  </el-form>
</template>

5.6.4 合成实验室（Final Studio）

功能：汇总脚本、配音、视觉资产，进行最终的多轨融合。

合成流程：

读取任务关联的所有资产（视频片段、音频、字幕文件）
调用 FFmpeg 进行多轨合成
叠加水印（免费用户）、片头片尾
导出为 MP4 或剪映草稿

FFmpeg 命令示例：

bash

ffmpeg -i video.mp4 -i audio.mp3 -i subtitle.srt \
  -c:v libx264 -c:a aac \
  -vf "subtitles=subtitle.srt,drawtext=text='Created by YiKe':x=W-w-10:y=H-h-10" \
  -shortest \
  output.mp4

5.6.5 智能调度决策（Orchestrator）

引擎路由机制（OrchestratorService.js）：

javascript

const routeTask = (taskManifest) => {
  const { complexity, require_state, external_api } = taskManifest;
  
  // Node 引擎：轻量级、高并发
  if (complexity === 'simple' && !require_state) {
    return 'node';
  }
  
  // LangGraph 引擎：多轮推理、状态纠偏
  if (require_state || complexity === 'complex') {
    return 'langgraph';
  }
  
  // n8n 引擎：跨平台 API 调用
  if (external_api.includes('zapier') || external_api.includes('webhook')) {
    return 'n8n';
  }
  
  // Flowise 引擎：RAG 知识检索
  if (taskManifest.workflow_type === 'knowledge_qa') {
    return 'flowise';
  }
  
  return 'node';  // 默认
};

5.7 多端协同与移动生产 (Multi-Terminal & Mobile)

对应代码：miniprogram/ & backend/src/services/workflow/

5.7.1 AR 构图辅助

移动端实现（camera/index.vue）：

vue

<template>
  <view class="camera-container">
    <camera 
      device-position="back" 
      flash="off"
      @ready="onCameraReady"
    >
      <!-- AR 辅助线叠加层 -->
      <canvas 
        v-if="showGrid" 
        canvas-id="ar-grid" 
        class="ar-overlay"
      />
    </camera>
    
    <button @click="toggleGrid">九宫格辅助</button>
  </view>
</template>

<script>
const drawGrid = (ctx, width, height) => {
  ctx.strokeStyle = 'rgba(255, 255, 255, 0.5)';
  ctx.lineWidth = 2;
  
  // 绘制九宫格
  for (let i = 1; i <= 2; i++) {
    // 竖线
    ctx.moveTo(width / 3 * i, 0);
    ctx.lineTo(width / 3 * i, height);
    // 横线
    ctx.moveTo(0, height / 3 * i);
    ctx.lineTo(width, height / 3 * i);
  }
  
  ctx.stroke();
};
</script>

5.7.2 智能提词器同步

同步逻辑：

PC 端保存脚本 -> 触发 WebSocket 推送
小程序接收推送 -> 本地持久化
拍摄时自动加载 -> 语速自适应滚动

小程序端（teleprompter/index.vue）：

vue

<template>
  <view class="teleprompter">
    <scroll-view 
      :scroll-top="scrollPosition" 
      scroll-y
      @scroll="onScroll"
    >
      <text 
        v-for="(line, idx) in lines" 
        :key="idx"
        :class="{ active: idx === currentLine }"
      >
        {{ line }}
      </text>
    </scroll-view>
    
    <button @click="startScrolling">开始</button>
    <button @click="adjustSpeed">快/慢</button>
  </view>
</template>

<script>
const startScrolling = () => {
  scrollTimer = setInterval(() => {
    scrollPosition.value += speed.value;  // 根据语速调整
    currentLine.value = Math.floor(scrollPosition.value / lineHeight);
  }, 50);  // 每 50ms 滚动一次
};
</script>

5.7.3 离线任务队列

本地缓存 + 自动重传（services/offline.js）：

javascript

// IndexedDB 存储离线任务
const saveOfflineTask = async (videoBlob, metadata) => {
  await db.put('offline_tasks', {
    id: generateId(),
    video: videoBlob,
    metadata,
    status: 'pending',
    created_at: Date.now()
  });
};

// 网络恢复后自动上传
const syncOfflineTasks = async () => {
  const tasks = await db.getAll('offline_tasks');
  
  for (const task of tasks) {
    if (task.status === 'pending') {
      try {
        await uploadVideo(task.video, task.metadata);
        await db.delete('offline_tasks', task.id);
      } catch (err) {
        console.error('上传失败，保留队列:', err);
      }
    }
  }
};

// 监听网络状态
uni.onNetworkStatusChange((res) => {
  if (res.isConnected) {
    syncOfflineTasks();
  }
});

6. 管理员后台与企业级特性 (Admin & Enterprise)

对应代码：frontend/src/views/admin/ & backend/src/middleware/adminAuth.js

6.1 AI 供应商与模型编排

6.1.1 多模型网关配置表

管理员可在后台配置不同场景使用的模型，实现灵活切换。

场景 (Scene)	默认模型	可选模型	切换理由
账号诊断	gpt-4o-mini	doubao-pro-32k, gpt-4o	简单问答，mini 足够
蓝图生成	doubao-pro-32k	gpt-4o, claude-3-sonnet	需要大容量推理
脚本改写	gpt-4o-mini	gpt-4o, wenxin-4	创意性任务，mini 足够
知识问答	gpt-4o-mini	doubao-pro-32k	RAG 任务，速度优先
视觉 Prompt	gpt-4o-mini	gpt-4o	英文 Prompt 工程

6.1.2 Agent 系统 Prompt 在线编辑

界面操作（AgentConfigs.vue）：

选择 Agent（如 StrategyAgent）
编辑 System Prompt（Markdown 格式）
点击"保存并热更新" -> 即时生效，无需重启服务

后端热更新机制（backend/src/services/agents/BaseAgent.js）：

javascript

class BaseAgent {
  constructor({ name, model, systemPrompt }) {
    this.name = name;
    this.model = model;
    this.systemPrompt = systemPrompt;
    
    // 订阅配置更新事件
    eventBus.on(`agent:${name}:update`, (newPrompt) => {
      console.log(`Agent ${name} 热更新 System Prompt`);
      this.systemPrompt = newPrompt;
    });
  }
}

6.2 安全、审计与风控

6.2.1 审计日志字段定义表

字段名	类型	说明	示例值
`id`	UUID	日志唯一标识	`uuid-xxx`
`user_id`	UUID	操作用户 ID	`user-123`
`action`	String	操作类型	`user.delete`, `model.update`
`resource_type`	String	资源类型	`User`, `AiModelConfig`
`resource_id`	UUID	资源 ID	`user-456`
`old_value`	JSON	修改前的值	`{ "role": "user" }`
`new_value`	JSON	修改后的值	`{ "role": "admin" }`
`ip_address`	String	操作 IP	`192.168.1.100`
`user_agent`	String	浏览器 UA	`Mozilla/5.0...`
`timestamp`	DateTime	操作时间	`2025-12-21 15:30:00`

6.2.2 风控策略

限流规则：

javascript

// 单用户限流（基于 IP + User ID）
const rateLimits = {
  'api:generate': { window: '1m', max: 10 },  // 每分钟最多 10 次生成
  'api:upload': { window: '1h', max: 100 },   // 每小时最多 100 次上传
  'api:query_kb': { window: '1m', max: 30 }   // 每分钟最多 30 次知识库查询
};

内容审核：

javascript

// 敏感词过滤（调用第三方 API）
const moderateContent = async (text) => {
  const result = await fetch('https://api.aliyun.com/content-moderation', {
    method: 'POST',
    body: JSON.stringify({ content: text })
  });
  
  if (result.risk_level === 'high') {
    throw new Error('内容包含违规信息，已拦截');
  }
};

7. 系统边界与非目标

7.1 明确不做的功能清单

我们是"内容生产基础设施"，不是以下工具：

类型	典型产品	我们不做的原因
精细剪辑工具	Adobe Premiere / Final Cut Pro	目标用户不需要帧级精度，AI 自动化足够
社交分发平台	OnlyFans / Patreon	专注于生产环节，分发留给原生平台
数据分析平台	飞瓜/蝉妈妈	轻量级统计即可，深度分析有专业工具
在线协作工具	石墨/飞书文档	仅限内容生产协作，不做通用文档编辑
培训/教育平台	网易云课堂	提供 SOP 模板，不做系统性培训课程

7.2 技术边界（不支持的场景）

不支持的文件格式：

视频：.avi, .wmv, .flv（仅支持 .mp4, .mov, .webm）
音频：.wma, .flac（仅支持 .mp3, .wav, .m4a）
文档：.pages, .odt（仅支持 .pdf, .docx, .md）

不兼容的浏览器：

IE 11 及以下（仅支持 Chrome 90+, Edge 90+, Safari 14+）

不支持的设备：

非智能手机（如功能机）
低于 iOS 13 / Android 8.0 的系统

8. FAQ & 常见问题

8.1 功能类问题

Q1: 为什么 AI 生成的视频有时候会"一眼假"？
A: 主要原因是缺少"真实素材"支撑。建议：①上传真人拍摄素材而非完全依赖 AI 生成 ②在知识库中上传品牌手册/产品图片，AI 会优先引用真实素材。

Q2: 智能喂料推荐的内容为什么跟我项目定位不符？
A: 请检查"账号诊断"结果是否准确，建议重新执行诊断并确保"行业标签"正确。

Q3: 为什么小程序拍摄的视频在 PC 端看不到？
A: 请确认：①手机网络正常 ②点击小程序右上角"一键同步" ③PC 端刷新"内容池"页面。

Q4: 如何避免 AI "一本正经胡说八道"？
A: 使用"结构化数据 (Facts)"功能，在知识库中录入产品参数/价格政策等"硬事实"，AI 会强制引用而非杜撰。

Q5: 批量采集器抓取失败怎么办？
A: 常见原因：①链接格式错误（需公开链接）②平台反爬虫限制（降低并发数）③API 配额不足（检查第三方服务余额）。

8.2 账号类问题

Q6: 免费版和付费版有什么区别？
A: 见"权限分级说明"表格（第 4.3 节），核心差异：生成次数（3 vs 50）、水印（有 vs 无）、批量采集（无 vs 有）。

Q7: 如何升级到付费版？
A: 点击右上角"会员订阅" -> 选择套餐（月付/年付）-> 支付宝/微信支付。

Q8: 付费后立即生效吗？
A: 是的，支付成功后 10 秒内权限自动开通，刷新页面即可。

8.3 技术类问题

Q9: 为什么我的浏览器打不开？
A: 请确认使用 Chrome 90+ / Edge 90+ / Safari 14+，IE 不支持。

Q10: 知识库上传的 PDF 为什么解析失败？
A: 请检查：①文件大小 < 50MB ②非扫描件（需可复制文字）③非加密 PDF。

Q11: ComfyUI 执行器报错"Seed 参数无效"？
A: Seed 需为整数，范围 0-2^32。若想随机生成，填 -1。

Q12: 配音生成失败怎么办？
A: 检查：①Fish Audio API Token 是否有效 ②余额是否充足 ③文案长度是否超限（单次最多 1000 字）。

8.4 商业类问题

Q13: 一刻工坊生成的视频可以商用吗？
A: 可以。付费用户拥有生成内容的完整商业使用权，免费用户需保留水印。

Q14: 可以给客户代运营吗？
A: 可以。我们支持"陪跑交付版"，适合 MCN/代运营公司。详见"方案书"。

Q15: 如何申请发票？
A: 付款后在"个人中心 -> 订单管理"点击"申请发票"，支持普票/专票。

9.1 30 秒电梯演讲

"一刻工坊是 AI 原生的短视频内容生产基础设施，专为 MCN 机构和品牌方打造。我们不是剪辑工具，而是工业化流水线：PC 端策划 + 手机端拍摄 + AI 自动生成，日产 50+ 条成片。核心差异是规模化、标准化、可追溯——新人 1 天上手，爆款经验沉淀为模板，全流程审计合规。"

9.2 1 分钟产品介绍

"痛点：传统内容生产依赖人工，产能极限 1-2 条/天，质量参差不齐，素材浪费。

方案：一刻工坊提供"三步走"工作流：

账号诊断：AI 访谈 30 分钟，自动生成 30 天内容排期
灵感采集：一键解析对标账号，Viral Score 评分推荐爆款
多端协同：PC 策划 + 手机拍摄 + AI 自动成片（配音/字幕/合成）

价值：产能提升 25 倍（50 条/天），成本降低 99%（外包 50 元/条 vs SaaS 99 元/月），新人培训从 2 周缩短到 1 天。

竞争力：企业级特性（审计日志/权限管理/API 编排），移动端离线队列（断网也能拍），知识库强制引用（杜绝 AI 幻觉）。"

9.3 关键术语中英文对照表

中文	英文	缩写	说明
一刻工坊	YiKe Studio	YiKe	产品品牌名
刻流星引擎	KeLiuXing Engine	KLX	技术内核代号
账号诊断	Account Diagnosis	-	AI 访谈式问卷
内容蓝图	Content Blueprint	-	30 天排期计划
爆款指数	Viral Score	-	0-100 分评分
热同步	Hot-Sync	-	诊断结果实时同步
强制引用	Mandatory Citation	-	RAG 必须标注来源
批量采集器	Batch Collector	-	大规模内容抓取
智能编排器	Orchestrator	-	任务引擎路由

End of Product Book V2.0

一刻工坊｜产品书 V2.0 ​

目录 (Table of Contents) ​

1. 品牌与定位体系 ​

1.1 品牌分层说明 ​

1.2 竞品差异化矩阵 ​

1.3 品牌架构图 ​

2. 用户画像与场景 ​

2.1 核心用户画像 ​

画像 A：个人创作者（小白向） ​

画像 B：MCN 运营（专业向） ​

画像 C：品牌方市场部（企业向） ​

2.2 用户痛点拆解表 ​

2.3 场景化用例矩阵 ​

3. 核心用户旅程 (User Journey) ​

3.1 完整旅程序列图 ​

3.2 关键决策点与系统响应 ​

3.3 效率提升对比（人工 vs AI） ​

4. 产品信息架构 (IA) ​

4.1 左侧导航栏完整层级 ​

4.2 核心页面跳转关系图 ​

4.3 权限分级说明 ​

5. 核心功能模块详解 ​

5.1 灵感广场与智能喂料 (Content Pool & Smart Feed) ​

5.1.1 链接解析器技术实现 ​

5.1.2 Viral Score 算法公式 ​

5.1.3 一键复刻的 Prompt 工程机制 ​

5.2 账号诊断与策略蓝图 (Diagnosis & Blueprint) ​

5.2.1 AI 问答逻辑 ​

5.2.2 30 天蓝图生成的 Multi-Step Reasoning ​

5.2.3 断点续传的状态持久化机制 ​

5.3 项目管理中心与资产闭环 (Project Console & Asset Loop) ​

5.3.1 Hot-Sync 同步机制的冲突解决算法 ​

5.3.2 项目回收站的软删除实现 ​

5.3.3 资产闭环的数据库关联查询 ​

5.4 智能知识库与文本处理 (Knowledge Center & Text processing) ​

5.4.1 核心服务矩阵 ​

5.4.2 知识库处理流程与文本切片策略 ​

5.4.3 RAG 问答的 Rerank 机制 ​

5.4.4 强制引用的实现原理 ​

5.4.5 知识冲突检测的语义相似度阈值 ​

5.5 批量采集与自动化中心 (Batch & Automation) ​

5.5.1 批量采集器的并发控制 ​

5.5.2 自动化中心的 Cron 触发器配置 ​

5.6 创作工作坊与执行引擎 (Creative Studios & Workflows) ​

5.6.1 视觉设计 Agent ​

5.6.2 自动化配音流（Fish Audio 集成） ​

5.6.3 ComfyUI 动态执行器 ​

5.6.4 合成实验室（Final Studio） ​

5.6.5 智能调度决策（Orchestrator） ​

5.7 多端协同与移动生产 (Multi-Terminal & Mobile) ​

5.7.1 AR 构图辅助 ​

5.7.2 智能提词器同步 ​

5.7.3 离线任务队列 ​

6. 管理员后台与企业级特性 (Admin & Enterprise) ​

6.1 AI 供应商与模型编排 ​

6.1.1 多模型网关配置表 ​

6.1.2 Agent 系统 Prompt 在线编辑 ​

6.2 安全、审计与风控 ​

6.2.1 审计日志字段定义表 ​

6.2.2 风控策略 ​

7. 系统边界与非目标 ​

7.1 明确不做的功能清单 ​

7.2 技术边界（不支持的场景） ​

8. FAQ & 常见问题 ​

8.1 功能类问题 ​

8.2 账号类问题 ​

8.3 技术类问题 ​

8.4 商业类问题 ​

9. 附录：产品要点速览 (Sales One-Pager) ​

9.1 30 秒电梯演讲 ​

9.2 1 分钟产品介绍 ​

9.3 关键术语中英文对照表 ​

一刻工坊｜产品书 V2.0

目录 (Table of Contents)

1. 品牌与定位体系

1.1 品牌分层说明

1.2 竞品差异化矩阵

1.3 品牌架构图

2. 用户画像与场景

2.1 核心用户画像

画像 A：个人创作者（小白向）

画像 B：MCN 运营（专业向）

画像 C：品牌方市场部（企业向）

2.2 用户痛点拆解表

2.3 场景化用例矩阵

3. 核心用户旅程 (User Journey)

3.1 完整旅程序列图

3.2 关键决策点与系统响应

3.3 效率提升对比（人工 vs AI）

4. 产品信息架构 (IA)

4.1 左侧导航栏完整层级

4.2 核心页面跳转关系图

4.3 权限分级说明

5. 核心功能模块详解

5.1 灵感广场与智能喂料 (Content Pool & Smart Feed)

5.1.1 链接解析器技术实现

5.1.2 Viral Score 算法公式

5.1.3 一键复刻的 Prompt 工程机制

5.2 账号诊断与策略蓝图 (Diagnosis & Blueprint)

5.2.1 AI 问答逻辑

5.2.2 30 天蓝图生成的 Multi-Step Reasoning

5.2.3 断点续传的状态持久化机制

5.3 项目管理中心与资产闭环 (Project Console & Asset Loop)

5.3.1 Hot-Sync 同步机制的冲突解决算法

5.3.2 项目回收站的软删除实现

5.3.3 资产闭环的数据库关联查询

5.4 智能知识库与文本处理 (Knowledge Center & Text processing)

5.4.1 核心服务矩阵

5.4.2 知识库处理流程与文本切片策略

5.4.3 RAG 问答的 Rerank 机制

5.4.4 强制引用的实现原理

5.4.5 知识冲突检测的语义相似度阈值

5.5 批量采集与自动化中心 (Batch & Automation)

5.5.1 批量采集器的并发控制

5.5.2 自动化中心的 Cron 触发器配置

5.6 创作工作坊与执行引擎 (Creative Studios & Workflows)

5.6.1 视觉设计 Agent

5.6.2 自动化配音流（Fish Audio 集成）

5.6.3 ComfyUI 动态执行器

5.6.4 合成实验室（Final Studio）

5.6.5 智能调度决策（Orchestrator）

5.7 多端协同与移动生产 (Multi-Terminal & Mobile)

5.7.1 AR 构图辅助

5.7.2 智能提词器同步

5.7.3 离线任务队列

6. 管理员后台与企业级特性 (Admin & Enterprise)

6.1 AI 供应商与模型编排

6.1.1 多模型网关配置表

6.1.2 Agent 系统 Prompt 在线编辑

6.2 安全、审计与风控

6.2.1 审计日志字段定义表

6.2.2 风控策略

7. 系统边界与非目标

7.1 明确不做的功能清单

7.2 技术边界（不支持的场景）

8. FAQ & 常见问题

8.1 功能类问题

8.2 账号类问题

8.3 技术类问题

8.4 商业类问题

9. 附录：产品要点速览 (Sales One-Pager)

9.1 30 秒电梯演讲

9.2 1 分钟产品介绍

9.3 关键术语中英文对照表