✨ feat(docs): 更新项目文档以反映 v2.5 版本新特性

- 更新 CHANGELOG.md，新增 v2.5.0 版本日志，记录人设专属 SD 视觉优化、新增人设及内容排期系统等重大功能 - 更新 CONTRIBUTING.md 项目架构图，补充新增的服务模块（analytics_service.py, publish_queue.py）和核心设计原则 - 全面更新 README.md，将项目标题升级至 V2.5，重构功能特性章节以对应 8 个 Tab，新增人设系统、内容排期、智能学习、反 AI 检测等核心功能的详细说明，并更新配置说明和常见问题解答
2026-02-10 22:50:41 +08:00 · 2026-02-10 22:50:41 +08:00 · a75d6ea422
commit a75d6ea422
parent e70cdace23
3 changed files with 189 additions and 26 deletions
--- 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

 ### 🚀 新功能
--- 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 检测多重保护

 ## 代码风格

--- a/README.md
+++ b/README.md
@ -1,14 +1,15 @@
 <p align="center">
-  <h1 align="center">🍒 小红书 AI 爆文生产工坊</h1>
+  <h1 align="center">🍒 小红书 AI 爆文生产工坊 V2.5</h1>
  <p align="center">
-    <strong>全自动小红书内容创作 & 运营工具</strong><br>
-    灵感 → 文案 → 绘图 → 发布 → 运营，一站式全闭环
+    <strong>全自动小红书内容创作 & 智能运营工具</strong><br>
+    灵感 → 文案 → 绘图 → 排期 → 发布 → 运营 → 学习，全闭环 AI 驱动
  </p>
  <p align="center">
    <a href="#功能特性">功能特性</a> •
    <a href="#快速开始">快速开始</a> •
    <a href="#使用指南">使用指南</a> •
    <a href="#配置说明">配置说明</a> •
+    <a href="#人设系统">人设系统</a> •
    <a href="#常见问题">FAQ</a> •
    <a href="#贡献指南">贡献</a>
  </p>
@ -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 风格 |
+| 资深美妆博主 | 环形灯棚拍，完美妆容特写 |
+
+选择「🎲 随机人设」可每次自动切换，增加账号内容多样性。
+
+---
+
 ## ❓ 常见问题

 <details>
@ -282,6 +360,26 @@ xhs-autobot/
 支持所有 OpenAI 兼容接口，包括但不限于：DeepSeek、GPT-4o、通义千问、Gemini（通过中转）、Claude（通过中转）等。
 </details>

+<details>
+<summary><b>Q: 反 AI 检测是怎么实现的？</b></summary>
+
+**文案层面**（8 层人格化）：口语化改写、插入不完美表达、随机错别字、方言词汇、不规律标点、emoji 混入、段落长度随机化、句式打乱。
+
+**图片层面**（7 步后处理）：微旋转裁剪、轻微色偏、随机噪点、JPEG 二次压缩（质量 82-92）、EXIF 清除、局部模糊/锐化、微位移。
+</details>
+
+<details>
+<summary><b>Q: 如何添加自定义人设？</b></summary>
+
+在人设下拉框中直接输入自定义人设描述即可（支持自由输入）。如需配套主题池和关键词，需在 `main.py` 的 `PERSONA_POOL_MAP` 中添加对应条目。如需配套 SD 视觉方案，需在 `sd_service.py` 的 `PERSONA_SD_PROFILES` 中添加。
+</details>
+
+<details>
+<summary><b>Q: 支持哪些 SD 模型？</b></summary>
+
+内置适配 3 款模型：majicmixRealistic（SD 1.5）、Realistic Vision（SD 1.5）、Juggernaut XL（SDXL）。系统会自动检测当前模型并匹配最佳参数。未知模型自动回退到 SDXL 默认档案。
+</details>
+
 ---

 ## 🤝 贡献指南