@lark-apaas/openclaw-scripts-diagnose-cli 0.1.18-alpha.4 → 0.1.18-alpha.6

package/dist/index.cjs

@@ -52,7 +52,7 @@ node_assert = __toESM(node_assert);
 * it terse and parseable.
 */
 function getVersion() {
-	return "0.1.18-alpha.4";
+	return "0.1.18-alpha.6";
 }
 //#endregion
 //#region src/rule-engine/base.ts
@@ -3448,24 +3448,36 @@ function compareCalVer(a, b) {
 	return semver.default.compare(coerceCalVer(a), coerceCalVer(b));
 }
 /**
-* Infer the effective upper bound for a compat entry that has no explicit maxOpenclawVersion.
+* 该条目的有效上界——开区间（EXCLUSIVE）：openclaw ≥ 此值即不兼容。
+* undefined = 最高档，无上界。
 *
-* Scans toward higher plugin versions (lower indices in the descending table) and returns
-* the first entry whose minOpenclawVersion differs from the current entry's.
-* That minOpenclawVersion becomes an EXCLUSIVE upper bound — the openclaw version that
-* starts a new incompatible range.
+* 上界一律为开区间，两种来源：
+*   - 有显式 maxOpenclawVersion → 直接用它（它本身就是「首个不兼容的 openclaw 版本」）。
+*   - 无显式 max → 向更高插件版本（表降序，index 更小）扫描，取首个「严格更高 min」的
+*     minOpenclawVersion，即下一不兼容区间的起点。
 *
-* Returns undefined for the topmost entry (no upper bound).
+* 只接受严格更高的 min（跳过相同 min 的同档；跳过更低 min 防止非单调表产生空区间
+* [min, max) 把本条目永久判为不兼容）。
 */
 function inferEffectiveMax(index) {
 	const cur = VERSION_COMPAT_MAP[index];
-	if (cur.maxOpenclawVersion != null) return {
-		max: cur.maxOpenclawVersion,
-		exclusive: false
-	};
-	for (let i = index - 1; i >= 0; i--) if (compareCalVer(VERSION_COMPAT_MAP[i].minOpenclawVersion, cur.minOpenclawVersion) > 0) return {
-		max: VERSION_COMPAT_MAP[i].minOpenclawVersion,
-		exclusive: true
+	if (cur.maxOpenclawVersion != null) return cur.maxOpenclawVersion;
+	for (let i = index - 1; i >= 0; i--) if (compareCalVer(VERSION_COMPAT_MAP[i].minOpenclawVersion, cur.minOpenclawVersion) > 0) return VERSION_COMPAT_MAP[i].minOpenclawVersion;
+}
+/**
+* 单一真相源：floor 匹配 + 有效上界，得到某插件版本的半开兼容区间 [min, max)（含命中条目）。
+* evaluateVersionRange / findClosestEntry / effectiveCompatRange 全部基于它，
+* 避免 floor 匹配与 inferEffectiveMax 在多处重复。max 一律为开区间上界（EXCLUSIVE）；
+* 最高档 max 为 undefined（无上界）。undefined = 版本比全表都旧（无 floor 条目）。
+*/
+function resolveRange(pluginVersion) {
+	const index = VERSION_COMPAT_MAP.findIndex((e) => compareCalVer(e.openclawLarkVersion, pluginVersion) <= 0);
+	if (index === -1) return void 0;
+	const entry = VERSION_COMPAT_MAP[index];
+	return {
+		entry,
+		min: entry.minOpenclawVersion,
+		max: inferEffectiveMax(index)
 	};
 }
 /**
@@ -3475,38 +3487,33 @@ function inferEffectiveMax(index) {
 *
 * - index === -1（插件版本比全表都旧，无 floor 条目）→ 无区间可判，视为插件过旧 → 'lark'
 * - oc < entry.minOpenclawVersion → 'openclaw'
-* - oc ≥ 推断/显式上界 → 'lark'
+* - oc ≥ 有效上界（开区间）→ 'lark'
 * - 否则兼容
 *
-* 上界语义：显式 maxOpenclawVersion 为 INCLUSIVE；推断上界为 EXCLUSIVE。
+* 区间统一为半开 [min, max)：min 闭、max 开（显式与推断上界一律 EXCLUSIVE）。
 */
 function evaluateVersionRange(pluginVersion, openclawVersion) {
-	const index = VERSION_COMPAT_MAP.findIndex((e) => compareCalVer(e.openclawLarkVersion, pluginVersion) <= 0);
-	if (index === -1) return {
+	const r = resolveRange(pluginVersion);
+	if (!r) return {
 		compatible: false,
 		direction: "lark",
 		entry: void 0
 	};
-	const entry = VERSION_COMPAT_MAP[index];
 	const oc = coerceCalVer(openclawVersion);
-	if (semver.default.lt(oc, coerceCalVer(entry.minOpenclawVersion))) return {
+	if (semver.default.lt(oc, coerceCalVer(r.min))) return {
 		compatible: false,
 		direction: "openclaw",
-		entry
+		entry: r.entry
+	};
+	if (r.max !== void 0 && semver.default.gte(oc, coerceCalVer(r.max))) return {
+		compatible: false,
+		direction: "lark",
+		entry: r.entry
 	};
-	const maxInfo = inferEffectiveMax(index);
-	if (maxInfo) {
-		const max = coerceCalVer(maxInfo.max);
-		if (maxInfo.exclusive ? !semver.default.lt(oc, max) : semver.default.gt(oc, max)) return {
-			compatible: false,
-			direction: "lark",
-			entry
-		};
-	}
 	return {
 		compatible: true,
 		direction: null,
-		entry
+		entry: r.entry
 	};
 }
 /**
@@ -3522,15 +3529,16 @@ function evaluateVersionRange(pluginVersion, openclawVersion) {
 /** fork 对标的官方 openclaw-lark 版本（与 VERSION_COMPAT_MAP 强耦合，故留在此处）。 */
 const FORK_LARK_PLUGIN_PINNED_VERSION = "2026.4.1";
 /**
-* Floor match: find the entry with the largest openclawLarkVersion that is
-* ≤ pluginVersion ("closest lower-or-equal version").
-*
-* The table is sorted descending, so the first entry whose version ≤
-* pluginVersion is the answer. Returns undefined only when pluginVersion
-* is older than every entry in the table.
+* 返回某插件版本（floor 匹配后）的有效兼容区间 [min, max)，含 evaluateVersionRange 所用的
+* （显式或推断的）开区间上界——区别于仅暴露显式 maxOpenclawVersion 的 findClosestEntry。
+* undefined = 版本比全表都旧（无 floor 条目）。
 */
-function findClosestEntry(pluginVersion) {
-	return VERSION_COMPAT_MAP.find((e) => compareCalVer(e.openclawLarkVersion, pluginVersion) <= 0);
+function effectiveCompatRange(pluginVersion) {
+	const r = resolveRange(pluginVersion);
+	return r ? {
+		min: r.min,
+		max: r.max
+	} : void 0;
 }
 /** "@scope/name" → "name"；无 scope 原样返回。 */
 function extractBaseName(name) {
@@ -3701,12 +3709,19 @@ function isLegacyPlugin(p) {
 function buildCompatPrefix(installed, ocCur, isLegacy) {
 	const desc = describePlugin(installed);
 	if (isLegacy) return `检测到已弃用的旧包 ${desc}（包名 "${installed.allowName}" 已停止维护，需替换为 "openclaw-lark"）`;
-	return `飞书插件 ${desc} 与当前 openclaw@${ocCur} 不兼容（${describeCompatConstraint(installed.version ? findClosestEntry(installed.version) : void 0, installed.version)}）`;
+	return `飞书插件 ${desc} 与当前 openclaw@${ocCur} 不兼容（${describeCompatConstraint(installed.version)}）`;
 }
-function describeCompatConstraint(entry, pluginVersion) {
-	if (!entry) return `插件版本 ${pluginVersion ?? "未知"} 不在版本兼容表中`;
-	if (entry.maxOpenclawVersion) return `该插件版本要求 openclaw ∈ [${entry.minOpenclawVersion}, ${entry.maxOpenclawVersion}]`;
-	return `该插件版本要求 openclaw ≥ ${entry.minOpenclawVersion}`;
+/**
+* 兼容区间文案，体现上下界（半开 [min, max)：下界闭、上界开）。用 effectiveCompatRange
+* 取「含推断/显式开区间上界」的区间，避免无显式 maxOpenclawVersion 的条目漏掉上限。
+*   有上界 → openclaw ∈ [min, max)
+*   最高档无上界 → openclaw ≥ min
+*/
+function describeCompatConstraint(pluginVersion) {
+	if (!pluginVersion) return `插件版本未知，不在版本兼容表中`;
+	const range = effectiveCompatRange(pluginVersion);
+	if (!range) return `插件版本 ${pluginVersion} 不在版本兼容表中`;
+	return range.max === void 0 ? `该插件版本要求 openclaw ≥ ${range.min}` : `该插件版本要求 openclaw ∈ [${range.min}, ${range.max})`;
 }
 function describePlugin(p) {
 	return (p.fullName ?? p.allowName) + (p.version ? `@${p.version}` : "");
@@ -5536,7 +5551,8 @@ async function installExtension(tag, ossFileMap, opts = {}) {
 			configPath: opts.configPath ?? node_path.default.join(homeBase, DEFAULT_CONFIG_REL),
 			workspaceDir: node_path.default.join(homeBase, "workspace", "agent"),
 			ossFileMap,
-			downloadOpts: opts
+			downloadOpts: opts,
+			backupBaseDir: opts.backupBaseDir
 		})) {
 			targets = targets.filter((p) => p.name !== LARK_PLUGIN_NAME);
 			if (targets.length === 0) {
@@ -5671,12 +5687,12 @@ async function installLarkPluginWithCompatCheck(opts) {
 		return false;
 	}
 	const compatResult = checkPluginCompat(pkg.packageName, pkg.version, ocCur);
-	const compatible = compatResult.resolvedVersion ? compatResult.compatible : true;
+	const compatible = compatResult.compatible;
 	console.error(`[install-extension] ${pkg.packageName ?? pkg.name}@${pkg.version ?? "unknown"} (compat-as ${compatResult.resolvedVersion ?? "unknown"}) vs openclaw@${ocCur}: ${compatible}`);
 	if (compatible) return false;
 	console.error(`[install-extension] openclaw-lark@${pkg.version} incompatible with openclaw@${ocCur} — using openclaw-lark-tools update`);
 	const log = (msg) => console.error(`[install-extension] ${msg}`);
-	const backupDir = node_path.default.join(homeBase, `.openclaw-lark-backup-${tag}`);
+	const backupDir = node_path.default.join(opts.backupBaseDir ?? "/tmp/openclaw-diagnose", `openclaw-lark-backup-${tag}-${Date.now()}`);
 	const backupOk = backupFeishuPlugins({
 		workspaceDir,
 		configPath,
@@ -10859,10 +10875,10 @@ async function runDoctor(rawCtx, opts) {
 			continue;
 		}
 		if (rule.meta.repairMode !== "standard") {
-			console.error(`rule ${key}: validate -> failed (no auto-repair, repairMode=${rule.meta.repairMode}) durationMs=${Date.now() - tValidate} message=${v1.message ?? ""}`);
+			console.error(`rule ${key}: validate -> failed, no auto-repair (repairMode=${rule.meta.repairMode}) -> skipped durationMs=${Date.now() - tValidate} message=${v1.message ?? ""}`);
 			results.push({
 				rule: key,
-				status: "failed",
+				status: "skipped",
 				message: v1.message,
 				action: v1.action
 			});
@@ -11220,7 +11236,7 @@ async function reportCliRun(opts) {
 //#region src/help.ts
 const BIN = "mclaw-diagnose";
 function versionBanner() {
-	return `v0.1.18-alpha.4`;
+	return `v0.1.18-alpha.6`;
 }
 const COMMANDS = [
 	{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/openclaw-scripts-diagnose-cli",
-  "version": "0.1.18-alpha.4",
+  "version": "0.1.18-alpha.6",
   "description": "CLI for OpenClaw config diagnose and repair with JSON5 support",
   "main": "dist/index.cjs",
   "bin": {