nanocode/skills/xiaohongshu_integration/ENHANCED_GUIDE.md

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

## 🎯 功能概述

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

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

## 🚀 快速开始

### 1. 安装依赖
```bash
# 确保已安装小红书CLI
uv tool install xiaohongshu-cli

# 安装Python依赖
pip install pillow requests
```

### 2. 配置API密钥
编辑配置文件 `xiaohongshu_enhanced_config.json`：
```json
{
  "image_generation": {
    "api_key": "你的豆包Seedream API密钥"
  }
}
```

### 3. 小红书登录
```bash
# 登录小红书
xhs login

# 验证登录状态
xhs status
```

### 4. 基本使用
```bash
# 发布单个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. 发布单个文件
```bash
# 基本发布（使用默认风格）
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. 批量处理
```bash
# 批量处理目录中的所有Markdown文件
python3 xiaohongshu_enhanced_publisher.py batch --directory ./articles/

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

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

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

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

### 4. 图片生成
```bash
# 生成图片
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. 配置管理
```bash
# 查看配置摘要
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`)
```json
{
  "cli_path": "xhs",
  "max_images": 9,
  "default_tags": ["#技术资讯", "#科技新闻"],
  "publish_interval": 3600,
  "auto_generate_images": true,
  "default_style": "notion",
  "default_layout": "balanced"
}
```

#### 图片生成配置 (`image_generation`)
```json
{
  "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`)
```json
{
  "max_title_length": 30,
  "max_content_length": 1000,
  "auto_generate_tags": true,
  "add_source_info": true,
  "extract_key_points": true
}
```

## 📝 Markdown文件要求

### 基本格式
```markdown
# 文章标题

这里是文章内容...

## 二级标题

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

### 三级标题

更多详细内容...
```

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

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

## 🔧 集成到现有工作流

### 1. 与IT资讯自动化集成
```python
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. 与内容创作工具集成
```python
# 从内容创作工具获取内容
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. 定时任务集成
```bash
# 每天定时发布
0 10 * * * cd /path/to/xiaohongshu_integration && python3 xiaohongshu_enhanced_publisher.py batch --directory ./daily_articles/
```

## 🐛 故障排除

### 常见问题

#### 1. 小红书CLI登录失败
```bash
# 检查登录状态
xhs status

# 重新登录
xhs login --qrcode
```

#### 2. API密钥错误
```
错误: API生成器初始化失败
```
- 检查 `api_key` 配置是否正确
- 确认API密钥有足够的额度
- 检查网络连接

#### 3. 图片生成失败
```
错误: 图片生成失败
```
- 检查内容是否包含敏感词
- 尝试不同的风格和布局
- 检查API服务状态

#### 4. 发布失败
```
错误: 小红书发布失败
```
- 检查小红书账号状态
- 确认内容符合社区规范
- 检查网络连接

### 日志查看
```bash
# 查看详细日志
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. 更新配置
```bash
# 备份现有配置
cp xiaohongshu_enhanced_config.json xiaohongshu_enhanced_config.json.backup

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

### 2. 清理生成的文件
```bash
# 清理生成的图片
rm -rf /home/ubuntu/xhs_generated_images/*

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

### 3. 监控发布状态
```bash
# 查看最近发布的笔记
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

---

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