bili-sunflower-publish

面向哔哩哔哩的统一发布流程：HTML/Markdown 文件 → 编辑器 → 发布。直接调用 window.editor API，不依赖系统剪贴板。

支持两类发布目标：

• 专栏（Article）：发布于 member.bilibili.com 的长文形式文章
• 小站（Tribee）：发布于 bilibili.com/bubble 的社区帖文

前置条件

• 浏览器工具，需配置 openclaw profile（由 Playwright 管理的浏览器实例）

输入

• 内容文件路径（正文）—— 支持 .html 与 .md / .markdown 文件
• 目标类型：article（专栏）或 tribee（小站）—— 根据用户意图推断
• 标题（可选 — 见第二阶段）
• 若为目标为小站：需提供 小站名称或 ID（必填）
• 若为目标为小站：可选提供 分区（分类，用户可在发布时指定或手动选择）

第一阶段：导航与登录检查

专栏模式

跳转至 https://member.bilibili.com/york/read-editor 并截取快照。

• 已登录：编辑器加载完成，标题输入框显示提示文字 "请输入标题（建议30字以内）"
• 未登录：跳转至登录页

小站模式

发布页面 URL：https://www.bilibili.com/bubble/publish?tribee_id={id}&tribee_name={name}

发布 URL 中 tribee_id 与 tribee_name 均为必需参数。缺失参数时按如下方式解析：

成功跳转至发布 URL 后：

• 已登录且为该小站成员：编辑器加载完成，显示标题与正文编辑区域
• 未登录：跳转至登录页
• 非该小站成员：可能显示加入提示 —— 需明确告知用户先加入小站

若未登录，立即中止并提示用户在 openclaw 浏览器 profile 中手动完成登录，之后重试。

第二阶段：预处理与标题处理

根据输入文件类型执行对应预处理脚本。脚本负责 H1 标题提取、标题层级提升、图片内联（inline），以及（对 HTML）空白字符清理。

2a. 对 .html 文件

python3 {SKILL_DIR}/scripts/preprocess_html.py  [output-dir]

输出（标准输出，共 3 行）：

title=<提取出的标题>
path=<处理后 HTML 文件路径>
bytes=

从输出中解析 title 与 path。位于 path 的已处理 HTML 文件即可用于第三阶段注入。

2b. 对 .md / .markdown 文件

python3 {SKILL_DIR}/scripts/preprocess_md.py  [output-dir]

输出（标准输出，共 3 行）：

title=<提取出的标题>
path=<处理后 Markdown 文件路径>
bytes=

从输出中解析 title 与 path。位于 path 的已处理 Markdown 文件即可用于第三阶段注入。

2c. 标题校验

若用户显式提供了标题，则优先采用该标题，而非脚本提取结果。

确定最终标题后，进行如下校验：

• 标题长度超过 50 字符：生成 2–3 个精简版备选标题，供用户选择
• 标题明显无意义（例如 output、untitled、temp，或明显与正文内容无关）：读取正文前几百字符，生成 2–3 个标题建议，供用户选择

严禁静默采用低质量标题。必须等待用户选定后方可继续后续流程。

输入标题：点击标题输入框并键入。

第三阶段：插入文章正文

两种编辑器共享同一富文本编辑组件（window.editor）。

使用第二阶段产出的预处理内容注入编辑器。

重要 — JS 字符串转义要求：

内容（HTML 或 Markdown）常含破坏 JS 语法的字符（反引号、引号、换行符、反斜杠等）。你 必须 使用下方方法安全构造 JS 执行代码。禁止 将原始内容直接拼入 JS 变量赋值语句中。

如何构造 evaluate JS 代码

请严格按以下步骤操作，适用于 HTML 与 Markdown 注入：

1. 从第二阶段输出中获取已处理文件路径（path=...）
2. 运行以下命令，生成 JSON 转义后的文件内容字符串：

python3 -c "import json,sys; print(json.dumps(open(sys.argv[1]).read()))" 

该命令输出一个双引号包裹的 JSON 字符串，其中所有特殊字符（换行、引号、反斜杠等）均已转义，例如："line1nline2"quoted""。

3. 将上述 stdout 输出捕获为 ESCAPED_JSON_STRING
4. 将 ESCAPED_JSON_STRING 嵌入下述模板（见 3a-HTML / 3a-MD）构建完整 JS 代码。注意：该字符串本身已含双引号，因此应直接置于 JSON.parse( 后，无需额外添加引号。

3a-HTML：已处理 HTML → ClipboardEvent 派发

(function () {
  const html = JSON.parse(ESCAPED_JSON_STRING);
  const clipboardData = new DataTransfer();
  clipboardData.setData('text/html', html);
  clipboardData.setData('text/plain', '');

  const pasteEvent = new ClipboardEvent('paste', {
    bubbles: true,
    cancelable: true,
    clipboardData,
  });

  window.editor.view.dom.dispatchEvent(pasteEvent);
})();

注意： 若 HTML 内容较大（>50KB），需分块依次粘贴。

3a-MD：已处理 Markdown → editor importMarkdown 命令

(function () {
  const markdown = JSON.parse(ESCAPED_JSON_STRING);
  window.editor.commands.importMarkdown({
    content: markdown,
    replaceContent: true,
  });
})();

3b. 内容校验

执行 JS 以确认内容已正确插入：

(function () {
  const e = window.editor.view.dom;
  return { chars: e.textContent.length, first80: e.textContent.substring(0, 80) };
})();

预期结果：chars > 100，且 first80 与文章开头一致。

第四阶段：发布

专栏模式

编辑器底部存在“发布设置”面板（通常默认可见），其默认配置可直接使用：

• 可见范围：所有人可见（默认）
• 封面：从正文自动提取（默认）
• 评论：开启（默认）

若用户有特定发布偏好，应在发布前调整：

操作步骤：

1. 滚动至底部，确认“发布设置”面板可见；若已折叠，点击“发布设置”按钮展开
2. 应用上表中用户指定的各项设置
3. 点击右下角 “发布” 按钮（位于“保存为草稿”旁）
4. 若弹出确认对话框，确认操作
5. 验证发布是否成功（URL 变化或出现成功提示）

小站模式

正文输入完成后，底部栏自动出现，默认配置可直接使用：

• 分区：未选择（部分小站可能强制要求）
• 同步至动态：开启（默认）

若用户有特定偏好，应在发布前调整：

分区自动选择（仅小站）

当用户 未指定 分区时：

1. 点击“选择分区”下拉菜单，展开可用选项列表
2. 从下拉菜单中读取所有分区名称（通过快照）
3. 基于 文章标题 + 正文前约 200 字符，选择最相关的分区：
   • 依据关键词/主题相似性匹配（例如教程类内容 → “经验分享”，提问类 → “提问求助”）
   • 若无明显匹配项，则选择最通用/兜底的分区
   • 若小站仅有 1–2 个泛用选项，直接选取最优者，无需过度纠结
4. 点击所选分区
5. 无需 向用户确认 —— 直接选定并继续（用户可随时重新发布更正）

若用户 已指定 分区，则直接采用（跳过自动选择）。

操作步骤：

1. 处理分区（按用户指定或上述自动逻辑）
2. 应用其他用户指定的设置
3. 点击右下角 “发布” 按钮（蓝色，右下角）
4. 验证发布是否成功

执行方式

默认行为：在主会话中顺序执行第一至第四阶段（支持用户交互，如登录、标题选择等）。

仅当用户明确要求时，才交由子 agent 执行。