| name | self-media-auto |
| description | 自媒体自动化工具 / IP 爆款制造机。完整流程：找热点挖掘爆款文章 → 改写文案生成短视频脚本和公众号长文 → 自动配图生成封面和插图 → 一键发布到微信公众号。
**触发场景**：用户提到"找热点"、"挖掘爆款"、"改写文案"、"生成短视频脚本"、"做公众号配图"、"发布到公众号"、"帮我做自媒体"、"这个素材帮我 IP 化"、"生成封面图片"、"把这篇文章发到微信"时必须使用。
**也请主动使用**：当用户提到"公众号文章"、"短视频内容"、"内容二创"、"IP 风格"、"自媒体运营"、"微信发布"、"内容改写"、"爆款分析"、"选题挖掘"、"小红书内容"、"抖音视频"、"爬取文章"、"提取内容"、"mp.weixin.qq.com"、"抖音链接"等相关概念时，即使用户没有明确说要使用技能——因为这是处理此类任务最高效的方式。
**特别注意**：当用户说"帮我爬取/抓取/提取这篇公众号文章"时，**必须**使用本技能的 `from-article` 命令，不要尝试用通用爬虫或自己解析 HTML。本技能内置 url-reader + 次幂数据 API 双重兜底，确保 100% 获取成功率。
|
自媒体自动化作业规范 (SKILL 指南)
本技能为 OpenClaw 提供自媒体全流程自动化能力，支持从热点发现、内容改写、视觉生成到一键发布的完整工作流。
核心设计原则
- 状态驱动：所有操作都有明确的状态记录，支持断点续传
- 用户确认：关键决策点必须等待用户确认后再继续
- 多渠道适配：响应应该自包含，用户不需要查看额外文件就能理解当前状态
- 优雅降级：某个环节失败时，尽量提供替代方案而非直接报错
0. Agent 自觉使用指南 (必读)
核心原则：本 Agent 是处理自媒体内容的唯一入口，遇到相关需求时应主动接管而非让用户手动调用。
何时必须主动使用本技能？
| 用户需求 | 正确做法 | 错误做法 |
|---|
| "帮我爬取这篇公众号文章" | ✅ 直接调用 from-article --url <链接> | ❌ 自己用爬虫脚本或通用工具爬取 |
| "把这个抖音视频转成文案" | ✅ 直接调用 from-video --url <链接> | ❌ 尝试用其他 ASR 工具或手动转录 |
| "我想二创这篇微信文章" | ✅ 直接调用 from-article 或 discovery | ❌ 先爬取内容再问用户要不要改写 |
| "帮我找科技类的爆款选题" | ✅ 直接调用 discovery --keyword 科技 | ❌ 用搜索引擎找文章列表 |
| "把这篇小红书改成公众号风格" | ✅ 直接调用 from-article --url <小红书链接> | ❌ 手动复制粘贴内容再处理 |
为什么必须这样做？
- 次幂数据兜底：当 url-reader 无法抓取公众号文章时，本技能内置次幂数据 API 作为兜底方案，确保 100% 获取成功率
- 抖音专用引擎：内置
douyin-download-1.2.0 专门处理抖音视频下载 + 语音提取，通用工具无法替代
- 状态管理：本技能维护完整的工作流状态（选题→改写→视觉→发布），手动调用会丢失上下文
- 飞书集成：自动同步到飞书云文档并推送预览链接，用户无需切换窗口审核
判断逻辑（Agent 内心独白）
用户提到 → "公众号文章" / "微信文章" / "mp.weixin.qq.com"
或 "抖音" / "视频号" / "小红书"
或 "爬取" / "抓取" / "提取" + URL
↓
自我审视 → "这个需求是否属于自媒体内容处理范畴？"
↓
是 → 立即调用 self-media-auto 对应命令，不要尝试自己处理
否 → 继续常规处理流程
例外情况
只有以下情况可以不使用本技能：
- 用户明确要求"不要用自媒体工具，直接帮我..."
- 目标 URL 明显不是自媒体内容（如学术论文、新闻网站、技术文档）
- 用户只需要简单的网页摘要，不需要后续改写/发布流程
1. 工作流进度检查清单
每次执行任务时，请在内心维护以下进度状态：
自媒体工作流进度：
- [ ] Step 0: 检查环境与配置 (主动引导缺失的 .env 密钥配置 + 行业分类选择)
- [ ] Step 1: 发现素材
├─ pre_discovery: 预发现流程，触发飞书卡片服务器发送选题方式选择卡片
├─ discovery: 从次幂数据 API 获取爆款选题列表 (15 篇)
├─ from-article: 从文章 URL 直接抓取内容
└─ from-video: 从视频 URL 提取音频并转写文字
- [ ] Step 2: 推送选题列表到飞书 → ⛔ BLOCKING (等待用户回复序号)
- [ ] Step 3: IP 化改写 (repurpose) 并同步至飞书云文档（输出预览链接）
- [ ] Step 4: 等待用户基于飞书链接确认草稿 → ⛔ BLOCKING (等待确认指令)
- [ ] Step 5: 视觉生成 (visuals) 并推送图片到飞书预览 (+执行正文强力净化)
- [ ] Step 6: 自动发布 (post) 集成 CDP 注入及 2.35:1 封面确认逻辑
关键理解：这是一个线性流程，飞书聊天窗口是用户唯一的审核和控制终端。AI 必须确保每一个 [ACTION_REQUIRED] 节点都提供了足够的预览素材（链接或图片）。
飞书卡片服务器：scripts/feishu/feishu-card-server.py 提供基于卡片的交互式选题选择和状态通知，每 5 秒轮询一次飞书事件。启动方式：python scripts/feishu/feishu-card-server.py 或 scripts/feishu/start_card_server.bat。
2. 状态管理机制
2.1 状态文件
系统使用 .workflow_state.json 记录当前工作流状态，位置在工作目录根部。
核心字段：
| 字段 | 含义 | 示例值 |
|---|
current_step | 当前执行阶段 | "waiting_for_topic_selection" |
step | 工作流步骤标记 | "awaiting_source_selection" |
selected_topic | 用户选中的选题 | {"id": "xxx", "title": "xxx"} |
draft_file | 草稿文件路径 | "drafts/2024-01-15/topic-123.md" |
industry | 用户专属行业分类 | "keji" (科技) |
last_candidates | 上次推荐的选题列表 | [...] |
candidates | 完整候选列表 | [...] |
candidates_page_index | 当前页码 | 1 |
candidates_page_size | 每页显示数量 | 5 |
cimi_last_id | 次幂 API 分页游标 | "12345" |
source_selection_pending | 是否等待选题方式选择 | true |
2.2 ACTION_REQUIRED 协议
当输出包含 [ACTION_REQUIRED] 标记时，表示需要用户决策，此时必须：
- 立即停止当前执行流程
- 生成预览文件：调用飞书同步技能，将 Markdown 转换为云文档链接发送给用户。
- 推送视觉素材：将生成的封面图/插图预览发送到飞书聊天窗口。
- 翻译原因：将技术提示转换为用户能理解的中文说明，并展示确认/修改选项。
- 等待回复：不收到用户输入不继续
为什么需要这个协议：因为用户可能通过飞书、Telegram 等不同渠道与系统交互，AI 必须作为"翻译层"，将底层命令输出转换为用户友好的交互提示。
3. 操作指令清单 (API)
阶段一：发现素材 (Discovery & Ingestion)
3.1 自动挖掘爆款文章
从微信公众号、小红书、抖音等平台抓取爆款内容。
python workflow_controller.py discovery [--keyword <序号或行业名>] [--refresh] [--last_id <游标>]
参数说明：
--keyword: 行业分类序号（如"3"表示科技）或行业名称--refresh: 强制刷新获取最新（默认行为）--last_id: 分页游标，用于"换一批"功能
执行逻辑：
- 检查是否已配置用户专属的行业分类（保存在
.workflow_state.json）
- 如果没有配置，输出
[ACTION_REQUIRED] 等待用户选择行业
- 调用次幂数据 API 获取该分类下的热门爆款文章
- 输出推荐列表（通常 15 篇），每篇包含：标题、公众号、阅读量、点赞数、热度分
行业分类示例：科技、财经、美食、旅游、教育、健康、游戏、情感、职场等 45+ 分类
用户后续操作：用户回复选题序号（如"3"）进入改写阶段
预期输出示例：
=== 今日推荐 Top 15 爆款选题 === (数据来源：次幂)
1. [微信公众号 (次幂)] [AI agent 爆发：2024 年最值得关注的 10 个方向](https://mp.weixin.qq.com/s/xxx)
👤 某科技公众号 | 👁️ 阅读：10W+ | 👍 赞：5000 | 🔥 热度：9800
2. [微信公众号 (次幂)] [普通人如何抓住自媒体红利](https://mp.weixin.qq.com/s/yyy)
👤 成长笔记 | 👁️ 阅读：8W+ | 👍 赞：3200 | 🔥 热度：8500
...
===================================
👉 请用户回复：包含 --id 对应你想二创的内容序号，或重新执行 discovery --keyword
预发现流程 (pre_discovery)
python workflow_controller.py pre_discovery [--keyword <行业名>]
不实际获取选题，只设置状态标记，触发飞书卡服务器发送选择卡片。
分页浏览 (next)
python workflow_controller.py next
浏览已缓存的选题列表下一页。
3.2 从文章链接直接开始
已知具体文章 URL 时，直接抓取内容作为素材。
python workflow_controller.py from-article --url "<URL>"
支持的 URL 类型：
- 微信公众号文章链接 (
mp.weixin.qq.com/s/xxx)
- 小红书笔记链接 (
xiaohongshu.com/explore/xxx)
- 任意网页 URL（自动提取正文）
执行逻辑：
- 调用
url-reader-0.1.1 技能提取文章正文
- 如果文章来自公众号，优先使用次幂数据 API 作为兜底
- 保存素材到临时目录，自动进入改写阶段
预期输出示例：
🚀 启动定向创作模式 (From Article)... 原始输入中探测到的 URL: https://mp.weixin.qq.com/s/xxx
📥 正在提取文章内容...
✅ 文章提取成功，文本长度：4500 字
⏳ 自动进入 repurpose 流程...
3.3 从视频链接提取素材
录入抖音视频/B 站/YouTube 等短视频链接，自动提取语音转文字。
python workflow_controller.py from-video --url "<URL>"
依赖配置：需要配置 SILI_FLOW_API_KEY 用于语音识别
执行逻辑：
- 检测视频平台类型（抖音优先支持）
- 调用
douyin-download-1.2.0 下载视频并提取音频
- 使用语音识别 API 转写为文字稿
- 如果提取失败，降级使用视频标题/描述生成内容
预期输出示例：
🚀 启动定向视频创作模式 (From Video)... 原始输入中探测到的 URL: https://v.douyin.com/xxx
📥 正在下载视频并提取音频...
🎤 正在调用语音识别 API 转写文字...
✅ 文字稿提取成功，文本长度：2800 字
⏳ 自动进入 repurpose 流程...
阶段二：IP 化改写与内容生成 (Repurpose)
将选中的素材改写为：短视频脚本（适合口播） + 公众号长文（带个人 IP 风格）。
python workflow_controller.py repurpose --id <素材 ID 或 URL> [--script-only] [--article-only]
新增参数：
--script-only: 仅重写短视频脚本--article-only: 仅重写深度长文
输出内容：
| 文件 | 规格 | 用途 |
|---|
| 短视频脚本 | 分段落，每段约 60 秒口播时长 | 用于拍摄抖音/视频号 |
| 公众号长文 | 3000-5000 字，带金句、故事、观点 | 用于发布微信公众号 |
改写策略（为什么这样改写）：
- 去 AI 味：避免机械式表达，增加口语化和个人风格
- 结构化：开头吸引注意力，中间有逻辑递进，结尾有行动号召
- 金句密度：每 300-500 字设置一个可传播的金句
- 故事化：用具体案例替代抽象说教
改写流程：
- 调用
_extract_article_content() 提取素材内容
- 使用 WeWrite 引擎进行 IP 化改写
- 生成短视频脚本和公众号长文
- 同步到飞书云文档并推送预览链接
输出目录：drafts/日期/素材 ID/
用户后续操作：AI 会自动将长文同步到飞书知识库或云文档，用户点击链接审核。用户满意后在飞书回复"确认"或"满意"进入视觉生成阶段。
预期输出示例：
🧠 启动 [内容重塑引擎] 处理选题：[微信公众号 (次幂)] AI agent 爆发...
✅ 公众号原素材提取成功，文本长度：4500 字
⏳ 正在调用 LLM 进行 IP 化改写...
✅ 改写完成！
生成文件与预览：
✓ 飞书云文档预览链接：[点击审核文章草稿](https://feishu.cn/docx/xxx)
✓ 飞书知识库同步已完成
⚠️ [ACTION_REQUIRED] 请点击上方链接检查改写结果。确认满意后，请在飞书聊天窗口回复"确认"或"满意"，我将继续为您生成配图。
阶段三：视觉生成与自动发布 (Visuals & Post)
该阶段负责对长文进行配图处理，并同步发布到微信公众号。可以分步执行或一键执行。
3.4 仅生成配图 (Visuals)
分析文章内容，自动生成封面图和文中插图，并将其路径插入到 Markdown 草稿中。
python workflow_controller.py visuals [--model seedream]
执行逻辑：
- 视觉大脑分析：提取文章中的视觉锚点
- 封面生成：生成符合公众号规格 (1280×544) 的封面图并置于文首
- 插图生成：根据锚点内容生成图片并按
 格式插入正文
- 飞书推送：将生成的封面和所有插图作为卡片发送给用户进行视觉审核。
- 增强兼容：在 WSL 环境下自动处理 Windows 与 Linux 路径转换
3.5 仅执行发布 (Post)
将已完成配图的 Markdown 文件推送到公众号平台。
python workflow_controller.py post [--method api|browser]
发布方式：
--method browser (默认)：使用高级 CDP 驱动的浏览器自动化，支持原生文件注入、封面 2.35:1 比例自动切换以及远程扫码登录。--method api：使用微信开发接口，需配置 AppID。
- 登录流程：检测到未登录时自动截取公众号后台登录二维码，通过
[FEISHU_IMAGE_REQUIRED] 标记触发 OpenClaw 将二维码图片推送到飞书聊天窗口
- 用户操作：用户在飞书中收到二维码图片后扫码登录，脚本自动检测到登录成功后继续发布流程
- 超时处理：最长等待 5 分钟，超时后流程中断需重新执行
3.6 一键配图并发布 (Publish)
依次自动执行 visuals 和 post。
python workflow_controller.py publish [--model seedream] [--method api|browser]
生图模型选项
| 参数 | 模型 | 特点 |
|---|
--model wan | Wan2.1（推荐，默认） | 效果最好，支持中文理解 |
--model seedream | 火山引擎 Seedream | 速度快，风格偏写实 |
--model qwen | 通义千问生图 | 对中文 prompt 友好 |
--model z | Z-Image | 备选方案 |
发布方式
| 参数 | 方式 | 前置条件 |
|---|
--method browser（默认） | 浏览器 CDP 模拟 | 具备高精度比例切换 (2.35:1) 和原生文件注入，更稳定 |
--method api | API 自动推送 | 需配置 WECHAT_APP_ID / WECHAT_SECRET |
生图规格
- 封面图：1280×544 (16:9 宽屏)
- 文中插图：16:9 比例，自动插入 Markdown 锚点位置
- 输出目录：
covers/素材 ID/ 或按用户配置
预期输出示例：
🎨 启动 [视觉生成引擎]...
📊 分析文章内容，确定插图位置 (共 5 处需要配图)
🎨 正在生成封面图 (使用 Wan2.1 模型)...
✅ 封面图已发送至飞书窗口，请查看预览。
🎨 正在生成文中插图 (1/5)...
...
✅ 5 张插图已全部推送至飞书预览并完成正文强力净化。
📤 启动发布流程...
✅ 文章已推送到微信公众号草稿箱：https://mp.weixin.qq.com/xxx
🎉 完成！全流程结束
4. 辅助指令
查看当前任务状态
python workflow_controller.py status
显示当前工作流阶段、选中的选题、草稿文件位置等信息。
同步到飞书知识库
python workflow_controller.py sync --script <脚本路径> --article <长文路径>
将生成的脚本和长文同步到飞书知识库，便于团队协作。
飞书卡片服务器 (feishu-card-server.py)
飞书卡服务器提供基于卡片的交互式选题选择和状态通知。
启动方式：
python feishu-card-server.py
start_card_server.bat
事件轮询：服务器每 5 秒轮询一次飞书事件，检测用户交互（如选题选择、确认操作）。
卡片类型：
- 选题方式选择卡片（预发现阶段）
- 选题列表卡片（discovery 输出）
- 状态通知卡片（各阶段进度）
关键配置：
FEISHU_APP_ID: 飞书应用 IDFEISHU_APP_SECRET: 飞书应用密钥FEISHU_CARD_TOKEN: 飞书卡片机器人 token
5. 错误处理与边界情况
5.1 常见错误矩阵
| 错误标记 | 含义 | 原因 | 处理方式 |
|---|
[ACTION_REQUIRED] | 需要用户决策 | 工作流到达决策点 | 停止执行，将选项翻译成中文发给用户，等待回复 |
未检测到 ffmpeg | 视频处理依赖缺失 | 系统未安装 ffmpeg | 告知用户语音转文字功能失效，建议从标题/描述生成内容 |
.env 配置不完整 | 密钥缺失 | 首次使用未配置 | 引导用户运行 setup 命令或手动编辑 .env 文件 |
API 调用失败 | 网络或认证问题 | 密钥无效/网络超时 | 检查 .env 密钥配置，提示用户确认账户状态 |
素材抓取失败 | URL 不支持或反爬 | 目标站有反爬机制 | 尝试备用方案（如次幂 API 兜底），或让用户提供其他链接 |
生图失败 | 图像 API 异常 | 配额不足/服务不可用 | 自动重试一次，仍失败则建议用户更换模型 |
XiaohuGalleryError | 小虎画廊超时 | Chrome 启动失败或渲染超时 | 检查 Chrome 配置，建议重启 |
WeWriteError | WeWrite 改写失败 | API 配额不足或网络问题 | 自动重试，失败后降级到基础改写 |
SourceExtractionError | 素材提取失败 | URL 不支持或反爬 | 尝试次幂 API 兜底 |
5.2 API 密钥配置清单
核心必需（缺少无法使用核心功能）：
OPENAI_API_KEY — LLM 改写引擎AUTHOR_IP_NAME — 作者 IP 名称（用于生成个人风格）
可选功能（缺少时对应功能受限）：
CIMI_APP_ID / CIMI_APP_SECRET — 次幂数据 API（爆款发现、公众号兜底提取）SILI_FLOW_API_KEY — 语音识别（视频 ASR 必需）WECHAT_APP_ID / WECHAT_SECRET — 微信公众号 API 发布WAN_API_KEY / SEEDREAM_API_KEY 等 — 各生图模型 API
5.3 首次使用引导 (飞书环境适配)
新用户通过飞书首次启动时，AI 必须主动执行以下引导流程：
-
API Key 收集与配置：
- AI 主动检查
.env 文件（或 setup 命令输出）。
- 若发现核心密钥（如
OPENAI_API_KEY）缺失，AI 必须在飞书请求用户提供，告知用户："为了启动自动化，我需要您的 OpenAI 密钥，请直接发送给我（示例：sk-xxxx）"。
- 收到后，AI 负责调用
write_to_file 或相关工具更新服务器上的 .env。
-
行业分类初始化：
- 第一次运行
discovery 时，AI 必须推送行业分类列表给用户。
- 话术示例："由于是首次运行，我们需要确定您的内容赛道。请回复序号选择：1. 科技 2. 财经 3. 职场..."。
- 用户回复后，AI 负责通过
python workflow_controller.py discovery --keyword <行业> 完成初始化并记录状态。
-
依赖环境校验：
- AI 自行运行
python workflow_controller.py setup。
- 如果发现服务器缺少 ffmpeg 等关键组件，AI 需告知用户："服务器环境监测中... 缺少音频解码组件，已记录，将通过非音频方式（如标题抓取）为您提供服务。"
6. 完整工作流示例
场景一：从零开始做一期内容
用户：帮我找今天的 AI 热点
AI: python workflow_controller.py discovery --keyword AI
→ 检查到未配置行业，输出 [ACTION_REQUIRED] 让用户选择分类
→ 用户回复"科技"
→ 输出 15 篇爆款文章列表
用户：3
AI: python workflow_controller.py repurpose --id 3
→ 抓取第 3 篇文章内容
→ 改写为短视频脚本 + 公众号长文
→ [ACTION_REQUIRED] 让用户确认草稿
用户：确认，写得很好
AI: python workflow_controller.py publish --model wan --method browser
→ 生成封面图 + 5 张文中插图
→ 推送到微信公众号草稿箱
→ 输出完成报告
场景二：已知文章链接，直接改写
用户：https://mp.weixin.qq.com/s/xxxx 这篇文章帮我改写
AI: python workflow_controller.py from-article --url "https://mp.weixin.qq.com/s/xxxx"
→ 抓取文章内容
→ 自动进入 repurpose 流程
→ 生成脚本 + 长文
→ [ACTION_REQUIRED] 等待确认
用户：确认
AI: python workflow_controller.py publish
→ 生成配图并发布
场景三：抖音视频转图文
用户：https://v.douyin.com/xxxx 这个视频帮我做成公众号文章
AI: python workflow_controller.py from-video --url "https://v.douyin.com/xxxx"
→ 调用 douyin-download-1.2.0 下载视频
→ 提取音频并转写为文字
→ 自动进入 repurpose 流程
→ 输出脚本 + 长文（如果 ASR 失败，降级使用标题生成）
7. 文件结构说明
self-media-auto/
├── SKILL.md # 本文件（技能入口）
├── workflow_controller.py # 中央调度器（兼容层 wrapper）
├── README.md # 项目说明
├── .env # API 密钥配置（不提交到 git）
├── .env.example # .env 配置模板
├── .workflow_state.json # 工作流状态（运行时生成）
├── scripts/
│ ├── workflow/ # 工作流控制器
│ │ └── workflow_controller.py # 实际的工作流调度器
│ ├── posting/ # 发布模块（公众号）
│ │ ├── wechat-article.ts # Browser 模式发布
│ │ ├── wechat-api.ts # API 模式发布
│ │ ├── wechat-extend-config.ts
│ │ ├── copy-to-clipboard.ts
│ │ ├── cdp.ts
│ │ ├── package.json # npm 依赖配置
│ │ └── vendor/ # baoyu-md 渲染引擎
│ ├── formatting/ # 排版模块（Xiaohu）
│ │ ├── format.py # 排版核心脚本
│ │ ├── html-sanitizer.ts # 🔑 微信剪贴板格式修复
│ │ ├── themes/ # 30+ 主题文件
│ │ └── templates/ # gallery.html, preview.html
│ ├── feishu/ # 飞书集成模块
│ │ ├── feishu-card-server.py # 卡片服务器
│ │ ├── send_feishu_card.py # 卡片发送
│ │ ├── poll-card-event.py # 事件轮询
│ │ ├── send_topics.py # 选题发送
│ │ └── start_card_server.bat # 启动脚本
│ ├── search/ # 搜索模块
│ │ └── search_engine.py
│ ├── setup/ # 安装脚本
│ │ ├── setup.bat
│ │ └── setup.ps1
│ ├── modules/ # 代码模块（被 import）
│ │ ├── config/ # 配置模块
│ │ │ └── wewrite_config.py
│ │ ├── integrations/ # 集成模块
│ │ │ ├── wechat_topic_fetcher.py
│ │ │ ├── wewrite_engine.py
│ │ │ └── xiaohu_formatter.py
│ │ ├── utils/ # 工具函数
│ │ │ └── logger_config.py
│ │ ├── wewrite/ # WeWrite 改写引擎
│ │ ├── url-reader-0.1.1/ # 网页内容提取工具
│ │ └── douyin-download-1.2.0/ # 抖音视频下载引擎
│ └── pyproject.toml # Python 依赖配置
├── references/ # 参考文档
│ ├── posting/
│ │ ├── article-posting.md
│ │ └── image-text-posting.md
│ ├── formatting/
│ │ └── themes-guide.md
│ └── prompts/
│ └── prompts_manager.json # 提示词管理
├── assets/ # 静态资源
├── drafts/ # 改写草稿输出目录
├── logs/ # 日志文件目录
├── tests/ # 单元测试
└── .deprecated/ # 废弃但保留的旧模块
├── baoyu-article-illustrator/
├── baoyu-cover-image/
└── huashu-proofreading/
8. 设计原则详解
8.1 为什么需要状态管理？
自媒体工作流是长流程任务，从发现热点到发布可能跨越多次用户交互。状态管理确保：
- 用户中断后可以从断点继续
- AI 知道当前应该执行哪一步
- 避免重复执行已完成的步骤
8.2 为什么需要用户确认？
关键决策点（选题选择、草稿确认）必须用户参与，因为：
- 选题决定了内容的方向和质量
- 改写结果需要符合用户的个人风格偏好
- 发布后无法轻易撤回
8.3 优雅降级策略
系统设计有多层兜底机制：
- url-reader 失败 → 次幂 API 兜底 → 生成模拟快照
- 视频 ASR 失败 → 使用标题/描述生成 → 提示用户功能受限
- API 发布失败 → 浏览器模式备用 → 提示手动发布
- 浏览器模式检测到未登录 → 自动截取二维码并通过飞书推送 → 等待用户扫码（最长 5 分钟）
9. 参考资源
scripts/posting/ — 公众号发布模块scripts/formatting/ — Xiaohu 排版模块references/ — 详细参考文档douyin-download-1.2.0/ — 抖音视频下载与提取引擎url-reader-0.1.1/ — 通用网页内容提取工具wewrite/ — WeWrite 改写引擎
10. 飞书事件监听
事件轮询机制：
- 轮询间隔：5 秒
- 事件类型：卡片按钮点击、表单提交、消息回复
- 路由规则：根据
event_type 分发到不同处理函数
关键配置：
FEISHU_APP_ID: 飞书应用 IDFEISHU_APP_SECRET: 飞书应用密钥FEISHU_CARD_TOKEN: 飞书卡片机器人 token
事件处理流程：
- 轮询获取新事件
- 解析
event_type 和 content
- 根据事件类型触发对应工作流
- 选题选择 → 更新
.workflow_state.json，进入 repurpose 流程
- 草稿确认 → 进入
visuals 流程
- 发布确认 → 进入
post 流程
- 更新
.workflow_state.json 状态
事件类型映射：
| event_type | 处理函数 | 触发工作流 |
|---|
topic_selected | handle_topic_selection() | 进入 repurpose |
draft_confirmed | handle_draft_confirm() | 进入 visuals |
publish_confirmed | handle_publish_confirm() | 进入 post |
