前端架构
前端技术点¶
阅读器¶
genshin-novel-reader-web 使用 React 18、Ant Design 5、Vite 7 和 Less。Axios 访问在线 API;react-intl-universal 负责国际化;localforage 用于保存阅读样式。Vite 将应用构建为可嵌入 Node Web 的库,npm run local-build 用于本地集成构建。
UI 按 src/features/ 的功能目录组织,通用 API、模型、国际化和工具位于 src/shared/。入口组件 App.js 组合导航栏、阅读区和设置面板。用户可导入本地文件、在线搜索/阅读小说、管理书架和评论,以及调整阅读样式和模式。
状态管理¶
阅读器使用 React useState、useEffect 和回调管理组件状态;跨多个功能区共享的 API、用户和移动端状态通过 AppContext 传递。没有 Redux store、reducers 或 React Router。
当前阅读器状态包括文件列表和选中文件、阅读样式、分页位置、面板可见性以及在线 API/用户信息。文件列表和当前阅读位置保存在内存中;阅读样式写入 localforage。详见状态管理和浏览器存储。
管理页面¶
Node API 仓库的 react/ 子项目包含登录、注册、退出及管理员统计界面,使用 React 和 Ant Design。它与 npm 发布的阅读器包是不同的前端入口,服务端用 EJS 页面和静态资源集成。
其他主要依赖¶
classnames:组合 CSS 类名。is-hotkey:键盘快捷键处理。react-color:颜色选择器。react-icons:图标。react-select:选择控件。react-transition-group:过渡效果。jspdf:导出 PDF。qrcode.react:二维码展示。
依赖的当前版本以 genshin-novel-reader-web/package.json 为准。