@ww_nero/mini-cli 1.0.62 → 1.0.63

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ww_nero/mini-cli",
-  "version": "1.0.62",
+  "version": "1.0.63",
   "description": "极简的 AI 命令行助手",
   "bin": {
     "mini": "bin/mini.js"

package/src/config.js

@@ -1,376 +1,401 @@
-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_MAX_TOOL_TOKENS = 65536;
-const DEFAULT_COMPACT_TOKEN_THRESHOLD = 65536;
-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_MAX_TOOL_TOKENS,
-  compactTokenThreshold: DEFAULT_COMPACT_TOKEN_THRESHOLD,
-  allowedCommands: [...DEFAULT_ALLOWED_COMMANDS],
-  worktrees: 2
-};
-
-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_MAX_TOOL_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
-    ),
-    worktrees: normalizePositiveInteger(
-      parsed.worktrees,
-      DEFAULT_SETTINGS.worktrees
-    )
-  };
-
-  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_MAX_TOOL_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 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
+};

package/src/tools/bash.js

@@ -2,10 +2,6 @@ const { spawn } = require('child_process');
 const { resolveWorkspacePath } = require('../utils/helpers');
 const { DEFAULT_ALLOWED_COMMANDS } = require('../config');
 
-const OUTPUT_MAX_LENGTH = 12000;
-const EXECUTION_TIMEOUT = 300000;
-const SERVICE_RETURN_DELAY = 5000;
-
 // Git 只读命令白名单
 const GIT_READONLY_COMMANDS = ['show', 'diff', 'log', 'status', 'branch', 'tag', 'ls-files', 'ls-tree', 'rev-parse', 'reflog', 'blame', 'shortlog', 'describe', 'config --get', 'config --list', 'remote', 'ls-remote', 'fetch --dry-run', 'grep'];
 
@@ -86,6 +82,10 @@ const executeCommand = async ({ command, workingDirectory = '.', isService = fal
   const allowedCommands = Array.isArray(context.allowedCommands) && context.allowedCommands.length > 0
     ? context.allowedCommands
     : DEFAULT_ALLOWED_COMMANDS;
+
+  const outputMaxLength = context.outputMaxLength || 12000;
+  const executionTimeout = context.executionTimeout || 300000;
+  const serviceBootWindow = context.serviceBootWindow || 5000;
   const commands = splitShellCommands(normalizedCommand);
   if (commands.length === 0) {
     return '未找到有效的命令';
@@ -129,15 +129,15 @@ const executeCommand = async ({ command, workingDirectory = '.', isService = fal
 
     child.stdout.on('data', (data) => {
       stdout += data.toString();
-      if (stdout.length > OUTPUT_MAX_LENGTH) {
-        stdout = stdout.slice(0, OUTPUT_MAX_LENGTH);
+      if (stdout.length > outputMaxLength) {
+        stdout = stdout.slice(0, outputMaxLength);
       }
     });
 
     child.stderr.on('data', (data) => {
       stderr += data.toString();
-      if (stderr.length > OUTPUT_MAX_LENGTH) {
-        stderr = stderr.slice(0, OUTPUT_MAX_LENGTH);
+      if (stderr.length > outputMaxLength) {
+        stderr = stderr.slice(0, outputMaxLength);
       }
     });
 
@@ -169,8 +169,8 @@ const executeCommand = async ({ command, workingDirectory = '.', isService = fal
         const stdOutput = stdout.trim();
         const errOutput = stderr.trim();
         const captured = stdOutput || errOutput ? `\n当前输出:\n${stdOutput}${errOutput ? `\n错误:\n${errOutput}` : ''}` : '\n暂无输出';
-        resolve(`已等待 ${SERVICE_RETURN_DELAY / 1000}s，命令已在后台持续运行（PID: ${child.pid}）。${captured}`);
-      }, SERVICE_RETURN_DELAY);
+        resolve(`已等待 ${serviceBootWindow / 1000}s，命令已在后台持续运行（PID: ${child.pid}）。${captured}`);
+      }, serviceBootWindow);
 
       const serviceErrorHandler = (error) => {
         clearTimeout(timer);
@@ -190,8 +190,8 @@ const executeCommand = async ({ command, workingDirectory = '.', isService = fal
         if (settled) return;
         child.kill('SIGTERM');
         cleanup();
-        resolve('命令执行超时 (超过 300s)');
-      }, EXECUTION_TIMEOUT);
+        resolve(`命令执行超时 (超过 ${executionTimeout / 1000}s)`);
+      }, executionTimeout);
     }
   });
 };

package/src/tools/index.js

@@ -15,7 +15,15 @@ const createToolRuntime = async (workspaceRoot, options = {}) => {
   const enabledMcps = Array.isArray(settings.mcps) ? settings.mcps : [];
   const allowedCommands = settings.allowedCommands;
 
-  const context = { workspaceRoot, allowedCommands, ...options };
+  const context = {
+    workspaceRoot,
+    allowedCommands,
+    outputMaxLength: settings.outputMaxLength,
+    executionTimeout: settings.executionTimeout,
+    serviceBootWindow: settings.serviceBootWindow,
+    largeFileLineThreshold: settings.largeFileLineThreshold,
+    ...options
+  };
 
   const tools = [];
   const handlers = {};
@@ -35,7 +43,9 @@ const createToolRuntime = async (workspaceRoot, options = {}) => {
 
   TOOL_MODULES.forEach(registerTool);
 
-  const mcpManager = await createMcpManager(workspaceRoot, enabledMcps);
+  const mcpManager = await createMcpManager(workspaceRoot, enabledMcps, {
+    mcpToolTimeout: settings.mcpToolTimeout
+  });
   let mcpConfigPath = null;
   const mcpToolNames = new Set(); // 记录所有 MCP 工具名称
   const enabledMcpNames = []; // 记录启用的 MCP 服务器名称

package/src/tools/mcp.js

@@ -305,9 +305,10 @@ const formatMcpContent = (content) => {
 };
 
 class McpManager {
-  constructor(workspaceRoot, allowedMcpNames = null) {
+  constructor(workspaceRoot, allowedMcpNames = null, options = {}) {
     this.workspaceRoot = workspaceRoot;
     this.allowedMcpNames = Array.isArray(allowedMcpNames) ? allowedMcpNames : null;
+    this.mcpToolTimeout = options.mcpToolTimeout || 600000;
     this.clients = [];
   }
 
@@ -407,7 +408,7 @@ class McpManager {
               },
               undefined,
               {
-                timeout: 600000 // 10 分钟超时
+                timeout: this.mcpToolTimeout
               }
             );
             const isError = Boolean(result && result.isError);
@@ -460,11 +461,11 @@ class McpManager {
   }
 }
 
-const createMcpManager = async (workspaceRoot, allowedMcpNames = null) => {
+const createMcpManager = async (workspaceRoot, allowedMcpNames = null, options = {}) => {
   if (Array.isArray(allowedMcpNames) && allowedMcpNames.length === 0) {
     return null;
   }
-  const manager = new McpManager(workspaceRoot, allowedMcpNames);
+  const manager = new McpManager(workspaceRoot, allowedMcpNames, options);
   await manager.initialize();
   const tools = manager.getTools();
   if (!tools || tools.length === 0) {