用途：把本地文档批量导入 WPS 笔记，来源包括 Obsidian Vault、思源笔记、微信公众号存档、下载目录或任意指定目录，递归扫描子目录并自动识别来源类型。
主要能力：支持 .html、.md、.pdf、.docx、.pptx、.xlsx、.txt、.sy 等格式；HTML 解析内联样式保留颜色、粗体、标题，Markdown 转 WPS XML，PDF 用 pdfplumber 提取文本与图片，DOCX 经 pandoc 转 Markdown，PPTX 用 markitdown，XLSX 用 pandas 转表格；图片以 base64 或 URL 插入。
使用方式：写入统一走笔记 Agent 工具（create_note、get_note_outline、batch_edit、insert_image、read_note/read_blocks、search_notes、sync_note）。流程为确定扫描目录、扫描文档清单、展示清单并询问导入范围、按标题去重、转换导入、输出进度。可参考自带脚本 scripts/scan_docs.py 与 scripts/import_to_wps.py。
限制与注意：get_note_outline 默认只返回 100 个 block，需用 read_blocks 翻页；旧版 WPS（<0.1.4）insert_image 只能插到前台笔记，新版已修复；list_notes 数据过大时应用 search_notes 收敛；连续 batch_edit 可能导致 anchor 失效，需重试并刷新 anchor；BATCH_SIZE 建议为 4。依赖 beautifulsoup4、lxml、pandoc、pdfplumber、markitdown、pandas、pillow 等，缺失需自行安装。扫描版 PDF 需 OCR。具体收费、平台支持范围等资料暂未提供。