xshat-lite 1.0.0 → 1.1.0

package/README.md

@@ -36,6 +36,12 @@ npm install
 npm install -g xshat-lite
 ```
 
+首次全局启动时，程序会自动进入一次轻量向导，帮助你：
+
+- 选择更适合首用的默认 provider
+- 打开可见浏览器支持
+- 预热浏览器环境并准备首次聊天
+
 本地调试全局命令：
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xshat-lite",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "CLI chat and agent tool powered by free AI web providers",
   "type": "module",
   "main": "src/index.mjs",

package/src/index.mjs

@@ -1,4 +1,5 @@
 import readline from 'node:readline/promises';
+import fs from 'node:fs';
 import { stdin as input, stdout as output } from 'process';
 import { resolve } from 'node:path';
 import { confirm, input as promptInput, select } from '@inquirer/prompts';
@@ -50,8 +51,11 @@ import {
 import { runRuntimeMaintenance } from './modules/runtime-maintenance.mjs';
 import { waitForKeypress } from './utils/key-input.mjs';
 import config, {
+  getRuntimeRootDir,
   getProvider,
-  listProviders
+  getUserConfigPath,
+  listProviders,
+  updateConfigValue
 } from './utils/config.mjs';
 
 let chatManager = null;
@@ -67,6 +71,117 @@ let lastSubmittedQuestion = '';
 let lastAgentOrReplySummary = '';
 const inputHistory = [];
 
+function getRecommendedFirstRunProviderId() {
+  const candidates = ['duckai', 'qwen', 'deepai', 'huggingchat', 'you'];
+  const available = new Set(listProviders().map((provider) => provider.id));
+  return candidates.find((id) => available.has(id)) || getProvider().id;
+}
+
+function isFirstRunGuideNeeded() {
+  if (config.meta?.firstRunCompleted) {
+    return false;
+  }
+
+  return !fs.existsSync(getUserConfigPath());
+}
+
+function buildFirstRunGuideRows() {
+  const defaultProvider = getProvider();
+  const recommendedProvider = getProvider(getRecommendedFirstRunProviderId());
+  const userDataDirExists = fs.existsSync(config.browser?.userDataDir || '');
+
+  return [
+    { label: '运行目录', value: getRuntimeRootDir() },
+    { label: '默认 Provider', value: defaultProvider.name },
+    { label: '推荐首选', value: recommendedProvider.name },
+    { label: '浏览器模式', value: config.browser?.headless ? 'Headless' : 'Visible' },
+    { label: '允许可见浏览器', value: String(Boolean(config.browser?.allowVisibleBrowser)) },
+    { label: '资料目录', value: config.browser?.userDataDir || '(未设置)' },
+    { label: '资料目录状态', value: userDataDirExists ? '已存在' : '首次启动时创建' }
+  ];
+}
+
+async function warmupBrowserEnvironment() {
+  ui.printInfo('正在预热浏览器环境，首次启动可能需要下载浏览器内核...');
+  try {
+    await browserManager.init({
+      headless: true
+    });
+    await browserManager.close();
+    ui.printSuccess('浏览器环境已准备好');
+    return true;
+  } catch (error) {
+    ui.printWarning(`浏览器预热未完成: ${error.message}`);
+    return false;
+  }
+}
+
+async function applyRecommendedFirstRunProfile() {
+  const recommendedProviderId = getRecommendedFirstRunProviderId();
+  await Promise.all([
+    config.defaultProvider !== recommendedProviderId
+      ? updateConfigValue('defaultProvider', recommendedProviderId)
+      : Promise.resolve(),
+    config.browser?.headless
+      ? updateConfigValue('browser.headless', false)
+      : Promise.resolve(),
+    config.browser?.allowVisibleBrowser !== true
+      ? updateConfigValue('browser.allowVisibleBrowser', true)
+      : Promise.resolve(),
+    config.browser?.autoRecover !== true
+      ? updateConfigValue('browser.autoRecover', true)
+      : Promise.resolve()
+  ]);
+}
+
+async function markFirstRunGuideCompleted() {
+  await updateConfigValue('meta.firstRunCompleted', true);
+}
+
+async function maybeRunFirstLaunchGuide() {
+  if (!isFirstRunGuideNeeded()) {
+    return;
+  }
+
+  ui.clear();
+  ui.printTitle('首次启动向导');
+  ui.printNewline();
+  ui.printInfo('检测到这是一个全新的 XShat 运行环境。先做一轮轻量初始化，后面进聊天会顺很多。');
+  ui.printNewline();
+  ui.printKeyValueTable('环境概览', buildFirstRunGuideRows());
+  ui.printNewline();
+  ui.printInfo('建议第一次先使用免登录或更稳定的站点，再按需要切换到 Gemini / ChatGPT / Copilot。');
+  ui.printNewline();
+
+  const choice = await select({
+    message: '选择首次启动动作',
+    choices: [
+      { name: '一键推荐设置（Duck.ai/Qwen + 可见浏览器）', value: 'recommended' },
+      { name: '只预热浏览器环境', value: 'warmup' },
+      { name: '打开系统设置自己调整', value: 'settings' },
+      { name: '暂时跳过', value: 'skip' }
+    ],
+    default: 'recommended'
+  });
+
+  if (choice === 'recommended') {
+    await applyRecommendedFirstRunProfile();
+    ui.printSuccess(`已应用首次推荐设置，默认提供方切到 ${getProvider().name}`);
+    await warmupBrowserEnvironment();
+  } else if (choice === 'warmup') {
+    await warmupBrowserEnvironment();
+  } else if (choice === 'settings') {
+    await showSettingsMenu({ ui, config });
+  } else {
+    ui.printMuted('已跳过首次向导，后续仍可在 /config 里调整。');
+  }
+
+  await markFirstRunGuideCompleted();
+  ui.printNewline();
+  ui.printInfo('首次向导完成。按回车进入主菜单...');
+  await askInput('', true);
+}
+
 function getSessionCompressionOptions() {
   return {
     compressThreshold: Number(config.session?.compressThreshold) || 12,
@@ -2743,11 +2858,12 @@ async function main() {
     await logger.init();
     await sessionManager.init();
     await taskStore.init();
+    setupGracefulShutdown();
+    await maybeRunFirstLaunchGuide();
+
     const maintenance = await runRuntimeMaintenance();
     ensureTaskRunner().startLoop();
 
-    setupGracefulShutdown();
-
     if (maintenance.tempRemoved > 0) {
       ui.printMuted(`启动清理: 已移除 ${maintenance.tempRemoved} 个临时文件`);
     }

package/src/utils/config.mjs

@@ -219,6 +219,10 @@ export function getUserConfigPath() {
   return userConfigPath;
 }
 
+export function getRuntimeRootDir() {
+  return runtimeRootDir;
+}
+
 export function getUserConfigOverrides() {
   return JSON.parse(JSON.stringify(userConfigOverrides));
 }