nanocode/skills/xiaohongshu_integration/ENHANCED_GUIDE.md

小红书增强版发布器使用指南

🎯 功能概述

增强版小红书发布器集成了图片风格生成功能，实现了从内容创作到图片生成到平台发布的全自动化流程。

核心功能

1. 智能内容分析 - 自动分析内容类型，推荐最佳图片风格
2. AI图片生成 - 基于内容自动生成小红书风格配图
3. 自动化发布 - 一键发布到小红书平台
4. 批量处理 - 支持批量处理多个Markdown文件
5. 配置管理 - 灵活的配置系统，支持多种风格和布局

🚀 快速开始

1. 安装依赖

# 确保已安装小红书CLI
uv tool install xiaohongshu-cli

# 安装Python依赖
pip install pillow requests

2. 配置API密钥

编辑配置文件 xiaohongshu_enhanced_config.json：

{
  "image_generation": {
    "api_key": "你的豆包Seedream API密钥"
  }
}

3. 小红书登录

# 登录小红书
xhs login

# 验证登录状态
xhs status

4. 基本使用

# 发布单个Markdown文件
python3 xiaohongshu_enhanced_publisher.py publish --markdown article.md

# 指定图片风格和布局
python3 xiaohongshu_enhanced_publisher.py publish --markdown article.md --style notion --layout dense

# 批量处理目录
python3 xiaohongshu_enhanced_publisher.py batch --directory ./articles/

# 测试发布功能
python3 xiaohongshu_enhanced_publisher.py test

📋 详细使用说明

1. 发布单个文件

# 基本发布（使用默认风格）
python3 xiaohongshu_enhanced_publisher.py publish --markdown article.md

# 指定风格和布局
python3 xiaohongshu_enhanced_publisher.py publish \
  --markdown article.md \
  --style notion \
  --layout dense

# 使用自定义配置
python3 xiaohongshu_enhanced_publisher.py publish \
  --markdown article.md \
  --config custom_config.json

2. 批量处理

# 批量处理目录中的所有Markdown文件
python3 xiaohongshu_enhanced_publisher.py batch --directory ./articles/

# 指定风格和布局
python3 xiaohongshu_enhanced_publisher.py batch \
  --directory ./articles/ \
  --style fresh \
  --layout balanced

# 处理结果会显示成功/失败统计

3. 内容分析

# 分析文本内容
python3 xiaohongshu_enhanced_publisher.py analyze --content "你的内容"

# 分析文件内容
python3 xiaohongshu_enhanced_publisher.py analyze --file article.md

4. 图片生成

# 生成图片
python3 xiaohongshu_enhanced_publisher.py generate --content "你的内容"

# 指定风格和布局
python3 xiaohongshu_enhanced_publisher.py generate \
  --content "你的内容" \
  --style cute \
  --layout balanced

# 指定输出路径
python3 xiaohongshu_enhanced_publisher.py generate \
  --content "你的内容" \
  --output ./images/generated.png

5. 配置管理

# 查看配置摘要
python3 xiaohongshu_enhanced_publisher.py config

# 查看完整配置
python3 xiaohongshu_enhanced_publisher.py config --show

🎨 支持的风格和布局

图片风格 (8种)

风格	描述	适用场景
cute	甜美可爱少女风	生活分享、日常种草
fresh	干净清新自然风	健康生活、自然主题
warm	温馨友好亲切风	生活故事、情感分享
bold	高冲击力醒目风	重要提醒、避坑指南
minimal	超简洁精致风	专业总结、商务内容
notion	简约手绘知识风	知识卡片、干货分享
retro	复古怀旧经典风	怀旧分享、经典盘点
pop	活力时尚吸睛风	趣味冷知识、炸裂封面

图片布局 (6种)

布局	描述	适用场景
sparse	最少信息，最大冲击力	封面、金句、氛围图
balanced	标准内容布局	常规内容、产品介绍
dense	高信息密度知识卡片	知识卡片、干货分享
list	列表和排名格式	清单、排行榜、要点
comparison	并排对比布局	产品测评、对比分析
flow	步骤和时间线布局	教程步骤、操作流程

预设组合 (6种)

预设	风格	布局	适用场景
knowledge_card	notion	dense	知识卡片、概念科普
cute_share	cute	balanced	可爱分享、日常种草
tutorial_steps	fresh	flow	教程步骤、操作指南
product_comparison	fresh	comparison	产品测评、对比分析
checklist	notion	list	清单、排行榜、要点
clean_quote	minimal	sparse	极简金句、封面

⚙️ 配置文件说明

主要配置项

小红书配置 (xiaohongshu)

{
  "cli_path": "xhs",
  "max_images": 9,
  "default_tags": ["#技术资讯", "#科技新闻"],
  "publish_interval": 3600,
  "auto_generate_images": true,
  "default_style": "notion",
  "default_layout": "balanced"
}

图片生成配置 (image_generation)

{
  "api_key": "你的API密钥",
  "api_base_url": "https://ark.cn-beijing.volces.com/api/v3",
  "model": "doubao-seedream-4-5-251128",
  "max_retries": 3,
  "timeout": 60,
  "output_dir": "/home/ubuntu/xhs_generated_images"
}

内容配置 (content)

{
  "max_title_length": 30,
  "max_content_length": 1000,
  "auto_generate_tags": true,
  "add_source_info": true,
  "extract_key_points": true
}

📝 Markdown文件要求

基本格式

# 文章标题

这里是文章内容...

## 二级标题

- 要点1
- 要点2
- 要点3

### 三级标题

更多详细内容...

图片处理

• 系统会自动生成配图，无需在Markdown中包含图片
• 如果需要使用特定图片，可以在Markdown中保留图片链接
• 生成的图片会优先使用

内容建议

1. 标题明确: 使用清晰的标题
2. 结构清晰: 使用标题层级组织内容
3. 要点突出: 使用列表突出关键信息
4. 长度适中: 建议500-1000字

🔧 集成到现有工作流

1. 与IT资讯自动化集成

from xiaohongshu_enhanced_publisher import XiaohongshuEnhancedPublisher

# 初始化发布器
publisher = XiaohongshuEnhancedPublisher("config.json")

# 处理IT资讯文章
def process_it_article(article_md_path):
    success = publisher.publish_with_generated_images(article_md_path)
    if success:
        print(f"✅ 文章已发布: {article_md_path}")
    else:
        print(f"❌ 发布失败: {article_md_path}")

2. 与内容创作工具集成

# 从内容创作工具获取内容
content = get_content_from_writing_tool()

# 保存为Markdown
with open("article.md", "w", encoding="utf-8") as f:
    f.write(content)

# 发布到小红书
publisher.publish_with_generated_images("article.md")

3. 定时任务集成

# 每天定时发布
0 10 * * * cd /path/to/xiaohongshu_integration && python3 xiaohongshu_enhanced_publisher.py batch --directory ./daily_articles/

🐛 故障排除

常见问题

1. 小红书CLI登录失败

# 检查登录状态
xhs status

# 重新登录
xhs login --qrcode

2. API密钥错误

错误: API生成器初始化失败

• 检查 api_key 配置是否正确
• 确认API密钥有足够的额度
• 检查网络连接

3. 图片生成失败

错误: 图片生成失败

• 检查内容是否包含敏感词
• 尝试不同的风格和布局
• 检查API服务状态

4. 发布失败

错误: 小红书发布失败

• 检查小红书账号状态
• 确认内容符合社区规范
• 检查网络连接

日志查看

# 查看详细日志
tail -f /var/log/xiaohongshu_enhanced.log

# 调试模式
python3 xiaohongshu_enhanced_publisher.py publish --markdown article.md 2>&1 | tee debug.log

📊 性能优化

1. 缓存策略

• 启用 cache_generated_images 缓存生成的图片
• 设置合理的 cache_ttl (默认24小时)

2. 批量处理优化

• 设置合适的 publish_interval 避免频率限制
• 启用 parallel_generation 并行生成图片

3. 内容预处理

• 启用 preprocess_content 预处理内容
• 使用 extract_key_points 提取关键信息

🔄 更新和维护

1. 更新配置

# 备份现有配置
cp xiaohongshu_enhanced_config.json xiaohongshu_enhanced_config.json.backup

# 更新配置
# 编辑配置文件

2. 清理生成的文件

# 清理生成的图片
rm -rf /home/ubuntu/xhs_generated_images/*

# 清理临时文件
find /tmp -name "*xhs*" -type f -delete

3. 监控发布状态

# 查看最近发布的笔记
xhs my-notes --page 0

# 查看发布统计
python3 xiaohongshu_enhanced_publisher.py config

🎯 最佳实践

1. 内容策略

• 知识分享: 使用 notion + dense 风格
• 生活分享: 使用 cute + balanced 风格
• 教程指南: 使用 fresh + flow 风格
• 产品测评: 使用 fresh + comparison 风格

2. 发布时间

• 设置合理的 publish_interval (建议1-2小时)
• 避免短时间内大量发布
• 选择用户活跃时间段发布

3. 标签优化

• 使用相关的话题标签
• 结合内容自动生成标签
• 避免使用过多或不相关的标签

4. 质量监控

• 定期检查发布效果
• 根据数据调整风格策略
• 收集用户反馈优化内容

📞 支持与反馈

问题报告

1. 查看日志文件获取错误信息
2. 提供复现步骤和配置信息
3. 报告到项目issue页面

功能建议

1. 描述使用场景和需求
2. 提供具体的功能建议
3. 讨论实现方案

贡献代码

1. Fork项目仓库
2. 创建功能分支
3. 提交Pull Request

---

祝您使用愉快！如有问题，请随时联系。 🚀