笔记同步助手 Obsidian 插件安装教程

欢迎！ 这个教程将一步步指导您安装笔记同步助手插件。

不用担心！ 即使您对电脑操作不太熟悉，只要按照步骤操作，就能成功安装。整个过程大约需要 10-15 分钟。

开始前的准备

请确保您已经：

• ✅ 在电脑上安装了 Obsidian 软件
• ✅ 创建了至少一个 Obsidian 笔记库（保管库）
• ✅ 关注了”笔记同步助手”微信公众号

基础概念说明

什么是插件？ 插件是为 Obsidian 添加新功能的小程序，就像手机应用一样，可以让软件做更多事情。

什么是 API 密钥？ API 密钥就像一把钥匙，让插件能够安全地连接到笔记同步助手的服务器获取您的数据。

什么是保管库（库）？ 保管库是您在 Obsidian 中存储所有笔记的文件夹，相当于您的”笔记本”。

安装步骤

第一步：获取插件文件

1. 打开微信，找到”笔记同步助手”公众号
2. 发送消息”Obsidian”
3. 您会收到下载链接和 API 密钥（请保存好 API 密钥，稍后需要用到）
4. 点击链接下载压缩包（文件名类似：obsidian-notehelper-2.1.0.zip）
5. 在电脑上找到下载的压缩包，右键选择”解压”或”提取”
6. 解压后会得到一个文件夹（如：2.1.0）

第二步：在 Obsidian 里打开插件文件夹

1. 打开 Obsidian
2. 点击左下角的设置图标（⚙️ 齿轮状）
3. 在左侧菜单里向下滚动，找到”第三方插件”，点击它
   • 💡 这个选项在”核心插件”下方
4. 找到”安全模式”开关，把它关掉
   • ✅ 关掉后会显示”安全模式已关闭”
   • 💡 关掉之后 Obsidian 才允许加载第三方插件
5. 继续往下滚，找到”已安装插件”这一行
6. 点这一行右侧的文件夹图标（鼠标悬停会显示”打开插件文件夹”）
7. 系统会自动弹出文件管理器，直接定位到您的插件文件夹 —— 不用自己找路径

第三步：把插件文件放进去

1. 把第一步解压出来的文件夹整个拖（或复制）到刚才弹出的窗口里
   • 💡 文件夹叫什么名字都不重要，叫 2.1.0、obsidian-notehelper-2.1.0、my-plugin 都行 —— 关键是层级
2. 拖完后，结构应该是这样：

plugins/
└── 任意文件夹名/        ← 这层叫什么都行
    ├── main.js          ← 但这几个文件必须直接在这层下面
    ├── manifest.json    ← 不能再多套一层
    ├── styles.css
    └── 其他文件...

⚠️ 最常见的错误：解压时有些电脑会多套一层同名文件夹，变成 plugins/2.1.0/2.1.0/main.js 这种双层套娃。这时 Obsidian 找不到插件。 解决：进到最里面那一层（能直接看到 main.js 的那层），把这一层的文件夹拖出来到 plugins/ 下，再把外面的空壳文件夹删掉。

第四步：在 Obsidian 中启用插件

1. 回到 Obsidian 的第三方插件设置页面（如果关了就重新打开）
2. 在”已安装插件”这一行右侧的刷新图标（就在刚才那个文件夹图标旁边）点一下
3. 您应该能看到”笔记同步助手”插件，右侧有一个灰色的开关
   • ❌ 如果看不到：请返回上一步检查文件夹层级，或者直接重启 Obsidian

4. 点击这个灰色开关把它打开
   • ✅ 开关变成紫色就是启用成功

第五步：配置 API 密钥

1. 在”已安装插件”列表中，点击”笔记同步助手”右侧的齿轮图标⚙️进入插件设置
2. 找到”API Key”输入框
3. 将第一步获取的 API 密钥粘贴到这个框中
4. 点击”保存”或直接关闭设置页面（会自动保存）

第六步：测试同步

1. 在 Obsidian 工具栏，找到笔记同步助手的图标（“同”字图标），点击它
2. 或者按 Ctrl/Cmd + P 打开命令面板，输入”同步”找到相关命令
3. 首次同步可能需要几分钟时间
4. 同步完成后，您应该能在笔记库中看到新创建的”笔记同步助手”文件夹

成功确认

如果看到以下情况，说明安装成功：

• ✅ 插件在”已安装插件”列表中显示为”已启用”
• ✅ Obsidian 工具栏出现笔记同步助手图标（“同”字图标）
• ✅ 点击同步后能够看到同步进度
• ✅ 笔记库中出现”笔记同步助手”文件夹

遇到问题怎么办？

常见问题解决

Q: 找不到”打开插件文件夹”的图标 A: 必须先把”安全模式”关掉才会出现”已安装插件”这一行（以及右侧的文件夹/刷新图标）。如果还是看不到，关掉设置页面再重新打开一次。

Q: 插件没有出现在列表中 A: 99% 是文件层级放错了，和文件夹叫什么名字没关系。请按下面的顺序检查：

1. 回到刚才打开的插件文件夹（如果关掉了，重新走一遍第二步），里面必须有一个您拖进去的文件夹（名字随便）
2. 进到这个文件夹里，要能直接看到 main.js、manifest.json、styles.css 这几个文件
3. ❌ 如果点开后里面又是一个文件夹（双层套娃，比如 2.1.0/2.1.0/main.js），Obsidian 就找不到插件。把最里面那一层文件夹拖出来到外层，再把空壳删掉
4. 检查完层级，回 Obsidian 设置页面点”已安装插件”右侧的刷新图标（或重启 Obsidian）就能看到插件了

Q: 同步不成功 / 没反应 / 想全量重新拉一次 A: 同步类问题（网络、配置、清空 Sync At 重新拉历史等）请看 同步不成功排查教程，里面有完整的排查步骤。

---

接下来：进阶配置和功能

插件装好之后，下面这些教程会带您把它用得更顺手：

配置常用选项

• 路径配置教程 —— 改默认存储路径、按日期 / 分类拆文件夹
• 二级目录设置教程 —— 把不同来源（公众号、知乎、日记…）放进不同子文件夹
• Frontmatter / 笔记属性模板配置 —— 自定义每篇笔记最上面的属性区
• 模板变量完全指南 —— 所有可用变量（title、author、date_saved…）一览
• 备注及标签功能 —— 给保存的内容加备注和标签
• 合并消息模式 —— 一天一个文件 vs 一篇一个文件

用得更高级

• 跳过提取功能 —— 哪些链接只存原始消息、不读取正文
• 不提取内容的网站配置 —— 长期把某些站点设为只存链接
• 邮件收藏功能 —— 用邮箱也能保存内容
• 日记链接功能 —— 自动把当天保存的内容链到日记里
• 图床接力功能 —— 让外链图片在 Obsidian 里也能稳定显示

遇到问题

• 同步不成功排查教程 —— 同步失败 / 没反应 / 想清空重拉
• 重置密钥教程 —— API Key 失效或想换一把
• 手机端 BRAT 安装教程 —— 在 iOS / Android 上装这个插件
• 常见使用问题汇总 —— 综合 FAQ

技术支持

如需技术支持，请：

1. 关注微信公众号”笔记同步助手”
2. 发送消息”客服”
3. 收到回复后发送”人工”转接人工客服
4. 向客服详细描述您遇到的问题

---

感谢使用笔记同步助手！如果您觉得插件有用，欢迎推荐给更多朋友使用。