用途:在现有 Vue 3 + Vite 业务应用里按阶段接入 TinyRobot Chat、GenUI、业务 WebMCP 与 PageTool,以目标项目实际安装的包、公开 API 和业务声明为准,不用演示组件或模拟工具替代真实接入。默认只完成代码接入验证,仅当用户明确要求时才执行运行时闭环。
阶段:1) TinyRobot Chat,基于 Vue 3 + Vite 应用,先查找已有组件与挂载链,不存在时按已发布 CLI 先执行 add chat --dry-run 再应用,不使用 create;2) GenUI,在已接入的唯一 TrChat 上增加,不创建第二个聊天面,经 PatternExtractor 解析流式内容,普通文本仍由 TinyRobot 渲染;3) 业务 WebMCP 与业务 Skill,接入 Next SDK 浏览器初始化、TinyRobot adapter 与 src/skills/**/SKILL.md 加载链,工具注册以业务声明为准;4) PageTool,使用当前 Next SDK 公开 API,未声明时不暴露业务页面内容。
所有权:第二阶段与第三阶段会改变 useLocalChatRuntime 的请求或 MCP 所有权,实施前须读取 Runtime 所有权,按目标版本源码 guard 选择唯一所有者,不能叠加互斥入口。自定义 adapter 为 MCP 唯一所有者时不得同时传入 mcpServers。
限制:配置只在 .env.example 补空占位,不读取或硬编码真实 .env 与密钥;VITE_* 会进入浏览器产物,需保密认证应由服务端或同源代理处理。缺少模型 Key 等运行时配置时保持相关功能不可启用并列出待补项。业务工具名、参数、返回值、副作用与确认规则均以业务方声明为准,缺少声明时只完成通用基础设施并指出需修改的文件与字段。不复制测试模板,临时测试在完成前删除,不占用用户已有进程。