dsh-weread-gather 1.1.0 → 1.1.2

package/README.md

@@ -16,6 +16,8 @@
 
 总览：置顶的年度阅读热力图，KPI、月度分布与表盘都跟着右上角的年份切。
 
+配色是浅绿纸感（页面 `#F6F8F7`、强调绿 `#4F9274`、热力图五档 `#EDF2EF → #438765`），通过重映射 `--dsw-alias-*` 跟随宿主的亮/暗主题。
+
 ![总览](assets/screenshot-2-overview.png)
 
 ## 安装
@@ -51,8 +53,9 @@ dsh plugin --profile <profile> add link:D:/path/to/dsh-weread-gather
 | 笔记 | 全部划线按时间倒流，**每页 24 条翻页**、按书筛选、关键词搜索、**单条复制**、**点卡片跳到该书详情** |
 | 想法 | 想法卡片墙（瀑布流式多列），**每页 20 条翻页**、按书筛选、关键词搜索、**单条复制**、**点卡片跳到该书详情（自动切到想法页）**、星级与章节 |
 | 书籍详情 | 封面、作者、大类 + 细分分类/读完/评分/出版社/出版年徽章、简介、该书全部划线 + 想法（每页 24 条翻页、可复制）、一键在微读打开、**「导出这本书」直接生成整本 Markdown** |
-| 全局搜索 | 顶栏搜索同时搜书名、作者、分类、划线正文、想法正文；结果按**书籍 / 划线 / 想法**分类切换，命中的关键词在卡片里高亮；`⌘K` / `Ctrl+K` 随时聚焦搜索框 |
+| 全局搜索 | 顶栏搜索同时搜书名、作者、分类、划线正文、想法正文；结果按**书籍 / 划线 / 想法**分类切换，命中的关键词在卡片里高亮 |
 | 导出 Markdown | 划线/想法卡片左上角圆圈勾选（悬停出现）→「导出所选」；也可「导出全部结果」或只导出某一本。导出面板可关掉原文/想法/书籍信息/章节标题/星级/微读链接，**先预览前 30 行**，再选择复制、下载 `.md` 或直接保存到导出目录（默认 `$DSH_HOME/weread-gather/exports/`，同名自动加 `-2` 序号） |
+| 同步提示 | 同步进行中在页面顶部显示进度条，完成后停留 8 秒自动消失，也可以随时点右侧 `×` 关掉；数据没变化时同步只花 2~3 秒 |
 | 设置 | 展示 Key 来源（环境变量或手填）、书架上限、每本书同步笔记条数、单次补全书籍信息上限、**Markdown 导出目录**、**下载备份 / 导入备份（两步确认，导入前自动另存当前数据）**、清空数据 |
 
 每一项（书架/笔记/想法/搜索/书籍详情内的列表）都有自己的搜索框；顶栏搜索是跨模块的全局搜索。
@@ -121,6 +124,17 @@ tags: ["微信读书"]
 
 这两类结果缓存在 `heat.json`：**已过年份永久缓存**，当年缓存 30 分钟后过期重取，所以切年份几乎瞬时。
 
+### 同步是增量的
+
+每次同步先读 `sync-state.json` 这本账，只处理「真的变了」的书：
+
+- 书架、分类、笔记本清单每次都读（清单约 5 个请求，且它是未在书架前 400 本里的书的主要来源，所以不能提前停）
+- 四套阅读统计 **6 小时**内直接复用，不重新请求
+- 每本书按 `lastNoteTime / noteCount / reviewCount` 三项比对：没变化的书**不重拉划线**，旧划线/想法直接沿用
+- 单次最多细读 `maxBooks` 本（默认 60）；账本会记下还有多少本从未细读过（`pending`），需要补齐时在设置里点「强制全量重建」
+
+实测：本机 779 本 / 694 条划线的库，首次全量约 8.4 秒，之后没有变化的同步 **2~3 秒**（`更新 0 本 · 跳过 470 本`）。
+
 ## 数据落点与隐私
 
 ```
@@ -129,8 +143,9 @@ $DSH_HOME/weread-gather/
   data.json     书架 + 分类 + 划线 + 想法 + 阅读统计
   meta.json     每本书的元信息缓存（bookId -> 分类/简介/出版社/出版年/评分）
   heat.json     逐年热力图与年度聚合缓存（{ "2025": { v, at, days, annual } }）
+  sync-state.json  同步账本（上次同步时间、每本书的计数与是否细读过、统计缓存时间）
   exports/      Markdown 导出（默认目录，可在设置里改）
-  backups/      导入备份前自动留存的旧数据（<时间戳>/ 四个 JSON）
+  backups/      导入备份前自动留存的旧数据（<时间戳>/ 五个 JSON）
 ```
 
 - 所有数据都在这一个目录里，插件不写别处；`data.json` 只在同步时整体重写，页面读内存副本
@@ -150,9 +165,9 @@ $DSH_HOME/weread-gather/
 | POST | `/export` | `{ selector, options, mode }`：`selector` 用 `bookIds` / `noteIds` / `thoughtIds`，`mode: 'preview'` 只回 Markdown、`'file'` 落盘；**空 selector 会报错，不会导出全部** |
 | GET | `/export/dir` | 当前导出目录与是否已存在 |
 | POST | `/export/dir` | 改导出目录（会先写探针文件确认可写，失败回滚） |
-| GET | `/backup` | 一次性备份包 `{ format, files: { config/data/meta/heat } }`，`config.json` 已剔除 apiKey |
+| GET | `/backup` | 一次性备份包 `{ format, files: { config/data/meta/heat/sync-state } }`，`config.json` 已剔除 apiKey |
 | POST | `/restore` | `{ bundle }`：校验后先复制旧数据到 `backups/<时间戳>/`，再写回；config 合并时保留本机 apiKey |
-| POST | `/sync` | 触发一次同步（异步，立刻返回进度；用 `/state` 或 `/sync` 轮询） |
+| POST | `/sync` | 触发一次同步（异步，立刻返回进度；用 `/state` 或 `/sync` 轮询）。`{ "full": true }` = 忽略账本强制全量重建 |
 | POST | `/config` | 改 apiKey / maxBooks / notesPerBook / metaLimit |
 | POST | `/reset` | 清掉手填的 Key |
 
@@ -163,8 +178,9 @@ $DSH_HOME/weread-gather/
 ```bash
 node --check index.js && node --check client.js   # 语法
 node scripts/check.cjs                            # 组件引用 / locale 键对称 / 宿主-客户端契约 / 包身份一致性
-node scripts/render-smoke.cjs                     # 用极简 hooks 运行时把 10 种视图各渲染一遍
+node scripts/render-smoke.cjs                     # 用极简 hooks 运行时把 11 种视图各渲染一遍
 node scripts/export-selftest.cjs                  # 45 项 Markdown 导出断言（front-matter、哈希、批量、隔离）
+node scripts/sync-selftest.cjs                    # 10 项增量同步断言（重拉判定、账本搬运），不联网
 ```
 
 三个脚本都不依赖浏览器：`render-smoke.cjs` 自建了极简 hooks 运行时，把 `client.js` 放进 `vm` 里逐个视图渲染，断言不会退化成加载态、笔记/想法必须带分页与复制控件；`export-selftest.cjs` 直接 `import` 宿主的 `__internals`，拿真实 `data.json` 跑导出断言。两者默认读 `~/.dsh/weread-gather/data.json`，可用 `WEREAD_DATA` 指到别的数据文件（需要一个已经同步过的数据集）。
@@ -172,7 +188,9 @@ node scripts/export-selftest.cjs                  # 45 项 Markdown 导出断言
 ## 已知限制
 
 - 「其他」桶里的书是微读自己的数据缺口：多半是 `CB_` 前缀的导入文档 / PDF，`/book/info` 也不返回分类，无法自动归类。
-- 笔记同步按「最近有笔记的 N 本书」（默认 60 本）展开，不是全量；把 `maxBooks` 调大可多抓，代价是请求数线性增长。
+- 笔记同步按「最近有笔记的 N 本书」（默认 60 本）展开，不是全量；账本会记下还有多少本从未细读过（同步结果里的 `pending`）。想补齐就在设置里点「强制全量重建」，或把 `maxBooks` 调大（代价是请求数线性增长）。
+- 增量同步依赖 `sync-state.json` 这本账；删掉它不会丢数据，但下一次同步会按全量走一遍。
+- 主题跟随宿主亮/暗主题的方式是重映射 `--dsw-alias-*` token；深色模式下纸感配色会被压暗，观感与浅色模式不同。
 - `/book/info` 实测不返回字数（文档有写、回包里没有），所以卡片上用的是出版年而不是字数。
 - 微读的 `/readdata/detail` 只在 `mode: overall` 时给 24 小时时段分布，年/月/周都返回空数组，所以「阅读时段」那张图只能展示累计值，不随年份切换（标题里有标注）。
 - 切到往年后，本周/本月两张卡会隐藏——它们本来就是「当前」的概念；往年的信息由年度 KPI 与月度分布承载。

package/client.js

@@ -18,6 +18,8 @@ window.__ModuleLoader__.load({
     const API = 'dsh-weread/api'
     /** Sidebar entry id; also the key of the center-column panel. */
     const PANEL_ID = 'weread'
+    /** A finished sync message clears itself after this long (ms). */
+    const AUTO_HIDE_MS = 8000
 
     // ------------------------------------------------------------------ copy
     const zh = {
@@ -35,10 +37,10 @@ window.__ModuleLoader__.load({
       'action.searchGlobal': '搜索书架、笔记、想法…',
       'action.save': '保存',
       'action.cancel': '取消',
+      'action.dismiss': '关闭提示',
       'action.clearKey': '清除 Key',
       'action.back': '返回',
       'action.retry': '重试',
-      'action.openWeread': '在微信读书打开',
       'action.loadMore': '加载更多',
       'action.copy': '复制',
       'action.copied': '已复制',
@@ -98,6 +100,8 @@ window.__ModuleLoader__.load({
       'dash.readRate': '文字 / 听书',
       'dash.text': '文字阅读',
       'dash.audio': '有声听书',
+      'dash.heat.none': '无阅读',
+      'dash.heat.future': '还没到',
       'dash.less': '少',
       'dash.more': '多',
       'dash.empty': '还没有阅读统计，先同步一次。',
@@ -189,6 +193,9 @@ window.__ModuleLoader__.load({
       'settings.dirSaved': '已更新导出目录',
       'settings.backup': '下载备份',
       'settings.backupHint': '包含书架、划线、想法、统计缓存与本机设置，不含 API Key。',
+      'settings.fullSync': '强制全量重建',
+      'settings.fullSyncHint': '平时只同步有变化的书；重建会重新拉取全部笔记与想法，比较慢。',
+      'settings.fullSyncStarted': '已开始全量重建，完成后会刷新数据',
       'settings.restore': '导入备份',
       'settings.restorePick': '选择备份文件',
       'settings.restoreConfirm': '将用备份覆盖本机数据，会先把当前数据另存一份。确定恢复吗？',
@@ -215,10 +222,10 @@ window.__ModuleLoader__.load({
       'action.searchGlobal': 'Search shelf, notes, thoughts…',
       'action.save': 'Save',
       'action.cancel': 'Cancel',
+      'action.dismiss': 'Dismiss the message',
       'action.clearKey': 'Clear key',
       'action.back': 'Back',
       'action.retry': 'Retry',
-      'action.openWeread': 'Open in WeRead',
       'action.loadMore': 'Load more',
       'action.copy': 'Copy',
       'action.copied': 'Copied',
@@ -278,6 +285,8 @@ window.__ModuleLoader__.load({
       'dash.readRate': 'Text / audio',
       'dash.text': 'E-books read',
       'dash.audio': 'Audiobooks heard',
+      'dash.heat.none': 'No reading',
+      'dash.heat.future': 'Not yet',
       'dash.less': 'Less',
       'dash.more': 'More',
       'dash.empty': 'No reading stats yet — sync once.',
@@ -369,6 +378,9 @@ window.__ModuleLoader__.load({
       'settings.dirSaved': 'Export folder updated',
       'settings.backup': 'Download backup',
       'settings.backupHint': 'Shelf, highlights, thoughts, statistics cache and local settings — API key excluded.',
+      'settings.fullSync': 'Full rebuild',
+      'settings.fullSyncHint': 'Normal syncs only read books that changed; a rebuild re-reads every highlight and is slower.',
+      'settings.fullSyncStarted': 'Full rebuild started — data refreshes when it finishes',
       'settings.restore': 'Import backup',
       'settings.restorePick': 'Choose a backup file',
       'settings.restoreConfirm': 'This overwrites local data (the current copy is saved first). Restore now?',
@@ -408,7 +420,7 @@ window.__ModuleLoader__.load({
     const apiState = () => request('/state')
     const apiData = () => request('/data')
     const apiHeat = (year) => request(`/heat?year=${encodeURIComponent(String(year))}`)
-    const apiSync = () => request('/sync', { method: 'POST', headers: { 'content-type': 'application/json' }, body: '{}' })
+    const apiSync = (options) => request('/sync', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(options && options.full === true ? { full: true } : {}) })
     const apiConfig = (patch) => request('/config', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(patch) })
     const apiReset = () => request('/reset', { method: 'POST', headers: { 'content-type': 'application/json' }, body: '{}' })
     const jsonPost = (path, body) => request(path, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(body === undefined ? {} : body) })
@@ -448,79 +460,82 @@ window.__ModuleLoader__.load({
     function contains(haystack, needle) {
       return haystack !== undefined && haystack !== null && String(haystack).toLowerCase().includes(needle)
     }
-    function wereadBookLink(bookId) {
-      if (typeof bookId !== 'string' || bookId === '' || bookId.startsWith('album:')) return ''
-      return `weread://reading?bId=${bookId}`
+    /** Hard cut for option labels: a long book title must not widen the popup. */
+    function clip(text, max) {
+      const value = text === undefined || text === null ? '' : String(text)
+      if (value.length <= max) return value
+      return `${value.slice(0, Math.max(1, max - 1))}…`
     }
 
     // ----------------------------------------------------------------- styles
     const CSS = `
-.wr-root{display:flex;flex-direction:column;height:100%;min-height:0;width:100%;box-sizing:border-box;background:var(--dsw-alias-bg-base);color:var(--dsw-alias-label-primary);font-family:inherit}
-.wr-head{flex:none;display:flex;align-items:center;gap:14px;padding:12px 20px;border-bottom:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-layer-1);flex-wrap:wrap}
+.wr-root{--wr-paper:#F6F8F7;--wr-paper-soft:#FFFFFF;--wr-wash:#F0F4F1;--wr-ink:#263C34;--wr-ink-soft:#6B7F74;--wr-ink-mute:#93A49B;--wr-sage:#A6CCB5;--wr-moss:#4F9274;--wr-clay:#A57F5B;--wr-progress:#73AD8A;--wr-track:#F0F4F1;--wr-line:#E7EEEA;--wr-line-2:#DCE6E0;--wr-heat-0:#EDF2EF;--wr-heat-1:#D5E9DD;--wr-heat-2:#A9D3BA;--wr-heat-3:#74B28E;--wr-heat-4:#438765;--dsw-alias-bg-base:var(--wr-paper);--dsw-alias-bg-layer-1:var(--wr-paper-soft);--dsw-alias-bg-layer-2:var(--wr-wash);--dsw-alias-label-primary:var(--wr-ink);--dsw-alias-label-secondary:var(--wr-ink-soft);--dsw-alias-border-l1:var(--wr-line);--dsw-alias-border-l2:var(--wr-line-2);--dsw-alias-brand-primary:var(--wr-moss);--dsw-alias-state-success-primary:#4F7A5B;--dsw-alias-state-warn-primary:#B98A57;--dsw-alias-state-error-primary:#A8574C;display:flex;flex-direction:column;height:100%;min-height:0;width:100%;box-sizing:border-box;background:radial-gradient(900px 420px at 50% -18%,#FFFFFF 0%,transparent 70%),var(--wr-paper);color:var(--wr-ink);font-family:inherit}
+.wr-head{flex:none;display:flex;align-items:center;gap:16px;padding:14px 26px;border-bottom:1px solid var(--dsw-alias-border-l1);background:rgba(255,255,255,.86);backdrop-filter:blur(10px);flex-wrap:wrap}
 .wr-brand{display:flex;flex-direction:column;gap:1px;min-width:0}
-.wr-brand-title{font-size:15px;font-weight:700;letter-spacing:.02em}
-.wr-brand-sub{font-size:11px;color:var(--dsw-alias-label-secondary)}
-.wr-tabs{display:flex;gap:2px;padding:3px;border-radius:10px;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l1)}
-.wr-tab{appearance:none;border:0;background:transparent;color:var(--dsw-alias-label-secondary);font:inherit;font-size:12.5px;padding:5px 12px;border-radius:8px;cursor:pointer;white-space:nowrap;transition:background .12s,color .12s}
+.wr-brand-title{font-size:15.5px;font-weight:700;letter-spacing:.07em;color:var(--wr-ink)}
+.wr-brand-sub{font-size:11px;color:var(--wr-ink-mute);letter-spacing:.05em}
+.wr-tabs{display:flex;gap:2px;padding:4px;border-radius:999px;background:var(--wr-wash);border:1px solid transparent}
+.wr-tab{appearance:none;border:0;background:transparent;color:var(--wr-ink-soft);font:inherit;font-size:12.5px;padding:6px 15px;border-radius:999px;cursor:pointer;white-space:nowrap;transition:background .16s ease,color .16s ease}
 .wr-tab:hover{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-1)}
-.wr-tab[data-active=true]{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-base);font-weight:600;box-shadow:0 1px 2px rgba(0,0,0,.08)}
+.wr-tab[data-active=true]{color:var(--wr-ink);background:var(--wr-paper-soft);font-weight:600;box-shadow:0 1px 2px rgba(38,60,52,.08)}
 .wr-head-right{margin-left:auto;display:flex;align-items:center;gap:8px;min-width:0;flex-wrap:wrap}
 .wr-search{position:relative;display:flex;align-items:center}
-.wr-search input{box-sizing:border-box;height:30px;width:230px;max-width:44vw;border-radius:8px;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-base);color:var(--dsw-alias-label-primary);font:inherit;font-size:12.5px;padding:0 26px 0 10px;outline:none}
-.wr-search input:focus{border-color:var(--dsw-alias-brand-primary)}
+.wr-search input{box-sizing:border-box;height:32px;width:232px;max-width:44vw;border-radius:999px;border:1px solid var(--wr-line-2);background:var(--wr-paper-soft);color:var(--wr-ink);font:inherit;font-size:12.5px;padding:0 28px 0 13px;outline:none;transition:border-color .16s ease,box-shadow .16s ease}
+.wr-search input:focus{border-color:var(--wr-moss);box-shadow:0 0 0 3px rgba(79,146,116,.14)}
 .wr-search input::placeholder{color:var(--dsw-alias-label-secondary)}
 .wr-search-clear{position:absolute;right:4px;width:20px;height:20px;border:0;border-radius:50%;background:transparent;color:var(--dsw-alias-label-secondary);cursor:pointer;font-size:13px;line-height:1;display:flex;align-items:center;justify-content:center}
 .wr-search-clear:hover{background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary)}
-.wr-btn{appearance:none;display:inline-flex;align-items:center;gap:6px;height:30px;padding:0 12px;border-radius:8px;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-base);color:var(--dsw-alias-label-primary);font:inherit;font-size:12.5px;font-weight:500;cursor:pointer;white-space:nowrap;transition:background .12s,border-color .12s}
-.wr-btn:hover{background:var(--dsw-alias-bg-layer-2);border-color:var(--dsw-alias-border-l2)}
+.wr-btn{appearance:none;display:inline-flex;align-items:center;gap:6px;height:30px;padding:0 14px;border-radius:999px;border:1px solid var(--wr-line-2);background:var(--wr-paper-soft);color:var(--wr-ink);font:inherit;font-size:12.5px;font-weight:500;cursor:pointer;white-space:nowrap;transition:background .16s ease,border-color .16s ease,transform .16s ease}
+.wr-btn:hover{background:var(--wr-wash);border-color:var(--wr-sage)}
 .wr-btn:disabled{opacity:.55;cursor:default}
 .wr-btn-primary{border-color:transparent;background:var(--dsw-alias-brand-primary);color:#fff}
 .wr-btn-primary:hover{background:var(--dsw-alias-brand-primary);filter:brightness(1.06)}
-.wr-btn-ghost{border-color:transparent;background:transparent}
-.wr-body{flex:1;min-height:0;overflow:auto;padding:20px 22px 40px}
-.wr-body-inner{max-width:1180px;margin:0 auto}
-.wr-card{background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);border-radius:14px;padding:16px 18px}
-.wr-section{margin-top:18px}
+.wr-btn-ghost{border-color:var(--wr-line);background:var(--wr-paper-soft)}
+.wr-btn-ghost:hover{background:var(--wr-wash);border-color:var(--wr-sage)}
+.wr-body{flex:1;min-height:0;overflow:auto;padding:26px 30px 64px;scrollbar-width:thin;scrollbar-color:#CFD8C6 transparent}
+.wr-body-inner{max-width:1240px;margin:0 auto}
+.wr-card{background:var(--wr-paper-soft);border:1px solid var(--wr-line);border-radius:16px;padding:20px 22px;box-shadow:0 1px 2px rgba(38,60,52,.04)}
+.wr-section{margin-top:22px}
 .wr-section:first-child{margin-top:0}
-.wr-section-title{display:flex;align-items:baseline;gap:8px;margin:0 0 10px;font-size:13px;font-weight:700}
+.wr-section-title{display:flex;align-items:baseline;gap:8px;margin:0 0 12px;font-size:13.5px;font-weight:700;letter-spacing:.03em}
 .wr-section-hint{font-size:11.5px;font-weight:400;color:var(--dsw-alias-label-secondary)}
 .wr-muted{color:var(--dsw-alias-label-secondary);font-size:12px}
 .wr-empty{padding:36px 10px;text-align:center;color:var(--dsw-alias-label-secondary);font-size:13px}
 .wr-empty strong{display:block;color:var(--dsw-alias-label-primary);font-size:14px;margin-bottom:6px}
 .wr-stats{display:grid;grid-template-columns:repeat(auto-fit,minmax(150px,1fr));gap:12px}
-.wr-stat{background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);border-radius:14px;padding:14px 16px}
+.wr-stat{background:var(--wr-paper-soft);border:1px solid var(--wr-line);border-radius:16px;padding:16px 18px;box-shadow:0 1px 2px rgba(38,60,52,.03)}
 .wr-stat-label{font-size:11.5px;color:var(--dsw-alias-label-secondary);letter-spacing:.04em}
 .wr-stat-value{font-size:22px;font-weight:700;margin-top:6px;font-variant-numeric:tabular-nums;line-height:1.15}
 .wr-stat-hint{font-size:11.5px;color:var(--dsw-alias-label-secondary);margin-top:6px;display:flex;gap:10px;flex-wrap:wrap}
 .wr-kpis{display:grid;grid-template-columns:repeat(auto-fit,minmax(112px,1fr));gap:10px;margin-top:14px}
-.wr-kpi{background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);border-radius:12px;padding:10px 12px;min-width:0}
+.wr-kpi{background:var(--wr-paper-soft);border:1px solid var(--wr-line);border-radius:14px;padding:12px 14px;min-width:0}
 .wr-kpi-value{font-size:19px;font-weight:700;font-variant-numeric:tabular-nums;line-height:1.2;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .wr-kpi-label{font-size:11px;color:var(--dsw-alias-label-secondary);margin-top:4px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .wr-kpi-hint{font-size:10px;color:var(--dsw-alias-label-secondary);opacity:.75;margin-top:2px}
 .wr-chip-stat{font-size:11.5px;color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);border-radius:999px;padding:3px 9px;white-space:nowrap}
 .wr-chips{display:flex;gap:6px;flex-wrap:wrap}
 .wr-chip{appearance:none;border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-secondary);border-radius:999px;padding:4px 11px;font:inherit;font-size:12px;cursor:pointer;white-space:nowrap;transition:all .12s}
-.wr-chip:hover{color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-border-l2)}
+.wr-chip:hover{color:var(--wr-ink);border-color:var(--wr-sage)}
 .wr-chip[data-active=true]{background:var(--dsw-alias-brand-primary);border-color:transparent;color:#fff;font-weight:600}
 .wr-toolbar{display:flex;align-items:center;gap:8px;flex-wrap:wrap;margin-bottom:14px}
 .wr-toolbar-fill{flex:1;min-width:0}
-.wr-input{box-sizing:border-box;height:30px;border-radius:8px;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-base);color:var(--dsw-alias-label-primary);font:inherit;font-size:12.5px;padding:0 10px;outline:none}
-.wr-input:focus{border-color:var(--dsw-alias-brand-primary)}
-.wr-select{box-sizing:border-box;height:30px;border-radius:8px;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-base);color:var(--dsw-alias-label-primary);font:inherit;font-size:12.5px;padding:0 8px;outline:none;max-width:220px}
+.wr-input{box-sizing:border-box;height:32px;border-radius:10px;border:1px solid var(--wr-line-2);background:var(--wr-paper-soft);color:var(--wr-ink);font:inherit;font-size:12.5px;padding:0 11px;outline:none;transition:border-color .16s ease,box-shadow .16s ease}
+.wr-input:focus{border-color:var(--wr-moss);box-shadow:0 0 0 3px rgba(79,146,116,.14)}
+.wr-select{box-sizing:border-box;height:32px;border-radius:10px;border:1px solid var(--wr-line-2);background:var(--wr-paper-soft);color:var(--wr-ink);font:inherit;font-size:12.5px;padding:0 9px;outline:none;max-width:220px;cursor:pointer}
 .wr-grid{display:grid;grid-template-columns:repeat(10,minmax(0,1fr));gap:12px}
 @media (max-width:1240px){.wr-grid{grid-template-columns:repeat(8,minmax(0,1fr))}}
 @media (max-width:920px){.wr-grid{grid-template-columns:repeat(6,minmax(0,1fr))}}
 @media (max-width:640px){.wr-grid{grid-template-columns:repeat(4,minmax(0,1fr))}}
 .wr-book{appearance:none;border:0;background:transparent;padding:0;margin:0;text-align:left;cursor:pointer;display:flex;flex-direction:column;gap:6px;font:inherit;color:inherit}
-.wr-book-cover-wrap{position:relative;border-radius:6px;overflow:hidden;box-shadow:0 3px 10px rgba(0,0,0,.16);transition:transform .16s,box-shadow .16s}
-.wr-book-cover-wrap{position:relative;border-radius:8px;overflow:hidden;box-shadow:0 6px 18px rgba(0,0,0,.18);transition:transform .16s,box-shadow .16s}
-.wr-book:hover .wr-book-cover-wrap{transform:translateY(-2px);box-shadow:0 8px 18px rgba(0,0,0,.24)}
+.wr-book-cover-wrap{position:relative;border-radius:8px;overflow:hidden;box-shadow:0 3px 8px rgba(38,60,52,.10),0 14px 26px -18px rgba(38,60,52,.5);transition:transform .2s ease,box-shadow .2s ease}
+.wr-book-cover-wrap{position:relative;border-radius:8px;overflow:hidden;box-shadow:0 3px 8px rgba(38,60,52,.10),0 14px 26px -18px rgba(38,60,52,.5);transition:transform .2s ease,box-shadow .2s ease}
+.wr-book:hover .wr-book-cover-wrap{transform:translateY(-3px);box-shadow:0 8px 16px rgba(38,60,52,.14),0 22px 34px -20px rgba(38,60,52,.55)}
 .wr-cover{aspect-ratio:3/4;width:100%;background:var(--dsw-alias-bg-layer-2);display:block;overflow:hidden;position:relative}
 .wr-cover img{width:100%;height:100%;object-fit:cover;display:block}
-.wr-cover-fallback{position:absolute;inset:0;display:flex;align-items:center;justify-content:center;font-size:30px;font-weight:700;color:rgba(255,255,255,.92);background:linear-gradient(140deg,#5c6b8a,#2f3a52)}
+.wr-cover-fallback{position:absolute;inset:0;display:flex;align-items:center;justify-content:center;font-size:30px;font-weight:700;color:rgba(255,255,255,.94);background:linear-gradient(150deg,#A8B9A3,#5F7562)}
 .wr-cover-badges{position:absolute;left:4px;top:4px;display:flex;gap:3px;flex-wrap:wrap;max-width:calc(100% - 8px)}
-.wr-badge{font-size:9px;line-height:1.5;padding:0 4px;border-radius:999px;background:rgba(0,0,0,.55);color:#fff;backdrop-filter:blur(3px)}
-.wr-badge[data-tone=brand]{background:rgba(60,110,220,.85)}
+.wr-badge{font-size:9px;line-height:1.5;padding:0 5px;border-radius:999px;background:rgba(38,60,52,.62);color:#FCFAF4;backdrop-filter:blur(3px)}
+.wr-badge[data-tone=brand]{background:rgba(111,138,116,.92)}
 .wr-book-title{font-size:11px;font-weight:600;line-height:1.35;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden}
 .wr-book-author{font-size:10px;color:var(--dsw-alias-label-secondary);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
 .wr-book-meta{display:flex;gap:4px;font-size:9.5px;color:var(--dsw-alias-label-secondary);align-items:center;flex-wrap:wrap}
@@ -528,7 +543,9 @@ window.__ModuleLoader__.load({
 .wr-progress span{display:block;height:100%;background:var(--dsw-alias-brand-primary);border-radius:2px}
 .wr-hour{display:grid;grid-template-columns:repeat(24,minmax(0,1fr));gap:3px;align-items:end;height:120px}
 .wr-hour-col{display:flex;flex-direction:column;justify-content:flex-end;align-items:center;gap:4px;height:100%}
-.wr-hour-bar{width:100%;border-radius:3px 3px 0 0;background:var(--dsw-alias-brand-primary);min-height:2px;opacity:.85}
+.wr-hour-bar{width:100%;border-radius:3px 3px 0 0;background:var(--wr-sage);min-height:2px}
+.wr-hour-col:hover .wr-hour-bar,.wr-hour-bar[data-active=true]{background:var(--wr-moss)}
+.wr-hour-label[data-active=true]{color:var(--wr-ink);font-weight:600}
 .wr-hour-label{font-size:9px;color:var(--dsw-alias-label-secondary);white-space:nowrap}
 .wr-months{display:grid;grid-template-columns:repeat(12,minmax(0,1fr));gap:6px;align-items:end;height:132px}
 .wr-months .wr-hour-label{font-size:10px}
@@ -545,13 +562,17 @@ window.__ModuleLoader__.load({
 .wr-heat-months{display:grid;grid-auto-flow:column;grid-auto-columns:13px;gap:3px;font-size:9.5px;color:var(--dsw-alias-label-secondary);overflow:hidden;margin:0 0 4px 0}
 .wr-heat-months span{white-space:nowrap;overflow:visible}
 .wr-heat{display:grid;grid-auto-flow:column;grid-template-rows:repeat(7,13px);gap:3px;flex:none}
-.wr-heat-cell{width:13px;height:13px;border-radius:3px;background:var(--dsw-alias-bg-layer-2);transition:transform .1s}
+.wr-heat-cell{width:13px;height:13px;border-radius:3px;background:var(--wr-heat-0);transition:transform .12s ease}
 .wr-heat-cell[data-on=true]:hover{transform:scale(1.3)}
+.wr-heat-cell[data-future=true]{background:transparent;box-shadow:inset 0 0 0 1px var(--wr-line-2);opacity:.7}
+.wr-banner-close{border:none;background:transparent;color:inherit;font-size:14px;line-height:1;cursor:pointer;padding:2px 4px;border-radius:6px;opacity:.55;flex:none;margin-left:auto}
+.wr-banner-close:hover{opacity:1;background:var(--wr-wash)}
+.wr-banner-text{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .wr-heat-legend{display:flex;align-items:center;gap:5px;margin-top:10px;font-size:11px;color:var(--dsw-alias-label-secondary)}
 .wr-bars{display:flex;flex-direction:column;gap:8px}
 .wr-bar-row{display:grid;grid-template-columns:104px 1fr 54px;gap:10px;align-items:center;font-size:12px}
-.wr-bar-track{height:8px;border-radius:999px;background:var(--dsw-alias-bg-layer-2);overflow:hidden}
-.wr-bar-fill{height:100%;border-radius:999px;background:var(--dsw-alias-brand-primary)}
+.wr-bar-track{height:6px;border-radius:999px;background:var(--wr-track);overflow:hidden}
+.wr-bar-fill{height:100%;border-radius:999px;background:var(--wr-progress)}
 .wr-bar-value{text-align:right;color:var(--dsw-alias-label-secondary);font-variant-numeric:tabular-nums;font-size:11.5px}
 .wr-list{display:flex;flex-direction:column;gap:2px}
 .wr-row{display:flex;align-items:center;gap:10px;padding:8px 8px;border-radius:8px;text-align:left;border:0;background:transparent;font:inherit;color:inherit;width:100%;cursor:default}
@@ -571,16 +592,18 @@ window.__ModuleLoader__.load({
 .wr-cols{column-count:2;column-gap:14px}
 @media (min-width:900px){.wr-cols{column-count:3}}
 @media (min-width:1300px){.wr-cols{column-count:4}}
-.wr-quote{break-inside:avoid;margin:0 0 14px;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);border-radius:12px;padding:12px 14px;position:relative}
-.wr-quote:before{content:'“';position:absolute;left:8px;top:2px;font-size:26px;color:var(--dsw-alias-border-l2);font-family:Georgia,serif;line-height:1}
+.wr-quote{break-inside:avoid;margin:0 0 14px;background:var(--wr-paper-soft);border:1px solid var(--wr-line);border-radius:14px;padding:14px 16px;position:relative;box-shadow:0 1px 2px rgba(38,60,52,.04)}
+.wr-quote:before{content:'“';position:absolute;left:9px;top:3px;font-size:26px;color:#C3D2BC;font-family:Georgia,serif;line-height:1}
 .wr-quote-text{font-size:12.8px;line-height:1.62;white-space:pre-wrap;word-break:break-word;padding-left:12px;margin:0}
 .wr-quote-foot{display:flex;align-items:center;gap:6px;margin-top:9px;padding-left:12px;font-size:11px;color:var(--dsw-alias-label-secondary);min-width:0}
 .wr-quote-book{font-weight:600;color:var(--dsw-alias-label-secondary);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;max-width:60%}
 .wr-quote-tail{margin-left:auto;flex:none;display:flex;gap:6px;align-items:center}
-.wr-thought{break-inside:avoid;margin:0 0 14px;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);border-left:3px solid var(--dsw-alias-brand-primary);border-radius:12px;padding:12px 14px}
+.wr-thought{break-inside:avoid;margin:0 0 14px;background:var(--wr-paper-soft);border:1px solid var(--wr-line);border-left:3px solid var(--wr-progress);border-radius:14px;padding:14px 16px;box-shadow:0 1px 2px rgba(38,60,52,.04)}
 .wr-quote[data-clickable=true],.wr-thought[data-clickable=true]{cursor:pointer;transition:border-color .12s ease}
 .wr-quote[data-clickable=true]:hover,.wr-thought[data-clickable=true]:hover{border-color:var(--dsw-alias-border-l2)}
-.wr-copy{appearance:none;border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-base);color:var(--dsw-alias-label-secondary);font:inherit;font-size:10.5px;line-height:1;padding:3px 7px;border-radius:6px;cursor:pointer;flex:none}
+.wr-copy{appearance:none;border:1px solid var(--wr-line);background:var(--wr-paper);color:var(--wr-ink-soft);font:inherit;font-size:10.5px;line-height:1;padding:4px 9px;border-radius:999px;cursor:pointer;flex:none;opacity:0;transition:opacity .14s ease,color .14s ease,border-color .14s ease}
+.wr-quote:hover .wr-copy,.wr-thought:hover .wr-copy,.wr-copy:focus,.wr-copy[data-done=true]{opacity:1}
+@media (hover:none){.wr-copy{opacity:1}}
 .wr-copy:hover{color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-border-l2)}
 .wr-copy[data-done=true]{color:var(--dsw-alias-state-success-primary);border-color:var(--dsw-alias-state-success-primary)}
 .wr-pager{display:flex;align-items:center;justify-content:center;gap:12px;margin-top:16px;font-size:12px;flex-wrap:wrap}
@@ -588,7 +611,7 @@ window.__ModuleLoader__.load({
 .wr-quote:hover .wr-pick,.wr-thought:hover .wr-pick,.wr-pick[data-on=true]{opacity:1}
 .wr-pick[data-on=true]{background:var(--dsw-alias-brand-primary);border-color:var(--dsw-alias-brand-primary);color:var(--dsw-alias-bg-base)}
 .wr-quote[data-picked=true],.wr-thought[data-picked=true]{border-color:var(--dsw-alias-brand-primary)}
-.wr-mark{background:color-mix(in srgb, var(--dsw-alias-state-warn-primary) 30%, transparent);color:inherit;border-radius:3px;padding:0 1px}
+.wr-mark{background:var(--wr-heat-1);color:var(--wr-ink);border-radius:3px;padding:0 2px}
 .wr-export{width:min(760px,94vw);max-height:88vh;display:flex;flex-direction:column}
 .wr-export-head{display:flex;align-items:baseline;justify-content:space-between;gap:12px}
 .wr-export-opts{display:flex;flex-wrap:wrap;align-items:center;gap:6px;margin:10px 0}
@@ -597,14 +620,12 @@ window.__ModuleLoader__.load({
 .wr-export-preview{margin:0;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:11.5px;line-height:1.6;white-space:pre-wrap;word-break:break-word}
 .wr-stars{color:var(--dsw-alias-state-warn-primary);font-size:10.5px;letter-spacing:1px}
 .wr-detail-head{display:flex;gap:18px;align-items:flex-start;flex-wrap:wrap}
-.wr-detail-cover{width:120px;flex:none;border-radius:10px;overflow:hidden;box-shadow:0 10px 26px rgba(0,0,0,.22)}
+.wr-detail-cover{width:120px;flex:none;border-radius:12px;overflow:hidden;box-shadow:0 10px 24px -12px rgba(38,60,52,.55)}
 .wr-detail-main{flex:1;min-width:220px;display:flex;flex-direction:column;gap:8px}
 .wr-detail-title{font-size:18px;font-weight:700;line-height:1.35;margin:0}
 .wr-detail-author{font-size:12.5px;color:var(--dsw-alias-label-secondary)}
-.wr-link{appearance:none;border:0;background:transparent;color:var(--dsw-alias-brand-primary);font:inherit;font-size:12px;cursor:pointer;padding:0;text-decoration:none}
-.wr-link:hover{text-decoration:underline}
-.wr-modal-mask{position:fixed;inset:0;z-index:1200;background:rgba(0,0,0,.42);display:flex;align-items:center;justify-content:center;padding:24px}
-.wr-modal{width:min(480px,100%);max-height:80vh;overflow:auto;background:var(--dsw-alias-bg-base);border:1px solid var(--dsw-alias-border-l2);border-radius:16px;box-shadow:0 24px 60px rgba(0,0,0,.35);padding:20px}
+.wr-modal-mask{position:fixed;inset:0;z-index:1200;background:rgba(45,60,48,.34);backdrop-filter:blur(4px);display:flex;align-items:center;justify-content:center;padding:24px}
+.wr-modal{width:min(480px,100%);max-height:80vh;overflow:auto;background:var(--wr-paper-soft);border:1px solid var(--wr-line);border-radius:18px;box-shadow:0 30px 70px -30px rgba(45,60,48,.6);padding:22px}
 .wr-modal h3{margin:0 0 4px;font-size:15px}
 .wr-field{display:flex;flex-direction:column;gap:6px;margin-top:14px}
 .wr-field label{font-size:11.5px;font-weight:600;color:var(--dsw-alias-label-secondary)}
@@ -620,7 +641,14 @@ window.__ModuleLoader__.load({
 .wr-flex{display:flex;gap:10px;align-items:center;flex-wrap:wrap}
 .wr-split{display:grid;grid-template-columns:repeat(auto-fit,minmax(300px,1fr));gap:16px}
 .wr-kv{display:flex;gap:8px;font-size:12px;color:var(--dsw-alias-label-secondary)}
-.wr-notice{font-size:11.5px;color:var(--dsw-alias-label-secondary);margin:8px 0 0}
+.wr-notice{font-size:11.5px;color:var(--wr-ink-mute);margin:8px 0 0}
+.wr-root ::selection{background:rgba(168,185,163,.45);color:var(--wr-ink)}
+.wr-root :focus-visible{outline:2px solid rgba(111,138,116,.45);outline-offset:2px}
+.wr-body::-webkit-scrollbar{width:10px;height:10px}
+.wr-body::-webkit-scrollbar-thumb{background:#CFD8C6;border-radius:999px;border:2px solid transparent;background-clip:content-box}
+.wr-body::-webkit-scrollbar-track{background:transparent}
+.wr-heat-legend i{width:11px;height:11px;border-radius:3px;display:inline-block}
+.wr-setup{background:var(--wr-paper-soft);border:1px solid var(--wr-line);border-radius:18px;padding:26px 28px;box-shadow:0 1px 2px rgba(38,60,52,.04)}
 `
 
     // ------------------------------------------------------------ components
@@ -842,16 +870,20 @@ window.__ModuleLoader__.load({
         return monthLabel(month - 1)
       })
 
+      // Four discrete steps above "no reading": a fixed palette keeps the bands
+      // distinguishable, where mixing percentages blurred them into the page.
       const level = (value) => {
-        if (value <= 0) return 'var(--dsw-alias-bg-layer-2)'
+        if (value <= 0) return 'var(--wr-heat-0)'
         const low = model.thresholds[0]
         const mid = model.thresholds[1]
         const high = model.thresholds[2]
-        if (value <= low) return 'color-mix(in srgb, var(--dsw-alias-brand-primary) 26%, var(--dsw-alias-bg-layer-2))'
-        if (value <= mid) return 'color-mix(in srgb, var(--dsw-alias-brand-primary) 48%, var(--dsw-alias-bg-layer-2))'
-        if (value <= high) return 'color-mix(in srgb, var(--dsw-alias-brand-primary) 72%, var(--dsw-alias-bg-layer-2))'
-        return 'var(--dsw-alias-brand-primary)'
+        if (value <= low) return 'var(--wr-heat-1)'
+        if (value <= mid) return 'var(--wr-heat-2)'
+        if (value <= high) return 'var(--wr-heat-3)'
+        return 'var(--wr-heat-4)'
       }
+      const now = new Date()
+      const todayIso = `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}`
 
       const cells = []
       model.columns.forEach((column, columnIndex) => {
@@ -861,13 +893,19 @@ window.__ModuleLoader__.load({
             cells.push(h('div', { key: `e-${columnIndex}-${row}`, className: 'wr-heat-cell', style: { background: 'transparent' } }))
             continue
           }
+          // Days after today are drawn as empty outlines, so "not yet" never
+          // reads as "read nothing".
+          const future = cell.iso > todayIso
           cells.push(
             h('div', {
               key: cell.iso,
               className: 'wr-heat-cell',
               'data-on': cell.value > 0 ? 'true' : 'false',
-              title: `${cell.iso} · ${cell.value > 0 ? fmtDuration(cell.value) : '没有阅读'}`,
-              style: { background: level(cell.value) },
+              'data-future': future ? 'true' : 'false',
+              title: future
+                ? `${cell.iso} · ${t('dash.heat.future')}`
+                : `${cell.iso} · ${cell.value > 0 ? fmtDuration(cell.value) : t('dash.heat.none')}`,
+              style: { background: future ? 'transparent' : level(cell.value) },
             }),
           )
         }
@@ -898,14 +936,11 @@ window.__ModuleLoader__.load({
         h(
           'div',
           { className: 'wr-heat-legend' },
-          h('span', null, t('dash.less')),
-          [
-            'var(--dsw-alias-bg-layer-2)',
-            'color-mix(in srgb, var(--dsw-alias-brand-primary) 26%, var(--dsw-alias-bg-layer-2))',
-            'color-mix(in srgb, var(--dsw-alias-brand-primary) 48%, var(--dsw-alias-bg-layer-2))',
-            'color-mix(in srgb, var(--dsw-alias-brand-primary) 72%, var(--dsw-alias-bg-layer-2))',
-            'var(--dsw-alias-brand-primary)',
-          ].map((color, index) => h('span', { key: index, className: 'wr-heat-cell', style: { background: color } })),
+          h('span', null, t('dash.heat.none')),
+          h('span', { className: 'wr-heat-cell' }),
+          h('span', { style: { marginLeft: '6px' } }, t('dash.less')),
+          ['var(--wr-heat-1)', 'var(--wr-heat-2)', 'var(--wr-heat-3)', 'var(--wr-heat-4)'].map((color, index) =>
+            h('span', { key: index, className: 'wr-heat-cell', style: { background: color } })),
           h('span', null, t('dash.more')),
         ),
       )
@@ -951,6 +986,7 @@ window.__ModuleLoader__.load({
 /** Twelve monthly bars for the selected year. */
     function MonthChart(props) {
       const values = Array.isArray(props.values) ? props.values : []
+      const activeIndex = Number.isInteger(props.activeIndex) ? props.activeIndex : -1
       const max = Math.max.apply(null, values.concat([1]))
       const cells = []
       for (let index = 0; index < 12; index += 1) {
@@ -960,8 +996,8 @@ window.__ModuleLoader__.load({
           h(
             'div',
             { className: 'wr-hour-col', key: index, title: `${index + 1} · ${fmtDuration(value)}` },
-            h('div', { className: 'wr-hour-bar', style: { height: `${height}%` } }),
-            h('div', { className: 'wr-hour-label' }, String(index + 1)),
+            h('div', { className: 'wr-hour-bar', 'data-active': index === activeIndex ? 'true' : 'false', style: { height: `${height}%` } }),
+            h('div', { className: 'wr-hour-label', 'data-active': index === activeIndex ? 'true' : 'false' }, String(index + 1)),
           ),
         )
       }
@@ -1160,7 +1196,7 @@ window.__ModuleLoader__.load({
         h(
           'div',
           { className: 'wr-split wr-section' },
-          h('div', { className: 'wr-card' }, h('h3', { className: 'wr-section-title' }, t('dash.month')), h(MonthChart, { values: monthly })),
+          h('div', { className: 'wr-card' }, h('h3', { className: 'wr-section-title' }, t('dash.month')), h(MonthChart, { values: monthly, activeIndex: isCurrent ? new Date().getMonth() : -1 })),
           h('div', { className: 'wr-card' }, h('h3', { className: 'wr-section-title' }, t('dash.category')), h(BarList, { items: categories })),
         ),
         h(
@@ -1700,9 +1736,17 @@ window.__ModuleLoader__.load({
           }),
           h(
             'select',
-            { className: 'wr-select', value: bookFilter, onChange: (event) => setBookFilter(event.target.value) },
+            {
+              className: 'wr-select',
+              style: { maxWidth: '240px' },
+              title: t('filter.allBooks'),
+              value: bookFilter,
+              onChange: (event) => setBookFilter(event.target.value),
+            },
             h('option', { value: 'all' }, t('filter.allBooks')),
-            bookOptions.map(([id, title]) => h('option', { key: id, value: id }, title)),
+            // Titles are cut short: a 40-character name would otherwise blow the
+            // native popup out to the width of the whole window.
+            bookOptions.map(([id, title]) => h('option', { key: id, value: id, title }, clip(title, 24))),
           ),
           h('div', { className: 'wr-toolbar-fill' }),
           selected.size > 0 ? h('span', { className: 'wr-chip-stat' }, t('export.selected', { count: String(selected.size) })) : null,
@@ -1799,7 +1843,6 @@ window.__ModuleLoader__.load({
       const needle = query.trim().toLowerCase()
       const visibleNotes = needle === '' ? notes : notes.filter((note) => contains(note.text, needle) || contains(note.chapterTitle, needle))
       const visibleThoughts = needle === '' ? thoughts : thoughts.filter((thought) => contains(thought.content, needle) || contains(thought.chapterName, needle))
-      const link = wereadBookLink(book.bookId)
 
       useEffect(() => {
         setPage(0)
@@ -1837,7 +1880,6 @@ window.__ModuleLoader__.load({
               book.rating > 0 ? h('span', { className: 'wr-badge', style: { background: 'var(--dsw-alias-bg-layer-1)', color: 'var(--dsw-alias-state-warn-primary)', border: '1px solid var(--dsw-alias-border-l1)' } }, `${t('book.rating')} ${(book.rating / 10).toFixed(1)}${book.ratingCount > 0 ? ` (${fmtCount(book.ratingCount)})` : ''}`) : null,
               book.publisher ? h('span', { className: 'wr-badge', style: { background: 'var(--dsw-alias-bg-layer-1)', color: 'var(--dsw-alias-label-secondary)', border: '1px solid var(--dsw-alias-border-l1)' } }, book.publisher) : null,
               book.publishYear ? h('span', { className: 'wr-badge', style: { background: 'var(--dsw-alias-bg-layer-1)', color: 'var(--dsw-alias-label-secondary)', border: '1px solid var(--dsw-alias-border-l1)' } }, `${t('book.year')} ${book.publishYear}`) : null,
-              link ? h('a', { className: 'wr-link', href: link }, t('action.openWeread')) : null,
             ),
             book.readingProgress > 0
               ? h(
@@ -2009,6 +2051,21 @@ window.__ModuleLoader__.load({
         if (fileRef.current) fileRef.current.click()
       }
 
+      /** Ignore the incremental ledger and re-read every book's highlights. */
+      const fullRebuild = async () => {
+        setBusyData(true)
+        setDataMessage('')
+        try {
+          await apiSync({ full: true })
+          setDataMessage(t('settings.fullSyncStarted'))
+          if (typeof props.onSyncStarted === 'function') props.onSyncStarted()
+        } catch (error) {
+          setDataMessage(String(error.message || error))
+        } finally {
+          setBusyData(false)
+        }
+      }
+
       const onFile = async (event) => {
         const file = event.target.files && event.target.files[0]
         event.target.value = ''
@@ -2106,9 +2163,11 @@ window.__ModuleLoader__.load({
               { className: 'wr-flex', style: { marginTop: '10px' } },
               h('button', { className: 'wr-btn', type: 'button', disabled: busyData, onClick: () => void downloadBackup() }, t('settings.backup')),
               h('button', { className: 'wr-btn', type: 'button', disabled: busyData, onClick: pickFile }, t('settings.restore')),
+              h('button', { className: 'wr-btn', type: 'button', disabled: busyData, onClick: () => void fullRebuild() }, t('settings.fullSync')),
               h('input', { ref: fileRef, type: 'file', accept: 'application/json,.json', style: { display: 'none' }, onChange: (event) => void onFile(event) }),
             ),
             h('p', { className: 'wr-muted', style: { margin: '6px 0 0' } }, t('settings.backupHint')),
+            h('p', { className: 'wr-muted', style: { margin: '4px 0 0' } }, t('settings.fullSyncHint')),
             pending
               ? h(
                   'div',
@@ -2197,6 +2256,76 @@ window.__ModuleLoader__.load({
     }
 
     // ------------------------------------------------------------------- page
+    /**
+     * Sync feedback line.
+     *
+     * A running sync stays until it finishes, because it is live progress. A
+     * finished one (done or failed) clears itself after a few seconds so the
+     * reading area is not permanently occupied, and the × dismisses it right
+     * away. Any new sync resets both, so a second run always shows up again.
+     */
+    function SyncBanner(props) {
+      const sync = props && props.sync ? props.sync : null
+      const phase = sync && sync.phase ? String(sync.phase) : ''
+      const running = Boolean(sync && sync.running)
+      const signature = [
+        sync && sync.startedAt ? sync.startedAt : '',
+        phase,
+        sync && sync.message ? sync.message : '',
+        sync && sync.error ? sync.error : '',
+      ].join('|')
+      const [dismissed, setDismissed] = useState(false)
+      const [expired, setExpired] = useState(false)
+
+      useEffect(() => {
+        setDismissed(false)
+        setExpired(false)
+      }, [signature])
+
+      useEffect(() => {
+        if (!sync || running) return undefined
+        if (phase !== 'done' && phase !== 'error') return undefined
+        if (typeof setTimeout !== 'function') return undefined
+        const timer = setTimeout(() => setExpired(true), AUTO_HIDE_MS)
+        return () => clearTimeout(timer)
+      }, [signature, running, phase])
+
+      if (!sync) return null
+      if (dismissed || expired) return null
+
+      const close = h('button', {
+        className: 'wr-banner-close',
+        type: 'button',
+        'aria-label': t('action.dismiss'),
+        title: t('action.dismiss'),
+        onClick: () => setDismissed(true),
+      }, '×')
+
+      if (running) {
+        const total = sync.total || 0
+        const done = sync.done || 0
+        return h('div', { className: 'wr-banner', 'data-tone': 'run' },
+          h('span', { className: 'wr-spinner' }),
+          h('span', { className: 'wr-banner-text' }, total > 0 ? t('sync.running', { label: sync.label || '', done, total }) : (sync.label || t('action.syncing'))),
+          sync.message ? h('span', { className: 'wr-banner-text wr-muted' }, sync.message) : null,
+          close,
+        )
+      }
+      if (phase === 'done' && sync.message) {
+        return h('div', { className: 'wr-banner' },
+          h('span', { className: 'wr-banner-text' }, t('sync.done', { message: sync.message })),
+          close,
+        )
+      }
+      if (phase === 'error' && sync.error) {
+        return h('div', { className: 'wr-banner', 'data-tone': 'error' },
+          h('span', { className: 'wr-banner-text' }, t('sync.failed', { error: sync.error })),
+          close,
+        )
+      }
+      return null
+    }
+
     function StudyPanel() {
       const [state, setState] = useState(null)
       const [data, setData] = useState(null)
@@ -2208,22 +2337,6 @@ window.__ModuleLoader__.load({
       const [showSettings, setShowSettings] = useState(false)
       const [booting, setBooting] = useState(true)
       const mounted = useRef(true)
-      const searchRef = useRef(null)
-
-      useEffect(() => {
-        const onKey = (event) => {
-          if (!(event.metaKey || event.ctrlKey)) return
-          if (String(event.key || '').toLowerCase() !== 'k') return
-          event.preventDefault()
-          const node = searchRef.current
-          if (node && typeof node.focus === 'function') {
-            node.focus()
-            if (typeof node.select === 'function') node.select()
-          }
-        }
-        window.addEventListener('keydown', onKey)
-        return () => window.removeEventListener('keydown', onKey)
-      }, [])
 
       useEffect(() => {
         mounted.current = true
@@ -2336,7 +2449,6 @@ window.__ModuleLoader__.load({
           { className: 'wr-head-right' },
           h('div', { className: 'wr-search' },
             h('input', {
-              ref: searchRef,
               placeholder: t('action.searchGlobal'),
               value: query,
               'aria-label': t('action.search'),
@@ -2352,22 +2464,7 @@ window.__ModuleLoader__.load({
         ),
       )
 
-      const syncBanner = (() => {
-        if (!state || !state.sync) return null
-        const sync = state.sync
-        if (sync.running) {
-          const total = sync.total || 0
-          const done = sync.done || 0
-          return h('div', { className: 'wr-banner', 'data-tone': 'run' },
-            h('span', { className: 'wr-spinner' }),
-            h('span', null, total > 0 ? t('sync.running', { label: sync.label || '', done, total }) : (sync.label || t('action.syncing'))),
-            sync.message ? h('span', { className: 'wr-muted' }, sync.message) : null,
-          )
-        }
-        if (sync.phase === 'done' && sync.message) return h('div', { className: 'wr-banner' }, h('span', null, t('sync.done', { message: sync.message })))
-        if (sync.phase === 'error' && sync.error) return h('div', { className: 'wr-banner', 'data-tone': 'error' }, h('span', null, t('sync.failed', { error: sync.error })))
-        return null
-      })()
+      const syncBanner = h(SyncBanner, { sync: state && state.sync })
 
       let body = null
       if (booting) {
@@ -2420,6 +2517,7 @@ window.__ModuleLoader__.load({
               onClose: () => setShowSettings(false),
               onChanged: (next) => { setState(next); void loadData() },
               onDataChanged: () => { void loadData(); void refreshState() },
+              onSyncStarted: () => { void refreshState() },
             })
           : null,
       )
@@ -2497,7 +2595,7 @@ window.__ModuleLoader__.load({
       },
       // Test-only handles: the render smoke test mounts these directly, because
       // the export panel normally only appears after a click. Nothing else reads it.
-      __smoke: { ExportPanel, MarkedText, PickButton },
+      __smoke: { ExportPanel, MarkedText, PickButton, SyncBanner, clip },
     }
   },
 })

package/index.js

@@ -45,6 +45,16 @@ const HEAT_TTL = 30 * 60
 const HEAT_CONCURRENCY = 4
 const HEAT_CACHE_VERSION = 2
 
+/**
+ * Incremental sync. `sync-state.json` remembers, per book, what the notebook
+ * list looked like the last time its highlights were fetched. A book is only
+ * re-read when one of those numbers moved, so a second sync in a row costs a
+ * shelf call plus one notebook page instead of ~130 requests.
+ */
+const SYNC_STATE_VERSION = 1
+/** Reading totals (annually / overall) change slowly: reuse them for a while. */
+const DASHBOARD_TTL = 6 * 60 * 60
+
 const JSON_HEADERS = { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' }
 
 /**
@@ -574,12 +584,60 @@ function buildExportDocument(picked, optionsInput, nowIso) {
   }
 }
 
+// --------------------------------------------------------------- sync planning
+
+const notebookSorted = (a, b) => Number(b.lastNoteTime || 0) - Number(a.lastNoteTime || 0)
+
+/**
+ * Decide which notebooks need their highlights re-read.
+ *
+ * A book is re-read when we have never recorded it, when its newest note moved,
+ * or when either note counter changed. Everything else is skipped and its old
+ * entries are carried over from `data.json` instead of being downloaded again.
+ */
+function planBookRefresh(previous, notebooks, options = {}) {
+  const full = options.full === true
+  const known = isObject(previous) ? previous : {}
+  const refresh = []
+  const skipped = []
+  for (const notebook of notebooks) {
+    if (!notebook || !notebook.bookId) continue
+    const before = isObject(known[notebook.bookId]) ? known[notebook.bookId] : null
+    const changed =
+      full ||
+      before === null ||
+      Number(notebook.lastNoteTime || 0) > Number(before.lastNoteTime || 0) ||
+      Number(notebook.noteCount || 0) !== Number(before.noteCount || 0) ||
+      Number(notebook.reviewCount || 0) !== Number(before.reviewCount || 0)
+    if (changed) refresh.push(notebook)
+    else skipped.push(notebook.bookId)
+  }
+  return { refresh, skipped, full }
+}
+
+/** Carry over the entries of books we are not re-reading this round. */
+function mergeCarriedEntries(previous, keepBookIds, refreshBookIds) {
+  const keep = keepBookIds instanceof Set ? keepBookIds : new Set(keepBookIds || [])
+  const refresh = refreshBookIds instanceof Set ? refreshBookIds : new Set(refreshBookIds || [])
+  const notes = []
+  const thoughts = []
+  if (!isObject(previous)) return { notes, thoughts }
+  for (const note of Array.isArray(previous.notes) ? previous.notes : []) {
+    if (keep.has(note.bookId) && !refresh.has(note.bookId)) notes.push(note)
+  }
+  for (const thought of Array.isArray(previous.thoughts) ? previous.thoughts : []) {
+    if (keep.has(thought.bookId) && !refresh.has(thought.bookId)) thoughts.push(thought)
+  }
+  return { notes, thoughts }
+}
+
 function createHost(options) {
   const dir = join(dshHome(), 'weread-gather')
   const configPath = join(dir, 'config.json')
   const dataPath = join(dir, 'data.json')
   const metaPath = join(dir, 'meta.json')
   const heatPath = join(dir, 'heat.json')
+  const syncStatePath = join(dir, 'sync-state.json')
 
   let config = readJsonFile(configPath, {})
   if (!isObject(config)) config = {}
@@ -594,6 +652,13 @@ function createHost(options) {
   /** "2026" -> { at, days: { "2026-01-02": seconds } } */
   let heatCache = readJsonFile(heatPath, {})
   if (!isObject(heatCache)) heatCache = {}
+  /** Sync bookkeeping: what the notebook list looked like when we last read it. */
+  let syncState = readJsonFile(syncStatePath, null)
+  if (!isObject(syncState) || Number(syncState.version) !== SYNC_STATE_VERSION) {
+    syncState = { version: SYNC_STATE_VERSION, lastSyncAt: 0, lastFullAt: 0, dashboardAt: {}, books: {} }
+  }
+  if (!isObject(syncState.books)) syncState.books = {}
+  if (!isObject(syncState.dashboardAt)) syncState.dashboardAt = {}
 
   let job = null
 
@@ -648,6 +713,14 @@ function createHost(options) {
     }
   }
 
+  function saveSyncState() {
+    try {
+      writeJsonFile(syncStatePath, syncState)
+    } catch {
+      // Losing the ledger only costs a slower sync next time; never fail a sync.
+    }
+  }
+
   // ------------------------------------------------------------------ exports
 
   const defaultExportDir = join(dir, 'exports')
@@ -769,6 +842,7 @@ function createHost(options) {
         'data.json': dataset,
         'meta.json': meta,
         'heat.json': heatCache,
+        'sync-state.json': syncState,
       },
     }
   }
@@ -824,6 +898,17 @@ function createHost(options) {
       saveHeat()
       restored.push('heat.json')
     }
+    // Optional: older bundles (1.0.0 / 1.1.0) have no ledger. Keep ours instead of
+    // resetting it, otherwise the next sync would silently become a full one.
+    if (isObject(files['sync-state.json'])) {
+      const incomingState = files['sync-state.json']
+      if (Number(incomingState.version) === SYNC_STATE_VERSION && isObject(incomingState.books)) {
+        syncState = incomingState
+        if (!isObject(syncState.dashboardAt)) syncState.dashboardAt = {}
+        saveSyncState()
+        restored.push('sync-state.json')
+      }
+    }
     return { restored, keptBackup: folder, keptFiles, counts: counts() }
   }
 
@@ -984,6 +1069,13 @@ function createHost(options) {
       finishedAt: 0,
     }
     const warnings = []
+    // Incremental bookkeeping. `full` (or having no ledger at all) falls back to
+    // the 1.1.0 behaviour of reading everything.
+    const full = options.full === true
+    const previousState = syncState
+    const previousDataset = dataset
+    const lastSyncAt = Number(previousState.lastSyncAt) || 0
+    const effectiveFull = full || lastSyncAt === 0 || !isObject(previousDataset)
 
     try {
       // 1. Shelf ------------------------------------------------------------
@@ -1062,6 +1154,9 @@ function createHost(options) {
         if (!hasMore || nextSort === 0 || nextSort === lastSort) break
         lastSort = nextSort
         job.message = `已读取 ${notebooks.length} 本有笔记的书`
+        // Paging must not stop early: this list is also where books that the
+        // capped shelf slice dropped come from, so a partial list would shrink
+        // the catalogue. It is only ~5 cheap requests anyway.
       }
 
       for (const notebook of notebooks) {
@@ -1084,10 +1179,21 @@ function createHost(options) {
       job.phase = 'dashboard'
       job.label = '同步阅读统计'
       const dashboard = {}
+      const previousDashboard = previousDataset && isObject(previousDataset.dashboard) ? previousDataset.dashboard : {}
+      const now = nowSeconds()
       for (const mode of ['weekly', 'monthly', 'annually', 'overall']) {
+        const cached = previousDashboard[mode]
+        const cachedAt = Number(previousState.dashboardAt[mode]) || 0
+        const reusable = !effectiveFull && isObject(cached) && now - cachedAt < DASHBOARD_TTL
+        if (reusable) {
+          dashboard[mode] = cached
+          continue
+        }
         try {
           dashboard[mode] = trimReadData(await gateway(current.apiKey, '/readdata/detail', { mode }, signal))
+          syncState.dashboardAt[mode] = now
         } catch (error) {
+          if (isObject(cached)) dashboard[mode] = cached
           warnings.push(`阅读统计(${mode}): ${error instanceof Error ? error.message : String(error)}`)
         }
       }
@@ -1139,15 +1245,40 @@ function createHost(options) {
       // 4. Per-book highlights and thoughts ---------------------------------
       job.phase = 'notes'
       job.label = '同步笔记与想法'
-      const candidates = notebooks
-        .filter((n) => n.noteCount + n.reviewCount > 0)
-        .sort((a, b) => b.lastNoteTime - a.lastNoteTime || b.noteCount - a.noteCount)
-        .slice(0, maxBooks)
+      const withNotes = notebooks.filter((n) => n.noteCount + n.reviewCount > 0).sort(notebookSorted)
+      const plan = planBookRefresh(previousState.books, withNotes, { full: effectiveFull })
+      const candidates = plan.refresh.slice(0, maxBooks)
+      // Books beyond the per-sync cap keep their old entries; they are simply not
+      // part of the refresh set.
+      const refreshIds = new Set(candidates.map((n) => n.bookId))
+      const keepIds = new Set(books.keys())
+      // A book whose counters dropped to zero has lost its entries: dropping the
+      // old rows is the only way the next view matches WeRead.
+      const emptiedIds = new Set(notebooks.filter((n) => n.noteCount + n.reviewCount === 0).map((n) => n.bookId))
+      const carried = mergeCarriedEntries(previousDataset, keepIds, new Set([...refreshIds, ...emptiedIds]))
       job.total = candidates.length
       job.done = 0
-
-      const notes = []
-      const thoughts = []
+      job.updated = candidates.length
+      job.skipped = withNotes.length - candidates.length
+      if (job.skipped > 0) job.message = `更新 ${candidates.length} 本 · 跳过 ${job.skipped} 本`
+
+      const notes = carried.notes
+      const thoughts = carried.thoughts
+      // Pre-fill the ledger for every notebook so the next sync can tell
+      // "unchanged" from "never looked at". `read` remembers that a book's
+      // highlights were actually downloaded once: books the per-sync cap has
+      // never reached keep `read:false`, which is what the pending count shows
+      // (1.1.0 only ever had highlights for the newest N books anyway).
+      for (const notebook of withNotes) {
+        const previousRow = isObject(syncState.books[notebook.bookId]) ? syncState.books[notebook.bookId] : null
+        syncState.books[notebook.bookId] = {
+          lastNoteTime: Number(notebook.lastNoteTime) || 0,
+          noteCount: Number(notebook.noteCount) || 0,
+          reviewCount: Number(notebook.reviewCount) || 0,
+          syncedAt: nowSeconds(),
+          read: previousRow !== null && (previousRow.read === true || previousRow.done === true),
+        }
+      }
       const results = await mapLimit(candidates, 4, async (notebook) => {
         const collectedNotes = []
         const collectedThoughts = []
@@ -1191,11 +1322,16 @@ function createHost(options) {
         const notebook = candidates[index]
         if (result && result.error) {
           warnings.push(result.error)
+          // Drop the ledger row so the next sync retries this book instead of
+          // remembering a half-finished state.
+          delete syncState.books[notebook.bookId]
           return
         }
         if (!result) return
         for (const note of result.notes) notes.push({ ...note, bookTitle: notebook.title, author: notebook.author, cover: notebook.cover })
         for (const thought of result.thoughts) thoughts.push({ ...thought, bookTitle: notebook.title, author: notebook.author, cover: notebook.cover })
+        const entry = syncState.books[notebook.bookId]
+        if (isObject(entry)) entry.read = true
         job.done += 1
       })
 
@@ -1219,10 +1355,25 @@ function createHost(options) {
       })
       saveDataset(next)
 
+      // 6. Ledger -----------------------------------------------------------
+      // Forget books that left the shelf so the file cannot grow forever.
+      for (const bookId of Object.keys(syncState.books)) {
+        if (!keepIds.has(bookId)) delete syncState.books[bookId]
+      }
+      const pendingBooks = withNotes.filter((n) => {
+        const row = syncState.books[n.bookId]
+        return isObject(row) && row.read !== true
+      }).length
+      if (pendingBooks > 0) job.pending = pendingBooks
+      syncState.version = SYNC_STATE_VERSION
+      syncState.lastSyncAt = nowSeconds()
+      if (effectiveFull) syncState.lastFullAt = syncState.lastSyncAt
+      saveSyncState()
+
       job.running = false
       job.phase = 'done'
       job.label = '同步完成'
-      job.message = `书架 ${next.books.length} 本 · 笔记 ${next.notes.length} 条 · 想法 ${next.thoughts.length} 条`
+      job.message = `更新 ${job.updated || 0} 本 · 跳过 ${job.skipped || 0} 本 · 笔记 ${next.notes.length} 条 · 想法 ${next.thoughts.length} 条`
       job.finishedAt = nowSeconds()
       return status()
     } catch (error) {
@@ -1436,7 +1587,15 @@ export const inject = ['webServer']
  * Pure helpers exposed for `scripts/export-selftest.cjs`. Nothing here touches
  * the filesystem or the gateway, so importing the module stays side-effect free.
  */
-export const __internals = { buildExportDocument, exportOptions, chapterGroups, formatStamp, safeSegment }
+export const __internals = {
+  buildExportDocument,
+  exportOptions,
+  chapterGroups,
+  formatStamp,
+  safeSegment,
+  planBookRefresh,
+  mergeCarriedEntries,
+}
 
 export function apply(ctx) {
   const host = createHost({})

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-weread-gather",
-  "version": "1.1.0",
-  "description": "数字书房 — a private WeRead study in the DSH sidebar: shelf, categories, highlights, thoughts, reading dashboard and heatmap, Markdown export and backup, with search everywhere.",
+  "version": "1.1.2",
+  "description": "数字书房 — 微信读书书架、笔记与想法的私人书房：Markdown 导出、备份恢复、增量同步。",
   "type": "module",
   "license": "MIT",
   "author": "fountainhead-gq",
@@ -61,4 +61,4 @@
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   }
-}
+}