md2wechat-mcp 0.2.0 → 0.2.1

package/README.md

@@ -1,9 +1,17 @@
 # 微信 Markdown 转换 MCP
 
-这个 MCP 服务提供三个工具：
+这个 MCP 服务提供以下工具：
 - `convert_markdown_to_wechat_html`: 把 Markdown 转成可用于公众号排版流程的内联样式 HTML。
 - `list_wechat_themes`: 返回可用主题。
-- `open_wechat_html_in_browser`: 接收 `cacheHtmlPath` 直接打开，方便手动 `Cmd+A` / `Cmd+C`。
+- `open_wechat_html_in_browser`: 打开转换后的缓存 HTML（`cacheHtmlPath` 必须来自 `convert_markdown_to_wechat_html` 返回值）。
+- `wechat_get_access_token`: 获取公众号接口调用凭证（读取环境变量）。
+- `wechat_upload_image`: 上传“文章内图片”并返回 URL（不占素材库配额）。
+- `wechat_add_material`: 上传永久素材（`image | voice | video | thumb`）。
+- `wechat_draft_add`: 新增草稿。
+- `wechat_markdown_to_draft`: 一键把 Markdown 转 HTML 并创建草稿。
+- `wechat_draft_update`: 更新草稿指定文章。
+- `wechat_draft_batchget`: 分页查询草稿列表。
+- `wechat_draft_delete`: 删除草稿。
 
 当前已支持常见 Markdown 语法（标题、段落、列表、引用、代码块、链接、强调）以及 GFM 风格表格。
 
@@ -64,14 +72,19 @@ node dist/cli.js ./input.md --theme default
 - `markdown_path` (string, optional): 传本地 Markdown 文件路径（避免整篇内容走 token）
 - `theme` (string, optional): `default | tech | warm | apple | wechat-native`
 - `title` (string, optional)
+- `font_size_preset` (string, optional, default `medium`): `small | medium | large`
+- `access_token` (string, optional): 传入后会自动上传本地图片并替换为微信 URL
 
 规则：
 - `markdown` 和 `markdown_path` 二选一
 - 如果两者都传，优先使用 `markdown`
+- 顶部一级标题（`# 标题`）会在转换时从正文移除（避免正文重复显示大标题）
 
 输出：
-- `text` 内容为 HTML 字符串（`<article>...</article>`）
-- `meta.cacheHtmlPath` 返回缓存文件路径
+- `content[0].text`：HTML 字符串（`<article>...</article>`）
+- `content[1].text`：可见元信息文本（含 `cacheHtmlPath=...`）
+- `meta.cacheHtmlPath` 返回缓存文件路径（后续 `open_wechat_html_in_browser.cacheHtmlPath` 必须使用这个字段）
+- 兼容说明：若客户端不展示 `meta`，从 `content[1].text` 解析 `cacheHtmlPath=...`
 
 ### 2) `list_wechat_themes`
 输入：空对象
@@ -79,17 +92,303 @@ node dist/cli.js ./input.md --theme default
 
 ### 3) `open_wechat_html_in_browser`
 输入：
-- `cacheHtmlPath` (string, required): 已有缓存 HTML 路径，工具会直接打开
+- `cacheHtmlPath` (string, required): 请直接传 `convert_markdown_to_wechat_html` 返回的 `meta.cacheHtmlPath`，不要手猜 `/tmp` 路径
 
 输出：
 - JSON 文本，包含 `ok / opened / cacheHtmlPath`
 - `meta.cacheHtmlPath` 返回缓存文件路径
 
+### 4) `wechat_add_material`
+对应官方接口：`POST /cgi-bin/material/add_material`
+
+输入：
+- `access_token` (string, required)
+- `type` (string, required): `image | voice | video | thumb`
+- `file_path` (string, required): 本地文件绝对路径
+- `title` (string, optional): `type=video` 时必填
+- `introduction` (string, optional): `type=video` 时必填
+
+输出：
+- `media_id` (string): 新增的永久素材 ID
+- `url` (string, optional): 仅 `image` 类型返回
+
+### 5) `wechat_get_access_token`
+输入：空对象
+
+依赖环境变量：
+- `WECHAT_APPID`
+- `WECHAT_APPSECRET`
+
+输出：
+- `access_token`
+- `expires_in`
+
+### 6) `wechat_upload_image`
+对应官方接口：`POST /cgi-bin/media/uploadimg`
+
+输入：
+- `access_token` (string, required)
+- `file_path` (string, required): 本地图片路径，仅支持 `jpg/jpeg/png`
+
+输出：
+- `url` (string): 文章内可用的图片 URL
+
+### 7) `wechat_draft_add`
+对应官方接口：`POST /cgi-bin/draft/add`
+
+输入：
+- `access_token` (string, required)
+- `articles` (array, required): 至少 1 篇，字段与公众号草稿接口一致，核心字段：
+- `title` (string, required)
+- `content` (string, required): 建议使用 `convert_markdown_to_wechat_html` 生成
+- `author`/`digest`/`content_source_url`/`thumb_media_id`/`need_open_comment`/`only_fans_can_comment` (optional)
+
+输出：
+- `media_id` (string)
+
+### 8) `wechat_draft_update`
+对应官方接口：`POST /cgi-bin/draft/update`
+
+输入：
+- `access_token` (string, required)
+- `media_id` (string, required)
+- `index` (number, optional, default `0`)
+- `article` (object, required): 同 `wechat_draft_add` 单篇文章结构
+
+输出：
+- `errcode`
+- `errmsg`
+
+### 9) `wechat_markdown_to_draft`
+一键工具：内部自动执行 `convert_markdown_to_wechat_html` + `wechat_draft_add`。
+封面自动策略（默认启用，无需传封面参数）：
+- 若存在 `title="封面"` 的本地 `jpg/jpeg` 图片：该图上传为封面，并从正文移除
+- 否则：尝试使用首张本地 `jpg/jpeg` 图片作为封面
+- 若无可用图片：不上传封面，草稿仍会创建
+- 顶部一级标题（`# 标题`）会在转换时从正文移除（避免正文重复显示大标题）
+
+输入（核心）：
+- `access_token` (string, required)
+- `article_title` (string, optional)：草稿标题。未传时按“首个一级标题（H1）→ 文件名（去扩展名）”自动推断
+- `markdown` 或 `markdown_path` (至少一个)
+
+输入（可选）：
+- `theme` / `title`
+- `font_size_preset`（可选，`small | medium | large`，默认 `medium`）
+- `thumb_media_id`（可选，显式覆盖自动封面）
+- `author` / `digest` / `content_source_url`
+- `need_open_comment` / `only_fans_can_comment`
+
+说明：
+- `auto_thumb_from_first_image` 参数已移除；封面由 `wechat_markdown_to_draft` 内置策略自动处理。
+
+输出：
+- 草稿创建结果（含 `media_id`）
+- `meta.cacheHtmlPath`（转换缓存路径）
+- `meta.thumbMediaId`（若自动或手动封面可用）
+
+### 10) `wechat_draft_batchget`
+对应官方接口：`POST /cgi-bin/draft/batchget`
+
+输入：
+- `access_token` (string, required)
+- `offset` (number, optional, default `0`)
+- `count` (number, optional, default `10`, 范围 `1-20`)
+- `no_content` (`0 | 1`, optional, default `0`)
+
+输出：
+- `total_count`
+- `item_count`
+- `item`
+
+### 11) `wechat_draft_delete`
+对应官方接口：`POST /cgi-bin/draft/delete`
+
+输入：
+- `access_token` (string, required)
+- `media_id` (string, required)
+
+输出：
+- `errcode`
+- `errmsg`
+
+## 典型调用流程
+
+前置：`wechat_markdown_to_draft` 也必须先拿到 `access_token`（可通过 `wechat_get_access_token` 获取）。
+
+1. 推荐直接调用 `wechat_markdown_to_draft` 一步完成转换+建草稿（在已持有 `access_token` 的前提下）
+2. 或者使用分步模式：`wechat_get_access_token` → `convert_markdown_to_wechat_html` → `wechat_draft_add`
+3. 封面默认自动处理（`title="封面"` 优先；否则首图）；也可手动 `wechat_add_material(type=thumb)` 后在草稿里显式传 `thumb_media_id`
+4. 使用 `wechat_draft_update / wechat_draft_batchget / wechat_draft_delete` 做后续管理
+
+## 给 AI 的执行规范（建议写入系统提示）
+
+当用户说“把 Markdown 上传到公众号草稿箱”时，必须遵循：
+1. 必须先调用 `convert_markdown_to_wechat_html`。
+2. `wechat_draft_add.articles[].content` 必须使用上一步返回的 `content[0].text`。
+3. 不要把原始 Markdown 直接传给 `wechat_draft_add`。
+4. `wechat_add_material` 仅用于素材上传（封面/音视频），不能替代 `wechat_draft_add` 创建草稿。
+5. 需要手动封面时，先调用 `wechat_add_material(type=thumb)`，再将返回 `media_id` 写入 `wechat_draft_add.articles[].thumb_media_id`。
+6. 调用 `open_wechat_html_in_browser` 时，`cacheHtmlPath` 必须来自 `convert_markdown_to_wechat_html` 返回的 `meta.cacheHtmlPath`。
+
+## MCP 调用示例（可直接复制）
+
+### `wechat_get_access_token`
+```json
+{
+  "name": "wechat_get_access_token",
+  "arguments": {}
+}
+```
+
+### `convert_markdown_to_wechat_html`
+```json
+{
+  "name": "convert_markdown_to_wechat_html",
+  "arguments": {
+    "markdown_path": "/absolute/path/article.md",
+    "theme": "wechat-native",
+    "font_size_preset": "small",
+    "title": "文章标题",
+    "access_token": "ACCESS_TOKEN"
+  }
+}
+```
+
+### `convert_markdown_to_wechat_html` -> `open_wechat_html_in_browser`（字段级映射）
+```text
+open.arguments.cacheHtmlPath = convert.meta.cacheHtmlPath
+```
+
+若客户端不展示 `meta`，可从 `convert` 的第二段 `content` 读取：
+```text
+convert.content[1].text:
+cacheHtmlPath=/abs/path/to/wechat-xxx.html
+```
+
+提取规则（示例）：
+```text
+cacheHtmlPath = line that starts with "cacheHtmlPath="
+value = text after "="
+```
+
+```json
+{
+  "name": "open_wechat_html_in_browser",
+  "arguments": {
+    "cacheHtmlPath": "<convert_result.meta.cacheHtmlPath>"
+  }
+}
+```
+
+### `wechat_add_material`
+```json
+{
+  "name": "wechat_add_material",
+  "arguments": {
+    "access_token": "ACCESS_TOKEN",
+    "type": "thumb",
+    "file_path": "/absolute/path/cover.jpg"
+  }
+}
+```
+
+### `wechat_upload_image`
+```json
+{
+  "name": "wechat_upload_image",
+  "arguments": {
+    "access_token": "ACCESS_TOKEN",
+    "file_path": "/absolute/path/inline-image.jpg"
+  }
+}
+```
+
+### `wechat_draft_add`
+```json
+{
+  "name": "wechat_draft_add",
+  "arguments": {
+    "access_token": "ACCESS_TOKEN",
+    "articles": [
+      {
+        "title": "文章标题",
+        "author": "作者名",
+        "digest": "摘要",
+        "content": "<article>...</article>",
+        "thumb_media_id": "THUMB_MEDIA_ID",
+        "need_open_comment": 1,
+        "only_fans_can_comment": 0
+      }
+    ]
+  }
+}
+```
+
+### `wechat_draft_update`
+```json
+{
+  "name": "wechat_draft_update",
+  "arguments": {
+    "access_token": "ACCESS_TOKEN",
+    "media_id": "DRAFT_MEDIA_ID",
+    "index": 0,
+    "article": {
+      "title": "更新后的标题",
+      "content": "<article>...</article>",
+      "thumb_media_id": "THUMB_MEDIA_ID"
+    }
+  }
+}
+```
+
+### `wechat_markdown_to_draft`
+```json
+{
+  "name": "wechat_markdown_to_draft",
+  "arguments": {
+    "access_token": "ACCESS_TOKEN",
+    "article_title": "文章标题",
+    "markdown_path": "/absolute/path/article.md",
+    "theme": "wechat-native",
+    "font_size_preset": "medium",
+    "title": "页面H1标题",
+    "author": "作者名",
+    "digest": "摘要"
+  }
+}
+```
+
+### `wechat_draft_batchget`
+```json
+{
+  "name": "wechat_draft_batchget",
+  "arguments": {
+    "access_token": "ACCESS_TOKEN",
+    "offset": 0,
+    "count": 10,
+    "no_content": 1
+  }
+}
+```
+
+### `wechat_draft_delete`
+```json
+{
+  "name": "wechat_draft_delete",
+  "arguments": {
+    "access_token": "ACCESS_TOKEN",
+    "media_id": "DRAFT_MEDIA_ID"
+  }
+}
+```
+
 ## CLI 参数
 
 `md2wechat <input> [options]`
 - `--theme <theme>`
 - `--title <title>`
+- `--font-size-preset <preset>`
 - `--out <path>`
 - `--cache-dir <path>`
 

package/dist/browser.js

@@ -1,4 +1,5 @@
 import { execFile } from "node:child_process";
+import { access } from "node:fs/promises";
 import { promisify } from "node:util";
 const execFileAsync = promisify(execFile);
 function getBrowserCommand(filePath) {
@@ -11,6 +12,7 @@ function getBrowserCommand(filePath) {
     return { command: "xdg-open", args: [filePath] };
 }
 export async function openFileInBrowser(filePath, runner = (command, args) => execFileAsync(command, args)) {
+    await access(filePath);
     const { command, args } = getBrowserCommand(filePath);
     await runner(command, args);
 }

package/dist/cache.js

@@ -16,7 +16,7 @@ export function ensureCacheDir(cwd) {
     const candidates = [
         process.env.WECHAT_MCP_CACHE_DIR,
         join(baseDir, ".cache", "wechat-mcp"),
-        join(process.cwd(), ".cache", "wechat-mcp"),
+        baseDir !== process.cwd() ? join(process.cwd(), ".cache", "wechat-mcp") : undefined,
         xdgCache ? join(resolve(xdgCache), "wechat-mcp") : undefined,
         process.platform === "darwin" ? join(homedir(), "Library", "Caches", "wechat-mcp") : join(homedir(), ".cache", "wechat-mcp"),
         join(tmpdir(), "wechat-mcp")
@@ -37,8 +37,9 @@ export function saveHtmlCache(html, cwd, cacheDir) {
     const finalDir = cacheDir ? resolve(cacheDir) : ensureCacheDir(cwd);
     mkdirSync(finalDir, { recursive: true });
     const now = new Date();
-    const stamp = `${now.getFullYear()}${String(now.getMonth() + 1).padStart(2, "0")}${String(now.getDate()).padStart(2, "0")}-${String(now.getHours()).padStart(2, "0")}${String(now.getMinutes()).padStart(2, "0")}${String(now.getSeconds()).padStart(2, "0")}`;
-    const filePath = join(finalDir, `wechat-${stamp}.html`);
+    const stamp = `${now.getFullYear()}${String(now.getMonth() + 1).padStart(2, "0")}${String(now.getDate()).padStart(2, "0")}-${String(now.getHours()).padStart(2, "0")}${String(now.getMinutes()).padStart(2, "0")}${String(now.getSeconds()).padStart(2, "0")}${String(now.getMilliseconds()).padStart(3, "0")}`;
+    const randomSuffix = Math.random().toString(36).slice(2, 8);
+    const filePath = join(finalDir, `wechat-${stamp}-${randomSuffix}.html`);
     writeFileSync(filePath, html, "utf8");
     return filePath;
 }

package/dist/cli.js

@@ -11,6 +11,12 @@ function validateTheme(theme) {
     }
     throw new Error(`Invalid theme: ${theme}. Available: ${[...THEME_NAMES].sort().join(", ")}`);
 }
+function validateFontSizePreset(value) {
+    if (value === "small" || value === "medium" || value === "large") {
+        return value;
+    }
+    throw new Error(`Invalid font size preset: ${value}. Available: small, medium, large`);
+}
 export async function main(argv = process.argv) {
     const program = new Command();
     program
@@ -19,6 +25,7 @@ export async function main(argv = process.argv) {
         .argument("<input>", "Input markdown file path")
         .option("--theme <theme>", "Rendering theme", "default")
         .option("--title <title>", "Optional title override")
+        .option("--font-size-preset <preset>", "Font size preset: small | medium | large", "medium")
         .option("--out <path>", "Optional output html path; if omitted, use .cache/wechat-mcp")
         .option("--cache-dir <path>", "Override cache directory (or set WECHAT_MCP_CACHE_DIR).")
         .showHelpAfterError();
@@ -27,7 +34,8 @@ export async function main(argv = process.argv) {
     const markdown = readFileSync(inputPath, "utf8");
     const opts = program.opts();
     const theme = validateTheme(opts.theme);
-    const html = parseMarkdown(markdown, theme, opts.title);
+    const fontSizePreset = validateFontSizePreset(opts.fontSizePreset);
+    const html = parseMarkdown(markdown, theme, opts.title, fontSizePreset);
     let outputPath;
     if (opts.out) {
         outputPath = resolve(opts.out);
@@ -39,6 +47,7 @@ export async function main(argv = process.argv) {
     }
     process.stdout.write(`Input: ${inputPath}\n`);
     process.stdout.write(`Theme: ${theme}\n`);
+    process.stdout.write(`Font size preset: ${fontSizePreset}\n`);
     process.stdout.write(`Output: ${outputPath}\n`);
     return 0;
 }

package/dist/markdown.d.ts

@@ -1,3 +1,3 @@
-import { type Theme } from "./themes.js";
+import { type FontSizePreset, type Theme } from "./themes.js";
 export declare function inlineFormat(text: string, theme: Theme): string;
-export declare function parseMarkdown(md: string, themeName?: string, title?: string): string;
+export declare function parseMarkdown(md: string, themeName?: string, title?: string, fontSizePreset?: FontSizePreset): string;

package/dist/markdown.js

@@ -1,4 +1,4 @@
-import { THEMES } from "./themes.js";
+import { resolveTheme } from "./themes.js";
 function escapeHtml(text) {
     return text
         .replaceAll("&", "&")
@@ -19,11 +19,15 @@ export function inlineFormat(text, theme) {
         return stash(`<code style=\"${theme.code_inline}\">${code}</code>`);
     });
     // Images must be processed before links (pattern starts with `!`)
-    escaped = escaped.replace(/!\[([^\]]*)\]\((https?:\/\/[^\s)]+)\)/g, (_m, alt, src) => {
-        return stash(`<img src=\"${src}\" alt=\"${alt}\" style=\"max-width:100%;height:auto;display:block;margin:0.8em auto;\" />`);
+    escaped = escaped.replace(/!\[([^\]]*)\]\((https?:\/\/[^\s)]+)(?:\s+(?:"([^"]+)"|'([^']+)'|&quot;([^&]+)&quot;|&#39;([^&]+)&#39;))?\)/g, (_m, alt, src, t1, t2, t3, t4) => {
+        const title = t1 ?? t2 ?? t3 ?? t4;
+        const titleAttr = title ? ` title=\"${title}\"` : "";
+        return stash(`<img src=\"${src}\" alt=\"${alt}\"${titleAttr} style=\"max-width:100%;height:auto;display:block;margin:0.8em auto;\" />`);
     });
-    escaped = escaped.replace(/\[([^\]]+)\]\((https?:\/\/[^\s)]+)\)/g, (_m, label, href) => {
-        return `<a href=\"${href}\" style=\"${theme.a}\">${label}</a>`;
+    escaped = escaped.replace(/\[([^\]]+)\]\((https?:\/\/[^\s)]+)(?:\s+(?:"([^"]+)"|'([^']+)'|&quot;([^&]+)&quot;|&#39;([^&]+)&#39;))?\)/g, (_m, label, href, t1, t2, t3, t4) => {
+        const title = t1 ?? t2 ?? t3 ?? t4;
+        const titleAttr = title ? ` title=\"${title}\"` : "";
+        return `<a href=\"${href}\"${titleAttr} style=\"${theme.a}\">${label}</a>`;
     });
     escaped = escaped.replace(/\*\*([^*]+)\*\*/g, (_m, content) => {
         return `<strong style=\"${theme.strong}\">${content}</strong>`;
@@ -60,8 +64,8 @@ function parseColumnAlignment(cell) {
         return "left";
     return null;
 }
-export function parseMarkdown(md, themeName = "default", title) {
-    const theme = THEMES[themeName] ?? THEMES.default;
+export function parseMarkdown(md, themeName = "default", title, fontSizePreset = "medium") {
+    const theme = resolveTheme(themeName, fontSizePreset);
     const lines = md.replaceAll("\r\n", "\n").split("\n");
     const out = [];
     if (title) {

package/dist/server.js

@@ -8,28 +8,55 @@ import pkg from "../package.json" with { type: "json" };
 const SERVER_NAME = pkg.name;
 const SERVER_VERSION = pkg.version;
 const themeSchema = z.enum(["default", "tech", "warm", "apple", "wechat-native"]);
+const fontSizePresetSchema = z.enum(["small", "medium", "large"]);
 const SERVER_INSTRUCTIONS = `
 ## 发布 Markdown 图文到微信公众号草稿箱
 
 前置条件：MCP server 配置环境变量 WECHAT_APPID 和 WECHAT_APPSECRET。
 
-完整工作流：
+严格执行规则（非常重要）：
+1) 用户要求“发布/上传 Markdown 到草稿箱”时，必须先调用 convert_markdown_to_wechat_html，再调用 wechat_draft_add。
+2) wechat_draft_add.articles[].content 必须使用 convert_markdown_to_wechat_html 返回的 content[0].text，不能直接使用原始 Markdown。
+3) wechat_add_material 只用于上传素材（如封面），不能替代 wechat_draft_add 创建草稿。
+4) 封面素材请通过一键工具自动处理，或手动调用 wechat_add_material(type=thumb) 后写入 wechat_draft_add.articles[].thumb_media_id。
+5) 若要预览/打开 HTML，open_wechat_html_in_browser.cacheHtmlPath 必须使用 convert_markdown_to_wechat_html 返回的 meta.cacheHtmlPath，不要猜测临时路径。
+6) 若客户端不展示 meta，必须从 convert_markdown_to_wechat_html 的 content[1].text 解析 cacheHtmlPath=...，不得用“最近文件”或路径猜测替代。
+
+完整工作流（按顺序）：
+
+推荐：可直接使用一键工具 wechat_markdown_to_draft 完成 Step 2/5 的核心链路（Step 1 仍需先获取 access_token）。
+  一键工具会自动处理封面：
+  - 若存在 title 为“封面”的本地 JPG/JPEG 图片，则该图作为封面并从正文移除；
+  - 否则尝试用首张本地 JPG/JPEG 作为封面；
+  - 若无可用图片则不上传封面。
 
 Step 1 — 获取 access_token
   wechat_get_access_token() → { access_token, expires_in }
   同一次任务保存复用，无需重复获取（有效期 7200 秒）。
 
 Step 2 — 转换 Markdown 并自动上传本地图片
-  convert_markdown_to_wechat_html(markdown_path, access_token, theme?, title?)
+  convert_markdown_to_wechat_html(markdown_path, access_token, theme?, title?, font_size_preset?)
   传入 access_token 后，![alt](./local/path) 形式的本地图片自动上传并替换为微信 CDN URL。
+  返回：content[0].text（HTML）、content[1].text（可见元信息）、meta.cacheHtmlPath（缓存文件路径）。
 
 Step 3（可选）— 上传文章内嵌图片
   wechat_upload_image(access_token, file_path) → { url }
   返回的 url 可用于文章 HTML 中的 <img src>，但不能用作封面 thumb_media_id。
 
-Step 4 — 新增草稿
+Step 4（可选）— 上传永久素材（封面图/视频等）
+  wechat_add_material(access_token, type, file_path, title?, introduction?) → { media_id, url? }
+  type: image | voice | video | thumb
+  当 type=video 时需要提供 title 和 introduction；返回的 media_id 可用于 thumb_media_id 或其他素材场景。
+
+Step 5 — 新增草稿
   wechat_draft_add(access_token, articles: [{ title, content, author?, digest?, thumb_media_id?, ... }])
-  content 使用 Step 2 返回的 HTML。返回 media_id 可用于后续更新或删除。
+  content 必须使用 Step 2 返回的 content[0].text。返回 media_id 可用于后续更新或删除。
+
+标准映射（必须遵循）：
+  draft.content = convert.content[0].text
+  draft.thumb_media_id = 使用 wechat_add_material(type=thumb) 返回的 media_id（或一键工具自动返回的封面）
+  open.cacheHtmlPath = convert.meta.cacheHtmlPath
+  fallback: open.cacheHtmlPath = parse(convert.content[1].text where line starts with "cacheHtmlPath=")
 
 其他工具：
   wechat_draft_batchget — 分页查询草稿列表
@@ -41,12 +68,13 @@ Step 4 — 新增草稿
 export function createServer() {
     const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION }, { instructions: SERVER_INSTRUCTIONS });
     server.registerTool("convert_markdown_to_wechat_html", {
-        description: "Convert Markdown to WeChat-friendly HTML with inline styles for copy/paste publishing workflows.",
+        description: "Convert Markdown to WeChat-friendly HTML. Output mapping: content[0].text is article HTML; meta.cacheHtmlPath is the cached file path for open_wechat_html_in_browser.cacheHtmlPath.",
         inputSchema: {
             markdown: z.string().optional().describe("Source markdown text. If both markdown and markdown_path are provided, markdown is used."),
             markdown_path: z.string().optional().describe("Local markdown file path. Use this to avoid sending full content through tokens."),
             theme: themeSchema.optional().default("default").describe("Theme name: default | tech | warm | apple | wechat-native"),
             title: z.string().optional().describe("Optional article title rendered as h1"),
+            font_size_preset: fontSizePresetSchema.optional().default("medium").describe("Font size preset: small | medium | large"),
             access_token: z.string().optional().describe("WeChat API access token. When provided, local images referenced as ![alt](./path) are automatically uploaded to WeChat CDN and replaced with permanent URLs.")
         }
     }, async (args) => handleToolCall("convert_markdown_to_wechat_html", args));
@@ -55,9 +83,9 @@ export function createServer() {
         inputSchema: {}
     }, async () => handleToolCall("list_wechat_themes", {}));
     server.registerTool("open_wechat_html_in_browser", {
-        description: "Open cached HTML path directly in the default browser for manual copy workflows.",
+        description: "Open cached HTML in browser for manual copy workflows. Pass convert_markdown_to_wechat_html result meta.cacheHtmlPath; do not guess temp paths.",
         inputSchema: {
-            cacheHtmlPath: z.string().describe("Existing cached HTML file path to open directly")
+            cacheHtmlPath: z.string().describe("Use convert_markdown_to_wechat_html returned meta.cacheHtmlPath directly")
         }
     }, async (args) => handleToolCall("open_wechat_html_in_browser", args));
     const articleSchema = z.object({
@@ -76,12 +104,30 @@ export function createServer() {
         inputSchema: {}
     }, async () => handleToolCall("wechat_get_access_token", {}));
     server.registerTool("wechat_draft_add", {
-        description: "Add a new draft to WeChat Official Account draft box. Returns media_id for the created draft.",
+        description: "Add a new draft to WeChat Official Account draft box. articles[].content must be HTML from convert_markdown_to_wechat_html content[0].text.",
         inputSchema: {
             access_token: z.string().describe("WeChat API access token from wechat_get_access_token"),
             articles: z.array(articleSchema).min(1).describe("Array of articles to include in the draft (usually 1)")
         }
     }, async (args) => handleToolCall("wechat_draft_add", args));
+    server.registerTool("wechat_markdown_to_draft", {
+        description: "One-shot tool: convert markdown to WeChat HTML and create draft. Cover is handled automatically (title=封面 preferred, else first local JPG/JPEG).",
+        inputSchema: {
+            access_token: z.string().describe("WeChat API access token from wechat_get_access_token"),
+            article_title: z.string().optional().describe("Draft article title. Fallback: first markdown H1, then markdown file name."),
+            markdown: z.string().optional().describe("Source markdown text. If both markdown and markdown_path are provided, markdown is used."),
+            markdown_path: z.string().optional().describe("Local markdown file path"),
+            theme: themeSchema.optional().default("default").describe("Theme name: default | tech | warm | apple | wechat-native"),
+            title: z.string().optional().describe("Optional rendered h1 title for HTML"),
+            font_size_preset: fontSizePresetSchema.optional().default("medium").describe("Font size preset: small | medium | large"),
+            thumb_media_id: z.string().optional().describe("Optional explicit thumb media id override."),
+            author: z.string().optional().describe("Author name"),
+            digest: z.string().optional().describe("Article summary"),
+            content_source_url: z.string().optional().describe("Original article URL"),
+            need_open_comment: z.union([z.literal(0), z.literal(1)]).optional().describe("Enable comments: 1=yes, 0=no"),
+            only_fans_can_comment: z.union([z.literal(0), z.literal(1)]).optional().describe("Only followers can comment: 1=yes, 0=no")
+        }
+    }, async (args) => handleToolCall("wechat_markdown_to_draft", args));
     server.registerTool("wechat_draft_update", {
         description: "Update an existing draft in WeChat Official Account draft box by media_id.",
         inputSchema: {
@@ -98,6 +144,16 @@ export function createServer() {
             file_path: z.string().describe("Absolute local path to the image file (JPG or PNG, max 1MB)")
         }
     }, async (args) => handleToolCall("wechat_upload_image", args));
+    server.registerTool("wechat_add_material", {
+        description: "Upload permanent material to WeChat material library (image/voice/video/thumb). Returns media_id and image url when type=image.",
+        inputSchema: {
+            access_token: z.string().describe("WeChat API access token from wechat_get_access_token"),
+            type: z.enum(["image", "voice", "video", "thumb"]).describe("Permanent material type"),
+            file_path: z.string().describe("Absolute local file path"),
+            title: z.string().optional().describe("Video title. Required when type=video"),
+            introduction: z.string().optional().describe("Video introduction. Required when type=video")
+        }
+    }, async (args) => handleToolCall("wechat_add_material", args));
     server.registerTool("wechat_draft_batchget", {
         description: "Query draft list from WeChat Official Account draft box with pagination.",
         inputSchema: {
@@ -125,7 +181,15 @@ MCP server that converts Markdown to WeChat-friendly HTML.
 Tools:
   convert_markdown_to_wechat_html  Convert Markdown to inline-styled HTML
   list_wechat_themes               List available themes
-  open_wechat_html_in_browser      Open cached HTML in browser
+  open_wechat_html_in_browser      Open cached HTML in browser (use meta.cacheHtmlPath from convert result)
+  wechat_get_access_token          Get WeChat access token from env
+  wechat_upload_image              Upload inline article image
+  wechat_add_material              Upload permanent material
+  wechat_draft_add                 Add draft
+  wechat_markdown_to_draft         One-shot markdown to draft
+  wechat_draft_update              Update draft
+  wechat_draft_batchget            Query draft list
+  wechat_draft_delete              Delete draft
 
 MCP config:
   {

package/dist/themes.d.ts

@@ -18,5 +18,7 @@ export type Theme = {
     th: string;
     td: string;
 };
+export type FontSizePreset = "small" | "medium" | "large";
 export declare const THEMES: Record<string, Theme>;
 export declare const THEME_NAMES: string[];
+export declare function resolveTheme(themeName: string, fontSizePreset?: FontSizePreset): Theme;