TinyRobot一键添加AI对话入口，一行命令省时高效
当今AI时代，各种大模型的能力一路飙升，不少团队都会冒出同一个念头——给自己项目里加一个AI聊天入口。听起来好像不难，无非就是搞个对话框嘛。可真正上手一搞，哎，事情就来了：聊天UI怎么写、流式响应怎么处理、会话状态怎么管理、Markdown怎么渲染、还要做响应式适配……单拎出来哪个都不算复杂，可凑到一起，就得折腾好一阵。
那有没有更省事儿的办法？既能快速搭一个AI对话应用，也能给现有项目快速加个AI入口？
当然有！
TinyRobot 就是干这个用的。它本身是一套AI组件库，封装好了基础的聊天气泡、输入框这些。现在又进一步推出了TinyRobot CLI，只需要两条简单的命令：
- 创建完整项目：用
create命令生成一套可以直接运行的TinyRobot示例工程； - 接入已有项目：用
add命令把AI聊天组件添加到现有Vue项目里。
先说清楚TinyRobot到底是什么，再说CLI为什么这么设计。
TinyRobot 是什么？
TinyRobot 是一套面向企业AI应用的Vue 3交互组件库与对话框架。底层基于OpenTiny设计体系，主要解决AI前端侧那些“不是不会写，但每次都得写”的常见问题，比如：
- 聊天消息和对话UI要怎么组织
- 流式消息如何在视图里逐字展示
- 多轮会话的状态怎么管理
- AI助手、智能客服、多轮对话页面如何快速搭建
- 响应式布局怎么在不同设备上保持一致
- 组件样式如何统一，后续扩展起来又不会拖泥带水
- ……等等
如果只是做个简单Demo，自己写一个聊天框当然没问题。但真实项目里，问题往往会逐步加码：消息发送和接收状态、加载中提示、异常处理、多轮上下文衔接、不同模型服务商的配置切换、后续业务组件怎么挂进来……每一个环节都需要前端专门做封装。用TinyRobot，等于有人帮你把AI会话应用里那些重复度较高的交互和工程基础提前搭好了，团队可以更快进入业务验证阶段，而不是在UI和状态管理上反复踩坑。
为什么要提供CLI工具
从之前各种问答、问卷和直播互动里，经常能听到类似的诉求——总的来说就是：感觉你东西挺好，但能不能让我用最快的速度跑起来？或者我已经有个项目了，能不能少改代码加进去？
这背后其实是AI时代大家对开发效率的普遍追求。一条CLI命令就能初始化项目或者注入代码，比手动复制粘贴省事太多，效率提升非常直接。而且，CLI对AI Agent也更友好——将来甚至可以把这篇文章直接扔给AI，让它自动执行CLI完成任务，这就真的把自己进一步解放了。另外，CLI也为后续更多与AI结合的能力预留了接口。
进一步来看，这背后其实对应着两个完全不同的使用场景。
一种是从零开始验证：团队还没有现成的接入方案，想先看看TinyRobot到底长什么样、好不好用。这种场景下，最好的方式就是几条命令，跑起来一个完整项目。
另一种是已有项目中增量接入：项目已经在线上跑着，或者正在开发中——比如一个后台管理系统、团队工作台、内部门户站。这时候最想要的不是另起炉灶重建，而是尽量少改现有代码，单独加一个AI会话入口，先看看效果，再决定后面怎么做。
所以，TinyRobot CLI同时提供了两条基础命令，覆盖这两种场景：
| 场景 | 推荐方式 | 适合做什么 |
|---|---|---|
| 还没有项目，或者想快速看完整效果 | 使用create命令创建完整项目 |
Demo、原型、PoC、方案验证 |
| 已经有 Vue 项目 | 使用add命令添加聊天组件 |
后台系统、工作台、门户站点中的AI入口 |
总结成一句话：想从零跑一个完整示例，用create；想在已有项目里加聊天能力，用add。
路径一：用 create 命令创建完整项目
create命令的定位很明确——就是让你“先跑起来”。它会帮你创建一个完整的可运行项目，非常适合第一次接触TinyRobot的开发者快速上手体验。
1. 执行创建命令
用npm或pnpm都可以：
# npm
npx @opentiny/tiny-robot-cli create
# pnpm
pnpm dlx @opentiny/tiny-robot-cli create
创建完成后，进入项目目录：
cd
2. 配置环境变量
创建出来的项目内置了DeepSeek和阿里百炼两个大模型服务商的示例配置。你只需要复制.env.example，再补充对应的API Key：
cd cp .env.example .env# 然后编辑 .env 文件 示例配置大概是这个样子：
# 阿里百炼 (DashScope) API_KEY —— 部分MCP插件依赖此变量VITE_ALIYUN -DASHSCOPE_KEY=# DeepSeek API_KEYVITE_DEEPSEEK_API_KEY=模板中还内置了3个MCP插件示例：阿里百炼提供的12306车票查询、高德地图、以及Model Context Protocol示例MCP。其中，阿里百炼相关的MCP插件依赖VITE_ALIYUN_DASHSCOPE_KEY。
不过这里必须提醒一句：前端项目中的VITE_环境变量会被注入到构建产物里，所以它们更适合本地演示和快速验证。如果在正式生产环境中涉及模型API Key，强烈建议通过后端服务转发或网关托管，避免把敏感Key暴露在浏览器侧。这个原则对所有前端应用都通用。
3. 安装依赖并启动项目
完成环境变量配置后，安装依赖并启动：
pnpm install && pnpm dev# 或npm install && npm run dev启动后，在浏览器打开：http://localhost:5173/，就可以看到TinyRobot的示例应用了。
这种方式适合哪些场景？
用create命令创建完整项目，适合这几类情况：
- 第一次接触TinyRobot，想先看完整的交互和功能效果；
- 想快速做一个Demo、原型或PoC，给老板或者客户演示；
- 团队内部想先验证AI会话的技术方案，确认可行后再决定是否接入正式业务；
- 希望先有一个可运行的项目，后面再基于它继续改造、二次开发。
它的好处是路径非常清晰——不用先纠结怎么和旧系统融合，把完整体验先跑起来。等团队确认了交互方式、模型服务商、MCP插件和业务方向后，再决定后续怎么接入到真实项目中。
路径二：用 add 命令给已有项目添加聊天组件
如果你的项目已经存在——比如后台管理系统、企业工作台、内部门户站——那通常的想法是：别让我为了加一个AI聊天功能重建一整套应用。这时候add命令就派上用场了。
用法也很简单：
1. 在现有项目根目录执行命令
在你的Vue项目根目录里执行：
npx @opentiny/tiny-robot-cli add chat如果你的项目是多包workspace结构，CLI会自动检测出来，并引导你选择目标package。如果是普通的单项目，CLI会直接在当前项目里完成注入。
2. CLI 会改哪些内容？
执行完成后，CLI会根据你勾选的变更项自动处理一些接入工作。默认情况下，它可能会涉及这些文件：
| 变更项 | 作用 |
|---|---|
src/TinyRobotChat.vue |
生成一个可直接使用的TinyRobot聊天组件 |
main.ts/main.js |
自动插入TinyRobot的样式导入语句 |
.env |
补充所需的环境变量 |
package.json |
添加或升级@opentiny/tiny-robot依赖 |
说白了，add命令就是帮你处理那些容易漏掉但又很机械的事情：组件生成、依赖补齐、样式引入、环境变量准备。把这些杂事先搞定，你就不用在一开始就大改业务代码了。
你可以先把聊天组件挂到一个页面上，确认交互和调用链路没问题，再逐步和业务数据、权限、页面布局做更深度的整合。
3. 在业务页面中使用组件
生成完成后，你就可以把TinyRobotChat.vue组件放到需要展示聊天入口的位置了。
比如在src/App.vue中这样使用：
<script>
import HelloWorld from './components/HelloWorld.vue'
import TinyRobotChat from './TinyRobotChat.vue'
</script>
同时，CLI会在src/main.ts或src/main.js中自动插入TinyRobot的基础样式：
import '@opentiny/tiny-robot/dist/style.css'如果你后续想把聊天入口放进某个具体的业务页面、抽屉、弹窗或侧边栏，直接把生成的组件移到对应目录，再按项目本身的组件组织方式引入就行了。灵活性很高。
4. 补充环境变量
如果只是想看看组件长什么样子，可能不需要马上配模型Key。但要想真正发起模型调用，就必须在.env文件里补充对应的API Key了。
默认示例是这样的：
VITE_DEEPSEEK_API_KEY=如果项目里已经有.env文件，CLI会尽量合并需要的变量进去。如果项目里没有.env，CLI会帮你新建一个。
同样需要再强调一遍：浏览器侧的环境变量不适合直接放生产环境的API Key。正式接入时，一定考虑后端做袋里、鉴权和限流。
5. 安装依赖并启动项目
如果package.json被更新了，需要重新安装依赖：
pnpm install && pnpm dev
# 或
npm install && npm run dev启动后，打开http://localhost:5173/，就能在已有项目中看到注入后的AI会话能力了。
这种方式适合哪些场景？
用add命令给已有项目添加聊天组件，更适合以下这些情况：
- 已经有后台系统、工作台或门户站点在运行或开发中；
- 不想重建项目，只想快速补一个AI会话入口当插件用；
- 团队想先低成本试点——先挂上去看看效果，再决定要不要做更深的业务整合；
- 希望接入过程尽量轻量，不破坏现有项目结构和代码习惯；
- 团队想先验证交互效果和调用链路是否通畅，再逐步考虑权限、数据、知识库等更重的业务能力。
相比创建完整项目，add命令更像是在现有项目上开一个“小入口”。它不会替你设计完整的业务闭环，但能让你在几分钟内就看到AI会话组件在真实项目里的样子，这个价值在试水阶段非常大。
小结
总结一下TinyRobot CLI的两条路径：
如果你还没有项目，或者想先看到完整的交互效果——用create命令快速创建一整套可运行工程。从项目结构、模型配置到MCP插件示例，所有东西都给你配好了，跑起来再说。
如果你已经有一个Vue项目——用add命令增量添加聊天组件。它不会改动你现有代码的结构和业务逻辑，只是把AI会话能力作为一个独立组件注进去，先让AI入口跑起来。
对于目前正在评估AI助手、智能客服、多轮对话系统的团队来说，这两种方式正好覆盖了两个典型阶段：
- 第一步，先用
create验证TinyRobot是否符合预期； - 第二步，再用
add把会话能力接入到真实的业务项目里。
后续计划
TinyRobot还在持续进化中。后续会进一步完善AI组件和交互能力，提供更多适用于AI应用的组件——包括布局组件、思维链展示组件、核心对话应用组件、Skill管理与动态加载等能力。
如果你正在做AI助手、智能客服、企业工作台里的智能入口，或者对Vue 3场景下的AI交互组件感兴趣，欢迎持续关注TinyRobot的进展。也欢迎在使用过程中反馈你遇到的问题——不管是使用上的困惑、发现的问题，还是希望未来能支持的能力，都可以通过Github社区向我们反馈。这些反馈会直接影响后续功能的设计方向。