Kobra：把 shadcn 组件文档做成可交互展厅

是什么 这条推文推荐的是 Kobra，一套以 shadcn 风格组织的 React 组件展示与文档体验；相关页面还包括 Shoogle，用于搜索组件、blocks 和模板。它的价值不只是提供组件，而是把安装、预览、属性和组合方式放在同一个浏览路径中。

核心设计 页面采用左侧分类导航、中间实时预览、右侧安装命令与 API 说明的三栏结构。Carousel 用图片、地点和按钮形成明确焦点；AI Editor 用选中文本、箭头批注和文档正文展示协作语境；Sound 则按 Presses、Toggles、Surfaces、Values、Outcomes 分类，把声音反馈从装饰性效果提升为可理解的交互语义。浅色与深色主题也被直接纳入文档体验。

关键洞察 将 Props、Composition、named parts 和 data-slot 与视觉示例并置，能让工程师同时理解组件怎么安装、怎么组合以及为什么这样设计。这种文档更接近可操作的产品样板，而不是静态 API 参考。

边界与风险 高完成度预览不等于生产可用性，仍需验证无障碍、响应式、性能和状态覆盖。Input OTP 中的 validCode 与示例验证码属于演示配置，不能直接用于真实认证流程；Shoogle 的搜索覆盖范围也需要实际使用后确认。