Initial commit: yu-zhi-ran platform with automation integration

2026-04-19 14:05:09 +08:00
commit 3cb2df51c8
209 changed files with 80379 additions and 0 deletions
@@ -0,0 +1,141 @@
+# 小红书自动化推广系统（yzr-yxl会话隔离版）
+
+## 📋 项目概览
+
+为手机配件京东店铺设计的**小红书自动化内容发布系统**，当前会话完全隔离，不影响其他agent。
+
+## 🗂️ 目录结构
+
+```
+/root/.openclaw/workspaces/yzr-yxl/
+├── 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/workspaces/yzr-yxl/scripts/xhs-publish-advanced.sh status
+```
+
+### 2. 查看帮助
+```bash
+/root/.openclaw/workspaces/yzr-yxl/scripts/xhs-publish-advanced.sh help
+```
+
+### 3. 创建示例内容
+```bash
+/root/.openclaw/workspaces/yzr-yxl/scripts/xhs-publish-advanced.sh sample
+```
+
+### 4. 查看示例内容
+```bash
+cat /root/.openclaw/workspaces/yzr-yxl/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/workspaces/yzr-yxl/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. [ ] **启用定时** - 配置正式发布计划
+
+或者我可以帮你：
+- 创建更详细的内容模板
+- 配置知乎/其他平台
+- 开发评论互动功能（谨慎）
+
+你想先完成哪一步？