创建分享

操作入口

在思源笔记的文档树中，对笔记本或文档右键点击，进入插件菜单，选择「创建分享」。

支持的分享类型：

• 笔记本分享 —— 分享整个笔记本及其所有文档
• 单篇文档分享 —— 仅分享当前文档
• 文档及子文档分享 —— 分享当前文档及其所有子文档

分享对话框

点击「创建分享」后会打开分享管理对话框，包含以下部分：

分享选项

同时分享子文档

勾选「同时分享子文档」复选框后，将会把当前文档及其所有子文档一起分享。不勾选则仅分享当前单篇文档。

对于笔记本分享，此选项不可用，因为默认会分享笔记本内所有文档。

排除文档

分享时可以选择排除部分文档，使其不参与分享。

操作步骤：

1. 点击「排除文档」按钮，打开选择对话框
2. 对话框中会列出所有可分享的文档，使用树形结构展示层级关系
3. 勾选要排除的文档，排除某个文档后其所有子文档也会被排除
4. 可以使用搜索框按标题或文档 ID 搜索
5. 点击「确定」保存选择

当前根文档不可排除。对于单篇文档分享，排除功能仅在勾选「同时分享子文档」时生效。

排除后会显示「已排除文档：{数量}」的提示。点击「清空排除」可以移除所有排除设置。

访问设置

在创建分享时可以同时设置以下访问限制（均为可选）：

• 访问密码 —— 访客需输入正确密码才能查看
• 到期时间 —— 超过该时间后分享将无法访问
• 访客上限 —— 最大访客数量，0 表示不限制
• 链接后缀 —— 自定义分享链接后缀，留空则自动生成

详细说明请参考「访问设置」章节。

分享流程

创建流程

1. 填写好分享选项和访问设置后，点击「创建分享」
2. 插件会依次执行以下步骤，并在进度对话框中显示：
   • 获取文档信息 / 获取笔记本与文档列表
   • 导出 Markdown
   • 准备资源文件（图片、附件等）
   • 上传分享内容
3. 上传完成后，会显示分享链接

增量更新机制

从 v0.3.8 版本起，插件采用增量更新算法。更新分享时：

1. 首先分析本地和远端的差异
2. 显示增量分析结果，包含：
   • 文档：原有数量、新增、修改、删除数量
   • 资源：原有数量、新增、修改、删除数量
3. 显示「继续上传」按钮，10 秒倒计时后自动开始上传
4. 仅上传变更的内容，节省时间和流量

资源处理

分享的内容包括文档中引用的所有资源：

• 图片（PNG、JPG、SVG 等）
• 附件文件
• 自定义表情

资源采用分片上传方式，支持大文件。如果某个资源获取失败，会跳过并提示「有 {数量} 个资源获取失败，已跳过」。

引用导出设置提醒

如果分享的文档中包含引用（ref），插件会检测你的思源笔记导出设置。若当前设置不是「脚注+锚点哈希」，会弹出提醒：

检测到分享内容包含引用。当前导出设置不是"脚注+锚点哈希"时，分享后的引用会失效。请前往 设置 -> 导出 -> 引用 选择"脚注+锚点哈希"。

你可以勾选「不再提醒」来关闭此提示。

分享完成

分享创建成功后，会：

1. 显示「分享已创建：{链接}」的通知
2. 在文档树中对应的文档/笔记本上显示蓝色分享图标
3. 在分享管理对话框中显示分享链接和所有设置信息