用途：为 Polpo 智能体构建 React 界面。@polpo-ai/react 负责运行时状态与 hooks，@polpo-ai/chat 提供可组合 UI；应用路由与业务侧客户端工具执行仍由使用方应用负责。
安装：npm install @polpo-ai/chat @polpo-ai/sdk @polpo-ai/react react-virtuoso lucide-react streamdown；也可用 npx @polpo-ai/ui add 添加源码组件，新应用用 npx create-polpo-app。
用法：通过 @polpo-ai/react 的 PolpoProvider 提供上下文，baseUrl 为项目根，不要追加 /v1 或 /api/v1；不要在浏览器包中暴露服务端特权 API key，需保留在服务端时使用应用自身的鉴权后端或代理。普通聊天可用高层组件 <Chat agent="support" sessionId={sessionId} />；需要持久投递、自定义交互、显式客户端工具、Loop 续接或自有消息组装时直接用 useChat。
UI 约束：以 Polpo 的 Session 历史为准，重连或客户端工具续接后不要重复乐观消息；重连状态与流式状态分开显示，不要将已分离的持久运行标记为失败；仅在按本地处理器校验名称与参数后渲染客户端工具；用稳定幂等键与当前 Session 版本续接工具结果；建议属于产生它的助手消息，且仅在该消息仍为最新时可操作；附件使用类型化内容部分与鉴权文件 URL 解析，不要把本地文件系统路径放入浏览器可见消息。
参考文档包括 runtime-chat、components、patterns、cli、theming、contract-version 等。具体版本、收费与平台支持暂未提供。