Obsidian小红书收藏AI分类操作文档

同步小红书（个人帖子、收藏、点赞）到 Obsidian Vault。

一、下载安装

1. 下载插件

下载插件安装包：rednote2obsidian.zip

2. 解压并安装

1. 解压 rednote2obsidian.zip，得到 rednote2obsidian 文件夹
2. 打开你的 Obsidian Vault 所在目录，找到 .obsidian/plugins/ 文件夹
   • macOS：你的Vault目录/.obsidian/plugins/
   • Windows：你的Vault目录\.obsidian\plugins\
   • 如果 plugins 文件夹不存在，手动创建一个
3. 把 rednote2obsidian 文件夹整个复制到 plugins/ 目录下

最终结构：

你的Vault/
└── .obsidian/
    └── plugins/
        └── rednote2obsidian/
            ├── main.js
            ├── manifest.json
            └── styles.css

提示：.obsidian 是隐藏文件夹。macOS 按 Cmd + Shift + . 显示隐藏文件，Windows 在文件资源管理器中勾选”显示隐藏的项目”。

3. 启用插件

1. 打开 Obsidian
2. 进入 设置 → 第三方插件
3. 如果提示”安全模式”，点击关闭安全模式
4. 点击刷新按钮，找到 RedNote Sync
5. 打开开关启用插件

二、配置插件

启用后，在 设置 → RedNote Sync 中进行配置。

1. 登录小红书

1. 点击「登录小红书」按钮
2. 在弹出的窗口中登录你的小红书账号
3. 登录成功后，点击窗口上方的「登录完成，提取 Cookie」按钮
4. 看到提示”小红书登录成功”即可

注意：登录信息会保存在插件中，无需每次重新登录。如果登录过期，同步时会自动提示你重新登录。

2. 同步设置

3. AI 分类（可选）

开启后，新同步的帖子会由 AI 自动分类到你设定的分类目录中。

1. 打开「启用 AI 分类」开关
2. 填写 API Key、API Base URL（需带 /v1）、模型名称
3. 点击「测试连接」确认配置可用
4. 设置分类列表（JSON 数组格式），或点击「从专辑目录加载」自动获取

支持的 AI 服务（任何 OpenAI 兼容接口均可）： - OpenAI：https://api.openai.com/v1 - DeepSeek：https://api.deepseek.com/v1 - Kimi（Moonshot）：https://api.moonshot.cn/v1 - 智谱 GLM：https://open.bigmodel.cn/api/paas/v4 - 通义千问（DashScope）：https://dashscope.aliyuncs.com/compatible-mode/v1 - OpenRouter：https://openrouter.ai/api/v1 - 硅基流动：https://api.siliconflow.cn/v1 - 其他自建 / 第三方 OpenAI 兼容网关

三、开始同步

自动同步

插件启用后会按设定的间隔自动同步，无需手动操作。

手动同步

两种方式触发手动同步：

1. 点击左侧栏小红书图标
2. 命令面板：按 Cmd + P（macOS）或 Ctrl + P（Windows），搜索「立即同步」

同步进度

• 同步过程中会在右上角弹出提示（如”收藏：同步了 5 条”）
• 在插件设置页可以看到每种类型的已同步数量和状态：
  • 历史数据同步中… — 正在拉取历史数据
  • 历史数据同步完成，开始增量同步 — 历史数据已全部同步，后续只拉取新增内容

四、同步内容说明

目录结构

RedNote/
├── Bookmarks/              ← 收藏
│   ├── 专辑名A/            ← 开启专辑同步时
│   │   └── 笔记.md
│   └── 笔记.md             ← 未分类的收藏
├── Posts/                  ← 个人帖子
│   └── 笔记.md
├── Likes/                  ← 点赞
│   └── 笔记.md
└── Media/                  ← 图片
    └── {帖子ID}/
        ├── image-1.webp
        └── image-2.webp

笔记格式

每篇笔记包含：

• YAML 属性：resourceId、作者、链接、标签、分类、创建时间等
• 正文：帖子的完整内容
• 图片：自动下载到本地，笔记中嵌入引用
• 视频：嵌入播放器 + 链接（视频不下载到本地）

五、常见问题

Q：同步时提示”登录已过期”？ 

小红书的登录信息有有效期，过期后插件会自动检测并提示。点击设置中的「登录小红书」重新登录即可。

Q：图片显示不出来？ 

确认 RedNote/Media/ 目录下有对应的图片文件。如果没有，可能是下载失败，清除缓存重新同步试试。

Q：想重新同步所有数据？ 

在插件设置中点击「清除缓存并重新同步」按钮。这只会重置同步记录，不会删除已有的笔记文件（会覆盖更新）。

Q：切换了小红书账号怎么办？ 

插件会自动检测账号切换并重置同步状态，无需手动操作。

Q：同步间隔设多少合适？ 

建议 10 分钟以上，每批 5 条。设太短或太多容易触发小红书的频率限制。

Q：如何更新插件？ 

下载新版本的 rednote2obsidian.zip，解压后覆盖 .obsidian/plugins/rednote2obsidian/ 目录下的文件，重新加载 Obsidian 即可。

六、安全问题

🛡️ 隐私保护声明（Privacy Policy） 

为了重视您的隐私，并承诺采取一切合理措施保护您的个人数据安全。请您仔细阅读以下内容，了解我们的隐私保护政策：

1. 插件运行方式

• 本插件为纯本地工具，所有操作均在您的 Obsidian 客户端本地执行，不会将任何数据发送至第三方服务器。
• 插件不会收集、存储或分析您的小红书账户信息、内容数据或登录凭证。
• 本插件仅作为个人知识库工具使用。

2. 数据访问权限

• 插件运行时会读取您已登录账号下的公开内容（例如您的收藏或发布的帖子），以便将您主动选择的信息同步至 Obsidian Vault。
• 插件不会主动抓取、储存或分发任何非您本人页面或受保护数据。

3. 第三方平台说明

• 插件通过 Obsidian 官方 API 写入本地 Vault，仅在您本地设备上与 Vault 交互。
• 所有同步动作由用户发起，插件不会在未授权的情况下执行任何数据传输行为。

4. 本地存储说明

• 插件会在本地存储用户配置项（如同步偏好设置、登录 Cookie），这些信息仅保存在您本地 Vault 的插件目录中，不会被上传或远程保存。

⚠️ 使用免责声明（Disclaimer） 

1. 第三方平台责任

本插件为独立开发工具，与小红书及 Obsidian 官方无任何隶属关系。所有商标与内容归各平台所有。

用户在使用本插件过程中，应遵守各平台的使用条款，不得进行非法抓取、批量爬取、账号共享等违规行为。如用户行为违反平台政策或法律法规，由用户自行承担责任。

2. 功能范围说明

• 本插件定位为协助用户搭建个人知识库的工具，仅用于将用户本人账号下的小红书收藏、帖子、点赞等内容整理同步到本地 Obsidian Vault，方便用户在自己的知识体系中检索与回顾。
• 严禁将本插件用于任何形式的数据爬取、批量抓取他人内容、二次分发或商业化数据采集。若用户将插件用于上述用途，由用户自行承担全部法律与平台责任，开发者不提供任何支持。
• 插件依赖用户在插件内登录并授权后方可使用，若平台接口或页面结构发生变化导致插件无法运行，请联系开发者反馈，由开发者进行后期的跟进维护。

3. 使用风险提示

用户使用插件过程中所产生的任何同步行为，均为用户主动触发。请用户自行评估数据内容的敏感性，合理使用插件。

八、联系与反馈

https://blog.notionedu.com/1b373415a27980b1b249eab49061527f