From a75d6ea4225ba43432c7e4fba3cc6e1f7fbdc340 Mon Sep 17 00:00:00 2001 From: zhoujie <929834232@qq.com> Date: Tue, 10 Feb 2026 22:50:41 +0800 Subject: [PATCH] =?UTF-8?q?=E2=9C=A8=20feat(docs):=20=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=E9=A1=B9=E7=9B=AE=E6=96=87=E6=A1=A3=E4=BB=A5=E5=8F=8D=E6=98=A0?= =?UTF-8?q?=20v2.5=20=E7=89=88=E6=9C=AC=E6=96=B0=E7=89=B9=E6=80=A7?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 更新 CHANGELOG.md,新增 v2.5.0 版本日志,记录人设专属 SD 视觉优化、新增人设及内容排期系统等重大功能 - 更新 CONTRIBUTING.md 项目架构图,补充新增的服务模块(analytics_service.py, publish_queue.py)和核心设计原则 - 全面更新 README.md,将项目标题升级至 V2.5,重构功能特性章节以对应 8 个 Tab,新增人设系统、内容排期、智能学习、反 AI 检测等核心功能的详细说明,并更新配置说明和常见问题解答 --- CHANGELOG.md | 61 +++++++++++++++++++++ CONTRIBUTING.md | 12 ++-- README.md | 142 ++++++++++++++++++++++++++++++++++++++++-------- 3 files changed, 189 insertions(+), 26 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 508552f..bc93475 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,67 @@ 本项目遵循 [Semantic Versioning](https://semver.org/) 语义化版本规范。 +## [2.5.0] - 2026-02-10 + +### 🚀 新功能 + +- **人设专属 SD 视觉优化** + - 新增 `PERSONA_SD_PROFILES` 引擎:9 种人设独立视觉方案 + - 每个方案含 `prompt_boost`(前置增强词)、`prompt_style`(风格后缀)、`negative_extra`(负面补充)、`llm_guide`(LLM 视觉指导) + - `txt2img()` 自动注入人设视觉方案,生图风格与人设严格匹配 + - `get_sd_prompt_guide()` 融入人设专属 LLM 指导词 + - 赛博AI虚拟博主特殊处理:豁免反 AI 检测(拥抱 AI 身份) + - 全链路贯通:Tab 1 手动生图、自动发布、队列生成均传入人设 + +- **新增人设:赛博AI虚拟博主** + - 住在2077年的数码女孩,AI 生成高颜值写真 + 全球场景打卡 + - 20 个专属主题 + 18 个关键词,设为默认人设 + +- **新增人设:性感福利主播** + - 身材火辣衣着大胆,专注分享穿衣显身材和私房写真风穿搭 + - 20 个专属主题 + 18 个关键词 + +### 支持的人设视觉方案 + +| 人设 | 风格关键词 | +|------|-----------| +| 赛博AI虚拟博主 | perfect face, vibrant colors, fantasy, dramatic lighting | +| 性感福利主播 | glamour photography, seductive, warm golden tones, boudoir | +| 身材管理健身美女 | fit body, athletic, gym environment, energetic | +| 温柔知性时尚博主 | elegant, fashion editorial, french style, magazine quality | +| 文艺青年摄影师 | film grain, vintage tones, kodak portra, nostalgic | +| 二次元coser | cosplay, vibrant colors, anime inspired, dynamic pose | +| 汉服爱好者 | traditional chinese, hanfu, ink painting aesthetic | +| 独居女孩 | cozy atmosphere, warm lighting, hygge, candle light | +| 资深美妆博主 | flawless makeup, beauty close-up, ring light, studio beauty | + +## [2.4.0] - 2026-02-10 + +### 🚀 新功能 + +- **数据看板 Bug 修复** + - 修复 MCP 响应解析:`raw["raw"]["content"]` 多层嵌套正确处理 + - 修复笔记 ID 字段:`f["noteId"]` → `f["id"]` 匹配实际 API 返回 + +## [2.3.0] - 2026-02-10 + +### 🚀 新功能 + +- **内容排期系统(Tab 8: 📅 内容排期)** + - 新增 `publish_queue.py`:SQLite 队列管理,支持 草稿→审核→排期→发布中→已发布/失败 全流程 + - 批量生成:一键生成多篇内容(文案 + 图片)加入队列 + - 队列处理器:`QueuePublisher` 后台线程自动轮询定时发布 + - 队列管理 UI:预览、审核、驳回、设定时间、启动/停止处理器 + +- **反 AI 检测增强** + - 8 层文案人格化:口语化改写、随机错别字、方言词汇、不规律标点、emoji 混入、段落随机化 + - 7 步图片后处理:微旋转裁剪、色偏、噪点、JPEG 二次压缩(质量 82-92)、EXIF 清除、局部模糊/锐化 + - 所有图片保存为 JPEG 格式(非 PNG),模拟手机拍摄 + +- **全局参数传递审计修复** + - `persona` 参数贯通 `generate_copy` / `generate_from_hotspot` / `auto_publish_once` 全链路 + - `quality_mode` 从 UI 传入替代硬编码,所有生图调用统一使用用户选择的质量档位 + ## [2.2.0] - 2026-02-10 ### 🚀 新功能 diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 2d609b1..bba48e9 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -92,11 +92,13 @@ refactor(mcp): 重构评论解析逻辑 ## 项目架构 ``` -main.py # 主程序:Gradio UI + 业务逻辑 + 自动化调度 +main.py # 主程序:Gradio UI (8 Tabs) + 业务逻辑 + 自动化调度 ├─ config_manager.py # 配置管理:单例模式,多 LLM 提供商 -├─ llm_service.py # LLM 封装:文案生成、热点分析、评论回复 -├─ sd_service.py # SD 封装:txt2img、img2img(JuggernautXL 优化) -└─ mcp_client.py # MCP 客户端:小红书搜索、发布、评论、点赞 +├─ llm_service.py # LLM 封装:文案生成、热点分析、评论回复、SD Prompt 指南 +├─ sd_service.py # SD 封装:3 模型适配 + 9 人设视觉方案 + 换脸 + 反AI后处理 +├─ mcp_client.py # MCP 客户端:小红书搜索、发布、评论、点赞 +├─ analytics_service.py # 笔记数据分析 & 权重学习服务 +└─ publish_queue.py # 内容排期队列(SQLite + 后台 Publisher) ``` ### 核心设计原则 @@ -105,6 +107,8 @@ main.py # 主程序:Gradio UI + 业务逻辑 + 自动化调度 - **MCP 协议** — 通过 JSON-RPC 与小红书 MCP 服务通信,不直接操作浏览器 - **LLM 无关** — 支持所有 OpenAI 兼容 API,不绑定特定提供商 - **UI 逻辑分离** — 业务函数与 Gradio UI 组件分开定义 +- **人设驱动** — 从文案风格到图片视觉,人设参数贯穿全链路 +- **防风控** — 每日操作限额、随机间隔、错误冷却、反 AI 检测多重保护 ## 代码风格 diff --git a/README.md b/README.md index 2ae3d59..fe73d94 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,15 @@

-

🍒 小红书 AI 爆文生产工坊

+

🍒 小红书 AI 爆文生产工坊 V2.5

- 全自动小红书内容创作 & 运营工具
- 灵感 → 文案 → 绘图 → 发布 → 运营,一站式全闭环 + 全自动小红书内容创作 & 智能运营工具
+ 灵感 → 文案 → 绘图 → 排期 → 发布 → 运营 → 学习,全闭环 AI 驱动

功能特性快速开始使用指南配置说明 • + 人设系统FAQ贡献

@@ -18,34 +19,54 @@ ## ✨ 功能特性 -### 📝 内容创作 +### 📝 内容创作(Tab 1) - **AI 文案生成** — 输入主题即可生成小红书爆款标题、正文、话题标签 -- **AI 绘图** — 集成 Stable Diffusion WebUI,自动生成配图(针对 JuggernautXL 优化) +- **AI 绘图** — 集成 Stable Diffusion WebUI,支持 3 款模型智能适配 +- **人设视觉优化** — 9 种人设专属视觉方案,自动注入风格提示词 +- **ReActor 换脸** — 上传头像一键换脸,保持角色一致性 +- **质量模式** — 快速/标准/精细三档,灵活平衡速度与画质 +- **反 AI 检测** — 8 层文案人格化 + 7 步图片后处理,绕过 AI 内容检测 - **一键导出** — 文案 + 图片打包导出到本地文件夹 -### 🔥 热点探测 +### 🔥 热点探测(Tab 2) - **关键词搜索** — 搜索小红书热门笔记,支持多维度排序 - **AI 趋势分析** — 分析热门标题套路、内容结构,给出模仿建议 - **一键借鉴创作** — 参考热门笔记风格生成原创内容 -### 💬 评论管家 +### 💬 评论管家(Tab 3) - **主动评论引流** — 浏览笔记 → AI 智能生成评论 → 一键发送 - **自动回复粉丝** — 加载笔记评论 → AI 生成回复 → 发送 -### 🤖 自动运营(无人值守) +### 🔐 账号管理(Tab 4) +- **扫码登录** — 小红书二维码登录,自动获取 Token +- **多 LLM 提供商** — 支持 DeepSeek、OpenAI、通义千问等所有兼容接口 + +### 📊 数据看板(Tab 5) +- **账号概览** — 粉丝数、获赞数等核心指标可视化 +- **笔记排行** — 点赞排行图表分析 +- **笔记详情** — 全部笔记数据明细表 + +### 🧠 智能学习(Tab 6) +- **数据采集** — 自动采集已发布笔记的互动数据(点赞、评论、收藏) +- **多维权重** — 主题权重、风格权重、标签权重、标题模式权重 +- **AI 深度分析** — LLM 分析笔记表现规律,生成内容策略建议 +- **定时学习** — 后台自动采集 + 分析(1-48 小时可配置) +- **加权发布** — 自动发布时根据笔记表现权重智能选择高互动主题 + +### 🤖 自动运营(Tab 7,无人值守) - **一键评论** — 自动搜索高赞笔记 + AI 生成评论 + 发送 - **一键点赞** — 批量随机点赞,提升账号活跃度 - **一键回复** — 自动扫描我的笔记 + AI 回复粉丝评论 - **一键发布** — 自动生成文案 + SD 生图 + 发布到小红书 - **随机定时** — 评论/点赞/回复/发布全自动定时执行,随机间隔模拟真人 +- **每日限额** — 评论/点赞/收藏/发布/回复独立限额,防封号 +- **错误冷却** — 连续错误自动暂停,避免异常操作 -### 📊 数据看板 -- **账号概览** — 粉丝数、获赞数等核心指标可视化 -- **笔记排行** — 点赞排行图表分析 - -### 🔐 账号管理 -- **扫码登录** — 小红书二维码登录,自动获取 Token -- **多 LLM 提供商** — 支持 DeepSeek、OpenAI、通义千问等所有兼容接口 +### 📅 内容排期(Tab 8) +- **批量生成** — 一键批量生成多篇内容(文案 + 图片)加入队列 +- **队列管理** — 草稿 → 审核 → 排期 → 发布,全流程状态管理 +- **定时发布** — SQLite 队列 + 后台 Publisher 线程自动定时发布 +- **队列处理器** — 启动/停止后台自动发布引擎 --- @@ -170,7 +191,13 @@ npx xiaohongshu-mcp python launch.py --api ``` -推荐模型:[JuggernautXL](https://civitai.com/models/133005)(参数已优化适配)。 +推荐模型: + +| 模型 | 架构 | 风格 | 推荐场景 | +|------|------|------|---------| +| [JuggernautXL](https://civitai.com/models/133005) | SDXL | 电影大片风 | 通用首选,高质量写真 | +| [majicmixRealistic](https://civitai.com/models/43331) | SD 1.5 | 东亚网红风 | 亚洲博主、日韩风 | +| [Realistic Vision](https://civitai.com/models/4201) | SD 1.5 | 纪实摄影风 | 生活场景、街拍 | --- @@ -182,7 +209,8 @@ python launch.py --api 2. **连接 SD**(可选)— 填写 SD WebUI URL,点击「连接 SD」 3. **检查 MCP** — 点击「检查 MCP」确认小红书服务正常 4. **登录小红书** — 切换到「🔐 账号登录」Tab,扫码登录 -5. **开始创作** — 切换到「✨ 内容创作」Tab,输入主题,一键生成 +5. **选择人设** — 在人设下拉框选择博主人设(影响文案风格 + 图片视觉) +6. **开始创作** — 切换到「✨ 内容创作」Tab,输入主题,一键生成 ### 自动化运营 @@ -191,6 +219,25 @@ python launch.py --api - **一键操作** — 手动触发单次评论/点赞/回复/发布 - **定时调度** — 勾选需要的功能,设置间隔时间,点击「▶️ 启动定时」 - **查看日志** — 点击「🔄 刷新日志」查看实时执行记录 +- **每日统计** — 自动跟踪今日操作量,超限自动暂停 + +### 内容排期 + +切换到「📅 内容排期」Tab: + +1. **批量生成** — 点击「📋 批量生成 → 加入队列」,自动生成多篇内容存入队列 +2. **审核内容** — 在队列列表中预览、编辑或驳回草稿 +3. **设定时间** — 为已审核内容设置发布时间 +4. **启动发布** — 点击「▶ 启动队列处理」,后台自动在预定时间发布 + +### 智能学习 + +切换到「🧠 智能学习」Tab: + +1. **采集数据** — 点击「📊 立即采集」收集笔记互动数据 +2. **分析权重** — 系统自动计算主题/风格/标签权重 +3. **启用加权** — 开启后自动发布时优先选择高互动主题 +4. **定时学习** — 设置自动采集间隔,持续优化内容策略 --- @@ -205,7 +252,7 @@ python launch.py --api "sd_url": "http://127.0.0.1:7860", "mcp_url": "http://localhost:18060/mcp", "model": "deepseek-chat", - "persona": "温柔知性的时尚博主", + "persona": "赛博AI虚拟博主,住在2077年的数码女孩...", "my_user_id": "你的小红书userId(24位)" } ``` @@ -217,7 +264,7 @@ python launch.py --api | `sd_url` | Stable Diffusion WebUI 地址 | 绘图需要 | | `mcp_url` | xiaohongshu-mcp 服务地址 | ✅ | | `model` | 默认使用的 LLM 模型名 | ✅ | -| `persona` | AI 评论回复的人设 | 可选 | +| `persona` | 博主人设(影响文案风格 + SD 视觉风格) | 可选 | | `my_user_id` | 你的小红书 userId(24 位十六进制) | 数据看板/自动回复需要 | | `llm_providers` | 多 LLM 提供商配置数组 | 通过 UI 管理 | @@ -233,11 +280,13 @@ python launch.py --api ``` xhs-autobot/ -├── main.py # 主程序入口 (Gradio UI + 业务逻辑) +├── main.py # 主程序入口 (Gradio UI + 业务逻辑 + 8 个 Tab) ├── config_manager.py # 配置管理模块 (单例、自动保存) -├── llm_service.py # LLM 服务封装 (文案生成、热点分析、评论回复) -├── sd_service.py # Stable Diffusion 服务封装 (txt2img、img2img) +├── llm_service.py # LLM 服务封装 (文案生成、热点分析、评论回复、SD Prompt 指南) +├── sd_service.py # Stable Diffusion 服务封装 (3 模型适配、9 人设视觉方案) ├── mcp_client.py # 小红书 MCP 客户端 (搜索、发布、评论、点赞) +├── analytics_service.py # 笔记数据分析 & 权重学习服务 +├── publish_queue.py # 内容排期队列 (SQLite + 后台 Publisher) ├── config.json # 运行时配置 (gitignore) ├── config.example.json # 配置模板 ├── requirements.txt # Python 依赖 @@ -245,11 +294,40 @@ xhs-autobot/ ├── docker-compose.yml # Docker Compose 编排 ├── .dockerignore # Docker 构建排除规则 ├── xhs_workspace/ # 导出的文案和图片 (gitignore) +│ ├── publish_queue.db # 排期队列数据库 +│ ├── analytics_data.json # 笔记表现数据 +│ └── content_weights.json # 内容权重数据 └── autobot.log # 运行日志 (gitignore) ``` --- +## 🎭 人设系统 + +项目内置 **28 种博主人设**,每种人设拥有: +- **专属主题池** — 匹配人设的内容方向(如健身博主自动抽健身主题) +- **评论关键词** — 搜索和评论时使用与人设相关的关键词 +- **SD 视觉方案** — 9 种人设拥有专属视觉优化(prompt_boost + 风格词 + 负面词) +- **LLM 指导词** — LLM 生成 SD Prompt 时收到人设专属的视觉风格引导 + +### 内置人设视觉方案 + +| 人设 | 视觉风格 | +|------|----------| +| 赛博AI虚拟博主 | 科幻/赛博朋克,发光特效,极致完美面容 | +| 性感福利主播 | 暖金色调,闺房/泳池,魅力摄影 | +| 身材管理健身美女 | 健身房/运动场,活力运动风 | +| 温柔知性时尚博主 | 法式优雅,时装杂志质感 | +| 文艺青年摄影师 | 胶片颗粒,Kodak Portra 怀旧色调 | +| 二次元coser | 动漫灵感,Cosplay,鲜艳色彩 | +| 汉服爱好者 | 水墨画风,丝绸流动,古典意境 | +| 独居女孩 | 温馨烛光,Hygge 风格 | +| 资深美妆博主 | 环形灯棚拍,完美妆容特写 | + +选择「🎲 随机人设」可每次自动切换,增加账号内容多样性。 + +--- + ## ❓ 常见问题
@@ -282,6 +360,26 @@ xhs-autobot/ 支持所有 OpenAI 兼容接口,包括但不限于:DeepSeek、GPT-4o、通义千问、Gemini(通过中转)、Claude(通过中转)等。
+
+Q: 反 AI 检测是怎么实现的? + +**文案层面**(8 层人格化):口语化改写、插入不完美表达、随机错别字、方言词汇、不规律标点、emoji 混入、段落长度随机化、句式打乱。 + +**图片层面**(7 步后处理):微旋转裁剪、轻微色偏、随机噪点、JPEG 二次压缩(质量 82-92)、EXIF 清除、局部模糊/锐化、微位移。 +
+ +
+Q: 如何添加自定义人设? + +在人设下拉框中直接输入自定义人设描述即可(支持自由输入)。如需配套主题池和关键词,需在 `main.py` 的 `PERSONA_POOL_MAP` 中添加对应条目。如需配套 SD 视觉方案,需在 `sd_service.py` 的 `PERSONA_SD_PROFILES` 中添加。 +
+ +
+Q: 支持哪些 SD 模型? + +内置适配 3 款模型:majicmixRealistic(SD 1.5)、Realistic Vision(SD 1.5)、Juggernaut XL(SDXL)。系统会自动检测当前模型并匹配最佳参数。未知模型自动回退到 SDXL 默认档案。 +
+ --- ## 🤝 贡献指南