Help us improve
Share bugs, ideas, or general feedback.
npx claudepluginhub zhiluop/siyuan-skills创建和编辑思源笔记兼容的文件,包括思源笔记风味 Markdown、Excalidraw 绘图等。当在思源笔记笔记本中处理 .md、.sy 或 Excalidraw 文件时使用。
Share bugs, ideas, or general feedback.
思源笔记(SiYuan Note)技能集合,采用分层设计提供基础知识和专用工具。
这些 skills 遵循 Claude Skills 规范,可被 Claude Code 和其他兼容 agent 使用。
{local_path}/data/assets/本仓库包含多个针对思源笔记的 Claude Code Skills,采用分层设计:
skills/
├── siyuan/ # 基础层:核心知识库
├── siyuan-article-import/ # 应用层:文章导入
├── siyuan-excalidraw/ # 应用层:图表生成
└── siyuan-markdown/ # 格式层:Markdown 编辑
层级:基础层
用途:提供思源笔记的核心概念、通用 API 调用方法、模板语法、闪卡系统等基础知识。
使用场景:
关键内容:
.action{})依赖关系:其他所有 skills 依赖此 skill 提供的基础知识
层级:应用层
用途:从网络抓取文章(微信公众号、知乎、掘金、博客等)并导入思源笔记。
使用场景:
核心功能:
触发关键词:"导入文章"、"保存网页"、"抓取内容"
依赖关系:依赖 siyuan 基础知识
层级:应用层
用途:为思源笔记创建流程图、思维导图、架构图等可视化内容。
使用场景:
核心功能:
触发关键词:"绘图"、"画流程图"、"创建架构图"、"可视化"
依赖关系:依赖 siyuan 基础知识
层级:格式层
用途:处理思源笔记风味 Markdown(SFMD)的编辑和语法。
使用场景:
核心功能:
[[文档]])((块ID)))关键语法:
[[文档名]] - 维基链接((块ID)) - 块引用{{SQL}} - SQL 查询嵌入依赖关系:依赖 siyuan 基础知识
┌─────────────────────────────────────────┐
│ siyuan (基础知识库) │
│ 核心概念、API、模板、块操作 │
│ ↓ │
│ ┌────────────┼────────────┐ │
│ ↓ ↓ ↓ │
│ 应用层 应用层 格式层 │
│ (导入) (绘图) (编辑) │
│ siyuan- siyuan- siyuan- │
│ article- excalidraw markdown │
│ import
└─────────────────────────────────────────┘
| 任务 | 使用 Skill |
|---|---|
| 了解思源笔记基本概念 | siyuan |
| 导入网络文章 | siyuan-article-import |
| 创建图表/流程图 | siyuan-excalidraw |
| 编辑 Markdown 文件 | siyuan-markdown |
| 调用思源 API | siyuan |
| 插入图片到文档 | siyuan-markdown |
将 skills/ 目录复制到 ~/.claude/skills/ 或项目根目录的 /.claude/skills/。
确保 .claude/siyuan.json 包含:
{
"api_url": "http://127.0.0.1:6806",
"api_token": "your-api-token",
"local_path": "/path/to/siyuan",
"remote_path": {
"webdav": true,
"url": "https://your-webdav-server.com",
"username": "username",
"password": "password",
"assets_path": "/assets"
}
}
💡 路径说明:
local_path应指向思源笔记的工作目录(包含data/、conf/等目录的根目录)- 全局 assets 路径为:
{local_path}/data/assets/- 图片引用语法:
assets/filename.ext(相对于 data 目录)示例目录结构:
Y:\note\siyuan\ # local_path 指向这里 ├── data/ │ ├── assets/ # 全局资源目录 │ └── {笔记本ID}/ └── conf/
欢迎贡献!请遵循 skill-creator 标准创建新 skills。