本地生活营销策划方案生成器

基于大众点评截图和商家信息，自动生成标准化的10板块营销策划方案，并输出为 Markdown、钉钉文档或 PPT。

触发条件

当用户需要以下场景时触发：
1. 为餐饮/咖啡/烘焙商家创建营销策划方案
2. 基于大众点评截图分析商家数据
3. 设计小红书/抖音/点星的内容投放策略
4. 制定达人投放预算和ROI预期
5. 输出可执行的内容brief和话术库

使用流程

第一步：收集商家信息

从用户或大众点评截图中获取：

第二步：生成方案

按照标准10板块模板生成完整方案：

1. 商家基础信息 - 整理商家核心数据
2. 用户评价深度洞察 - 情感分析、卖点排序、机会点、负面预警
3. 策略定位 - 差异化定位 + 策略依据
4. 平台策略 - 三平台配比和任务分工
5. 内容矩阵 - 素人/腰部/头部的数量和方向
6. 内容选题 - 主路线、副路线、差异化路线
7. 关键话术库 - 按场景分类的用户原话风格话术
8. 执行细节 - 素人要求、腰部/头部达人Brief
9. 预算板块 - 各层级数量、单价、预算区间

详细模板结构参考：references/template.md
AI生成提示词参考：references/ai-prompts.md
成功案例参考：references/examples.md

第三步：输出交付

支持四种输出格式：

1. Markdown 文件 - 保存到工作区 plans/ 目录
2. 腾讯文档 - 使用 qclaw_tdoc_mcp_call 直接创建智能文档（推荐）
3. PPT 演示文稿 - 使用 scripts/generate_ppt_v4.py 生成 .pptx
4. HTML 幻灯片 - 使用 scripts/generate_html_slides.py 生成 .html（浏览器直接打开，支持键盘导航）

预算配置

前提信息

• 总预算金额（具体数字，如 ¥20,000）
• 城市（上海/杭州/南京/苏州/宁波）
• 主推平台（小红书 / 抖音 / 点星）
• 要爆文号（是/否，如要则预留30%预算）
• 是否需要出镜（达人是否需要出镜拍摄）

达人价格参考

详见 references/kol_price_table.json

精算原则：
- 素人层：0元现金预算，只展示数量（套餐置换模式）
- 腰部层：千粉:万粉 = 2:1（数量比，即千粉篇数:万粉篇数 = 2:1），按城市和平台查表取单价
- 默认不出镜价格（参考 kol_price_table.json）
- 如上海小红书：千粉¥100，万粉¥200
- 如南京小红书：千粉¥160，万粉¥240
- 重要：2:1 指的是达人数量比例，不是预算比例
- 爆文号：如需要则预留30%预算，只展示金额不展示数量
- 按城市单价表精算，允许最低限度超出预算

预算分配公式（以上海小红书、¥14,000预算、要爆文号为例）：

⚠️ 关键：2:1 指的是数量比（千粉篇数:万粉篇数 = 2:1），不是预算比！

总预算：¥14,000

爆文号预留 30%：¥4,200（只展示金额，不展示数量）

腰部剩余 70%：¥9,800
  ├─ 千粉（篇数是万粉的 2 倍）：约49篇 × ¥100（上海千粉不出镜）= ¥4,900
  └─ 万粉（篇数是千粉的 1/2）：约24篇 × ¥200（上海万粉不出镜）= ¥4,800

素人：80篇（0元，套餐置换）

合计：¥13,900（允许最低限度超出）

注意：不同城市单价不同，计算时必须查 kol_price_table.json 获取对应价格

脚本使用

HTML 幻灯片生成

使用 HTML5 + CSS3 + Vanilla JS 实现，无需任何依赖：

# 从 JSON 数据生成
python3 scripts/generate_html_slides.py plan_data.json "输出文件.html"

特点：
- 🎨 响应式设计，支持桌面/平板/手机
- ⌨️ 键盘导航（←→ 空格 PageUp/PageDown Home/End）
- 📊 11页完整结构：封面→商家信息→洞察→策略→平台→矩阵→选题→话术→执行→预算→结尾
- 🎯 现代化 UI：卡片布局、渐变背景、高亮框、数据表格
- 🖨️ 支持打印（每页自动分页）
- 🌐 单文件 HTML，无需服务器，浏览器直接打开

JSON 字段规范（与 PPT 生成器兼容）：

{
  "merchant": { "name", "category", "location", "hours", "per_capita", "rating", "reviews", "tags", "goal", "budget" },
  "insight": { "positive_pct", "neutral_pct", "negative_pct", "top_selling_points", "opportunities", "risks" },
  "strategy": { "positioning", "reasons" },
  "platform": [{ "name", "goal", "tactics", "expected_result" }],
  "content_matrix": { "tier1", "tier2", "tier3", "viral" },
  "topics": { "main", "sub", "diff" },
  "scripts": [{ "scene", "script" }],
  "execution": { "amateur_req", "waist_brief", "head_brief", "viral_brief" },
  "budget": { "total_amount", "items" }
}

PPT 生成

使用 V4 版本生成器，支持以下特性：
- 首页标题简洁，无重复文字
- 策略定位页定位语高亮（橙色加粗）
- 执行细节分4页展示（素人/千粉/万粉/爆文号）
- 预算板块使用表格形式呈现

# 从 JSON 数据生成
python3 scripts/generate_ppt_v4.py plan_data.json "输出文件.pptx"

# JSON 数据格式参考 scripts/example_plan_data.json

JSON 字段规范（必须与脚本匹配）：

{
  "merchant": { "name", "category", "location", "hours", "per_capita", "rating", "reviews", "tags", "goal", "budget" },
  "insight": { "positive_pct", "neutral_pct", "negative_pct", "top_selling_points", "opportunities", "risks" },
  "strategy": { "positioning", "reasons" },
  "platform": [{ "name", "goal", "tactics", "expected_result" }],
  "content_matrix": { "tier1", "tier2", "tier3", "viral" },
  "topics": { "main", "sub", "diff" },
  "scripts": [{ "scene", "script" }],
  "execution": { "amateur_req", "waist_brief", "head_brief", "viral_brief" },
  "budget": { "total_amount", "items" }
}

关键修复记录（2026-05-18）：
1. 正文文本框筛选：s.top.inches > 1.5 → >= 1.5（模板文本框 top=1.50）
2. 执行细节清空逻辑：while len(tf.paragraphs) > 1 → > 0（完全清空避免残留"正文内容..."）
3. 预算合计字段：使用 total_amount 而非 total

PPT 页面结构（15页）：
1. 封面
2. 目录
3. 商家基础信息
4. 用户评价洞察
5. 策略定位（定位语高亮）
6. 平台策略（三卡片）
7. 内容矩阵（四卡片）
8. 内容选题
9. 关键话术库
10. 执行细节 - 素人置换
11. 执行细节 - 腰部达人（千粉）
12. 执行细节 - 腰部达人（万粉）
13. 执行细节 - 爆文号
14. 预算板块（表格）
15. 结尾页

腾讯文档上传

# 使用 qclaw_tdoc_mcp_call 创建智能文档
qclaw_tdoc_mcp_call(
    tool_name="create_smartcanvas_by_mdx",
    arguments={
        "title": "商家名称-营销策划方案",
        "mdx": "# 方案内容...",
        "content_format": "mdx"
    }
)

特点：
- 无需预先创建文档，一键生成
- 智能文档格式，排版美观
- 支持完整 Markdown 语法
- 可直接分享链接给他人

注意事项

1. 必须获取商家的大众点评截图才能准确分析
2. 总预算金额和核心诉求必须明确，影响整个方案结构
3. 话术库必须基于真实用户评价，不能编造
4. PPT 生成需要 python-pptx 库（需手动安装，见下方环境配置）

Python 环境配置

⚠️ Windows 用户必读：本 Skill 的 PPT 生成功能依赖 python-pptx 库，需要手动安装。

1️⃣ 检查 Python 是否已安装

打开命令提示符（cmd.exe）或 PowerShell，输入：

python --version
# 或
python3 --version

• ✅ 如果显示版本号（如 Python 3.9.7），说明已安装
• ❌ 如果提示"不是内部或外部命令"，需要先安装 Python

下载 Python：访问 https://www.python.org/downloads/ ，下载并安装最新版（勾选 "Add Python to PATH"）

2️⃣ 安装 python-pptx 库

方法 1：使用 requirements.txt（推荐）

# 进入 skill 目录
cd %USERPROFILE%\.qclaw\skills\marketing-plan-generator

# 安装依赖
pip install -r requirements.txt

方法 2：直接安装

# 使用 pip3（推荐）
pip3 install python-pptx

# 如果 pip3 不可用，尝试 pip
pip install python-pptx

# 如果 pip 也不可用，使用 python -m pip
python -m pip install python-pptx

⚠️ Windows 常见问题

1. 提示"pip 不是内部或外部命令"：
   bash python -m pip install python-pptx

2. 提示"权限不足"：
   bash pip install --user python-pptx

3. 提示"拒绝访问"：
   - 右键点击命令提示符 → "以管理员身份运行"
   - 然后执行安装命令

3️⃣ 验证安装

python -c "from pptx import Presentation; print('✅ python-pptx 已成功安装！')"

• ✅ 如果显示 ✅ python-pptx 已成功安装！，说明安装成功
• ❌ 如果提示 ModuleNotFoundError，说明安装失败，请检查步骤 2

4️⃣ 测试 PPT 生成

# 进入 skill 目录
cd %USERPROFILE%\.qclaw\skills\marketing-plan-generator

# 使用示例数据生成 PPT
python scripts\generate_ppt_v4.py scripts\example_plan_data.json 测试输出.pptx

• ✅ 如果生成 测试输出.pptx，说明环境配置成功
• ❌ 如果提示错误，检查 template_v3.pptx 是否存在于 assets/ 目录

5️⃣ HTML 幻灯片生成（无需额外依赖）

如果不想安装 Python 依赖，可以使用 HTML 幻灯片生成器（无需任何依赖）：

python scripts\generate_html_slides.py scripts\example_plan_data.json 测试输出.html

生成的 .html 文件可以直接用浏览器打开，支持键盘导航（←→），适合快速预览和分享。

6️⃣ 依赖库说明

如果不生成 PPT，只需安装 requests：

pip install requests

参考文件