用途:管理文档的创建、读取、更新与删除,文档存储在 SQL 数据库中,通过 Drizzle ORM 访问。每篇文档包含标题、Markdown 内容、可选父级(用于嵌套)和用于排序的 position。
主要能力:提供专用脚本操作文档,禁止使用原始 db-exec SQL。list-documents 以树形列出文档元数据(不返回正文);search-documents 按标题和内容搜索,返回片段;get-document 按 ID 获取单篇完整内容;create-document 新建文档,支持 --parentId 嵌套与 --icon 图标;edit-document 用查找替换做局部修改,支持批量 --edits;update-document 用于整体重写或新内容;delete-document 递归删除文档及其所有子文档。评论为 Notion/Google-Docs 风格的行内评论,通过 ProseMirror 装饰层高亮,不写入 Markdown 正文,支持 @提及、回复、解决与重新打开。
使用方式:通过 pnpm action 调用各脚本,例如 pnpm action list-documents、pnpm action get-document --id abc123、pnpm action create-document --title "Meeting Notes" --content "..."、pnpm action edit-document --id abc123 --find "old text" --replace "new text"。任何创建、更新或删除操作后都应运行 pnpm action refresh-list 刷新侧边栏。
适用场景:需要以脚本方式维护文档树、搜索文档、做局部文本修改或管理行内评论时。
限制:文档正文为 Markdown;父子层级通过 parent_id 构成树,删除父级会递归删除子级;position 决定同一父级下的排序。其余未在资料中说明的细节暂未提供。