HX Library System（图书管理系统）

为浙大星弦幻协编写的（包含极大量Copilot成分） 一个基于 Flutter 的轻量级个人/小型机构图书馆管理客户端，支持扫码导入 ISBN、手动录入、藏书位置管理、导入/导出 CSV、搜索与分享等功能。 此仓库为移动端（Android / iOS）和桌面端（Windows / MacOS）客户端源代码。

关键特性

• 扫描 ISBN 并从第三方 API 获取图书元数据（ShowAPI）
• 手动或自动添加图书到书架（支持重复 ISBN 的不同处理策略）
• 本地存储与索引管理（支持回收站与恢复）
• 导入 / 导出 CSV / Excel文件用于批量数据迁移
• 支持封面图片 URL、分类、简介、物理位置等元信息
• 简单的测试用例（位于 test/）

目录结构（简要）

• lib/ - 应用源码
• android/, ios/, windows/ - 平台工程
• test/ - 单元/Widget 测试

快速开始（开发者）

先决条件：

• 安装 Flutter SDK（建议使用最新稳定版）
• 已配置 Android/iOS 开发环境（Android Studio等）

一般构建并运行即可

配置

ShowAPI Key（或其他图书信息 API）

本应用在运行时从应用设置或本地存储读取用于查询图书信息的 API Key（具体实现参见 lib/services/book_api_service.dart）。

签名密钥与敏感信息

仓库中请不要提交真实的签名密钥或敏感配置（例如 *.jks、key.properties、local.properties）。仓库已将常见密钥与本地配置添加到 .gitignore。如果你需要在本地测试签名：

1. 在 android/ 下保存你的密钥文件，例如 release_keystore.jks（仅保存在本地，不提交）。
2. 在 android/key.properties 中配置密钥信息（同样不要提交）。
3. 我们建议在仓库中提供 android/key.properties.example（不包含真实凭证）以示例化配置。

在 CI 环境中，请将密钥与密码保存为 CI secrets，然后在构建脚本中动态注入。

许可证

采用GPLv3许可证，详见 LICENSE 文件。