思源笔记查询技能

让你的思源笔记与Claude完美融合，实现强大的笔记智能查询和管理。

GitHub仓库: https://github.com/2234839/siyuan-notes-skill

✨ 为什么选择这个技能？

• 🔍 全量内容搜索 - 不再局限于思源内置搜索，可以查询笔记中的任何内容
• 🔗 智能关联发现 - 自动发现笔记间的引用关系，找到你可能遗忘的关联
• 📋 任务管理集成 - 直接查询和管理笔记中的待办事项
• 🏷️ 标签属性查询 - 支持基于标签和自定义属性的精准筛选
• 📊 时间维度分析 - 按时间范围查询日记、任务、近期文档等
• 🎯 零学习成本 - 自然语言即可完成复杂查询，无需学习SQL

🚀 快速开始

1. 安装技能

# 克隆到Claude技能目录
cd ~/.claude/skills
git clone https://github.com/2234839/siyuan-notes-skill.git siyuan-notes

# 安装依赖
cd siyuan-notes
npm install

2. 配置连接

1. 打开思源笔记 → 设置 → 关于
2. 复制 API Token
3. 创建配置文件：

cp .env.example .env

4. 编辑 .env，填入你的API Token：

SIYUAN_HOST=localhost
SIYUAN_PORT=6806
SIYUAN_API_TOKEN=你的API_TOKEN

3. 开始使用

安装完成后，你就可以用自然语言向Claude询问关于笔记的各种问题！

💡 使用示例

日常查询

"帮我搜索所有包含'人工智能'的笔记" "最近一周我写了哪些待办事项？" "找出所有标记为'重要'的笔记" "显示我的所有日记文档"

深度分析

"哪些笔记引用了这篇文章？" "列出项目中未完成的任务" "找出这个笔记本里没有被引用的文档" "随机推荐一个笔记标题让我看看"

文档管理

"显示所有文档的结构" "查找特定时间段创建的笔记" "按优先级排序显示我的任务"

⚡ 核心优势

🎯 精准定位

相比思源内置搜索，这个技能可以：

• 基于时间、属性、引用关系等多维度筛选
• 支持复杂的组合查询条件
• 快速定位特定类型的笔记内容

🔄 持续同步

• 实时连接你的思源笔记数据库
• 自动获取最新的笔记内容和结构
• 支持远程思源实例

🛡️ 安全可靠

• 本地运行，数据不离开你的设备
• 支持思源笔记的安全认证机制
• 不会修改或删除你的笔记内容

🔧 支持的查询类型

• 内容搜索 - 全文检索笔记内容
• 文档导航 - 按文档结构浏览
• 引用关系 - 发现笔记间的链接
• 任务管理 - 待办事项状态跟踪
• 时间查询 - 按创建/修改时间筛选
• 标签系统 - 基于标签的分类查询
• 属性过滤 - 自定义属性精确筛选

📝 常见问题

Q: 需要学习SQL吗？ A: 不需要！用自然语言描述你的需求即可，Claude会自动转换为相应的查询。

Q: 会修改我的笔记吗？ A: 完全不会，这个技能只读取内容，不会对笔记做任何修改。

Q: 支持哪些思源版本？ A: 支持所有提供API接口的思源笔记版本。

Q: 可以在移动设备上使用吗？ A: 只要能访问到你的思源笔记API接口就可以使用。

---

开始你的智能笔记管理之旅！ 🎉

安装完成后，直接对Claude说："帮我查看笔记"就可以开始了。