# 小红书自动化推广系统（宇之然项目组件）

## 📋 项目概览

为手机配件京东店铺设计的**小红书自动化内容发布系统**，当前会话完全隔离，不影响其他agent。

## 🗂️ 目录结构

```
/root/openclaw-workspace/projects/yu-zhi-ran/
├── sessions/promoter/           # 🔒 会话隔离存储
│   ├── cookies/                # 登录状态
│   ├── screenshots/            # 操作截图
│   └── logs/                   # 运行日志
├── scripts/                    # 自动化脚本
│   ├── xhs-promoter.sh         # 基础脚本
│   └── xhs-publish-advanced.sh # 高级脚本
├── content/                    # 内容库
│   ├── posts/                  # 笔记内容
│   └── images/                 # 图片素材
├── cron/                       # 定时任务配置
│   └── promoter-schedule.json
└── docs/                       # 文档
    └── xhs-setup-guide.md
```

## ✅ 已完成

1. **环境搭建**
   - [x] 创建会话隔离目录结构
   - [x] 验证 agent-browser 可用（v0.23.0）
   - [x] 验证 Xvfb 支持
   - [x] 分析小红书登录页结构

2. **脚本开发**
   - [x] 基础登录/检查/发布脚本
   - [x] 高级发布脚本（批量、定时、状态监控）
   - [x] 示例内容模板（手机配件场景）

3. **配置文档**
   - [x] 设置指南（Cookie导入）
   - [x] 定时任务配置

## ⏳ 待完成

1. **登录授权**（需要你的操作）
   - [ ] 获取小红书Cookie
   - [ ] 上传到隔离目录
   - [ ] 验证登录状态

2. **内容准备**
   - [ ] 准备产品图片
   - [ ] 创建真实内容文件
   - [ ] 测试单篇发布

3. **自动化测试**
   - [ ] 测试定时发布
   - [ ] 监控日志输出
   - [ ] 调整风控参数

## 🚀 快速开始

### 1. 查看当前状态
```bash
/root/openclaw-workspace/projects/yu-zhi-ran/scripts/xhs-publish-advanced.sh status
```

### 2. 查看帮助
```bash
/root/openclaw-workspace/projects/yu-zhi-ran/scripts/xhs-publish-advanced.sh help
```

### 3. 创建示例内容
```bash
/root/openclaw-workspace/projects/yu-zhi-ran/scripts/xhs-publish-advanced.sh sample
```

### 4. 查看示例内容
```bash
cat /root/openclaw-workspace/projects/yu-zhi-ran/content/posts/sample-post.json
```

## 🔐 登录步骤（关键）

由于服务器无图形界面，需要**Cookie导入**方式登录：

### 方式一：浏览器扩展导出（推荐）

1. 在本地电脑登录 [creator.xiaohongshu.com](https://creator.xiaohongshu.com)
2. 安装 [EditThisCookie](https://chrome.google.com/webstore/detail/editthiscookie/) 扩展
3. 导出为 JSON 格式
4. 保存到服务器的隔离路径：
   ```
   /root/openclaw-workspace/projects/yu-zhi-ran/sessions/promoter/cookies/xhs-session.json
   ```

### 方式二：手动复制Cookie

1. F12打开开发者工具 → Application → Cookies
2. 复制关键字段：`session_id`, `web_id`, `gid`, `a1` 等
3. 创建JSON文件：
   ```json
   [
     {"name": "session_id", "value": "your_value", "domain": ".xiaohongshu.com"},
     {"name": "web_id", "value": "your_value", "domain": ".xiaohongshu.com"}
   ]
   ```

## 📊 自动化能力

| 功能 | 状态 | 说明 |
|------|------|------|
| 登录状态保持 | ✅ | Cookie隔离存储 |
| 单篇发布 | 🧪 | 框架完成，需测试 |
| 批量发布 | 🧪 | 支持JSON配置 |
| 定时任务 | 🧪 | Cron配置就绪 |
| 图片上传 | ⚠️ | 需要进一步开发 |
| 评论互动 | ❌ | 需额外开发，风险高 |

## ⚠️ 风控建议

1. **发布频率**: 每天1-2条，间隔至少6小时
2. **内容去重**: 同一产品换不同角度拍摄
3. **账号权重**: 建议养号2周后再开自动化
4. **备用策略**: 准备2-3个小号轮换

## 📝 下一步行动

需要你来完成：

1. [ ] **提供Cookie** - 按上述方式获取并上传
2. [ ] **准备素材** - 产品图片（建议每个产品5-10张场景图）
3. [ ] **测试发布** - 验证自动化流程
4. [ ] **启用定时** - 配置正式发布计划

或者我可以帮你：
- 创建更详细的内容模板
- 配置知乎/其他平台
- 开发评论互动功能（谨慎）

你想先完成哪一步？