@ww_nero/mini-cli 1.0.63 → 1.0.68

package/src/config.js

@@ -1,401 +1,405 @@
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-
-const CONFIG_DIR = path.join(os.homedir(), '.mini');
-const FILE_NAMES = {
-  chat: 'chat.json',
-  commit: 'commit.json',
-  mcp: 'mcp.json',
-  settings: 'settings.json',
-  worktree: 'worktree.json',
-  mini: 'MINI.md'
-};
-
-const DEFAULT_ALLOWED_COMMANDS = [
-  'rm', 'rmdir', 'touch', 'mkdir', 'cd', 'cp', 'mv', 'node', 'npm', 'pkill', 'kill',
-  'curl', 'ls', 'pwd', 'grep', 'cat', 'echo', 'sed', 'head', 'tail', 'find', 'true',
-  'false', 'pip', 'python', 'ps', 'lsof', 'git', 'pandoc'
-];
-
-const DEFAULT_TOOL_RESPONSE_MAX_TOKENS = 65536;
-const DEFAULT_COMPACT_TOKEN_THRESHOLD = 65536;
-const DEFAULT_MCP_TOOL_TIMEOUT_MS = 10 * 60 * 1000;
-const DEFAULT_OUTPUT_MAX_LENGTH = 12000;
-const DEFAULT_EXECUTION_TIMEOUT = 300000;
-const DEFAULT_SERVICE_BOOT_WINDOW = 5000;
-const DEFAULT_LARGE_FILE_LINE_THRESHOLD = 2000;
-const COMPACT_SUMMARY_PROMPT = `请对以下对话进行总结，用于上下文压缩。请按以下格式输出：
-
-## 问题背景
-简要描述用户的原始问题和目标，包括涉及的重要文件路径。
-
-## 已完成工作
-列出已经完成的任务或环节：
-- 已搜索/阅读的文件
-- 已修改的代码
-- 已执行的操作
-- 重要的中间结果
-
-## 待继续任务
-根据对话上下文，描述接下来需要继续完成的工作：
-- 未完成的任务
-- 需要进一步处理的问题
-- 用户最后一次请求的具体内容
-
-请确保总结完整、准确，以便在压缩后能够继续完成用户的任务。`;
-const detectCommandPath = () => {
-  if (process.platform === 'win32') return 'C:/Windows/System32/wsl.exe';
-  if (process.platform === 'darwin') return '/bin/zsh';
-  return '/bin/bash';
-};
-
-const DEFAULT_CHAT_ENDPOINTS = [
-  {
-    baseUrl: 'https://generativelanguage.googleapis.com/v1beta/openai',
-    key: 'your-api-key',
-    model: 'gemini-flash-latest',
-    alias: 'Gemini Flash',
-    name: 'gemini-flash-latest',
-    think: true,
-    price: 0,
-    options: {
-      extra_body: {
-        google: {
-          thinking_config: {
-            thinking_budget: -1,
-            include_thoughts: false
-          }
-        }
-      }
-    }
-  }
-];
-
-const DEFAULT_COMMIT_MODEL = {
-  baseUrl: 'https://generativelanguage.googleapis.com/v1beta/openai',
-  key: 'your-api-key',
-  model: 'gemini-flash-latest',
-  options: {
-    reasoning_effort: 'none'
-  }
-};
-
-const DEFAULT_WORKTREE_COMMANDS = [
-  { base: 'codex', prompt: 'codex --full-auto {prompt}', resume: 'codex --full-auto resume' },
-  { base: 'claude', prompt: 'claude --permission-mode acceptEdits {prompt}', resume: 'claude --permission-mode acceptEdits --continue' },
-  { base: 'gemini', prompt: 'gemini -m pro --approval-mode=auto_edit -i {prompt}', resume: 'gemini -m pro --approval-mode=auto_edit --resume' }
-];
-
-const DEFAULT_SETTINGS = {
-  mcpServers: {},
-  tools: {},
-  commands: [],
-  maxToolTokens: DEFAULT_TOOL_RESPONSE_MAX_TOKENS,
-  compactTokenThreshold: DEFAULT_COMPACT_TOKEN_THRESHOLD,
-  allowedCommands: [...DEFAULT_ALLOWED_COMMANDS],
-  mcpToolTimeout: DEFAULT_MCP_TOOL_TIMEOUT_MS,
-  outputMaxLength: DEFAULT_OUTPUT_MAX_LENGTH,
-  executionTimeout: DEFAULT_EXECUTION_TIMEOUT,
-  serviceBootWindow: DEFAULT_SERVICE_BOOT_WINDOW,
-  largeFileLineThreshold: DEFAULT_LARGE_FILE_LINE_THRESHOLD
-};
-
-const DEFAULT_MINI_CONTENT = '# 在此填写全局系统指令。\n';
-
-class ConfigError extends Error {
-  constructor(message, configPath) {
-    super(message);
-    this.name = 'ConfigError';
-    this.configPath = configPath;
-  }
-}
-
-const isPlainObject = (value) => value && typeof value === 'object' && !Array.isArray(value);
-
-const ensureDir = (dirPath) => {
-  if (!fs.existsSync(dirPath)) {
-    fs.mkdirSync(dirPath, { recursive: true });
-  }
-};
-
-const writeJsonFile = (filePath, data) => {
-  fs.writeFileSync(filePath, `${JSON.stringify(data, null, 2)}\n`, 'utf8');
-};
-
-const ensureFile = (filePath, data) => {
-  if (fs.existsSync(filePath)) return false;
-  if (typeof data === 'string') {
-    fs.writeFileSync(filePath, data, 'utf8');
-  } else {
-    writeJsonFile(filePath, data);
-  }
-  return true;
-};
-
-const getConfigPath = (key) => path.join(CONFIG_DIR, FILE_NAMES[key]);
-const getDefaultConfigPath = () => getConfigPath('chat');
-
-const readJsonFile = (filePath, fallback = {}) => {
-  try {
-    const raw = fs.readFileSync(filePath, 'utf8');
-    if (!raw.trim()) return fallback;
-    return JSON.parse(raw);
-  } catch (_) {
-    return fallback;
-  }
-};
-
-const extractEndpointList = (parsed) => {
-  if (Array.isArray(parsed)) return parsed;
-  if (isPlainObject(parsed)) {
-    if (Array.isArray(parsed.endpoints)) return parsed.endpoints;
-    if (parsed.endpoint) return [parsed.endpoint];
-  }
-  return [];
-};
-
-const ensureConfigFiles = () => {
-  ensureDir(CONFIG_DIR);
-  const createdFiles = [];
-
-  if (ensureFile(getConfigPath('chat'), { endpoints: DEFAULT_CHAT_ENDPOINTS })) {
-    createdFiles.push(FILE_NAMES.chat);
-  }
-
-  if (ensureFile(getConfigPath('commit'), { model: DEFAULT_COMMIT_MODEL })) {
-    createdFiles.push(FILE_NAMES.commit);
-  }
-
-  if (ensureFile(getConfigPath('mcp'), { mcpServers: {} })) {
-    createdFiles.push(FILE_NAMES.mcp);
-  }
-
-  if (ensureFile(getConfigPath('settings'), DEFAULT_SETTINGS)) {
-    createdFiles.push(FILE_NAMES.settings);
-  }
-
-  if (ensureFile(getConfigPath('worktree'), { commands: DEFAULT_WORKTREE_COMMANDS })) {
-    createdFiles.push(FILE_NAMES.worktree);
-  }
-
-  if (ensureFile(getConfigPath('mini'), DEFAULT_MINI_CONTENT)) {
-    createdFiles.push(FILE_NAMES.mini);
-  }
-
-  return { configDir: CONFIG_DIR, createdFiles };
-};
-
-const normalizePositiveInteger = (value, fallback) => {
-  const numberValue = Number(value);
-  if (Number.isFinite(numberValue) && numberValue > 0) {
-    return Math.trunc(numberValue);
-  }
-  return fallback;
-};
-
-const normalizeField = (value) => (typeof value === 'string' ? value.trim() : '');
-const createEndpointSignature = (entry = {}) => {
-  const pick = (key) => normalizeField(entry[key]).toLowerCase();
-  return ['name', 'model', 'baseUrl', 'key'].map(pick).join('::');
-};
-
-const normalizeEndpoint = (raw = {}, index = 0) => {
-  if (!isPlainObject(raw)) return { endpoint: null };
-
-  const key = normalizeField(raw.key);
-  const baseUrl = normalizeField(raw.baseUrl);
-  const model = normalizeField(raw.model);
-  if (!baseUrl || !key || !model) {
-    return { endpoint: null };
-  }
-
-  const nameRaw = normalizeField(raw.alias || raw.name);
-  const name = nameRaw || model || `model_${index + 1}`;
-  const think = raw.think === true;
-  const price = Number.isFinite(Number(raw.price)) ? Number(raw.price) : 0;
-  const options = isPlainObject(raw.options) ? raw.options : undefined;
-
-  const endpoint = {
-    baseUrl,
-    key,
-    model,
-    name,
-    alias: name,
-    think,
-    price,
-    ...(options ? { options } : {})
-  };
-
-  return {
-    endpoint: {
-      ...endpoint,
-      signature: createEndpointSignature({ ...raw, ...endpoint })
-    }
-  };
-};
-
-const loadEndpointConfig = () => {
-  const ensureResult = ensureConfigFiles();
-  const configPath = getConfigPath('chat');
-  const parsed = readJsonFile(configPath, { endpoints: [] });
-  const rawList = extractEndpointList(parsed);
-
-  const endpoints = rawList
-    .map((entry, idx) => normalizeEndpoint(entry, idx).endpoint)
-    .filter(Boolean)
-    .map((endpoint, idx) => ({ ...endpoint, name: endpoint.name || endpoint.alias || endpoint.model || `model_${idx + 1}` }));
-
-  const validEndpoints = endpoints.filter((ep) => ep.key && !ep.key.toLowerCase().includes('your-api-key'));
-  if (validEndpoints.length === 0) {
-    const suffix = ensureResult.createdFiles.includes(FILE_NAMES.chat)
-      ? '已自动生成模板，请填写 baseUrl/key/model 后重新运行 mini。'
-      : '请在配置中提供至少一个有效的 baseUrl、key、model。';
-    throw new ConfigError(`${configPath} 缺少可用的模型配置。${suffix}`, configPath);
-  }
-
-  return { endpoints: validEndpoints, configPath, created: ensureResult.createdFiles.includes(FILE_NAMES.chat) };
-};
-
-const resolveEndpointCollection = (parsed) => {
-  if (Array.isArray(parsed)) {
-    return parsed;
-  }
-  if (parsed && typeof parsed === 'object' && Array.isArray(parsed.endpoints)) {
-    return parsed.endpoints;
-  }
-  return null;
-};
-
-const promoteEndpointInConfig = (configPath, signature) => {
-  if (!configPath || !signature) {
-    return false;
-  }
-  try {
-    if (!fs.existsSync(configPath)) {
-      return false;
-    }
-    const rawContent = fs.readFileSync(configPath, 'utf8') || '';
-    if (!rawContent.trim()) {
-      return false;
-    }
-    const parsed = JSON.parse(rawContent);
-    const targetList = resolveEndpointCollection(parsed);
-    if (!Array.isArray(targetList) || targetList.length <= 1) {
-      return false;
-    }
-    const matchIndex = targetList.findIndex((entry) => createEndpointSignature(entry) === signature);
-    if (matchIndex <= 0) {
-      return matchIndex === 0;
-    }
-    const [selected] = targetList.splice(matchIndex, 1);
-    targetList.unshift(selected);
-    const serialized = Array.isArray(parsed) ? targetList : { ...parsed, endpoints: targetList };
-    writeJsonFile(configPath, serialized);
-    return true;
-  } catch (error) {
-    return false;
-  }
-};
-
-const ensureArrayOfStrings = (value, fallback = []) => {
-  if (!Array.isArray(value)) {
-    return [...fallback];
-  }
-  return value.map((v) => (typeof v === 'string' ? v.trim() : '')).filter(Boolean);
-};
-
-const getAllMcpServerNames = () => {
-  const mcpPath = getConfigPath('mcp');
-  const parsed = readJsonFile(mcpPath, { mcpServers: {} });
-  const mcpServers = parsed.mcpServers && typeof parsed.mcpServers === 'object'
-    ? parsed.mcpServers
-    : {};
-  return Object.keys(mcpServers);
-};
-
-const loadSettings = ({ defaultTools = [] } = {}) => {
-  const ensureResult = ensureConfigFiles();
-  const settingsPath = getConfigPath('settings');
-  const parsed = readJsonFile(settingsPath, DEFAULT_SETTINGS);
-
-  const settings = {
-    mcps: (() => {
-      const allMcpNames = getAllMcpServerNames();
-      const mcpConfig = parsed.mcpServers;
-
-      // 只支持对象格式，默认全部启用，只有明确设置为 false 才禁用
-      if (!isPlainObject(mcpConfig)) {
-        return allMcpNames;
-      }
-
-      return allMcpNames.filter((name) => mcpConfig[name] !== false);
-    })(),
-    tools: (() => {
-      const toolConfig = parsed.tools;
-
-      // 只支持对象格式，默认全部启用，只有明确设置为 false 才禁用
-      if (!isPlainObject(toolConfig)) {
-        return ensureArrayOfStrings(defaultTools);
-      }
-
-      return defaultTools.filter((name) => toolConfig[name] !== false);
-    })(),
-    commands: ensureArrayOfStrings(parsed.commands),
-    commandPath: detectCommandPath(),
-    maxToolTokens: normalizePositiveInteger(
-      parsed.maxToolTokens,
-      DEFAULT_TOOL_RESPONSE_MAX_TOKENS
-    ),
-    allowedCommands: (() => {
-      const list = ensureArrayOfStrings(parsed.allowedCommands);
-      return list.length ? Array.from(new Set(list)) : [...DEFAULT_ALLOWED_COMMANDS];
-    })(),
-    compactTokenThreshold: normalizePositiveInteger(
-      parsed.compactTokenThreshold,
-      DEFAULT_COMPACT_TOKEN_THRESHOLD
-    ),
-    mcpToolTimeout: normalizePositiveInteger(
-      parsed.mcpToolTimeout,
-      DEFAULT_MCP_TOOL_TIMEOUT_MS
-    ),
-    outputMaxLength: normalizePositiveInteger(
-      parsed.outputMaxLength,
-      DEFAULT_OUTPUT_MAX_LENGTH
-    ),
-    executionTimeout: normalizePositiveInteger(
-      parsed.executionTimeout,
-      DEFAULT_EXECUTION_TIMEOUT
-    ),
-    serviceBootWindow: normalizePositiveInteger(
-      parsed.serviceBootWindow,
-      DEFAULT_SERVICE_BOOT_WINDOW
-    ),
-    largeFileLineThreshold: normalizePositiveInteger(
-      parsed.largeFileLineThreshold,
-      DEFAULT_LARGE_FILE_LINE_THRESHOLD
-    )
-  };
-
-  settings.toolOutputTokenLimit = settings.maxToolTokens;
-
-  return {
-    settingsPath,
-    settings,
-    created: ensureResult.createdFiles.includes(FILE_NAMES.settings)
-  };
-};
-
-module.exports = {
-  ConfigError,
-  loadEndpointConfig,
-  getDefaultConfigPath,
-  promoteEndpointInConfig,
-  loadSettings,
-  ensureConfigFiles,
-  getConfigPath,
-  DEFAULT_ALLOWED_COMMANDS,
-  DEFAULT_TOOL_RESPONSE_MAX_TOKENS,
-  DEFAULT_COMPACT_TOKEN_THRESHOLD,
-  COMPACT_SUMMARY_PROMPT
-};
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const CONFIG_DIR = path.join(os.homedir(), '.mini');
+const FILE_NAMES = {
+  chat: 'chat.json',
+  commit: 'commit.json',
+  mcp: 'mcp.json',
+  settings: 'settings.json',
+  worktree: 'worktree.json',
+  mini: 'MINI.md'
+};
+
+const DEFAULT_ALLOWED_COMMANDS = [
+  'rm', 'rmdir', 'touch', 'mkdir', 'cd', 'cp', 'mv', 'node', 'npm', 'pkill', 'kill',
+  'curl', 'ls', 'pwd', 'grep', 'cat', 'echo', 'sed', 'head', 'tail', 'find', 'true',
+  'false', 'pip', 'python', 'ps', 'lsof', 'git', 'pandoc'
+];
+
+const DEFAULT_TOOL_RESPONSE_MAX_TOKENS = 65536;
+const DEFAULT_COMPACT_TOKEN_THRESHOLD = 65536;
+const DEFAULT_MCP_TOOL_TIMEOUT_MS = 10 * 60 * 1000;
+const DEFAULT_OUTPUT_MAX_LENGTH = 12000;
+const DEFAULT_EXECUTION_TIMEOUT = 300000;
+const DEFAULT_SERVICE_BOOT_WINDOW = 5000;
+const DEFAULT_LARGE_FILE_LINE_THRESHOLD = 2000;
+const COMPACT_SUMMARY_PROMPT = `请对以下对话进行总结，用于上下文压缩。请按以下格式输出：
+
+## 问题背景
+简要描述用户的原始问题和目标，包括涉及的重要文件路径。
+
+## 已完成工作
+列出已经完成的任务或环节：
+- 已搜索/阅读的文件
+- 已修改的代码
+- 已执行的操作
+- 重要的中间结果
+
+## 待继续任务
+根据对话上下文，描述接下来需要继续完成的工作：
+- 未完成的任务
+- 需要进一步处理的问题
+- 用户最后一次请求的具体内容
+
+请确保总结完整、准确，以便在压缩后能够继续完成用户的任务。`;
+const detectCommandPath = () => {
+  if (process.platform === 'win32') return 'C:/Windows/System32/wsl.exe';
+  if (process.platform === 'darwin') return '/bin/zsh';
+  return '/bin/bash';
+};
+
+const DEFAULT_CHAT_ENDPOINTS = [
+  {
+    baseUrl: 'https://generativelanguage.googleapis.com/v1beta/openai',
+    key: 'your-api-key',
+    model: 'gemini-flash-latest',
+    alias: 'Gemini Flash',
+    name: 'gemini-flash-latest',
+    think: true,
+    price: 0,
+    options: {
+      extra_body: {
+        google: {
+          thinking_config: {
+            thinking_budget: -1,
+            include_thoughts: false
+          }
+        }
+      }
+    }
+  }
+];
+
+const DEFAULT_COMMIT_MODEL = {
+  baseUrl: 'https://generativelanguage.googleapis.com/v1beta/openai',
+  key: 'your-api-key',
+  model: 'gemini-flash-latest',
+  options: {
+    reasoning_effort: 'none'
+  }
+};
+
+const DEFAULT_WORKTREE_COMMANDS = [
+  { base: 'codex', prompt: 'codex --full-auto {prompt}', resume: 'codex --full-auto resume' },
+  { base: 'claude', prompt: 'claude --permission-mode acceptEdits {prompt}', resume: 'claude --permission-mode acceptEdits --continue' },
+  { base: 'gemini', prompt: 'gemini -m pro --approval-mode=auto_edit -i {prompt}', resume: 'gemini -m pro --approval-mode=auto_edit --resume' }
+];
+
+const DEFAULT_SETTINGS = {
+  mcpServers: {},
+  tools: {},
+  commands: [],
+  maxToolTokens: DEFAULT_TOOL_RESPONSE_MAX_TOKENS,
+  compactTokenThreshold: DEFAULT_COMPACT_TOKEN_THRESHOLD,
+  allowedCommands: [...DEFAULT_ALLOWED_COMMANDS],
+  mcpToolTimeout: DEFAULT_MCP_TOOL_TIMEOUT_MS,
+  outputMaxLength: DEFAULT_OUTPUT_MAX_LENGTH,
+  executionTimeout: DEFAULT_EXECUTION_TIMEOUT,
+  serviceBootWindow: DEFAULT_SERVICE_BOOT_WINDOW,
+  largeFileLineThreshold: DEFAULT_LARGE_FILE_LINE_THRESHOLD
+};
+
+const DEFAULT_MINI_CONTENT = '# 在此填写全局系统指令。\n';
+
+class ConfigError extends Error {
+  constructor(message, configPath) {
+    super(message);
+    this.name = 'ConfigError';
+    this.configPath = configPath;
+  }
+}
+
+const isPlainObject = (value) => value && typeof value === 'object' && !Array.isArray(value);
+
+const ensureDir = (dirPath) => {
+  if (!fs.existsSync(dirPath)) {
+    fs.mkdirSync(dirPath, { recursive: true });
+  }
+};
+
+const writeJsonFile = (filePath, data) => {
+  fs.writeFileSync(filePath, `${JSON.stringify(data, null, 2)}\n`, 'utf8');
+};
+
+const ensureFile = (filePath, data) => {
+  if (fs.existsSync(filePath)) return false;
+  if (typeof data === 'string') {
+    fs.writeFileSync(filePath, data, 'utf8');
+  } else {
+    writeJsonFile(filePath, data);
+  }
+  return true;
+};
+
+const getConfigPath = (key) => path.join(CONFIG_DIR, FILE_NAMES[key]);
+const getDefaultConfigPath = () => getConfigPath('chat');
+
+const readJsonFile = (filePath, fallback = {}) => {
+  try {
+    const raw = fs.readFileSync(filePath, 'utf8');
+    if (!raw.trim()) return fallback;
+    return JSON.parse(raw);
+  } catch (_) {
+    return fallback;
+  }
+};
+
+const extractEndpointList = (parsed) => {
+  if (Array.isArray(parsed)) return parsed;
+  if (isPlainObject(parsed)) {
+    if (Array.isArray(parsed.endpoints)) return parsed.endpoints;
+    if (parsed.endpoint) return [parsed.endpoint];
+  }
+  return [];
+};
+
+const ensureConfigFiles = () => {
+  ensureDir(CONFIG_DIR);
+  const createdFiles = [];
+
+  if (ensureFile(getConfigPath('chat'), { endpoints: DEFAULT_CHAT_ENDPOINTS })) {
+    createdFiles.push(FILE_NAMES.chat);
+  }
+
+  if (ensureFile(getConfigPath('commit'), { model: DEFAULT_COMMIT_MODEL })) {
+    createdFiles.push(FILE_NAMES.commit);
+  }
+
+  if (ensureFile(getConfigPath('mcp'), { mcpServers: {} })) {
+    createdFiles.push(FILE_NAMES.mcp);
+  }
+
+  if (ensureFile(getConfigPath('settings'), DEFAULT_SETTINGS)) {
+    createdFiles.push(FILE_NAMES.settings);
+  }
+
+  if (ensureFile(getConfigPath('worktree'), { commands: DEFAULT_WORKTREE_COMMANDS })) {
+    createdFiles.push(FILE_NAMES.worktree);
+  }
+
+  if (ensureFile(getConfigPath('mini'), DEFAULT_MINI_CONTENT)) {
+    createdFiles.push(FILE_NAMES.mini);
+  }
+
+  return { configDir: CONFIG_DIR, createdFiles };
+};
+
+const normalizePositiveInteger = (value, fallback) => {
+  const numberValue = Number(value);
+  if (Number.isFinite(numberValue) && numberValue > 0) {
+    return Math.trunc(numberValue);
+  }
+  return fallback;
+};
+
+const normalizeField = (value) => (typeof value === 'string' ? value.trim() : '');
+const createEndpointSignature = (entry = {}) => {
+  const nameVal = normalizeField(entry.alias || entry.name || entry.model);
+  const pick = (key) => {
+    if (key === 'name') return nameVal.toLowerCase();
+    return normalizeField(entry[key]).toLowerCase();
+  };
+  return ['name', 'model', 'baseUrl', 'key'].map(pick).join('::');
+};
+
+const normalizeEndpoint = (raw = {}, index = 0) => {
+  if (!isPlainObject(raw)) return { endpoint: null };
+
+  const key = normalizeField(raw.key);
+  const baseUrl = normalizeField(raw.baseUrl);
+  const model = normalizeField(raw.model);
+  if (!baseUrl || !key || !model) {
+    return { endpoint: null };
+  }
+
+  const nameRaw = normalizeField(raw.alias || raw.name);
+  const name = nameRaw || model || `model_${index + 1}`;
+  const think = raw.think === true;
+  const price = Number.isFinite(Number(raw.price)) ? Number(raw.price) : 0;
+  const options = isPlainObject(raw.options) ? raw.options : undefined;
+
+  const endpoint = {
+    baseUrl,
+    key,
+    model,
+    name,
+    alias: name,
+    think,
+    price,
+    ...(options ? { options } : {})
+  };
+
+  return {
+    endpoint: {
+      ...endpoint,
+      signature: createEndpointSignature({ ...raw, ...endpoint })
+    }
+  };
+};
+
+const loadEndpointConfig = () => {
+  const ensureResult = ensureConfigFiles();
+  const configPath = getConfigPath('chat');
+  const parsed = readJsonFile(configPath, { endpoints: [] });
+  const rawList = extractEndpointList(parsed);
+
+  const endpoints = rawList
+    .map((entry, idx) => normalizeEndpoint(entry, idx).endpoint)
+    .filter(Boolean)
+    .map((endpoint, idx) => ({ ...endpoint, name: endpoint.name || endpoint.alias || endpoint.model || `model_${idx + 1}` }));
+
+  const validEndpoints = endpoints.filter((ep) => ep.key && !ep.key.toLowerCase().includes('your-api-key'));
+  if (validEndpoints.length === 0) {
+    const suffix = ensureResult.createdFiles.includes(FILE_NAMES.chat)
+      ? '已自动生成模板，请填写 baseUrl/key/model 后重新运行 mini。'
+      : '请在配置中提供至少一个有效的 baseUrl、key、model。';
+    throw new ConfigError(`${configPath} 缺少可用的模型配置。${suffix}`, configPath);
+  }
+
+  return { endpoints: validEndpoints, configPath, created: ensureResult.createdFiles.includes(FILE_NAMES.chat) };
+};
+
+const resolveEndpointCollection = (parsed) => {
+  if (Array.isArray(parsed)) {
+    return parsed;
+  }
+  if (parsed && typeof parsed === 'object' && Array.isArray(parsed.endpoints)) {
+    return parsed.endpoints;
+  }
+  return null;
+};
+
+const promoteEndpointInConfig = (configPath, signature) => {
+  if (!configPath || !signature) {
+    return false;
+  }
+  try {
+    if (!fs.existsSync(configPath)) {
+      return false;
+    }
+    const rawContent = fs.readFileSync(configPath, 'utf8') || '';
+    if (!rawContent.trim()) {
+      return false;
+    }
+    const parsed = JSON.parse(rawContent);
+    const targetList = resolveEndpointCollection(parsed);
+    if (!Array.isArray(targetList) || targetList.length <= 1) {
+      return false;
+    }
+    const matchIndex = targetList.findIndex((entry) => createEndpointSignature(entry) === signature);
+    if (matchIndex <= 0) {
+      return matchIndex === 0;
+    }
+    const [selected] = targetList.splice(matchIndex, 1);
+    targetList.unshift(selected);
+    const serialized = Array.isArray(parsed) ? targetList : { ...parsed, endpoints: targetList };
+    writeJsonFile(configPath, serialized);
+    return true;
+  } catch (error) {
+    return false;
+  }
+};
+
+const ensureArrayOfStrings = (value, fallback = []) => {
+  if (!Array.isArray(value)) {
+    return [...fallback];
+  }
+  return value.map((v) => (typeof v === 'string' ? v.trim() : '')).filter(Boolean);
+};
+
+const getAllMcpServerNames = () => {
+  const mcpPath = getConfigPath('mcp');
+  const parsed = readJsonFile(mcpPath, { mcpServers: {} });
+  const mcpServers = parsed.mcpServers && typeof parsed.mcpServers === 'object'
+    ? parsed.mcpServers
+    : {};
+  return Object.keys(mcpServers);
+};
+
+const loadSettings = ({ defaultTools = [] } = {}) => {
+  const ensureResult = ensureConfigFiles();
+  const settingsPath = getConfigPath('settings');
+  const parsed = readJsonFile(settingsPath, DEFAULT_SETTINGS);
+
+  const settings = {
+    mcps: (() => {
+      const allMcpNames = getAllMcpServerNames();
+      const mcpConfig = parsed.mcpServers;
+
+      // 只支持对象格式，默认全部启用，只有明确设置为 false 才禁用
+      if (!isPlainObject(mcpConfig)) {
+        return allMcpNames;
+      }
+
+      return allMcpNames.filter((name) => mcpConfig[name] !== false);
+    })(),
+    tools: (() => {
+      const toolConfig = parsed.tools;
+
+      // 只支持对象格式，默认全部启用，只有明确设置为 false 才禁用
+      if (!isPlainObject(toolConfig)) {
+        return ensureArrayOfStrings(defaultTools);
+      }
+
+      return defaultTools.filter((name) => toolConfig[name] !== false);
+    })(),
+    commands: ensureArrayOfStrings(parsed.commands),
+    commandPath: detectCommandPath(),
+    maxToolTokens: normalizePositiveInteger(
+      parsed.maxToolTokens,
+      DEFAULT_TOOL_RESPONSE_MAX_TOKENS
+    ),
+    allowedCommands: (() => {
+      const list = ensureArrayOfStrings(parsed.allowedCommands);
+      return list.length ? Array.from(new Set(list)) : [...DEFAULT_ALLOWED_COMMANDS];
+    })(),
+    compactTokenThreshold: normalizePositiveInteger(
+      parsed.compactTokenThreshold,
+      DEFAULT_COMPACT_TOKEN_THRESHOLD
+    ),
+    mcpToolTimeout: normalizePositiveInteger(
+      parsed.mcpToolTimeout,
+      DEFAULT_MCP_TOOL_TIMEOUT_MS
+    ),
+    outputMaxLength: normalizePositiveInteger(
+      parsed.outputMaxLength,
+      DEFAULT_OUTPUT_MAX_LENGTH
+    ),
+    executionTimeout: normalizePositiveInteger(
+      parsed.executionTimeout,
+      DEFAULT_EXECUTION_TIMEOUT
+    ),
+    serviceBootWindow: normalizePositiveInteger(
+      parsed.serviceBootWindow,
+      DEFAULT_SERVICE_BOOT_WINDOW
+    ),
+    largeFileLineThreshold: normalizePositiveInteger(
+      parsed.largeFileLineThreshold,
+      DEFAULT_LARGE_FILE_LINE_THRESHOLD
+    )
+  };
+
+  settings.toolOutputTokenLimit = settings.maxToolTokens;
+
+  return {
+    settingsPath,
+    settings,
+    created: ensureResult.createdFiles.includes(FILE_NAMES.settings)
+  };
+};
+
+module.exports = {
+  ConfigError,
+  loadEndpointConfig,
+  getDefaultConfigPath,
+  promoteEndpointInConfig,
+  loadSettings,
+  ensureConfigFiles,
+  getConfigPath,
+  DEFAULT_ALLOWED_COMMANDS,
+  DEFAULT_TOOL_RESPONSE_MAX_TOKENS,
+  DEFAULT_COMPACT_TOKEN_THRESHOLD,
+  COMPACT_SUMMARY_PROMPT
+};