进阶 docs.nodebb.org 2026-10-13 15:07:09 · 31 阅读

第52章 NodeBB 中未分类虚拟分类(cid -1)的作用与使用指南

未分类 (cid -1)

适用版本:>4.0.0

创建分类时,系统会为其分配一个数字分类ID(即cid)。NodeBB在初始设置时会自动生成四个分类,占用cid 1至4。

此外,界面上还存在一个cid为-1的虚拟分类。这个"未分类"虚拟分类并非数据库中真实存在、可供编辑的分类。

它如何使用

ActivityPub集成会利用该分类自动归档那些未指向特定分类的接收内容。鉴于其较为自由杂乱的性质,cid -1下的内容也需接受常规的清理机制。

它如何被使用

对cid -1的使用没有限制。你完全可以像操作其他分类一样,将其作为目标发布主题;具体做法是在调用api.topics.create时,将cid属性设为-1。

注意:由于内容清理仅针对本地用户无任何互动的主题,因此本地用户创建的主题自动免于清理。

对于希望复用现成的主题与帖子结构,而非从零开始构建数据结构的插件而言,这是一个很有用的构建思路。

例如,一个旨在让用户进行自我记录(journaling)的插件,可以利用现有的内部API,将日记条目(即主题)发布到cid -1中。在此场景下,开发者只需维护一份按用户划分的日记条目(tid)列表,而无需构建一整套用于向数据库保存日记条目的模型与控制层。

评论 (0)