核心用法
xhs-viral-factory 是一款面向小红书创作者的全自动内容生产工具。用户只需将原始素材（PDF、Markdown文件或文件夹）导入系统，AI 即可自动分析内容特征，匹配四大爆款模式之一（治愈心理流、知识百宝箱、认知升级流、极简视觉流），生成可直接发布的图文初稿。
执行流程：配置 LLM_API_KEY 等环境变量 → 运行 python3 scripts/generate_xhs.py --source [素材路径] --output [输出目录] → 获取 AI 生成的爆款内容。
显著优点
1. 模式智能匹配：告别手动选题焦虑，AI 自动判断素材最适合的呈现风格，降低创作决策成本
2. 全模型兼容性：支持 OpenAI 协议下的所有主流模型（DeepSeek、GPT-4o、Claude、Ollama），推荐 DeepSeek 兼具网感与性价比
3. 端到端自动化：从原始素材提取到成品初稿，无需人工干预文案结构
4. 本地化执行：核心脚本本地运行，API Key 仅存于用户环境变量，传输链路采用 HTTPS 加密
潜在缺点与局限性
- 依赖外部 API：内容生成质量直接受制于所选大模型的能力与稳定性
- 创意同质化风险：AI 生成的"爆款模式"可能导致平台内容风格趋同，差异化竞争力需人工二次加工
- 平台政策风险：小红书对 AI 生成内容的识别与流量分配策略存在不确定性
- 素材质量门槛：输入素材的完整性与清晰度直接影响输出可用性
适合人群
小红书内容创业者、知识博主、品牌运营者、需要批量生产图文素材的自媒体团队，尤其适合有原始资料积累但缺乏文案转化能力或时间的用户。
常规风险
- 数据外传：本地文件内容需上传至第三方大模型供应商，敏感资料需谨慎评估
- API 成本：高频调用可能产生不可忽略的模型使用费用
- 版权合规：生成内容的原创性界定及商用授权需用户自行把控