Shuang_Dong/autoUpload

Fork 0

Shuang_Dong 377e34c651 小红书图文发布初版（已优化正文和标签）

2025-10-14 17:56:43 +08:00

6.4 KiB

Raw Blame History

小红书图文上传 - 图片文件夹

这个文件夹用于存放要上传到小红书的图片文件。

🎯 支持的上传方式

单图上传：每张图片单独发布一个图文
多图上传：多张图片组合成一个图文（最多9张）

📁 文件结构

images/
├── README.md          # 说明文件
├── 图片1.jpg          # 图片文件
├── 图片1.txt          # 对应的标题和标签文件（可选）
├── 图片2.png          # 另一张图片
├── 图片2.txt          # 对应的标题和标签文件
└── ...

🖼️ 支持的图片格式

JPG/JPEG - 推荐格式
PNG - 支持透明背景
WEBP - 现代格式，文件更小

📝 标题和标签配置

为每张图片创建同名的 .txt 文件来配置标题和标签：

文件格式

第一行：图文标题
第二行：标签（支持两种格式）
第三行：地点信息（可选，留空则不设置地理位置）
第四行及以后：正文内容（可选，支持多行长文本）

📋 标签格式支持

格式1：逗号分隔

美食,甜品,蛋糕,下午茶,生活

格式2：空格分隔（带#号）

#美食 #甜品 #蛋糕 #下午茶 #生活

注意：系统会自动识别格式并处理，两种格式效果相同。

🎯 智能标签建议选择

系统支持智能标签建议选择功能：

选择策略

精确匹配优先：如果找到与输入标签完全一致的建议，优先选择
包含匹配备选：如果没有精确匹配，选择包含关键词的相关建议
自动生成新标签：如果没有任何匹配的建议，系统会自动生成新标签

处理流程

输入标签 → 等待建议加载 → 查找最佳匹配 → 选择建议或生成新标签

示例

输入 #广州旅游 → 找到 #广州旅游 16.8亿人浏览 → 自动选择
输入 #美食分享 → 找到 #美食分享日常 → 选择相关建议
输入 #我的原创标签 → 无匹配建议 → 生成新标签

示例文件：`美食分享.txt`

今日美食推荐 - 超好吃的蛋糕
美食,甜品,蛋糕,下午茶,生活
北京市

今天发现了一家超棒的蛋糕店！🍰

这家店的招牌是巧克力慕斯蛋糕，
口感丰富，甜而不腻，
搭配他们家的手冲咖啡简直完美！

店里的装修也很有格调，
很适合和朋友一起来聊天放松。
下次还想再来尝试其他口味。

推荐给喜欢甜品的朋友们！
你们有什么好吃的蛋糕店推荐吗？

不设置地理位置的示例：`生活分享.txt`

今天的心情特别好
生活,分享,心情

今天阳光明媚，心情特别好！
和朋友一起度过了愉快的一天。

注意：第三行留空，系统会自动跳过地理位置设置。

📸 多图上传功能

文件命名规则

对于多图上传，使用以下命名规则：

旅行1.jpg    # 第1张图
旅行2.jpg    # 第2张图  
旅行3.jpg    # 第3张图
旅行.txt     # 对应的文本文件

多图示例：`旅行.txt`

三亚海边度假之旅
旅行,度假,海边,三亚,美景
三亚市

这次三亚之旅真的太棒了！🏖️

第一天：抵达三亚，入住海景酒店
第二天：天涯海角，椰梦长廊漫步
第三天：亚龙湾海滩，享受阳光沙滩

每一刻都是美好的回忆！

使用脚本

使用 upload_images_to_xiaohongshu.py - 智能适配单图和多图

python examples/upload_images_to_xiaohongshu.py

🤖 智能适配规则

脚本会自动识别文件命名规则：

单图模式

美食.jpg     ← 单独发布一个图文
美食.txt     ← 对应的文本文件

多图模式

旅行1.jpg    ┐
旅行2.jpg    ├─ 自动组合成一个图文
旅行3.jpg    ┘
旅行.txt     ← 对应的文本文件

混合模式

美食.jpg     ← 单图图文
旅行1.jpg    ┐
旅行2.jpg    ├─ 多图图文
旅行3.jpg    ┘
生活.jpg     ← 单图图文

所有图片会被智能分组并按计划发布

配置说明

📍 地点信息（第三行）

格式要求：城市名（如"北京市"、"上海市"、"广州市"）
可选设置：可以留空或不写
自动处理：如果不设置地点，系统将跳过位置设置

📝 正文内容（第四行及以后）

支持长文本：可以写多行内容，支持换行
内容丰富：可以包含表情符号、问句、描述等
自动处理：如果不写正文，系统将使用标题作为默认内容
格式保持：会保持原有的换行和段落格式
标签位置：标签会自动添加在正文内容的后面，用空格分隔

🚀 使用方法

准备图片：将要上传的图片放入此文件夹
配置信息：为每张图片创建对应的 .txt 文件（可选）
运行脚本：执行 python examples/upload_image_to_xiaohongshu.py

⏰ 定时发布说明

默认设置：每天下午4点发布1个图文
自动排期：多个图文会按天数顺序排期
发布逻辑：与视频发布保持一致的定时机制

📋 注意事项

如果没有 .txt 文件，将使用图片文件名作为标题
标签可以用逗号或中文逗号分隔
建议图片尺寸为正方形或竖屏比例
单个图文最多支持9张图片

🔧 高级配置

单张图片上传

from uploader.xiaohongshu_uploader.main import XiaoHongShuImage

app = XiaoHongShuImage(
    title="图文标题",
    image_paths=["path/to/image.jpg"],
    tags=["标签1", "标签2"],
    publish_date=0,  # 0表示立即发布
    account_file="cookies/xiaohongshu_uploader/account.json",
    location="北京市"  # 地点信息（可选）
)

多张图片上传

app = XiaoHongShuImage(
    title="多图合集",
    image_paths=[
        "path/to/image1.jpg",
        "path/to/image2.jpg",
        "path/to/image3.jpg"
    ],
    tags=["合集", "分享"],
    publish_date=0,
    account_file="cookies/xiaohongshu_uploader/account.json",
    location="上海市"  # 地点信息（可选）
)

地点信息配置

参数名称: location
数据类型: 字符串或None
示例值: "北京市"、"上海市"、"广州市"、"深圳市"
默认值: None（不设置地点）
注意事项: 地点名称需要是小红书支持的有效地点

6.4 KiB Raw Blame History Unescape Escape