md2wechatDSH / INSTALLATION
dsh-md2wechat 安装与配置
按 2.0.0-rc.3 预发布版整理，核验于 2026-10-28。先检查兼容条件，再完成第一篇文章的预览。
本页依据插件 README 与包声明整理安装步骤；本轮官网核验未在用户环境安装插件，也未执行真实公众号投递。查看上游完整说明
1. 核对环境
- DSH 宿主与网页客户端使用相互匹配的 0.2.0-rc.2 或 0.2.1-rc.2
- Node.js ^22.19.0 或 >=24.0.0；dsh 命令可用
- 通过 npm 启动 DSH 时需安装 pnpm；打包宿主可能已内置
- Markdown 与本地图片放在当前会话工作区；保留原有 CLI 配置
CLI 3.3.0 和 3.8.0 是插件回归目标，不是唯一允许的版本。插件启动时检查 v1 JSON 协议及必需命令，不能只看版本号。
获取 DeepSeek Harness2. 分别安装 CLI 和插件
尚未安装 CLI 时运行下面的安装命令；已有兼容版本可继续使用。
npm install -g @geekjourneyx/md2wechatmd2wechat version --json
md2wechat capabilities --json从发布页下载 geekjourneyx-dsh-md2wechat-2.0.0-rc.3.tgz 与 SHA256SUMS，放在同一目录。插件通过 GitHub 发布包分发，前面的 npm 命令只安装 CLI。
shasum -a 256 --check SHA256SUMSsha256sum --check SHA256SUMS选择适合系统的校验命令，确认成功后，在文件所在目录安装。
dsh plugin --profile web add ./geekjourneyx-dsh-md2wechat-2.0.0-rc.3.tgzdsh plugin --profile web why @geekjourneyx/dsh-md2wechat确认显示 2.0.0-rc.3 后重启对应配置的 DSH，让宿主与网页客户端加载同一版本。插件从宿主进程的 PATH 查找 md2wechat；找不到时，按 README 的 binaryPath 配置说明处理，并从同一终端重启。
3. 按用途配置凭据
由你在 DSH 凭据服务中添加引用，不要把密钥贴进对话或写进文章。
| 用途 | 需要的引用 |
|---|---|
| 排版预览与导出 | MD2WECHAT_API_KEY |
| 上传微信素材、保存草稿 | WECHAT_APPID、WECHAT_SECRET |
| 可选 CLI 备用生图 | IMAGE_API_KEY，以及相应服务配置 |
普通 HTML 导出不需要公众号凭据或封面。保存草稿需封面和对应公众号配置；插件使用 DSH 的这组凭据，不会自动采用 CLI 的命名账号列表。
微信接口还要求配置 IP 白名单。固定出口服务的开通条件须单独核对；插件不会替你修改公众号后台设置。
4. 完成第一次预览与交付
请打开当前工作区的 article.md，保留文章事实和引用，给出标题与润色建议，并打开文章供我调整。先生成排版预览；上传图片、导出或保存公众号草稿前，分别让我确认。- 点击「打开文章」或「预览与调整文章」，检查标题与正文。
- 选择主题与图片，生成预览；修改后重新预览并审阅。
- 只需本地文件时，导出已审阅的 HTML。
- 需要草稿时，选择封面，确认准备微信素材，再核对最终预览，点击「确认保存到草稿箱」。
- 到公众号后台核对草稿内容。正式发布由你在后台确认。
插件只保存未发布草稿，不发布、不群发；当前使用 DSH 中配置的一组公众号凭据，不提供界面内多账号切换或批量投递。
遇到问题时检查什么
插件未启用
核对宿主与客户端版本、CLI 路径和能力检查输出，重启对应配置。不要强制安装不兼容版本。
预览失败或过期
检查排版 Key、网络和文章输入。失败后保留的旧预览不能作为当前版本交付。
草稿结果不明
先到公众号后台核对，再决定恢复操作；不要重复创建。检查公众号凭据、封面与 IP 白名单。
插件 README 记录的最近验证使用 DSH 0.2.1-rc.2、CLI 3.8.0、本地排版测试服务与模拟微信写入，并在真实宿主中检查界面；不代表付费生图或真实公众号投递已验证。
查看插件排错说明