/**
 * 版本兼容映射表条目
 */
interface VersionCompatEntry {
    /** 插件版本 */
    pluginVersion: string;
    /** 兼容的最低 openclaw 版本 */
    minOpenclawVersion: string;
    /** 兼容的最高 openclaw 版本（可选，不填则无上限） */
    maxOpenclawVersion?: string;
}
/**
 * 版本解析结果
 */
export interface VersionResolution {
    /** 解析出的插件版本，null 表示使用最新版（不指定版本） */
    version: string | null;
    /** 解析原因 */
    reason: 'exact' | 'compat' | 'check-failed' | 'no-match';
    /** 描述信息 */
    message: string;
}
/**
 * 版本兼容映射表
 *
 * 根据用户本地的 openclaw 版本，自动匹配应安装的插件版本。
 *
 * ┌─ 映射规则 ────────────────────────────────────────────┐
 * │ openclaw >= 2026.3.22  →  安装插件 2026.3.24           │
 * │ openclaw <  2026.3.22  →  安装插件 2026.3.20           │
 * └───────────────────────────────────────────────────────┘
 *
 * ┌─ 如何新增条目 ────────────────────────────────────────┐
 * │ 1. 在数组首位插入新条目（保持版本降序）                   │
 * │ 2. 填写 pluginVersion 和 minOpenclawVersion            │
 * │ 3. 为上一条补充 maxOpenclawVersion 以划定版本边界        │
 * └───────────────────────────────────────────────────────┘
 */
export declare const VERSION_MAP: VersionCompatEntry[];
/**
 * 检测本地安装的 openclaw 版本
 * @returns 版本号字符串（如 "2026.3.22"），检测失败返回 null
 */
export declare function detectOpenclawVersion(): string | null;
/**
 * 根据本地 openclaw 版本，解析应安装的插件版本
 *
 * ┌─ 解析流程 ────────────────────────────────────────────┐
 * │ 1. 用户通过 --version 手动指定 → 直接采用              │
 * │ 2. 自动检测本地 openclaw 版本                          │
 * │    检测失败 → 回退到最新插件版本并输出警告              │
 * │ 3. 按映射表从新到旧逐条匹配 (min <= openclaw <= max)    │
 * │ 4. openclaw 高于所有条目上限 → 回退到最新插件版本        │
 * │ 5. openclaw 低于最低要求 → 提示用户升级                 │
 * └───────────────────────────────────────────────────────┘
 *
 * @param userSpecifiedVersion 用户通过 --version 指定的版本，undefined 表示未指定
 */
export declare function resolvePluginVersion(userSpecifiedVersion?: string): VersionResolution;
export {};
//# sourceMappingURL=version.d.ts.map