@opentiny/tiny-robot-cli 0.5.0 → 0.5.2-alpha.12

package/README.md

@@ -7,6 +7,7 @@ A lightweight CLI for scaffolding TinyRobot-based product projects.
 ```bash
 npx @opentiny/tiny-robot-cli create my-app
 pnpm dlx @opentiny/tiny-robot-cli create my-app
+npx @opentiny/tiny-robot-cli add chat
 ```
 
 ## Options
@@ -14,6 +15,15 @@ pnpm dlx @opentiny/tiny-robot-cli create my-app
 - `-t, --template <name>`: template name, currently supports `basic`
 - `-h, --help`: show help
 
+`add chat` adds a self-contained floating Chat component, including its runtime, UI configuration, composables, component-scoped styles, and supporting components. It updates these OpenTiny dependencies to `0.5.2-alpha.10`:
+
+- `@opentiny/tiny-robot`
+- `@opentiny/tiny-robot-chat`
+- `@opentiny/tiny-robot-kit`
+- `@opentiny/tiny-robot-svgs`
+
+It also adds `@vueuse/core@13.9.0`. The command does not modify the application entry file or create `src/index.css`. Configure a private environment file from the generated `.env.example` before starting the project; the generated example only includes the Qwen and DeepSeek API key variables. Their API URL variables remain optional overrides for proxies, private gateways, or other regions. The CLI never creates or modifies `.env`.
+
 ## Template Documentation
 
 Template-specific features and environment variables are documented in each template directory, for example:

package/bin/commands/add.js

@@ -1,4 +1,4 @@
-import { checkbox, select } from '@inquirer/prompts'
+import { confirm, select } from '@inquirer/prompts'
 import { Argument } from 'commander'
 import fs from 'node:fs'
 import path from 'node:path'
@@ -7,6 +7,7 @@ import semver from 'semver'
 
 import {
   copyFile,
+  copyDirectory,
   findProjectRoot,
   findSubPackageRoot,
   findWorkspacePackages,
@@ -19,16 +20,14 @@ import {
   mergeEnvFile,
 } from '../utils.js'
 
-const DEP_NAME = '@opentiny/tiny-robot'
-const TARGET_VERSION = '0.5.1-alpha.2'
-const STYLE_IMPORT = "import '@opentiny/tiny-robot/dist/style.css'"
-
-function logUnavailable(label) {
-  logSkip(`${label} could not be applied`)
-}
-
-function logSkippedSelection(label) {
-  logSkip(`${label} change was not selected`)
+const TARGET_VERSION = '0.5.2-alpha.10'
+const VUEUSE_VERSION = '13.9.0'
+const DEPENDENCIES = {
+  '@opentiny/tiny-robot': TARGET_VERSION,
+  '@opentiny/tiny-robot-chat': TARGET_VERSION,
+  '@opentiny/tiny-robot-kit': TARGET_VERSION,
+  '@opentiny/tiny-robot-svgs': TARGET_VERSION,
+  '@vueuse/core': VUEUSE_VERSION,
 }
 
 async function resolveTargetPackage(cwd) {
@@ -42,7 +41,6 @@ async function resolveTargetPackage(cwd) {
     }
 
     const workspacePatterns = findWorkspacePackages(workspaceRoot)
-
     const packageDirs = listPackages(workspaceRoot, workspacePatterns)
 
     invariant(packageDirs.length > 0, 'no packages found in workspace.')
@@ -63,7 +61,6 @@ async function resolveTargetPackage(cwd) {
   }
 
   console.error('Error: no package.json found.')
-
   process.exit(1)
 }
 
@@ -79,58 +76,8 @@ function writePackageJson(pkgPath, pkg) {
   fs.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`)
 }
 
-function findMainEntry(targetDir) {
-  for (const file of ['src/main.ts', 'src/main.js']) {
-    const fullPath = path.join(targetDir, file)
-
-    if (fs.existsSync(fullPath)) {
-      return fullPath
-    }
-  }
-
-  return null
-}
-
-function ensureStyleImport(mainFile) {
-  const content = fs.readFileSync(mainFile, 'utf-8')
-
-  if (content.includes(STYLE_IMPORT)) {
-    return {
-      type: 'skipped',
-    }
-  }
-
-  const lines = content.split('\n')
-
-  let lastImportIndex = -1
-
-  for (let i = 0; i < lines.length; i++) {
-    if (/^\s*import\s/.test(lines[i])) {
-      lastImportIndex = i
-      continue
-    }
-
-    if (lastImportIndex !== -1) {
-      break
-    }
-  }
-
-  if (lastImportIndex === -1) {
-    lines.unshift(STYLE_IMPORT)
-  } else {
-    lines.splice(lastImportIndex + 1, 0, STYLE_IMPORT)
-  }
-
-  fs.writeFileSync(mainFile, lines.join('\n'))
-
-  return {
-    type: 'inserted',
-  }
-}
-
 function insertDependencyOrdered(dependencies, name, version) {
   const next = {}
-
   let inserted = false
 
   for (const [key, value] of Object.entries(dependencies)) {
@@ -154,7 +101,6 @@ function ensureDependency(pkg, name, targetVersion) {
 
   const currentVersion = pkg.dependencies[name]
 
-  // 1. 不存在 => 新增（使用 ordered insert）
   if (!currentVersion) {
     pkg.dependencies = insertDependencyOrdered(pkg.dependencies, name, targetVersion)
 
@@ -164,33 +110,26 @@ function ensureDependency(pkg, name, targetVersion) {
     }
   }
 
-  // 2. 已存在 => 只更新版本，不调整顺序
-  const current = semver.valid(currentVersion)
-
-  if (current !== targetVersion) {
-    pkg.dependencies[name] = targetVersion
-
+  if (
+    currentVersion.startsWith('workspace:') ||
+    semver.satisfies(targetVersion, currentVersion, { includePrerelease: true })
+  ) {
     return {
-      type: 'updated',
-      from: currentVersion,
-      to: targetVersion,
+      type: 'skipped',
     }
   }
 
-  // 3. 完全一致 => 跳过
   return {
-    type: 'skipped',
+    type: 'conflict',
+    from: currentVersion,
+    to: targetVersion,
   }
 }
 
 function printDependencyResult(result, name) {
   switch (result.type) {
     case 'added':
-      logSuccess(`Added ${name}@${TARGET_VERSION}`)
-      break
-
-    case 'updated':
-      logSuccess(`Updated ${name} from ${result.from} to ${result.to}`)
+      logSuccess(`Added ${name}@${result.to}`)
       break
 
     case 'skipped':
@@ -199,208 +138,162 @@ function printDependencyResult(result, name) {
   }
 }
 
-function getChatFeatureFiles(targetDir) {
-  const mainEntry = findMainEntry(targetDir)
+function getGeneratedFiles(targetDir) {
+  const templateSource = getTemplateFile('src')
+  const supportTarget = path.join(targetDir, 'src/tiny-robot-chat')
 
   return [
     {
       label: 'TinyRobotChat.vue',
+      source: path.join(templateSource, 'TinyRobotChat.vue'),
       target: path.join(targetDir, 'src/TinyRobotChat.vue'),
-      template: getTemplateFile('src', 'TinyRobotChat.vue'),
-      action(fileExists) {
-        return fileExists ? 'overwrite' : 'create'
-      },
+      type: 'file',
     },
     {
-      label: 'main entry style import',
-      target: mainEntry,
-      action() {
-        return 'modify'
-      },
+      label: 'Chat UI components',
+      source: path.join(templateSource, 'tiny-robot-chat/components'),
+      target: path.join(supportTarget, 'components'),
+      type: 'directory',
     },
     {
-      label: '.env',
-      target: path.join(targetDir, '.env'),
-      template: getTemplateFile('.env.example'),
-      action(fileExists) {
-        return fileExists ? 'modify' : 'create'
-      },
+      label: 'Chat composables',
+      source: path.join(templateSource, 'tiny-robot-chat/composables'),
+      target: path.join(supportTarget, 'composables'),
+      type: 'directory',
     },
-
     {
-      label: 'package.json',
-      target: path.join(targetDir, 'package.json'),
-      action() {
-        return 'modify'
-      },
+      label: 'Chat configuration',
+      source: path.join(templateSource, 'tiny-robot-chat/config'),
+      target: path.join(supportTarget, 'config'),
+      type: 'directory',
     },
   ]
 }
 
-async function selectFileChanges(files) {
-  return checkbox({
-    message: 'Select which file changes to apply (all selected by default):',
-    choices: files.map((file) => {
-      const exists = file.target ? fs.existsSync(file.target) : false
-
-      const disabled = !file.target
-
-      const descriptions = {
-        'TinyRobotChat.vue': 'integrate TinyRobot chat component',
-        'main entry style import': 'import TinyRobot styles',
-        '.env': 'add environment variables',
-        'package.json': 'add TinyRobot dependencies',
-      }
-
-      const description = descriptions[file.label]
+function findCopyConflicts(source, target) {
+  if (!fs.existsSync(target)) {
+    return []
+  }
 
-      return {
-        name: disabled
-          ? `${file.action(false)} ${file.label} — ${description} (main.ts/js not found)`
-          : `${file.action(exists)} ${file.label} — ${description}`,
+  const sourceStat = fs.statSync(source)
+  const targetStat = fs.statSync(target)
 
-        value: file.label,
+  if (!sourceStat.isDirectory()) {
+    return [target]
+  }
 
-        checked: !disabled,
+  if (!targetStat.isDirectory()) {
+    return [target]
+  }
 
-        disabled,
-      }
-    }),
+  return fs.readdirSync(source, { withFileTypes: true }).flatMap((entry) => {
+    return findCopyConflicts(path.join(source, entry.name), path.join(target, entry.name))
   })
 }
 
-function isSelected(selectedFiles, label) {
-  return selectedFiles.includes(label)
-}
+export function applyChatFeature(targetDir) {
+  const pkgPath = path.join(targetDir, 'package.json')
 
-async function addFeature(targetDir, type) {
-  invariant(type === 'chat', `unsupported feature: ${type}`)
+  invariant(fs.existsSync(pkgPath), 'package.json not found.')
 
-  const files = getChatFeatureFiles(targetDir)
+  const generatedFiles = getGeneratedFiles(targetDir)
+  const conflicts = generatedFiles.flatMap((file) => findCopyConflicts(file.source, file.target))
 
-  const selectedFiles = await selectFileChanges(files)
+  if (conflicts.length > 0) {
+    const conflictPaths = conflicts.map((file) => path.relative(targetDir, file)).join(', ')
 
-  if (selectedFiles.length === 0) {
-    logSkip('No changes selected.')
-    return
+    throw new Error(`Chat feature files already exist: ${conflictPaths}`)
   }
 
-  const componentFile = files.find((f) => {
-    return f.label === 'TinyRobotChat.vue'
-  })
-
-  const envFile = files.find((f) => {
-    return f.label === '.env'
-  })
-
-  invariant(componentFile, 'TinyRobotChat.vue config missing.')
-
-  invariant(envFile, '.env config missing.')
-
-  console.log('\nChange Results\n')
-
-  let needsManualStyleImport = false
-  let envChanged = false
-  let dependencyChanged = false
+  const pkg = readPackageJson(pkgPath)
+  const dependencyResults = []
 
-  if (isSelected(selectedFiles, 'TinyRobotChat.vue')) {
-    copyFile(componentFile.template, componentFile.target)
-    logSuccess(`Copied ${componentFile.label}`)
-  } else {
-    logSkippedSelection(componentFile.label)
+  for (const [name, version] of Object.entries(DEPENDENCIES)) {
+    dependencyResults.push({ name, result: ensureDependency(pkg, name, version) })
   }
 
-  const mainFile = files.find((f) => {
-    return f.label === 'main entry style import'
-  })
-
-  if (!mainFile?.target) {
-    needsManualStyleImport = true
+  const dependencyConflicts = dependencyResults.filter(({ result }) => result.type === 'conflict')
 
-    logUnavailable('main entry style import (main.ts/js not found)')
-  } else {
-    if (isSelected(selectedFiles, mainFile.label)) {
-      const result = ensureStyleImport(mainFile.target)
+  if (dependencyConflicts.length > 0) {
+    const conflictDetails = dependencyConflicts
+      .map(({ name, result }) => `${name}: found ${result.from}, required ${result.to}`)
+      .join('; ')
 
-      switch (result.type) {
-        case 'inserted':
-          logSuccess('Inserted TinyRobot style import')
-          break
+    throw new Error(`Dependency version conflict: ${conflictDetails}`)
+  }
 
-        case 'skipped':
-          logSkip('TinyRobot style import already exists')
-          break
-      }
+  for (const file of generatedFiles) {
+    if (file.type === 'file') {
+      copyFile(file.source, file.target)
     } else {
-      needsManualStyleImport = true
-
-      logSkippedSelection(mainFile.label)
+      copyDirectory(file.source, file.target)
     }
   }
 
-  if (isSelected(selectedFiles, '.env')) {
-    const envResult = mergeEnvFile(envFile.template, envFile.target)
+  const envResult = mergeEnvFile(getTemplateFile('.env.example'), path.join(targetDir, '.env.example'))
 
-    switch (envResult.type) {
-      case 'created':
-        envChanged = true
+  if (dependencyResults.some(({ result }) => result.type !== 'skipped')) {
+    writePackageJson(pkgPath, pkg)
+  }
 
-        logSuccess('Created .env')
-        break
+  return {
+    generatedFiles,
+    envResult,
+    dependencyResults,
+  }
+}
 
-      case 'merged':
-        envChanged = true
+async function addFeature(targetDir, type) {
+  invariant(type === 'chat', `unsupported feature: ${type}`)
 
-        logSuccess(`Added ${envResult.added} env variables`)
-        break
+  const shouldApply = await confirm({
+    message: `Add the complete TinyRobot chat feature to ${targetDir}?`,
+    default: true,
+  })
 
-      case 'skipped':
-        logSkip('.env already contains required variables')
-        break
-    }
-  } else {
-    logSkippedSelection('.env')
+  if (!shouldApply) {
+    logSkip('No changes applied.')
+    return
   }
 
-  const pkgPath = path.join(targetDir, 'package.json')
+  const result = applyChatFeature(targetDir)
 
-  invariant(fs.existsSync(pkgPath), 'package.json not found.')
+  console.log('\nChange Results\n')
 
-  const pkg = readPackageJson(pkgPath)
+  for (const file of result.generatedFiles) {
+    logSuccess(`Copied ${file.label}`)
+  }
 
-  if (isSelected(selectedFiles, 'package.json')) {
-    const result = ensureDependency(pkg, DEP_NAME, TARGET_VERSION)
+  switch (result.envResult.type) {
+    case 'created':
+      logSuccess('Created .env.example')
+      break
 
-    if (result.type !== 'skipped') {
-      dependencyChanged = true
-    }
+    case 'merged':
+      logSuccess(`Added ${result.envResult.added} variables to .env.example`)
+      break
 
-    writePackageJson(pkgPath, pkg)
+    case 'skipped':
+      logSkip('.env.example already contains required variables')
+      break
+  }
 
-    printDependencyResult(result, DEP_NAME)
-  } else {
-    logSkippedSelection('package.json')
+  for (const { name, result: dependencyResult } of result.dependencyResults) {
+    printDependencyResult(dependencyResult, name)
   }
 
   console.log(`\nSuccessfully added "${type}" feature to ${targetDir}`)
 
   printNextSteps({
-    needsManualStyleImport,
-    envChanged,
-    dependencyChanged,
+    envChanged: result.envResult.type !== 'skipped',
+    dependencyChanged: result.dependencyResults.some(({ result: dependencyResult }) => {
+      return dependencyResult.type !== 'skipped'
+    }),
   })
 }
 
-function printNextSteps({ needsManualStyleImport, envChanged, dependencyChanged }) {
-  const steps = []
-
-  if (needsManualStyleImport) {
-    steps.push(
-      ['Import TinyRobot styles in your application entry file.', '', 'Example:', '', `  ${STYLE_IMPORT}`].join('\n'),
-    )
-  }
-
-  steps.push(
+function printNextSteps({ envChanged, dependencyChanged }) {
+  const steps = [
     [
       'Render <TinyRobotChat /> near your main application component.',
       '',
@@ -415,12 +308,12 @@ function printNextSteps({ needsManualStyleImport, envChanged, dependencyChanged
       '    <TinyRobotChat />',
       '  </template>',
     ].join('\n'),
-  )
+  ]
 
   if (envChanged) {
     steps.push(
       [
-        'Configure your AI provider API key in the .env file.',
+        'Copy the required variables from .env.example to your private environment file and configure a provider key.',
         '',
         'Example:',
         '',
@@ -433,10 +326,6 @@ function printNextSteps({ needsManualStyleImport, envChanged, dependencyChanged
     steps.push(['Install or update project dependencies.', '', 'Example:', '', '  pnpm install'].join('\n'))
   }
 
-  if (steps.length === 0) {
-    return
-  }
-
   console.log('\nNext Steps\n')
 
   for (const [index, step] of steps.entries()) {

package/bin/utils.js

@@ -88,6 +88,10 @@ export function validateProjectName(name) {
 }
 
 export function copyTemplate(sourceDir, targetDir) {
+  copyDirectory(sourceDir, targetDir)
+}
+
+export function copyDirectory(sourceDir, targetDir) {
   fs.cpSync(sourceDir, targetDir, {
     recursive: true,
     filter: (source) => {

package/package.json

@@ -1,7 +1,14 @@
 {
   "name": "@opentiny/tiny-robot-cli",
-  "version": "0.5.0",
+  "version": "0.5.2-alpha.12",
   "description": "CLI to scaffold TinyRobot product projects",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/opentiny/tiny-robot.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "type": "module",
   "bin": {
     "tiny-robot-cli": "./bin/cli.js"
@@ -12,7 +19,8 @@
     "README.md"
   ],
   "scripts": {
-    "start": "node ./bin/cli.js"
+    "start": "node ./bin/cli.js",
+    "test": "node --test ./test/*.test.js"
   },
   "license": "MIT",
   "engines": {
@@ -25,5 +33,5 @@
     "semver": "^7.8.1",
     "yaml": "^2.9.0"
   },
-  "gitHead": "47f98d6b156e80289b8b7b5b213b9575dd230210"
+  "gitHead": "dc033027731d2d5b863529cc65b5314a1daa33ff"
 }

package/templates/chat/.env.example

@@ -1 +1,2 @@
+VITE_ALIYUN_DASHSCOPE_KEY=
 VITE_DEEPSEEK_API_KEY=

package/templates/chat/README.md

@@ -0,0 +1,38 @@
+# chat-add
+
+`chat-add` 是一个可嵌入现有 Vue 应用的 Chat 扩展模板，提供通用工作助手场景的最小工程结构。
+
+## 启动
+
+```powershell
+pnpm --filter chat-add dev
+```
+
+## 构建
+
+```powershell
+pnpm --filter chat-add type-check
+pnpm --filter chat-add build
+```
+
+## 接入真实模型
+
+将生成的 `.env.example` 复制为 `.env.local`，按需配置 `VITE_ALIYUN_DASHSCOPE_KEY` 和 `VITE_DEEPSEEK_API_KEY`，重启 Vite 后即可使用模型选择器中的真实模型。
+
+Qwen 和 DeepSeek 默认使用 `@opentiny/tiny-robot-chat` 内置的官方接口地址。仅在使用代理、私有网关或其他地域接口时，才需要在 `.env.local` 中额外配置 `VITE_QWEN_API_URL` 或 `VITE_DEEPSEEK_API_URL`。配置读取逻辑位于 `src/tiny-robot-chat/config/chat-runtime.ts`。
+
+## 目录职责
+
+- `src/TinyRobotChat.vue`: 悬浮入口、Chat 主体以及组件作用域样式。
+- `src/tiny-robot-chat/config/chat-ui.ts`: Chat UI、提示词和模板配置。
+- `src/tiny-robot-chat/config/chat-runtime.ts`: 模型配置和留给后续集成的空 MCP Server 列表。
+- `src/tiny-robot-chat/components`: 窗口头部和输入区工具。
+- `src/tiny-robot-chat/composables/useWindow.ts`: floating、fullscreen 窗口状态。
+
+## 替换数据
+
+直接修改 `src/tiny-robot-chat/config/chat-ui.ts` 和 `src/tiny-robot-chat/config/chat-runtime.ts` 中导出的数据；组件通过 props 使用这些配置。
+
+## 切换窗口模式
+
+默认显示 AI 头像按钮，点击后展开 Chat。窗口头部提供 floating、fullscreen 两种模式。floating 支持拖拽、缩放和位置恢复；fullscreen 铺满对应区域，可使用 Escape 返回悬浮窗口。点击关闭后返回 AI 头像按钮。

package/templates/chat/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Chat Add Template</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/templates/chat/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "__PROJECT_NAME__",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vue-tsc -b && vite build",
+    "preview": "vite preview",
+    "type-check": "vue-tsc -b"
+  },
+  "dependencies": {
+    "@opentiny/tiny-robot": "0.5.2-alpha.10",
+    "@opentiny/tiny-robot-chat": "0.5.2-alpha.10",
+    "@opentiny/tiny-robot-kit": "0.5.2-alpha.10",
+    "@opentiny/tiny-robot-svgs": "0.5.2-alpha.10",
+    "@vueuse/core": "13.9.0",
+    "vue": "^3.5.40"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.3",
+    "@vitejs/plugin-vue": "^6.0.8",
+    "@vue/tsconfig": "^0.9.1",
+    "typescript": "~6.0.2",
+    "vite": "^8.2.0",
+    "vue-tsc": "^3.3.8"
+  }
+}