@opentiny/tiny-robot-cli 1.0.0-beta.1 → 1.0.0-rc.0

package/README.md

@@ -12,20 +12,20 @@ npx @opentiny/tiny-robot-cli add chat --yes
 
 ## Options
 
-- `-t, --template <name>`: template name; `basic` generates the Chat Basic project
-- `--runtime-version <version>`: override the TinyRobot runtime version for local CLI development or diagnosis
+- `-t, --template <name>`: template name; `basic` generates the Chat Basic project and `chat` generates the standalone Chat project
+- `--runtime-version <version>`: override the TinyRobot runtime version used in the generated or updated project
 - `-h, --help`: show help
 
-`create` is an overall project scaffold. The `basic` template is aligned with `packages/chat-basic` and is copied into a new project.
+`create` scaffolds a new project. The `basic` template creates the Chat Basic project, and the `chat` template creates a standalone Chat project.
 
-`add chat` is a local feature injection for an existing Vue project. It creates the isolated `src/tiny-robot-chat/` feature from `packages/cli/templates/chat`, adds the runtime dependencies (including `@vueuse/core@13.9.0`), and imports feature-scoped CSS that does not reset the host document. It does not modify the host project's Vite configuration. Existing files with different contents are reported as conflicts and are never silently overwritten.
+`add chat` creates the isolated `src/tiny-robot-chat/` feature from `packages/cli/templates/chat`, adds the runtime dependencies (including `@vueuse/core@13.9.0`), and merges `.env.example`. Existing files with different contents are reported as conflicts and are never silently overwritten. If a write fails, the CLI attempts to roll back the changes that were already applied and reports any residual paths.
 
-By default, `add chat` mounts `TinyRobotChat` into a standard `src/App.vue` when a safe template and script setup block are available, so the generated project includes the floating AI trigger. Use `--no-mount` to keep `App.vue` unchanged and print the mount snippet. Use `--dry-run` to inspect the plan without changing files and `--yes` to skip prompts:
+`add chat` never modifies `src/main.ts`, `src/main.js`, `src/App.vue`, or `vite.config.*`, and it does not mount the component automatically. Render `TinyRobotChat` in the host application and add the MCP proxy manually; the generated component imports its required styles. Interactive mode shows the plan and asks for confirmation; `--dry-run` previews the plan without changing files and `--yes` applies it without confirmation:
 
 ```bash
 npx @opentiny/tiny-robot-cli add chat --dry-run
 npx @opentiny/tiny-robot-cli add chat --yes
-npx @opentiny/tiny-robot-cli add chat --yes --no-mount
+npx @opentiny/tiny-robot-cli add chat --yes --runtime-version 0.5.2-rc.2
 ```
 
 The feature adds or preserves these dependencies. Compatible versions are kept, and higher versions are not downgraded:
@@ -44,9 +44,9 @@ CLI 0.5.2-beta.3   -> runtime 0.5.2-beta.3
 CLI 0.5.3          -> runtime ^0.5.3
 ```
 
-An existing dependency range is preserved when it accepts the target runtime version; for example, `^0.5.1` is kept for a stable `0.5.3` target. Use `--runtime-version` only when testing an unpublished CLI checkout or diagnosing version resolution. The override follows the same prerelease-exact and stable-caret rules.
+An existing stable dependency range is preserved when it accepts the target runtime version; for example, `^0.5.1` is kept for a stable `0.5.3` target. Prerelease targets always use the exact requested version. The override follows the same prerelease-exact and stable-caret rules.
 
-Copy the generated `.env.example` to `.env.local`, then configure the provider API URL and API key before starting the project. `add chat` does not create or modify `.env`.
+Copy the generated `.env.example` to `.env.local`, then configure the provider API key before starting the project. Optional provider endpoints are configured with `VITE_QWEN_API_URL` and `VITE_DEEPSEEK_API_URL`; the MCP endpoint uses `VITE_AMAP_MCP_URL`. `add chat` does not create or modify `.env`. `VITE_*` values are embedded in the client bundle, so do not use production keys; production deployments must protect provider credentials behind a server-side proxy.
 
 The Model Context MCP example uses `/modelcontextprotocol-mcp`. Add this proxy manually to the existing `vite.config.*` file under `server.proxy`, then restart Vite:
 
@@ -67,3 +67,4 @@ server: {
 Template-specific features and environment variables are documented in each template directory, for example:
 
 - `packages/cli/templates/basic/README.md`
+- `packages/cli/templates/chat/README.md`

package/bin/commands/add.js

@@ -1,5 +1,4 @@
-import { checkbox, select } from '@inquirer/prompts'
-import { compileTemplate, parse } from '@vue/compiler-sfc'
+import { confirm, select } from '@inquirer/prompts'
 import { Argument } from 'commander'
 import fs from 'node:fs'
 import path from 'node:path'
@@ -21,19 +20,6 @@ import {
 } from '../utils.js'
 
 const CHAT_ADD_FEATURE_DIR = 'src/tiny-robot-chat'
-const PACKAGE_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, nonInteractive) {
   const workspaceRoot = findWorkspaceRoot(cwd)
 
@@ -110,54 +96,6 @@ function readPackageJson(pkgPath) {
   return pkg
 }
 
-function findMainEntry(targetDir) {
-  for (const file of ['src/main.ts', 'src/main.js']) {
-    const fullPath = path.join(targetDir, file)
-    if (fs.existsSync(fullPath) && fs.statSync(fullPath).isFile()) return fullPath
-  }
-  return null
-}
-
-function importedModule(line) {
-  const match = /^\s*import(?:\s+[\s\S]*?\sfrom\s+)?\s*['"]([^'"]+)['"]\s*;?\s*$/.exec(line)
-  return match?.[1] ?? null
-}
-
-function insertImport(content, importStatement) {
-  const eol = content.includes('\r\n') ? '\r\n' : '\n'
-  const lines = content.replaceAll('\r\n', '\n').split('\n')
-  const moduleName = importedModule(importStatement)
-  if (moduleName && lines.some((line) => importedModule(line) === moduleName)) return content
-
-  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(importStatement)
-  else lines.splice(lastImportIndex + 1, 0, importStatement)
-  return lines.join(eol)
-}
-
-function ensureStyleImportsContent(before, featureStyleImport) {
-  let after = before
-  for (const styleImport of [...PACKAGE_STYLE_IMPORTS, featureStyleImport]) {
-    after = insertImport(after, styleImport)
-  }
-  return { type: after === before ? 'skipped' : 'inserted', content: after }
-}
-
-function ensureStyleImports(mainFile, featureStyleImport) {
-  const before = fs.readFileSync(mainFile, 'utf-8')
-  const result = ensureStyleImportsContent(before, featureStyleImport)
-  if (result.type === 'inserted') fs.writeFileSync(mainFile, result.content)
-  return { type: result.type }
-}
-
 function findDependency(pkg, name) {
   const matches = []
   for (const section of ['dependencies', 'devDependencies', 'optionalDependencies', 'peerDependencies']) {
@@ -232,6 +170,26 @@ function ensureDependency(pkg, name, targetSpecifier) {
     }
   }
 
+  if (semver.prerelease(targetVersion) !== null) {
+    if (dependency.version === targetSpecifier)
+      return { type: 'skipped', section: dependency.section, version: dependency.version }
+
+    if (dependency.section !== 'dependencies') {
+      return {
+        type: 'conflict',
+        reason: `${name}@${dependency.version} in ${dependency.section} does not satisfy ${targetSpecifier}`,
+      }
+    }
+
+    pkg.dependencies[name] = targetSpecifier
+    return {
+      type: 'updated',
+      section: dependency.section,
+      from: dependency.version,
+      to: targetSpecifier,
+    }
+  }
+
   const satisfies = semver.satisfies(targetVersion, dependency.version)
 
   if (satisfies) return { type: 'skipped', section: dependency.section, version: dependency.version }
@@ -293,83 +251,6 @@ function getChatFeatureFiles(targetDir) {
   return featureFiles
 }
 
-function parseMountTemplate(source, filename) {
-  const parsed = parse(source, { filename })
-  if (parsed.errors.length > 0 || !parsed.descriptor.template) {
-    return { type: 'manual', reason: 'App.vue template could not be parsed safely' }
-  }
-
-  const compiled = compileTemplate({
-    source: parsed.descriptor.template.content,
-    filename,
-    id: 'tiny-robot-cli-mount',
-  })
-  if (compiled.errors.length > 0 || !compiled.ast) {
-    return { type: 'manual', reason: 'App.vue template could not be parsed safely' }
-  }
-
-  return { type: 'parsed', block: parsed.descriptor.template, components: compiled.ast.components ?? [] }
-}
-
-function findTemplateClose(block) {
-  return block.loc.end.offset
-}
-
-function planMount(targetDir) {
-  const appFile = path.join(targetDir, 'src/App.vue')
-  if (!fs.existsSync(appFile)) return { type: 'manual', reason: 'src/App.vue was not found' }
-  if (!fs.statSync(appFile).isFile()) return { type: 'manual', reason: 'src/App.vue is not a file' }
-  const before = fs.readFileSync(appFile, 'utf-8')
-
-  const templatePlan = parseMountTemplate(before, appFile)
-  if (templatePlan.type === 'manual') return templatePlan
-  if (templatePlan.components.includes('TinyRobotChat')) return { type: 'skipped', content: before }
-
-  const importStatement = "import TinyRobotChat from './tiny-robot-chat/TinyRobotChat.vue'"
-  let after = before
-  const setupMatch = /<script\s+setup(?:\s[^>]*)?>([\s\S]*?)<\/script>/i.exec(before)
-  if (setupMatch) {
-    const setupContent = setupMatch[1]
-    const defaultImport = /^\s*import\s+TinyRobotChat\s+from\s+['"]([^'"]+)['"]\s*;?\s*$/m.exec(setupContent)
-    const featureImport =
-      /^\s*import\s+([A-Za-z_$][\w$]*)\s+from\s+['"]\.\/tiny-robot-chat\/TinyRobotChat\.vue['"]\s*;?\s*$/m.exec(
-        setupContent,
-      )
-    const namedImport = /^\s*import\s*\{[^}]*\bTinyRobotChat\b[^}]*\}\s*from\s+['"][^'"]+['"]\s*;?\s*$/m.test(
-      setupContent,
-    )
-    const localBinding = /^\s*(?:const|let|var|function|class)\s+TinyRobotChat\b/m.test(setupContent)
-
-    if (
-      namedImport ||
-      localBinding ||
-      (defaultImport && defaultImport[1] !== './tiny-robot-chat/TinyRobotChat.vue') ||
-      (featureImport && featureImport[1] !== 'TinyRobotChat')
-    ) {
-      return { type: 'manual', reason: 'App.vue already declares TinyRobotChat with a different binding' }
-    }
-
-    if (!defaultImport) {
-      const insertionIndex = setupMatch.index + setupMatch[0].indexOf('>') + 1
-      after = `${before.slice(0, insertionIndex)}\n${importStatement}${before.slice(insertionIndex)}`
-    }
-  } else if (/<script(?:\s[^>]*)?>/.test(before)) {
-    return { type: 'manual', reason: 'App.vue has a non-setup script block' }
-  } else {
-    after = `<script setup lang="ts">\n${importStatement}\n</script>\n\n${before}`
-  }
-
-  const updatedTemplate = parseMountTemplate(after, appFile)
-  if (updatedTemplate.type === 'manual') return updatedTemplate
-  const templateClose = findTemplateClose(updatedTemplate.block)
-  if (templateClose === -1) return { type: 'manual', reason: 'App.vue template closing tag was not found' }
-  const beforeClose = after.slice(0, templateClose).trimEnd()
-  const lineIndent = /^\s*/.exec(beforeClose.slice(beforeClose.lastIndexOf('\n') + 1))?.[0] ?? ''
-  const indent = lineIndent || '  '
-  after = `${beforeClose}\n${indent}<TinyRobotChat />\n${after.slice(templateClose)}`
-  return { type: 'merge', content: after }
-}
-
 function inspectFeatureFiles(files) {
   return files.map((file) => {
     if (!fs.existsSync(file.target)) return { ...file, type: 'create' }
@@ -383,45 +264,6 @@ function formatRelative(file, targetDir) {
   return path.relative(targetDir, file).replaceAll('\\', '/')
 }
 
-function getChatFeatureChoices(targetDir, options) {
-  const mainEntry = findMainEntry(targetDir)
-  return [
-    { label: 'Chat feature files', enabled: true },
-    { label: 'main entry style imports', enabled: Boolean(mainEntry) },
-    { label: '.env.example', enabled: true },
-    { label: 'package.json', enabled: true },
-    ...(options.mount ? [{ label: 'App.vue mount', enabled: fs.existsSync(path.join(targetDir, 'src/App.vue')) }] : []),
-  ].map((item) => ({ ...item, mainEntry }))
-}
-
-async function selectFileChanges(targetDir, options) {
-  const files = getChatFeatureChoices(targetDir, options)
-  if (options.yes || options.dryRun || options.nonInteractive)
-    return files.filter((file) => file.enabled).map((file) => file.label)
-  return checkbox({
-    message: 'Select which file changes to apply (all selected by default):',
-    choices: files.map((file) => ({
-      name: file.enabled ? file.label : `${file.label} (not available)`,
-      value: file.label,
-      checked: file.enabled,
-      disabled: !file.enabled,
-    })),
-  })
-}
-
-function isSelected(selectedFiles, label) {
-  return selectedFiles.includes(label)
-}
-
-function getDependencyPlan(pkg, dependencies) {
-  const preview = JSON.parse(JSON.stringify(pkg))
-
-  return Object.entries(dependencies).map(([name, version]) => ({
-    name,
-    result: ensureDependency(preview, name, version),
-  }))
-}
-
 function getEnvPlan(targetDir) {
   const templateFile = getTemplateFile('.env.example')
   const targetFile = path.join(targetDir, '.env.example')
@@ -436,7 +278,7 @@ function getEnvPlan(targetDir) {
 
 function formatPlanStatus(type) {
   if (type === 'create') return '+'
-  if (type === 'merge') return '~'
+  if (type === 'merge' || type === 'merged') return '~'
   if (type === 'unavailable' || type === 'conflict') return '!'
   return '○'
 }
@@ -449,24 +291,40 @@ function fileContent(content) {
   return Buffer.isBuffer(content) ? content : Buffer.from(content)
 }
 
-function addFileChange(changes, target, content, message) {
-  if (fs.existsSync(target)) invariant(fs.statSync(target).isFile(), `${target} exists and is not a file.`)
+function readTargetState(target) {
+  if (!fs.existsSync(target)) return { existed: false, content: null }
+  invariant(fs.statSync(target).isFile(), `${target} exists and is not a file.`)
+  return { existed: true, content: fs.readFileSync(target) }
+}
 
+function addFileChange(changes, target, content, message) {
+  const expected = readTargetState(target)
   const next = fileContent(content)
-  if (fs.existsSync(target) && fs.readFileSync(target).equals(next)) return false
+  if (expected.existed && expected.content.equals(next)) return false
 
-  changes.push({ target, content, message })
+  changes.push({ target, content: next, message, expected })
   return true
 }
 
+function assertTargetUnchanged(change) {
+  const current = readTargetState(change.target)
+  if (current.existed !== change.expected.existed) {
+    throw new Error(`planned target changed after planning: ${change.target}`)
+  }
+  if (current.existed && !current.content.equals(change.expected.content)) {
+    throw new Error(`planned target changed after planning: ${change.target}`)
+  }
+}
+
 function applyChanges(changes) {
   const snapshots = changes.map(({ target }) => ({
     target,
-    existed: fs.existsSync(target),
-    content: fs.existsSync(target) ? fs.readFileSync(target) : null,
+    ...readTargetState(target),
   }))
   const createdDirectories = new Set()
 
+  for (const change of changes) assertTargetUnchanged(change)
+
   try {
     for (const change of changes) {
       let directory = path.dirname(change.target)
@@ -480,12 +338,31 @@ function applyChanges(changes) {
       fs.writeFileSync(change.target, change.content)
     }
   } catch (error) {
+    const rollbackErrors = []
     for (const snapshot of snapshots.reverse()) {
-      if (snapshot.existed) fs.writeFileSync(snapshot.target, snapshot.content)
-      else if (fs.existsSync(snapshot.target)) fs.rmSync(snapshot.target, { force: true })
+      try {
+        if (snapshot.existed) fs.writeFileSync(snapshot.target, snapshot.content)
+        else if (fs.existsSync(snapshot.target)) fs.rmSync(snapshot.target, { force: true })
+      } catch (rollbackError) {
+        rollbackErrors.push(
+          `${snapshot.target}: ${rollbackError instanceof Error ? rollbackError.message : String(rollbackError)}`,
+        )
+      }
     }
     for (const directory of [...createdDirectories].sort((left, right) => right.length - left.length)) {
-      if (fs.existsSync(directory) && fs.readdirSync(directory).length === 0) fs.rmdirSync(directory)
+      try {
+        if (fs.existsSync(directory) && fs.readdirSync(directory).length === 0) fs.rmdirSync(directory)
+      } catch (rollbackError) {
+        rollbackErrors.push(
+          `${directory}: ${rollbackError instanceof Error ? rollbackError.message : String(rollbackError)}`,
+        )
+      }
+    }
+
+    if (rollbackErrors.length > 0) {
+      throw new Error(
+        `Failed to apply changes; rollback was incomplete: ${error instanceof Error ? error.message : String(error)}. Residual paths: ${rollbackErrors.join('; ')}`,
+      )
     }
 
     throw new Error(
@@ -494,155 +371,90 @@ function applyChanges(changes) {
   }
 }
 
-function validateSelection(selectedFiles, pkg, featureInspection, mountPlan, allowManualMount, dependencies) {
-  const featureFilesSelected = isSelected(selectedFiles, 'Chat feature files')
-  const featureFilesMissing = featureInspection.some((file) => file.type === 'create')
-
-  if (!featureFilesSelected && featureFilesMissing && isSelected(selectedFiles, 'main entry style imports')) {
-    throw new Error('Select Chat feature files before adding the local feature style import.')
-  }
-
-  if (!featureFilesSelected && featureFilesMissing && isSelected(selectedFiles, 'App.vue mount')) {
-    throw new Error('Select Chat feature files before mounting TinyRobotChat in App.vue.')
-  }
-
-  if (isSelected(selectedFiles, 'App.vue mount') && mountPlan?.type === 'manual' && !allowManualMount) {
-    throw new Error(`cannot safely mount TinyRobotChat: ${mountPlan.reason}`)
-  }
-
-  if (isSelected(selectedFiles, 'package.json')) return
+function prepareChanges(targetDir, context) {
+  const { featureInspection, pkgPath, pkg, allowConflicts, dependencies } = context
+  const changes = []
+  const results = { featureInspection, env: null, dependencies: [], dependencyChanged: false }
+  const conflicts = featureInspection.filter((file) => file.type === 'conflict')
 
-  const dependencyChanges = getDependencyPlan(pkg, dependencies).filter(({ result }) => result.type !== 'skipped')
-  if (dependencyChanges.length > 0 && (featureFilesSelected || isSelected(selectedFiles, 'main entry style imports'))) {
+  if (conflicts.length > 0 && !allowConflicts) {
     throw new Error(
-      'Select package.json when adding the chat feature or its style imports so required dependencies can be checked.',
+      `file conflicts detected:\n${conflicts.map((file) => `  - ${formatRelative(file.target, targetDir)}`).join('\n')}\nResolve the conflicts and run add chat again.`,
     )
   }
-}
 
-function prepareChanges(targetDir, selectedFiles, context) {
-  const { featureInspection, mainFile, mountPlan, pkgPath, pkg, allowConflicts, dependencies } = context
-  const changes = []
-  const results = { featureInspection, style: null, env: null, dependencies: [], mount: null, dependencyChanged: false }
-
-  if (isSelected(selectedFiles, 'Chat feature files')) {
-    const conflicts = featureInspection.filter((file) => file.type === 'conflict')
-    if (conflicts.length > 0 && !allowConflicts) {
-      throw new Error(
-        `file conflicts detected:\n${conflicts.map((file) => `  - ${formatRelative(file.target, targetDir)}`).join('\n')}\nResolve the conflicts and run add chat again.`,
-      )
-    }
-    for (const file of featureInspection) {
-      if (file.type === 'create')
-        addFileChange(
-          changes,
-          file.target,
-          fs.readFileSync(file.source),
-          `Created ${formatRelative(file.target, targetDir)}`,
-        )
-    }
-  }
-
-  if (isSelected(selectedFiles, 'main entry style imports')) {
-    if (!mainFile) results.style = { type: 'unavailable' }
-    else {
-      const styleResult = ensureStyleImportsContent(
-        fs.readFileSync(mainFile, 'utf-8'),
-        "import './tiny-robot-chat/index.css'",
+  for (const file of featureInspection) {
+    if (file.type === 'create')
+      addFileChange(
+        changes,
+        file.target,
+        fs.readFileSync(file.source),
+        `Created ${formatRelative(file.target, targetDir)}`,
       )
-      results.style = styleResult
-      if (styleResult.type === 'inserted')
-        addFileChange(changes, mainFile, styleResult.content, 'Inserted TinyRobot and Chat feature style imports')
-    }
   }
 
-  if (isSelected(selectedFiles, '.env.example')) {
-    results.env = getEnvPlan(targetDir)
-    if (results.env.type === 'create')
-      addFileChange(changes, results.env.targetFile, results.env.content, 'Created .env.example')
-    if (results.env.type === 'merged')
-      addFileChange(changes, results.env.targetFile, results.env.content, `Added ${results.env.added} env variables`)
-  }
+  results.env = getEnvPlan(targetDir)
+  if (results.env.type === 'create')
+    addFileChange(changes, results.env.targetFile, results.env.content, 'Created .env.example')
+  if (results.env.type === 'merged')
+    addFileChange(changes, results.env.targetFile, results.env.content, `Added ${results.env.added} env variables`)
 
-  if (isSelected(selectedFiles, 'package.json')) {
-    for (const [name, version] of Object.entries(dependencies)) {
-      const result = ensureDependency(pkg, name, version)
-      if (result.type === 'conflict' && !allowConflicts) throw new Error(`${name}: ${result.reason}`)
-      results.dependencies.push({ name, result })
-      results.dependencyChanged ||= result.type !== 'skipped'
-    }
-    if (results.dependencyChanged)
-      addFileChange(changes, pkgPath, `${JSON.stringify(pkg, null, 2)}\n`, 'Updated package.json')
+  for (const [name, version] of Object.entries(dependencies)) {
+    const result = ensureDependency(pkg, name, version)
+    if (result.type === 'conflict' && !allowConflicts) throw new Error(`${name}: ${result.reason}`)
+    results.dependencies.push({ name, result })
+    results.dependencyChanged ||= result.type !== 'skipped'
   }
 
-  if (isSelected(selectedFiles, 'App.vue mount')) {
-    results.mount = mountPlan
-    if (mountPlan.type === 'merge')
-      addFileChange(
-        changes,
-        path.join(targetDir, 'src/App.vue'),
-        mountPlan.content,
-        'Mounted TinyRobotChat in src/App.vue',
-      )
-  }
+  if (results.dependencyChanged)
+    addFileChange(changes, pkgPath, `${JSON.stringify(pkg, null, 2)}\n`, 'Updated package.json')
 
   return { changes, results }
 }
 
-function printChangeResults(targetDir, selectedFiles, results) {
-  if (isSelected(selectedFiles, 'Chat feature files')) {
-    for (const file of results.featureInspection) {
-      if (file.type === 'create') logSuccess(`Created ${formatRelative(file.target, targetDir)}`)
-      else if (file.type === 'skipped') logSkip(`${formatRelative(file.target, targetDir)} already exists`)
-    }
-  } else logSkippedSelection('Chat feature files')
-
-  if (isSelected(selectedFiles, 'main entry style imports')) {
-    if (results.style?.type === 'unavailable') logUnavailable('main entry style imports (main.ts/js not found)')
-    else if (results.style?.type === 'inserted') logSuccess('Inserted TinyRobot and Chat feature style imports')
-    else logSkip('TinyRobot and Chat feature style imports already exist')
-  } else logSkippedSelection('main entry style imports')
-
-  if (isSelected(selectedFiles, '.env.example')) {
-    if (results.env?.type === 'unavailable') logUnavailable('.env.example (template .env.example not found)')
-    else if (results.env?.type === 'create') logSuccess('Created .env.example')
-    else if (results.env?.type === 'merged') logSuccess(`Added ${results.env.added} env variables`)
-    else logSkip('.env.example already contains required variables')
-  } else logSkippedSelection('.env.example')
-
-  if (isSelected(selectedFiles, 'package.json')) {
-    for (const { name, result } of results.dependencies) printDependencyResult(result, name)
-    if (!results.dependencyChanged) logSkip('package.json already contains required dependencies')
-  } else logSkippedSelection('package.json')
-
-  if (isSelected(selectedFiles, 'App.vue mount')) {
-    if (results.mount?.type === 'merge') logSuccess('Mounted TinyRobotChat in src/App.vue')
-    else logSkip('App.vue already mounts TinyRobotChat')
+function printChangePlan(targetDir, results) {
+  console.log('\nChange Plan\n')
+  for (const file of results.featureInspection) {
+    console.log(`  ${formatPlanStatus(file.type)} ${formatRelative(file.target, targetDir)}`)
+  }
+  console.log(
+    `  ${formatPlanStatus(results.env?.type ?? 'unavailable')} .env.example (${results.env?.type ?? 'unavailable'})`,
+  )
+  for (const { name, result } of results.dependencies) {
+    const status = result.type === 'added' || result.type === 'updated' ? '~' : result.type === 'conflict' ? '!' : '○'
+    console.log(`  ${status} package.json (${result.type}: ${name})`)
   }
+  console.log('  ○ src/main.ts / src/main.js (unchanged)')
+  console.log('  ○ src/App.vue (unchanged)')
+  console.log('  ○ vite.config.* (unchanged)')
+  printManualMcpSetup()
+}
+
+function printChangeResults(targetDir, results) {
+  for (const file of results.featureInspection) {
+    if (file.type === 'create') logSuccess(`Created ${formatRelative(file.target, targetDir)}`)
+    else if (file.type === 'skipped') logSkip(`${formatRelative(file.target, targetDir)} already exists`)
+  }
+
+  if (results.env?.type === 'create') logSuccess('Created .env.example')
+  else if (results.env?.type === 'merged') logSuccess(`Added ${results.env.added} env variables`)
+  else if (results.env?.type === 'unavailable') logSkip('.env.example template is unavailable; no environment variables were added')
+  else logSkip('.env.example already contains required variables')
+
+  for (const { name, result } of results.dependencies) printDependencyResult(result, name)
+  if (!results.dependencyChanged) logSkip('package.json already contains required dependencies')
 }
 
 async function addFeature(targetDir, type, options) {
   invariant(type === 'chat', `unsupported feature: ${type}`)
-  const mountRequested = options.mount !== false
   const featureFiles = getChatFeatureFiles(targetDir)
-  const mainFile = findMainEntry(targetDir)
-  const mountPlan = mountRequested ? planMount(targetDir) : null
   const pkgPath = path.join(targetDir, 'package.json')
   invariant(fs.existsSync(pkgPath), 'package.json not found.')
   invariant(fs.statSync(pkgPath).isFile(), 'package.json is not a file.')
   const pkg = readPackageJson(pkgPath)
   const featureInspection = inspectFeatureFiles(featureFiles)
-  const selectedFiles = await selectFileChanges(targetDir, {
-    ...options,
-    mount: mountRequested,
-    nonInteractive: options.nonInteractive,
-  })
-
-  validateSelection(selectedFiles, pkg, featureInspection, mountPlan, options.dryRun, options.dependencies)
-  const prepared = prepareChanges(targetDir, selectedFiles, {
+  const prepared = prepareChanges(targetDir, {
     featureInspection,
-    mainFile,
-    mountPlan,
     pkgPath,
     pkg,
     allowConflicts: options.dryRun,
@@ -650,77 +462,51 @@ async function addFeature(targetDir, type, options) {
   })
 
   if (options.dryRun) {
-    console.log('\nChange Plan\n')
-    for (const file of featureInspection)
-      console.log(
-        `  ${file.type === 'create' ? '+' : file.type === 'conflict' ? '!' : '○'} ${formatRelative(file.target, targetDir)}`,
-      )
-    console.log(
-      `  ${mainFile ? formatPlanStatus(prepared.results.style?.type) : '!'} ${mainFile ? formatRelative(mainFile, targetDir) : 'src/main.ts or src/main.js'} (style imports)`,
-    )
-    console.log(
-      `  ${formatPlanStatus(prepared.results.env?.type ?? 'unavailable')} .env.example (${prepared.results.env?.type ?? 'not selected'})`,
-    )
-    const dependencyPlan =
-      prepared.results.dependencies.length > 0
-        ? prepared.results.dependencies
-        : getDependencyPlan(pkg, options.dependencies)
-    for (const { name, result } of dependencyPlan) {
-      const status = result.type === 'added' || result.type === 'updated' ? '~' : result.type === 'conflict' ? '!' : '○'
-      console.log(`  ${status} package.json (${result.type}: ${name})`)
-    }
-    if (mountPlan)
-      console.log(
-        `  ${mountPlan.type === 'merge' ? '~' : mountPlan.type === 'manual' ? '!' : '○'} src/App.vue (mount: ${mountPlan.type})`,
-      )
-    printManualMcpSetup()
+    printChangePlan(targetDir, prepared.results)
     return
   }
 
-  if (selectedFiles.length === 0) {
-    logSkip('No changes selected.')
+  if (prepared.changes.length === 0) {
+    logSkip('No changes were necessary.')
     return
   }
+
+  if (!options.yes && !options.nonInteractive) {
+    printChangePlan(targetDir, prepared.results)
+    const accepted = await confirm({ message: `Apply these changes to ${targetDir}?`, default: true })
+    if (!accepted) {
+      logSkip('Operation cancelled.')
+      return
+    }
+  }
+
   console.log('\nChange Results\n')
   applyChanges(prepared.changes)
-  printChangeResults(targetDir, selectedFiles, prepared.results)
-  if (prepared.changes.length > 0) console.log(`\nSuccessfully added "${type}" feature to ${targetDir}`)
-  else logSkip('No changes were necessary.')
-  printNextSteps({
-    mainFile,
-    dependencyChanged: prepared.results.dependencyChanged,
-    mounted: isSelected(selectedFiles, 'App.vue mount') && mountPlan?.type !== 'manual',
-    selectedFiles,
-    featureFilesSelected: isSelected(selectedFiles, 'Chat feature files'),
-  })
+  printChangeResults(targetDir, prepared.results)
+  console.log(`\nSuccessfully added "${type}" feature to ${targetDir}`)
+  printNextSteps({ dependencyChanged: prepared.results.dependencyChanged })
 }
 
-function printNextSteps({ mainFile, dependencyChanged, mounted, selectedFiles, featureFilesSelected }) {
+function printNextSteps({ dependencyChanged }) {
   const steps = []
-  if (featureFilesSelected && !mainFile)
-    steps.push("Import the package styles and './tiny-robot-chat/index.css' in your application entry file.")
-  if (featureFilesSelected && !mounted) {
-    steps.push(
-      [
-        'Render <TinyRobotChat /> near your main application component.',
-        '',
-        "Example ('src/App.vue'):",
-        '',
-        '  <script setup lang="ts">',
-        "  import TinyRobotChat from './tiny-robot-chat/TinyRobotChat.vue'",
-        '  </script>',
-        '',
-        '  <template>',
-        '    <YourAppComponent />',
-        '    <TinyRobotChat />',
-        '  </template>',
-      ].join('\n'),
-    )
-  }
-  if (isSelected(selectedFiles, '.env.example'))
-    steps.push('Copy .env.example to .env.local and configure your AI provider API keys.')
-  if (featureFilesSelected)
-    steps.push('Add the Model Context MCP proxy to vite.config.* under server.proxy, then restart Vite.')
+  steps.push(
+    [
+      'Render <TinyRobotChat /> near your main application component.',
+      '',
+      "Example ('src/App.vue'):",
+      '',
+      '  <script setup lang="ts">',
+      "  import TinyRobotChat from './tiny-robot-chat/TinyRobotChat.vue'",
+      '  </script>',
+      '',
+      '  <template>',
+      '    <YourAppComponent />',
+      '    <TinyRobotChat />',
+      '  </template>',
+    ].join('\n'),
+  )
+  steps.push('Copy .env.example to .env.local and configure your AI provider API keys.')
+  steps.push('Add the Model Context MCP proxy to vite.config.* under server.proxy, then restart Vite.')
   if (dependencyChanged) steps.push('Install or update project dependencies: pnpm install')
   if (steps.length > 0) {
     console.log('\nNext Steps\n')
@@ -733,10 +519,8 @@ export function registerAddCommand(program) {
     .command('add')
     .description('Add a feature to the project')
     .addArgument(new Argument('<type>', 'type of feature to add').choices(['chat']))
-    .option('--yes', 'apply all safe changes without prompts')
+    .option('--yes', 'apply the complete chat feature without prompts')
     .option('--dry-run', 'print the change plan without modifying files')
-    .option('--mount', 'safely mount TinyRobotChat in src/App.vue (default)')
-    .option('--no-mount', 'keep App.vue unchanged and print the mount snippet')
     .option('--runtime-version <version>', 'override the TinyRobot runtime version')
     .action(async (type, options) => {
       try {
@@ -759,4 +543,4 @@ export function registerAddCommand(program) {
     })
 }
 
-export { ensureDependency, ensureStyleImports, getChatFeatureFiles, planMount, resolveTargetPackage }
+export { addFileChange, applyChanges, ensureDependency, getChatFeatureFiles, printChangeResults, resolveTargetPackage }

package/bin/utils.js

@@ -7,7 +7,7 @@ import yaml from 'yaml'
 const TEMPLATE_PLACEHOLDER = '__PROJECT_NAME__'
 const RUNTIME_VERSION_PLACEHOLDER = '__TINY_ROBOT_VERSION__'
 
-export const BUILTIN_TEMPLATES = ['basic']
+export const BUILTIN_TEMPLATES = ['basic', 'chat']
 export const DEFAULT_TEMPLATE = 'basic'
 export const DEFAULT_PROJECT_NAME = 'tiny-robot-app'
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opentiny/tiny-robot-cli",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-rc.0",
   "description": "CLI to scaffold TinyRobot product projects",
   "repository": {
     "type": "git",
@@ -28,11 +28,10 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^8.3.2",
-    "@vue/compiler-sfc": "^3.5.40",
     "commander": "^14.0.3",
     "picocolors": "^1.1.1",
     "semver": "^7.8.1",
     "yaml": "^2.9.0"
   },
-  "gitHead": "49bf2d12171a55e1029bd00bdf2c5dbb53be3eb7"
+  "gitHead": "a2ee45f7628dfd1cacdddd159050c026ba11e67e"
 }

package/templates/basic/README.md

@@ -1,4 +1,4 @@
-# **PROJECT_NAME**
+# __PROJECT_NAME__
 
 This project is generated from the TinyRobot Chat Basic template. It covers conversations, streaming responses, cancellation, Markdown rendering, responsive history, themes, model capabilities, and MCP Server/Tool management.
 

package/templates/basic/src/App.vue

@@ -1,7 +1,7 @@
 <script setup lang="ts">
 import {
   TrChat,
-  useLocalChatRuntime,
+  useChatRuntime,
   type ChatMcpServers,
   type ChatProviderConfig,
   type ChatUIOptions,
@@ -90,7 +90,7 @@ const mcpServers = [
   },
 ] satisfies ChatMcpServers
 
-const runtime = useLocalChatRuntime({
+const runtime = useChatRuntime({
   mcpServers,
   modelProviders,
 })

package/templates/chat/.env.example

@@ -5,6 +5,7 @@ VITE_DEEPSEEK_API_URL=
 # Optional custom MCP endpoint. Leave blank to use the official endpoint.
 VITE_AMAP_MCP_URL=
 
-# Optional local direct-connection credentials.
+# Optional local direct-connection credentials (development only).
+# WARNING: VITE_* values are embedded in the client bundle. Do not use production keys.
 VITE_ALIYUN_DASHSCOPE_KEY=
 VITE_DEEPSEEK_API_KEY=

package/templates/chat/README.md

@@ -1,6 +1,12 @@
 # TinyRobot Chat Add
 
-这是一个独立的 Chat 扩展模板，提供通用工作助手场景的最小工程结构。
+这是一个独立的 Chat 项目模板，也可以通过 `add chat` 注入到现有 Vue 项目。
+
+创建独立 Chat 项目：
+
+```bash
+npx @opentiny/tiny-robot-cli create my-chat --template chat
+```
 
 ## 启动
 
@@ -17,7 +23,9 @@ pnpm build
 
 ## 接入真实模型
 
-复制项目根目录的 `.env.example` 为 `.env.local`，配置 `VITE_QWEN_API_URL`、`VITE_ALIYUN_DASHSCOPE_KEY`、`VITE_DEEPSEEK_API_URL` 和 `VITE_DEEPSEEK_API_KEY`，重启 Vite 后即可使用模型选择器中的真实模型。模板只提供 `.env.example`，不会自动创建 `.env`。配置读取逻辑位于 `src/config/chat-runtime.ts`；使用 `add chat` 注入后，对应文件位于 `src/tiny-robot-chat/config/chat-runtime.ts`。
+复制项目根目录的 `.env.example` 为 `.env.local`，配置 `VITE_ALIYUN_DASHSCOPE_KEY` 和 `VITE_DEEPSEEK_API_KEY`，重启 Vite 后即可使用模型选择器中的真实模型。使用自定义 Provider 代理时，可配置 `VITE_QWEN_API_URL` 和 `VITE_DEEPSEEK_API_URL`；自定义 MCP 地址使用 `VITE_AMAP_MCP_URL`。模板只提供 `.env.example`，不会自动创建 `.env`。配置读取逻辑位于 `src/config/chat-runtime.ts`；使用 `add chat` 注入后，对应文件位于 `src/tiny-robot-chat/config/chat-runtime.ts`。
+
+`VITE_*` 变量会被写入浏览器产物，仅限开发使用，禁止配置生产密钥；生产环境应通过服务端代理保护 Provider 凭证。
 
 ## 模型配置
 
@@ -33,6 +41,7 @@ DeepSeek 模型默认继承 `low`、`high`、`max` 三档思考强度，默认
 
 - `src/config/chat-ui.ts`: Chat UI、提示词、模板和菜单配置。
 - `src/config/chat-runtime.ts`: MCP 示例和模型配置。
+- `src/TinyRobotChat.vue`: Chat 入口组件及其样式依赖。
 - `src/components`: 窗口头部和输入区工具。
 - `src/composables/useWindow.ts`: floating、fullscreen 窗口状态。
 - `src/index.css`: 仅作用于 Chat 容器的组件样式和 Surface 样式变量，不重置宿主页面的全局样式。

package/templates/chat/src/TinyRobotChat.vue

@@ -1,7 +1,7 @@
 <script setup lang="ts">
 import type { HistoryMenuItem, PromptProps, TemplateItem } from '@opentiny/tiny-robot'
 import { TrSender, TrThemeProvider as TrTheme } from '@opentiny/tiny-robot'
-import { TrChat, useChatHistoryItems, useLocalChatRuntime, type ChatHistoryItem } from '@opentiny/tiny-robot-chat'
+import { TrChat, useChatHistoryItems, useChatRuntime, type ChatHistoryItem } from '@opentiny/tiny-robot-chat'
 import { IconAi } from '@opentiny/tiny-robot-svgs'
 import { computed, reactive, ref } from 'vue'
 import ComposerTools from './components/ComposerTools.vue'
@@ -9,8 +9,11 @@ import WindowHeader from './components/WindowHeader.vue'
 import { composerMenus, createChatUi, templateCategories } from './config/chat-ui'
 import { mcpExamples, mcpServers, modelProviders } from './config/chat-runtime'
 import { useWindow } from './composables/useWindow'
+import '@opentiny/tiny-robot/dist/style.css'
+import '@opentiny/tiny-robot-chat/dist/style.css'
+import './index.css'
 
-const runtime = useLocalChatRuntime({ modelProviders, mcpServers })
+const runtime = useChatRuntime({ modelProviders, mcpServers })
 const window = reactive(useWindow())
 const chatRef = ref<{ send: (payload: { text: string }) => Promise<boolean> } | null>(null)
 const currentTemplate = ref<TemplateItem[]>([])

package/templates/chat/src/main.ts

@@ -1,7 +1,4 @@
 import { createApp } from 'vue'
-import '@opentiny/tiny-robot/dist/style.css'
-import '@opentiny/tiny-robot-chat/dist/style.css'
-import './index.css'
 import TinyRobotChat from './TinyRobotChat.vue'
 
 createApp(TinyRobotChat).mount('#app')