WeChat MP Publisher

将 Markdown 稿件排版并推送到微信公众号草稿箱（经 relay，凭据按请求透传）。

凭据与存储位置

• 公众号凭据存放在本 skill 目录下的 accounts.json（已 gitignore，不进仓）：

  crews/main/skills/wx-mp-publisher/accounts.json

  结构见 accounts.example.json。支持多账号，每条含 alias / appId / appSecret；多账号时 default 指向默认 alias。
• relay 身份 OFB_KEY + RELAY_BASE_URL 来自 daemon.env（由 entrypoint 注入环境变量）。

凭据缺失时 Agent 行为

1. 若 accounts.json 不存在或对应账号缺 appId/appSecret：先读同目录 REFERENCE.md，按其中的步骤指导用户获取 AppID / AppSecret（含 relay IP 白名单 123.60.18.144 的设置）。
2. 收到用户提供的值后，写入 accounts.json，再继续发布。
3. 若 OFB_KEY 未配置：告知用户需让 IT engineer 在 daemon.env 配置后重启实例。

发布命令

通过 PATH 调用 wrapper：wx-mp-publisher <cmd>，无需手动拼接 python 命令或脚本路径。

wx-mp-publisher <markdown_file> [theme] [--account ALIAS]

• theme：渲染主题，三种形态：

  1. 内置 id（pie / lapis / default / …）——原样作为 theme 传给 relay
  2. 本地 .css 文件路径——脚本读出文件内容，作为 custom_theme 字段随 multipart 上传 relay
  3. SKILL.md 主题表登记的自定义 id——解析出对应 CSS 路径，同 (2)

  可选，缺省由 relay 默认渲染。

• --account ALIAS：多账号时指定目标公众号；缺省用 accounts.json 的 default

自定义主题不持久化：relay 是无状态多租户中转，不存任何用户主题。CSS 随请求上传，relay 写到 per-request 临时目录、用后即清理，天然按用户隔离。下表的「主题 ID → CSS 文件」映射只存在 client 侧。

脚本自动：

• 从 accounts.json 取目标账号凭据
• 从 Markdown 中提取本地图片路径，作为 images 字段一并上传（http/https 图片由 relay 自行抓取，不在此列）
• POST multipart 到 ${RELAY_BASE_URL}/api/v1/wx-mp/publish，带 X-OFB-Key
• 校验响应包络 { success, data, error }

主题选择（未指定时）

自定义主题说明：generate-wenyan-theme 生成的用户自定义 CSS 会注册到下表。若用户明确指定参考某个自定义主题，必须优先采用该主题；未指定时才按内容在内置主题和已注册自定义主题中匹配。

智能选择决策树（用户未指定主题时）：

含大量代码/技术术语 → lapis
年轻女性/亲子/萌宠  → rainbow
情感/故事/节日      → orangeheart
健康/美食/户外      → maize
品牌/商务/精品      → purple
科普/知识型         → phycat
深度长文/评测/观点  → pie
其他（资讯/通知）   → default

Frontmatter 要求

文章 Markdown 开头必须包含 YAML 块，否则微信 API 会拒绝：

---
title: 文章标题
cover: ./cover.jpg           # 可选，缺省自动取正文第一张图
author: 作者名称              # 可选
source_url: https://...      # 可选，原文链接
need_open_comment: true      # 可选，是否开启评论（默认 false）
only_fans_can_comment: false # 可选，是否仅粉丝可评论（默认 false）
---

小绿书（图片消息）

纯图片轮播形式，不含正文 HTML。在 frontmatter 中指定 image_list（最多 20 张，首张为封面）：

---
title: 文章标题
image_list:
  - ./1.jpg
  - ./2.jpg
---

有 image_list 时 relay 自动走图片消息接口，忽略主题参数。

Agent 行为约束

1. 等待脚本完整返回后再判定结果，禁止在脚本输出前自行判断是否发布成功
2. 发布前先确认目标账号凭据存在；缺失则按 REFERENCE.md 引导用户获取并写入
3. 多账号场景：用户未明示账号时用 default；用户口头说「发到技术号」等 alias 含义时传 --account

Error Handling

Notes

• 发布成功后输出草稿 media_id，可在公众号后台「草稿箱」找到对应草稿
• 本 skill 只负责推送草稿，正式发布仍需在公众号后台手动操作
• relay 已内置 @wenyan-md/core 渲染，client 不再需要装 wenyan-cli
• 仅支持文本 + 图片（无视频）