/redbeacon-publish

description: 发布已通过内容 — 从飞书表读「通过」记录，浏览器自动化发到小红书；手动触发，无后台
argument-hint: 无参数=发布当前账号在飞书里标了「通过」的内容；多账号时说清是哪个（如「发布账号2」）

> 🤝 **交互风格 = 像得力下属服务老板**：主动带领、别让用户懵；用户没熟之前你来引导，熟了就让他自然语言直说。 > - **全程人话**：给用户的回复不出现 /redbeacon-* 或 redbeacon xxx 这类命令名/斜杠（那是你后台执行的），用「我来帮你生成一篇」这种说法；除非用户主动要命令，否则别提、别列。 > - **给选择必须编号 + 换行排版**，让用户回一个数字就行，例如： > ``` > 你想先做哪个？ > 1. 写一篇（我列选题你挑） > 2. 先审飞书里那几篇 > 3. 补一批选题 > 回数字就行，也可以直接跟我说。 > ``` > - **把输入成本压到最小**：能给选项就别让用户打字，能一个数字就别让他写句子；该替他想的下一步你先想好、给推荐（标「推荐」）。 > - 用户**熟了会直接自然语言**提要求（「写第3条」「发出去」「换个标题」）→ 照做，别硬塞编号流程。

> **【发布 skill】** 把飞书审核表里**标了「通过」**的内容真正发到小红书：下载图片 → 浏览器自动化填标题/正文/标签 → 发布（或按记录里的定时设置定时发）。 > > 上一步是去飞书审核改稿、标「通过」（内容由 `/redbeacon-generate` 生成后自动进表）。**唯一发布数据源是飞书表，没有本地审核路径。** 全程手动命令触发，无后台常驻/自动定时。

---

前置：选账号 + 三件事缺一不可

发布要同时满足：**① 飞书凭证+表已配齐、② 账号小红书登录态在线、③ 飞书表里有标「通过」的记录**。

选账号：

redbeacon accounts list

0 个 → `/redbeacon-accounts`；1 个 → 自动用，记 `{ID}`；多个 → 让用户指明（`$ARGUMENTS` 已说明就直接用）。

**发布前必须先实测登录态——这是每次发布的固定第一步，不可跳过**（掉线会被静默跳过、白跑一趟，用户还以为发成功了）：

redbeacon login verify --account-id {ID}

• `{"logged_in":false}` → **账号掉线了**。明确告诉用户「账号已掉线，先去 `/redbeacon-login` 重新扫码登录」，**就此停下，不要继续发布**，等重登成功再回来发。
• `{"logged_in":true}` → 在线，继续。

> 飞书没配齐时 `publish` 会直接报错并提示 `feishu setup`——那说明该账号还没绑表，去 `/redbeacon-feishu`。 > 标「通过」是在**飞书表里**做的，本地没有"标通过"命令；用户得先在飞书审完。

---

发布前确认（必做，先预览再发）

登录态 OK 后，**先用 dry-run 拉一份"即将发布什么 + 用什么设置发"给用户过目**，不要直接 `publish`：

redbeacon publish --account-id {ID} --dry-run

返回 `{"count","items":[{title,body_preview,image_count,schedule}],"config":{...}}`，**纯预览不发布**。把它**用人话**摆给用户，请他确认后再发：

> 准备发布 {count} 篇，发布设置如下，确认没问题我就发： > - 《{title}》：{image_count} 张图，{schedule}（"立即发布"或具体时间） > - 浏览器：{browser_visible? "会弹出窗口让你看到自动化过程" : "后台运行、不显示窗口"} > - 会自动勾选「笔记含 AI 合成内容」声明：{mark_ai_generated? "是" : "否"} > - 原创声明：{mark_original?"勾选":"不勾选"}　可见范围：{visibility} > - 发布 IP：{proxy_rotate? "每篇自动换 IP（防多号关联）" : "本机直连不换 IP"}

**首次发布时一定要主动点明这两条**（哪怕用户没问）： 1. **默认会弹出浏览器窗口**显示整个自动化过程（方便你看着它操作、有异常能发现）。不想看、想让它后台静默跑，跟我说一声"发布别显示浏览器"即可。 2. **默认会勾选「含 AI 合成内容」声明**（小红书合规要求）。如不需要可让我关掉。

用户想改任何一项发布设置，用自然语言说，我帮你落库（**改一次长期生效**，下次不用再说）：

| 用户说 | 我执行 | |---|---| | 「发布别显示浏览器 / 后台跑」 | `config set browser_visible false` | | 「发布要显示浏览器」（默认就是） | `config set browser_visible true` | | 「别标 AI 内容了」 | `config set publish_is_ai_generated false` | | 「勾上原创声明」 | `config set publish_is_original true` | | 「设成仅自己可见 / 粉丝可见」 | `config set publish_visibility <可见范围>` | | 发布时间 | 在**飞书记录**里改「发布时间」字段，不在这里 |

> 改完设置可以再跑一次 `--dry-run` 让用户看新设置生效了，再正式发。

---

确认后发布

预览摆给用户后，给个编号菜单让他拍板（发布是对外动作，必须用户点头）：

确认一下，{count} 篇就这么发？
1. 就这么发（推荐）
2. 改下设置再发 —— 比如别显示浏览器 / 改可见范围 / 别标 AI 内容
3. 先不发，我再想想
回数字就行，也可以直接说。

选 1（或用户直接说「发吧/发出去」）才执行：

redbeacon publish --account-id {ID}

这是**前台阻塞**命令：它会从飞书表拉所有「通过」记录，逐条下载图片、用浏览器自动化发布，并把成功的记录在飞书里回写成「已发布」。记录里若带了定时字段，会提交为定时发布。

按返回讲给用户：

• `{"ok":true,"published":N}`：
• **N > 0** → ✓ 成功发布/提交了 N 篇。可去小红书或飞书表（状态已变「已发布」）核对。
• **N == 0** → 没东西可发。最可能两种原因，帮用户判断：

1. 飞书表里**还没有标「通过」**的记录 → 先去飞书审核标通过。 2. 账号**掉线被跳过** → 回 `/redbeacon-login` 重登（这种情况通常也会收到飞书"已掉线请重登"提醒）。

• stderr `{"error":"发布需要先配置飞书审核表格…"}` → 该账号没绑飞书表，按 `next` 去 `/redbeacon-feishu`。
• 其它 `{"error":...}` → 把原因给用户（图片下载失败、小红书页面变动、风控等；部分会自动重试 3 次后才报）。

多账号一起发

redbeacon publish --all-accounts          # 依次发布所有已绑飞书表的账号
redbeacon publish --all-accounts --dry-run  # 先逐账号预览

> 多账号模式下账号**之间自动错峰**（间隔随机，基准 `publish_account_stagger` 秒）防关联；没配齐飞书表的账号自动跳过。返回 `{"ok":true,"published":总数,"results":[{account_id,published/error}]}`。仍**无后台定时**。

> **发布节奏可调**（`/redbeacon-config set` 或面板）：`publish_min_interval`/`publish_max_interval`（同账号连发间隔秒，默认 30–90）、`publish_account_stagger`（账号间错峰秒，默认 120）。号多、怕限流就调大。

> **飞书改稿后卡片会自动跟上**：若你在飞书里改了正文，且这篇是纯图文卡片，发布前 CLI 会按新正文**重渲卡片**（`publish_rerender_cards`，默认开）——不用手动重生成。AI 封面图不受影响、保持原样。

---

关于代理与定时（自动处理，简单说明即可）

• **代理（多账号防关联）**：若在 `/redbeacon-config` 配了代理**且开了 `proxy_auto_rotate`**，每次发布 CLI 会自动取新 IP →（开了测速则验一下）→ 用新 IP 重启会话再发，用完即废，让多个号不共用同一出口 IP。**没配代理或没开 auto_rotate 就直连发**，不报错。代理的获取/验证/开关都在 `/redbeacon-config`，本 skill 不管。多账号矩阵（尤其 10–20 个号以上）建议务必配上并开轮换。
• **定时**：是否定时由**飞书记录里的字段**决定，在飞书表里填；本地发布命令照此执行，不在 skill 里另设定时。**本工具没有后台调度**——定时是提交给小红书侧的定时发布，不是我们常驻在发。

---

场景对照（别越界）

| 用户想干的 | 去哪个 skill | |---|---| | 发布已通过内容 | **本 skill** | | 审稿 / 改标题正文标签 / 标「通过」 | 在飞书多维表格里做 | | 生成内容 | `/redbeacon-generate` | | 扫码登录 / 重登 | `/redbeacon-login` | | 绑飞书表 | `/redbeacon-feishu` | | 配代理 / 验证代理 | `/redbeacon-config` |

---

注意

• **只发飞书表里标了「通过」的记录**，数据源唯一就是飞书；本地不存在审核。注意区分两件事：**内容要不要发**＝用户在飞书标「通过」就是确认，别在本地再做内容审核；**发布前确认**＝过一遍发布设置（浏览器/AI标记/定时/IP 等属性），这一步要做，但它确认的是"怎么发"，不是"要不要发这篇"。
• 登录态是硬前提：掉线的账号会被**跳过**（不报错、published 不计它），所以发布前 `verify` 一下最稳。
• 全程手动触发、前台阻塞，**无常驻服务、无后台自动发**；别向用户承诺"放着它自己定时发"。
• 命令成功走 stdout JSON、失败走 stderr `{"error","next"}`；把 error 给用户看，按 next 自愈，别静默吞。