# 小红书增强版发布器使用指南 ## 🎯 功能概述 增强版小红书发布器集成了图片风格生成功能，实现了从内容创作到图片生成到平台发布的全自动化流程。 ### 核心功能 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 --- **祝您使用愉快！如有问题，请随时联系。** 🚀