@ww_nero/mini-cli 1.0.81 → 1.0.82

package/src/utils/settings.js

@@ -1,77 +1,77 @@
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-
-const MINI_DIR_NAME = '.mini';
-const SETTINGS_FILE_NAME = 'settings.json';
-const DEFAULT_TOOL_OUTPUT_TOKEN_LIMIT = 32768;
-
-const ensureArrayOfStrings = (value, fallback = []) => {
-  if (!Array.isArray(value)) {
-    return [...fallback];
-  }
-  return value.map(String).filter(Boolean);
-};
-
-const loadSettings = ({ defaultTools = [] } = {}) => {
-  const settingsPath = path.join(os.homedir(), MINI_DIR_NAME, SETTINGS_FILE_NAME);
-  const dir = path.dirname(settingsPath);
-
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
-  }
-
-  const defaultSettings = {
-    mcps: [],
-    tools: [...defaultTools],
-    toolOutputTokenLimit: DEFAULT_TOOL_OUTPUT_TOKEN_LIMIT
-  };
-
-  let parsed = null;
-  let created = false;
-  let needsUpdate = false;
-
-  if (!fs.existsSync(settingsPath)) {
-    fs.writeFileSync(settingsPath, `${JSON.stringify(defaultSettings, null, 2)}\n`, 'utf8');
-    parsed = defaultSettings;
-    created = true;
-  } else {
-    try {
-      const raw = fs.readFileSync(settingsPath, 'utf8') || '{}';
-      parsed = JSON.parse(raw);
-
-      if (typeof parsed.toolOutputTokenLimit !== 'number') {
-        parsed.toolOutputTokenLimit = DEFAULT_TOOL_OUTPUT_TOKEN_LIMIT;
-        needsUpdate = true;
-      }
-    } catch (error) {
-      parsed = defaultSettings;
-    }
-  }
-
-  const settings = {
-    mcps: ensureArrayOfStrings(parsed.mcps, defaultSettings.mcps),
-    tools: ensureArrayOfStrings(parsed.tools, defaultSettings.tools),
-    toolOutputTokenLimit: typeof parsed.toolOutputTokenLimit === 'number' && parsed.toolOutputTokenLimit > 0
-      ? parsed.toolOutputTokenLimit
-      : DEFAULT_TOOL_OUTPUT_TOKEN_LIMIT
-  };
-
-  if (needsUpdate) {
-    try {
-      fs.writeFileSync(settingsPath, `${JSON.stringify(parsed, null, 2)}\n`, 'utf8');
-    } catch (error) {
-    }
-  }
-
-  return {
-    settingsPath,
-    settings,
-    created
-  };
-};
-
-module.exports = {
-  loadSettings,
-  DEFAULT_TOOL_OUTPUT_TOKEN_LIMIT
-};
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const MINI_DIR_NAME = '.mini';
+const SETTINGS_FILE_NAME = 'settings.json';
+const DEFAULT_TOOL_OUTPUT_TOKEN_LIMIT = 32768;
+
+const ensureArrayOfStrings = (value, fallback = []) => {
+  if (!Array.isArray(value)) {
+    return [...fallback];
+  }
+  return value.map(String).filter(Boolean);
+};
+
+const loadSettings = ({ defaultTools = [] } = {}) => {
+  const settingsPath = path.join(os.homedir(), MINI_DIR_NAME, SETTINGS_FILE_NAME);
+  const dir = path.dirname(settingsPath);
+
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+
+  const defaultSettings = {
+    mcps: [],
+    tools: [...defaultTools],
+    toolOutputTokenLimit: DEFAULT_TOOL_OUTPUT_TOKEN_LIMIT
+  };
+
+  let parsed = null;
+  let created = false;
+  let needsUpdate = false;
+
+  if (!fs.existsSync(settingsPath)) {
+    fs.writeFileSync(settingsPath, `${JSON.stringify(defaultSettings, null, 2)}\n`, 'utf8');
+    parsed = defaultSettings;
+    created = true;
+  } else {
+    try {
+      const raw = fs.readFileSync(settingsPath, 'utf8') || '{}';
+      parsed = JSON.parse(raw);
+
+      if (typeof parsed.toolOutputTokenLimit !== 'number') {
+        parsed.toolOutputTokenLimit = DEFAULT_TOOL_OUTPUT_TOKEN_LIMIT;
+        needsUpdate = true;
+      }
+    } catch (error) {
+      parsed = defaultSettings;
+    }
+  }
+
+  const settings = {
+    mcps: ensureArrayOfStrings(parsed.mcps, defaultSettings.mcps),
+    tools: ensureArrayOfStrings(parsed.tools, defaultSettings.tools),
+    toolOutputTokenLimit: typeof parsed.toolOutputTokenLimit === 'number' && parsed.toolOutputTokenLimit > 0
+      ? parsed.toolOutputTokenLimit
+      : DEFAULT_TOOL_OUTPUT_TOKEN_LIMIT
+  };
+
+  if (needsUpdate) {
+    try {
+      fs.writeFileSync(settingsPath, `${JSON.stringify(parsed, null, 2)}\n`, 'utf8');
+    } catch (error) {
+    }
+  }
+
+  return {
+    settingsPath,
+    settings,
+    created
+  };
+};
+
+module.exports = {
+  loadSettings,
+  DEFAULT_TOOL_OUTPUT_TOKEN_LIMIT
+};

package/src/utils/skills.js

@@ -1,250 +1,250 @@
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-
-const MINI_DIR_NAME = '.mini';
-const SKILLS_DIR_NAME = 'skills';
-const SKILL_ENTRY_FILE = 'SKILL.md';
-const MAX_DESCRIPTION_LENGTH = 160;
-
-const getSkillsRoot = () => path.join(os.homedir(), MINI_DIR_NAME, SKILLS_DIR_NAME);
-
-const toDisplayPath = (targetPath = '') => {
-  const absolutePath = path.resolve(String(targetPath || ''));
-  const homePath = path.resolve(os.homedir());
-  const relativePath = path.relative(homePath, absolutePath);
-
-  if (relativePath === '') {
-    return '~';
-  }
-
-  if (!relativePath.startsWith('..') && !path.isAbsolute(relativePath)) {
-    return `~/${relativePath.split(path.sep).join('/')}`;
-  }
-
-  return absolutePath;
-};
-
-const isPathInside = (basePath, targetPath) => {
-  const relativePath = path.relative(path.resolve(basePath), path.resolve(targetPath));
-  return relativePath === '' || (!relativePath.startsWith('..') && !path.isAbsolute(relativePath));
-};
-
-const trimDescription = (text = '') => {
-  const normalized = String(text || '').replace(/\s+/g, ' ').trim();
-  if (!normalized) {
-    return '';
-  }
-  if (normalized.length <= MAX_DESCRIPTION_LENGTH) {
-    return normalized;
-  }
-  return `${normalized.slice(0, MAX_DESCRIPTION_LENGTH)}...`;
-};
-
-const extractDescription = (content = '') => {
-  const normalized = String(content || '').replace(/\r/g, '');
-  if (!normalized.trim()) {
-    return '';
-  }
-
-  const taggedPattern = /^\s*(?:description|desc|简介|说明)\s*[:：]\s*(.+)$/im;
-  const taggedMatch = normalized.match(taggedPattern);
-  if (taggedMatch && taggedMatch[1]) {
-    return trimDescription(taggedMatch[1]);
-  }
-
-  const lines = normalized.split('\n');
-  let inCodeBlock = false;
-
-  for (const rawLine of lines) {
-    const line = rawLine.trim();
-
-    if (line.startsWith('```')) {
-      inCodeBlock = !inCodeBlock;
-      continue;
-    }
-
-    if (!line || inCodeBlock) {
-      continue;
-    }
-
-    if (
-      line.startsWith('#')
-      || line.startsWith('-')
-      || line.startsWith('*')
-      || line.startsWith('>')
-      || /^\d+[.)]\s/.test(line)
-    ) {
-      continue;
-    }
-
-    return trimDescription(line);
-  }
-
-  return '';
-};
-
-const discoverSkills = () => {
-  const skillsRoot = getSkillsRoot();
-
-  if (!fs.existsSync(skillsRoot)) {
-    return {
-      skillsRoot,
-      skills: []
-    };
-  }
-
-  let entries = [];
-
-  try {
-    entries = fs.readdirSync(skillsRoot, { withFileTypes: true });
-  } catch (error) {
-    return {
-      skillsRoot,
-      skills: [],
-      error: `读取 skills 目录失败：${error.message}`
-    };
-  }
-
-  const skills = entries
-    .filter((entry) => entry && entry.isDirectory() && !entry.name.startsWith('.'))
-    .map((entry) => {
-      const skillDirPath = path.join(skillsRoot, entry.name);
-      const entryFilePath = path.join(skillDirPath, SKILL_ENTRY_FILE);
-
-      if (!fs.existsSync(entryFilePath)) {
-        return null;
-      }
-
-      let description = '';
-      try {
-        const content = fs.readFileSync(entryFilePath, 'utf8');
-        description = extractDescription(content);
-      } catch (_) {
-        description = '';
-      }
-
-      return {
-        name: entry.name,
-        description,
-        dirPath: skillDirPath,
-        entryFilePath
-      };
-    })
-    .filter(Boolean)
-    .sort((left, right) => left.name.localeCompare(right.name));
-
-  return {
-    skillsRoot,
-    skills
-  };
-};
-
-const resolveSkillDirectory = (skillsRoot, skillName) => {
-  if (typeof skillName !== 'string' || !skillName.trim()) {
-    throw new Error('skillName 参数不能为空');
-  }
-
-  const normalizedName = skillName.trim();
-  const skillDirPath = path.resolve(skillsRoot, normalizedName);
-
-  if (!isPathInside(skillsRoot, skillDirPath)) {
-    throw new Error('skillName 非法，不能超出 skills 目录');
-  }
-
-  if (path.resolve(path.dirname(skillDirPath)) !== path.resolve(skillsRoot)) {
-    throw new Error('skillName 必须是 skills 目录下的直接子目录名');
-  }
-
-  if (!fs.existsSync(skillDirPath) || !fs.statSync(skillDirPath).isDirectory()) {
-    throw new Error(`skill 不存在: ${normalizedName}`);
-  }
-
-  return {
-    skillName: normalizedName,
-    skillDirPath
-  };
-};
-
-const resolveSkillFilePath = (skillDirPath, filePath = SKILL_ENTRY_FILE) => {
-  const normalizedFilePath = typeof filePath === 'string' && filePath.trim()
-    ? filePath.trim()
-    : SKILL_ENTRY_FILE;
-
-  if (path.isAbsolute(normalizedFilePath)) {
-    throw new Error('filePath 必须是相对于 skill 目录的路径');
-  }
-
-  const absoluteFilePath = path.resolve(skillDirPath, normalizedFilePath);
-
-  if (!isPathInside(skillDirPath, absoluteFilePath)) {
-    throw new Error('filePath 非法，不能超出 skill 目录');
-  }
-
-  if (!fs.existsSync(absoluteFilePath) || !fs.statSync(absoluteFilePath).isFile()) {
-    throw new Error(`文件不存在: ${normalizedFilePath}`);
-  }
-
-  const relativeFilePath = path.relative(skillDirPath, absoluteFilePath).split(path.sep).join('/');
-
-  return {
-    absoluteFilePath,
-    relativeFilePath
-  };
-};
-
-const readSkillFile = ({ skillName, filePath } = {}) => {
-  const skillsRoot = getSkillsRoot();
-  if (!fs.existsSync(skillsRoot)) {
-    throw new Error(`skills 目录不存在: ${toDisplayPath(skillsRoot)}`);
-  }
-
-  const { skillName: normalizedSkillName, skillDirPath } = resolveSkillDirectory(skillsRoot, skillName);
-  const { absoluteFilePath, relativeFilePath } = resolveSkillFilePath(skillDirPath, filePath);
-  const content = fs.readFileSync(absoluteFilePath, 'utf8');
-
-  return {
-    skillsRoot,
-    skillName: normalizedSkillName,
-    skillDirPath,
-    filePath: relativeFilePath,
-    absoluteFilePath,
-    content
-  };
-};
-
-const buildSkillsSystemPrompt = (snapshot = {}) => {
-  const skills = Array.isArray(snapshot.skills) ? snapshot.skills : [];
-  if (skills.length === 0) {
-    return '';
-  }
-
-  const lines = [
-    '<skills>',
-    `skills 目录: ${toDisplayPath(snapshot.skillsRoot || getSkillsRoot())}`,
-    '当用户明确提到某个 skill，或任务明显匹配某个 skill 描述时，优先使用该 skill。',
-    'skill 使用流程：',
-    '1. 先调用 skills 工具读取对应 skill 的 SKILL.md。',
-    '2. 若 SKILL.md 引用其他文件，再调用 skills 工具按需读取。',
-    '3. 仅加载当前任务需要的内容，避免无关读取。',
-    '可用 skills：'
-  ];
-
-  skills.forEach((skill) => {
-    const description = skill.description || '（暂无描述）';
-    lines.push(`- ${skill.name}: ${description}`);
-  });
-
-  lines.push('</skills>');
-
-  return lines.join('\n');
-};
-
-module.exports = {
-  SKILL_ENTRY_FILE,
-  getSkillsRoot,
-  discoverSkills,
-  readSkillFile,
-  toDisplayPath,
-  buildSkillsSystemPrompt
-};
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const MINI_DIR_NAME = '.mini';
+const SKILLS_DIR_NAME = 'skills';
+const SKILL_ENTRY_FILE = 'SKILL.md';
+const MAX_DESCRIPTION_LENGTH = 160;
+
+const getSkillsRoot = () => path.join(os.homedir(), MINI_DIR_NAME, SKILLS_DIR_NAME);
+
+const toDisplayPath = (targetPath = '') => {
+  const absolutePath = path.resolve(String(targetPath || ''));
+  const homePath = path.resolve(os.homedir());
+  const relativePath = path.relative(homePath, absolutePath);
+
+  if (relativePath === '') {
+    return '~';
+  }
+
+  if (!relativePath.startsWith('..') && !path.isAbsolute(relativePath)) {
+    return `~/${relativePath.split(path.sep).join('/')}`;
+  }
+
+  return absolutePath;
+};
+
+const isPathInside = (basePath, targetPath) => {
+  const relativePath = path.relative(path.resolve(basePath), path.resolve(targetPath));
+  return relativePath === '' || (!relativePath.startsWith('..') && !path.isAbsolute(relativePath));
+};
+
+const trimDescription = (text = '') => {
+  const normalized = String(text || '').replace(/\s+/g, ' ').trim();
+  if (!normalized) {
+    return '';
+  }
+  if (normalized.length <= MAX_DESCRIPTION_LENGTH) {
+    return normalized;
+  }
+  return `${normalized.slice(0, MAX_DESCRIPTION_LENGTH)}...`;
+};
+
+const extractDescription = (content = '') => {
+  const normalized = String(content || '').replace(/\r/g, '');
+  if (!normalized.trim()) {
+    return '';
+  }
+
+  const taggedPattern = /^\s*(?:description|desc|简介|说明)\s*[:：]\s*(.+)$/im;
+  const taggedMatch = normalized.match(taggedPattern);
+  if (taggedMatch && taggedMatch[1]) {
+    return trimDescription(taggedMatch[1]);
+  }
+
+  const lines = normalized.split('\n');
+  let inCodeBlock = false;
+
+  for (const rawLine of lines) {
+    const line = rawLine.trim();
+
+    if (line.startsWith('```')) {
+      inCodeBlock = !inCodeBlock;
+      continue;
+    }
+
+    if (!line || inCodeBlock) {
+      continue;
+    }
+
+    if (
+      line.startsWith('#')
+      || line.startsWith('-')
+      || line.startsWith('*')
+      || line.startsWith('>')
+      || /^\d+[.)]\s/.test(line)
+    ) {
+      continue;
+    }
+
+    return trimDescription(line);
+  }
+
+  return '';
+};
+
+const discoverSkills = () => {
+  const skillsRoot = getSkillsRoot();
+
+  if (!fs.existsSync(skillsRoot)) {
+    return {
+      skillsRoot,
+      skills: []
+    };
+  }
+
+  let entries = [];
+
+  try {
+    entries = fs.readdirSync(skillsRoot, { withFileTypes: true });
+  } catch (error) {
+    return {
+      skillsRoot,
+      skills: [],
+      error: `读取 skills 目录失败：${error.message}`
+    };
+  }
+
+  const skills = entries
+    .filter((entry) => entry && entry.isDirectory() && !entry.name.startsWith('.'))
+    .map((entry) => {
+      const skillDirPath = path.join(skillsRoot, entry.name);
+      const entryFilePath = path.join(skillDirPath, SKILL_ENTRY_FILE);
+
+      if (!fs.existsSync(entryFilePath)) {
+        return null;
+      }
+
+      let description = '';
+      try {
+        const content = fs.readFileSync(entryFilePath, 'utf8');
+        description = extractDescription(content);
+      } catch (_) {
+        description = '';
+      }
+
+      return {
+        name: entry.name,
+        description,
+        dirPath: skillDirPath,
+        entryFilePath
+      };
+    })
+    .filter(Boolean)
+    .sort((left, right) => left.name.localeCompare(right.name));
+
+  return {
+    skillsRoot,
+    skills
+  };
+};
+
+const resolveSkillDirectory = (skillsRoot, skillName) => {
+  if (typeof skillName !== 'string' || !skillName.trim()) {
+    throw new Error('skillName 参数不能为空');
+  }
+
+  const normalizedName = skillName.trim();
+  const skillDirPath = path.resolve(skillsRoot, normalizedName);
+
+  if (!isPathInside(skillsRoot, skillDirPath)) {
+    throw new Error('skillName 非法，不能超出 skills 目录');
+  }
+
+  if (path.resolve(path.dirname(skillDirPath)) !== path.resolve(skillsRoot)) {
+    throw new Error('skillName 必须是 skills 目录下的直接子目录名');
+  }
+
+  if (!fs.existsSync(skillDirPath) || !fs.statSync(skillDirPath).isDirectory()) {
+    throw new Error(`skill 不存在: ${normalizedName}`);
+  }
+
+  return {
+    skillName: normalizedName,
+    skillDirPath
+  };
+};
+
+const resolveSkillFilePath = (skillDirPath, filePath = SKILL_ENTRY_FILE) => {
+  const normalizedFilePath = typeof filePath === 'string' && filePath.trim()
+    ? filePath.trim()
+    : SKILL_ENTRY_FILE;
+
+  if (path.isAbsolute(normalizedFilePath)) {
+    throw new Error('filePath 必须是相对于 skill 目录的路径');
+  }
+
+  const absoluteFilePath = path.resolve(skillDirPath, normalizedFilePath);
+
+  if (!isPathInside(skillDirPath, absoluteFilePath)) {
+    throw new Error('filePath 非法，不能超出 skill 目录');
+  }
+
+  if (!fs.existsSync(absoluteFilePath) || !fs.statSync(absoluteFilePath).isFile()) {
+    throw new Error(`文件不存在: ${normalizedFilePath}`);
+  }
+
+  const relativeFilePath = path.relative(skillDirPath, absoluteFilePath).split(path.sep).join('/');
+
+  return {
+    absoluteFilePath,
+    relativeFilePath
+  };
+};
+
+const readSkillFile = ({ skillName, filePath } = {}) => {
+  const skillsRoot = getSkillsRoot();
+  if (!fs.existsSync(skillsRoot)) {
+    throw new Error(`skills 目录不存在: ${toDisplayPath(skillsRoot)}`);
+  }
+
+  const { skillName: normalizedSkillName, skillDirPath } = resolveSkillDirectory(skillsRoot, skillName);
+  const { absoluteFilePath, relativeFilePath } = resolveSkillFilePath(skillDirPath, filePath);
+  const content = fs.readFileSync(absoluteFilePath, 'utf8');
+
+  return {
+    skillsRoot,
+    skillName: normalizedSkillName,
+    skillDirPath,
+    filePath: relativeFilePath,
+    absoluteFilePath,
+    content
+  };
+};
+
+const buildSkillsSystemPrompt = (snapshot = {}) => {
+  const skills = Array.isArray(snapshot.skills) ? snapshot.skills : [];
+  if (skills.length === 0) {
+    return '';
+  }
+
+  const lines = [
+    '<skills>',
+    `skills 目录: ${toDisplayPath(snapshot.skillsRoot || getSkillsRoot())}`,
+    '当用户明确提到某个 skill，或任务明显匹配某个 skill 描述时，优先使用该 skill。',
+    'skill 使用流程：',
+    '1. 先调用 skills 工具读取对应 skill 的 SKILL.md。',
+    '2. 若 SKILL.md 引用其他文件，再调用 skills 工具按需读取。',
+    '3. 仅加载当前任务需要的内容，避免无关读取。',
+    '可用 skills：'
+  ];
+
+  skills.forEach((skill) => {
+    const description = skill.description || '（暂无描述）';
+    lines.push(`- ${skill.name}: ${description}`);
+  });
+
+  lines.push('</skills>');
+
+  return lines.join('\n');
+};
+
+module.exports = {
+  SKILL_ENTRY_FILE,
+  getSkillsRoot,
+  discoverSkills,
+  readSkillFile,
+  toDisplayPath,
+  buildSkillsSystemPrompt
+};