2026-10-24 关于近期建站已完成的工作（四）

更新一：「藏书室」上线，书籍按系列与分卷整理#

功能概述：工具菜单调整为「学习工具」与「藏书室」两个入口。藏书室采用独立页面，集中展示书籍系列；同一本书的后续卷收纳在系列详情中，避免每上传一卷就把书架再挤满一格。

技术实现方案：

• 分类与系列分开：分类用于区分轻小说等书籍种类，系列保存书名、作者、简介和封面，分卷维护各自的卷名、顺序与阅读文件。后台可以在已有系列下继续上传，不必反复填写整套书的信息。
• 阅读格式：支持 EPUB、TXT 与 PDF。进入系列详情后选择分卷，再在新标签页打开阅读器；有目录的内容可以通过章节导航定位。
• 书架与卡片：默认采用书架展示，书脊结合实际封面图案与取色呈现，鼠标悬停或键盘聚焦时可以查看封面与完整书名。也可以切换为卡片，按分类、作者分组，并结合搜索、推荐与喜欢筛选。
• 连续浏览：书架按批次追加内容，加载更多时保留原来的位置；卡片按屏幕宽度调整每页数量，兼顾电脑与手机上的浏览空间。
• 封面与管理：支持单独上传封面，也可以利用书籍内可提取的图片作为封面来源；后台同步提供卡片、书架和列表视图，保留系列、分卷、封面及启用状态的管理。

问题与解决：最初把分类、系列与单卷混在同一层级，容易出现书架重复、上传繁琐和封面缺失的问题。现在将这三层明确分开，并统一前台入口、阅读页面和后台菜单中的「藏书室」名称；已有书籍链接继续可用。

更新二：阅读器、分卷切换与书籍互动完善#

功能概述：藏书室继续补齐实际阅读时需要的操作，让找书、选卷、阅读、恢复进度和评价形成连续的使用流程。

优化内容：

• 阅读设置：根据文件格式提供翻页或连续阅读、字号和主题等设置；EPUB、TXT 的文字排版与 PDF 的固定版面分别处理，不强行使用同一套排版方式。
• 分卷导航：上一卷、下一卷入口收纳到目录区域，卷末提供下一卷提示，由读者主动点击切换，避免浮动按钮与陪读角色互相遮挡。
• 本地记录：阅读进度与设置保存在当前浏览器，并支持导出、导入阅读记录。更换浏览器或设备时通过备份文件迁移，不把本地保存误认为账号云同步。
• 陪读与滚动：阅读页面的陪读角色可以移动和收起；改善滚轮、滑动与连续阅读体验，保留有意义的章节定位，去掉多余的底部横向滚动条。
• 评分与评论：系列详情支持五颗星的点亮交互与半星评分，评分可选，评论围绕整个系列集中展示。游客填写昵称提交后进入审核，通过后再公开；后台将评分、评论和留言分开管理。

问题与解决：此前存在书籍打不开、封面加载失败、控件遮挡和进度操作不顺手的情况。这一阶段分别修复资源加载与阅读交互，并把阅读记录、书籍内容和访客评价的保存方式区分清楚。

更新三：左下角旋转玩偶与页面陪伴交互#

功能概述：Study 页面及学习笔记增加左下角陪伴玩偶，把原本静态的角色点缀扩展为可以播放音乐、旋转互动和自由调整位置的小组件。

交互方式：

• 点击玩偶播放音乐并开始动作，再次点击暂停；播放需要主动操作，不在进入页面时强制出声。
• 电脑端右键、移动端长按打开角色菜单，可以在夜乃樱等角色之间切换。
• 按住拖动调整位置，菜单中可以调节音量或收起玩偶；收起后保留恢复入口。
• 优化玩偶旋转、形变与落点的连贯性，并保存角色、位置等偏好，减少每次进入页面都要重新调整的操作。

问题与解决：角色点缀不能以遮挡正文和按钮为代价。因此将拖动、收起、音量控制与角色切换一起补齐，让页面保留二次元氛围，也给专注阅读留出空间。

更新四：Agent 学习与文献学习接入学习笔记#

功能概述：「文章 → 学习笔记」继续扩充。在前端笔记、Python 语音处理笔记之外，加入「agent学习」与「文献学习」，按各自内容特点组织课程、练习和学习记录。

内容与使用方式：

• Agent 学习：按阶段组织基础知识、实践任务与项目练习，把概念、动手操作和项目准备放到一条学习路线中，学习记录保存在当前浏览器。
• 文献学习：围绕信息与通信工程、智能视频处理相关参考书目，整理基础知识、论文讲解、逐书练习与复习内容，方便阅读之后再检查理解程度。
• 练习扩充：文献学习新增 684 道逐书题目，加上原有 40 道练习，共 724 道，配合 12 个基础单元和 21 篇论文讲解使用。练习属于学习辅助内容，并非学校官方题库或考试范围承诺。
• 来源与阅读边界：保留书目来源、实际阅读范围和未取得原文的缺口。能够公开访问的内容提供原始来源入口，尚未读到的正文不会标记为已经精读。
• 记录迁移：文献学习支持导出、导入本地记录。之前在本地预览页面学习的记录，需要先从旧页面导出，再到线上页面导入。

问题与解决：仅列书单和少量问题不足以支持持续学习，因此补充逐书题库、基础单元与论文讲解，同时明确哪些内容已经取得原文、哪些仍有缺口，避免把概括性的整理当作完整阅读的替代。

更新五：各类笔记统一阅读风格，保留各自特色#

功能概述：以前几类笔记各自独立的页面为基础，统一淡紫色调、正文与控件字号、卡片间距、明暗对比和手机布局，让从一个学习入口切换到另一个入口时更加自然。

优化内容：

• 前端笔记保留作品与示例的浏览方式，语音笔记保留章节、代码与实验输出，Agent 和文献学习保留课程及练习结构，不把所有内容强行套成同一张页面。
• 分别补充前端创作桌、语音实验室、Agent 工作台和文献阅读角插图，替换反复出现的同一张装饰图，正文仍以清晰阅读为主。
• 调整深色模式下的文字对比度、侧栏与小屏布局，处理插图覆盖正文、长内容来回跳转不方便等问题。
• 延续语音笔记的 48 个网页实验，读者可以在页面内修改适合演示的代码，并查看文字、波形图或音频结果。
• 速记速查在简短定义之外补充详细解释，可以点击查看，也可以按 D 切换；在输入框中打字时不触发该快捷键。

更新六：导航、视觉细节与后台维护体验整理#

功能概述：在主要学习模块之外，继续完善日常进入网站、寻找内容和后台维护时遇到的细节。

优化内容：

• 独立导航页按分类展示网站卡片，后台维护网站信息与排序，补充目标网站图标的读取与保存，减少只有单字占位的卡片。
• 调整 Study 的淡紫主题、深色文字对比与阅读时的顶栏显隐；移动端壁纸换成适合竖屏的角色画面。
• 日间保留樱花氛围，夜间使用带拖尾的流星效果，并修正流星头尾方向。
• 完善文章编辑格式、转载信息、封面与壁纸缩略图展示，减少后台看到的内容与前台最终效果不一致的情况。
• 后台功能入口按站点适配，书籍管理与评论审核各自归类；不同站点的内容与管理范围继续分别处理。

问题一：页面已经打开，但内容仍要刷新才能出现#

问题表现：从站内导航进入导航页、藏书室等页面时，页面框架已经显示，数据或交互却没有正常初始化，手动刷新后才恢复。

处理方案：补齐页面切换后的初始化与清理，避免只在首次加载时执行逻辑；同时检查接口返回、资源路径和错误提示，让站内跳转与直接打开页面保持一致。

问题二：后台保存成功，不代表静态页面已经更新#

问题表现：文章和动态已在后台更新，前台仍可能停留在旧版本；页面标题已经改名，菜单中的旧名称却还被保留。

处理方案：完善自动构建的排队、失败重试与完成状态记录，成功生成后再发布资源；名称调整同时核对源码、实际页面和后台菜单配置。此次将后台遗留的「图书馆」菜单更正为「藏书室」，并核对电脑、手机顶栏入口。

问题三：视觉装饰增加后，阅读空间与加载成本也需要同步控制#

问题表现：封面、插图、玩偶和浮动控件叠加后，容易出现等待时间变长、文字难读或操作入口被挡住的情况。

处理方案：书架封面按可见范围加载并限制并发，长书名调整排版；插图避开正文，玩偶支持移动与收起，分卷切换放入目录。清晰的正文、能找到的按钮和稳定的阅读位置仍然优先。