OddMeta文章生成技能 Article Generation Skill

> 本技能默认使用 oddmeta 品牌色作为示例。你可以在 references/ 目录下修改为自己的品牌色，或在 local/SKILL.local.md 中覆盖路径和个人设定。

一条龙：素材收集 → 写文章 → 排版 → 多平台内容 → 一键分发。

环境变量配置

本技能所使用到的环境变量在 local/.env 中配置。

支持的环境变量如下：

• OUTPUT_DIR：输出目录，用于放置收集到的素材、生成的文章、排版预览、封面图、微贴图轮播图等文件。
• ARCHIVE_DIR：存档目录，用于归档历史文档文件。
• BRAND_NAME：品牌名称，用于在生成的文章中显示品牌名称。
• BRAND_LOGO_DARK：品牌logo（深色），用于在生成的文章中显示品牌logo。
• BRAND_LOGO_LIGHT：品牌logo（浅色），用于在生成的文章中显示品牌logo。
• WECHAT_ID：微信公众号ID，用于发布文章。
• WECHAT_SLOGON：微信公众号标语，用于在文章中显示。
• WECHAT_APPID：微信公众号AppID，用于发布文章时的认证。
• WECHAT_APPSECRET：微信公众号AppSecret，用于发布文章时的认证。
• CNBLOGS_TOKEN：博客园Token，用于发布博客园文章时的认证。
• MD_FORMATTER_DIR：Markdown格式化工具目录，用于格式化Markdown文章。
• BAOYU_WECHAT_SKILL_DIR: 奥德元微信技能目录，用于发布文章。
• MD_TO_WECHAT_SCRIPT: Markdown文章转微信文章脚本，用于将Markdown文章转换为微信文章。

输出目录 OUTPUT_DIR 示例

[输出目录]/
├── drafts/
│   └── current.json          # 当前素材列表
├── [文章标题].md              # 产出的文章
├── [文章标题]_preview.html    # 排版预览
├── [文章标题]_cover.html      # 封面图
└── [主题]-chartlet.html       # 微贴图轮播图

存档目录 ARCHIVE_DIR 示例

[存档目录]/
├── 20260321/                  # 按日期归档（YYYYMMDD）
│   ├── Fish-Audio-S2-Tutorial-v2/    # 文章标题目录
│   │   ├── Fish-Audio-S2-Tutorial-v2.md
│   │   ├── Fish-Audio-S2-Tutorial-v2_preview.html
│   │   ├── Fish-Audio-S2-Tutorial-v2_cover.html
│   │   └── manifest.json
│   └── OpenClaw-Memory-Deep-Article/  # 另一篇文章
│       ├── OpenClaw-Memory-Deep-Article.md
│       ├── OpenClaw-Memory-Deep-Article_preview.html
│       └── manifest.json
└── 20260320/
    └── ...

触发词

素材收集（Path A）

内容生成（Path B）

文章阅读

排版与配图

分发

存档

博客园发布（独立工具）

不依赖 manifest，可直接发布 Markdown 文件到博客园。具体请参考：references/publishing_to_cnblogs.md

存档功能（独立工具）

将 OUTPUT_DIR 目录下的历史文档文件（.md, .html, .png, manifest.json）移动到 ARCHIVE_DIR 目录下，按日期归档。具体请参考：references/archive_outputs.md

两条输入路径

Path A：日常素材收集 → 出稿

边干活边记录 → 说"出稿" → 写文章 → 排版 → 封面图 → 朋友圈文案 → manifest

适用场景：日常和 cc 协作时，自动积累素材，攒够了一键出稿。

Path B：微信链接 → 多平台内容

微信链接 → 抓取文章 → 分析结构 → 生成微贴图/博客园/微博/视频 → manifest → 分发

适用场景：已有公众号文章，一键转为多平台内容并发布。

Path A 流程：素材收集 → 出稿

自动记录（默认开启）

cc 在对话中主动识别有料瞬间并自动记录，无需手动触发。

识别信号：

自动记录时：不打断对话，段落结尾标记 （✓ 素材+1）

手动记录

用户说"记一笔：xxx"或"素材+1：xxx"时记录。

current.json 格式

{
  "topic": "主题（可选，出稿时自动提取）",
  "materials": [
    {
      "time": "2026-01-30 14:30",
      "content": "素材内容",
      "type": "搞笑时刻",
      "context": "可选的上下文备注",
      "auto": true
    }
  ],
  "created": "2026-01-30"
}

出稿步骤

STEP 1: 读取素材**

1. 读取素材 — 读取输出目录下 drafts/current.json
2. 分析提炼 — 提炼主题和故事线

STEP 2: 确定写作框架

1. 判断内容类型 → 选择写作框架：

STEP 3: 写作

读取: `references/writing-guide.md`
读取: `playbook.md`（如果存在，按 confidence 分级执行）
读取: `history.yaml`（最近 3 篇的 dimensions + closing_type 字段）
读取: `references/exemplars/index.yaml`（如果存在）

1. 写文章 — 按对应框架写文章
2. 保存 — 保存 Markdown 文件，文件名格式为 {{date}}-{{title}}.md，{{title}} 为文章标题的拼音，保存到 OUTPUT_DIR 目录下。
3. 排版 — 调用排版工具生成 HTML 预览（oddmeta 主题）
4. 头图 + 配图 — 生成可下载的 HTML 文件（→ 读 references/cover_template.md）
• 竖版封面（可选）：用户说"做竖版封面"时，从已生成的公众号头图 HTML 转换 → 读 references/cover_vertical_spec.md
5. 朋友圈文案 — 生成朋友圈推广文案（→ 读 references/platform_copy.md）

STEP 4: 推广文案

1. manifest — 生成 manifest.json，供 /distribute 使用。wechat 部分必须包含：
• wechat.markdown：文章 Markdown 路径
• wechat.html：排版后的 _preview.html 路径
• wechat.cover_image：封面 PNG 路径（用户需先从浏览器下载）
• wechat.title：文章标题
• wechat.author：作者名（默认 曹操同学）
• wechat.digest：文章摘要（120 字内）
• wechat.images：配图 PNG 路径列表（如有）
2. 询问 — 是否存档并清空当前素材

排版命令

cd "$MD_FORMATTER_DIR"
python3 md2wechat.py [文章路径] --theme [主题]

> $MD_FORMATTER_DIR 需在 local/.env 或环境变量中配置。

推荐主题：default（oddmeta 品牌色，默认）、chinese（中国风）、apple（极简优雅）

推荐字号：medium（15px 默认）、large（16px 长文推荐）

oddmeta 主题说明：基于 chinese 主题，使用 oddmeta 品牌色（墨绿 #1A3328 + 鱼红 #C44536 + 宣纸底 #F2EDE3）

执行排版命令报错说明：请参考 references/running_python_script_guide.md

Path B 流程：微信链接 → 多平台内容

第 1 步：抓取文章

使用 Python 抓取脚本（微信有反爬验证，WebFetch 会被拦）：

python3 "${SKILL_DIR}/scripts/wechat_download.py" "<URL>" --json

超时 30 秒。失败则提示用户手动复制文章正文。

如果用户只是说"帮我读一下这篇公众号"（/read-gzh 触发），执行抓取后直接生成结构化总结，不进入后续内容生成流程。总结格式：

# 文章总结
## 基本信息（标题/作者/类型/配图数）
## 核心观点（3条）
## 关键信息
## 金句摘录
## 图片内容（下载并识别配图中的文字）
## 思考/迭代点

第 2 步：分析文章结构

提取：标题、副标题/金句、核心概念、关键数据、步骤/流程、亮点/特色、方法论/金句、行动召唤。

第 3 步：拆分为卡片

8-10 张卡片，遵循chartlet阅读节奏（→ 读 references/generate_chartlet.md）：

第 4 步：生成图片 HTML

输出路径：文章同目录下 [简短主题]-chartlet.html，未指定目录放 /tmp/。浏览器自动打开预览。

最后一张行动召唤页必须包含：微信号 [你的微信号]（强调色大字）、备注关键词、核心链接。

> 在 local/SKILL.local.md 中配置你的实际微信号。

📚 重要：生成前必读范例

参考 references/examples-chartlet/example-chartlet.html 的质量标准：

✅ 卡片设计要求

• 纯信息图设计，无文章截图
• 像素风/游戏化界面展示（适用时）
• 流程图、卡片网格、编号列表等丰富视觉元素
• 品牌色克制使用（墨绿85% + 鱼红5%）

✅ 文案质量要求

• 真人分享感，有真实场景和个人感受
• 口语化表达："玩疯了"、"上头了"、"然后我就..."
• 298-350字 + 8-12个标签

生成的内容应达到范例的专业水准。

第 5 步：生成微贴图发布文案

根据内容类型选择风格：

• 个人 IP 风格（真人分享、产品开发、踩坑记录）
• → 读 local/SKILL.local.md 中指定的个人品牌风格文件（如有）
• 流水账式真实感 + 具体时间细节 + 口语化表达
• 300-350字，8-12个标签
• 人设：在 local/SKILL.local.md 中自定义

• oddmeta风格（方法论总结、深度分析）
• → 读 references/platform_copy.md 的微贴图部分
• 结构化拆解 + 干货密度高
• 适合转载公众号文章

第 6 步：生成博客园发布文案

→ 读 references/platform_copy.md 的博客园部分。

第 7 步：生成播客脚本

→ 读 references/platform_copy.md 的播客部分。

第 7.5 步：生成微博文案

→ 读 references/platform_copy.md 的微博部分。

第 8 步：AI 语音生成

使用 Fish Audio TTS 将播客脚本转为 MP3（→ 读 references/tts_config.md）。

文件命名：[播客标题].mp3 + [播客标题]-播客脚本.txt

第 8.5 步：输出 manifest.json

所有内容生成完毕后，自动输出 manifest.json 到输出目录。格式：

{
  "version": "1.0",
  "created": "<ISO时间戳>",
  "source": "<微信链接>",
  "title": "<文章标题>",
  "outputs": {
    "chartlet": { "html": "...", "copy": { "title": "...", "body": "...", "tags": [...] } },
    "cnblogs": { "copy": { "body": "...", "circles": [...] } },
    "xiaoyuzhou": { "audio": "...", "script": "...", "copy": { "title": "...", "description": "...", "show_notes": "..." } },
    "video_canvas": { "html": "...", "teleprompter_md": "...", "cover_html": "..." },
    "weibo": { "copy": { "title": "...", "body": "...", "tags": [...] } }
  }
}

如果用户说"转微贴图并发布"，生成 manifest 后自动执行 /distribute。

第 9 步：品牌视频生成（可选）

仅当用户提到"视频"、"抖音"、"视频号"或"品牌视频"时执行：

A. Remotion 品牌片头片尾

cd "$REMOTION_DIR"
npx remotion render src/index.ts Intro --output /tmp/brand-intro.mp4
npx remotion render src/index.ts Outro --output /tmp/brand-outro.mp4

> $REMOTION_DIR 需在 local/.env 或环境变量中配置。

B. AI 视频 Prompt — 为 Seedance 2.0 或 Google Veo 生成 4 段视频 prompt

C. ffmpeg 拼接指令 — 生成拼接命令供用户手动执行

第 9B 步：视频画布生成（可选）

仅当用户说"做视频画布"、"录屏画布"、"手账视频"时执行。接受任意素材输入：微信链接、Markdown 文件、PDF、HTML 文件、纯文本、用户口述内容均可。

1. 获取内容 — 根据输入类型自动处理：
• 微信链接：调用 scripts/wechat_download.py 抓取
• 文件路径（md/pdf/html/txt）：直接读取
• 用户粘贴的文本：直接使用
2. 分析结构 — 提取标题、核心数据、痛点、步骤、原理、对比、金句、亮点
3. 拆分为 9 张卡片 — 读取 references/video_canvas_template.md 获取完整 CSS+JS 模板和卡片规范
4. 生成 9 段提词器脚本 — 口语化，每段 80-150 字，含 [提示] cue 标记
5. 输出提词器脚本 md — [简短主题]-提词器脚本.md，用户可直接编辑
6. 组装 HTML — CSS 框架 + HTML 骨架 + 填充内容 + JS 框架（SCRIPTS 与 md 一致）
7. 输出文件 — [简短主题]-视频画布.html，保存到文章同目录或 /tmp/
8. 生成封面图 — [简短主题]-封面.html，手账风格 + 人像圆框，浏览器下载 PNG
9. 提示用户 — 先检查提词器脚本 md，再在浏览器中打开 HTML 录制。16:9 固定比例，各平台直接上传

第 10 步：用户微调

告知用户所有产出物路径，提示可调整，输入 /distribute 可一键发布。

公众号同步提示：封面 PNG 从浏览器下载后，直接 /distribute --platforms wechat 即可同步到草稿箱（API 模式，无需打开 Chrome）。

一次性产出五样东西，不需要额外要求：

1. 微贴图图片 HTML（含一键下载工具栏）
2. 微贴图发布文案（标题 + 正文 + 标签）
3. 博客园发布文案（正文 + 圈子标签）
4. 微博发布文案（录制脚本 + AI 语音 MP3）
5. manifest.json（供 /distribute 一键发布）

第 9B 步可选追加（说"视频画布"时）：

1. 视频画布 HTML（含录制 + 提词器 + 美颜，16:9 固定）
2. 提词器脚本 md（可编辑，修改后说"更新提词器"同步到 HTML）
3. 封面图 HTML（手账风格 + 人像圆框，浏览器下载 PNG）

分发流程（/distribute）

读取 manifest.json，通过 Chrome CDP 自动化发布到各平台（→ 读 references/distribute-platforms.md）。

用法

# 全平台发布
npx -y bun "${SKILL_DIR}/scripts/distribute/distribute.ts" --manifest /path/to/manifest.json

# 选择平台
npx -y bun "${SKILL_DIR}/scripts/distribute/distribute.ts" --manifest /path/to/manifest.json --platforms chartlet,weibo

# 预览模式（不提交，只预填内容）
npx -y bun "${SKILL_DIR}/scripts/distribute/distribute.ts" --manifest /path/to/manifest.json --platforms chartlet --preview

平台缩写

执行顺序

公众号 → 微贴图 → 博客园 → 微博 → 抖音 → 视频号 → 微博（顺序执行，避免 Chrome 端口冲突）

四级降级

公众号优先 L0（API），凭证缺失或失败时自动降级 L1（CDP）。

品牌设计规范

两套品牌色体系：

• oddmeta：专业内容品牌（公众号、深度文章、方法论）
• OPEN365：真人IP品牌（微贴图、微博、博客园、日常分享）

> 单一真相源：在 local/SKILL.local.md 中指定你的品牌色文档路径。

> 如果色值冲突，以品牌文档为准。以下色板作为默认示例。

oddmeta 色板（墨绿体系）

比例法则：墨绿 85% : 鱼红 5% : 其余 10%

OPEN365 色板（桃粉体系）

比例法则：桃气粉 15% : 奶油黄 40% : 暮光紫 10% : 灰色 35%

品牌选择规则

双品牌联动：同一篇内容，公众号用oddmeta色，微贴图转发用奥德元色

字体

font-family: -apple-system, 'PingFang SC', 'Microsoft YaHei', sans-serif;

品牌角标

每页左上角 oddmeta logo + 文字，暗底页用 .light，浅底页用 .dark。

页码

右下角 1/N，暗底页 rgba(255,255,255,0.2)，浅底页 rgba(26,51,40,0.2)。

内容改写原则

微信 → 微贴图不是照搬，需适配：

改写要点：标题要炸、数字要大、一页一个点、视觉替代文字、保留核心链接。

完整模板参考

首次生成微贴图图片时，参考 references/examples-chartlet/exampe.html 范例文件获取完整 CSS + JS。

> 如果有额外的本地模板参考，在 local/SKILL.local.md 中指定路径，格式为 extra_examples: ["references/examples-chartlet/exampe-chartlet.html"]。

生成新内容时复用范例文件的 CSS + JS 部分，只替换卡片内容。

Script Directory

Agent Execution: Determine this SKILL.md directory as SKILL_DIR, then use ${SKILL_DIR}/scripts/.

Reference 文件索引

cc 按需读取，不要一次性加载所有 reference。

故障处理