bestblogs-topic — 主题探索
何时使用
- 用户想了解 BestBlogs 有哪些主题专页。
- 用户想深入某个特定主题(如 "AI 编程"、"Vibe Coding")。
- 用户想按类型筛选主题(事件型 / 领域型 / 人物组织型 / 对比型)。
原语
| 原语 | CLI | 说明 |
|---|---|---|
bestblogs.topic.list | bestblogs topics list --json | 浏览全部主题(默认中文) |
bestblogs.topic.list.en | bestblogs topics list --lang en --json | 英文主题列表 |
bestblogs.topic.list.filter | bestblogs topics list --type DOMAIN --json | 按类型筛选主题 |
bestblogs.topic.get | bestblogs topics get <slug> --json | 查看主题详情 |
bestblogs.topic.get.en | bestblogs topics get <slug> --lang en --json | 英文版主题详情 |
核心动作:浏览主题列表
bashbestblogs topics list --lang zh --json
返回:
json{ "success": true, "data": { "topics": [ { "slug": "vibe-coding", "type": "DOMAIN", "title": "Vibe Coding", "summary": "AI 辅助编程的全新范式……", "tagCodes": ["AI_CODING", "LLM"], "publishedAt": "2026-04-20T00:00:00Z", "pinnedOrder": 1 } ], "totalCount": 12 } }
展示建议:
pinnedOrder非 null → 置顶主题,优先展示(数字越小越靠前)。type枚举含义:EVENT— 事件型(某次具体事件的深度解读)DOMAIN— 领域型(某技术/方向的系统梳理)PERSON_ORG— 人物/组织型(人物或公司的全面解读)COMPARISON— 对比型(多个选项/方案的对比分析)
tagCodes帮助用户了解主题覆盖的技术领域。
查看主题详情
bashbestblogs topics get vibe-coding --lang zh --json
返回的 topic 对象包含:
title/summary/type/languagehasZhVersion/hasEnVersion— 是否有双语版本eventContent/domainContent/personOrgContent/comparisonContent— 对应类型的详细内容体(仅对应类型非 null)references— 脚注引用列表(含站内资源标题)furtherReadingResources— 延伸阅读资源快照(resourceId → resource 元信息)
bash# 查看英文版 bestblogs topics get vibe-coding --lang en --json
主题类型过滤
bash# 只看领域型主题 bestblogs topics list --type DOMAIN --json # 只看事件型主题(英文) bestblogs topics list --type EVENT --lang en --json
错误处理
404 / NOT_FOUNDontopics get <slug>→ 主题不存在或未发布;建议改用topics list查看可用 slug。404且有language参数 → 该语言版本尚未发布;尝试另一语言(hasZhVersion/hasEnVersion字段预告可用版本)。- 空列表 → 该类型/语言暂无已发布主题。
组合建议
- 发现感兴趣的 topic 后,从
furtherReadingResources中挑选 resourceId,链式调用bestblogs-readskill 深读 bestblogs-trending给热门横切面,bestblogs-topic给纵深主题视角 — 配合使用references中包含站内资源引用,可从中选取高相关内容继续探索

