@opentiny/tiny-robot-cli 0.5.2-alpha.11 → 0.5.2-alpha.13

package/README.md

@@ -15,14 +15,14 @@ npx @opentiny/tiny-robot-cli add chat
 - `-t, --template <name>`: template name, currently supports `basic`
 - `-h, --help`: show help
 
-`add chat` copies the complete Chat example from the `chat-add` template, including its runtime, UI configuration, composables, components, and styles. It updates these dependencies to `0.5.2-alpha.10`:
+`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`
 
-Configure the generated `.env` file with the provider API URL and API key before starting the project.
+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
 

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'
@@ -21,26 +21,16 @@ import {
 } from '../utils.js'
 
 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,
 }
-const STYLE_IMPORTS = [
-  "import '@opentiny/tiny-robot/dist/style.css'",
-  "import '@opentiny/tiny-robot-chat/dist/style.css'",
-]
 
-function logUnavailable(label) {
-  logSkip(`${label} could not be applied`)
-}
-
-function logSkippedSelection(label) {
-  logSkip(`${label} change was not selected`)
-}
-
-async function resolveTargetPackage(cwd) {
+export async function resolveTargetPackage(cwd) {
   const workspaceRoot = findWorkspaceRoot(cwd)
 
   if (workspaceRoot) {
@@ -51,9 +41,12 @@ async function resolveTargetPackage(cwd) {
     }
 
     const workspacePatterns = findWorkspacePackages(workspaceRoot)
-
     const packageDirs = listPackages(workspaceRoot, workspacePatterns)
 
+    if (workspacePatterns.length === 0 && fs.existsSync(path.join(workspaceRoot, 'package.json'))) {
+      return workspaceRoot
+    }
+
     invariant(packageDirs.length > 0, 'no packages found in workspace.')
 
     return select({
@@ -72,7 +65,6 @@ async function resolveTargetPackage(cwd) {
   }
 
   console.error('Error: no package.json found.')
-
   process.exit(1)
 }
 
@@ -88,62 +80,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')
-  const lines = content.split('\n')
-  let inserted = false
-
-  for (const styleImport of STYLE_IMPORTS) {
-    if (lines.some((line) => line.trim() === styleImport)) {
-      continue
-    }
-
-    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(styleImport)
-    } else {
-      lines.splice(lastImportIndex + 1, 0, styleImport)
-    }
-
-    inserted = true
-  }
-
-  if (inserted) {
-    fs.writeFileSync(mainFile, lines.join('\n'))
-  }
-
-  return {
-    type: inserted ? 'inserted' : 'skipped',
-  }
-}
-
 function insertDependencyOrdered(dependencies, name, version) {
   const next = {}
-
   let inserted = false
 
   for (const [key, value] of Object.entries(dependencies)) {
@@ -167,7 +105,6 @@ function ensureDependency(pkg, name, targetVersion) {
 
   const currentVersion = pkg.dependencies[name]
 
-  // 1. 不存在 => 新增（使用 ordered insert）
   if (!currentVersion) {
     pkg.dependencies = insertDependencyOrdered(pkg.dependencies, name, targetVersion)
 
@@ -177,22 +114,19 @@ 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,
   }
 }
 
@@ -202,278 +136,168 @@ function printDependencyResult(result, name) {
       logSuccess(`Added ${name}@${result.to}`)
       break
 
-    case 'updated':
-      logSuccess(`Updated ${name} from ${result.from} to ${result.to}`)
-      break
-
     case 'skipped':
       logSkip(`${name} already satisfies required version`)
       break
   }
 }
 
-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'
-      },
-    },
-    {
-      label: 'main entry style imports',
-      target: mainEntry,
-      action() {
-        return 'modify'
-      },
+      type: 'file',
     },
     {
       label: 'Chat UI components',
-      target: path.join(targetDir, 'src/components'),
-      template: path.join(templateSource, 'components'),
-      action() {
-        return 'merge'
-      },
+      source: path.join(templateSource, 'tiny-robot-chat/components'),
+      target: path.join(supportTarget, 'components'),
+      type: 'directory',
     },
     {
       label: 'Chat composables',
-      target: path.join(targetDir, 'src/composables'),
-      template: path.join(templateSource, 'composables'),
-      action() {
-        return 'merge'
-      },
+      source: path.join(templateSource, 'tiny-robot-chat/composables'),
+      target: path.join(supportTarget, 'composables'),
+      type: 'directory',
     },
     {
       label: 'Chat configuration',
-      target: path.join(targetDir, 'src/config'),
-      template: path.join(templateSource, 'config'),
-      action() {
-        return 'merge'
-      },
-    },
-    {
-      label: 'Chat app styles',
-      target: path.join(targetDir, 'src/index.css'),
-      template: path.join(templateSource, 'index.css'),
-      action(fileExists) {
-        return fileExists ? 'overwrite' : 'create'
-      },
-    },
-    {
-      label: '.env',
-      target: path.join(targetDir, '.env'),
-      template: getTemplateFile('.env.example'),
-      action(fileExists) {
-        return fileExists ? 'modify' : 'create'
-      },
-    },
-
-    {
-      label: 'package.json',
-      target: path.join(targetDir, 'package.json'),
-      action() {
-        return 'modify'
-      },
+      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 imports': 'import TinyRobot styles',
-        'Chat UI components': 'copy Chat UI components',
-        'Chat composables': 'copy Chat composables',
-        'Chat configuration': 'copy Chat runtime and UI configuration',
-        'Chat app styles': 'copy Chat application 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) })
   }
 
-  for (const file of files.filter((item) => item.label.startsWith('Chat '))) {
-    if (!isSelected(selectedFiles, file.label)) {
-      logSkippedSelection(file.label)
-      continue
-    }
+  const dependencyConflicts = dependencyResults.filter(({ result }) => result.type === 'conflict')
 
-    if (file.target.endsWith('.css')) {
-      copyFile(file.template, file.target)
-    } else {
-      copyDirectory(file.template, file.target)
-    }
+  if (dependencyConflicts.length > 0) {
+    const conflictDetails = dependencyConflicts
+      .map(({ name, result }) => `${name}: found ${result.from}, required ${result.to}`)
+      .join('; ')
 
-    logSuccess(`Copied ${file.label}`)
+    throw new Error(`Dependency version conflict: ${conflictDetails}`)
   }
 
-  const mainFile = files.find((f) => {
-    return f.label === 'main entry style imports'
-  })
-
-  if (!mainFile?.target) {
-    needsManualStyleImport = true
-
-    logUnavailable('main entry style imports (main.ts/js not found)')
-  } else {
-    if (isSelected(selectedFiles, mainFile.label)) {
-      const result = ensureStyleImport(mainFile.target)
-
-      switch (result.type) {
-        case 'inserted':
-          logSuccess('Inserted TinyRobot style import')
-          break
-
-        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')) {
-    for (const [name, version] of Object.entries(DEPENDENCIES)) {
-      const result = ensureDependency(pkg, name, 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
 
-      printDependencyResult(result, name)
-    }
+    case 'skipped':
+      logSkip('.env.example already contains required variables')
+      break
+  }
 
-    writePackageJson(pkgPath, pkg)
-  } 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_IMPORTS.map((styleImport) => `  ${styleImport}`),
-      ].join('\n'),
-    )
-  }
-
-  steps.push(
+function printNextSteps({ envChanged, dependencyChanged }) {
+  const steps = [
     [
       'Render <TinyRobotChat /> near your main application component.',
       '',
@@ -488,12 +312,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:',
         '',
@@ -506,10 +330,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

@@ -196,8 +196,12 @@ export function findWorkspacePackages(workspaceRoot) {
           (pattern) => typeof pattern === 'string' && pattern.length > 0 && !pattern.startsWith('!'),
         )
       : []
-  } catch {
-    return []
+  } catch (error) {
+    const reason = error instanceof Error ? error.message : String(error)
+
+    throw new Error(`Invalid pnpm workspace configuration in ${workspaceFile}: ${reason}`, {
+      cause: error,
+    })
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opentiny/tiny-robot-cli",
-  "version": "0.5.2-alpha.11",
+  "version": "0.5.2-alpha.13",
   "description": "CLI to scaffold TinyRobot product projects",
   "repository": {
     "type": "git",
@@ -19,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": {
@@ -32,5 +33,5 @@
     "semver": "^7.8.1",
     "yaml": "^2.9.0"
   },
-  "gitHead": "09317e7ea1f51d2b8b6a97ebb7b2ceee9be4a963"
+  "gitHead": "afeda129637cd33e0771ff9fee90a268a1ff55d5"
 }

package/templates/chat/.env.example

@@ -1,5 +1,2 @@
-VITE_DEEPSEEK_API_KEY=
-VITE_DEEPSEEK_API_URL=
-VITE_QWEN_API_URL=
 VITE_ALIYUN_DASHSCOPE_KEY=
-VITE_AMAP_MCP_URL=
+VITE_DEEPSEEK_API_KEY=

package/templates/chat/README.md

@@ -1,6 +1,6 @@
 # chat-add
 
-`chat-add` 是一个独立的 Chat 扩展模板，提供通用工作助手场景的最小工程结构。
+`chat-add` 是一个可嵌入现有 Vue 应用的 Chat 扩展模板，提供通用工作助手场景的最小工程结构。
 
 ## 启动
 
@@ -17,19 +17,21 @@ pnpm --filter chat-add build
 
 ## 接入真实模型
 
-在 `packages/chat-add/.env.local` 中配置 `VITE_QWEN_API_URL`、`VITE_ALIYUN_DASHSCOPE_KEY`、`VITE_DEEPSEEK_API_URL` 和 `VITE_DEEPSEEK_API_KEY`，重启 Vite 后即可使用模型选择器中的真实模型。配置读取逻辑位于 `src/config/chat-runtime.ts`。
+将生成的 `.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/config/chat-ui.ts`: Chat UI、提示词、模板和菜单配置。
-- `src/config/chat-runtime.ts`: MCP 示例和模型配置。
-- `src/components`: 窗口头部和输入区工具。
-- `src/composables/useWindow.ts`: floating、fullscreen 窗口状态。
-- `src/index.css`: 模板公共样式和 Surface 样式变量。
+- `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/config/chat-ui.ts` 和 `src/config/chat-runtime.ts` 中导出的数据；组件通过 props 使用这些配置。
+直接修改 `src/tiny-robot-chat/config/chat-ui.ts` 和 `src/tiny-robot-chat/config/chat-runtime.ts` 中导出的数据；组件通过 props 使用这些配置。
 
 ## 切换窗口模式
 

package/templates/chat/package.json

@@ -14,7 +14,7 @@
     "@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.1.0",
+    "@vueuse/core": "13.9.0",
     "vue": "^3.5.40"
   },
   "devDependencies": {