siyuan-cli
思源笔记命令行工具 — 笔记本/文档/块管理、全文搜索、SQL 查询、AI 对话、MCP 集成,全部在终端完成。
简体中文 | English
功能特性
- 笔记本管理 — 创建、打开、关闭、重命名、删除,支持配置读写
Agenten stärken
Installation vom Herausgeber. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
Noch kein paketiertes Release in der Registry. Folgen Sie der README des Repositorys.
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenVom Herausgeber
思源笔记命令行工具 — 笔记本/文档/块管理、全文搜索、SQL 查询、AI 对话、MCP 集成,全部在终端完成。
简体中文 | English
思源笔记命令行工具 — 笔记本/文档/块管理、全文搜索、SQL 查询、AI 对话、MCP Server、Claude Code Skill,全部在终端完成。
--format 全局切换git clone https://github.com/cicbyte/siyuan-cli.git
cd siyuan-cli
go build -o siyuan-cli .
环境要求: Go >= 1.24、思源笔记实例(本地或远程)
siyuan-cli auth login # 配置连接
siyuan-cli notebook list # 列出笔记本
siyuan-cli search block "关键词" # 全文搜索
siyuan-cli chat "搜索关于 Go 的笔记" # AI 对话
siyuan-cli notebook list # 列出笔记本
siyuan-cli notebook create "我的笔记" # 创建笔记本
siyuan-cli notebook rename "旧名" "新名" # 重命名
siyuan-cli notebook delete "旧笔记" -F # 删除(-F 强制)
siyuan-cli notebook open "笔记本" # 打开
siyuan-cli notebook close "笔记本" # 关闭
siyuan-cli notebook getconf "笔记本" # 获取配置
siyuan-cli notebook setconf "笔记本" --sort 1 # 设置配置

siyuan-cli document list "我的笔记" # 列出文档
siyuan-cli document list "我的笔记" --path /技术 # 指定路径
siyuan-cli document get "我的笔记" /日记/2024-01-01 # 获取内容
siyuan-cli document createMd "我的笔记" --title "新文档" --content "# 标题\n内容"
siyuan-cli document outline "我的笔记" /技术笔记 # 查看大纲
siyuan-cli document daily --notebook 日记本 # 创建今日日记
siyuan-cli document move "笔记" /旧路径 /新路径 # 移动文档
siyuan-cli document copy "笔记" /文档路径 # 复制文档
siyuan-cli document history "笔记" /文档 --limit 5 # 查看历史
siyuan-cli document rollback "笔记" /文档 --to <history-path> # 回滚文档

siyuan-cli search doc "AI" # 按标题搜索文档
siyuan-cli search block "goroutine" # 全文搜索块内容
siyuan-cli query "SELECT * FROM blocks WHERE type='d' LIMIT 10"

siyuan-cli block get 20240101120000-xxx # 获取块信息
siyuan-cli block source 20240101120000-xxx # 获取块 kramdown 源码
siyuan-cli block update <id> --content "新内容" # 更新块
siyuan-cli block append <doc-id> --content "内容" # 追加内容到文档
siyuan-cli block delete <id> # 删除块
siyuan-cli tag list # 列出标签
siyuan-cli tag search "Go" # 搜索标签
siyuan-cli tag add "笔记" "文档路径" --tag "标签" # 添加标签
siyuan-cli tag remove "笔记" "文档路径" --tag "标签" # 移除标签
siyuan-cli export doc "笔记" /文档 --format html -o output.html
siyuan-cli export notebook "笔记" --format md -o ./backup/
siyuan-cli import md ./notes/ --notebook "笔记"
siyuan-cli import sy ./backup/ --notebook "笔记"
siyuan-cli asset upload ./image.png
siyuan-cli asset list "笔记" /文档路径
siyuan-cli asset unused # 列出未使用资源
siyuan-cli asset clean -F # 清理未使用资源
siyuan-cli sync status # 同步状态
siyuan-cli sync now # 立即同步
siyuan-cli notebook list --format json # JSON 输出
siyuan-cli chat "问题" # 单轮对话
siyuan-cli chat # 多轮交互对话
siyuan-cli chat --non-stream "问题" # 非流式输出
AI Agent 通过 10 个 function tools 检索笔记内容(列出笔记本、文档树、获取文档、大纲、全文搜索、文档搜索、标签、SQL 查询、创建文档、创建日记),自动选择检索策略后生成回答。

交互模式支持 /quit /exit /q 退出、/clear 清除上下文。

配置文件:~/.cicbyte/siyuan-cli/config/config.yaml(首次运行自动创建)
siyuan:
base_url: "http://127.0.0.1:6806"
api_token: ""
timeout: 30
retry_count: 3
enabled: false
ai:
provider: openai
base_url: "https://open.bigmodel.cn/api/paas/v4/"
api_key: ""
model: "GLM-4-Flash-250414"
max_tokens: 2048
temperature: 0.8
timeout: 30
output:
format: table
siyuan-cli config set ai.api_key "your-api-key"
siyuan-cli config set ai.model "GLM-4-Flash-250414"
siyuan-cli config list
siyuan-cli mcp 以 stdio 模式运行 MCP Server,注册 14 个工具:
Claude Desktop:
{
"mcpServers": {
"siyuan": {
"command": "siyuan-cli",
"args": ["mcp"]
}
}
}
Cherry Studio: 设置 → MCP 服务器,命令 siyuan-cli,参数 mcp
MIT © 2026 cicbyte
思源笔记命令行工具 — 笔记本/文档/块管理、全文搜索、SQL 查询、AI 对话、MCP Server、Claude Code Skill,全部在终端完成。
Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Siyuan Cli läuft lokal über stdio.
Zuletzt geprüft: 2026-10-27. 思源笔记命令行工具 — 笔记本/文档/块管理、全文搜索、SQL 查询、AI 对话、MCP Server、Claude Code Skill,全部在终端完成。