wiznote

name	wiznote
description	通过本地运行的 WizNotePlus 读取、创建、更新、移动和整理为知笔记内容。适用于用户要求读取笔记、写入笔记、搜索笔记、归档笔记、总结笔记并写回、按目录或 SQL 条件批量整理为知笔记的场景。

WizNote

这个 skill 通过本地运行的 WizNotePlus 操作为知笔记，不直接重写云端同步协议。

何时使用

• 用户要读取某篇为知笔记正文
• 用户要创建、更新、移动为知笔记
• 用户要按目录、时间、SQL 条件筛选笔记
• 用户要总结一批笔记，再把整理结果写回为知

先决条件

先执行：

node /Users/sunqb/data/documents/skills/wiznote-skills/wiznote/scripts/wiznote-bridge.mjs ping

如果失败：

• 确认 WizNotePlus 正在运行
• 确认本地端口 127.0.0.1:8848 可用
• 首次连接时在 WizNotePlus 中允许 http://localhost
• 或手动在 ~/.wiznote/allowedOrigins 增加一行 http://localhost

标准流程

1. 先 ping
2. 再列目录或搜索笔记，确认目标范围
3. 单篇读取用 read，批量整理用 collect
4. 由模型完成总结、改写、归档决策
5. 单篇操作用 create / update / move
6. 批量迁移优先用 bulk-move，默认先预览，再 --apply

常用命令

列目录：

node /Users/sunqb/data/documents/skills/wiznote-skills/wiznote/scripts/wiznote-bridge.mjs list-locations

列标签：

node /Users/sunqb/data/documents/skills/wiznote-skills/wiznote/scripts/wiznote-bridge.mjs list-tags

按 SQL 条件查笔记：

node /Users/sunqb/data/documents/skills/wiznote-skills/wiznote/scripts/wiznote-bridge.mjs search \
  --sql "DOCUMENT_LOCATION not like '/Deleted Items/%' order by DT_CREATED desc limit 20"

读取笔记正文：

node /Users/sunqb/data/documents/skills/wiznote-skills/wiznote/scripts/wiznote-bridge.mjs read --guid <guid>

批量采集正文，适合做总结或整理前分析：

node /Users/sunqb/data/documents/skills/wiznote-skills/wiznote/scripts/wiznote-bridge.mjs collect \
  --sql "DOCUMENT_LOCATION not like '/Deleted Items/%' order by DT_CREATED desc limit 10" \
  --limit 10 \
  --max-html-chars 12000

如果上一轮已经拿到了目标 GUID，也可以直接：

node /Users/sunqb/data/documents/skills/wiznote-skills/wiznote/scripts/wiznote-bridge.mjs collect \
  --guids guid1,guid2,guid3

新建笔记：

node /Users/sunqb/data/documents/skills/wiznote-skills/wiznote/scripts/wiznote-bridge.mjs create \
  --title "标题" \
  --location "/My Notes/" \
  --html "<p>正文</p>"

更新笔记：

node /Users/sunqb/data/documents/skills/wiznote-skills/wiznote/scripts/wiznote-bridge.mjs update \
  --guid <guid> \
  --title "新标题" \
  --html "<p>新正文</p>"

移动笔记：

node /Users/sunqb/data/documents/skills/wiznote-skills/wiznote/scripts/wiznote-bridge.mjs move \
  --guid <guid> \
  --location "/My Notes/Archive/"

批量移动笔记，默认只预览：

node /Users/sunqb/data/documents/skills/wiznote-skills/wiznote/scripts/wiznote-bridge.mjs bulk-move \
  --sql "DOCUMENT_TITLE like '%周报%' order by DT_MODIFIED desc limit 20" \
  --location "/My Notes/Archive/"

确认后真正执行：

node /Users/sunqb/data/documents/skills/wiznote-skills/wiznote/scripts/wiznote-bridge.mjs bulk-move \
  --guids guid1,guid2 \
  --location "/My Notes/Archive/" \
  --apply

设置文档参数：

node /Users/sunqb/data/documents/skills/wiznote-skills/wiznote/scripts/wiznote-bridge.mjs set-param \
  --guid <guid> \
  --name MY_PARAM \
  --value MY_VALUE

整理策略

• 先用 search 缩小范围，不要一开始读取全库
• 批量整理正文时，优先用 collect，不要循环调用很多次 read
• 批量迁移时，优先用 bulk-move 做预览；确认后再加 --apply
• 批量整理时，先输出将要修改的 GUID、原标题、目标目录
• 对移动、覆盖更新这类操作，默认先让用户确认
• 对“总结后写回”，优先新建汇总笔记，除非用户明确要求覆盖原文

读取更多信息

需要对象模型、底层 API 映射或 SQL 示例时，再读：

• references/wiznoteplus-local-api.md

不要把上游 WizNotePlus 全仓库大段加载进上下文，优先调用 bridge CLI。