From 69b92ae44f955332c374a6fd8f41f89a2821c85e Mon Sep 17 00:00:00 2001 From: yumoqing Date: Tue, 4 Aug 2026 08:27:45 +0800 Subject: [PATCH] docs: add platform credentials table to README + skills/ directory --- README.md | 72 ++++++++++++++++++++++---------- skills/publisher-module/SKILL.md | 69 ++++++++++++++++++++++++++++++ 2 files changed, 119 insertions(+), 22 deletions(-) create mode 100644 skills/publisher-module/SKILL.md diff --git a/README.md b/README.md index 54846e2..29c4822 100644 --- a/README.md +++ b/README.md @@ -4,17 +4,51 @@ Sage 框架模块 — 多平台内容一键发布。支持文章/视频/音频/ ## 支持平台 -| 平台代码 | 平台名称 | 支持内容类型 | -|---------|---------|------------| -| `weibo` | 微博 | article, video, image | -| `douyin` | 抖音 | video, image | -| `bilibili` | B站 | video, article, image | -| `kuaishou` | 快手 | video, image | -| `wechat` | 微信公众号 | article | -| `xiaohongshu` | 小红书 | article, image, video | -| `toutiao` | 头条号 | article, video | -| `youtube` | YouTube | video | -| `twitter` | Twitter/X | article, image, video | +| 平台代码 | 平台名称 | 支持内容类型 | 标题上限 | 正文上限 | 媒体上限 | +|---------|---------|------------|:---:|:---:|:---:| +| `weibo` | 微博 | article, video, image | — | 2000字 | 图片1张 | +| `douyin` | 抖音 | video, image | 100字 | 500字 | 图片9张 | +| `bilibili` | B站 | video, article, image | 80字 | 2000字 | — | +| `kuaishou` | 快手 | video, image | — | 500字 | — | +| `wechat` | 微信公众号 | article | 64字 | 50000字 | 封面图 | +| `channels` | 微信视频号 | video, image | 50字 | 500字 | 图片9张 | +| `xiaohongshu` | 小红书 | article, image, video | 20字 | 1000字 | 图片9张 | +| `toutiao` | 头条号 | article, video | 30字 | 20000字 | — | +| `youtube` | YouTube | video | 100字 | 5000字 | — | +| `twitter` | Twitter/X | article, image, video | — | 280字 | 图片4张 | + +## 平台认证凭据 + +每个平台需要配置 `publisher_platform` 记录，通用字段： + +| 字段 | 说明 | 必填 | +|------|------|:---:| +| `platform_code` | 平台代码（上表第一列） | ✓ | +| `app_key` | App Key / Client ID / AppID | ✓ | +| `app_secret` | App Secret（加密存储） | ✓ | +| `access_token` | OAuth 2.0 访问令牌 | ✓ | +| `refresh_token` | 刷新令牌（YouTube 必填） | 部分 | +| `extra_config` | 平台特有参数 JSON | 部分 | + +各平台 `extra_config` 需要的额外字段： + +| 平台 | 额外字段 | 说明 | +|------|---------|------| +| 微博 | `uid` | 微博用户 UID | +| 抖音 | `open_id` | 授权用户的 open_id | +| B站 | `cookie` | 部分接口需 Cookie | +| 快手 | `open_id` | 用户唯一标识 | +| 公众号 | — | AppID+Secret 即可，token 2h过期需定时刷新 | +| 视频号 | `open_id` | 同公众号体系独立授权 | +| 小红书 | `user_id` | 创作者身份 ID | +| 头条号 | `user_id` | 头条作者 ID | +| YouTube | `channel_id` | 目标频道 ID | +| Twitter | `oauth_token_secret` | OAuth 1.0a Token Secret | + +配置示例: +```json +{"uid": "1234567890", "open_id": "abc123", "channel_id": "UCxxx"} +``` ## 目录 @@ -26,7 +60,8 @@ publisher/ │ ├── platforms.py # 10 平台 API 适配器 │ ├── engine.py # 发布引擎 + 定时调度 │ └── db.py # 数据库操作 -├── json/ # 表定义 (4 张表) +├── models/ # 表定义 (4 张表) +├── skills/ # Hermes 技能文件 ├── wwwroot/publisher/ # UI + DSPY 端点 ├── ddl/mysql.sql ├── scripts/load_path.py @@ -39,24 +74,17 @@ publisher/ git clone git@git.opencomputing.cn:yumoqing/publisher.git /tmp/publisher SAGE_ROOT=/path/to/sage cp -r /tmp/publisher/publisher $SAGE_ROOT/ -cp /tmp/publisher/json/publisher_*.json $SAGE_ROOT/json/ +cp /tmp/publisher/models/publisher_*.json $SAGE_ROOT/models/ cp -r /tmp/publisher/wwwroot/publisher $SAGE_ROOT/wwwroot/ mysql -u user -p sage < /tmp/publisher/ddl/mysql.sql -cd $SAGE_ROOT && python scripts/load_path.py # 从 publisher/scripts/ +cd $SAGE_ROOT && python scripts/load_path.py ``` sage.py 中添加: `from publisher.init import load_publisher` + `load_publisher()` -## 使用 - -1. 配置平台 → 填 App Key/Secret/Access Token -2. 创建内容 → 选类型(article/video/audio/image) + 媒体URL -3. 创建任务 → 选内容 + 平台 + 定时发布时间 -4. 点击「执行待发布任务」 - ## 新增平台 -编辑 `publisher/platforms.py`，添加: +编辑 `publisher/platforms.py`: ```python from publisher.platforms import register diff --git a/skills/publisher-module/SKILL.md b/skills/publisher-module/SKILL.md new file mode 100644 index 0000000..65714bf --- /dev/null +++ b/skills/publisher-module/SKILL.md @@ -0,0 +1,69 @@ +--- +name: publisher-module +description: Multi-platform content publishing module for Sage — articles, videos, audio to 10 social platforms +category: devops +--- + +# Publisher Module + +Multi-platform content publishing for Sage. Covers 10 platforms: weibo, douyin, bilibili, kuaishou, wechat (公众号), channels (视频号), xiaohongshu, toutiao, youtube, twitter. + +## Architecture + +- **Repo**: `git@git.opencomputing.cn:yumoqing/publisher.git` +- **Tables** (4): `publisher_platform`, `publisher_content`, `publisher_task`, `publisher_log` +- **Content types**: article, video, audio, image +- **DSPY pattern**: `import json` + `get_sor_context(env, 'sage')` + `env.run_scheduled(sor)` + +## Adding a Platform + +Edit `publisher/platforms.py`: + +```python +from publisher.platforms import register + +def publish_newplat(platform, content): + headers = {'Authorization': 'Bearer ' + platform['access_token']} + body = {'text': content.get('title', '')} + return ('POST', 'https://api.newplat.com/publish', headers, body, content['content_type']) + +register('newplat', '新平台', publish_newplat, ['article', 'image', 'video']) +``` + +Each platform needs in `publisher_platform`: +- `app_key` + `app_secret` (all) +- `access_token` (all) +- `refresh_token` (YouTube) +- `extra_config` JSON with platform-specific fields (uid/open_id/channel_id/etc.) + +## Platform Credentials Quick Reference + +| platform_code | extra_config fields | Notes | +|---|---|---| +| weibo | uid | Weibo user UID required | +| douyin | open_id | OAuth authorized user | +| bilibili | cookie | Some endpoints need Cookie | +| kuaishou | open_id | User identifier | +| wechat | — | Token expires every 2h | +| channels | open_id | Separate auth from 公众号 | +| xiaohongshu | user_id | Creator ID | +| toutiao | user_id | Author ID | +| youtube | channel_id | Needs refresh_token | +| twitter | oauth_token_secret | OAuth 1.0a | + +## Deployment Checklist + +1. `cp -r publisher $SAGE_ROOT/` +2. `cp models/publisher_*.json $SAGE_ROOT/models/` +3. `cp -r wwwroot/publisher $SAGE_ROOT/wwwroot/` +4. Execute `ddl/mysql.sql` +5. Run `scripts/load_path.py` +6. `from publisher.init import load_publisher` + `load_publisher()` in sage.py +7. Restart Sage + +## Pitfalls + +- Platform APIs require real credentials — access_token expires, need refresh flow +- Content format differs per platform (Weibo 2000, WeChat title 64, Twitter 280) +- Network errors auto-retry 3 times before marking failed +- `sor` parameter allows DSPY context reuse