前言¶

用思源笔记（SiYuan）的朋友常遇到一个需求：笔记内容沉淀好了，但要交给不使用思源的人，或者要塞进公司的 Word 模板里。思源本身可以导出，但批量导出子文档、把散落的图片打进同一个 docx 这类操作，手动点导出并不顺手。下面介绍的这个社区 Skill「思源文档导出」就是针对这个场景的：它把「搜索文档 → 转成 docx → 图片打包」串成一条能被 Agent 直接执行的流程。

这是什么¶

「思源文档导出」是一个面向通用 SKILL.md 格式的社区 Skill，坐标 @user_e9d5236e/siyuan-export，发布者为 user_e9d5236e，当前版本 1.0.2，分类 office-efficiency。它解决的问题是：让 Agent 通过思源笔记 API 检索文档，并把文档连同图片一起导出为 Word（docx）文件，支持单个文档导出，也支持批量导出一个文档下的子文档。

SkillHub 页面显示评分 100000、下载 600、安装 3（以 SkillHub 页面实时数据为准）。

核心功能¶

下面介绍已核实的能力，均来自该 Skill 的官方简介。

1、按文档 ID / 路径 / 名称搜索导出：可以给文档的 ID、路径或名称，由 Agent 检索后导出，不必手动翻目录。
2、图片自动打包：文档引用的图片会一并打包进生成的 docx，导出后在 Word 里图片不丢失。
3、单文档导出：导出指定的一篇文档。
4、批量导出子文档：把一个文档下的子文档批量导出，适合整章、整本书一次性转 Word。

触发词包括：导出文档、导出 Word、siyuan export、思源导出、批量导出、导出子文档。在支持 Skill 触发词的客户端里，直接说这些词即可唤起。

安装与启用¶

安装命令、目录和配置字段在目前已抓取的资料中没有给出，官方页面（https://www.skillhub.cn/skills/user_e9d5236e/siyuan-export 和 https://api.skillhub.cn/user_e9d5236e/siyuan-export）在撰写时两次抓取失败，无法核对。安装前请到官方地址查看最新的安装方式，不要照抄下面不存在的命令。

已知的配置相关信息只有两点：

1、该 Skill 带有 requires_api_key=true 标签，说明需要 API Key。思源笔记通过本地 API 操作，通常需要在思源设置里开启 API 服务并生成 token，具体填在哪个配置项、字段名是什么，资料中未提供，以官方页面说明为准。
2、该 Skill 来源为 community（社区发布），安装前建议在官方页面确认版本号与发布者信息。

典型用法¶

以下用法来自官方简介描述的能力，实际命令以官方页面为准。

单个文档导出：对 Agent 说「导出文档」，并给出文档 ID、路径或名称，Agent 检索后把该文档转成 docx，图片一并打包。

批量导出子文档：说「批量导出」或「导出子文档」，指定一个父文档，Agent 把该文档下的子文档逐个导出为 docx。

触发词写法也可以直接用英文，例如 siyuan export、siyuan export <文档名>，效果与中文触发词一致。

适用场景与注意¶

适合谁：

1、思源笔记用户，需要把笔记交给外部人员或归档为 Word。
2、需要按目录批量转 Word 的人，例如把一本书的章节一次性导出。
3、在支持 Skill 触发词的 Agent 客户端里使用，通过自然语言驱动导出。

限制与坑：

1、必须先准备好 API Key，否则 Skill 无法调用思源笔记的接口，这是 requires_api_key=true 决定的硬前提。
2、导出格式只支持 docx，不涉及 PDF、Markdown 等其他格式，资料中没有提到。
3、大文档、图片特别多的文档导出耗时、图片体积上限等，资料中未提供数据，建议先拿一篇小文档试通再批量跑。
4、安装命令与配置字段在现有资料中缺失，动手前先到官方页面核对，避免按旧版本操作。

结尾¶

这个 Skill 的价值在于把「搜索文档 → 转 docx → 图片打包 → 批量导出子文档」交给 Agent 一条龙完成，省去手动点导出、反复整理图片的时间。功能点不多，但正好覆盖思源笔记导出 Word 最常见的几个需求。

官方地址：https://api.skillhub.cn/user_e9d5236e/siyuan-export
SkillHub 页面：https://www.skillhub.cn/skills/user_e9d5236e/siyuan-export