neodb

<h4 class="article-title"> <a href="https://neodb.social/@help/posts/589018518612982376/">NeoDB API</a> </h4> <div class="article-body"> <p>NeoDB目前提供API搜索条目库，以及通过OAuth认证令牌访问个人的标记和评论，详见 <a href="https://neodb.social/developer/" rel="nofollow"><span class="invisible">https://</span>neodb.social/developer/</a></p> </div> <div class="article-tags"> <span class="tag">#NeoDB</span> <span class="tag">#中文文档</span> </div>

<h4 class="article-title"> <a href="https://neodb.social/@help/posts/589018520299527800/">NeoDB 应用</a> </h4> <div class="article-body"> <p>NeoDB 的网页端可以在桌面和手机浏览器里使用，也是目前功能最完整的入口。刚开始使用时，建议先用网页端完成注册、绑定备用登录方式、导入旧数据、搜索条目和整理设置；之后再按自己的习惯选择手机应用或 Mastodon 兼容客户端。</p><p>网页端适合做什么</p><p>网页端覆盖 NeoDB 的完整功能集合：</p><p>搜索、创建和编辑书影音游播客条目。<br>标记想读、在读、已读，想看、在看、看过等状态。<br>写短评、长评、笔记、标签和收藏单。<br>导入豆瓣、Goodreads、StoryGraph、Letterboxd、RateYourMusic、Steam、播客 OPML 等旧数据。<br>管理账号、电子邮件、通行密钥、联邦宇宙身份、Bluesky 身份、同步设置和数据导出。</p><p>如果遇到第三方应用里找不到的设置或操作，优先回到网页端处理。</p><p>NeoDB 原生应用</p><p>一些第三方开发者正在维护 NeoDB 专用应用。它们不是 NeoDB 官方发布和维护的，其功能范围、发布渠道和维护状态可能会变化，安装前请查看各自说明。</p><p>iOS：</p><p><span class="h-card"><a href="https://mastodon.social/@piecelet" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>Piecelet</span></a></span>，由 <span class="h-card"><a href="https://mastodon.social/@piecelet" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>piecelet@mastodon.social</span></a></span> 开发：<a href="https://apps.apple.com/app/piecelet-for-neodb/id6739444863" rel="nofollow">App Store</a> / <a href="https://github.com/lcandy2/neodb-app" rel="nofollow">源代码</a><br><span class="h-card"><a href="https://mastodon.social/@chihu" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>Chihu</span></a></span>，由 <span class="h-card"><a href="https://mastodon.social/@chihu" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>chihu@mastodon.social</span></a></span> 开发：<a href="https://apps.apple.com/app/chihu/id6737745206" rel="nofollow">App Store</a> / <a href="https://github.com/nunesdennis/Chihu" rel="nofollow">源代码</a><br><span class="h-card"><a href="https://pc.cafe/@fedicat" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>Fedicat</span></a></span>，由 <span class="h-card"><a href="https://pc.cafe/@fedicat" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>fedicat@pc.cafe</span></a></span> 开发：<a href="https://testflight.apple.com/join/b6GatWTY" rel="nofollow">TestFlight</a> / <a href="https://codeberg.org/technicat/fedicat" rel="nofollow">源代码</a></p><p>Android：</p><p>NeoComment，由 <span class="h-card"><a href="https://fosstodon.org/@mohammadrafigh" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>mohammadrafigh</span></a></span> 开发：<a href="https://github.com/mohammadrafigh/NeoComment/" rel="nofollow">源代码</a><br>NeoDB You，由 <span class="h-card"><a href="https://mastodon.social/@neodb_you" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>neodb_you</span></a></span> 开发：<a href="https://f-droid.org/packages/day.vitayuzu.neodb/" rel="nofollow">F-Droid</a> / <a href="https://apt.izzysoft.de/fdroid/index/apk/day.vitayuzu.neodb" rel="nofollow">IzzyOnDroid</a> / <a href="https://github.com/heddxh/NeoDB-You/" rel="nofollow">源代码</a></p><p>Mastodon 兼容应用</p><p>NeoDB 支持 Mastodon 的 API，所以很多 Mastodon 客户端可以登录 NeoDB 实例。它们适合处理社交时间线相关的功能：</p><p>发布短帖和图片。<br>查看时间线、回复、点赞、转发和书签。<br>在书签页找到正在阅读等进行中的条目，并通过回复写笔记。</p><p>但 Mastodon 兼容客户端并不是完整的 NeoDB 客户端。目录搜索、导入导出、条目元数据编辑、收藏单管理、账号安全设置等操作，仍建议使用网页端或 NeoDB 专用应用。</p><p>登录 Mastodon 兼容客户端时，服务器域名填写 neodb.social，然后按客户端提示授权。授权第三方应用前，确认它来自可信来源；不再使用的客户端，可以回到 NeoDB 的账号或授权管理页面撤销。</p><p>笔记入口</p><p>如果你主要想在手机上记录阅读笔记，可以使用 Mastodon 兼容客户端的 书签 页面。把书先在网页端标记为 在读，NeoDB 会按你的设置自动把对应动态加入书签；在客户端里回复这条书签，就会变成这本书的笔记。</p><p>具体写法见笔记说明。</p><p>登录安全</p><p>如果你最初是用 Mastodon 或 Bluesky 授权注册 NeoDB，建议尽快在 账号 页面绑定电子邮件，或添加通行密钥作为备用登录方式。这样即使 Mastodon 实例临时故障、上游账号丢失、应用密码失效，仍然可以回到 NeoDB。</p><p>参考资料</p><p><a href="https://neodb.net/apps/" rel="nofollow">NeoDB 应用列表</a><br><a href="https://github.com/neodb-social/neodb" rel="nofollow">NeoDB 源代码仓库</a></p> </div> <div class="article-tags"> <span class="tag">#NeoDB</span> <span class="tag">#中文文档</span> </div>

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