neodb

<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-body"> <p>NeoDB 收录情况</p><p>NeoDB 目前支持图书（含网络小说、同人作品）、影视、音乐、游戏（含桌游）、演出、播客类型的条目。</p><p>Movie(电影）<br>TVShow（电视剧系列）<p>TVSeason（电视剧分季）<p>TVEposide（电视剧分集</p></p><br>Work（著作）<p>Edition（图书）</p><br>Album（专辑）<br>Game（游戏）<br>Perfomance（演出）<p>PerformanceProduction（上演版本）</p><br>Podcast（播客）</p><p>待实现的类型：</p><p>Series（丛书）<br>People（现实人物）</p><p>上游站列表</p><p>NeoDB 能从其他网站导入条目，这些网站称作上游站，导入后会在条目标题的右侧显示上游站标签。</p><p>!外站标签</p> 上游站 中文元数据 导入方式 可导入的类型 <a href="https://www.imdb.com/" rel="nofollow">IMDB</a> ❌ 网页 Movie、TVShow、TVSeason、TVEpisode <a href="https://www.themoviedb.org/?language=en-US" rel="nofollow">TMDB</a> ✅ API Movie、TVShow、TVSeason、TVEpisode <a href="https://www.douban.com/" rel="nofollow">豆瓣</a> ✅ 网页 Edition、Work、Movie、TVSeason、Album、Game、Perfomance、PerformanceProduction<p>| <a href="https://bgm.tv" rel="nofollow">Bangumi</a>|✅|API| Edition、Movie、TVSeason、Album、Game| <a href="https://www.goodreads.com/" rel="nofollow">Goodreads</a>|🤗<a href="#fn-1" rel="nofollow">1</a>|网页|Edition、Work|| <a href="https://books.google.com/" rel="nofollow">谷歌图书</a>|🤗<a href="#fn-2" rel="nofollow">2</a>|API|Edition、Work|| <a href="https://www.qidian.com/" rel="nofollow">起点中文网</a>|✅|网页|Edition|| <a href="https://www.ypshuo.com/" rel="nofollow">阅评说</a>|✅|非开放API|Edition|| <a href="https://archiveofourown.org/" rel="nofollow">AO3</a>|🤗<a href="#fn-3" rel="nofollow">3</a>|网页|Edition|| <a href="https://www.jjwxc.net/" rel="nofollow">晋江文学城</a>|✅|非开放API|Edition| <a href="https://www.books.com.tw/" rel="nofollow">博客來</a>|✅|网页|Edition| <a href="https://store.steampowered.com/" rel="nofollow">Steam</a>|🤗<a href="#fn-4" rel="nofollow">4</a>|API|Game|| <a href="https://www.igdb.com/" rel="nofollow">IGDB</a>|❌|API|Game|| <a href="https://boardgamegeek.com/" rel="nofollow">BoardGameGeek</a>|❌|网页|Game||<a href="https://music.apple.com/" rel="nofollow">Apple Music</a>||网页|Album||<a href="https://bandcamp.com/" rel="nofollow">Bandcamp</a>||网页|Album||<a href="https://www.discogs.com/" rel="nofollow">Discogs</a>||API|Album||<a href="https://open.spotify.com/" rel="nofollow">Spotify</a>||API|Album||<a href="https://podcasts.apple.com/us/browse" rel="nofollow">ApplePodcast</a>||API|Podcast|</p><p>音乐平台 TODO</p><p>导入时可能自动合并或关联现有条目，详情见下。</p><p>条目编辑</p><p>!进入编辑界面</p><p>NeoDB 不存在审核机制，所有登录用户均可在条目详情界面左下角（上图红色标记处）点击铅笔图标进入元数据编辑界面。</p><p>!条目编辑界面</p><p>左侧界面可手工填写元数据，右侧界面为编辑选项界面，建议在阅读完本章之前不要点击编辑选项中的任何按钮。</p><p>编辑选项</p><p>点击右上角的的🕒图标可查看条目编辑历史</p><p>点击任一“外部网站”按钮可展开“重新获取”按钮，其功能为从上游站重新获取条目元数据并覆盖现有数据，所以在点击此按钮前，请提前确认该上游站的元数据是否正确。</p><p>关联与合并是完全不同的，操作时务必注意。</p><p>合并条目</p><p>导入时自动合并</p><p>NeoDB 条目有一项“主要标识数据”的字段（对图书一般是 ISBN、对影视来说一般是 IMDB_id），如果 NeoDB 在导入外站条目时检测到已存在同标识数据的条目，会将其自动合并到现有条目。</p><p>TVSeason、Movie<p>豆瓣、IMDB、TMDB: 互相之间靠 imdb_id 能自动合并<p>bangumi: 三次元条目大部分有 imdb_id（出错概率极大，建议不要导入），动画大部分需要手动合并</p></p><br>Edition：大部分出版物有 ISBN (或ASIN) 就能合并<p>起点/阅评说/晋江：大部分阅评说条目能分别与起点、晋江条目合并。<br>全站统一使用ISBN13，大部分ISBN10会被自动转换为ISBN13</p><br>Game：大部分情况下需手动操作<p>IGDB、Steam 之间大部分时候能自动合并</p><br>Album<p>Douban / Spotify / Discogs 偶尔通过条形码（也称UPC）可以自动合并</p></p><p>编辑时手工合并条目</p><p>NeoDB 导入条目时并不都能自动合并，很多时候需要用户手动合并条目。点击“合并”按钮展开合并界面，在输入框中填入目标条目的链接后点击“合并到另一条目”即可。</p><p>注意合并条目并不会合并元数据，而只是将原条目的链接重定向到另一条目并移动上游站标签至目标条目。假设在 A 条目的合并界面填入 B 条目，合并成功后你就只能搜索到 B 条目。</p><p>普通用户仅可将未被标记（仅有用户本人标记也不行）的条目合并到其他条目，如有合并两个已被标记条目的需求请使用<a href="#%E4%BF%AE%E6%94%B9%E5%BB%BA%E8%AE%AE" rel="nofollow">修改建议</a>。</p><p>常见的合并误区：</p><p>同一书籍的不同出版版本（ISBN 不同）应使用<a href="#%E5%85%B3%E8%81%94%E6%9D%A1%E7%9B%AE" rel="nofollow">关联</a>而非合并<br>同一游戏的重制版与原版是不同的游戏，不应合并<br>同一季日本动画分割放送的两部分，不应合并</p><p>关联条目</p><p>TvSeason（分季）条目可以关联到 TvShow（系列）。注意：豆瓣本身没有 TVShow 条目，与其关联到其他上游站导入的 TVShow 不如合并到 TMDB/IMDB 的 TVSeason。</p><p>Edition 可以关联到另一本 Edition，这样二者的短评可以互通。适用范围：原著与不同译本。</p><p>修改建议</p><p>当遇到普通用户权限无法处理的操作时（合并两个已标记条目、取消错误合并），可以在“修改建议”界面提交建议，建议会被发送到<a href="https://discord.com/channels/1041738638364528710/1202807627684380702" rel="nofollow">Discord 条目管理板块</a>供管理员参考。</p><p>目前可在<a href="https://discord.gg/8KweCuApaK" rel="nofollow">Discord</a>申请成为旗舰站（neodb.social、eggplant.place）的条目管理员。请务必审慎使用管理权限，如有不确定的操作请在相关帖子与他人讨论。</p><p>常见问题</p><p>无法合并不同类型的条目</p><p>多见于影视类合并，有些网站（如 Bangumi）的 TvSeason 在导入时可能会错误识别成 Movie，需要用户手动在编辑界面点击“切换分类”按钮将其改为正确的分类。</p><p>locallized_title error</p><p>是图书条目自动合并引发的 bug，现已修复。旧有数据的解决方案是删去多余的 locallized_title。</p><p>条目管理员（Staff User）</p><p>条目管理员仅有合并/取消合并/删除已标记条目的权限，其余权限与普通用户没有任何区别。</p><p>条目管理员不能查看用户发布的非公开内容，能做到此事的只有实例服务器的所有者（站长）。</p><p>条目管理员只是维护条目元数据的志愿者，发表的非条目管理相关内容与所属实例均无关系。</p><p>条目管理员的用户页面有一个魔法帽图标。</p><p>附录：元数据字段</p><p>Edition（图书）</p><p>original_title 原标题 多出现于翻译作品<br>locallized_title 本地化标题：当地出版时用的标题<br>other_title<br>localized_subtitle 副标题<br>author 作者<br>format 格式（平装、）<br>pub_house 出版社<br>pub_month<br>pub_year<br>language<br>translator 译者<br>series<br>imprint 出品方<br>binding 装订<br>pages<br>price<br>index<br>localized_description 简介</p><p>TVSeason（电视剧分季）/Movie（电影）</p><p>二者字段基本一致</p><p>TODO</p><p>Game（游戏）</p><p>TODO</p><p><p>Goodreads：与图书出版语言相关<a href="#fnref-1" rel="nofollow">↩</a></p><br><p>谷歌图书：良莠不齐<a href="#fnref-2" rel="nofollow">↩</a></p><br><p>AO3：与文章的语言相关<a href="#fnref-3" rel="nofollow">↩</a></p><br><p>Steam：有些游戏开发商没有填中文元数据<a href="#fnref-4" rel="nofollow">↩</a></p></p> </div>

<div class="article-body"> <p>NeoDB 的笔记适合记录“过程中的想法”：读到第几页的摘记，看剧到第几集的感受，听播客到某个时间点的想法，或游戏过程中的阶段记录。它和短评、长评不完全一样：短评偏一句话评价，长评偏完整文章，笔记更像带进度的随手记录。</p><p></p><p>在网页端写笔记</p><p>进入条目页后，先把条目标记到自己的记录里。对于正在阅读、观看、收听或游玩的条目，你可以在条目页的笔记区域新增笔记，并按页面提供的选项填写进度。</p><p>常见进度包括：</p><p>图书：页码、章节、百分比。<br>剧集：集数。<br>音乐：曲目。<br>播客：时间点。<br>游戏或其它长期项目：阶段、循环或自定义进度。</p><p>笔记可以和其它记录一样设置可见性。只写给自己整理用时，发布前检查可见性是否为仅自己可见。</p><p>用 Mastodon 兼容客户端写笔记</p><p>NeoDB 还有一个很方便的手机用法：用 Mastodon 兼容客户端的书签页写笔记。</p><p>步骤如下：</p><p>先在 NeoDB 网页端把一本书标记为 在读。<br>在 Mastodon 兼容客户端里登录 neodb.social。<br>打开客户端里的 书签 或 Bookmarks 页面。正在阅读的书会以书签动态的形式出现。<br>回复那条书签动态，回复内容会变成这本书的笔记。</p><p>注意这里用的是 书签，不是点赞或收藏夹。</p><p>在客户端里填写进度</p><p>如果想在 Mastodon 兼容客户端里顺手记录进度，可以在回复正文最后追加两行：倒数第二行只放短横线或破折号，最后一行写进度。</p><p>例如：</p><p>这一章把前面的伏笔收回来了，人物动机也清楚了很多。-p200</p><p>常见写法：</p><p>p200、page 200：第 200 页。<br>ch 13、chapter 13：第 13 章。<br>42%：进度 42%。<br>ep 6、episode 6：第 6 集。<br>trk 4、track 4：第 4 首。<br>23:45：播客或音频中的时间点。</p><p>发布后，NeoDB 会把末尾的进度行解析为笔记进度，并在网页端和客户端里显示为更适合阅读的格式。</p><p>自动书签设置</p><p>NeoDB 的设置页里可以选择“自动为这些分类创建书签”。当你把这些分类的条目标记为在读、在看、在听、在玩等进行中状态时，NeoDB 会自动把对应动态加入书签，方便你在手机客户端里继续写笔记。</p><p>默认更常见的是图书场景；如果你也想给在看剧集、在听播客或在玩游戏写进度笔记，可以去 设置 页面检查相关分类是否开启。</p><p>即使某条进行中动态没有被自动加入书签，只要你能在客户端里找到那条动态并回复，NeoDB 也可以把回复关联成对应条目的笔记。</p><p>编辑时的小提醒</p><p>在 Mastodon 兼容客户端里编辑笔记时，可能会看到末尾有 NeoDB 自动添加的条目链接或进度行。如果只是修改正文，不需要动这些行；如果要修改进度，再把最后一行改成新的 p201、ch 14、55% 等格式。</p><p>如果你不确定客户端会如何处理编辑后的格式，回到 NeoDB 网页端编辑最稳妥。</p><p>参考资料</p><p><a href="https://mastodon.social/@neodb/112640901754020823" rel="nofollow">NeoDB 关于 Mastodon 客户端笔记的说明</a><br><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>