Files
ai-proj-helper/skills-integration/siyuan-to-feishu-plugin/skills/SKILL.md
T
johnQ d5bdfcfb7c refactor(skill): 18 个命令型技能转 user-invoked,压目录预算
- biz-* 4 个、integration-* 8 个、dev-android/ios/pda、publish、ai-proj-cicd-release、ai-proj-macos-release
- 均加 metadata.invocation: user-invoked + disable-model-invocation: true(DSH 实测生效)
- catalog: promoted/model-invoked 40、promoted/user-invoked 18、beta 3
2026-10-31 22:16:39 +08:00

2.7 KiB

name, description, metadata, disable-model-invocation
name description metadata disable-model-invocation
siyuan-to-feishu 将思源笔记导出为 PDF 并发送到飞书群。当用户提到"发送笔记"、"导出PDF发飞书"、"/siyuan send"、"分享到飞书"相关任务时自动激活。
invocation
user-invoked
true

siyuan-to-feishu Skill

将思源笔记导出为 PDF 文件,并通过飞书文件消息发送到指定群组。

触发条件

  • 用户说"把思源笔记发到飞书"
  • 用户说"/siyuan send "
  • 用户说"导出笔记 PDF 并分享"
  • 用户提到"发送笔记到龙虾群"

使用方式

# 基础用法(发送到默认群:龙虾大神群)
~/.claude/skills/siyuan-to-feishu/send.sh <doc-id>

# 指定目标群
~/.claude/skills/siyuan-to-feishu/send.sh <doc-id> --group <chat-id>

# 指定 PDF 文件名
~/.claude/skills/siyuan-to-feishu/send.sh <doc-id> --name "技术文档.pdf"

# 示例
~/.claude/skills/siyuan-to-feishu/send.sh 20260312053926-w0m0fnc
~/.claude/skills/siyuan-to-feishu/send.sh 20260312053926-w0m0fnc --group oc_06889f55d62add6c484a8caea38d8e6c
~/.claude/skills/siyuan-to-feishu/send.sh 20260312053926-w0m0fnc --name "会议纪要.pdf"

执行流程

/siyuan send <doc-id>
     │
     ├─── 1. 思源 Export API ──► 获取 HTML 内容
     │         (siyuan.pipexerp.com)
     │
     ├─── 2. wkhtmltopdf/Python ► 渲染为 PDF 文件
     │         (/tmp/siyuan-export-<doc-id>.pdf)
     │
     ├─── 3. 飞书 Files API ─────► 上传获取 file_key
     │         (open.feishu.cn)
     │
     └─── 4. 飞书 IM API ─────────► 群消息 ✅
               (open.feishu.cn)

配置参数

参数 值
思源服务地址 https://siyuan.pipexerp.com
思源 API Token mkea1080c0x0jxqy
飞书 App ID cli_a9f29dca82b9dbef
飞书 App Secret sDfhjG7QT1S4gfHiMVYSygmPQPN1R2Ho
默认飞书群 oc_06889f55d62add6c484a8caea38d8e6c (龙虾大神群)

执行时机

当用户要执行发送操作时,直接调用:

bash ~/.claude/skills/siyuan-to-feishu/send.sh <doc-id> [--group <chat-id>] [--name <filename>]

脚本会自动打印进度并返回结果。

错误处理

错误场景 提示信息
doc-id 不存在 "❌ 笔记不存在,请检查 ID: "
PDF 超过 20MB "❌ 文件过大 (>20MB),请拆分笔记后重试"
飞书 API 失败 "❌ 飞书发送失败 (code: <错误码>),已重试 3 次"
思源服务不可达 "❌ 思源服务连接失败,请检查 siyuan.pipexerp.com"
wkhtmltopdf 未安装 自动降级为 Python weasyprint 或提示安装