运营选题助手（Content Strategy Assistant）

这份指南是做什么的

运营人在发布内容前最纠结的问题是"下一期发什么"。本技能读取用户的历史内容数据（点赞/收藏/评论/转发/观看），从数据中找出"什么内容容易火、什么容易扑街"的规律，并给出下一期 3 个选题方案（每个方案附带引用数据依据的推荐理由），最后输出《选题建议书.docx》和《选题方案.xlsx》两份文件。

核心卖点：全程本地运行，用户的选题策略数据绝不出机。

何时使用（触发条件）

用户问"下一期发什么""给我几个选题方案""帮我选题"
用户想复盘历史内容数据、找出爆款规律
用户提供或提到一份历史选题数据表（xlsx / Excel）
用户要求分析点赞、收藏、评论、转发、观看等数据并给出建议

执行步骤

第 1 步：确认数据文件

询问用户历史选题数据的 xlsx 路径。文件需包含以下列（中文列名即可，顺序不限）：

| 列 | 说明 | |----|------| | 日期 | 发布时间（可选） | | 选题 | 内容选题（必填） | | 类型 | 如：干货教程/产品介绍/行业资讯/互动话题（可选） | | 标题 | 发布标题（可选，用于标题特征分析） | | 平台 | 如：公众号/小红书/抖音/知乎（可选） | | 点赞/收藏/评论/转发/观看 | 互动数据（可选，缺省按 0 处理） |

如果用户没有数据文件，运行 python files/scripts/make_demo_data.py 生成 60 条示例数据（data/demo_history.xlsx）用于演示。

路径说明：本指南命令以发布包结构为准（源码在 files/scripts/ 子目录）；若在源码仓库中开发调试，将命令中的 files/scripts/ 换成 scripts/ 即可。

第 2 步：准备运行环境（首次）

# 在技能目录下执行
pip install -r files/requirements.txt

第 3 步：运行分析

# 模板分析模式（无模型，秒出结果，适合快速演示）
python files/scripts/main.py --data <数据文件.xlsx> --out-dir output --model mock

# 本地模型模式（推荐，效果更好；需先准备模型，见下）
python files/scripts/main.py --data <数据文件.xlsx> --out-dir output \
    --model openvino --model-path models/qwen2.5-7b-instruct-int4

准备本地模型（可选）：运行 python files/scripts/download_ir_model.py 下载 OpenVINO IR 格式的 Qwen2.5-7B-Instruct（int4 量化，约 4.5GB，来自 hf-mirror）。下载完成后推理全程离线、数据不出机。

第 4 步：汇报结果

向用户说明输出文件位置与核心结论：

output/选题建议书_<日期>.docx —— 数据总览 + 赛道画像 + 爆款规律 + 3 个选题方案
output/选题方案_<日期>.xlsx —— 可编辑的选题方案表（含数据快照页）

汇报时先口述 2-3 条关键规律（赛道、什么类型/平台/标题特征更容易火），再列出 3 个选题方案及理由，最后给出文件路径。

第 5 步：用户不满意时"换一批"

如果用户对当前 3 个选题不满意，用不同的变体编号重新运行：

# 换一批选题（仍基于同一份数据，2 个最佳类型 + 1 个多样性组合）
python files/scripts/main.py --data <数据文件.xlsx> --out-dir output --model mock --variant 2
python files/scripts/main.py --data <数据文件.xlsx> --out-dir output --model mock --variant 3

规则：

--variant N（默认 1）：每次换 N 得到另一组同样有数据依据的选题组合；
同一 N 的结果可复现（方便对比与讨论）；
可以一直换到用户满意为止（N=1,2,3,...）；
openvino 模式同样支持（作为随机种子）。

输出格式要求

《选题建议书.docx》必须包含五个部分：

历史数据总览（内容总数/平均互动率/爆款数量/爆款占比）
账号赛道画像（推断赛道/置信度/代表关键词）
爆款规律（最佳类型×平台组合、标题特征对比）
下一期选题方案（3 个，每个含：选题名称/内容类型/建议平台/推荐理由）
说明（注明"数据仅在本机处理，未上传任何云端"与生成模式）

《选题方案.xlsx》第一页为方案表（序号/选题名称/内容类型/建议平台/推荐理由），第二页为关键指标快照。

注意事项

数据安全：全程本地处理，禁止将用户数据上传任何云端服务。
只基于数据：分析结论必须引用用户数据中的具体数字，不得编造。
模型模式：--model mock 无需模型；--model openvino 需先下载模型。若模型未准备，请使用 mock 模式保证流程可跑通。
数据列名：支持中英文列名（见第 1 步表格），缺失列会报错或按 0 处理。