autosnippet 3.3.5 → 3.3.7

package/dist/lib/core/discovery/parsers/StarlarkParser.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @module StarlarkParser
+ * @description Starlark (Python 子集) 轻量解析器 — 从 BUILD / BUILD.bazel / BUCK 文件提取构建目标信息
+ *
+ * 支持解析：
+ *  - load() 语句 → 推断语言
+ *  - 目标声明 (swift_library, cc_binary, java_library 等)
+ *  - name / deps / srcs / visibility 字段
+ *
+ * 设计策略: 正则 + 逐行状态机（不做宏展开）
+ */
+export interface StarlarkTarget {
+    rule: string;
+    name: string;
+    srcs: string[];
+    deps: string[];
+    visibility: string[];
+    testonly?: boolean;
+}
+export interface LoadStatement {
+    repository: string;
+    path: string;
+    symbols: string[];
+}
+export interface ParsedBuildFile {
+    targets: StarlarkTarget[];
+    loads: LoadStatement[];
+}
+export declare const RULE_TO_LANGUAGE: Record<string, string>;
+/**
+ * 解析单个 BUILD/BUILD.bazel/BUCK 文件内容
+ */
+export declare function parseStarlarkBuildFile(content: string): ParsedBuildFile;

package/dist/lib/core/discovery/parsers/StarlarkParser.js

@@ -0,0 +1,229 @@
+/**
+ * @module StarlarkParser
+ * @description Starlark (Python 子集) 轻量解析器 — 从 BUILD / BUILD.bazel / BUCK 文件提取构建目标信息
+ *
+ * 支持解析：
+ *  - load() 语句 → 推断语言
+ *  - 目标声明 (swift_library, cc_binary, java_library 等)
+ *  - name / deps / srcs / visibility 字段
+ *
+ * 设计策略: 正则 + 逐行状态机（不做宏展开）
+ */
+// ── 规则名 → 语言映射 ────────────────────────────────
+export const RULE_TO_LANGUAGE = {
+    // Bazel
+    swift_library: 'swift',
+    swift_binary: 'swift',
+    swift_test: 'swift',
+    cc_library: 'cpp',
+    cc_binary: 'cpp',
+    cc_test: 'cpp',
+    java_library: 'java',
+    java_binary: 'java',
+    java_test: 'java',
+    kt_jvm_library: 'kotlin',
+    kt_jvm_binary: 'kotlin',
+    py_library: 'python',
+    py_binary: 'python',
+    py_test: 'python',
+    go_library: 'go',
+    go_binary: 'go',
+    go_test: 'go',
+    rust_library: 'rust',
+    rust_binary: 'rust',
+    rust_test: 'rust',
+    ts_project: 'typescript',
+    proto_library: 'protobuf',
+    // Buck2
+    cxx_library: 'cpp',
+    cxx_binary: 'cpp',
+    cxx_test: 'cpp',
+    android_library: 'kotlin',
+    android_binary: 'kotlin',
+    apple_library: 'swift',
+    apple_binary: 'swift',
+    python_library: 'python',
+    python_binary: 'python',
+    // Pants
+    python_source: 'python',
+    python_sources: 'python',
+    docker_image: 'docker',
+};
+// ── 正则模式 ────────────────────────────────────────
+const LOAD_RE = /^load\(\s*"([^"]+)"\s*,\s*((?:"[^"]+"(?:\s*,\s*)?)+)\s*\)/;
+const RULE_CALL_RE = /^(\w+)\(\s*$/;
+const NAME_RE = /name\s*=\s*"([^"]+)"/;
+const TESTONLY_RE = /testonly\s*=\s*(True|1)/;
+const STRING_LIST_RE = (field) => new RegExp(`${field}\\s*=\\s*(?:glob\\(\\s*)?\\[([^\\]]*)\\]`, 's');
+const DEP_LABEL_RE = /"((?:\/\/[^"]*|:[^"]*))"/g;
+const GLOB_RE = /glob\(\s*\[([^\]]*)\]\s*\)/;
+// ── 公开 API ────────────────────────────────────────
+/**
+ * 解析单个 BUILD/BUILD.bazel/BUCK 文件内容
+ */
+export function parseStarlarkBuildFile(content) {
+    const result = { targets: [], loads: [] };
+    const lines = content.split('\n');
+    // Pass 1: 提取 load 语句
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith('#')) {
+            continue;
+        }
+        const loadMatch = trimmed.match(LOAD_RE);
+        if (loadMatch) {
+            const fullLabel = loadMatch[1];
+            const symbolsPart = loadMatch[2];
+            // 解析 repository 和 path
+            let repository = '';
+            let path = fullLabel;
+            if (fullLabel.startsWith('@')) {
+                const slashIdx = fullLabel.indexOf('//');
+                if (slashIdx !== -1) {
+                    repository = fullLabel.substring(0, slashIdx);
+                    path = fullLabel.substring(slashIdx);
+                }
+            }
+            const symbols = [];
+            const symRe = /"([^"]+)"/g;
+            let symMatch;
+            while ((symMatch = symRe.exec(symbolsPart)) !== null) {
+                symbols.push(symMatch[1]);
+            }
+            result.loads.push({ repository, path, symbols });
+        }
+    }
+    // Pass 2: 提取目标声明（逐行状态机）
+    let i = 0;
+    while (i < lines.length) {
+        const trimmed = lines[i].trim();
+        // 跳过注释和空行
+        if (trimmed.startsWith('#') || trimmed === '') {
+            i++;
+            continue;
+        }
+        // 检测规则调用开始: rule_name(
+        const ruleMatch = trimmed.match(RULE_CALL_RE);
+        if (ruleMatch) {
+            const rule = ruleMatch[1];
+            // 收集整个调用块直到匹配的 )
+            const blockLines = [trimmed];
+            let depth = 1;
+            let j = i + 1;
+            while (j < lines.length && depth > 0) {
+                const bLine = lines[j];
+                for (const ch of bLine) {
+                    if (ch === '(') {
+                        depth++;
+                    }
+                    if (ch === ')') {
+                        depth--;
+                    }
+                }
+                blockLines.push(bLine);
+                j++;
+            }
+            const block = blockLines.join('\n');
+            const target = parseTargetBlock(rule, block);
+            if (target) {
+                result.targets.push(target);
+            }
+            i = j;
+            continue;
+        }
+        // 也检测单行调用: rule_name(name = "...")
+        const inlineMatch = trimmed.match(/^(\w+)\(/);
+        if (inlineMatch && RULE_TO_LANGUAGE[inlineMatch[1]]) {
+            // 同样收集到闭合 )
+            const rule = inlineMatch[1];
+            const blockLines = [trimmed];
+            let depth = 0;
+            for (const ch of trimmed) {
+                if (ch === '(') {
+                    depth++;
+                }
+                if (ch === ')') {
+                    depth--;
+                }
+            }
+            let j = i + 1;
+            while (j < lines.length && depth > 0) {
+                const bLine = lines[j];
+                for (const ch of bLine) {
+                    if (ch === '(') {
+                        depth++;
+                    }
+                    if (ch === ')') {
+                        depth--;
+                    }
+                }
+                blockLines.push(bLine);
+                j++;
+            }
+            const block = blockLines.join('\n');
+            const target = parseTargetBlock(rule, block);
+            if (target) {
+                result.targets.push(target);
+            }
+            i = j;
+            continue;
+        }
+        i++;
+    }
+    return result;
+}
+// ── 内部解析函数 ────────────────────────────────────
+function parseTargetBlock(rule, block) {
+    const nameMatch = block.match(NAME_RE);
+    if (!nameMatch) {
+        return null;
+    }
+    return {
+        rule,
+        name: nameMatch[1],
+        srcs: extractStringList(block, 'srcs'),
+        deps: extractDepLabels(block),
+        visibility: extractStringList(block, 'visibility'),
+        testonly: TESTONLY_RE.test(block) ? true : undefined,
+    };
+}
+function extractStringList(block, field) {
+    const listMatch = block.match(STRING_LIST_RE(field));
+    if (!listMatch) {
+        return [];
+    }
+    let inner = listMatch[1];
+    // 处理 glob() 模式
+    const globMatch = inner.match(GLOB_RE);
+    if (globMatch) {
+        inner = globMatch[1];
+    }
+    const items = [];
+    const strRe = /"([^"]+)"/g;
+    let m;
+    while ((m = strRe.exec(inner)) !== null) {
+        items.push(m[1]);
+    }
+    return items;
+}
+function extractDepLabels(block) {
+    const depsMatch = block.match(STRING_LIST_RE('deps'));
+    if (!depsMatch) {
+        return [];
+    }
+    const inner = depsMatch[1];
+    const deps = [];
+    const re = new RegExp(DEP_LABEL_RE.source, 'g');
+    let m;
+    while ((m = re.exec(inner)) !== null) {
+        deps.push(m[1]);
+    }
+    // 也捕获非标签格式的字符串依赖
+    const strRe = /"([^"]+)"/g;
+    while ((m = strRe.exec(inner)) !== null) {
+        if (!m[1].startsWith('//') && !m[1].startsWith(':') && !deps.includes(m[1])) {
+            deps.push(m[1]);
+        }
+    }
+    return deps;
+}

package/dist/lib/core/discovery/parsers/YamlConfigParser.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @module YamlConfigParser
+ * @description YAML 配置解析器 — 从 XcodeGen project.yml 中提取项目结构信息
+ *
+ * 支持解析：
+ *  - targets（构建目标）及其依赖关系
+ *  - settings（项目级/目标级构建设置）
+ *  - schemes（构建方案）
+ *  - sources（源文件路径）
+ *
+ * 使用 js-yaml 进行安全解析（禁用危险的 YAML 特性）。
+ */
+import type { ParsedModuleSpec, ParsedProjectConfig } from './RubyDslParser.js';
+/**
+ * 解析 XcodeGen project.yml 内容
+ * 返回与 RubyDslParser 兼容的 ParsedProjectConfig
+ */
+export declare function parseXcodeGenProject(content: string): ParsedProjectConfig;
+/**
+ * 解析单个 target 为 ParsedModuleSpec 格式
+ */
+export declare function parseXcodeGenTarget(targetName: string, content: string): ParsedModuleSpec | null;
+/**
+ * 提取所有 target 的依赖图
+ * 返回 [from, to][] 形式的有向边列表
+ */
+export declare function extractXcodeGenDependencyEdges(content: string): Array<[string, string]>;
+export interface ParsedMelosProject {
+    name: string;
+    packageGlobs: string[];
+    scripts: string[];
+}
+/**
+ * 解析 melos.yaml 内容
+ * 提取项目名、包路径 glob 模式、scripts 列表
+ */
+export declare function parseMelosProject(content: string): ParsedMelosProject;

package/dist/lib/core/discovery/parsers/YamlConfigParser.js

@@ -0,0 +1,212 @@
+/**
+ * @module YamlConfigParser
+ * @description YAML 配置解析器 — 从 XcodeGen project.yml 中提取项目结构信息
+ *
+ * 支持解析：
+ *  - targets（构建目标）及其依赖关系
+ *  - settings（项目级/目标级构建设置）
+ *  - schemes（构建方案）
+ *  - sources（源文件路径）
+ *
+ * 使用 js-yaml 进行安全解析（禁用危险的 YAML 特性）。
+ */
+import yaml from 'js-yaml';
+// ── 目标类型 → 层级推断 ────────────────────────────────
+const TARGET_TYPE_LAYER = {
+    application: 'App',
+    'app-extension': 'Extension',
+    framework: 'Framework',
+    'static-library': 'Library',
+    'dynamic-library': 'Library',
+    bundle: 'Resource',
+    'unit-test': 'Test',
+    'ui-test': 'Test',
+    tool: 'Tool',
+};
+// ── 公开 API ────────────────────────────────────────
+/**
+ * 解析 XcodeGen project.yml 内容
+ * 返回与 RubyDslParser 兼容的 ParsedProjectConfig
+ */
+export function parseXcodeGenProject(content) {
+    let doc;
+    try {
+        doc = yaml.load(content, { schema: yaml.CORE_SCHEMA });
+    }
+    catch {
+        return { layers: [], globalDependencies: [] };
+    }
+    if (!doc || typeof doc !== 'object') {
+        return { layers: [], globalDependencies: [] };
+    }
+    const result = {
+        layers: [],
+        globalDependencies: [],
+    };
+    // 提取宿主应用
+    if (doc.name) {
+        result.hostApp = { name: doc.name, version: '0.0.0' };
+    }
+    if (!doc.targets) {
+        return result;
+    }
+    // 将 targets 按类型分层
+    const layerMap = new Map();
+    for (const [targetName, target] of Object.entries(doc.targets)) {
+        const targetType = target.type ?? 'framework';
+        const layerName = TARGET_TYPE_LAYER[targetType] ?? 'Other';
+        const isLocal = !isExternalTarget(targetName, doc);
+        const mod = {
+            name: targetName,
+            version: '0.0.0',
+            isLocal,
+            localPath: extractSourcePath(target),
+            group: layerName,
+        };
+        if (!layerMap.has(layerName)) {
+            layerMap.set(layerName, []);
+        }
+        layerMap.get(layerName)?.push(mod);
+    }
+    // 转为 ParsedLayer[]
+    let order = 0;
+    for (const [name, modules] of layerMap.entries()) {
+        result.layers.push({
+            name,
+            order: order++,
+            accessibleLayers: [],
+            modules,
+        });
+    }
+    // 提取 SPM packages → globalDependencies
+    if (doc.packages) {
+        for (const [pkgName, pkg] of Object.entries(doc.packages)) {
+            result.globalDependencies.push({
+                name: pkgName,
+                version: pkg.from ?? pkg.version ?? pkg.branch ?? '0.0.0',
+                isLocal: !!pkg.path,
+                localPath: pkg.path,
+            });
+        }
+    }
+    return result;
+}
+/**
+ * 解析单个 target 为 ParsedModuleSpec 格式
+ */
+export function parseXcodeGenTarget(targetName, content) {
+    let doc;
+    try {
+        doc = yaml.load(content, { schema: yaml.CORE_SCHEMA });
+    }
+    catch {
+        return null;
+    }
+    if (!doc?.targets?.[targetName]) {
+        return null;
+    }
+    const target = doc.targets[targetName];
+    return {
+        name: targetName,
+        version: '0.0.0',
+        sources: extractSourcePath(target) ?? targetName,
+        dependencies: extractTargetDependencies(target),
+        publicHeaders: [],
+        deploymentTarget: extractDeploymentTarget(target),
+    };
+}
+/**
+ * 提取所有 target 的依赖图
+ * 返回 [from, to][] 形式的有向边列表
+ */
+export function extractXcodeGenDependencyEdges(content) {
+    let doc;
+    try {
+        doc = yaml.load(content, { schema: yaml.CORE_SCHEMA });
+    }
+    catch {
+        return [];
+    }
+    if (!doc?.targets) {
+        return [];
+    }
+    const edges = [];
+    for (const [targetName, target] of Object.entries(doc.targets)) {
+        if (!target.dependencies) {
+            continue;
+        }
+        for (const dep of target.dependencies) {
+            const depName = dep.target ?? dep.framework ?? dep.package ?? dep.carthage;
+            if (depName) {
+                edges.push([targetName, depName]);
+            }
+        }
+    }
+    return edges;
+}
+// ── 内部帮助函数 ────────────────────────────────────
+function extractSourcePath(target) {
+    if (!target.sources || target.sources.length === 0) {
+        return undefined;
+    }
+    const first = target.sources[0];
+    if (typeof first === 'string') {
+        return first;
+    }
+    return first.path;
+}
+function extractTargetDependencies(target) {
+    if (!target.dependencies) {
+        return [];
+    }
+    return target.dependencies
+        .map((dep) => dep.target ?? dep.framework ?? dep.package ?? dep.carthage)
+        .filter((name) => !!name);
+}
+function extractDeploymentTarget(target) {
+    if (!target.deploymentTarget) {
+        return undefined;
+    }
+    if (typeof target.deploymentTarget === 'string') {
+        return target.deploymentTarget;
+    }
+    // Object form: { iOS: "15.0", macOS: "12.0" }
+    const values = Object.values(target.deploymentTarget);
+    return values[0];
+}
+function isExternalTarget(targetName, doc) {
+    // SPM packages referenced as targets are external
+    if (doc.packages?.[targetName]) {
+        return true;
+    }
+    // Targets defined in the project are local
+    return false;
+}
+/**
+ * 解析 melos.yaml 内容
+ * 提取项目名、包路径 glob 模式、scripts 列表
+ */
+export function parseMelosProject(content) {
+    const result = {
+        name: '',
+        packageGlobs: [],
+        scripts: [],
+    };
+    try {
+        const doc = yaml.load(content, { schema: yaml.CORE_SCHEMA });
+        if (!doc) {
+            return result;
+        }
+        result.name = doc.name ?? '';
+        if (Array.isArray(doc.packages)) {
+            result.packageGlobs = doc.packages.filter((p) => typeof p === 'string');
+        }
+        if (doc.scripts && typeof doc.scripts === 'object') {
+            result.scripts = Object.keys(doc.scripts);
+        }
+    }
+    catch {
+        // YAML 解析失败时返回空结果
+    }
+    return result;
+}

package/dist/lib/{service/bootstrap/DimensionCopyRegistry.d.ts → domain/dimension/DimensionCopy.d.ts}

@@ -7,8 +7,8 @@
  *
  * ---
  * 使用方式：
- *   import { DimensionCopy } from '../service/bootstrap/DimensionCopyRegistry.js';
- *   const copy = DimensionCopy.get('code-pattern', 'python');
+ *   import { DimensionCopy } from '#domain/dimension/DimensionCopy.js';
+ *   const copy = DimensionCopy.get('design-patterns', 'python');
  *   // → { label: '设计模式与代码惯例', guide: '装饰器/描述器/上下文管理器/生成器/ABC 抽象基类/Mixin 模式' }
  */
 export declare class DimensionCopy {

package/dist/lib/{service/bootstrap/DimensionCopyRegistry.js → domain/dimension/DimensionCopy.js}

@@ -7,10 +7,11 @@
  *
  * ---
  * 使用方式：
- *   import { DimensionCopy } from '../service/bootstrap/DimensionCopyRegistry.js';
- *   const copy = DimensionCopy.get('code-pattern', 'python');
+ *   import { DimensionCopy } from '#domain/dimension/DimensionCopy.js';
+ *   const copy = DimensionCopy.get('design-patterns', 'python');
  *   // → { label: '设计模式与代码惯例', guide: '装饰器/描述器/上下文管理器/生成器/ABC 抽象基类/Mixin 模式' }
  */
+import { getDimension } from './DimensionRegistry.js';
 // ═══════════════════════════════════════════════════════════
 // 语言族定义
 // ═══════════════════════════════════════════════════════════
@@ -45,11 +46,7 @@ function _langFamily(lang) {
  */
 const COPY_REGISTRY = {
     // ── ① 代码规范 ──────────────────────────────────────
-    'code-standard': {
-        _default: {
-            label: '代码规范',
-            guide: '命名约定、注释风格、文件组织规范、代码格式化标准',
-        },
+    'coding-standards': {
         apple: {
             label: '代码规范',
             guide: '命名约定（类名前缀/方法签名风格/API 命名）、注释风格（语言/格式/MARK 分段）、文件组织规范',
@@ -80,11 +77,7 @@ const COPY_REGISTRY = {
         },
     },
     // ── ② 设计模式与代码惯例 ─────────────────────────────
-    'code-pattern': {
-        _default: {
-            label: '设计模式与代码惯例',
-            guide: '单例/工厂/观察者/策略/Builder 等设计模式在项目中的使用方式',
-        },
+    'design-patterns': {
         apple: {
             label: '设计模式与代码惯例',
             guide: '单例/委托/Category·Extension/工厂/Builder/观察者/Coordinator 模式、继承关系',
@@ -116,10 +109,6 @@ const COPY_REGISTRY = {
     },
     // ── ③ 架构模式 ──────────────────────────────────────
     architecture: {
-        _default: {
-            label: '架构模式',
-            guide: '分层架构、模块职责与边界、依赖图、导入约束规则',
-        },
         apple: {
             label: '架构模式',
             guide: '分层架构（MVVM/VIPER/TCA）、Package/Target 模块边界、依赖图、import 约束规则',
@@ -149,12 +138,8 @@ const COPY_REGISTRY = {
             guide: '分层架构、Workspace/crate 边界、pub/pub(crate) 可见性、trait object 抽象层',
         },
     },
-    // ── ④ 最佳实践 ──────────────────────────────────────
-    'best-practice': {
-        _default: {
-            label: '最佳实践',
-            guide: '错误处理、并发安全、资源管理、日志规范、测试模式',
-        },
+    // ── ④ 错误韧性 ──────────────────────────────────────
+    'error-resilience': {
         apple: {
             label: '最佳实践',
             guide: '错误处理、并发安全（Swift Concurrency/GCD）、内存管理（ARC/weak/unowned）、日志规范、XCTest 模式',
@@ -184,12 +169,8 @@ const COPY_REGISTRY = {
             guide: '错误处理（Result/? 操作符/thiserror）、并发安全（Send+Sync/Arc/Mutex）、生命周期管理、日志（tracing）、#[test] 模式',
         },
     },
-    // ── ⑤ 事件与数据流 ─────────────────────────────────
-    'event-and-data-flow': {
-        _default: {
-            label: '事件与数据流',
-            guide: '事件传播机制、状态管理模式、数据流向追踪',
-        },
+    // ── ⑤ 数据与事件流 ─────────────────────────────────
+    'data-event-flow': {
         apple: {
             label: '事件与数据流',
             guide: '事件传播（Delegate/Notification/Block·Closure/Target-Action）、数据状态管理（KVO/属性观察/Combine/SwiftUI State）',
@@ -219,47 +200,8 @@ const COPY_REGISTRY = {
             guide: '事件传播（tokio channel/crossbeam-channel）、Stream trait、Actor 模式（Actix）、状态管理（Arc<RwLock<T>>）',
         },
     },
-    // ── ⑥ 项目特征 ──────────────────────────────────────
-    'project-profile': {
-        _default: {
-            label: '项目特征',
-            guide: '技术栈、目录结构、三方依赖枚举与用途、基础设施服务注册表',
-        },
-        apple: {
-            label: '项目特征',
-            guide: '技术栈、目录结构、三方依赖枚举与用途、Extension/Category 分类聚合、自定义基类层级与全局定义（宏/typealias/PCH）、系统事件 hook 与生命周期入口、基础设施服务注册表、Runtime 与语言互操作',
-        },
-        js: {
-            label: '项目特征',
-            guide: '技术栈（框架/构建工具/包管理器）、目录结构、三方依赖枚举与用途、monorepo 配置、环境变量与配置注入、CI/CD 管线',
-        },
-        jvm: {
-            label: '项目特征',
-            guide: '技术栈（Spring/Android/Ktor）、module 结构、三方依赖枚举与用途、构建配置（Gradle/Maven）、Profile 环境管理、基础设施服务',
-        },
-        python: {
-            label: '项目特征',
-            guide: '技术栈（Django/FastAPI/Flask）、包结构、三方依赖枚举与用途、pyproject.toml/setup.cfg 配置、虚拟环境管理',
-        },
-        go: {
-            label: '项目特征',
-            guide: '技术栈、module 结构、go.mod 依赖枚举与用途、internal 包组织、build tags、Makefile 构建',
-        },
-        dart: {
-            label: '项目特征',
-            guide: '技术栈（Flutter/Dart Server/CLI）、目录结构（lib/src 分层）、pubspec.yaml 依赖枚举与用途、平台通道（MethodChannel/FFI）、Flavors/多环境配置',
-        },
-        rust: {
-            label: '项目特征',
-            guide: '技术栈、Workspace/crate 结构、Cargo.toml 依赖枚举与用途、feature flags、#[cfg] 条件编译',
-        },
-    },
-    // ── ⑦ Agent 开发注意事项 ─────────────────────────────
+    // ── ⑥ Agent 开发注意事项 ─────────────────────────────
     'agent-guidelines': {
-        _default: {
-            label: 'Agent 开发注意事项',
-            guide: '三大核心原则（严谨性/深度特征挖掘/完整性）、命名强制、并发安全、资源管理、已废弃 API 标记、架构约束注释、TODO/FIXME',
-        },
         apple: {
             label: 'Agent 开发注意事项',
             guide: '三大核心原则（严谨性/深度特征挖掘/完整性）、命名强制、线程安全、内存约束、已废弃 API 标记、架构约束注释、TODO/FIXME',
@@ -302,11 +244,19 @@ export class DimensionCopy {
      */
     static get(dimId, lang) {
         const entry = COPY_REGISTRY[dimId];
-        if (!entry) {
-            return null;
+        if (entry) {
+            const family = _langFamily(lang);
+            const match = entry[family] || entry[lang];
+            if (match) {
+                return match;
+            }
+        }
+        // 回退到 Registry 元数据（消除 _default 双源）
+        const dim = getDimension(dimId);
+        if (dim) {
+            return { label: dim.label, guide: dim.extractionGuide };
         }
-        const family = _langFamily(lang);
-        return entry[family] || entry[lang] || entry._default || null;
+        return null;
     }
     /**
      * 批量为维度数组注入语言差异化文案（单语言版本）