页间是一个通用的静态漫画站。 它把作品目录、漫画阅读器和台词检索放在一起，以纸色、墨色与青绿为基础，提供三套深浅配色，适合建立自己的漫画资料库。
站点由 Astro 构建，提供 EdgeOne Makers、ESA Pages、GitHub Pages 和 Cloudflare Workers Static Assets 部署入口，并保留 Cloudflare Pages。图片与检索库保存在对象存储中，经 CDN 读取；浏览与检索不需要常驻应用服务器。仓库默认不附带实际漫画、线上账号或已配置的部署项目。各平台容量与预览边界见下方部署说明，适配代码不代表已经完成云端验收。
中文是默认 README；顶部按钮可切换到英文。网站当前默认中文界面，README 的语言切换只切换文档。
主要功能
- 作品浏览：作品 / 期 / 话 / 页层级、封面、作者、标签、各作品最新一话、随机一话，以及元数据检索。“最新一话”按期 / 话顺序选取，不代表按发布时间排序。
- 漫画阅读：单页、长条和双页模式，阅读方向、键盘与滑动翻页、全屏、亮度和页码跳转；自动保存阅读进度，首页和作品页可继续阅读。
- 个人书架与最近阅读：收藏作品，手动标记“想读／在读／已读”，按状态和作品名筛选，按书架更新时间或最近阅读排列；独立查看最近阅读的章节，未收藏作品也可继续阅读。
- 阅读数据概览：汇总收藏作品、有进度的作品与章节、页码书签及带文字备注书签，复用当前页面数据；存储受限和本页未保存修改会单独提示。
- 页码书签：普通和增强阅读器共用页收藏，可添加简短备注；在书架按作品筛选，按备注、作品或章节等信息查找、修改或移除书签，直接跳到对应页。
- 阅读备份：在书架导出或恢复收藏、进度、页码书签和备注；导入先预览，默认合并并保留已有记录，全程在浏览器内完成。
- 深浅配色：在浅色、深色与跟随系统之间切换，三套主题均有深色版本；记住当前浏览器的选择，漫画图片保持原色。
- 长连载与弱网：完整目录在首次打开时加载，每页最多显示 100 话，支持正序／倒序、前后翻页、输入组号跳转、文字与进度筛选，以及跨页定位当前章；显示各章阅读位置并可返回已记录页码。图片自动尝试备用来源，失败后可单独重试本页，台词层仍可读。
- 台词定位：可选择和复制的文字层，搜索结果直达页码与台词框；页面显示实际台词稿覆盖率。
- 浏览器端搜索：下载并校验对应版本的 SQLite 检索库，支持作品筛选与结果分页；首次有效查询才加载数据库。
- 内容导入：支持 LabelPlus 台词稿；没有稿时，可生成 OCR 草稿，人工校对并明确接受后再纳入检索。
- 可选增强分页：通过
features.comimi_reader 开启增强阅读入口，支持缩放和手势，界面使用本站名称、图标与页码书签文案；默认关闭，加载失败可回退到标准阅读器。
- 站点自定义：维护者可在浏览器中预览和设置站名、Logo、页脚文案、配色、标题字体、导航入口及阅读功能，保存到同一份站点配置。
- 静态发布：每话一个 HTML，构建时生成索引、sitemap 和平台配置；发布流水线校验不可变资源、部署回执和版本一致性。
在阅读页打开“目录”（或按 t），可查看各章“暂无进度”“读至第 N / M 页”或“已到末页”。章节名称筛选可与“有进度／暂无进度”组合使用；点击有进度的章节会返回已记录页码。“定位当前章”会清空筛选并定位当前阅读位置。这些提示只描述浏览位置，不会自动把作品标成“已读”。
从导航或页脚打开“我的书架”（/library/）。在作品页加入书架，默认标记为“想读”；
阅读状态由自己调整，不会随翻页自动变为“已读”。移出书架保留阅读进度；尚无章节的作品
也能收藏，发布章节后即可开始阅读。
“最近阅读”显示每话最后一次保存的位置，无需先收藏作品；可按作品、作者、期名或章节名查找，每次显示 20 条并可继续展开。它复用已有进度，不保存每次访问的流水，也不会自动修改作品收藏或阅读状态。
“阅读数据概览”按当前目录和页面恢复规则汇总可显示记录，不随搜索、筛选或分页改变。独立备注和编辑中的草稿不计入；备份另有校验并保留合法旧记录，条数可能不同。
阅读时可收藏当前页、编辑最多 200 字符的备注，在“我的书架”的页码书签区集中查看。
作品无需先加入书架即可保存页书签；移出作品书架也会保留页书签。增强阅读器已有的页收藏
直接兼容，不需要迁移。备注须明确保存或取消，翻页不会自动保存正在编辑的内容。
“查找书签”支持备注、作品名、作者、期名或章节名，与作品筛选组合使用。每次显示 50 条，可继续展开；更换关键词或作品时回到前 50 条。搜索复用已加载数据，不额外读取存储，编辑中的备注草稿不参与匹配，阅读数据概览的总数不变。
书架、书签、备注与进度保存在当前站点的当前浏览器中，没有账号同步。浏览器不允许保存时，
页面会提示修改仅在当前页面临时保留。清除站点数据或更换设备、域名前，可先保存备份文件。
保存或移除失败后，可使用“重试保存”完成剩余操作，或“放弃未保存修改”重新读取已保存记录。
正在编辑的备注须先保存或取消；所有未保存修改处理完后即可备份。
如果其他窗口已修改同一页，重试会提示冲突并保留待处理状态；可放弃未保存修改，核对最新记录后重新编辑。
多标签页同时使用时，短时间内连续到达的书架、书签和进度更新会合并刷新。回到窗口或手动刷新记录时，会立即读取最新数据；正在编辑的书签备注仍保留草稿。
切换深浅配色
在导航中的配色选项选择“浅色”“深色”或“跟随系统”，默认跟随系统。选择保存在当前站点的当前浏览器中，切换页面或再次打开时继续使用；跟随系统时，系统外观变化也会同步。浏览器不允许保存时会显示提示，本页仍可切换。
旁边的昼夜场景开关用于快速选择浅色或深色；需要恢复自动配色时，仍可从配色选项选择“跟随系统”。两种控件共用同一份状态，系统外观和其他标签页的修改会同步到场景开关。
书架、搜索、书签和阅读控件共用配色，增强分页也会同步；漫画图片不会反色。页面在显示正文前读取已保存的选择，减少首次打开时闪白。关闭 JavaScript 时仍通过 CSS 跟随系统，手动切换控件保持隐藏。该偏好属于界面设置，不包含在阅读数据备份中，也不改变站点配置或发布流程。
备份与恢复阅读数据
- 打开“我的书架”的“备份与恢复”，导出一份 JSON 备份文件。它包含已保存的书架状态、阅读进度、页码书签和备注，不包含漫画图片或台词库。
- 在另一浏览器或新域名的书架中选择该文件，查看将新增、保留、覆盖或修复的记录数量。此时尚未写入。
- 默认保留本机已有的状态、进度和备注，页码书签取并集。需要恢复备份中的冲突记录时，明确选择使用备份，再核对预览并确认导入；备份以外的记录不会删除。
文件不上传服务器，无需账号或后台。迁移按作品与章节标识匹配；当前目录中已移除或尚未收录的合法记录仍会保留，但暂不显示，孤立备注不会重新创建书签。备份只包含已成功保存的记录；本页存在未保存的临时修改或正在编辑的备注时，先完成保存或取消编辑。
支持的备份上限为 5 MiB、20,000 条记录，每个收藏页单独计数。格式、版本或内容不合法时拒绝导入；导出跳过损坏的旧记录并提示数量。预览后检测到数据变化时需重新预览。写入失败会尝试恢复本次已写数据，并如实提示恢复不完整的情况；请保留原备份，按提示核对后再重试。
怎么跑
需要 Node.js 22.19.0+ 和 pnpm 10+，以满足锁定依赖的最低版本。以下命令可在 Codespaces 终端运行；Python 3 用于协作守卫，可选 OCR 另需 Tesseract 和对应语言包。
pnpm install --frozen-lockfile
pnpm --dir docs-site install --frozen-lockfile # 完整测试需要独立的文档依赖
pnpm run init # 中文交互配置站点，确认后写入；也可保留默认配置直接构建
pnpm run build # 生成配置、检索库、静态页面、索引和 sitemap，不发布
pnpm run check # 配置同步、数据校验、产物预算与 lint
pnpm test # 数据模型、阅读器、搜索与构建发布测试
首次完整构建会生成所需的中间文件。空内容目录也能构建，首页会明确显示尚无作品。
预览构建结果：
pnpm run preview --workspace @gallery/site -- --host 0.0.0.0
在 Codespaces 的「端口」面板打开终端显示的预览端口。页面开发可运行 pnpm run dev --workspace @gallery/site -- --host 0.0.0.0；修改 site.config.yaml 或 data/ 后，重新构建以刷新生成数据。开发服务器不提供构建到 dist/index/ 的元数据索引，完整检索验收使用构建后的 preview。
完整构建顺序：
build:config → build:manifest → build:db → build:site → build:index → build:sitemap
若只想查看示例章节，可在 Codespaces 的 Bash 终端使用测试夹具构建：
DATA_DIR=packages/core/test/fixtures/data DIST_DIR=out/demo-dist OUT_DIR=out/demo-build pnpm run build
python3 -m http.server 4173 --bind 0.0.0.0 --directory out/demo-dist
夹具仅包含虚构元数据与台词，没有漫画图片。上述预览服务器需要 Python 3；实际图像需自行配置。示例构建会刷新共用生成数据，返回默认站点前重新运行 pnpm run build。
配置与内容
site.config.yaml 是唯一配置源。pnpm run init 可交互设置站名、域名、图片源和功能开关，按当前配置提供默认值；取消时不写入。使用 pnpm run init -- --ui-lang en 可切换初始化工具的界面语言。
也可以通过参数预览修改：
pnpm run init -- --title "我的漫画站" --domain gallery.example.org --image-host images.example.org --target cloudflare --project my-comics
pnpm run init -- --help
参数模式默认只预览，确认后在同一条命令末尾加 --write 才写入；--dry-run 可显式预览，不能与 --write 同用。非交互环境应使用参数模式。图片源可重复传入 --image-host，最多两个；--text-layer、--enhanced-reader 和 --platform-config 接受 true 或 false。--site-lang 只设置 HTML 语言标记，不翻译网站界面。
--target 取 none（默认）、edgeone、esa、github、workers 或 cloudflare，仅选择平台设置提示；实际发布目标仍由手动发布表单指定。--project 写入 Cloudflare Pages 项目名，其他平台的账号标识和凭据仍放在 secrets。初始化允许示例域名用于预览，不创建云资源或触发部署。
工具保留已有注释和未选择的字段，复用完整配置校验；写入前将原文件备份到 out/init/（可由 OUT_DIR 覆盖），通过同目录临时文件原子替换，并在检测到配置被同时修改时中止。--config 可指定其他现有配置，未指定时依次使用 CONFIG_FILE 环境变量或仓库根文件。初始化后运行 pnpm run build 刷新派生配置和站点产物。
站点自定义
pnpm run customize
打开终端显示的地址，即可调整名称、Logo、页脚文案；选择纸白、海蓝或暮紫主题，设置自定义主色和衬线／无衬线标题；显示或隐藏搜索、书架入口，以及开关文字层和增强分页。预览随编辑更新，点击保存才写入 site.config.yaml。右侧可分别预览深浅配色，预览切换不会写入配置或更改读者的个人偏好。隐藏导航入口不会删除对应页面、已有书签或阅读记录。
这是维护期间临时启动的编辑器，默认只绑定回环地址，不随正式站点部署。Codespaces 如需外部监听，可运行 pnpm run customize -- --host 0.0.0.0，通过「端口」面板打开对应端口，保持可见性为私有，并在转发地址末尾保留终端显示的 #token=…。不要公开转发该端口或分享带令牌的地址，结束后停止命令即可。
Logo 可填写 HTTPS 图片地址或站内 SVG 路径，默认使用 /favicon.svg；图片可放在自己的 CDN。当前产物预算禁止在 dist 中分发 PNG、JPEG、WebP 等图片，编辑器暂不提供上传。Logo 同时用于导航、网站图标和增强阅读器，第三方许可保持不变。
保存前会校验设置并将原配置备份到 out/customize/（可由 OUT_DIR 覆盖），保留未编辑字段与注释；检测到其他编辑器已修改文件时拒绝覆盖。--config 可指定其他现有配置，默认沿用 CONFIG_FILE 或仓库根文件。保存只更新配置文件，重新构建、检查并手动发布后，设置才对全站访客生效；无需给正式站点开放写入接口。
首次使用应核对：
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
