# 上线 Tabbit 读书笔记技能与看板书库

> 项目：PM Hub 项目管理系统　·　时间：2026-10-17 10:15　·　进度：87%　·　阶段：上线运营
> 分支：`claude/tabbit-pdf-notes-sync-a29dad`　·　提交：`5b6b2ae`　·　执行人：kinger520@163.com

## 摘要

在 Tabbit 里读 PDF 时，可以直接对 Tabbit AI 说「/读书笔记」「记一下」：笔记写进看板新增的「书库」页，再自动同步到 jin-pm-hub/library/ 形成按书归档的知识库。线上接口和权限边界都验证过了；Tabbit 技能包已打好，还需要用户导入 Tabbit。

## 本次完成

- D1 新增 book_notes 表，并已在线上执行迁移
- 新增 /api/notes 写入接口，使用独立的只写凭证 PM_NOTES_TOKEN：读不了看板、digest 和项目数据（实测 401）
- 看板新增「书库」页：书目卡片、最近记录、单本书笔记，支持删除
- Tabbit 技能 book-notes：用云端沙箱脚本写入，先对齐已有书名，原文逐字摘录，重复提交不重复记录
- build.mjs 生成凭证、写入 Pages secret 并打包 zip（dist 不进 git）
- notes.mjs 增量同步到 library/<书名>/ 并 push；SessionStart hook 每次开新会话时在后台触发
- 用打包好的技能脚本对线上端到端测试：写入、去重、书名列表、同步渲染 Markdown 都通过，测试数据已清理

## 下一步

- 把 tabbit-skill/dist/book-notes.zip 导入 Tabbit 国内版和国际版的技能
- 把分支合并到 main 并 push，这样 hook 软链与后续部署才会包含本功能
- 读第一本书时实际试用，按体验调整 SKILL.md 的提炼规则

## 风险 / 阻塞

- Tabbit 技能导入格式未经官方文档确认（zip 根目录放 SKILL.md），导入失败时可能要调整目录结构
- 线上已部署分支代码；在合并到 main 之前，如果从 main 重新部署，书库功能会被覆盖掉

## 涉及文件

- 工作区无未提交改动（改动可能已提交）