Skip to content

Releases: GitBinS/xhs-importer-pro

XHS Importer Pro 1.0.14

Choose a tag to compare

@GitBinS GitBinS released this 30 Sep 06:28

XHS Importer Pro 1.0.14

本版只改一件事:插件的显示名。逻辑代码与 1.0.13 完全一致(main.js 逐字节相同)。

变更

  • 显示名:xhs-importer-pro → XHS Importer Pro
    与同作者的另一个插件 XHS Product Search 统一为「空格分隔 + 首字母大写」写法 —— 读起来更自然,在社区搜索里也更容易命中。

使用提示

  • ⚠️ 插件 id 没有变,仍是 xhs-importer-pro。你的插件配置、插件目录名、去重索引(imported-notes.json)全部以 id 为准 —— 不需要重装、不需要重设。
  • 更新后 Obsidian 里显示的名字会变成 XHS Importer Pro,但插件文件夹名仍是 xhs-importer-pro(目录名以 id 为准,这是正常的)。
  • 本版没有功能改动;如果你对名字不敏感,跳过这版也不影响使用。

测试

dev/verify.mjs 43 项断言全部通过(未改动逻辑,跑一遍确认无回归)。

xhs-importer-pro 1.0.13

Choose a tag to compare

@GitBinS GitBinS released this 18 Sep 17:55

xhs-importer-pro 1.0.13

本版相对 1.0.12:字段名全部中文化、设置页可读化,并修掉 3 个真实使用中发现的 bug。

新增

  • 设置页的占位符列表改为逐条中文说明 —— 原先只是三行 {{...}} 堆砌,看不出 {{collectedCount}} 是"收藏数"。现在每个占位符单独一行并附说明。
  • 加一句澄清:字段名(写进笔记顶部的属性名)vs 占位符(只在字段的「默认值」里用、不会出现在笔记中)。

变更

  • frontmatter 字段名全部中文化:created→创建日期、published→发布日期、author→博主、source→笔记链接。
    最终 12 个键:type / aliases / 创建日期 / 发布日期 / 博主 / 笔记链接 / 点赞 / 收藏 / 评论 / 转发 / tags / 上级概念
    —— 仅 type(Bases 过滤锚点)与 aliases / tags(Obsidian 内置属性)保留英文,三者都是技术必需。
  • 「笔记链接」移到「博主」之后,与配套知识库的卡片字段顺序一致。

修复

  • 创建日期 差一天:原先取 UTC 日期,东八区 00:00–08:00 之间导入会被写成前一天(实测:09-19 00:43 导入写成 2026-09-18)。现在与「发布日期」共用同一套本地日期逻辑,不再两套口径。
  • 单条导入不走去重索引:原先只有批量导入读写索引,单条导入既无去重保护(重复导入会静默生成 标题-1.md 副本),批量导入也认不出它。现在两条路径完全一致:读索引 → 校验笔记是否仍在仓库 → 写回。
  • 正文残留"看不见的空行":零宽空格(U+200B)、零宽连接符(U+200C/D)与韩文填充符(U+3164,即 ㅤ)不属 \s,原判定看不出来。现在四种变体统一归一为真空行;行内的不可见字符保持不动(作者有意用来隔词)。

使用提示

  • 重导同一篇前先删掉已导入的笔记,否则会被判为重复并跳过 —— 判定依据是"笔记是否仍在仓库里",删掉即可重新导入。
  • 从 1.0.12 升上来时,已有笔记里的旧英文键不会自动改名,只有新导入的笔记使用中文键。

测试

dev/verify.mjs 43 项断言全部通过,含时区回归测试(本地构造 00:43,任何机器上退回 UTC 实现即失败)、四种伪空行的断言、以及"新增占位符却忘记写设置页说明即失败"的守门断言。

xhs-importer-pro 1.0.12

Choose a tag to compare

@GitBinS GitBinS released this 17 Sep 05:31

把小红书笔记导入 Obsidian 知识库:正文、全部图片、话题标签、作者信息与互动数据,落成本地 Markdown。

功能概览

  • 从分享链接导入 —— 支持 xhslink.com/xhslink.cn 短链、App 与网页分享链接
  • 批量导入 —— 一次粘贴多条链接,单次上限 20 条,请求间随机节流 1.5–3.5 秒
  • 按笔记 ID 去重 —— 删掉笔记后可重新导入
  • 图片全部下载到本地 —— 同名图片已存在时直接复用
  • 互动数据 —— 点赞 / 收藏 / 评论 / 分享数写入 frontmatter
  • 发布时间与作者 —— 含真实发布时间、作者昵称 / ID / 主页链接
  • 落点与 frontmatter 可配、界面中英双语

完整功能、可用占位符、安装步骤与配置示例见 README。

本版变更(1.0.12)

移除作者主页抓取功能,以及配套的「补抓作者的缺失信息」命令。

作者的小红书号只在作者主页下发,而该接口限流严格 —— 连发请求会被重定向到登录页,批量导入时多数笔记拿不到,加节流与重试后仍不稳定,故移除。{{authorRedId}}、{{authorDesc}}、{{authorFans}}、{{authorIpLocation}} 四个占位符一并删除。

保留 {{authorUrl}} —— 由作者 ID 直接拼出,不需要额外请求,点开即可在主页看到小红书号。

累计修复

  • 图文笔记封面图重复插入
  • 图片链接写成相对路径导致引不到图 → 改为库根绝对路径
  • 图片文件名丢 emoji 与中文标点;长名截断切断 emoji
  • 正文保留源文本的 tab 伪空行(视频与图文两条分支均已修)
  • 去重索引只增不减 → 删掉笔记后重导被误判重复
  • 重新导入时图片重复下载成 -1/-2 副本
  • 界面文案硬编码英文 → 改为跟随 Obsidian 语言

本仓库当前只保留此一个发布版;更早版本的变更记录见 CHANGELOG。