neodb

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

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 专用应用。

登录 Mastodon 兼容客户端时，服务器域名填写 neodb.social，然后按客户端提示授权。授权第三方应用前，确认它来自可信来源；不再使用的客户端，可以回到 NeoDB 的账号或授权管理页面撤销。

笔记入口

如果你主要想在手机上记录阅读笔记，可以使用 Mastodon 兼容客户端的 书签 页面。把书先在网页端标记为 在读，NeoDB 会按你的设置自动把对应动态加入书签；在客户端里回复这条书签，就会变成这本书的笔记。

具体写法见笔记说明。

登录安全

如果你最初是用 Mastodon 或 Bluesky 授权注册 NeoDB，建议尽快在 账号 页面绑定电子邮件，或添加通行密钥作为备用登录方式。这样即使 Mastodon 实例临时故障、上游账号丢失、应用密码失效，仍然可以回到 NeoDB。

参考资料

• NeoDB 应用列表
• 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 源代码仓库