TUTORIALS · 教程中心
把笔记同步助手用到极致
共 67 篇教程，覆盖 OneNote、Notion 的账号绑定与文章转发，以及 Obsidian、思源笔记的安装、路径配置、密钥管理、邮件剪藏、模板变量和常见问题。 左侧目录按类目分组；点进任意一篇都能一眼看到其它教程。
Obsidian 教程
25 篇- 01 在 Obsidian 插件市场安装笔记同步助手教程 笔记同步助手已重新上架 Obsidian 官方社区插件市场。在市场搜索框输入中文「笔记同步助手」就能找到插件 Bi Ji Tong Bu，一键安装，电脑端和手机端都适用，免去下载压缩包和手动复制文件夹。
- 02 Obsidian 插件安装教程 零基础小白也能轻松上手，手把手教你安装笔记同步助手插件
- 03 手机端安装笔记同步助手插件 手机端 Obsidian 安装「笔记同步助手」插件的完整图文教程：插件市场搜英文 china brat 装上「快速安装插件 China BRAT」，再点一下示例即可从国内地址装好笔记同步助手；含密钥配置与首次同步，另附市场直装与 BRAT 备选方式。
- 04 路径配置教程 自定义笔记同步助手的保存路径，把同步内容整齐地放到你想要的文件夹。
- 05 重置密钥教程 密钥泄漏或更换设备时如何安全重置笔记同步助手的密钥。
- 06 多个微信号绑定同一个 Obsidian 笔记库教程 主号买一份会员，其他微信号 / 企业微信号通过发送密钥绑定到同一个 Obsidian 笔记库，所有号转发的内容都会同步到一处。
- 07 笔记属性配置教程（前置元数据模板） 自定义同步笔记的属性（Front Matter）模板，记录来源、时间、标签等元数据。
- 08 笔记属性配置案例 通过真实案例讲解常见的前置元数据（Front Matter）配置写法与坑点。
- 09 备注及标签功能使用教程 如何在同步时为笔记添加备注和标签，让知识管理更有条理。
- 10 Obsidian 插件模板变量完全指南 详细介绍笔记同步助手 Obsidian 插件中所有可用的模板变量，帮助你自定义文件名、文件夹路径和文章格式，打造个性化的知识管理系统。
- 11 Obsidian 合并消息模式说明（一天一个文件 vs 一篇一个文件） 笔记同步助手的合并消息模式：什么是「企微消息」、为什么默认按天合并到一个文件、和「文章」一篇一个文件有什么区别。包含四种模式（不合并/仅合并消息/双写/合并所有）、文件名/排序/分隔符/模板等设置项的解释。双写模式、合并文件模板 3.2.0 起支持；「不合并」模式下用 extract 函数把消息标题中间那段截出来当文件名，3.2.7 起支持。
- 12 Obsidian 无 id 纯净同步：消息不写 id / 笔记属性不写 id（3.2.0 起支持） 笔记同步助手 3.2.0 新增两个设置：合并消息不再写隐藏注释符、笔记属性不再写 id 字段，去重完全依靠最新同步游标（按时间判断）。本文讲解开启方法、开启后的效果、原理，以及为什么开启后跨设备同步不能用网盘方案。
- 13 转发链接时写一句「跳过」，只存链接不做 AI 整理 转发链接给机器人时，在备注框开头写「跳过」（或 //、句号、no 等指令），机器人就把链接原样存进笔记，不交给 AI 整理。本文列出全部可用指令、写法规则和常见问题。
- 14 仅保存链接的网站配置教程 配置某些网站跳过 AI 整理，按需保留原始链接或完整页面。
- 15 邮件收藏功能教程 将邮件直接转发到专属邮箱即可自动同步到 Obsidian，无需手动保存。
- 16 Obsidian 日记链接功能使用教程 详细介绍笔记同步助手 Obsidian 插件的日记链接功能，让同步的内容自动插入到你的日记中，实现无缝的知识管理工作流。
- 17 Obsidian 图片本地化教程：图片保存在哪、为什么图片会失效打不开、网络图片怎么批量下载到本地（下载到本地 / 保留原始链接 / 不加载图片） Obsidian 笔记里的图片保存在哪个文件夹？同步文章后为什么会多出一个 images 附件文件夹，能不能只要一个文件、不要图片文件夹？外链图片为什么过一阵就显示不出来、裂开、打不开？用真实截图讲清 Obsidian 本地笔记里图片的原理：笔记里显示的图就是旁边文件夹里的文件。对比笔记同步助手「下载到本地 / 保留原始链接 / 不加载图片」三种图片处理模式各自把图片存在哪、会不会失效、占不占空间；图片太占空间怎么办（PNG 转 JPEG、图床接力）；以及怎么把笔记里的网络图片批量下载回本地、在图片失效前补救（右键「重新本地化」，插件 3.1.6+，Web Clipper 剪藏的笔记也适用）。
- 18 图床接力功能教程 同步完成后自动把 Obsidian 笔记里的本地图片换成你自己图床的外链。云端接力 + 本地接力两种模式，按需选用。
- 19 同步不成功排查教程 没看到新笔记同步进来？按本文的排查流程依次检查推送、同步、权益等环节。
- 20 同步卡在「处理图片 N/M」不动？换掉插件里的两个文件就好 右上角进度停在「处理图片 112/281」几十分钟不动、后面的新笔记一篇都进不来——完全关掉 Obsidian，打开插件文件夹，用新版的 main.js 和 manifest.json 替换掉旧的两个文件，重新打开就恢复了。新版插件遇到打不开的图片会自动放手让同步继续，不会再卡住。
- 21 云空间使用、清空、重新拉取、重新下载图片教程 笔记同步助手的云空间是干什么的、暂存多久（免费版 2 天、会员 14 天、头等舱 30 天）？怎么查看、怎么清空、怎么从云端重新把笔记拉到 Obsidian？笔记里的图片还是远程链接怎么重新下载到本地？回答"云端暂存几天会删吗""同步过来又被删了""移动笔记后下次同步又自动复发""怎么只同步一次""图片打不开怎么重新下载"等问题。
- 22 开发者集成：API / Skill / Web 端 / 浏览器插件 笔记同步助手对开发者的接入方式。当前已有：Clawhub 上的 Note Sync Helper Skill、网页剪藏浏览器插件（实验室）。短期不计划做：Web 端、对外开放 REST API。
- 23 用 obsidian-cli 从命令行触发同步 不想每次都去点 Obsidian 左上角那个「同」字图标？把同步动作交给 cron / 脚本 / agent。本文教你用 Obsidian 自带的 obsidian-cli 跑一行命令把云端笔记拉下来。
- 24 给 AI 看的设置教程（AI 改 data.json 必读） 面向 AI 助手（Claude / ChatGPT / Gemini 等）的笔记同步助手插件设置参考：可改字段、可选值、默认值、危险红线。用户在让 AI 帮忙改设置前，请先把这页发给 AI 阅读。
- 25 常见使用问题 使用笔记同步助手过程中常见问题与解决方案汇总（Obsidian 版本）。
思源笔记教程
9 篇- 01 思源笔记安装「笔记同步助手」插件教程 三步在思源笔记里装好「笔记同步助手」插件：思源集市一键安装 → 微信服务号选「使用思源笔记」拿密钥 → 回思源粘贴密钥点同步。整个过程约 1 分钟。
- 02 思源笔记同步助手路径配置教程 配置思源笔记同步助手同步内容的保存位置。
- 03 思源笔记邮件收藏教程 通过邮件把文章直接收藏到思源笔记。
- 04 思源笔记同步助手视频转图文笔记教程 在思源笔记里把视频/播客链接转成图文笔记；助手会把链接交给 DeepSeek、豆包、千问 等 AI 处理。备注里写「无图 / 少图 / 多图」可以控制截图密度。
- 05 思源笔记合并消息模式说明（按天合并 vs 一篇一个文档） 思源笔记同步助手插件的合并消息模式说明：什么是「企微消息」、为什么默认按天合并到一个文档里、怎么把文章和消息分开存放，以及合并文件名/排序/分隔符等设置项的作用。
- 06 思源笔记同步助手重置密钥教程 思源笔记同步助手密钥重置流程。
- 07 思源笔记同步助手跳过 AI 整理功能教程 思源版本的跳过 AI 整理功能使用说明。
- 08 思源笔记同步助手仅保存链接的网站配置教程 思源笔记同步助手如何配置跳过 AI 整理的网站列表。
- 09 思源笔记同步助手常见使用问题 思源笔记版本笔记同步助手的试用期、会员共享、重新同步、同步延迟、频率调整等常见问题与解决办法。
OneNote 教程
4 篇- 01 OneNote 绑定与使用教程：添加同步助手，转发文章存进笔记 用实际截图一步步完成 OneNote 账号绑定、添加同步助手和首次转发。重点说明第一次要从「转发给朋友」选择助手，之后可从转发栏直接选择，以及到哪里查看处理通知和文章效果。
- 02 开启 OneNote 同步目的地：发给「同步助手」的内容，一次同时进 OneNote、笔记库和 Kindle 在设置页的「同步目的地」里打开 OneNote 开关，之后发给「同步助手」企微好友的内容会额外存一份进 OneNote；同一条内容还能同时进 Obsidian / 思源 / Logseq / Joplin / Zotero 的笔记库、推到 Kindle 上阅读——发一次，三处到达。含绑定前提、开关步骤、扫码加好友二维码和常见问题排查。
- 03 世纪互联 / 教育版 OneNote 如何用笔记同步助手？双账号组合方案完整教程 世纪互联（21Vianet / *.partner.onmschina.cn）、国内高校教育版、全球教育版（Office 365 for Education）OneNote 账号目前都可以用"双账号组合"方案使用笔记同步助手：注册一个微软国际账号（outlook.com / hotmail.com）用来绑定助手作为新剪藏入口，原来的教育版 / 世纪互联账号（通常自带 1TB OneDrive）继续作为长期存储仓库。本文说明为什么暂不直接支持，以及手把手图解双账号分工、归档节奏、OneNote 内部"保存副本 / 移动分区 / 导出 onepkg"的完整操作。
- 04 OneNote 笔记同步助手常见使用问题（含 7 天免费试用 / 文件同步 / 截图说明） OneNote 版笔记同步助手 FAQ：首次绑定免费试用 7 天头等舱权益、聊天记录保存、文件同步（≤100MB，头等舱专属）、稳定截图同步、同步位置设置、世纪互联与教育版双账号方案，常见问题与解决办法集合。
Notion 教程
1 篇微信存档教程
3 篇- 01 把微信图片、文档、语音、视频里的文字识别成笔记 在微信里把图片、语音、视频转发给笔记同步助手，助手会自动把里面的文字 / 说话内容交给 DeepSeek、豆包、千问 等 AI 识别成笔记——不用写备注；想强制识别或跳过识别时在备注里写一个词就行。识别不消耗积分。
- 02 发文档（Word / PDF / PPT / Excel）自动多整理一篇正文笔记 头等舱用户用微信把 Word / PDF / PPT / Excel 等文档发给笔记同步助手，除了照旧保留一条文件下载链接，助手还会把文档正文交给 AI 整理成一篇可搜索、可复制、可编辑的笔记。这一篇讲清楚怎么用、支持哪些文档（PDF 目前最多 200 页）、计费，以及发一个文档为什么会陆续收到 4 条微信通知。
- 03 微信聊天记录、收藏、笔记如何保存到 Obsidian / OneNote / Notion / 思源笔记 把微信聊天记录、微信收藏、微信笔记保存成笔记的完整教程：开通条件、聊天记录的合并转发步骤、收藏 / 笔记必须先点开再从右上角「···」转发（不要在收藏列表里长按直接转发，否则助手只收到「[笔记]」占位符、内容一个字都不会传过去，助手会回「未收到内容」提醒卡片）、发了收藏笔记却没动静的排查与重发方法、别人发来的收藏 / 笔记要等内容全部加载完再转发、微信侧的限制（发送者名字、文件有效期、语音默认自动识别）、卡住时的客服兜底。
剪藏教程
14 篇- 01 视频转图文笔记教程 把视频/播客链接发给笔记同步助手，助手会把链接交给 DeepSeek、豆包、千问 等 AI 处理，整理为图文笔记直接落进 Obsidian / 思源 / OneNote。最省事的发法：在分享面板里点「复制链接」，再顺手转发给助手、长按粘贴发送，一气呵成。可在同一条消息里加「无图 / 少图 / 多图」控制截图密度，也可在设置页设「图片默认选项」和「AI 整理自定义提示词」。
- 02 图文笔记如何保存到 Obsidian 和 OneNote 使用笔记同步助手把图文社区里的图文笔记一键剪藏到 Obsidian 或 OneNote。链接交给 DeepSeek、豆包、千问 等 AI 处理后写入笔记。
- 03 把"图里全是字"的图文笔记，原样存进笔记本 图文社区里那种把内容做成长图、读书笔记、知识科普图的帖子，剪藏后正文经常是空的。现在助手会把链接交给 DeepSeek、豆包、千问 等 AI 处理，识别图里的文字并按"文字 → 图片 → 描述 → 评论"重新排版进笔记，文字可搜可复制。
- 04 问答 / 专栏文章如何保存到笔记本 使用笔记同步助手把问答平台上的回答、专栏文章一键剪藏到 Obsidian 或 OneNote，告别收藏夹吃灰。链接交给 DeepSeek、豆包、千问 等 AI 处理后写入笔记。
- 05 社交动态如何保存到笔记本 使用笔记同步助手把社交平台上的动态、长文一键剪藏到 Obsidian 或 OneNote。链接交给 DeepSeek、豆包、千问 等 AI 处理后写入笔记。
- 06 X（Twitter）帖子如何剪藏保存到 Obsidian / 思源笔记 想把 X（Twitter，推特）上刷到的好帖子长期存进 Obsidian 或思源笔记？在帖子下回复一句 @save2obsidian，机器人就把这条 X 帖子交给 DeepSeek、豆包、千问 等 AI 整理成一篇干净图文笔记写进你的仓库。本文用手机截图讲清 X 剪藏到 Obsidian 的完整流程：关注机器人、私信绑定密钥、@ 一键剪藏与常见问题。
- 07 用飞书机器人把在线文档和链接同步到笔记 在飞书里添加「笔记同步助手」机器人，绑定一次密钥，再按你的飞书版本选一条路线打通在线文档：个人版扫两次码即可（约 1 分钟，免建应用）；企业 / 团队版花几分钟创建一个属于你自己的飞书应用并授权。之后把在线文档、电子表格、网页链接发给它，就会自动整理成一篇笔记写进你的笔记仓库。判断标准只有一条：你自己的飞书账号点开能看到的文档就能同步，别人分享给你、只有「可阅读」权限的那种同样可以。文档用你自己的应用身份读取，凭据保存在你自己名下、随时可撤销。本文含每一步的标注截图。
- 08 学习类 App 内容如何保存到 Obsidian 和 OneNote 使用笔记同步助手把学习类 App 的文章、专栏内容剪藏到 Obsidian 或 OneNote，打造个人知识库。链接交给 DeepSeek、豆包、千问 等 AI 处理后写入笔记。
- 09 在线文档分享链接如何保存到笔记同步助手 主流在线文档平台的公开分享链接，发给笔记同步助手即可整理为一篇笔记，自动同步到 Obsidian / 思源 / OneNote / Notion。重点：必须是不登录就能查看的公开链接。链接交给 DeepSeek、豆包、千问 等 AI 处理后写入笔记。
- 10 加三个企微好友，发给不同的好友，内容自动存进不同的库 默认加的三个企微好友共用同一个客服代码、内容都汇到同一个库。这篇教你给每个好友配一把独立密钥：发给「大黄」的进工作库、发给「小黑」的进生活库，三个 Obsidian 库（思源笔记同理）各进各的，还能给每个好友改个好记的昵称，一眼看清谁进哪个库。
- 11 把笔记同步到 Kindle：绑定推送邮箱 + 认可发件人完整教程 手把手教你在设置页绑定 Kindle 推送邮箱，并把发件人 send@kindle.clipfx.app 加进 Amazon 的认可发件人列表，之后发给「同步助手」的内容会自动额外投递到你的 Kindle 上阅读。含 Amazon 个人文档设置的图文步骤。
- 12 支持哪些平台和内容 笔记同步助手在各内容平台上的支持范围与限制：哪些链接可以剪藏、哪些需要特殊操作、哪些目前不支持。包含主流短视频、公众号文章内嵌视频、在线文档（需公开）、文件附件等常见疑问。
- 13 思源笔记表格无法正常显示？一招帮你轻松解决 从在线文档复制表格到思源笔记后显示异常？本文教你使用 HTML 块功能完美解决表格展示问题。
- 14 隐私说明：你的数据放在哪、什么时候删？ 逐条说明笔记同步助手在 OneNote / Notion / Obsidian / 思源笔记四种笔记本下，是如何处理用户消息、剪藏内容、中转云空间的，以及阅后即焚、匿名化、加密等机制的具体落地方式。
权益 & 账户
5 篇- 01 高级权益常见问题（含 7 天免费试用说明） 笔记同步助手高级权益 FAQ：首次绑定免费试用 7 天头等舱权益、会员与头等舱区别、快速通道额度（会员 600 篇/年、头等舱 3000 篇/年）、头等舱的语音图片视频录音转文字笔记、积分消耗、订阅续费与退款，跨 Obsidian / OneNote / 思源 / Notion 通用。
- 02 优先通道使用说明 收到「排队进度通知」是什么意思、为什么会排队、各权益等级的快速额度是多少、想跳过排队要怎么做。链接多的时候用「笔记同步助手」小程序发，不占快速额度、也不受微信批量转发的速率限制；已经在排队的链接还能在小程序里一条条加速处理掉。
- 03 为什么我批量转发的链接会排队？ 一条一条转发给企微好友会很快处理；短时间内一次性大批量转发链接，助手会先排队、按公平节奏依次处理——这跟优先额度无关。链接多的时候用「笔记同步助手」小程序发，不受微信批量转发的速率限制、不占快速额度；已经在排队的链接也能在小程序里一条条加速处理掉。
- 04 积分用途说明 笔记同步助手积分体系：积分从哪来、哪些 AI 功能会消耗积分、每种功能多少积分，以及积分用完后的处理方式。
- 05 邀请好友得积分：邀请奖励活动说明 笔记同步助手邀请奖励活动：把你的专属邀请码发给朋友，朋友扫码关注服务号并首次付费满 49 元，第二天就给你（邀请人）赠送 2000 积分。本文说明怎么拿邀请码、奖励规则、到账时间与常见问题。
实验室
6 篇- 01 预览版抢先体验：用 China BRAT 从地址安装（实验室） 正式版还没推送时，用 China BRAT 填一个地址就能装上笔记同步助手的预览版，抢先用到最新修复。含安装步骤、注意事项和回退方法。
- 02 网页剪藏浏览器插件使用教程（实验室） 在电脑 Chrome / Edge 浏览器里一键剪藏当前网页：手动安装实验室版插件，验证密钥后点「剪藏本页」，内容会像微信里发送链接一样自动整理并同步到你的笔记库。
- 03 链接剪藏小程序使用教程（实验室） 在微信里粘贴文章链接，访问并剪藏到 Obsidian：无需安装任何软件，不扣积分、不占快速额度。两个小程序功能完全一样，选喜欢的样式用即可。
- 04 Logseq 版笔记同步助手安装与使用教程（实验室） 在 Logseq 里用上笔记同步助手：手动安装实验室版插件，填好密钥与保存位置，把公众号文章、网页剪藏自动同步成 Logseq 页面。
- 05 Joplin 版笔记同步助手安装与使用教程（实验室） 在 Joplin 里用上笔记同步助手：从文件安装实验室版插件，填好密钥与目标笔记本，把公众号文章、网页剪藏自动同步成 Joplin 笔记。
- 06 Zotero 版笔记同步助手安装与使用教程（实验室） 把发给公众号的链接和文章自动整理并同步到 Zotero 指定分类。