autosnippet 3.0.1 → 3.0.2

package/lib/shared/LanguageService.js

@@ -0,0 +1,399 @@
+/**
+ * @module LanguageService
+ * @description 统一语言服务 — 项目中唯一的语言映射与检测来源
+ *
+ * 所有文件扩展名→语言映射、扩展名→显示名、主语言推断都必须通过此服务。
+ * 禁止在业务代码中自建 langMap / _inferLang。
+ *
+ * ---
+ * 使用方式：
+ *   import { LanguageService } from '../shared/LanguageService.js';
+ *   const lang = LanguageService.inferLang('App.swift');      // 'swift'
+ *   const display = LanguageService.displayName('swift');       // 'Swift'
+ *   const primary = LanguageService.detectPrimary(langStats);   // 'typescript'
+ */
+
+// ═══════════════════════════════════════════════════════════
+// 1) 文件扩展名 → 规范化语言 ID
+// ═══════════════════════════════════════════════════════════
+
+/** @type {Readonly<Record<string, string>>} */
+const EXT_TO_LANG = Object.freeze({
+  // Apple
+  '.swift': 'swift',
+  '.m': 'objectivec',
+  '.mm': 'objectivec',
+  '.h': 'objectivec', // C/ObjC 头文件默认归 objectivec
+
+  // C/C++
+  '.c': 'c',
+  '.cpp': 'cpp',
+  '.cc': 'cpp',
+  '.cxx': 'cpp',
+  '.hpp': 'cpp',
+
+  // JavaScript/TypeScript
+  '.js': 'javascript',
+  '.mjs': 'javascript',
+  '.cjs': 'javascript',
+  '.jsx': 'javascript',
+  '.ts': 'typescript',
+  '.tsx': 'typescript',
+  '.vue': 'javascript',
+  '.svelte': 'javascript',
+
+  // Python
+  '.py': 'python',
+
+  // JVM
+  '.java': 'java',
+  '.kt': 'kotlin',
+  '.kts': 'kotlin',
+
+  // Go / Rust / Ruby
+  '.go': 'go',
+  '.rs': 'rust',
+  '.rb': 'ruby',
+
+  // Dart / C#
+  '.dart': 'dart',
+  '.cs': 'csharp',
+
+  // Markup / Data (常用)
+  '.md': 'markdown',
+  '.json': 'json',
+  '.yaml': 'yaml',
+  '.yml': 'yaml',
+  '.toml': 'toml',
+  '.xml': 'xml',
+  '.plist': 'plist',
+});
+
+// ═══════════════════════════════════════════════════════════
+// 2) 裸扩展名（不带 dot）→ 规范化语言 ID
+//    用于 langStats（bootstrap 按 extname('.').replace('.','') 做 key）
+// ═══════════════════════════════════════════════════════════
+
+/** @type {Readonly<Record<string, string>>} */
+const BARE_EXT_TO_LANG = Object.freeze({
+  swift: 'swift',
+  m: 'objectivec',
+  mm: 'objectivec',
+  h: 'objectivec',
+  c: 'c',
+  cpp: 'cpp',
+  cc: 'cpp',
+  cxx: 'cpp',
+  hpp: 'cpp',
+  js: 'javascript',
+  mjs: 'javascript',
+  cjs: 'javascript',
+  jsx: 'javascript',
+  ts: 'typescript',
+  tsx: 'typescript',
+  vue: 'javascript',
+  svelte: 'javascript',
+  py: 'python',
+  java: 'java',
+  kt: 'kotlin',
+  kts: 'kotlin',
+  go: 'go',
+  rs: 'rust',
+  rb: 'ruby',
+  dart: 'dart',
+  cs: 'csharp',
+});
+
+// ═══════════════════════════════════════════════════════════
+// 3) 语言 ID → 人类可读显示名
+// ═══════════════════════════════════════════════════════════
+
+/** @type {Readonly<Record<string, string>>} */
+const LANG_DISPLAY_NAMES = Object.freeze({
+  swift: 'Swift',
+  objectivec: 'Objective-C',
+  c: 'C',
+  cpp: 'C++',
+  javascript: 'JavaScript',
+  typescript: 'TypeScript',
+  python: 'Python',
+  java: 'Java',
+  kotlin: 'Kotlin',
+  go: 'Go',
+  rust: 'Rust',
+  ruby: 'Ruby',
+  dart: 'Dart',
+  csharp: 'C#',
+  markdown: 'Markdown',
+  json: 'JSON',
+  yaml: 'YAML',
+  toml: 'TOML',
+  xml: 'XML',
+  plist: 'Property List',
+  unknown: 'Unknown',
+});
+
+// ═══════════════════════════════════════════════════════════
+// 4) 已知可分析的编程语言集合
+// ═══════════════════════════════════════════════════════════
+
+/** @type {ReadonlySet<string>} */
+const KNOWN_PROGRAMMING_LANGS = Object.freeze(
+  new Set([
+    'swift',
+    'objectivec',
+    'c',
+    'cpp',
+    'javascript',
+    'typescript',
+    'python',
+    'java',
+    'kotlin',
+    'go',
+    'rust',
+    'ruby',
+    'dart',
+    'csharp',
+  ])
+);
+
+// ═══════════════════════════════════════════════════════════
+// 5) 源代码扩展名（Guard / 文件收集时使用）
+// ═══════════════════════════════════════════════════════════
+
+/** @type {ReadonlySet<string>} */
+const SOURCE_CODE_EXTS = Object.freeze(
+  new Set([
+    '.m',
+    '.mm',
+    '.h',
+    '.swift',
+    '.c',
+    '.cpp',
+    '.cc',
+    '.cxx',
+    '.hpp',
+    '.js',
+    '.mjs',
+    '.cjs',
+    '.jsx',
+    '.ts',
+    '.tsx',
+    '.vue',
+    '.svelte',
+    '.py',
+    '.java',
+    '.kt',
+    '.kts',
+    '.go',
+    '.rs',
+    '.rb',
+    '.dart',
+    '.cs',
+  ])
+);
+
+// ═══════════════════════════════════════════════════════════
+// LanguageService — 静态单例
+// ═══════════════════════════════════════════════════════════
+
+export class LanguageService {
+  // ─── 文件名 → 语言 ────────────────────────────
+
+  /**
+   * 从文件名（或路径）推断规范化语言 ID
+   * @param {string} filename
+   * @returns {string} 语言 ID，如 'swift', 'typescript', 'python', 'unknown'
+   */
+  static inferLang(filename) {
+    const dot = filename.lastIndexOf('.');
+    if (dot === -1) {
+      return 'unknown';
+    }
+    const ext = filename.slice(dot).toLowerCase();
+    return EXT_TO_LANG[ext] || 'unknown';
+  }
+
+  /**
+   * 从文件扩展名（带 dot）推断语言
+   * @param {string} ext - 如 '.ts', '.py'
+   * @returns {string}
+   */
+  static langFromExt(ext) {
+    return EXT_TO_LANG[ext.toLowerCase()] || 'unknown';
+  }
+
+  // ─── 显示名 ────────────────────────────────────
+
+  /**
+   * 语言 ID → 人类可读名称
+   * @param {string} langId
+   * @returns {string}
+   */
+  static displayName(langId) {
+    return LANG_DISPLAY_NAMES[langId] || langId;
+  }
+
+  /**
+   * 文件扩展名（带 dot）→ 人类可读语言名
+   * @param {string} ext - 如 '.swift', '.ts'
+   * @returns {string}
+   */
+  static displayNameFromExt(ext) {
+    const lang = EXT_TO_LANG[ext.toLowerCase()];
+    return lang ? LANG_DISPLAY_NAMES[lang] || lang : ext;
+  }
+
+  // ─── 主语言检测 ────────────────────────────────
+
+  /**
+   * 从文件扩展名统计推断主语言
+   * @param {Record<string, number>} langStats - key = 裸扩展名 (如 'ts', 'm', 'py')，value = 文件数
+   * @returns {string} 主语言 ID
+   */
+  static detectPrimary(langStats) {
+    if (!langStats || typeof langStats !== 'object') {
+      return 'unknown';
+    }
+    // 按规范化语言聚合计数（避免 ObjC 的 .h/.m/.mm 分散）
+    const aggregated = {};
+    for (const [ext, count] of Object.entries(langStats)) {
+      const lang = BARE_EXT_TO_LANG[ext] || ext;
+      aggregated[lang] = (aggregated[lang] || 0) + count;
+    }
+    let best = 'unknown',
+      bestCount = 0;
+    for (const [lang, count] of Object.entries(aggregated)) {
+      if (count > bestCount && KNOWN_PROGRAMMING_LANGS.has(lang)) {
+        best = lang;
+        bestCount = count;
+      }
+    }
+    return best;
+  }
+
+  /**
+   * 从文件扩展名统计返回所有检测到的编程语言（按文件数降序）
+   * @param {Record<string, number>} langStats
+   * @returns {Array<{ lang: string, count: number }>}
+   */
+  static detectAll(langStats) {
+    if (!langStats || typeof langStats !== 'object') {
+      return [];
+    }
+    const aggregated = {};
+    for (const [ext, count] of Object.entries(langStats)) {
+      const lang = BARE_EXT_TO_LANG[ext] || ext;
+      aggregated[lang] = (aggregated[lang] || 0) + count;
+    }
+    return Object.entries(aggregated)
+      .filter(([lang]) => KNOWN_PROGRAMMING_LANGS.has(lang))
+      .sort((a, b) => b[1] - a[1])
+      .map(([lang, count]) => ({ lang, count }));
+  }
+
+  /**
+   * 多语言项目画像 — 返回主语言 + 次要语言 + 完整排序列表
+   *
+   * 与 detectPrimary 的区别:
+   *   - detectPrimary 只给出一个语言，适用于需要单值场景
+   *   - detectProfile 给出完整画像，适用于维度文案、AI prompt 等需要
+   *     感知多语言的场景
+   *
+   * @param {Record<string, number>} langStats - key=裸扩展名, value=文件数
+   * @param {object} [opts]
+   * @param {number} [opts.secondaryThreshold=0.1] 次要语言文件占比阈值（≥此比例才算次要语言）
+   * @returns {{ primary: string, secondary: string[], all: Array<{lang:string, count:number, ratio:number}>, totalFiles: number, isMultiLang: boolean }}
+   */
+  static detectProfile(langStats, opts = {}) {
+    const threshold = opts.secondaryThreshold ?? 0.1;
+    const all = LanguageService.detectAll(langStats);
+    if (all.length === 0) {
+      return { primary: 'unknown', secondary: [], all: [], totalFiles: 0, isMultiLang: false };
+    }
+
+    const totalFiles = all.reduce((s, e) => s + e.count, 0);
+    const enriched = all.map((e) => ({ ...e, ratio: e.count / totalFiles }));
+    const primary = enriched[0].lang;
+    const secondary = enriched
+      .slice(1)
+      .filter((e) => e.ratio >= threshold)
+      .map((e) => e.lang);
+
+    return {
+      primary,
+      secondary,
+      all: enriched,
+      totalFiles,
+      isMultiLang: secondary.length > 0,
+    };
+  }
+
+  // ─── 查询方法 ─────────────────────────────────
+
+  /**
+   * 该语言 ID 是否是已知编程语言
+   * @param {string} langId
+   * @returns {boolean}
+   */
+  static isKnownLang(langId) {
+    return KNOWN_PROGRAMMING_LANGS.has(langId);
+  }
+
+  /**
+   * 该扩展名是否为源代码文件
+   * @param {string} ext - 带 dot，如 '.ts'
+   * @returns {boolean}
+   */
+  static isSourceExt(ext) {
+    return SOURCE_CODE_EXTS.has(ext.toLowerCase());
+  }
+
+  /**
+   * 获取所有源代码扩展名（不可变）
+   * @returns {ReadonlySet<string>}
+   */
+  static get sourceExts() {
+    return SOURCE_CODE_EXTS;
+  }
+
+  /**
+   * 获取所有已知编程语言 ID（不可变）
+   * @returns {ReadonlySet<string>}
+   */
+  static get knownLangs() {
+    return KNOWN_PROGRAMMING_LANGS;
+  }
+
+  /**
+   * 获取完整的 ext→lang 映射（不可变）
+   * @returns {Readonly<Record<string, string>>}
+   */
+  static get extToLangMap() {
+    return EXT_TO_LANG;
+  }
+
+  /**
+   * 获取完整的 bareExt→lang 映射（不可变）
+   * @returns {Readonly<Record<string, string>>}
+   */
+  static get bareExtToLangMap() {
+    return BARE_EXT_TO_LANG;
+  }
+
+  /**
+   * 根据语言 ID 返回主扩展名（带 dot）
+   * @param {string} langId - 如 'go', 'swift', 'python'
+   * @returns {string|null} - 如 '.go', '.swift', '.py'；未知返回 null
+   */
+  static extForLang(langId) {
+    if (!langId) return null;
+    const lower = langId.toLowerCase();
+    for (const [ext, lang] of Object.entries(EXT_TO_LANG)) {
+      if (lang === lower) return ext;
+    }
+    return null;
+  }
+}
+
+export default LanguageService;

package/lib/shared/PathGuard.js

@@ -26,8 +26,8 @@
  *  - 错误不静默：越界写操作抛出 PathGuardError
  */
 
-import path from 'node:path';
 import fs from 'node:fs';
+import path from 'node:path';
 
 export class PathGuardError extends Error {
   /**
@@ -41,8 +41,8 @@ export class PathGuardError extends Error {
       : `[PathGuard] 写入路径越界: "${targetPath}" 不在允许范围内。`;
     super(
       msg +
-      `\n  projectRoot: ${projectRoot}` +
-      `\n  提示: 检查 process.cwd() 或 projectRoot 配置是否正确`
+        `\n  projectRoot: ${projectRoot}` +
+        `\n  提示: 检查 process.cwd() 或 projectRoot 配置是否正确`
     );
     this.name = 'PathGuardError';
     this.targetPath = targetPath;
@@ -55,19 +55,16 @@ export class PathGuardError extends Error {
  * 注意：这是相对于 projectRoot 的前缀列表
  */
 const PROJECT_WRITE_SCOPE_PREFIXES = [
-  '.autosnippet',       // 运行时 DB、记忆、对话、信号快照
-  '.cursor',            // Cursor IDE 集成
-  '.vscode',            // VSCode 集成
-  '.github',            // Copilot instructions
+  '.autosnippet', // 运行时 DB、记忆、对话、信号快照
+  '.cursor', // Cursor IDE 集成
+  '.vscode', // VSCode 集成
+  '.github', // Copilot instructions
 ];
 
 /**
  * 项目根目录下允许直接写入的文件（非目录前缀匹配）
  */
-const PROJECT_ROOT_WRITABLE_FILES = [
-  '.gitignore',
-  '.env',
-];
+const PROJECT_ROOT_WRITABLE_FILES = ['.gitignore', '.env'];
 
 class PathGuard {
   /** @type {string|null} 项目根目录（绝对路径） */
@@ -85,8 +82,6 @@ class PathGuard {
   /** @type {boolean} 是否已配置 */
   #configured = false;
 
-  constructor() {}
-
   /**
    * 配置 PathGuard（每个进程执行一次）
    * @param {object} opts
@@ -102,7 +97,7 @@ class PathGuard {
 
     this.#projectRoot = path.resolve(projectRoot);
     this.#packageRoot = packageRoot ? path.resolve(packageRoot) : null;
-    this.#knowledgeBaseDir = knowledgeBaseDir || null;  // 延迟解析
+    this.#knowledgeBaseDir = knowledgeBaseDir || null; // 延迟解析
 
     // 默认白名单：Xcode snippets 目录、全局缓存（cache 子目录，不含整个 ~/.autosnippet）
     const HOME = process.env.HOME || process.env.USERPROFILE || '';
@@ -148,7 +143,9 @@ class PathGuard {
    * @throws {PathGuardError}
    */
   assertSafe(targetPath) {
-    if (!this.#configured) return;
+    if (!this.#configured) {
+      return;
+    }
 
     if (!targetPath || typeof targetPath !== 'string') {
       throw new PathGuardError(String(targetPath), this.#projectRoot);
@@ -157,14 +154,20 @@ class PathGuard {
     const resolved = path.resolve(targetPath);
 
     // 1. 项目目录内 — 允许
-    if (this.#isUnder(resolved, this.#projectRoot)) return;
+    if (this.#isUnder(resolved, this.#projectRoot)) {
+      return;
+    }
 
     // 2. AutoSnippet 包自身目录内（logs/ 等）— 允许
-    if (this.#packageRoot && this.#isUnder(resolved, this.#packageRoot)) return;
+    if (this.#packageRoot && this.#isUnder(resolved, this.#packageRoot)) {
+      return;
+    }
 
     // 3. 白名单目录 — 允许
     for (const allowed of this.#allowList) {
-      if (this.#isUnder(resolved, allowed)) return;
+      if (this.#isUnder(resolved, allowed)) {
+        return;
+      }
     }
 
     // 越界
@@ -179,7 +182,9 @@ class PathGuard {
    * @throws {PathGuardError}
    */
   assertProjectWriteSafe(targetPath) {
-    if (!this.#configured) return;
+    if (!this.#configured) {
+      return;
+    }
 
     // 先做边界检查
     this.assertSafe(targetPath);
@@ -187,7 +192,9 @@ class PathGuard {
     const resolved = path.resolve(targetPath);
 
     // 如果不在 projectRoot 内（在白名单/packageRoot 中），跳过项目内检查
-    if (!this.#isUnder(resolved, this.#projectRoot)) return;
+    if (!this.#isUnder(resolved, this.#projectRoot)) {
+      return;
+    }
 
     // 计算相对于 projectRoot 的路径
     const relative = path.relative(this.#projectRoot, resolved);
@@ -195,21 +202,27 @@ class PathGuard {
 
     // 检查是否在允许的前缀中
     for (const prefix of PROJECT_WRITE_SCOPE_PREFIXES) {
-      if (firstSegment === prefix) return;
+      if (firstSegment === prefix) {
+        return;
+      }
     }
 
     // 检查知识库目录（动态解析）
     const kbDir = this.#resolveKnowledgeBaseDir();
-    if (kbDir && firstSegment === kbDir) return;
+    if (kbDir && firstSegment === kbDir) {
+      return;
+    }
 
     // 检查根目录可写文件（如 .gitignore）
-    if (PROJECT_ROOT_WRITABLE_FILES.includes(relative)) return;
+    if (PROJECT_ROOT_WRITABLE_FILES.includes(relative)) {
+      return;
+    }
 
     // 不在允许的写入范围内
     throw new PathGuardError(
       resolved,
       this.#projectRoot,
-      `项目内写入范围受限: "${relative}" 不在允许的目录中（允许: ${[...PROJECT_WRITE_SCOPE_PREFIXES, kbDir || 'AutoSnippet'].join(', ')}）`,
+      `项目内写入范围受限: "${relative}" 不在允许的目录中（允许: ${[...PROJECT_WRITE_SCOPE_PREFIXES, kbDir || 'AutoSnippet'].join(', ')}）`
     );
   }
 
@@ -280,7 +293,9 @@ class PathGuard {
    * 优先使用 configure 阶段传入的值，否则尝试运行时探测
    */
   #resolveKnowledgeBaseDir() {
-    if (this.#knowledgeBaseDir) return this.#knowledgeBaseDir;
+    if (this.#knowledgeBaseDir) {
+      return this.#knowledgeBaseDir;
+    }
 
     // 运行时探测: 查找包含 AutoSnippet.boxspec.json 的子目录
     try {
@@ -293,7 +308,9 @@ class PathGuard {
           }
         }
       }
-    } catch { /* ignore */ }
+    } catch {
+      /* ignore */
+    }
 
     // 默认
     return 'AutoSnippet';
@@ -303,8 +320,8 @@ class PathGuard {
 /**
  * 延迟加载 fs（避免循环依赖）
  */
-function await_fs() {
-  // eslint-disable-next-line no-eval
+function _await_fs() {
+  // biome-ignore lint/security/noGlobalEval: intentional CJS require fallback for avoiding circular deps
   return eval("require('fs')");
 }
 

package/lib/shared/RecipeReadinessChecker.js

@@ -7,7 +7,18 @@
  * @returns {{ ready: boolean, missing: string[], suggestions: string[] }}
  */
 
-const STANDARD_CATEGORIES = ['View', 'Service', 'Tool', 'Model', 'Network', 'Storage', 'UI', 'Utility'];
+import { LanguageService } from './LanguageService.js';
+
+const STANDARD_CATEGORIES = [
+  'View',
+  'Service',
+  'Tool',
+  'Model',
+  'Network',
+  'Storage',
+  'UI',
+  'Utility',
+];
 
 /**
  * Bootstrap 等特殊来源使用的 category 白名单 —— 这些 category
@@ -28,12 +39,49 @@ export function checkRecipeReadiness(item) {
   const missing = [];
   const suggestions = [];
 
-  // ── 必填 ──
+  // ── 核心必填 ──
+  if (!item.title || !String(item.title).trim()) {
+    missing.push('title');
+    suggestions.push('title 必须非空（中文简短标题 ≤20 字）');
+  }
+
+  // content 有效性（pattern/markdown/rationale 至少有实质内容）
+  const hasCode = !!(item.code || item.content?.pattern || item.content?.markdown);
+  if (!hasCode) {
+    missing.push('content');
+    suggestions.push('content 需包含 pattern 或 markdown（代码片段或正文）');
+  }
+
+  if (!item.content?.rationale && !item.rationale) {
+    missing.push('rationale');
+    suggestions.push('content.rationale 必须提供设计原理说明');
+  }
+
+  if (!item.language) {
+    missing.push('language');
+    suggestions.push('language 必须指定（如 swift/typescript/python/java/go 等）');
+  }
+
+  if (!item.kind) {
+    missing.push('kind');
+    suggestions.push('kind 必须为 rule/pattern/fact');
+  }
+
+  if (!item.doClause) {
+    missing.push('doClause');
+    suggestions.push('doClause 需为英文祈使句正向指令（≤60 tokens）');
+  }
+
   if (!item.category) {
     missing.push('category');
-    suggestions.push('category 必须为: ' + STANDARD_CATEGORIES.join('/'));
-  } else if (!STANDARD_CATEGORIES.includes(item.category) && !WHITELISTED_CATEGORIES.includes(item.category)) {
-    suggestions.push(`category "${item.category}" 非标准值，应为: ${STANDARD_CATEGORIES.join('/')}（bootstrap/knowledge 等特殊来源可忽略此建议）`);
+    suggestions.push(`category 必须为: ${STANDARD_CATEGORIES.join('/')}`);
+  } else if (
+    !STANDARD_CATEGORIES.includes(item.category) &&
+    !WHITELISTED_CATEGORIES.includes(item.category)
+  ) {
+    suggestions.push(
+      `category "${item.category}" 非标准值，应为: ${STANDARD_CATEGORIES.join('/')}（bootstrap/knowledge 等特殊来源可忽略此建议）`
+    );
   }
 
   if (!item.trigger) {
@@ -49,12 +97,11 @@ export function checkRecipeReadiness(item) {
     suggestions.push('请提供描述（≤100字）');
   }
 
-  if (!Array.isArray(item.headers) || item.headers.length === 0) {
+  if (!Array.isArray(item.headers)) {
     missing.push('headers');
-    suggestions.push('请提供完整 import 语句数组，如 ["#import <Module/Header.h>"]');
+    suggestions.push('请提供完整 import 语句数组，无 import 时传 []');
   }
 
-  // ── 建议 ──
   if (!item.usageGuide) {
     missing.push('usageGuide');
     suggestions.push('请提供使用指南（Markdown ### 章节格式）');
@@ -62,15 +109,28 @@ export function checkRecipeReadiness(item) {
 
   if (!item.knowledgeType) {
     missing.push('knowledgeType');
+    suggestions.push('knowledgeType 必须指定（如 code-pattern/architecture/best-practice）');
   }
 
-  if (!item.rationale) {
-    missing.push('rationale');
+  // reasoning 检查
+  if (!item.reasoning || typeof item.reasoning !== 'object') {
+    missing.push('reasoning');
+    suggestions.push('reasoning 必须包含 whyStandard + sources + confidence');
+  } else {
+    if (!item.reasoning.whyStandard?.trim()) {
+      missing.push('reasoning.whyStandard');
+    }
+    if (!Array.isArray(item.reasoning.sources) || item.reasoning.sources.length === 0) {
+      missing.push('reasoning.sources');
+    }
   }
 
   const lang = item.language?.toLowerCase();
-  if (lang && lang !== 'swift' && lang !== 'objectivec' && lang !== 'objc' && lang !== 'markdown') {
-    suggestions.push(`language "${item.language}" — Recipe 一般为 swift/objectivec/markdown`);
+  // 使用 LanguageService 统一语言集，额外接受 'objc' 别名和 'markdown'
+  if (lang && !LanguageService.isKnownLang(lang) && lang !== 'objc' && lang !== 'markdown') {
+    suggestions.push(
+      `language "${item.language}" — 请使用标准语言标识 (swift/typescript/python/java/kotlin 等)`
+    );
   }
 
   return { ready: missing.length === 0, missing, suggestions };