XHS Publisher

将飞书文档转换为小红书图文帖，全流程半自动化，用户收工直接发布。

工作流程（5步，每步与用户确认）

Step 1：读取飞书文档

• docx 链接：直接提取 doc_token，用飞书 SDK docx.document.rawContent 读取内容
• wiki 链接：先用 wiki.space.getNode 获取 obj_token，再读文档内容
• Wiki token 提取：https://xxx.feishu.cn/wiki/ABC123 → token = ABC123

// 飞书 SDK（在 ~/.openclaw/extensions/feishu/ 目录下运行）
const client = new Lark.Client({ appId: '...', appSecret: '...' });

// wiki → obj_token
const node = await client.wiki.space.getNode({ params: { token: wikiToken } });
const objToken = node.node.obj_token;

// 读取内容
const content = await client.docx.document.rawContent({
  path: { document_id: objToken }, params: { lang: 0 }
});

Step 2：润色成小红书风格（AI 改写）

将原文改写为小红书风格，与用户确认文案后再进行图片渲染。

改写原则：

• 长段落 → 拆成 2-3 行短句，每段加 emoji 开头
• 标题层级 → 🔥 小节标题 风格
• 列表 → 👉 要点一
• 代码块 → 保留原文，另做代码截图卡
• 表格 → 提炼关键信息转成对比句
• 超链接 → 去掉 URL，保留链接文字

图片分组建议（按内容长度）：

• 短文（\x3C1000字）：5-7 张
• 中等（1000-2500字）：7-10 张
• 长文（>2500字）：10-12 张，可分多篇发布

每个代码块额外生成 1 张代码截图卡（深色背景 + macOS 窗口样式）。

Step 3：生成 HTML 图片并渲染

在工作目录创建 cards/ 子目录，每张图一个 HTML 文件（命名按序号：01_xxx.html）。

图片规格：1242×1660px（3:4 小红书推荐比例）

渲染命令：

python3 ~/.openclaw/workspace/skills/xhs-publisher/scripts/render_images.py \
  \x3Ccards_dir> \x3Coutput_dir>

需要 Playwright：pip3 install playwright && playwright install chromium

设计风格参考：见 references/design-styles.md，默认使用「科技蓝·深空」风格。 内容卡模板参考：见 assets/templates/example_cover.html。

渲染完成后打开图片供用户确认效果再继续。

Step 4：生成正文摘要 + 标题

与用户确认以下内容再进入 Step 5：

1. 正文摘要（500-800字，小红书风格，含 emoji）
2. 标题备选（3 个，20字以内，带钩子）
3. 话题标签（8-10 个 #xxx 格式）

Step 5：上传到飞书文档

飞书 SDK 所在目录：~/.openclaw/extensions/feishu/（含 @larksuiteoapi/node-sdk）

上传脚本：

cd ~/.openclaw/extensions/feishu
node ~/.openclaw/workspace/skills/xhs-publisher/scripts/upload_to_feishu.cjs \
  \x3Coutput_dir> \x3Cdoc_title> [summary_md_file]

图片上传三步法（顺序不能错）：

1. 创建空图片块（documentBlockChildren.create，block_type: 27）
2. 用图片块 blockId 作为 parent_node 上传图片（⚠️ 不是 docId）
3. patch 图片块填入 file_token

// ⚠️ 关键：parent_node 用 imageBlockId，不是 docId
const insertRes = await client.docx.documentBlockChildren.create({...});
const imageBlockId = insertRes.data.children[0].block_id;  // 注意是 .data.children

const uploadRes = await client.drive.media.uploadAll({
  data: { parent_type: 'docx_image', parent_node: imageBlockId, ... }
});

await client.docx.documentBlock.patch({
  path: { document_id: docId, block_id: imageBlockId },
  data: { replace_image: { token: uploadRes.file_token } }
});

文字内容写入用 Markdown 转换法：

const convertRes = await client.docx.document.convert({
  data: { content_type: 'markdown', content: markdownText }
});
await client.docx.documentBlockDescendant.create({
  path: { document_id: docId, block_id: docId },
  data: {
    children_id: convertRes.data.first_level_block_ids,
    descendants: convertRes.data.blocks,
    index: -1
  }
});

完成后发送飞书文档链接给用户。

飞书 SDK 配置

SDK 位于 ~/.openclaw/extensions/feishu/，所有脚本在此目录运行：

const Lark = require('./node_modules/@larksuiteoapi/node-sdk');
const client = new Lark.Client({
  appId: 'cli_a9249001d9f8dcc9',
  appSecret: 'IcxmMHOYNVUGWsuI4Ikp2fjtouXEwDUf',
  domain: Lark.Domain.Feishu,
});

文档所有者 open_id：ou_966010364ecf08ba373bf29bf198a04a

常见问题