Releases: GitBinS/xhs-importer-pro
Releases · GitBinS/xhs-importer-pro
Release list
XHS Importer Pro 1.0.14
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
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
把小红书笔记导入 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。