## 功能特性 - 📊 **条形码 / ISBN 查询** — 输入条形码自动查找 Open Library（书籍）或 UPC Item DB（通用商品） - 🔍 **标题搜索** — 跨 Open Library、OMDb、MusicBrainz、RAWG 多平台搜索 - ✍️ **手动录入** — 直接填写表单添加媒体项目 - 📥 **CSV 批量导入** — 从电子表格一键批量导入 - 📤 **CSV 导出** — 随时导出完整收藏库 - ⭐ **评分与状态** — 支持 1-5 星评分，跟踪拥有/愿望单/借出/已卖状态 - 🏷️ **分类管理** — 按 Book / Movie / Music / Game / TV / Other 分类筛选 ## ⚠️ 注意事项 | 限制项 | 说明 | 影响 | |--------|------|------| | 书籍外部 API 需代理 | 条形码/标题搜索调用境外 API，国内需配置代理，可在应用环境变量里进行代理配置 | 不配置代理则搜索功能不可用，手动录入不受影响 | | 游戏搜索需 API Key | RAWG 游戏搜索需要配置 API Key，可在应用环境变量里进行API配置 | 不配置则游戏搜索返回空结果 | 使用方法： ### 条形码 ISBN 查询（书籍） 1. 打开应用，点击 `+ Add` 按钮 2. 在 Barcode/ISBN 输入框中输入 `9780140449136`（《伊利亚特》ISBN） 3. 点击 `Lookup` 按钮 4. ✅ 预期结果：自动填充书名 "The Iliad"、作者 "Homer"、类型 "book"、封面图片 ### 标题搜索（电影） 1. 点击 `+ Add` 按钮，切换到 Title Search 2. 选择类型为 `movie`，输入 `Inception` 3. 点击 `Search` 按钮 4. ✅ 预期结果：搜索结果列表中显示 "Inception (2010)" 等匹配结果 5. 点击结果项，表单自动填充 ### CSV 批量导入 1. 准备如下 CSV 文件内容（保存为 `test.csv`）： ```csv title,creator,type,year,rating,status The Great Gatsby,F. Scott Fitzgerald,book,1925,5,owned Pulp Fiction,,movie,1994,4,owned Abbey Road,The Beatles,music,1969,5,owned ``` 2. 点击 `↑ Import CSV` 按钮 3. 拖拽或选择 `test.csv` 文件 4. ✅ 预期结果：显示 "Imported 3 items"，列表中出现 3 条新记录 ### CSV 导出 1. 确保库中已有数据 2. 点击 `↓ Export CSV` 按钮 3. ✅ 预期结果：浏览器下载 `catalogrr-export.csv` 文件，内容包含所有编目项 ### RAWG API Key 申请步骤 如需使用游戏搜索功能，需申请免费的 RAWG API Key： 1. 访问 [RAWG.io](https://rawg.io/apidocs) 2. 点击 "Get API Key" 按钮 3. 注册账号并填写应用信息 4. 获取 API Key（形如 `abc123def456...`） 5. 在懒猫应用安装时填入 "RAWG API 密钥" 参数