account-pool-manager

Account Pool Manager - 自媒体多账户池管理

版本: v1.1
创建日期: 2026-04-26
状态: 🟢 已完成
优先级: P0（自媒体业务核心基础设施）
文档字数: ≥2000 字

---

一、业务背景

1.1 为什么需要统一的多账户池？

JueJin 自媒体内容营销有 4 种业务对象，每种需要不同的账号：

核心问题：发布内容时，如何自动选择正确的账号？如何管理所有账号的 Cookie？如何健康检查？

1.2 与 account-manager 的区别

边界原则：

• 当账号被封/被限制时 → 使用 account-manager 切换备用号
• 当发布内容需要选择发布账号时 → 使用 account-pool-manager 获取账号
• 两者功能互补，互不替代，可以同时存在

结论：两者功能互补，互不替代。

---

二、架构设计

2.1 目录结构

data/content/accounts/
├── pool_config.json                    # 账户池全局配置
├── self_media/                         # 自媒体自营账号
│   ├── account_001.json
│   └── account_002.json
├── social_dept/                        # 社交部账号
├── ecommerce_dept/                     # 电商部账号
└── clients/                            # 外包客户账号

data/content/cookies/                # Cookie 存储（统一管理）
├── douyin_self_media_001.json          # 格式：{platform}_{account_id}.json
└── ...

data/content/health/                 # 健康检查记录
└── health_report.json                  # 最新健康报告

2.2 账号配置文件格式

{
  "account_id": "self_media_001",
  "department": "self_media",
  "platforms": {
    "douyin": {
      "cookie_path": "data/content/cookies/douyin_self_media_001.json",
      "status": "active",
      "last_publish": "2026-04-26T10:00:00Z",
      "publish_count_today": 3,
      "daily_limit": 10
    }
  },
  "created_at": "2026-04-01T00:00:00Z",
  "notes": "自媒体主力账号"
}

---

三、工作流程

3.1 主流程：获取发布账号

1. 接收发布请求
   └── 输入：{business_type: "self_media", platforms: ["douyin", "xiaohongshu"]}

2. 查询账户池 → 按部门筛选 → 过滤可用账号 → 轮换选择

3. 检查 Cookie 健康 → 返回账号信息和 cookie 路径

4. 输出 → 供 content-publisher 调用 sau 进行发布

3.2 Cookie 健康检查流程

1. Cron 每日 08:00 触发 → exec 调用 cookie_health.py check_all
2. 扫描所有 Cookie 文件 → 检查文件/大小/时间
3. 生成健康报告 → healthy(≤7天) / warning(7-25天) / expired(>25天)
4. 推送通知 → expired立即通知 / warning每日提醒

---

四、输入输出格式

4.1 获取发布账号

输入: {"action": "get_publish_account", "business_type": "self_media", "platforms": ["douyin", "xiaohongshu"]}

输出: {"success": true, "data": {"account_id": "self_media_001", "department": "self_media", "platforms": {...}}, "error": null, "code": "AP-SUCCESS-01"}

4.2 Cookie 健康检查

输入: {"action": "check_cookie_health"}

输出: {"success": true, "data": {"total": 10, "healthy": 7, "warning": 2, "expired": 1, "details": [...]}, "error": null, "code": "AP-SUCCESS-02"}

---

五、异常处理

---

六、与 content-publisher 集成

6.1 集成流程

content-publisher 收到发布请求
    ↓
调用 account-pool-manager 获取账号和 cookie 路径
    ↓
调用 sau 进行真实发布
    ↓
记录发布结果到账号历史

6.2 content-publisher 修改点

在 execute_real_publish() 中：

1. 调用 account_manager.py get_publish_account 获取账号
2. 使用返回的 cookie_path 构建 sau CLI 命令
3. 发布成功后更新账号的 publish_count_today

---

七、使用示例

输入格式

{
  "action": "get_publish_account",
  "business_type": "self_media",
  "platforms": ["douyin", "xiaohongshu"]
}

支持action: get_publish_account(获取发布账号)/check_cookie_health(Cookie健康检查)/rotate_account(轮换账号)/list_pool(列出账号池)/add_account(添加账号)

示例1：获取发布账号

python "skills/account-pool-manager/scripts/account_manager.py" get_publish_account self_media "douyin,xiaohongshu"

预期输出：

{"success": true, "data": {"account_id": "self_media_001", "department": "self_media",
  "platforms": {"douyin": {"cookie_path": "data/content/cookies/douyin_self_media_001.json",
    "status": "active", "publish_count_today": 3, "daily_limit": 10}}},
  "error": null, "code": "AP-SUCCESS-01"}

示例2：注册新账号

python "skills/account-pool-manager/scripts/account_manager.py" register_account '{"account_id": "self_media_003", "department": "self_media", "platforms": {"douyin": {}, "xiaohongshu": {}}, "daily_limit": 10, "notes": "新注册"}'

示例3：Cookie健康检查

python "skills/account-pool-manager/scripts/cookie_health.py" check_all

预期输出：

{"success": true, "data": {"total": 5, "healthy": 4, "warning": 1, "expired": 0,
  "details": [{"cookie_file": "douyin_self_media_001.json", "status": "healthy", ...}]},
  "error": null, "code": "AP-SUCCESS-02"}

示例4：查询健康报告

python "skills/account-pool-manager/scripts/report_manager.py" get_report

示例5：与 content-publisher 集成

# content-publisher 内部自动调用 account-pool-manager 获取账号
python "skills/content-publisher/scripts/content_publisher.py" --action publish_auto --content_id video_001 --platforms douyin,xiaohongshu --business_type self_media

---

八、风控安全规则（来源: 01手册§十10.1）

---

九、相关文件

• SKILL.md: skills/account-pool-manager/SKILL.md
• exec 脚本:
  • skills/account-pool-manager/scripts/account_manager.py (账号注册/查询/轮换)
  • skills/account-pool-manager/scripts/cookie_health.py (Cookie健康检查)
  • skills/account-pool-manager/scripts/report_manager.py (健康报告管理)
• 数据目录: data/content/accounts/、data/content/cookies/、data/content/health/
• 升级方案: docs/design/电商营销能力升级方案.md

---

变更历史