Docs

NeoDB 是一个开放、互联的书影音游播客收藏与评论空间。你可以把它理解成一个更自由的文化产品数据库：找书、电影、剧集、音乐、游戏、播客和演出，记录自己的进度、评分、短评、评论和笔记，也可以通过联邦宇宙和 Bluesky/ATProto 把这些记录分享给朋友。 neodb.social 是 NeoDB 开发者维护的公共实例。你也可以使用其他 NeoDB 实例，或在需要时自建实例；不同实例之间通过开放协议互联。 NeoDB 能做什么 NeoDB 不是“又一个打分网站”和围墙花园，而是把你的文化生活记录放在一个更易用和互联的地方。 你可以用它做这些事： 建立自己的书影音游播客档案：想读、在读、已读，想看、在看、看过，想玩、在玩、玩过等。 写短评、长评、笔记和标签；标签可以公开，也可以只给自己整理用。 创建收藏单，例如“今年读完的小说”“想补的科幻电影”“适合通勤听的播客”。 从豆瓣、Goodreads、StoryGraph、Letterboxd、RateYourMusic、Steam、播客 OPML 等来源导入旧数据。 在动态页看到朋友的标记、评论和帖子；符合条件的播客和音乐条目还可以直接播放。 像传统社交网络或博客系统一样发帖：微博和长文都可以，不一定要围绕某个条目。 用 Fediverse 或 Bluesky/ATProto 身份登录和同步社交关系，也可以把公开记录同步到这些网络。 注册和登录 打开 neodb.social，点击页面上的注册或登录入口。NeoDB 当前常见的登录方式包括： 电子邮件注册。 使用 Fediverse 身份登录，例如 Mastodon、Pleroma、Firefish、GoToSocial、Pixelfed、Friendica、Takahē 等。 使用 Bluesky/ATProto 身份登录。 使用 Fediverse 身份登录时，只需要输入实例域名，不要输入完整账号。比如你的账号是 @neodb@mastodon.social，在这里输入 mastodon.social 即可。 如果你已经有 Mastodon 或 Bluesky 账号，用它们授权登录很方便；不过第一次进入 NeoDB 后，建议马上去 账号 页面绑定电子邮件，或添加 通行密钥（passkey）作为备用登录方式。 这个步骤很重要：如果你的 Mastodon 实例临时故障、账号丢失、Bluesky 应用密码失效，或者上游账号无法完成授权，你仍然可以通过电子邮件或通行密钥回到 NeoDB。 ...

NeoDB 的网页端可以在桌面和手机浏览器里使用，也是目前功能最完整的入口。刚开始使用时，建议先用网页端完成注册、绑定备用登录方式、导入旧数据、搜索条目和整理设置；之后再按自己的习惯选择手机应用或 Mastodon 兼容客户端。 网页端适合做什么 网页端覆盖 NeoDB 的完整功能集合： 搜索、创建和编辑书影音游播客条目。 标记想读、在读、已读，想看、在看、看过等状态。 写短评、长评、笔记、标签和收藏单。 导入豆瓣、Goodreads、StoryGraph、Letterboxd、RateYourMusic、Steam、播客 OPML 等旧数据。 管理账号、电子邮件、通行密钥、联邦宇宙身份、Bluesky 身份、同步设置和数据导出。 如果遇到第三方应用里找不到的设置或操作，优先回到网页端处理。 NeoDB 原生应用 一些第三方开发者正在维护 NeoDB 专用应用。它们不是 NeoDB 官方应用，功能范围、发布渠道和维护状态可能会变化，安装前请查看各自说明。 iOS： Piecelet，由 @piecelet@mastodon.social 开发：App Store / 源代码 Chihu，由 @chihu@mastodon.social 开发：App Store / 源代码 Fedicat，由 @fedicat@pc.cafe 开发：TestFlight / 源代码 Android： NeoComment，由 @mohammadrafigh@fosstodon.org 开发：源代码 NeoDB You，由 @neodb_you@mastodon.social 开发：F-Droid / IzzyOnDroid / 源代码 Mastodon 兼容应用 NeoDB 支持 Mastodon 的 API，所以很多 Mastodon 客户端可以登录 NeoDB 实例。它们适合处理社交时间线相关的功能： 发布短帖和图片。 查看时间线、回复、点赞、转发和书签。 在书签页找到正在阅读等进行中的条目，并通过回复写笔记。 但 Mastodon 兼容客户端并不是完整的 NeoDB 客户端。目录搜索、导入导出、条目元数据编辑、收藏单管理、账号安全设置等操作，仍建议使用网页端或 NeoDB 专用应用。 ...

NeoDB 的笔记适合记录“过程中的想法”：读到第几页的摘记，看剧到第几集的感受，听播客到某个时间点的想法，或游戏过程中的阶段记录。它和短评、长评不完全一样：短评偏一句话评价，长评偏完整文章，笔记更像带进度的随手记录。 在网页端写笔记 进入条目页后，先把条目标记到自己的记录里。对于正在阅读、观看、收听或游玩的条目，你可以在条目页的笔记区域新增笔记，并按页面提供的选项填写进度。 常见进度包括： 图书：页码、章节、百分比。 剧集：集数。 音乐：曲目。 播客：时间点。 游戏或其它长期项目：阶段、循环或自定义进度。 笔记可以和其它记录一样设置可见性。只写给自己整理用时，发布前检查可见性是否为仅自己可见。 用 Mastodon 兼容客户端写笔记 NeoDB 还有一个很方便的手机用法：用 Mastodon 兼容客户端的书签页写笔记。 步骤如下： 先在 NeoDB 网页端把一本书标记为 在读。 在 Mastodon 兼容客户端里登录 neodb.social。 打开客户端里的 书签 或 Bookmarks 页面。正在阅读的书会以书签动态的形式出现。 回复那条书签动态，回复内容会变成这本书的笔记。 注意这里用的是 书签，不是点赞或收藏夹。 在客户端里填写进度 如果想在 Mastodon 兼容客户端里顺手记录进度，可以在回复正文最后追加两行：倒数第二行只放短横线或破折号，最后一行写进度。 例如： 这一章把前面的伏笔收回来了，人物动机也清楚了很多。 - p200 常见写法： p200、page 200：第 200 页。 ch 13、chapter 13：第 13 章。 42%：进度 42%。 ep 6、episode 6：第 6 集。 trk 4、track 4：第 4 首。 23:45：播客或音频中的时间点。 发布后，NeoDB 会把末尾的进度行解析为笔记进度，并在网页端和客户端里显示为更适合阅读的格式。 ...

NeoDB 的搜索不只是找条目。你可以搜索目录里的书影音游播客，也可以搜索自己的记录、朋友动态、人物和外站链接。理解搜索以后，收藏单也会更好用：手工收藏单适合策展，动态收藏单适合把一组搜索条件保存下来，让它自动更新。 搜索条目 顶部搜索框可以输入： 标题、原名、译名。 作者、导演、演员、音乐人、播客名、游戏名。 ISBN。 外站条目链接，例如豆瓣、Goodreads、IMDb、TMDB、Bangumi、Steam、Spotify、Apple Music、Bandcamp、BoardGameGeek、AO3、Open Library、WorldCat、MusicBrainz，或播客 RSS。 用户地址，例如 @用户名 或 @用户名@实例。 如果你贴入的是外站链接，NeoDB 会尝试识别来源并拉取条目元数据。找不到条目时，搜索结果页也会提供手动创建入口。 搜索自己的记录 在个人记录搜索里，可以把普通关键词和过滤条件组合起来。常用过滤条件包括： status:complete：按状态过滤，可用 wishlist、progress、complete、dropped。 rating:8..10：按评分范围过滤。 rating:0：查找没有评分的记录。 tag:scifi：按标签过滤。 category:book：按分类过滤，可用 movie、tv、book、music、game、podcast、performance。 type:note：按记录类型过滤，可用 mark、comment、review、collection、note。 date:2024、date:2024-06、date:2024-06-13：按年份、月份或日期过滤。 date:2023..2024：按时间范围过滤。 sort:date、sort:rating：按日期或评分排序。 例如： status:complete rating:8..10 tag:scifi date:2024 sort:rating 这会查找你在 2024 年完成、评分 8 到 10 分、带有 scifi 标签的记录，并按评分从高到低排序。 动态页 动态 是朋友活动流，不只是条目评论区。你会在那里看到关注对象的标记、短评、长评、笔记、收藏单、回复和普通帖子。 动态页通常适合做三件事： 看朋友最近在读、在看、在听、在玩什么。 通过朋友的记录发现新条目、收藏单和评论。 发布普通帖子，像传统社交网络或博客一样写短帖、图片或长文。 如果你只想看围绕书影音游播客的内容，可以使用页面上的过滤选项；如果你希望减少他人的评分和评论干扰，也可以在设置里打开更专注的显示方式。 手工收藏单 手工收藏单适合“我明确挑出来的一组条目”。例如： 今年最喜欢的十本书。 想补的华语独立电影。 适合通勤听的播客。 给朋友推荐的入门游戏。 你可以从条目页把条目加入收藏单，也可以在收藏单页面调整顺序、补充说明和设置可见性。手工收藏单不会自动变化，适合需要人工排序和写说明的场景。 动态收藏单 动态收藏单是“保存下来的个人记录搜索”。你先在自己的记录里搜出一组结果，再把这条搜索保存为动态收藏单。以后你的标记、评分、标签或状态变化时，收藏单会按同一条查询自动更新。 适合保存成动态收藏单的例子： date:2024 status:complete rating:8..10：2024 年完成且高分的条目。 status:progress category:book：当前在读的书。 tag:通勤 category:podcast：被你打上通勤标签的播客。 type:note tag:摘录：带摘录标签的笔记相关条目。 动态收藏单不能像手工收藏单那样逐项拖动排序或删除单个条目，因为它的成员来自搜索结果。想改变内容，需要修改条目的状态、评分、标签，或回到收藏单的 查询 入口调整搜索条件。 ...

NeoDB 收录情况 NeoDB 目前支持图书（含网络小说、同人作品）、影视、音乐、游戏（含桌游）、演出、播客类型的条目。 Movie(电影） TVShow（电视剧系列） TVSeason（电视剧分季） TVEposide（电视剧分集 Work（著作） Edition（图书） Album（专辑） Game（游戏） Perfomance（演出） PerformanceProduction（上演版本） Podcast（播客） 待实现的类型： Series（丛书） People（现实人物） 上游站列表 NeoDB 能从其他网站导入条目，这些网站称作上游站，导入后会在条目标题的右侧显示上游站标签。 上游站 中文元数据 导入方式 可导入的类型 IMDB ❌ 网页 Movie、TVShow、TVSeason、TVEpisode TMDB ✅ API Movie、TVShow、TVSeason、TVEpisode 豆瓣 ✅ 网页 Edition、Work、Movie、TVSeason、Album、Game、Perfomance、PerformanceProduction Bangumi ✅ API Edition、Movie、TVSeason、Album、Game Goodreads 🤗1 网页 Edition、Work 谷歌图书 🤗2 API Edition、Work 起点中文网 ✅ 网页 Edition 阅评说 ✅ 非开放API Edition AO3 🤗3 网页 Edition 晋江文学城 ✅ 非开放API Edition 博客來 ✅ 网页 Edition Steam 🤗4 API Game IGDB ❌ API Game BoardGameGeek ❌ 网页 Game Apple Music 网页 Album Bandcamp 网页 Album Discogs API Album Spotify API Album ApplePodcast API Podcast 音乐平台 TODO ...

NeoDB目前提供API搜索条目库，以及通过OAuth认证令牌访问个人的标记和评论，详见 https://neodb.social/developer/

豆伴（又称豆坟）是一款浏览器扩展程序，可以安装在Chrome/Vivaldi/Opera/Edge/Brave等电脑浏览器中，用于备份自己的豆瓣数据到本机，然后再从本机上传到NeoDB。 豆伴已有两年未更新，经用户反馈目前存在备份失败的可能，如果您有更稳定的替代方法请与我们联系。 以下来自豆伴官方说明: 豆伴：豆瓣账号备份工具 一款 Chrome 扩展程序，用于备份豆瓣账号数据。 安装 此工具基于 Chrome 扩展开发，所以需先安装 Chromium 内核浏览器才能使用。请先检查你的系统种是否已经安装了此类浏览器。常见的 Chromium 内核浏览器有：Chrome、Opera、Vivaldi 等。如果你所在的地区无法访问 Chrome 浏览器的官方网站，建议使用 Vivaldi 浏览器代替。为了你的系统安全，请务必不要安装从其他任何非官方渠道（特别是国内某搜索引擎推荐的链接）下载的 Chrome 浏览器。 1. Chrome 网上应用商店 如果你所在的地区可以访问 Chrome 网上应用商店，请直接前往： https://chrome.google.com/webstore/detail/ghppfgfeoafdcaebjoglabppkfmbcjdd 进行在线安装。 如果无法打开上面的链接，请选择其他安装方式。 2. 本地安装扩展 如果你系统中安装了 Chromium 内核的浏览器，可以前往 https://download.doufen.org/ 下载打包的扩展程序，进行本地安装。 安装方法： 将下载的压缩包解压缩后保存到本地文件夹中； 打开浏览器主菜单，选择「更多工具」-「扩展程序」，或者直接在浏览器地址栏内打开「chrome://extensions/」； 开启页面右上角的「开发者模式」选项； 点击「加载已解压的扩展程序」按钮，选择刚才保存的文件夹。 3. 使用「豆坟」浏览器 为了方便 Windows 用户，特地制作了开箱即用的「豆坟」浏览器，可以前往 https://download.doufen.org/ 下载。「豆坟」浏览器是一个修改过的 Chromium 浏览器，无需通过 Chrome 网上应用商店便可安装「豆伴」扩展程序。 「豆坟」浏览器无需安装，下载后解压缩保存到本地，双击运行「豆坟.exe」。启动浏览器窗口后，会自动下载并安装「豆伴」扩展程序。安装完毕后，会在浏览器地址栏右侧出现「豆伴」扩展程序的图标。 使用 成功安装后，你会在浏览器地址栏右侧看到扩展的图标。如果没有找到图标，可能需要前往「扩展程序」页面开启此扩展程序。 1. 备份数据 请先在浏览器中打开豆瓣并登录你的账号。然后点击扩展程序图标，在下拉菜单中选择「新建任务」，在对话框中选择你要备份的项目，点击「新建」按钮开始备份。 2. 浏览备份 备份完成后，可以在刚才的下拉菜单中，选择「浏览备份」来查看备份的内容。你可以点击浏览视图右上角的「导出数据」按钮，将数据导出到 Excel 表格中。 导出得到的文件可以在NeoDB的「数据」页面导入。