xhs-note-batch-export
功能描述
把任意指定xhs博主的公开笔记批量导出为本地 Markdown 文件。每篇笔记一个 md，包含：标题、原文链接（带 xsec_token）、正文文字、图片/视频 URL（仅存 URL，不下载本地）、互动数（赞/藏/评）。用于对标分析、内容研究、长期备份、喂 AI 等场景。
前置条件
- wc3-chrome 扩展已安装，relay 服务已启动（Extension Relay HTTP API，端口 3459）
- 浏览器已登录xhs（未登录可能只能看到部分笔记或触发登录页）
- 本 skill 为纯浏览器自动化，不含 LLM 子会话，无需 pipeline 子会话服务
使用方式
node skill.mjs <input.json>
stdout 只输出一行 JSON：{ status, summary, output_dir }，status 为 success / partial / failed。
入参（input.json）
profileUrl（string，必填）：博主xhs个人主页 URL，如https://www.xiaohongshu.com/user/profile/<24位hex>?xsec_token=...count（number，可选，默认 10）：本次导出笔记数量上限；设 -1 或 0 表示导出全部可达笔记offset（number，可选，默认 0）：从第几篇开始导出（分批/断点续导）parallel（number，可选，默认 1，上限 3）：详情抓取并发 tab 数，超过 3 按 3 处理outputDir（string，可选，默认/tmp/xhs-note-batch-export-output/）：md 输出目录；若提供output_dir（绝对路径）则以它为准output_files（object，可选）：{ data, result }自定义 data.md / res.json 文件名
输出格式
<outputDir>/ 下每篇笔记一个文件 <序号>_<笔记名>.md（序号从 offset 延续递增，笔记名取标题去非法字符并截断 50 字符），外加汇总文件：
# <标题>
原文链接: https://www.xiaohongshu.com/explore/<note_id>?xsec_token=...
互动: 赞<赞数> 藏<藏数> 评<评论数>（互动数未读到标 (partial)）
---
<正文文字>
---
图片: <URL1> <URL2> ...（若有）
视频: <视频URL>（若有）
summary.json：{ total_exported, offset, count, parallel, total_available, skipped_partial: [note_id...], failures: [...] }res.json：状态/摘要元信息（pipeline 约定）data.md：全部记录数据（pipeline 约定）
注意事项
- 博主主页是虚拟列表，DOM 只保留视口附近卡片，脚本通过滚动持续收集，进度以 note_id 去重集合判断
- 排序 = 博主主页笔记 tab 默认排序（最新发布在前），脚本按页面实际顺序取数，不做额外排序
- 详情抓取并发上限 3（
parallel）；若页面跳转至登录/验证页，脚本会停止操作并提示用户手动处理，不自动重试 - 互动数渲染慢于正文，脚本会轮询最长约 18s，仍缺则该篇标记
(partial)
