它能做什么

三步开始使用

1. 安装插件

从 最新版发布页面 下载以下三个文件：

• main.js
• manifest.json
• styles.css

将它们放进仓库中的插件目录：

.obsidian/plugins/wechat-multi-publisher/

然后打开 Obsidian → 设置 → 第三方插件，启用「WeChatPB」。

插件目录和内部标识继续保留 wechat-multi-publisher，这是为了让旧版本能够正常升级并保留已有设置，并不是尚未改名。

2. 添加公众号

打开 Obsidian → 设置 → WeChatPB → 添加账号，填写公众号的 AppID 与 AppSecret。

这些信息可在微信公众平台的「设置与开发 → 基本配置」中获取。发布前还需要将当前服务器或代理的出口 IP 加入公众号 IP 白名单。

3. 排版并发布

1. 打开一篇 Markdown 笔记。
2. 打开侧边栏中的 WeChatPB 面板。
3. 选择排版主题并点击「预览」。
4. 选择封面和需要发布的公众号。
5. 点击「发布」，文章会进入微信公众号草稿箱。

你仍然可以在微信公众平台里继续编辑、检查并正式群发。

内置排版主题

首次安装会直接使用「绿白清简」。14 套主题已经打包在插件中，不需要下载本地 CSS，也不需要先点击“保存并应用”。

「绿白清简」和「蓝白案例」的二级标题会按照文章顺序显示 TITEL 01、TITEL 02、TITEL 03……

使用自己的排版

内置主题足够直接使用。只有在需要学习或导入自己的排版时，才需要在设置中开启「启用自定义排版」。

1. 在 Obsidian 仓库中创建一个文件夹，例如 css-themes/。
2. 放入 .css 文件，或放入包含 CSS 代码块的 .md 文件。
3. 在 WeChatPB 设置中选择该文件夹。
4. 返回发布面板，即可选择自定义主题并预览。

Markdown 主题文件可以这样编写：

# 我的自定义主题

```css
.note-to-mp h1 {
    color: #333333;
    border-bottom: 2px solid #07c160;
}

.note-to-mp p {
    color: #555555;
    line-height: 1.8;
}
```

不知道如何写 CSS 时，可以在插件设置中打开「查看 AI 排版规范」，复制完整示例给 AI，再补充你的品牌色、文章类型和参考风格。

使用前须知

• 插件仅支持 Obsidian 桌面端。
• 建议使用已认证的微信公众号；不同账号类型拥有的接口权限可能不同。
• AppSecret、访问令牌和代理密码不会写入 data.json，请仍然避免在截图、日志和公开问题中泄露它们。
• 正文图片会在发布时压缩并上传到微信公众号素材库。
• 如果「预览」没有反应，请先确认当前打开的是 Markdown 笔记。
• 如果「发布」按钮不可点击，请先完成账号配置、连接检测并勾选至少一个可用账号。

隐私与网络请求

插件只会在测试账号、检查状态、上传素材或创建草稿时请求微信公众平台接口；测试代理或查看出口 IP 时会请求 api.ipify.org。如果你配置了代理，相应请求会经过该代理。

文章正文和图片不会发送到插件作者控制的服务器。账号密钥由 Obsidian SecretStorage 保存在本机。

开发与反馈

本地构建：

npm install
npm run build

发现问题时，请通过 问题页面 提交，并附上 Obsidian 版本、WeChatPB 版本、操作系统、复现步骤和已经脱敏的错误信息。

参与开发前请阅读贡献指南；安全漏洞请按照安全说明私下反馈。