书放哪了—图书录入｜书架整理｜阅读笔记（Obsidian 插件）

把「书放哪了」微信小程序里的藏书、阅读计划、读书笔记同步进 Obsidian vault，并以书架网格界面浏览。

安装和启用：

1. 打开obsidian的设置界面，找到第三方插件，打开社区插件市场，搜索“书放哪了”，安装插件。
2. 从“已安装插件”中，启用“书放哪了”。
3. 从左侧工具栏找到“书放哪了”

书籍同步：

1. 点左侧「📚」打开书架面板（或 Cmd/Ctrl+P 搜「打开书架」），或者右键「📚」。
2. 点「同步」按钮，会生成小程序码。
3. 二选一扫码：
   • **微信「扫一扫」**扫小程序码
   • 从小程序的“更多”Tab页，进入“同步到obsidian”，点「扫码同步」。
4. 等待同步完成。

同步内容（写入 vault）

• 藏书：书放哪了/<中图分类号> - <书名>.md（分类号缺失时前缀为 未分类；分类号有多行时只取第一行）
• 计划 + 笔记：书放哪了/笔记/<中图分类号> - <书名>.md（该书无阅读数据则不生成）
• 书架总览：书放哪了/书架总览.md（书架 → 层 → 格）

增量策略：文件不存在则创建，内容变化才更新。

反向同步（把 Obsidian 的修改传回）

在 Obsidian 里改过的藏书信息字段（属性面板里的可改字段）可以回传小程序，同样扫码：

1. 命令面板执行「反向同步（把 Obsidian 的修改传回小程序）」（或设置页「回传修改」按钮）。
2. 插件与上次同步的基线对比，只挑出真正改过的字段/书。
3. 生成一次性二维码，用小程序扫码确认 → 后端把这些字段应用到你的书上（复用既有更新接口）。
4. 插件显示逐条回执（成功 / 失败原因），成功项刷新基线。

• 只上传改动字段，不动未改的书；元数据（书名/作者/… ）永远不会被回传（只读）。
• 护栏：若检测到未回传的改动，正向同步会被阻止（否则服务器值会覆盖你的编辑）——先反向同步再正向同步。

书架视图

左侧栏「📚」图标打开侧边面板，卡片网格展示藏书（封面 / 书名 / 作者 / 位置 / 在架状态 / 阅读状态）。点击卡片进入书籍详情页。同步完成后会自动刷新。

筛选维度对齐小程序「找书」页，全部在本地完成

控件	说明
搜索	书名 / 作者 / 出版社 / ISBN / 位置 / 分类 / 标签
分类	选项从库里现有笔记汇总
书标签	同上（单选取一个标签；小程序是本地多选）
在架状态	固定 5 项：在架 / 出借 / 赠送 / 卖出 / 遗失
阅读状态	固定 4 项：正在读 / 已搁置 / 已读完 / 还没读
排序	书名 / 作者 / 中图分类 / 购入日期（新→旧）

设置项

• 同步目录：藏书笔记写入的文件夹，默认 书放哪了。
• 立即同步：一键发起一次二维码同步（下载）。
• 反向同步：把笔记里改过的藏书信息回传小程序（上传）。

许可证（闭源专有）

This plugin is closed source. 源码不公开；main.js 是未混淆的标准 esbuild 产物，仍可阅读以审查插件行为。本插件是「书放哪了」小程序服务的配套客户端，无需公开实现细节。

许可证为专有许可，全文见 LICENSE（Copyright (C) 2026 crabeater, All rights reserved）：

• 免费使用：在 Obsidian 中安装运行；个人、家庭、学习研究，以及非营利组织 / 教育机构 / 政府机构等非商业用途。
• 需事先书面授权：任何商业用途（通常也包括公司、企业内部使用）。
• 不允许：复制、修改、制作衍生插件、再分发、转售、再许可、移除内嵌声明、用于训练机器学习模型。

第三方组件：打包进 main.js 的 qrcode 采用 MIT License，Copyright (c) 2012 Ryan Day —— 声明原文见 THIRD_PARTY_NOTICES.md，并已内嵌在 main.js 顶部注释里。