web-importer（网络导入器）

Web Importer — 网页高质量导入 WPS 笔记

将网页或微信公众号文章直接导入 WPS 笔记，保留原文的颜色、粗体、标题推断、blockquote 高亮块，图片按位置插入。 现已支持 X/Twitter 推文和 Thread：统一通过 web_fetch 获取当前可见内容，抓到图片链接时按原文位置插入笔记。

核心原则

不要把抓取回来的 Markdown 原样写进 WPS 笔记。当前入口是 web_fetch / web_search，抓回来的主内容需要先整理为 WPS XML，再写入笔记；图片仍然单独插入。

正确路径：

网页 URL
  ↓
web_fetch / web_search / batch_web_search
  ↓
网页正文 + 图片链接
  ↓
整理成 WPS XML
  ↓
create_note + batch_edit（正文 + 图片占位符写入 WPS）
  ↓
get_note_outline / read_blocks（找占位符）
  ↓
insert_image（逐张插图）

快速使用

# 用户直接给 URL
web_fetch "https://mp.weixin.qq.com/s/xxxxx"
create_note
batch_edit
insert_image
sync_note

# 用户只给标题或模糊描述
web_search "文章标题或关键词"
ask_user（候选链接不唯一时）
web_fetch "确认后的 URL"
create_note
batch_edit
insert_image
sync_note

两种模式对比

X/Twitter 支持说明

X 的内容仍然可能受到动态渲染、登录态和线程展开限制影响。当前 Skill 统一依赖 web_fetch 返回的可见正文和图片链接，不额外假设浏览器渲染能力。

工作流程

X 推文 URL
  ↓
web_fetch 获取当前可见正文
  ↓
提取正文 + 图片链接
  ↓
整理成 WPS XML
  ↓
写入 WPS 笔记

注意事项

html_to_segments 解析逻辑

当前不再依赖 html_to_segments 本地脚本，但处理目标不变：把网页结构整理为 WPS XML，并尽量保留原文层级和重点样式。

网页内容 → WPS XML 映射

颜色映射精度

如果抓取结果能明确保留颜色语义，可在 WPS XML 中映射到可用样式；如果抓取结果已丢失颜色信息，就不要伪造颜色。

section 展平逻辑

网页存在多层嵌套时，按最终阅读顺序展平为标题、正文、引用、列表、表格和图片占位符，再写入 WPS。

WPS 写入稳定性规则

与现有笔记编辑工具的稳定写入规则保持一致，关键约束如下：

正文优先用 batch_edit
少量修补可用 edit_block
图片只能用 insert_image
编辑前必须先拿到 block_id

anchor 失效重试：图片插入或补写前，如果 block_id 已变化，先重新 get_note_outline，必要时再 read_blocks 精确定位。

outline 翻页：长文导入后如果需要回找图片占位符或补写位置，先重新获取最新 outline，再按需要分段读取。

防重复插图：重试时先回读当前笔记，确认图片是否已经插入，避免重复写入。

下载后的目录结构

当前 Skill 的最终产物是 WPS 笔记，不要求保留本地下载目录。导入完成后，笔记中至少应有：

笔记标题
来源信息（原网页链接）
正文结构（标题 / 段落 / 引用 / 列表 / 表格）
按位置插入的图片

微信公众号标题提取优先级

按顺序尝试：

1. web_fetch 返回的页面标题
2. web_search 命中的候选标题
3. 用户在请求里明确给出的文章标题
4. 以上均失败 → 用链接或“未命名文章”作为兜底

异常处理

依赖项