为知笔记文档同步

要解决什么问题

团队如果把文档放在为知笔记（WizNote）里，又希望在 Git 仓库里保留可读副本，就会遇到两套路径：服务端分类树、本地目录结构，以及「以谁为准」的同步顺序。公开版技能刻意去掉硬编码的服务器地址、账号和本机 home 路径，改由你自己提供 WIZNOTE_BASE_URL、WIZNOTE_USER、WIZNOTE_PASSWORD，以及 category_root 与 repo_root，适合内网笔记服务器或自建 WizNote 实例。

技能如何工作

设计原则是 WizNote 为权威源，本地仓库为镜像。同目录下的 wiznote_cli.py 与 wiznote_helper.py 封装登录、列笔记、拉取 HTML、创建/更新笔记等能力，例如 login(...)、fetch_note_list(...)、fetch_note_html(...)、create_note(...)、save_note(...)。典型流程：用 normalize_category_root(...) 规范化分类根，登录一次并复用 login.token、login.kb_server、login.kb_guid；读路径上 resolve_category(...) 定位分类 → 列笔记 → 下载 HTML → 必要时写入本地；写路径上先把 Markdown 转成 HTML（create_note/save_note 不接受裸 Markdown），在 WizNote 更新后再刷新镜像，并用 mirror_output_path(repo_root, category_root, category, title) 生成本地路径，避免手工拼标题导致路径逃逸。

适用边界与注意点

• 仅在与用户明确提到 WizNote、为知笔记、内网笔记同步或「文档镜像」时使用；不要套用到其它文档系统。
• 写入时先更新 WizNote，再更新本地镜像；不要只改仓库副本。
• 分类路径应落在配置的 category_root 之下；批量操作不要每条笔记都重新登录。
• 发布或分享技能副本时，勿把服务器 URL、凭据、私有目录写进共享内容。