WindPost

基于 Obsidian 的个人多渠道内容发布工作台。

WindPost 以本地 Obsidian vault 为唯一内容源，将同一篇 Markdown 笔记转换并发布到 Blog 和微信公众号。项目目标不是建设一个通用社交媒体管理平台，而是为个人长期内容创作提供一条可控、可维护、可迁移的发布链路。

English

Overview

WindPost is a desktop Obsidian plugin for publishing the current Markdown note to a GitHub-backed blog or to a WeChat Official Account draft. Obsidian remains the single source of truth: WindPost prepares channel-specific content, previews the result, asks for confirmation, and then performs the selected API operation. It never sends a WeChat mass message.

WindPost currently supports macOS and requires Obsidian Desktop 1.12.0 or later.

Installation

Install WindPost from Settings → Community plugins → Browse and search for WindPost. For manual installation, download main.js, manifest.json, and styles.css from the latest GitHub release, place them in <vault>/.obsidian/plugins/windpost/, reload Obsidian, and enable WindPost under Community plugins.

Basic usage

1. Open the WindPost publishing center and select Initialize on first use. This creates WindPost.base, a WindPost/ content folder, and two editable examples.
2. Open a Markdown note, select the Blog or WeChat channel, and review the preview.
3. Configure the selected channel in Settings → WindPost, then use its connection test before the first publish.
4. Confirm the publish action. Blog publishing creates a GitHub commit. WeChat publishing uploads article images and a cover, then creates a draft through the official WeChat API. Final WeChat sending remains a manual action in WeChat.

Accounts, network use, and privacy

• Blog publishing requires a GitHub repository and a fine-grained token with Contents: write access. Requests are sent directly to api.github.com.
• WeChat publishing requires an Official Account AppID, AppSecret, API permissions, and an API IP allowlist entry. Requests are sent directly to api.weixin.qq.com.
• Public external images referenced by an article are downloaded from their original URLs before being uploaded to WeChat.
• GitHub tokens and WeChat AppSecrets are stored with Obsidian SecretStorage. WindPost has no hosted relay, telemetry, advertising, payment, or browser automation.
• WindPost reads only the active note and its referenced attachments. Initialization creates missing files inside the vault and does not overwrite existing content.

See the detailed user guide for complete setup and troubleshooting. Report security issues privately through GitHub Security Advisories.

文档

• 使用说明：安装、初始化、公众号配置与发布
• 公众号自定义模板规范
• 开发者自动发版流程

安装

WindPost 目前面向 macOS 上的 Obsidian Desktop 1.12.0 及以上版本。

• 在「设置 → 第三方插件 → 浏览」中搜索 WindPost 安装；
• 如需手动安装，可从 GitHub Releases 下载 main.js、manifest.json、styles.css，放入 Vault 的 .obsidian/plugins/windpost/ 后重新加载 Obsidian；
• 开发者也可以获取源码后执行项目中的构建与测试脚本。

升级前建议保留 Vault 备份。初始化只补齐缺失文件，不会覆盖已有内容。

背景

过去的内容生产链路以 Notion 为知识库，并依赖多个工具分别发布公众号和 Blog。随着知识库迁移到 Obsidian，原有工具出现了几个问题：

• 内容源和发布工具分散，渠道之间缺少统一状态；
• 同一篇文章需要被不同插件重复解析和处理；
• 浏览器自动化与内容转换耦合，页面变化后难以维护；
• Blog 仍依赖 Notion，尚未真正以 Obsidian 为发布源。

现有项目中，wepost 已验证部分 Obsidian Markdown 渲染与平台预览能力；windscroll 已实现 Astro 静态 Blog。WindPost 在这些验证结果上重新划分边界，建立统一的发布工作流。

产品定位

WindPost 是 Obsidian 中唯一面向作者的多渠道发布入口。作者继续在 Obsidian 中写作，完成后从当前笔记打开 WindPost，分别处理 Blog、 微信公众号。

WindPost 不是独立 CMS，也不接管写作和知识管理。它只负责把一篇已经写好的 Obsidian 笔记变成各渠道可发布的内容，并完成发布前确认、外部交互和结果反馈。

WePost 不再作为 Obsidian 插件继续使用。它只作为现有 Markdown 渲染与平台预览 能力的迁移来源，WindPost 不依赖 WePost 运行。

使用方式

首次打开发布中心时，点击「一键初始化」。WindPost 会创建：

• 根目录 WindPost.base 内容入口；
• WindPost/ 内容目录；
• 通用长内容、Her 完整文章两篇示例；
• WindPost/Attachments/Her/ 中的四张 Her 示例配图。

初始化只补齐缺失文件，不覆盖用户已有内容，也可以从命令面板或设置页重复执行。 示例文章和实际文章不分目录，均直接位于 WindPost/；用户可以直接改写、重命名或 删除示例。WindPost/Attachments/ 只保存插件自带示例资源，用户日常插入的附件仍 遵循自己的 Obsidian 附件目录设置。 之后的典型流程围绕当前笔记展开：

1. 从 WindPost.base 选择示例并改写，或在 WindPost/ 中新建文章；
2. 打开 WindPost，选择 Blog 或公众号；
3. 查看该渠道的最终效果和必要提示；
4. 确认后生成或提交到对应渠道；
5. WindPost 展示每个渠道的结果，失败渠道可以单独重试。

不同渠道可以有不同的确认方式：Blog 展示将要同步的文章与附件，公众号预览最终 富文本。WindPost 默认停在不可逆操作之前，由作者完成最终确认。

WindPost.base 的基础契约只有三个字段：stage 表示创作阶段，channels 表示计划 发布渠道，published_to 记录已经完成的渠道。标题从文件名或一级标题推导，日期使用 文件时间或发布时生成；账号名称、作者等账户信息放在插件设置中。其他 Properties 只有在真实发布需求出现时才添加。

项目边界

WindPost 负责

• 读取当前 Obsidian 笔记、metadata、wikilink 和本地附件；
• 为 Blog 和公众号生成各自需要的内容；
• 提供渠道预览、发布前检查、人工确认和结果反馈；
• 执行 Git 或平台 API 等发布动作；
• 保存插件配置、临时产物和必要的发布记录。

WindScroll 负责

• Blog 的页面结构、视觉样式、站点配置和 Astro 构建；
• 接收 WindPost 导出的公开文章与附件；
• 通过 Git 和 Vercel 完成 Blog 部署。

WindScroll 可以根据发布链路需要直接调整，不把当前 Notion adapter 或既有内容模型 当成固定边界。私人 vault 不进入 WindScroll 仓库。

外部平台负责

• 微信公众号的账号、草稿与最终线上内容；
• 平台自身无法稳定自动化的确认步骤。

平台页面变化造成的适配问题应隔离在对应发布实现中，不影响 Obsidian 内容读取和 其他渠道。

隐私与安全

• WindPost 只读取用户主动打开并预览/发布的笔记及其中引用的本地附件；只有用户点击 初始化时才会在 Vault 中补齐 WindPost.base、示例文章与示例配图；
• Blog 发布会连接 api.github.com，公众号发布会连接 api.weixin.qq.com；文章引用 公开外部图片时，插件还会请求对应图片地址；
• GitHub Token 与微信公众号 AppSecret 由 Obsidian SecretStorage 保存，不写入普通 插件配置、Markdown 或仓库；
• WindPost 不提供自建中转服务器，不收集遥测，不展示广告，不包含付费或推广机制；
• WindPost 不安装浏览器扩展，也不控制微信公众号后台。它只调用微信官方 API 创建 草稿，最终群发必须由用户人工确认。

安全问题请通过 GitHub 仓库的 Security Advisory 私下报告；一般缺陷和功能建议使用 GitHub Issues。

初步实现分层

Current Obsidian Note
    -> Note Reader
    -> Channel Preparation
        -> Blog Content     -> WindScroll / Git / Vercel
        -> WeChat Content   -> HTML / Draft API

实现可以按实际开发逐步拆分，暂不要求固定的数据模型或目录层级。需要长期保持的 只有三类职责：

• 笔记读取：理解当前笔记及其本地资源；
• 渠道准备：生成各渠道最终需要的内容和预览；
• 渠道交付：封装 Git 与 API 等外部交互。

与 WindScroll 的关系

WindPost 是发布端，WindScroll 是 Blog 渲染与部署端，二者保持为独立项目。

WindPost 只把用户确认发布的文章及相关附件通过 GitHub API提交到 WindScroll， 由 GitHub commit 触发 Vercel 静态站部署。使用 WindPost 不要求本地安装或 clone WindScroll，私人 vault 也不会进入公开仓库。

第一阶段范围

• 用 WindPost 替换 Obsidian 中的 WePost 插件入口；
• 打通 Obsidian 到 WindScroll 的静态 Blog 发布闭环；
• 迁移并整理现有公众号 HTML 渲染能力；
• 默认保留最终人工确认，不自动执行不可逆发布。

暂不处理

• 团队协作、审批流和内容日历；
• 多用户、多租户或云端 CMS；
• 批量管理整个 vault 的内容后台；
• 数据分析、评论管理和账号运营；
• 知乎、掘金等尚未进入真实发布流程的渠道；
• 为未来渠道提前建设通用插件系统。

项目状态

已完成第一轮工程初始化：

• WindPost 已作为独立 Obsidian 插件构建并接入当前 vault；
• WePost 的 Markdown 渲染能力已迁入，知乎与掘金入口已移除；
• 发布中心已拆分为 Blog 和公众号两个独立渠道；
• Blog 预览不会修改 WindScroll 或其他外部状态；
• 用户确认后，Blog 文章与附件通过 GitHub Git Database API组成一个 commit；
• GitHub Token 使用 Obsidian SecretStorage 保存；
• WindScroll 已支持 Notion 与 WindPost 文章并存，同 slug 时使用 WindPost 版本；
• 公众号已接入微信官方 API：自动上传正文图片、将封面保存为永久素材并创建草稿；
• 公众号最终群发保留人工确认，不由 WindPost 自动执行。

公众号可在 Properties 中使用以下可选字段：

• wechat_cover：本地图片 wikilink、vault 路径或公开图片 URL；未设置时使用正文首图；
• wechat_author、wechat_digest、wechat_source_url：作者、摘要和「阅读原文」地址；
• wechat_open_comment、wechat_fans_only_comment：评论开关。

首次使用公众号发布前，需要配置 AppID、AppSecret 与 API IP 白名单。具体入口、 文章字段、发布步骤和故障排查见使用说明。

创建草稿时，正文中的本地或外部图片先通过官方素材接口上传并替换为微信图片 URL； 封面单独上传为永久素材，通过 thumb_media_id 绑定到草稿，不会插入正文。WindPost 只创建草稿，最终群发仍由用户在微信公众号后台人工确认。

公众号排版开箱内置 Anthropic 和 Her 两个模板，可在公众号预览区直接切换； 初始化提供对应的完整示例，普通用户无需自行设计。高级用户仍可让 Agent 按 公众号模板规范 创建模板，并放到 Vault 的 WindPost/Templates/WeChat/<template-id>/。模板创建 Skill 位于 skills/create-windpost-wechat-template。

需要刊头的 editorial 模板从 WindPost 设置读取公众号名称和默认作者，不要求每篇 文章重复填写。前言、说明、阅读要点、Podcast 与结尾卡片可使用模板规范中的 WindPost 语义块；这些标记由 Agent 生成，不增加必填 Properties，并可在普通模板中 降级为可读内容。

Her 示例为完整文章「我花了两年，才走出那段狼狈的日子」及四张配图，用于 展示刊头、PREFACE、六个章节、说明卡片、引语、阅读列表、Podcast、图片裁切和结尾 卡片。工作区初始化会自动创建该示例，也可从命令面板单独执行「创建并预览 Her 示例文章」；重复执行不会覆盖已有笔记或配图。内置图片已压缩并移除 EXIF/GPS 元数据。

当前版本已经完成 Blog 提交与微信公众号官方 API 草稿创建闭环；不同账号权限和网络 环境下的兼容问题会继续通过 Issue 跟踪。