用途:帮助用户发现 BestBlogs 上的主题专页,深入某个特定主题,或按类型筛选主题。
主要能力(CLI 原语):
- 浏览全部主题:bestblogs topics list --json(默认中文);英文列表加 --lang en。
- 按类型筛选:bestblogs topics list --type DOMAIN --json,类型枚举包括 EVENT(事件型)、DOMAIN(领域型)、PERSON_ORG(人物/组织型)、COMPARISON(对比型)。
- 查看主题详情:bestblogs topics get <slug> --json;英文版加 --lang en,例如 bestblogs topics get vibe-coding --lang zh --json。
列表返回字段:topics 数组含 slug、type、title、summary、tagCodes、publishedAt、pinnedOrder,以及 totalCount。pinnedOrder 非 null 表示置顶主题,数字越小越靠前;tagCodes 反映主题覆盖的技术领域。
主题详情字段:title、summary、type、language,hasZhVersion / hasEnVersion 表示是否有双语版本,eventContent / domainContent / personOrgContent / comparisonContent 为对应类型的详细内容体(仅对应类型非 null),references 为脚注引用列表,furtherReadingResources 为延伸阅读资源快照。
限制与错误处理:topics get <slug> 返回 404 / NOT_FOUND 表示主题不存在或未发布,可改用 topics list 查看可用 slug;带 language 参数返回 404 表示该语言版本尚未发布,可尝试另一语言;空列表表示该类型或语言暂无已发布主题。
组合建议:在 furtherReadingResources 中挑选 resourceId,链式调用 bestblogs-read 深读;bestblogs-trending 提供热门横切面,bestblogs-topic 提供纵深主题视角,可配合使用。