菜单
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.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
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.
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-create-edit |
| description | 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. |
Read the target first, choose the highest-level action that preserves intent, perform one bounded change, then read it again.
Use a workspace path for convenient path-based creation:
fs(action="write", path="/Notebook/Project/Notes", markdown="# Notes\n\nInitial content.")
Use a notebook ID plus notebook-local hpath when low-level control is needed:
document(action="create", notebook="<notebook-id>", path="/Project/Notes", markdown="# Notes")
Do not include the notebook name in the low-level hpath.
block(action="append", parentID="<doc-id>", dataType="markdown", data="## New section\n\nParagraph.")
block(action="insert", previousID="<block-id>", dataType="markdown", data="Inserted paragraph.")
block(action="update", id="<block-id>", dataType="markdown", data="Replacement block content.")
Use block update only when replacing the whole block is intended. Prefer a scoped replacement for a small textual change:
block(action="replace", id="<block-id>", edit={"old":"draft","new":"final"})
block(action="set_attrs", id="<block-id>", attrs={"custom-source":"agent"})
document(action="create_daily_note", notebook="<notebook-id>")
Before rename, move, delete, or broad replacement, resolve the exact target, show the affected scope, and obtain approval. After every mutation, read by stable ID when possible. Use siyuan://help/action/block/append when any parameter is uncertain.