CLI 接入

TinyRobot 提供官方 CLI 工具 @opentiny/tiny-robot-cli，用于：

create 创建完整的 TinyRobot 示例工程
add 向现有 Vue 项目快速注入聊天能力

安装方式

无需全局安装，可直接通过 npx 或 pnpm dlx 使用。

pnpmnpm

bash

# pnpm
pnpm dlx @opentiny/tiny-robot-cli

bash

# npm
npx @opentiny/tiny-robot-cli

create

创建一个完整的 TinyRobot 工程。

bash

npx @opentiny/tiny-robot-cli create <project-name> --template basic

示例：

bash

npx @opentiny/tiny-robot-cli create my-app --template basic

CLI 还提供独立的 Chat 模板：

bash

npx @opentiny/tiny-robot-cli create my-chat --template chat

运行时版本

create 和 add chat 都根据 CLI 包版本生成 TinyRobot 运行时依赖：prerelease 使用同一精确版本，stable 使用 ^ 范围。通常无需指定版本；如需让生成项目使用特定 TinyRobot 版本，可通过 --runtime-version <version> 覆盖默认版本。

bash

npx @opentiny/tiny-robot-cli create my-app --template basic --runtime-version 0.5.2-rc.2
npx @opentiny/tiny-robot-cli add chat --runtime-version 0.5.2-rc.2

create 会将版本写入生成项目的 TinyRobot 运行时依赖。add chat 使用该版本处理 TinyRobot 运行时依赖；稳定版本会保留能够满足目标版本的依赖，预发布版本按精确版本处理。

创建完成后：

pnpmyarnnpm

bash

cd my-app
pnpm install

# configure your API key
# copy .env.example to .env.local

pnpm dev

bash

cd my-app
yarn install

# configure your API key
# copy .env.example to .env.local

yarn dev

bash

cd my-app
npm install

# configure your API key
# copy .env.example to .env.local

npm run dev

create 命令特性

自动生成 Vue 工程结构
内置 TinyRobot 基础聊天能力
自动生成环境变量模板
提供可直接运行的示例页面

add

向现有项目添加 TinyRobot 能力。

bash

npx @opentiny/tiny-robot-cli add chat

CLI 会自动检测当前项目或 workspace 包，并引导选择目标 package。

执行命令后，CLI 会生成以下内容：

变更项	说明
`src/tiny-robot-chat/`	集成 TinyRobot Chat 组件和功能样式
`.env.example`	添加所需环境变量模板
`package.json`	添加或保留 TinyRobot Chat 所需依赖

add chat 不会修改 src/main.ts、src/main.js、src/App.vue 或 vite.config.*。

默认交互模式会显示待变更内容并请求确认；--yes 直接应用变更，--dry-run 只预览变更计划，不写入文件。如果写入过程中失败，CLI 会尝试回滚已应用的文件和新建目录；如果回滚失败，会报告未能回滚的路径。

CLI 会处理以下依赖：@opentiny/tiny-robot、@opentiny/tiny-robot-chat、@opentiny/tiny-robot-kit、@opentiny/tiny-robot-svgs 和 @vueuse/core。稳定版本会保留能够满足目标版本的依赖，预发布版本按精确版本处理。

配置 Model Context MCP 代理

在用户项目根目录现有的 vite.config.ts、vite.config.js、vite.config.mts 或 vite.config.mjs 中，将下面的路由添加到 server.proxy。如果已有 server.proxy，只追加该路由；修改后重启 Vite。

export default defineConfig({
  server: {
    proxy: {
      '/modelcontextprotocol-mcp': {
        target: 'https://modelcontextprotocol.io/mcp',
        changeOrigin: true,
        rewrite: (path) => path.replace(/^\/modelcontextprotocol-mcp/, ''),
      },
    },
  },
})

下一步操作

接入组件

CLI 不会自动挂载 TinyRobotChat，需要在你的主业务组件中手动添加 CLI 创建的 <TinyRobotChat/> 组件代码。比如 src/App.vue 是你的主应用

vue

<!-- src/App.vue -->
<script setup lang="ts">
import HelloWorld from './components/HelloWorld.vue'
import TinyRobotChat from './tiny-robot-chat/TinyRobotChat.vue'
</script>

<template>
  <HelloWorld />
  <TinyRobotChat />
</template>

生成的 TinyRobotChat.vue 会自动导入 TinyRobot 和 Chat 样式，无需在 src/main.ts 或 src/main.js 中重复导入。

配置 API_KEY

复制 .env.example 为 .env.local，根据使用的模型配置 VITE_ALIYUN_DASHSCOPE_KEY 或 VITE_DEEPSEEK_API_KEY；自定义模型代理可配置 VITE_QWEN_API_URL 或 VITE_DEEPSEEK_API_URL，自定义 MCP 地址使用 VITE_AMAP_MCP_URL。VITE_* 变量会被写入浏览器产物，仅限开发使用，禁止配置生产密钥；生产环境应通过服务端代理保护 Provider 凭证。比如

shell

# .env.local
VITE_DEEPSEEK_API_KEY=your_api_key

更新依赖

如果依赖更新了，不要忘记安装

pnpmyarnnpm

bash

pnpm install

bash

yarn install

bash

npm install

现在你可以启动你的应用体验 AI 聊天应用了

Workspace 支持

CLI 支持 pnpm workspace。

当检测到多 package workspace 时：

自动识别 workspace 根目录
自动识别 package 列表
支持交互式选择目标 package

如果 pnpm-workspace.yaml 没有 packages 字段，CLI 会按 pnpm 默认规则递归发现 workspace 包；如果当前命令从 workspace 根目录执行且存在多个包，--yes 或 --dry-run 会要求改为从目标 package 目录执行。packages: [] 不会回退到 workspace 根目录。

CLI 接入 ​

安装方式 ​

create ​

运行时版本 ​

add ​

配置 Model Context MCP 代理 ​

下一步操作 ​

Workspace 支持 ​

CLI 接入

安装方式

create

运行时版本

add

配置 Model Context MCP 代理

下一步操作

Workspace 支持