思源笔记 通用操作二（六）

6.通用操作二

涵盖 AI 配置、导入导出、剪藏与收集箱、数据历史（文件历史 + 数据快照）等实用功能。

一、AI 功能

思源笔记不内置 AI，而是提供 API 接口，需自行对接 OpenAI 或微软 Azure OpenAI。

1. 前置条件

• 拥有 OpenAI / Azure OpenAI 账号。
• 能够访问 OpenAI 的网络环境。
• 思源笔记本身不收取费用，费用来自 OpenAI 的 API 调用。

2. 配置步骤

1. 在 OpenAI 后台创建 API Key 并复制。
2. 打开思源笔记 → 设置 → AI。
3. 粘贴 API Key，完成配置。
4. 确保网络能连接到 OpenAI。

3. 使用方法

• 方式一：输入 /​ → 选择 AI Chat → 直接提问或下达指令。
• 方式二：右键点击块标识 → 人工智能 → 选择预设操作（如读写、翻译、提取摘要、头脑风暴、语法修正等）。也可自定义预定义动作。

目前仅支持 OpenAI 模型，暂不支持文心一言、星火、Gemini 等，需等待后续更新。

二、导入导出

1. 导入

思源笔记主要支持两种导入格式：

格式	说明	适用场景
Markdown 文档/文件夹	标准 Markdown 格式	从其他笔记软件导出为 Markdown 后再导入
​ ​.sy.zip​​ 压缩包	思源专用的 data 压缩包	设备间迁移或全量备份恢复

操作步骤

导入 Markdown：

• 在文档树中，鼠标悬停在目标笔记本上 → 点击 ... → 导入 → Markdown 文档 → 选择文件。

导入 ​.sy.zip​：

• 同样点击 ...​ → 导入 → Siyuan.sy.zip → 选择压缩包。

• 导入后，文件会被复制到当前工作空间的 data/ 文件夹。

  • 相同文件会覆盖。
  • 不同文件会新增。
  • 已有文件不做处理（不覆盖）。⚠️ 请留意，避免数据丢失。

其他软件中的图片、音视频、思维导图等会被转换为资源文件，可能需要手动微调排版。
强烈建议导入前备份现有数据。

2. 导出

• 最简单的导出：直接 Ctrl+C​ / Cmd+C 复制内容，粘贴到 Word 等软件中，得到带 Markdown 语法的纯文本。

• 文档树右键导出：在文档上右键 → 导出。

• 导出设置（在 设置 → 导出 中调整）：

  • 引用/嵌入块处理：可设置导出时对引用块和嵌入块的处理方式。
  • PDF 导出：页脚、标注引用、水印等。
  • Word 导出：页码、符号、保存路径等。

导出前同样建议备份数据。

三、剪藏与收集箱

1. 浏览器剪藏（网页内容）

• 支持的浏览器：Chrome、Edge、Firefox。

• 安装扩展：在扩展商店搜索“思源”并获取。
  （如果无法访问商店，可下载安装包手动拖入浏览器安装。）

• 配置：在扩展选项中填入 API Token（获取路径：思源笔记 → 设置 → 关于 → API Token）。

• 使用：

  • 选中网页内容 → 右键 → Copy to Siyuan。
  • 或点击扩展图标 → Send to Siyuan（剪藏整篇文章）。

2. 手机收集箱

通过云端收集外部数据，然后在思源笔记的“收集箱”面板中获取并整理。

方式一：B3log 开源公众号

• 关注 B3log开源 公众号。
• 右下角绑定思源账号。
• 向公众号发送消息（文本、图片、超链接），或从收藏中转发。
• 在思源笔记中打开 收集箱面板 即可看到。

方式二：思源小助手（需订阅会员）

• 添加“思源小助手”微信（或扫码）。
• 直接转发聊天记录（支持文本、图片、语音、视频、文件，单文件 ≤20MB）。
• ⚠️ 仅限订阅会员使用，订阅过期会删除联系人关系。

四、数据历史（重要！）

数据历史分为 文件历史 和 数据快照，两者区别如下：

类型	存储位置	能否手动恢复	用途
文件历史	​工作空间/history/	✅ 可手动拷贝到 data/ 恢复	自动备份近期修改
数据快照	​工作空间/repo/（加密压缩）	❌ 无法手动恢复	手动创建完整快照，用于回滚和云端同步

1. 文件历史（自动）

• 生成规则：每 10 分钟 自动对 10 分钟内更新过的文档生成历史（间隔可在 设置 → 编辑器 → 历史生成间隔 中调整）。

• 查看与回滚：

  • 点击顶部工具栏 数据历史 按钮 → 切换到 文件历史。
  • 左侧时间列表选择记录，右侧点击 回滚 按钮 → 确认后使用历史文件覆盖现有文件。

• 历史文件后缀名如 .update 等，不同操作有不同后缀。

2. 数据快照（手动）

第一步：初始化数据仓库密钥（设置 → 关于）

• 三种初始化方式（确保所有设备使用相同密钥，否则无法跨设备同步快照）：

  1. 导入密钥：将其他设备上的密钥字符串粘贴过来。
  2. 自动生成密钥：随机生成（只需在一台设备执行，其他设备导入该密钥）。
  3. 通过密码生成：自定义密码，所有设备使用相同密码。

第二步：创建快照

• 顶部工具栏 数据历史 → 切换到 数据快照 → 点击 创建快照 → 填写备注（越详细越好）→ 确认。

第三步：回滚快照

• 在快照列表中，找到对应时间/备注的快照，点击右侧 回滚 → 确认后，快照数据将完全替换现有数据。

快照仅能通过创建时间和备注区分，务必写清楚备注内容。

五、小结

• AI：需自行对接 OpenAI API，提供智能辅助。

• 导入/导出：支持 Markdown 和思源专用压缩包，注意备份和覆盖规则。

• 剪藏与收集箱：浏览器扩展剪藏网页，手机通过公众号或小助手收集内容。

• 数据历史：

  • 文件历史（自动、可手动拷贝恢复）
  • 数据快照（手动、加密、跨设备同步需统一密钥）

数据历史是挽救误操作的关键功能，建议养成手动创建快照的习惯。