# obsidian_sync_wechat

**Repository Path**: xiaoa7/obsidian_sync_wechat

## Basic Information

- **Project Name**: obsidian_sync_wechat
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-10
- **Last Updated**: 2026-06-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 微信公众号文章同步插件使用文档

## 快速开始

### 1. 关注公众号

扫码或搜索关注微信公众号 **「开发技术合集」**

### 2. 获取 OpenID

在微信中向公众号发送以下任意指令：
- `openid`
- `OpenID`
- `我的ID`
- `我的openid`

公众号会回复你的 OpenID，**复制保存好**！

### 3. 安装插件

1. 将整个 `wechat-sync` 文件夹复制到你的 Obsidian Vault 的插件目录：
   ```
   <你的库>/.obsidian/plugins/wechat-sync/
   ```
2. 重启 Obsidian
3. 在「设置」→「社区插件」→「已安装插件」中找到「微信公众号文章同步」，点击启用

### 4. 配置插件

打开插件设置，填写以下内容：

| 配置项 | 说明 | 示例 |
|--------|------|------|
| 服务器地址 | 后端服务地址 | `https://ob-sync.jianyu360.cn` |
| OpenID | 刚才从公众号获取的 | `ogff77DS9va70rc32VB8O5AdgDS0` |
| 同步文件夹 | 文章保存位置 | `微信文章` |

**⚠️ 重要提醒：服务器地址后面不要有空格！**

### 5. 测试连接

点击设置里的「测试连接」按钮，显示连接成功就OK了！

## 使用方法

### 收藏文章

1. 在微信里阅读一篇公众号文章
2. 点击右上角菜单 →「分享给朋友」
3. 选择分享给 **「开发技术合集」** 公众号
4. 公众号会回复「收到文章，正在为你抓取并保存...」

### 同步到 Obsidian

1. 在 Obsidian 左侧功能区点击微信同步插件的图标
2. 或者按 `Ctrl/Cmd + P` 呼出命令面板，输入并执行「同步微信文章」
3. 文章会自动保存到你配置的文件夹！

## 文件命名规则

文件命名格式：`YYYYMMDD-文章标题.md`

示例：
```
20260610-如何使用Go语言开发Web应用.md
```

## 文章内容格式

每篇文章会自动添加 Frontmatter：

```yaml
---
title: 文章标题
date: 2026-06-10
source: https://mp.weixin.qq.com/...
author: 公众号名称
category: 微信文章
tags: [未分类]
---

# 文章标题

（Markdown 内容）

---

*原文链接: https://mp.weixin.qq.com/...*
*收藏时间: 2026-06-10*
```

## 常见问题

### Q: 点击同步没反应？
A: 检查：
1. 后端服务是否正常运行
2. 服务器地址是否正确（**不要有空格！**）
3. OpenID 是否正确

### Q: 公众号没反应？
A: 确认「服务器配置」在微信公众平台后台是**已启用**状态，且选择的是**明文模式**。

### Q: 图片显示不出来？
A: 当前版本直接保留原图片链接，需要网络连接才能查看。

## 技术支持

如有问题，请检查后端日志和 Obsidian 开发者控制台（Ctrl/Cmd + Shift + I）。