# 晨风书舍 — CHANGELOG

> **当前版本：V1.12.15** | 2026-06-02

---

## V1.12.15 — 2026-06-02

**修复：OpenLibrary 占位图根治**

- OpenLibrary URL 加 `?default=false`，无封面时直接返回 404 而非占位图
- 彻底解决尺寸检查无法拦截"合法尺寸但内容为空"占位图的问题

---

## V1.12.14 — 2026-06-02

**修复：豆瓣封面也可能返回小占位图**

- `tryDoubanCover` 拿到 URL 后用 `tryImg` 验证尺寸，占位图不再存入
- `fetchCover`（单书扫码流程）豆瓣部分同步加尺寸校验

---

## V1.12.13 — 2026-06-02

**修复：OpenLibrary 1×1 占位图被误存为封面**

- `tryImg` 和 `fetchCover` 加尺寸校验（宽高需 > 10px），过滤掉无内容的占位图
- 每次点击「补封面」前先清除已存的无效封面（`_purgeFakeCovers`），再重新抓取

---

## V1.12.12 — 2026-06-02

**修复：封面显示位置错误**

- 封面应在点击书脊弹出的详情面板（`openDetail`）中显示，而非编辑表单
- 有封面时在详情面板标题下方居中显示（最高 140px），无封面时不占位

---

## V1.12.11 — 2026-06-02

**Modal 封面显示**

- 点开书籍详情时，若已有封面图，在标题下方居中显示缩略图（最高 120px）
- 无封面时区域隐藏，不影响录入新书的表单布局

---

## V1.12.10 — 2026-06-02

**重复书提示改进**

- 扫到已录入 ISBN 时，弹确认框显示已有书的书名和位置
- 用户可选择"确定"再录入一本（同书多册），或"取消"跳过
- 取消后自动清空 ISBN 字段并聚焦，继续扫下一本

---

## V1.12.9 — 2026-06-01

**补封面批量抓取优化**

- 运行中点击「补封面」按钮可直接中止，不再弹错误提示
- 按钮运行中显示「停止 (x/total)」，明确进度与可操作性
- 每批完成后立即 `renderShelf()`，封面逐批显示无需等全部结束
- 中止与正常完成显示不同 toast 提示
- 保存逻辑优化：只对本批有封面的书执行 put

---

## V1.12.8 — 2026-06-01

**补封面并行批次 + 豆瓣 CORS 来源**

- 批量获取封面改为并行处理（每批 8 本）
- 新增豆瓣 CORS 代理作为来源 2（中文书覆盖更好）
- 每批完成后保存 IndexedDB，进度实时更新按钮文字

---

## V1.12.7（稳定版）2026-06-01

**修复：** `rebuildLayout()` 中旧代码块未清除导致 `const classes` 重复声明，引发 `SyntaxError`，页面完全无响应。

---

## V1.12.6 — 2026-06-01

**等比例预留分配算法（`proportionalAlloc`）**

- 新增 `proportionalAlloc(classes, totalCells)` 公共函数
- 两步算法：① 存量保底 `ceil(count/15)` ② 剩余格按比例分缓冲
- 确保总格数精确 = 78（不再出现 79 > 78 的溢出）
- Z 类（3本）→ 1 格 → **G13 最后一格（G13-L8）**
- `buildCellPlan()` 和 `rebuildLayout()` 共用同一算法

---

## V1.12.5 — 2026-06-01

**修复统计面板图表空白**

- 根因：顶栏 `<div id="statsBar">` 与统计 canvas `<canvas id="statsBar">` ID 重名
- `document.getElementById('statsBar')` 返回 div，`div.getContext('2d')` 抛 TypeError
- 修复：canvas 重命名为 `statsAuthorBar` / `statsPubBar`
- 修复作者提取：去除"著/编著/主编/译"后缀、括号内年份
- 修复出版社提取：去除年份后缀、"出版集团/出版公司"后缀

---

## V1.12.4 — 2026-06-01

比例分配初版（存在 allocSum=79 的 off-by-one bug，已在 V1.12.6 修复）

---

## V1.12.3 — 2026-06-01

**重排逻辑重写 + 多项改进**

- 重排放置改为顺序填入（去除"跳层"逻辑），彻底消除混放
- 溢出全局兜底：分类区满时找 G1-G13 任意空位，不留书在旧位置
- G14 L1 显示橙色"儿童"列标识，G15 L1 显示紫色"相册"列标识
- L9 底层支持点击编辑自定义标签（手办/杂志/手机盒等）
- 统计面板：移除月度趋势，保留作者 Top10 + 出版社 Top10

---

## V1.12.2 — 2026-06-01

**DeepSeek API 集成**

- 顶栏新增 🤖 按钮，设置/清除 DeepSeek API Key（localStorage 存储）
- 分类优先级：NLC → DeepSeek → 关键词匹配
- 国图失败后的所有数据源（豆瓣/OpenLibrary/Google）自动 await DeepSeek
- 无 ISBN 旧书手动录入时，🔍 搜索后也触发 DeepSeek 分类
- `fillBookData()` 新增 `skipAutoSave` 参数，等 DeepSeek 返回后再保存
- 新增 `applyClcBadge(clc, source)` 统一更新分类 badge

---

## V1.12.1 — 2026-06-01

**手动录入改进 + 混放检测**

- 书名字段旁新增 🔍 按钮，显式触发书名搜索（无 ISBN 时使用）
- `searchByTitle(explicit)` 参数控制触发条件
- 重排弹窗新增混放格子检测，列出所有 CLC 混放的格子名称
- 修复区域文字与坐标文字重叠：有 zone 时清空 `data-label`

---

## V1.12.0 — 2026-06-01

**统计面板重设计**

- 布局：2×2 网格（分类饼图 + 作者排行 + 月度趋势 + 出版社）
- 饼图改为甜甜圈图 + 侧边图例（分类名/数量/占比），不再把文字塞进扇区
- KPI 卡片新增：ISBN 覆盖率、书架利用率
- 出版社 Top5
- 月度录入趋势（近 12 个月）

---

## V1.11.9 — 2026-06-01

**区域可视化**

- 空格显示所属分类名标签（如"I 文学"）
- 所有格子带分类色极淡底色
- 区域首格带左侧/顶部竖线边框
- 有 zone 的空格不再显示无意义的坐标文字

---

## V1.11.8 — 2026-06-01

**布局排序修正**

- 删除硬编码 `LAYOUT_PLAN`
- `buildCellPlan()` 改为动态按 `CLC_ORDER`（A→Z）比例分配
- `allocateLocation()` fallback 限制在 G1-G13，不再进入 G14/G15
- `refreshData()` 每次重置 plan cache

---

## V1.11.7 — 2026-06-01

**书名显示 + 统计修复**

- 书名字数：`≤4本→10字 / ≤9本→8字 / ≥10本→6字`（原为固定 2 字）
- 修复统计按钮无响应：改用 `classList.add/remove('active')`

---

## V1.11.6 — 2026-06-01

**书架层/列规则修正**

- `START_LAYER=3`、`END_LAYER=8`（L1-L2 保留，L9 杂志区）
- `buildCellPlan()` 从 START_LAYER 开始
- L1-L2 渲染为虚线"保留"格，L9 渲染为虚线"杂志区"格
- 统计分母 `/135` → `/78`
- 活跃层 80% 时顶栏显示提示

---

## V1.11.5 — 2026-06-01

**10 项 Bug 修复**

| # | 问题 | 影响 |
|---|------|------|
| 1 | `applyZoom` 未更新 `currentZoom` | 缩放失效 |
| 2 | `CLC_MATCH` 重复 key F/T | 分类关键词丢失 |
| 3 | `renderShelf` L1-L3 书籍不可见 | 已分配书籍不显示 |
| 4 | `renderShelf` 循环到 `l<=10` 超出 9 行网格 | L10 布局错乱 |
| 5 | `updateStats` 显示 "X/135/135" | 统计重复 |
| 6 | `moveBook` position 差一 | 拖拽位置错误 |
| 7 | `importCSV` 不更新 `booksByLocation` | 批量导入位置冲突 |
| 8 | `fillBookData` 未传 `dbText` | 豆瓣关键词未用于分类 |
| 9 | `tryFetch` 非 AbortError 中断查询链 | 网络错误跳过备用源 |
| 10 | `mouseout` tooltip 永不消失 | tooltip 卡住 |

另：移除重复 Ctrl+Wheel 监听器

---

## V1.11.4 — 2026-06-01

**功能版本：云备份、封面、CSV、统计、9层书架**

- 云端备份/恢复（自动 + 手动）
- 封面显示（OpenLibrary）+ 补封面按钮
- CSV 导入导出（UTF-8 BOM）
- 统计面板（饼图 + 柱状图）
- 9 层书架（L1-L9）
- Ctrl+滚轮缩放