xshat-lite 1.0.0

package/src/modules/settings-menu.mjs

@@ -0,0 +1,367 @@
+import { input as promptInput, select } from '@inquirer/prompts';
+import { getUserConfigPath, listProviders, updateConfigValue } from '../utils/config.mjs';
+
+function getProviderStatusLabel(status = '') {
+  if (status === 'working') {
+    return '可用';
+  }
+  if (status === 'experimental') {
+    return '实验性';
+  }
+  if (status === 'disabled') {
+    return '停用';
+  }
+  return status || '未知';
+}
+
+function getProviderTransportLabel(provider) {
+  return provider?.transport === 'api' ? 'API' : 'Web';
+}
+
+function formatProviderValue(provider) {
+  if (!provider) {
+    return '(未设置)';
+  }
+  return `${provider.name} · ${getProviderTransportLabel(provider)} · ${getProviderStatusLabel(provider.status)}`;
+}
+
+function buildProviderChoiceName(provider, currentProviderId) {
+  const currentTag = provider.id === currentProviderId ? '（当前）' : '';
+  const summary = `${getProviderTransportLabel(provider)} / ${getProviderStatusLabel(provider.status)}`;
+  return `${provider.name}${currentTag}  ${summary}  ${provider.description || ''}`.trim();
+}
+
+function buildSettingItems(config) {
+  const currentProvider = listProviders().find((provider) => provider.id === config.defaultProvider);
+  return [
+    {
+      key: 'defaultProvider',
+      label: '默认提供方',
+      description: '新建聊天和任务默认使用的站点或 API',
+      type: 'select',
+      value: formatProviderValue(currentProvider)
+    },
+    {
+      key: 'providersRuntime.autoFallback',
+      label: '自动故障切换',
+      description: '当前 provider 多次重试仍失败后，是否自动切换到下一个提供方',
+      type: 'boolean',
+      value: Boolean(config.providersRuntime?.autoFallback)
+    },
+    {
+      key: 'providersRuntime.includeApiFallback',
+      label: 'API 兜底',
+      description: '网页模型都不稳时是否允许切换到 API 提供方',
+      type: 'boolean',
+      value: Boolean(config.providersRuntime?.includeApiFallback)
+    },
+    {
+      key: 'api.baseUrl',
+      label: 'API Base URL',
+      description: 'OpenAI-compatible API 根地址',
+      type: 'text',
+      value: config.api?.baseUrl || ''
+    },
+    {
+      key: 'api.model',
+      label: 'API 默认模型',
+      description: 'API 提供方默认模型名',
+      type: 'text',
+      value: config.api?.model || ''
+    },
+    {
+      key: 'agent.enabled',
+      label: 'Agent 模式',
+      description: '是否默认开启 Agent 结构化对话',
+      type: 'boolean',
+      value: Boolean(config.agent?.enabled)
+    },
+    {
+      key: 'agent.autoExecuteCommands',
+      label: '自动执行命令',
+      description: '是否自动执行模型建议的命令',
+      type: 'boolean',
+      value: Boolean(config.agent?.autoExecuteCommands)
+    },
+    {
+      key: 'agent.allowShell',
+      label: 'Shell 权限',
+      description: '是否允许执行系统命令',
+      type: 'boolean',
+      value: Boolean(config.agent?.allowShell)
+    },
+    {
+      key: 'agent.allowFileWrite',
+      label: '文件写入',
+      description: '是否允许增删改工作区文件',
+      type: 'boolean',
+      value: Boolean(config.agent?.allowFileWrite)
+    },
+    {
+      key: 'agent.maxAutoSteps',
+      label: '最大自动步数',
+      description: '单次 Agent 自动续跑的最大步数',
+      type: 'number',
+      value: Number(config.agent?.maxAutoSteps) || 4,
+      min: 1,
+      max: 20
+    },
+    {
+      key: 'agent.longRunning',
+      label: '长时运行',
+      description: '是否启用更适合长任务的运行模式',
+      type: 'boolean',
+      value: Boolean(config.agent?.longRunning)
+    },
+    {
+      key: 'agent.multiAgent',
+      label: '多 Agent 协作',
+      description: '是否启用主控 + 专项角色的协作模式',
+      type: 'boolean',
+      value: Boolean(config.agent?.multiAgent)
+    },
+    {
+      key: 'browser.headless',
+      label: '浏览器 Headless',
+      description: '是否默认无界面启动浏览器',
+      type: 'boolean',
+      value: Boolean(config.browser?.headless)
+    },
+    {
+      key: 'browser.humanize',
+      label: '浏览器 Humanize',
+      description: '是否启用更拟人的交互节奏',
+      type: 'boolean',
+      value: Boolean(config.browser?.humanize)
+    },
+    {
+      key: 'browser.autoRecover',
+      label: '自动恢复',
+      description: '浏览器异常后是否尝试自动恢复',
+      type: 'boolean',
+      value: Boolean(config.browser?.autoRecover)
+    },
+    {
+      key: 'browser.allowVisibleBrowser',
+      label: '允许可见浏览器',
+      description: '是否允许程序主动切换到可见浏览器窗口',
+      type: 'boolean',
+      value: Boolean(config.browser?.allowVisibleBrowser)
+    },
+    {
+      key: 'browser.shareAuthState',
+      label: '统一登录态',
+      description: '在聊天通道和 Agent 通道之间同步登录状态',
+      type: 'boolean',
+      value: Boolean(config.browser?.shareAuthState)
+    },
+    {
+      key: 'session.compressThreshold',
+      label: '上下文压缩阈值',
+      description: '达到多少轮后开始自动压缩上下文',
+      type: 'number',
+      value: Number(config.session?.compressThreshold) || 12,
+      min: 4,
+      max: 100
+    },
+    {
+      key: 'session.keepRecentMessages',
+      label: '保留最近轮数',
+      description: '压缩时保留多少轮原始消息',
+      type: 'number',
+      value: Number(config.session?.keepRecentMessages) || 6,
+      min: 2,
+      max: 20
+    }
+  ];
+}
+
+function buildSettingGroups(config) {
+  const items = buildSettingItems(config);
+  const pick = (...keys) => items.filter((item) => keys.includes(item.key));
+
+  return [
+    {
+      key: 'provider',
+      label: '提供方与兜底',
+      items: pick(
+        'defaultProvider',
+        'providersRuntime.autoFallback',
+        'providersRuntime.includeApiFallback',
+        'api.baseUrl',
+        'api.model'
+      )
+    },
+    {
+      key: 'agent',
+      label: 'Agent 能力',
+      items: pick(
+        'agent.enabled',
+        'agent.autoExecuteCommands',
+        'agent.allowShell',
+        'agent.allowFileWrite',
+        'agent.maxAutoSteps',
+        'agent.longRunning',
+        'agent.multiAgent'
+      )
+    },
+    {
+      key: 'browser',
+      label: '浏览器',
+      items: pick(
+        'browser.headless',
+        'browser.humanize',
+        'browser.autoRecover',
+        'browser.allowVisibleBrowser',
+        'browser.shareAuthState'
+      )
+    },
+    {
+      key: 'session',
+      label: '会话与上下文',
+      items: pick(
+        'session.compressThreshold',
+        'session.keepRecentMessages'
+      )
+    }
+  ];
+}
+
+function getDisplayValue(item) {
+  if (item.type === 'boolean') {
+    return item.value ? '开启' : '关闭';
+  }
+  return String(item.value ?? '');
+}
+
+async function editSetting(item, config, ui) {
+  if (item.type === 'boolean') {
+    const nextValue = !item.value;
+    updateConfigValue(item.key, nextValue);
+    ui.printSuccess(`${item.label} 已切换为${nextValue ? '开启' : '关闭'}`);
+    return;
+  }
+
+  if (item.type === 'number') {
+    const answer = await promptInput({
+      message: `${item.label} (${item.min}-${item.max})`,
+      default: String(item.value)
+    });
+    if (!answer) {
+      return;
+    }
+    const parsed = Number.parseInt(answer, 10);
+    if (!Number.isFinite(parsed) || parsed < item.min || parsed > item.max) {
+      ui.printError('输入无效');
+      return;
+    }
+    updateConfigValue(item.key, parsed);
+    ui.printSuccess(`${item.label} 已更新为 ${parsed}`);
+    return;
+  }
+
+  if (item.type === 'text') {
+    const answer = await promptInput({
+      message: item.label,
+      default: String(item.value ?? '')
+    });
+    if (answer === undefined) {
+      return;
+    }
+    updateConfigValue(item.key, answer.trim());
+    ui.printSuccess(`${item.label} 已更新`);
+    return;
+  }
+
+  if (item.type === 'select') {
+    const providers = listProviders();
+    const value = await select({
+      message: '选择默认提供方',
+      choices: providers.map((provider) => ({
+        name: buildProviderChoiceName(provider, config.defaultProvider),
+        value: provider.id
+      })),
+      default: config.defaultProvider
+    });
+    updateConfigValue(item.key, value);
+    const provider = providers.find((item) => item.id === value);
+    ui.printSuccess(`默认提供方已切换为 ${provider?.name || value}`);
+  }
+}
+
+export async function showSettingsMenu({
+  ui,
+  config
+}) {
+  while (true) {
+    const items = buildSettingItems(config);
+    const groups = buildSettingGroups(config);
+
+    ui.clear();
+    ui.printTitle('系统设置');
+    ui.printNewline();
+    ui.printKeyValueTable('配置概览', [
+      ...items.map((item) => ({
+        label: item.label,
+        value: `${getDisplayValue(item)} · ${item.description}`
+      })),
+      { label: '用户配置', value: getUserConfigPath() }
+    ]);
+    ui.printNewline();
+
+    const choice = await select({
+      message: '选择分组或直接返回',
+      choices: [
+        ...groups.map((group) => ({
+          name: `${group.label}  ${group.items.length} 项`,
+          value: group.key
+        })),
+        { name: '全部设置项', value: '__all__' },
+        { name: '返回', value: '__back__' }
+      ]
+    });
+
+    if (choice === '__back__') {
+      ui.printNewline();
+      ui.printInfo('设置已保存到用户配置文件。');
+      ui.printNewline();
+      return;
+    }
+
+    const scopedItems =
+      choice === '__all__'
+        ? items
+        : groups.find((group) => group.key === choice)?.items || [];
+
+    if (scopedItems.length === 0) {
+      continue;
+    }
+
+    const settingChoice = await select({
+      message: '上下选择设置项，回车编辑或切换',
+      choices: [
+        ...scopedItems.map((item) => ({
+          name: `${item.label}  ${getDisplayValue(item)}  ${item.description}`,
+          value: item.key
+        })),
+        { name: '返回上一级', value: '__group_back__' }
+      ]
+    });
+
+    if (settingChoice === '__group_back__') {
+      continue;
+    }
+
+    const currentItem = items.find((item) => item.key === settingChoice);
+    if (!currentItem) {
+      continue;
+    }
+
+    await editSetting(currentItem, config, ui);
+    await new Promise((resolve) => setTimeout(resolve, 700));
+  }
+}
+
+export default {
+  showSettingsMenu
+};