前言¶

DeepSeek Harness（DSH）的设计理念是「一切皆插件」。当智能体在写作任务中已经能生成 Markdown 文章后，发布这一步往往仍停留在「人工复制粘贴」的链路里：公众号后台不支持 Markdown，图片要一张张上传，封面还需要单独设置。这个插件把从 Markdown + 封面到公众号草稿箱的整条链路收成一个工具调用，让模型只需一句「把这篇文章发到公众号」，其余的 token 获取、图片上传、正文转 HTML、建草稿等步骤全部由插件完成。

它是什么¶

dsh-plugin-wechat-publisher 是一个为 DeepSeek Harness（dsh）准备的微信公众号发布插件，由 xiaoziwenjie-code 维护。它把一篇 Markdown 文章 + 一张封面图直推到公众号草稿箱，纯 Node.js 实现，零第三方依赖，只使用微信官方 /cgi-bin 接口。安装后会在 DSH 中注册 wechat_publish_article 工具，用于执行发文操作。

安装与启用¶

在插件父目录执行以下命令，从本地目录装进 profile：

# dsh 侧（pnpm 必需——npm 在这一大坨 @deepseek-ai/dsh-* 依赖上会 OOM）
corepack enable --install-directory ~/.local/bin pnpm

# 从本地目录装进 profile（注意：在插件父目录执行）
dsh plugin --profile web add ./dsh-plugin-wechat-publisher
dsh --profile web

安装成功后，在 DSH 的输出中看到这一行说明已就绪：

[xiaoziwenjie-code-wechat-publisher] 已就绪 — 工具 wechat_publish_article

配置¶

插件凭据只从环境变量读取，不落盘、不进日志、不出现在工具返回里。在执行前需先设置：

export WECHAT_APP_ID=wx______________
export WECHAT_APP_SECRET=______________

在公众号后台完成两件事：

1. IP 白名单：设置与开发 → 基本配置 → IP 白名单，把运行主机的外网出口 IP 加进去。这是最常见失败原因之一，errcode=40164 就是它。
2. 接口权限：订阅号需要认证才有 draft/add 和 freepublish 权限。

插件会绕过 HTTP_PROXY / HTTPS_PROXY 调用微信接口，因为微信校验的是真实出口 IP，走代理会导致校验失败。

典型用法¶

调用 wechat_publish_article 工具，传入路径与参数：

{
  "markdownPath": "/path/to/article.md",
  "coverPath":    "/path/to/cover.png",
  "title":        "文章标题",
  "author":       "作者名",        // 可选
  "digest":       "摘要，不填取首段",  // 可选
  "mode":         "draft_only"     // 默认，或 full_publish
}

工具返回结构化结果：

{
  "ok": true,
  "stage": "done",
  "mode": "draft_only",
  "mediaId": "xxxxxxxx",
  "publishId": "",
  "articleUrl": "",
  "title": "文章标题",
  "error": ""
}

两种模式¶

⚠️ freepublish 不等于手动点发布。它能返回 publish_id 和 article_url，但文章在公众号首页的实际可见性，和后台手动发布的表现并不总是一致。历史上有发布成功但首页不显示的情况。所以默认走 draft_only。

失败处理¶

插件不抛异常，永远返回结构化结果。stage 字段告诉你卡在哪一步：

full_publish 在 publish 阶段失败时，mediaId 仍然有效，文章安全躺在草稿箱里。

实现约束¶

• 正文 HTML 只输出微信不删的标签：p/h1-h6/ul/li/blockquote/strong/em/code/a/img。微信会剥掉 <style>，所以样式全部内联交给平台。
• 图片用真格式校验，不靠扩展名猜 —— 微信按文件头识别，扩展名和实际格式不符会直接拒。
• 封面走 material/add_material（永久素材，返回 thumb_media_id），正文图走 media/uploadimg（返回临时 URL），两条路径用途不同不能混用。
• 30 秒请求超时，避免插件卡死拖住整个 session。

开发¶

在本地进行开发与自检：

pnpm install
npm run build      # tsc → dist/index.js (pure ESM)
npm run typecheck

无凭据自检（验证注册和错误分支，不需要真号）：

node -e "
import('./dist/index.js').then(m => {
  const reg = new Map();
  m.apply({ tools: { register(t){ reg.set(t.name,t); return ()=>{} }, get(n){ return reg.get(n) } } });
  reg.get('wechat_publish_article')
    .execute({ markdownPath:'/tmp/a.md', coverPath:'/tmp/c.png', title:'T' })
    .then(r => console.log(JSON.stringify(r)));
});
"

预期输出 stage: "token" + missing WECHAT_APP_ID。

已知坑¶

1. @deepseek-ai/dsh-tools 的 npm latest 是过期的 0.0.1-rc.1，正确版本在 next tag。本包已锁 0.2.1-rc.2，别手动 npm i 覆盖。
2. pnpm 默认拦截构建脚本，装 dsh 全家桶时要在 pnpm-workspace.yaml 写 onlyBuiltDependencies。
3. 8GB 内存机器上 npm 装 dsh 会被静默 OOM 杀掉，没有任何错误日志，进程直接消失。用 pnpm。

适用场景与注意¶

这个插件适合已经在使用 DeepSeek Harness、希望让智能体具备「一键发文」能力的开发者。插件以当前 dsh 进程的权限运行，安装前应检查源码与许可证。

社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不要写成官方应用商店。

结尾¶

把 Markdown + 封面直推到公众号草稿箱，让智能体的发文链路更完整。目录页：https://www.skillhub.cn/plugins/xiaoziwenjie-code/dsh-plugin-wechat-publisher；GitHub：https://github.com/xiaoziwenjie-code/dsh-plugin-wechat-publisher