geekjourneyx/dsh-md2wechat

dsh-md2wechat

从 DeepSeek Harness 为微信准备 Markdown 文章，提供可审查、需审批的步骤。

Release
License: MIT
md2wechat CLI

dsh-md2wechat 是一个可安装的 DeepSeek Harness 插件，用于构建不可变的文章修订版本、改进它、规划图片、生成签名预览，并导出已审查的 HTML。可选工具可以通过 md2wechat 配置的图片服务生成缺失的图片，并创建未发布的微信草稿。

它不是 md2wechat CLI、图片模型或发布机器人。该插件及其 GitHub Release 不包含也不安装 md2wechat，并且没有任何命令可以发布或群发文章。

安装

要求：

- 已安装 DeepSeek Harness，且 dsh 和 pnpm 可用。
- Node.js ^22.19.0 或 >=24.0.0。
- 单独安装的 md2wechat CLI，版本必须恰好为 3.3.0。
- 在 profile 启动前，将 MD2WECHAT_BINARY_PATH 设置为该可执行文件的绝对路径。

将预构建的、与平台无关的插件归档安装到 DSH profile 中：

dsh plugin --profile web add https://github.com/geekjourneyx/dsh-md2wechat/releases/download/v1.0.0/geekjourneyx-dsh-md2wechat-1.0.0.tgz

确认依赖和组合后的配置：

dsh plugin --profile web why @geekjourneyx/dsh-md2wechat
dsh --profile web --dump-config

Release 中仅包含该插件。请单独安装 md2wechat 3.3.0，将 MD2WECHAT_BINARY_PATH 设置为其可执行文件的绝对路径，然后启动 profile。如果可执行文件缺失、报告了其他版本或缺少所需命令，插件激活会在注册工具之前失败。

凭据与配置

捆绑的 patch 会读取 MD2WECHAT_BINARY_PATH，并使用以下默认 DSH 凭据引用：

| 引用 | 用途 |
|---|---|
| MD2WECHAT_API_KEY | 签名预览验证、预览生成、导出验证和草稿创建 |
| WECHAT_APPID | 备用图片上传和未发布草稿创建 |
| WECHAT_SECRET | 备用图片上传和未发布草稿创建 |
| IMAGE_API_KEY | 通过 md2wechat 配置的图片服务进行备用生成 |

凭据引用是由 DSH 解析的名称；不要将凭据值放入 patch 或提示词中。

插件行可以在后续的 profile patch 中被替换。由于 DSH patch 会替换该行的完整 config，因此在更改功能开关时，需要重新声明可执行文件和凭据引用。例如，保留草稿创建但禁用备用图片生成：

- id: dsh-md2wechat
config:
binaryPath: !!js process.env.MD2WECHAT_BINARY_PATH
credentialRefs:
MD2WECHAT_API_KEY: MD2WECHAT_API_KEY
WECHAT_APPID: WECHAT_APPID
WECHAT_SECRET: WECHAT_SECRET
IMAGE_API_KEY: IMAGE_API_KEY
enableWechatWriteTools: true
enableFallbackImageTool: false

将此行保存到配置文件的 cordis.patch.yml 中。后续层会覆盖捆绑包的默认值。

工具与功能开关

成功激活后，六个基础工具始终可用：

| 工具 | 用途 |
|---|---|
| md2wechat_doctor | 检查已配置的 CLI、版本、能力以及提供程序就绪状态，且不暴露凭据 |
| md2wechat_start_article | 将工作区中的 Markdown 文件复制为新的不可变文章修订版本，且不更改源文件 |
| md2wechat_improve_article | 为当前修订版本准备建议或重写请求，且不修改其字节内容 |
| md2wechat_plan_images | 创建可重放的图片计划，无需凭据、生成或上传 |
| md2wechat_preview | 在一次性批准后创建会过期的签名 HTML 预览 |
| md2wechat_export | 将当前签名预览 HTML 的精确副本复制到已批准的本地绝对目标路径 |

可选工具严格遵循这两个开关：

| enableWechatWriteTools | enableFallbackImageTool | 附加工具 |
|---|---|---|
| false | false 或 true | 无 |
| true | false | md2wechat_create_draft |
| true | true | md2wechat_create_draft、md2wechat_generate_images |

两个开关默认均为 true。md2wechat_create_draft 会根据精确的签名预览和已验证的上传图片创建一篇未发布的微信草稿。仅当需要处理图片且当前 DSH 代理没有其他图片生成能力时，才必须使用 md2wechat_generate_images。

工作流

请按以下顺序操作：

1. md2wechat_start_article 或 md2wechat_improve_article
2. md2wechat_plan_images
3. md2wechat_preview
4. md2wechat_export，或在启用时使用 md2wechat_create_draft

当文章需要图片且代理没有其他图片生成能力时，请在规划之后、生成最终预览或草稿之前运行 md2wechat_generate_images。

示例提示词：

Prepare article.md as a WeChat article, plan the required images, let me review the signed preview, then export the approved HTML. Use md2wechat fallback image generation only if you have no other image-generation capability.

批准与副作用

- 预览需要一次性批准，之后 md2wechat 才会通过已配置的提供程序生成签名预览 HTML。它会写入修订版本本地的预览产物。
- 导出需要一次性批准，且该批准绑定到精确的签名 HTML 和绝对目标路径。它不执行任何 CLI 或网络调用，但会写入已批准的本地文件。
- 回退生成需要一次性批准。它可能会产生图片提供程序的使用费用、下载结果，并在保存已验证的本地产物之前将其上传到微信素材存储。当仍有工作时，它会作为后台任务运行。
- 草稿创建需要一次性批准。它使用已上传的正文图片和一张已验证的封面来创建未发布的微信草稿。它绝不会发布或群发。

规划、预览、导出、生成图片和创建草稿是各自独立的决策。预览或导出并不意味着批准生成、上传或创建草稿。

兼容性与安全性

- 插件版本：1.0.0。
- 外部 md2wechat CLI：必须恰好为 3.3.0；其他版本将激活失败。
- Node.js：^22.19.0 或 >=24.0.0。
- 插件归档文件与平台无关。外部 CLI 的平台支持由 CLI 分发方负责。
- 修订产物默认保留在会话工作区内的 .dsh/md2wechat 中。
- 图片计划和草稿操作的权限默认保留在工作区和临时目录之外的 $DSH_HOME/plugins/dsh-md2wechat 中。当该默认路径与工作区重叠时，请配置一个绝对的外部 stateDir。
- 凭据仅在需要它们的已批准操作中被解析。插件不会打印凭据值，也不会将其存储在文章产物中。
- md2wechat 是受信任的外部可执行文件。请单独审查并安装它；插件不会对其进行沙箱隔离或更新。

故障排除

插件未注册任何工具。 请检查 MD2WECHAT_BINARY_PATH 是否为绝对路径、是否指向可执行的 md2wechat 3.3.0，以及 md2wechat version --json 和 md2wechat capabilities --json 是否成功。

预览、导出、图片任务或草稿报告缺少凭据。 将指定的凭据添加到 DSH，并保留相应的 credentialRefs 条目。不要将凭据粘贴到提示词或补丁中。

回退生成不可用。 enableWechatWriteTools 和 enableFallbackImageTool 都必须为 true。当有其他可用的代理图片能力时，优先使用它。

状态目录被拒绝。 请使用会话工作区、产物目录和平台临时目录之外的绝对私有目录。

草稿结果未知。 对于已启动但未获得经过身份验证的完成结果的操作，插件会阻止自动重试，以防止意外产生重复草稿。在决定任何手动恢复之前，请检查微信账号。

开发

pnpm install --frozen-lockfile
pnpm test
pnpm typecheck
pnpm lint
pnpm run check:boundaries
pnpm run build
pnpm run pack:check

测试套件使用受控的测试夹具和已安装包的验收测试，不会进行付费提供商、图片生成、微信、发布、群发或浏览器调用。

许可证

MIT © 2026 geekjourneyx。当前版本请参见 CHANGELOG.md。