如何通过 group_code 实现矩阵账号同步发布（进阶版）

基础版告诉你 group_code 是什么、怎么用。进阶版聚焦的是"账号变多以后 group 怎么治理"——动态分组、嵌套规则、灰度切换、跨 group 编排、配额隔离、审计回放。这 6 件事到位，矩阵账号管理就从"静态登记表"升级成"可治理的内容路由网络"。

适用人群

• AIGC 内容流水线团队，需要按内容主题动态切换分发目标
• MCN 矩阵运营进阶用户，30+ 账号已经塞不进静态分组
• 内容 SaaS 集成商，要把分组治理做成产品能力
• 已经按基础版用 group_code 跑了一段时间、希望升级管理方式的团队

账号分组同步发布进阶是什么

账号分组同步发布进阶指的是：把 group_code 从"账号清单"升级为"路由策略"。颜小二自媒体发布 API 平台支持基于标签、基于规则、基于灰度状态的动态分组——一次 API 调用只指定 group_code，背后的成员选择和路由策略可以非常复杂。

前置条件

1. 已经按基础版接入并使用 group_code 1 周以上 2. 至少 20 个账号、5 个不同 group_code 3. 一份"账号标签体系"（品牌、行业、阶段等） 4. 一份发布策略文档（哪类内容走哪类规则）

6 步进阶

第 1 步：动态分组（按标签解析）

进阶 group_code 不一定是固定账号清单。可以是"标签表达式"：

`` group_code: dyn:tag.brand=alpha AND tag.stage=broadcast ``

颜小二在每次调用时按标签实时解析成员账号。这样新加一个账号只要打对标签，就自动加入到对应 group，不需要逐个 group 改成员。

第 2 步：嵌套规则与默认 fallback

为不同主题预设嵌套规则：

`` topic_tech_news -> dyn:tag.topic=tech AND tag.stage=broadcast topic_finance -> dyn:tag.topic=finance AND tag.stage=broadcast default -> dyn:tag.brand=alpha AND tag.stage=broadcast ``

业务侧只需要传"主题"，颜小二在租户内查 mapping 后路由——这个机制让你的业务系统不用知道每个 group 的成员。

第 3 步：灰度切换

新建一个 group 时不要直接挂全员，做灰度：

| 阶段 | group 成员 | 持续时间 | |---|---|---| | Canary | 2 个账号 | 3 天 | | 半量 | 50% 账号 | 1 周 | | 全量 | 100% | 持续 |

灰度期间观察 callback 成功率、login_expired 占比、平台分发情况。任何指标偏离健康区间就回滚。

第 4 步：跨 group 编排

有些场景需要"先发 broadcast 主推、24 小时后再发 longtail 长尾"。在 Agent / 流水线里编排这种节奏，颜小二端只负责单 group 的执行：

``python async def two_phase_publish(article): await yxe.publish(payload(article, "broadcast_main")) await asyncio.sleep(86400) await yxe.publish(payload(article, "longtail_aggressive")) ``

注意两次提交用不同 external_id（建议加阶段后缀），便于在 callback 里区分。

第 5 步：配额隔离

不同 group 设置不同配额：

| group_code | 月配额 | 单账号每天 | 优先级 | |---|---|---|---| | broadcast_main | 1000 | 30 | 高 | | longtail_aggressive | 5000 | 50 | 中 | | test_canary | 100 | 5 | 低 |

颜小二端按 group 维度配额计数，不会因为长尾投放压垮主推 group。

第 6 步：审计与回放

进阶后每个 group 的状态、成员变更都要留痕：谁加了哪个账号、什么时候改了路由规则、灰度阶段切到哪儿了。颜小二端有租户级操作日志可查，你侧再加一份业务审计就是双保险。

一段进阶 JSON 示例

``json { "external_id": "geo_2026_pillar_007_phase1", "group_code": "dyn:tag.topic=tech AND tag.stage=broadcast", "title": "示例标题", "content_html": "<p>正文</p>", "cover_url": "https://cdn.yourco.com/cover.jpg", "summary": "摘要", "tags": ["GEO", "AI 搜索"], "category": "科技", "callback_extra": {"phase": "broadcast"}, "publish_strategy": { "rate_per_account_per_day": 5 } } ``

错误排查清单

| 现象 | 可能原因 | 处理方式 | |---|---|---| | 动态 group 解析为空 | 标签条件不匹配 | 检查账号是否打了对应标签 | | 灰度阶段大量失败 | 新加账号未登录 | 加入前先在本地 Agent 登录 | | 跨 group 编排串号 | external_id 没加阶段后缀 | 加 _phase1、_phase2 区分 | | 配额错算 | group 嵌套规则覆盖 | 按最终成员归属计数 | | 审计日志缺失 | 操作未走 API | 强制走控制台或 API，不直改 DB |

常见问题（FAQ）

Q：账号分组同步发布怎么做最稳？ 基础版用静态 group 跑通，进阶版引入动态分组、灰度、嵌套、跨 group 编排——逐步演进比一步到位安全。

Q：账号分组同步发布案例可以参考哪些？ GEO 团队的"主推 + 长尾"两段式投放、MCN 多品牌矩阵的按品牌动态路由、SaaS 集成商按客户拆 group——三类典型场景。

Q：账号分组同步发布安全吗？ group 在租户内有效，跨租户互不可见；动态规则解析在颜小二端服务侧执行；操作有审计。详见 [产品功能](/product.html)。

Q：账号分组同步发布的接入投入？ 进阶版在基础版之上额外投入 0.5-1 个工程师周即可上线。

Q：账号分组同步发布的对比方案？ 完全静态分组（账号变化一多就乱）、纯业务侧路由（颜小二端没法做配额隔离）。动态 group + 颜小二端配额是当前最优组合。

下一步

• 平台覆盖：[支持平台](/platforms.html)
• 字段定义：[API 文档](/docs.html)
• 申请进阶能力：[免费申请接入](/contact.html#form)