geekjourneyx/obsidian-md2wechat

MD2WeChat Publisher – 是什么

MD2WeChat Publisher 是一个 Obsidian 桌面端插件，允许你在 Obsidian 中撰写 markdown 文章，调用一个 支持 AI 的 Agent（如 Claude、Codex、WorkBuddy）将其格式化为 WeChat 适配样式，侧边预览效果，并通过外部 md2wechat CLI 工具将格式化后的内容作为 WeChat 公众号草稿发布。

核心任务——markdown 转 WeChat HTML、图片上传、草稿创建——由独立的 md2wechat CLI 工具（通过 npm 全局安装）完成。插件本身仅提供 Obsidian 内的 UI 和与 Agent 及 md2wechat 技能通信的胶水代码。

---

核心功能

功能	工作方式
边写边预览	在笔记旁边打开「公众号排版」面板。Agent 完成格式化后，预览将显示将发送至 WeChat 的精确布局。
Agent 无关	插件不自带 AI 服务。任何支持标准 obsidian-md2wechat 技能的本地 Agent（如 Claude Code、Codex、WorkBuddy、ZCode 等）均可使用。
发布前确认	你可选择目标公众号、封面图、标题、作者和摘要。只有点击 创建草稿 后，插件才会调用 md2wechat 在 WeChat 上实际创建草稿。
版本感知草稿	插件会记录已发送的文章、账号和版本，以便查看历史草稿并避免重复提交。
实时刷新	编辑源 markdown 后，点击 刷新布局 会以相同主题/字体设置重新运行 Agent，更新预览但不创建新草稿。

---

安装流程（详见 README）

1. 安装 md2wechat CLI

   npm install -g @geekjourneyx/md2wechat
   md2wechat version --json
   md2wechat config init --json   # 运行向导
   md2wechat config validate --json
   

   CLI 必须至少为版本 3.5.0。
2. 添加 Obsidian 插件
   • 从最新 GitHub 发布版下载 zip（非源码归档）。
   • 解压后将 md2wechat-publisher 文件夹放入 <vault>/.obsidian/plugins/。
   • 重启 Obsidian，在 设置 → 第三方插件 中启用 MD2WeChat Publisher。
3. 连接 Agent
   • 启用 Obsidian 官方命令行功能。
   • 将插件包中的 skills/obsidian-md2wechat 目录复制到 Agent 的技能文件夹中。
   • 确保 Agent 可执行 md2wechat 技能（其内部会调用 CLI）。

---

典型工作流

1. 打开你想要发布的 markdown 笔记。
2. 打开 公众号排版 侧边面板。
3. 向 Agent 说话（或输入）：“排版 Obsidian 当前文章，完成后展示给我。” — Agent 执行 md2wechat 技能，转换 markdown，上传图片，并返回预览。
4. 通过面板的 更多 菜单调整主题或字体大小；如需可复制格式化后的 HTML。
5. 满意后点击 创建草稿，选择 WeChat 账号和封面图，确认元数据，插件调用 md2wechat 在 WeChat 后端创建草稿。
6. 面板现在显示草稿记录（账号、时间戳、版本）。后续可刷新或重新格式化文章，而不会创建重复草稿。

---

兼容性与限制

• 支持的系统 – 已在 macOS 上测试；Windows/Linux 尚未验证。
• Obsidian 版本 – 需要桌面版 1.12.7+；移动端客户端不支持。
• Agent 要求 – 必须支持本地命令执行和 obsidian-md2wechat 技能。插件不捆绑任何特定 Agent。
• 插件中无 API 密钥 – 所有凭证均由 md2wechat CLI 配置管理。

---

开发与贡献

• 使用 npm ci 构建，npm run check 检查，npm run package 打包（需本地有 md2wechat CLI）。
• 发布自动化：推送标签（如 v2.0.0）会触发 GitHub Actions，生成 zip 并上传至发布页。
• 贡献遵循项目 AGPL-3.0-Only 许可证，并遵守 dev.md、RELEASE.md 和 AGENTS.md 中的指南。

---

TL;DR

MD2WeChat Publisher 是连接 Obsidian、AI Agent 与 WeChat 公众号发布流程的桥梁。用 markdown 写作，让本地 Agent 格式化，Obsidian 内预览，经手动确认后推送为 WeChat 草稿——整个过程无需在插件中暴露 API 密钥。