技能介绍

要解决什么问题

在 Agent 或脚本里操作思源笔记时，UI 指引帮不上忙：你需要的是可重复的 API 调用——列出笔记本、按 ID 创建/更新文档、给一批页面打标签，或在某个父文档下完整枚举子文档。思源 REST API 本身够用，但参数组合和文档类型（doc-type vs folder-type）很容易让人误判「数据丢了」。

技能如何工作

本技能是装在 ~/skills/siyuan-skill-enhanced/ 的 Node.js CLI，所有命令在该目录下通过 node siyuan.js <子命令> 执行，统一走思源 REST API。

核心能力包括：

结构：structure --depth -1 递归列出子文档（这是枚举子树最可靠的方式）
读写：content 读正文，create / update --file 写 Markdown，rename / delete（删除需先关 safeMode）
发现：search 支持关键词/语义/混合模式；tags 用 -t 设置标签（不是 --tags）
校验：info 看 updated 时间戳，配合操作后抽查

典型流程是：用 notebooks 定位笔记本 → structure 拿 ID 树 → 批量 create/update/tags → 用 info 与 content 做 spot check。

适用边界与注意点

别用它做：思源安装/服务器部署、纯 UI 操作教学、代写笔记正文（应换写作类 skill；方法论可参考 siyuan-knowledge-base-mgmt）。
参数陷阱：--depth 默认是 1，全量递归必须传 -1；create 标题用位置参数 "标题" ""，--title 不识别。
删除：默认删除保护，需在 config.json 将 safeMode 改为 false，操作完改回。
已知行为：刚 update 后立刻 content 可能暂时返回 0 块，等 1～2 秒或用 info 确认；大文档注意 1MB 与 API 频率限制。