菜单
MCP playbook for browsing and reading SiYuan notes. Use for notebooks, document trees, human-readable paths, IDs, storage paths, block content, and read-only discovery.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
MCP playbook for creating and editing SiYuan documents and blocks. Use for path-based document creation, block append/insert/update, metadata, daily notes, and verified edits.
MCP playbook for SiYuan attribute views. Use to inspect database metadata, render views, add columns or rows, update cells, and keep AV, view, row, column, and block IDs distinct.
MCP playbook for SiYuan assets and exports. Use for uploads, Markdown export, document extraction, resource ZIP export, OCR text, templates, and safe asset maintenance.
MCP SiYuan markup guide for rich Markdown written through block and document actions. Use for headings, lists, tasks, tables, code, math, diagrams, tags, callouts, super blocks, embeds, and block references.
MCP playbook for finding and querying SiYuan content. Use for fulltext, read-only SQL, backlinks, references, assets, dynamic query blocks, and safe find-replace.
Top-level skill for operating SiYuan Note through the Sisyphus MCP server. Use to choose an aggregated tool, discover action resources, route complex tasks to a scenario skill, and apply permissions and safety rules.
| name | siyuan-mcp-browse-read |
| description | MCP playbook for browsing and reading SiYuan notes. Use for notebooks, document trees, human-readable paths, IDs, storage paths, block content, and read-only discovery. |
Start with fs and human-readable paths. Drop to document or block actions only when IDs, storage paths, metadata, or block structure are required.
notebook(action="list")
fs(action="ls", path="/")
fs(action="tree", path="/Notebook/Folder", maxDepth=4)
fs(action="read", path="/Notebook/Folder/Doc", page=1, pageSize=8000)
Use search-assisted discovery when the path is unknown:
fs(action="search", path="/Notebook", query="keyword", page=1, pageSize=20)
search(action="fulltext", query="keyword", page=1, pageSize=20)
document(action="lookup", id="<doc-id>", include=["path","hpath","notebook"])
document(action="get_doc", id="<doc-id>", mode="markdown")
block(action="get_kramdown", id="<block-id>")
| Value | Example | Typical use |
|---|---|---|
| Workspace path | /Notebook/Folder/Doc | fs actions |
| Notebook-local hpath | /Folder/Doc | document create or lookup with notebook |
| Storage path | /20260712123000-abc123.sy | low-level rename, remove, or move |
Never derive a storage path from a title. Resolve the document first and reuse the returned path. Treat pages and truncation notices as incomplete data, and continue with explicit page and pageSize values.