安装
pnpm add @cloudflare/kumo适合谁
Kumo 面向要搭建现代 Web 应用界面的人，尤其是已经在用 React、希望少自己处理键盘、焦点和 ARIA 细节的前端。它是 Cloudflare 的组件库，建立在 Base UI 之上，对应页面是 https://base-ui.com/ 说明写明它会处理键盘导航、焦点管理和 ARIA 属性，让你按设计系统去拼界面。
更贴的用法是：你准备在 React 项目里引入 @cloudflare/kumo，先确认对等依赖 react、react-dom、@phosphor-icons/react 能装，再按需引入 Button、Input、Dialog 和样式。它不适合当编码助手的斜杠技能，也不适合没有 React 的项目。
仓库没有写其它包管理器的等价命令，因此主路径只按它给出的 pnpm 走。若你的仓库不用 pnpm，现有说明到此为止，不要把这条命令改写成未记载的安装器。
3 分钟完成第一次尝试
官方安装命令是：pnpm add @cloudflare/kumo。仓库地址是 https://github.com/cloudflare/kumo 请只按这一页操作。对等依赖的官方命令是：pnpm add react react-dom @phosphor-icons/react。若项目里已经有 React，先核对版本是否仍需要再装一层，不要盲目重复安装。
前置条件：本机有 pnpm，并且你有一个可以丢弃或本就使用 React 的本地应用。安装位置是该应用的依赖，而不是全局技能目录。
低风险第一次任务：先不要改页面。在项目目录执行 npx @cloudflare/kumo ls，只列出全部组件。成功信号是终端打印出组件名单，而不是你的页面已经被改掉。若要再看一份说明，用 npx @cloudflare/kumo doc Button 只读查看 Button 文档；npx @cloudflare/kumo docs 会取全部文档，第一次可以不做。
确认名单后，如需真正接入，再把这段写进一个不会上线的试验页：从 @cloudflare/kumo 引入 Button、Input、Dialog，并 import "@cloudflare/kumo/styles"。写入前先看 diff，确认只动了试验页和依赖清单。说明没有写主题定制或服务端渲染步骤，因此第一次停在“能列出组件、试验页能渲染一个 Button”即可。
使用案例
案例一：在 React 应用里引入常用组件。先 pnpm add @cloudflare/kumo，补齐对等依赖，再 import { Button, Input, Dialog } from "@cloudflare/kumo" 并加载 @cloudflare/kumo/styles。适合你已经有页面骨架、只想换成这套无障碍组件的时候。说明只点名了这三个组件作为示例，其它组件名以 npx @cloudflare/kumo ls 为准，不要猜。
案例二：用 CLI 只读查文档。npx @cloudflare/kumo ls 列出全部组件，npx @cloudflare/kumo doc Button 取单个组件文档，npx @cloudflare/kumo docs 取全部文档。适合你还没决定改哪一页、先核对 API 的时候。说明没有写文档的输出格式，也没有写离线缓存；查完即可，不必立刻改代码。若命令失败，回到 https://github.com/cloudflare/kumo 对照，不要改用未记载的安装方式。
使用边界
安装边界：官方只写了 pnpm add @cloudflare/kumo 以及对等依赖 react、react-dom、@phosphor-icons/react，没有记载的安装器不要使用。运行时边界：示例是 React 组件与样式入口，没有写无 React 用法。能力边界：它处理键盘导航、焦点管理和 ARIA，并宣称符合设计系统；没有写视觉主题一定等于 Cloudflare 官网每一页。CLI 边界：能核对到的是 ls、doc Button、docs。基础库是 Base UI，见 https://base-ui.com/ 但说明没有把 Kumo 与 Base UI 的全部组件一一对应。