AI本地营销 · 平台管理员使用说明 v2.0.0

AI 本地营销 · 平台管理员使用说明

版本：v2.0.0  |  适用：平台后台（yp_admin）

一、入口

后台侧边栏 → 「AI本地营销」 菜单，含 12 个子菜单：商铺站点/GEO内容库/本地关键词/LBS活动/AI任务/营销报表/AI配置/广告投放/营销账单/分享传播/高级LBS/行业模板。

二、AI 配置（首次使用必读）

路径：「AI配置」

1. 文本 AI：启用 AI 生成 → 选 Provider（DeepSeek/火山豆包/Claude）→ 填 API Key（加密落库，脱敏展示）→ 设每日预算 → 保存 → 点「测试文本连接」
2. 图像 AI：启用图像生成 → 选图像 Provider（通义万相）→ 填百炼 API Key → 选模型（推荐 wanx2.1-t2i-plus）→ 设图像每日预算 → 保存 → 点「测试图像生成」

通义万相开通：去阿里云百炼平台 bailian.console.aliyun.com → 模型广场开通通义万相 → 创建 API Key（与原 DashScope Key 通用）。注：新模型 wan2.7-image-pro 旧 endpoint 暂不可用，用 wanx2.1-t2i-plus。

预算硬校验：超每日预算时所有 AI 生成入口自动回退确定性模板，不消耗 token。

三、行业模板管理

路径：「行业模板」

• 13 个行业 × 5 场景 = 65 条种子模板，按行业分组展示
• 点「编辑」可调整某场景的 AI 提示词模板（支持 {shop_name}{category}{address}{phone}{hours}{goods_hint} 占位符）与回退文案
• 点「补齐种子模板」可补齐缺失行业
• 改后该行业商户下次生成即用新提示词

四、商铺站点与内容

• 商铺站点：查看/创建商家商铺官网，管理域名绑定与 SSL
• GEO 内容库：审核商户提交的 intro/faq/promo（草稿→待审核→发布/驳回）
• 本地关键词：管理商家本地搜索关键词库

五、LBS 活动与高级 LBS

• LBS 活动：审核商户活动，活动到点自动上线/下线（CronMarketing 每60分钟）
• 高级 LBS：多边形围栏、人群分组、到店预测（rule_v1）

六、营销报表

路径：「营销报表」

• 概览：曝光/点击/领券/到店/核销/订单 + 券核销率/带单营收/ROI
• 趋势：按天趋势图
• 排行：活动/门店/渠道维度

页面顶部可安装/卸载营销 Cron（活动上下线+报表快照）。

七、AI 任务与用量

路径：「AI任务」

• 查看所有 AI 生成任务（geo_content/auto_marketing/smart_coupon/image/keyword 等）状态与用量
• 失败任务由 CronMarketing 自动重试（近24h，每站点上限3次）

八、智能发券（平台视角）

• 商户在商户端自助生成券策略、圈人发券、开关定时
• 平台可在「营销报表」查看全平台券核销率与带单营收
• 发券 Cron（CronSmartCoupon）由商户在商户端自助安装

九、运维要点

• 部署：本地改 → php -l 检查 → commit/push → 服务器 git pull → php think clear
• DB 升级：用 database_upgrade/ 下幂等脚本（如 ai_marketing_utf8mb4.php）
• 服务器：跑 PHP 必须 sudo -u www，否则日志属主变 root 致 fpm 500
• 进度文档：docs/geo-lbs-ai-marketing-progress.md（跨会话恢复上下文）
• 版本日志：docs/VERSION.md（每次发版追加）

十、已知限制

• 到店预测为 rule_v1（确定性评分），真实模型待样本积累
• 排名监控为人工录入（各平台无公开 API）
• 消费者端 yp_uniapp 待真机联调