hectorqin
73f9eb6e20
feat(media): add isolated media libraries and playback
...
Support local and OpenList libraries, metadata, independent media navigation, themes, and audio/video playback. Preserve approved v2 prototypes and current documentation; archive superseded review artifacts and keep generated validation output outside version control.
2026-09-27 18:22:51 +08:00
hectorqin
0b7f901db5
chore(server): change default listening port to 5888
2026-09-24 14:50:13 +08:00
hectorqin
563a321898
fix(docker): include system Chromium for Legado WebView
2026-09-24 12:07:52 +08:00
hectorqin
9918141705
fix(docker): normalize shell entrypoint line endings
2026-09-24 07:53:10 +08:00
cnb.dQC5J6ohAGA
0f53088ffe
fix(docker): 允许非 root 用户写入挂载的 /data
...
服务端以非特权用户 `reader` 运行，镜像里构建时做的 `chown /data` 在
`/data` 被 **挂载** 时完全失效：bind mount 的属主来自宿主机目录，宿主机上
`./data` 不存在时 Docker 会以 root:root 新建它，于是服务端写签名密钥时
直接以 `EACCES: permission denied, open '/data/token.secret'` 崩溃退出。
命名卷继承镜像的 chown，所以只有 bind mount 受影响，而 compose 与 README
推荐的正是 bind mount，等于默认路径就是坏的。
改动：
- 新增 `server/docker-entrypoint.sh`：以 root 启动，只在启动时把 /data
这一层的属主改成 reader（不递归整棵树，避免大缓存目录每次重启都被
chown），随后用 su-exec 降权到 reader 再 exec 服务端。服务端仍是 pid 1，
main.ts 的 SIGTERM/SIGINT 优雅退出照常工作。若容器本来就不是 root
启动（`--user`），脚本直接 exec 命令，不尝试改属主。
- `server/Dockerfile`：装 su-exec（约 10KB；alpine 的 busybox 没有等价的
setpriv，util-linux 又不在基础镜像里），加 ENTRYPOINT。去掉 `USER reader`，
因为降权改由入口脚本完成。
- `server/src/config/index.ts`：写密钥失败时，EACCES/EPERM/EROFS 不再只抛
errno，而是报出「DATA_DIR 必须可写」并给出两种修法（改宿主机属主，
或设 READER_TOKEN_SECRET 跳过写文件）。这是自部署最高频的坑，
直接给出下一步能省掉一整轮排查。
- 新增 `server/test/config.test.ts`：覆盖密钥持久化与复用的稳定性、
READER_TOKEN_SECRET 优先时不落盘、目录不可写时错误信息含修法、
DATA_DIR 落在 BOOKS_DIR 内被拒。权限用例在非 root 下运行，
以 root 跑测试时跳过。
- README 增加「故障排查」小节，写明成因与 4 步自查。
验证：`npm run typecheck` 通过；`npm test` 149 项 148 通过 1 跳过
（跳过项即需非 root 的权限用例，已用非 root 单独跑通）；以非 root 手动
复现 EACCES 路径，确认错误信息与修法正确；入口脚本的 chown + 降权流程
手动模拟通过。
2026-09-17 10:16:11 +08:00
cnb.dQC5J6ohAGA
ec5fa83046
修复dockerfile
2026-09-17 09:55:13 +08:00
cnb.dQC5J6ohAGA
ca68a03e5d
merge: 解决 auto/init-server-scaffold-81b3 与 main 的冲突
...
两个分支各自演进：一侧引入格式注册表、H5 客户端与 Android 外壳，另一侧
引入漫画目录书与逐页取图。冲突集中在扫描器、metadata、library 路由和 web
客户端，逐项按「两边能力都要保留」的原则合并。
合并后修复了 4 个被冲突掩盖的真实缺陷：
- scanner 同时保留了两套目录书实现，类型检查与测试均无法通过；改为统一
走格式注册表，目录书在文件遍历之前发现，其内容不再重复入库。
- /manifest 的 files 对漫画目录书返回的是文件夹路径，客户端无法逐页取图；
改为由 manifest 派生真实页路径。
- 单个文件端点只认 book_files 行，漫画目录书的每一页都 404；改为目录书
额外认领其目录下的路径，并修正路径归一化使穿越尝试仍被拒绝。
- 目录书判定只看图片数量，会把夹着一本书的目录整体吞掉；改为注册表驱动
的判定，含书籍文件的目录始终是书架。
同时修复了 web 端两套测试运行器互相无法执行对方用例的问题（vitest 与
node:test 混跑会静默跳过），以及 web 侧 5 处类型错误。
Ref: #9
2026-09-16 18:04:11 +08:00
CodeBuddy
8e55dc23a3
fix(web,build): 无封面的书不再显示破图；镜像内置 H5 客户端
...
- 没有封面的书（大部分 txt、不少 pdf）之前是一个 <img> 不设 src，
浏览器渲染成破图图标 —— 那读起来像"这个书库坏了"，而事实是"这本书没有
封面"，读者无从分辨。改为显示书名首字（相当于书脊），并在封面加载失败时
也回落到同一占位。
- Dockerfile 加 web 构建阶段，`WEB_DIR=/app/public`，镜像里自带完整阅读器。
构建失败必须让镜像失败：一个没有客户端的服务端会看起来部署成功，
实际打开是落地页而不是阅读器。
- CI 拆成 server/web 两条，失败模式不同（读不了书 vs 白屏）。
- compose 构建上下文改为仓库根目录（从 ./server 构建会得到一个没有客户端的
服务端）。
已按 Dockerfile 的三阶段在本机复现验证：web 构建产物 + 服务端 dist +
prune --omit=dev 后的 node_modules，用生产布局起服务，浏览器实测四个格式
全部正常、零控制台错误。
2026-09-16 15:48:52 +08:00
cnb.dQC5J6ohAGA
2233b295bb
feat: 初始化自部署书库服务端
...
按产品设计 v0.2 落地服务端，覆盖第一版范围中的扫描、元数据、权限与同步。
核心决策：
- 书籍主键用 dc:identifier + 内容哈希，不用文件路径。
重命名/移动不丢进度，副本自动合并，重新编码的文件保持独立。
- 库目录只读挂载，写操作全部落到 DATA_DIR。
启动时断言 DATA_DIR 不在 BOOKS_DIR 内，路径解析统一走 resolveInside
拦截逃逸，扫描不跟随符号链接。
- 元数据优先级：手动修改 > 内嵌 > provider > 文件名解析。
手动修改独立成表，扫描永远碰不到，可单字段撤销。
- 中文文件名解析采取保守策略，无证据时不猜测作者方向。
- 离线合并用 LWW，笔记删除写墓碑，批次单事务。
- 无原生编译依赖：node:sqlite 与 scrypt 均为内置模块。
交付：
- Fastify + TypeScript 服务端，Docker 单容器
- 27 个自动化测试用例全部通过
- AGPL-3.0，README 做到一条命令跑起来
- CNB 流水线：typecheck / test / build
2026-09-16 14:07:25 +08:00
hectorqin
cnb.dQC5J6ohAGA
CodeBuddy