2026-03-26

工作内容

• 完成 bookmark 阅读器项目的大量功能开发：
  • 书籍导入和书库页面
  • EPUB/PDF 阅读器完整实现：渲染、目录导航、笔记面板、高亮标注
  • PDF 缩放控件、文字选中、高亮精确到选中文字、HiDPI 适配
  • PDF 支持鼠标滚轮翻页、连续滚动模式
  • EPUB 连续滚动模式、暗黑主题文字适配
  • 阅读器全文搜索功能
  • 数据导出/导入备份功能
  • 增强笔记编辑器（Tiptap）、修复笔记唯一性
  • 支持删除高亮、取消已标记的文字高亮
• 多项 Bug 修复：
  • 选中文字操作框支持点击外部关闭
  • 复制后清除选区，添加笔记直接使用默认颜色高亮
  • PDF 点击高亮文字弹出取消高亮选项
  • EPUB/PDF 操作后正确清除文字选区
• 配置 GitHub Actions 自动部署 bookmark 到 GitHub Pages（xiaoxiaoyi12.github.io/bookmark/）
  • 创建 deploy workflow、SPA 404 路由回退、.nojekyll 处理
  • 解决 Node.js 版本兼容、npm lockfile 同步、PAT 权限等部署问题
• 完善所有历史学习笔记（5 篇），统一为详细、结构清晰、小白友好的风格：
  • Claude Code Skills 机制、Skill 开发指南、飞书 MCP 集成、Superpowers 技能系统、前端测试指南
• bookmark 新增主题切换功能（护眼暖色调/暗色/跟随系统三种模式）：
  • 使用 Zustand 管理主题状态，localStorage 持久化
  • Tailwind v4 @custom-variant dark 实现 class-based 暗色模式
  • 全组件适配双色模式（18 个文件），EPUB iframe 通过 themes API 注入暗色样式
  • Tiptap 编辑器使用 .dark .tiptap 选择器适配暗色
• bookmark 书库页面 UI 优化：
  • 添加返回主页按钮（SVG 图标 + hover 效果）
  • 顶栏内嵌书名模糊搜索
  • 更换书签主题 favicon，标题改为 bookmark-web
• 博客站点新增主题切换：
  • Jekyll 博客支持暗色/亮色（护眼暖色调）/跟随系统三种模式切换
  • 将所有硬编码颜色重构为 CSS 变量（[data-theme] 属性驱动）
  • 创建 _includes/theme-toggle.html 共享组件，含防闪烁初始化脚本
  • 覆盖远程 Hacker 主题 default.html，将 View on GitHub 按钮移至标题右侧
  • 压缩 header 与内容区间距，整体布局更紧凑
  • 首页添加 bookmark 导航按钮

学习内容

• 学习了 GitHub Actions 部署 SPA 到 GitHub Pages 的完整流程 → 学习笔记
• 学习了 Tailwind CSS v4 暗色模式配置方式（@custom-variant 替代 v3 的 tailwind.config.js）→ 学习笔记
• 学习了 epub.js 的 themes API 动态注入样式到 iframe → 学习笔记

备注

• bookmark 项目单日完成了从基础书库到完整阅读器的跨越式开发
• GitHub Actions 部署过程中遇到多个问题：Node.js 20 deprecation 警告、lockfile 版本不兼容、PAT 权限配置
• 确立了学习笔记的写作标准：详细、结构清晰、配合代码示例和流程图、小白也能看懂
• Tailwind v4 暗色模式配置与 v3 差异较大，不再使用 config 文件而是 CSS 层声明
• 护眼模式选用暖色调（#f5f0e6 背景 + 绿色强调色），阅读体验舒适
• 博客主题切换通过覆盖远程主题 default.html 实现布局自定义，避免 fork 整个主题