媒体库功能使用指南

2024-05-01·技术浅谈

媒体库功能使用指南

Taco 提供了强大的媒体库功能，让你可以记录和管理阅读过的书籍和观看过的影视作品。

📚 功能概览

媒体库支持以下功能：

  • 📖 书籍记录管理
  • 🎬 影视作品管理
  • 🏷️ 状态分类（已完成、正在进行、想要阅读/观看）
  • ⭐ 评分系统
  • 📝 评价记录功能
  • 🔍 筛选和分页浏览

🔧 如何添加记录

1. 书籍记录

在 data/media.data.js 文件的 books 数组中添加新记录：

{
  id: 6,                    // 唯一ID，递增数字
  title: "书籍标题",        // 书籍名称
  author: "作者姓名",       // 作者信息
  cover: "封面图片链接",    // 书籍封面URL
  rating: 4.5,              // 评分 (0-5)
  category: "技术",         // 分类标签
  readDate: "2024-05-01",   // 阅读日期 (YYYY-MM-DD)
  review: "评价内容...",    // 读后感想
  status: "finished"        // 状态：finished/reading/mark
}

2. 影视记录

在 data/media.data.js 文件的 movies 数组中添加新记录：

{
  id: 7,                    // 唯一ID，递增数字
  title: "影片标题",        // 影片名称
  director: "导演姓名",     // 导演信息
  cover: "海报图片链接",    // 影片海报URL
  rating: 4.0,              // 评分 (0-5)
  category: "科幻",         // 分类标签
  watchDate: "2024-05-01",  // 观看日期 (YYYY-MM-DD)
  review: "观后感想...",    // 观影感受
  status: "finished"        // 状态：finished/reading/mark
}

📊 状态类型说明

状态分类

状态值 显示名称 说明
finished 已完成 已阅读完成的书籍或已观看完成的影片
reading 正在进行 正在阅读的书籍或正在观看的剧集
mark 想要阅读/观看 加入待读/待看清单的内容

状态使用建议

  • finished: 用于已经完成的内容，通常应该有评分和评价
  • reading: 用于正在进行中的内容，可以暂时不设置评分
  • mark: 用于想要阅读/观看的内容，通常评分为0，评价为空

🎨 封面图片建议

图片来源

  • Amazon: 图书和电影的官方封面
  • 豆瓣: 中文版本的封面图片
  • TMDB: 电影海报的高质量来源
  • Google Images: 其他来源的封面图片

图片规格

  • 推荐尺寸: 宽度 300-500px
  • 宽高比: 书籍 2:3，电影海报 2:3
  • 格式: JPEG 或 PNG
  • 文件大小: 建议小于 200KB

示例图片链接

// Amazon 图书封面
"https://images-na.ssl-images-amazon.com/images/I/51wqvVyXw2L._SX379_BO1,204,203,200_.jpg"

// Amazon 电影海报  
"https://images-na.ssl-images-amazon.com/images/I/51%2BPYpRKgyL._AC_.jpg"

📝 评分系统

评分标准

  • 5.0: 极力推荐，非常优秀
  • 4.0-4.9: 推荐，质量很好
  • 3.0-3.9: 一般，有一定价值
  • 2.0-2.9: 不太推荐，有缺陷
  • 1.0-1.9: 不推荐，质量较差
  • 0: 未评分或想要阅读/观看

评分建议

  • 保持评分的一致性标准
  • 可以使用 0.5 的增量 (如 4.5)
  • 对于想要阅读/观看的内容，建议设置为 0

🏷️ 分类管理

书籍分类建议

  • 技术: 编程、设计、工具类书籍
  • 文学: 小说、诗歌、散文
  • 科学: 科普、学术类书籍
  • 传记: 人物传记、自传
  • 哲学: 哲学、思想类书籍
  • 历史: 历史、政治类书籍

影视分类建议

  • 剧情: 剧情片、文艺片
  • 科幻: 科幻片、奇幻片
  • 喜剧: 喜剧片、轻松娱乐
  • 动作: 动作片、冒险片
  • 纪录片: 纪录片、教育片
  • 动画: 动画电影、动画剧集

📱 界面功能

筛选功能

  • 全部: 显示所有记录
  • 已完成: 只显示已读完/看完的内容
  • 正在进行: 只显示正在读/看的内容
  • 想要阅读/观看: 只显示待读/待看清单

分页浏览

  • 每页显示 12 条记录
  • 支持页码跳转
  • 自动计算总页数

💡 使用技巧

1. 批量添加

// 可以使用数组展开运算符批量添加
const newBooks = [
  { id: 6, title: "书籍1", ... },
  { id: 7, title: "书籍2", ... },
  { id: 8, title: "书籍3", ... }
];

// 添加到现有数组
books: [
  ...existingBooks,
  ...newBooks
]

2. ID 管理

// 简单的 ID 生成方法
const getNextId = (items) => {
  return items.length > 0 ? Math.max(...items.map(item => item.id)) + 1 : 1;
};

3. 数据验证

添加记录时建议检查：

  • ID 唯一性
  • 必需字段完整性
  • 日期格式正确性
  • 评分范围合理性

🔄 数据迁移

从其他平台导入

如果你有其他平台的数据（如豆瓣、Goodreads等），可以：

  1. 导出数据为 JSON 或 CSV 格式
  2. 编写脚本转换为 Taco 格式
  3. 批量导入到 media.data.js

备份建议

  • 定期备份 media.data.js 文件
  • 使用版本控制系统跟踪变更
  • 考虑将数据导出为 JSON 文件备份

✅ 完整示例

以下是一个完整的记录示例：

// 书籍示例
{
  id: 10,
  title: "代码大全",
  author: "Steve McConnell",
  cover: "https://images-na.ssl-images-amazon.com/images/I/515iO%2B-PRUL._SX408_BO1,204,203,200_.jpg",
  rating: 5,
  category: "技术",
  readDate: "2024-05-15",
  review: "软件开发必读经典，全面且实用的编程指南。无论是新手还是有经验的开发者都能从中获益良多。",
  status: "finished"
}

// 影视示例
{
  id: 10,
  title: "程序员之夏",
  director: "技术导演",
  cover: "https://example.com/poster.jpg",
  rating: 4.5,
  category: "纪录片",
  watchDate: "2024-05-20",
  review: "深入展现程序员的工作日常，很有共鸣。镜头语言流畅，故事叙述清晰。",
  status: "finished"
}

🎯 总结

通过媒体库功能，你可以：

  • ✅ 系统化记录阅读和观影历程
  • ✅ 建立完整的知识和娱乐档案
  • ✅ 通过评分和评价进行反思总结
  • ✅ 管理待读/待看清单
  • ✅ 分享品味和推荐内容

开始记录你的媒体消费历程，建立属于自己的知识和文化档案吧！📚🎬