如何用Obsidian+VSCode生成文案排版并发布到公众号

本教程将教你如何配置环境，通过简单的指令让AI自动搜集热点、撰写文章、生成配图及封面，并一键发布到微信公众号。

第一阶段：环境搭建 (基础软件安装)

在开始之前，我们需要安装以下三个核心软件。

1. 安装 Obsidian (知识库)

Obsidian 是一个强大的本地笔记软件，我们将用它作为存放文章和素材的"仓库"。

下载地址： https://obsidian.md
操作： 下载并安装即可。

2. 安装 VSCode (代码编辑器)

VSCode 是我们将要运行自动化指令的"控制台"。

下载地址： https://code.visualstudio.com/download
操作： 下载并安装。

3. 安装 Node.js (运行环境)

这是运行自动化脚本必须的基础环境。

Windows 用户：
- 下载地址： https://nodejs.org/en/download
- 操作： 下载下方的独立安装包（LTS版本）并安装。
MacOS 用户：
- 建议不要直接下载安装包，推荐通过 Homebrew 安装（更方便管理）。
- 先安装 Homebrew：https://brew.sh/
- 然后在终端运行：brew install node

4. 安装 uv (Python环境管理)

截图中提到了 uv，这是运行部分Python脚本（如文生图）所需的工具。

安装方法： 打开终端（Windows下是PowerShell，Mac下是Terminal），输入以下命令安装：

codeBash
复制代码
```
pip install uv
```
(注：前提是你电脑里需要有基础的Python环境)

第二阶段：项目初始化

1. 创建文档仓库

打开 Obsidian。
点击"创建新的仓库 (Create new vault)"。
找一个你喜欢的硬盘位置，新建一个文件夹（例如命名为 AI-WeChat-Writer）。
记住这个文件夹的路径。

2. 用 VSCode 接管仓库

打开 VSCode。
点击菜单栏的 File -> Open Folder... (打开文件夹)。
选择刚才在 Obsidian 里创建的那个文件夹 (AI-WeChat-Writer)。

3. 配置 GitHub Copilot

这是整个流程的"大脑"。

在 VSCode 左侧扩展商店（Extensions）搜索 GitHub Copilot 并安装。
安装后根据提示登录你的 GitHub 账号。
注意： GitHub Copilot 是付费服务，但通常有免费试用额度，请确保你的账号已获得授权。

第三阶段：安装 AI Skills (核心插件)

在 VSCode 中，使用快捷键 Ctrl + J (Windows) 或 CMD + J (Mac) 打开底部终端 (Terminal)，依次运行以下三条命令来安装所需的 AI 技能：

1. 安装热点发现技能

用于自动搜集新闻资讯。

codeBash

复制代码

npx skills add huozhong-in/news-aggregator-skill

2. 安装文章撰写技能

用于调用 Claude 模型写文章。

codeBash

复制代码

npx skills add iamzhihuix/happy-claude-skills --skill wechat-article-writer

3. 安装配图及发布技能

这是最全的一步，包含文章配图、封面生成、Markdown转公众号HTML格式以及发布功能。

codeBash

复制代码

npx skills add jimliu/baoyu-skills \
  --skill baoyu-article-illustrator \
  --skill baoyu-cover-image \
  --skill baoyu-image-gen \
  --skill baoyu-infographic \
  --skill baoyu-post-to-wechat \
  --skill baoyu-markdown-to-html

第四阶段：配置 API Key

为了让 AI 能画图和写作，你需要配置大模型的 API Key。

在 VSCode 的文件资源管理器中（也就是你的Obsidian仓库目录），新建一个文件夹，命名为 .baoyu-skills。
在该文件夹内，新建一个文件，命名为 .env。

打开 .env 文件，填入你的 API Key（以下三选一即可，根据你拥有的账号）：

codeEnv

复制代码

# 示例格式，请替换为真实Key
GEMINI_API_KEY=你的Key
# 或者
OPENAI_API_KEY=你的Key
# 或者
DASHSCOPE_API_KEY=你的通义万象Key

第五阶段：开始使用

1. 启动代理 (如果使用海外模型)

如果你在国内使用 Claude 或 OpenAI，需要在 VSCode 终端先设置代理（端口号 7890 请根据你自己的梯子软件设置进行修改）：

codeBash

复制代码

# Mac/Linux
export HTTP_PROXY=http://127.0.0.1:7890 && export HTTPS_PROXY=http://127.0.0.1:7890

# Windows PowerShell
$env:HTTP_PROXY="http://127.0.0.1:7890"; $env:HTTPS_PROXY="http://127.0.0.1:7890"

2. 发送指令

现在，你可以在 VSCode 的 Copilot 对话框（或者通过终端运行 Agent）发号施令了。

场景一：搜集热点

在 Copilot 中输入：

"看一下今天的硅谷热点新闻，整理一份md到 Daily/ 目录下，按日期规则存放。"

触发关键词： /news

场景二：写文章并发布

当你已经有了素材，可以输入：

"请根据 $刚才生成的md文件$ 写一篇公众号文章，生成配图和封面，并发布。"

触发关键词： /wechat (调用写作)、/baoyu (调用配图和发布)

3. 查看结果

生成的文章会自动保存在你的 Obsidian 目录中。
生成的图片会保存在附件目录。
如果配置无误，文章将直接保存为草稿或发布到你的微信公众号后台。

💡 小贴士：

Obsidian 的作用： 你可以随时打开 Obsidian 查看生成的 Markdown 文档，进行人工微调和归档，它相当于你的本地 CMS（内容管理系统）。
报错处理： 如果遇到网络连接错误，请务必检查 HTTP_PROXY 设置是否与你的代理软件端口一致。