@lark-apaas/openclaw-scripts-diagnose-cli 0.1.15-alpha.0 → 0.1.15-alpha.10

package/dist/index.cjs

@@ -52,7 +52,7 @@ node_assert = __toESM(node_assert);
 * it terse and parseable.
 */
 function getVersion() {
-	return "0.1.15-alpha.0";
+	return "0.1.15-alpha.10";
 }
 //#endregion
 //#region src/rule-engine/base.ts
@@ -1770,6 +1770,96 @@ SessionPersistenceRule = __decorate([Rule({
 	level: "silent"
 })], SessionPersistenceRule);
 //#endregion
+//#region src/rules/tools-allow-also-allow-conflict.ts
+/**
+* 检测 tools 配置中 allow 与 alsoAllow 同时非空的冲突。
+*
+* openclaw 的 Zod schema 在配置加载时会拒绝这种组合，原因是语义互斥：
+*   - allow：完全替换式白名单，只允许列出的工具
+*   - alsoAllow：追加式，在 profile 或默认基线上叠加额外工具
+* 两者同时存在会导致 openclaw 服务启动失败。
+*
+* 修复策略：将 alsoAllow 的条目去重合并进 allow，删除 alsoAllow。
+* 这是最保守的修复：保留原 allow 的精确白名单，不扩大权限范围。
+*
+* 检测范围：
+*   - 顶层 tools
+*   - tools.byProvider.*
+*   - agents.list[].tools
+*   - agents.list[].tools.byProvider.*
+*/
+let ToolsAllowAlsoAllowConflictRule = class ToolsAllowAlsoAllowConflictRule extends DiagnoseRule {
+	validate(ctx) {
+		const conflicts = [];
+		visitAllScopes(ctx.config, (scope, label) => {
+			if (hasConflict(scope)) conflicts.push(label);
+		});
+		if (conflicts.length === 0) return { pass: true };
+		return {
+			pass: false,
+			message: `tools allow 与 alsoAllow 冲突（${conflicts.length} 处）：${conflicts.join("；")}。修复方式：将 alsoAllow 合并进 allow 并删除 alsoAllow`
+		};
+	}
+	repair(ctx) {
+		visitAllScopes(ctx.config, (scope) => mergeInScope(scope));
+	}
+};
+ToolsAllowAlsoAllowConflictRule = __decorate([Rule({
+	key: "tools_allow_also_allow_conflict",
+	description: "tools 配置中 allow 与 alsoAllow 同时设置会导致 openclaw 启动失败；自动将 alsoAllow 合并进 allow（实验性）",
+	dependsOn: ["config_syntax_check"],
+	repairMode: "standard",
+	level: "critical",
+	profile: "experimental"
+})], ToolsAllowAlsoAllowConflictRule);
+/**
+* 遍历所有 tools-policy scope，对每个 scope 调用 callback。
+* validate 和 repair 共用同一套遍历逻辑，确保两者覆盖的 scope 始终一致。
+*/
+function visitAllScopes(config, cb) {
+	const topTools = asRecord(asRecord(config)?.tools);
+	if (topTools) {
+		cb(topTools, "tools");
+		const byProvider = asRecord(topTools.byProvider);
+		if (byProvider) for (const key of Object.keys(byProvider)) {
+			const scope = asRecord(byProvider[key]);
+			if (scope) cb(scope, `tools.byProvider.${key}`);
+		}
+	}
+	const agents = asRecord(asRecord(config)?.agents);
+	const list = Array.isArray(agents?.list) ? agents.list : [];
+	for (let i = 0; i < list.length; i++) {
+		const agent = asRecord(list[i]);
+		const agentId = typeof agent?.id === "string" ? agent.id : String(i);
+		const tools = asRecord(agent?.tools);
+		if (tools) {
+			cb(tools, `agents.list[${agentId}].tools`);
+			const byProvider = asRecord(tools.byProvider);
+			if (byProvider) for (const key of Object.keys(byProvider)) {
+				const scope = asRecord(byProvider[key]);
+				if (scope) cb(scope, `agents.list[${agentId}].tools.byProvider.${key}`);
+			}
+		}
+	}
+}
+/** scope 中 allow 与 alsoAllow 同时非空 */
+function hasConflict(scope) {
+	const allow = scope.allow;
+	const alsoAllow = scope.alsoAllow;
+	return Array.isArray(allow) && allow.length > 0 && Array.isArray(alsoAllow) && alsoAllow.length > 0;
+}
+/**
+* 将 alsoAllow 去重合并进 allow，删除 alsoAllow。
+* 仅保留字符串元素，过滤掉格式异常的非字符串条目，避免写入损坏配置。
+*/
+function mergeInScope(scope) {
+	if (!hasConflict(scope)) return;
+	const allow = scope.allow.filter((v) => typeof v === "string");
+	const alsoAllow = scope.alsoAllow.filter((v) => typeof v === "string");
+	scope.allow = [...new Set([...allow, ...alsoAllow])];
+	delete scope.alsoAllow;
+}
+//#endregion
 //#region src/rules/feishu-default-account.ts
 /**
 * Owns the multi-agent feishu-channel migration: turns legacy v1/v2
@@ -2520,242 +2610,581 @@ function upsertResourceConstrainedToolsBlock(content) {
 	return `${content}${content.length > 0 && !content.endsWith("\n") ? "\n\n" : "\n"}${RESOURCE_CONSTRAINED_TOOLS_BLOCK}\n`;
 }
 //#endregion
-//#region src/rules/miaoda-official-plugins-install-spec-unlock.ts
+//#region src/paths.ts
 /**
-* Official miaoda-side plugins that must track manifest — version-locked specs
-* here block upgrades. Third-party / user-installed plugins are intentionally
-* out of scope (users may pin them deliberately).
+* Central directory for all ephemeral diagnose/reset artifacts: task status
+* files (`reset-<taskId>.json`) and human-readable step logs
+* (`reset-<taskId>.log`). Having everything under one dir makes debugging a
+* stuck reset much easier — `ls /tmp/openclaw-diagnose/` shows every recent
+* run, and each run's log is right next to its state.
 */
-const OFFICIAL_PLUGIN_NAMES = new Set([
-	"openclaw-extension-miaoda",
-	"openclaw-extension-miaoda-coding",
-	"openclaw-guardian-plugin",
-	"openclaw-mem0-plugin",
-	"openclaw-lark"
-]);
-const LOCKED_NPM_SPEC = /^(@[a-z0-9][\w.-]*\/)?[a-z0-9][\w.-]*@[^@/:#\s]+$/i;
-function isLockedNpmSpec(spec) {
-	return typeof spec === "string" && LOCKED_NPM_SPEC.test(spec);
+const DIAGNOSE_DIR = "/tmp/openclaw-diagnose";
+function resetResultFile(taskId) {
+	return `${DIAGNOSE_DIR}/reset-${taskId}.json`;
 }
-function unlockSpec(spec) {
-	const slash = spec.indexOf("/");
-	const cut = slash === -1 ? spec.indexOf("@") : spec.indexOf("@", slash + 1);
-	return spec.slice(0, cut);
+function resetLogFile(taskId) {
+	return `${DIAGNOSE_DIR}/reset-${taskId}.log`;
 }
-/** Yield `[key, lockedSpec]` for every official-plugin install whose `spec` is locked. */
-function* iterLockedOfficialInstalls(config) {
-	const installs = getNestedMap(config, "plugins", "installs");
-	if (!installs) return;
-	for (const [key, entry] of Object.entries(installs)) {
-		if (!OFFICIAL_PLUGIN_NAMES.has(key)) continue;
-		const spec = asRecord(entry)?.spec;
-		if (isLockedNpmSpec(spec)) yield [key, spec];
-	}
+/** Sandbox workspace root where openclaw config + agent state lives. */
+const WORKSPACE_DIR = "/home/gem/workspace/agent";
+/** File containing the provider key used by the openclaw miaoda provider. */
+const PROVIDER_FILE_PATH = "/home/gem/workspace/.force/openclaw/miaoda-provider-key";
+/** File containing the miaoda openclaw secrets JSON. */
+const SECRETS_FILE_PATH = "/home/gem/workspace/.force/openclaw/miaoda-openclaw-secrets.json";
+/** Absolute path to the openclaw config JSON. */
+const CONFIG_PATH = `${WORKSPACE_DIR}/openclaw.json`;
+/**
+* upgrade-lark 每次运行的日志文件路径，含时间戳便于按时间排序定位。
+* checkOnly=true 时文件名含 "-check" 后缀，便于与正式安装日志区分。
+*/
+function upgradeLarkLogFile(runId, checkOnly = false) {
+	const ts = (/* @__PURE__ */ new Date()).toISOString().slice(0, 19).replace(/:/g, "-");
+	return `${DIAGNOSE_DIR}/upgrade-lark${checkOnly ? "-check" : ""}-${ts}-${runId.slice(0, 8)}.log`;
 }
-let MiaodaOfficialPluginsInstallSpecUnlockRule = class MiaodaOfficialPluginsInstallSpecUnlockRule extends DiagnoseRule {
-	validate(ctx) {
-		const locked = [...iterLockedOfficialInstalls(ctx.config)].map(([k]) => k);
-		if (locked.length === 0) return { pass: true };
-		return {
-			pass: false,
-			message: "plugins.installs 中官方插件存在锁版本的 spec: " + locked.sort().join(",")
-		};
-	}
-	repair(ctx) {
-		for (const [key, spec] of iterLockedOfficialInstalls(ctx.config)) setNestedValue(ctx.config, [
-			"plugins",
-			"installs",
-			key,
-			"spec"
-		], unlockSpec(spec));
-	}
-};
-MiaodaOfficialPluginsInstallSpecUnlockRule = __decorate([Rule({
-	key: "miaoda_official_plugins_install_spec_unlock",
-	description: "移除官方妙搭插件安装条目中的锁版本 npm spec，使其跟随最新 manifest 版本",
-	dependsOn: ["config_syntax_check"],
-	repairMode: "standard",
-	level: "silent"
-})], MiaodaOfficialPluginsInstallSpecUnlockRule);
 //#endregion
-//#region src/rules/miaoda-plugin-allow.ts
-const MIAODA_PLUGIN = "openclaw-extension-miaoda";
-let MiaodaPluginAllowRule = class MiaodaPluginAllowRule extends DiagnoseRule {
-	validate(ctx) {
-		if (!isPluginInstalledOnDisk(getExtensionsDir(ctx.configPath), MIAODA_PLUGIN)) return { pass: true };
-		if (getAllow$1(ctx.config).includes(MIAODA_PLUGIN)) return { pass: true };
-		return {
-			pass: false,
-			message: `plugins.allow 缺少 ${MIAODA_PLUGIN}（已在 extensions/ 下装但未启用）`
-		};
-	}
-	repair(ctx) {
-		if (!isPluginInstalledOnDisk(getExtensionsDir(ctx.configPath), MIAODA_PLUGIN)) return;
-		const plugins = ctx.config.plugins;
-		if (plugins == null || typeof plugins !== "object" || Array.isArray(plugins)) {
-			ctx.config.plugins = { allow: [MIAODA_PLUGIN] };
-			return;
+//#region src/lark-cli-init.ts
+const LARK_PLUGIN_NAMES$1 = ["openclaw-lark", "feishu-openclaw-plugin"];
+const PE_XML_TAG = "lark-cli-pe";
+const PE_PLACEHOLDER = `
+<${PE_XML_TAG}>
+**【强制要求 - 无例外】飞书所有操作必须先读 feishu-lark-cli skill。未读skill不得调用任何飞书工具，违者视为操作失误。**
+</${PE_XML_TAG}>
+`;
+function isLarkPluginInstalled(configPath) {
+	const extDir = getExtensionsDir(configPath);
+	return LARK_PLUGIN_NAMES$1.some((name) => {
+		try {
+			return node_fs.default.existsSync(node_path.default.join(extDir, name, "package.json"));
+		} catch {
+			return false;
 		}
-		const pluginsMap = plugins;
-		const rawAllow = pluginsMap.allow;
-		const allow = Array.isArray(rawAllow) ? rawAllow : [];
-		if (allow.includes(MIAODA_PLUGIN)) return;
-		allow.push(MIAODA_PLUGIN);
-		pluginsMap.allow = allow;
-	}
-};
-MiaodaPluginAllowRule = __decorate([Rule({
-	key: "miaoda_plugin_allow",
-	description: "当 openclaw-extension-miaoda 已在磁盘安装但未在 allow 列表中时，将其添加到 plugins.allow（实验性）",
-	dependsOn: ["config_syntax_check"],
-	repairMode: "standard",
-	level: "critical",
-	profile: "standard"
-})], MiaodaPluginAllowRule);
-function getAllow$1(config) {
-	const plugins = config.plugins;
-	if (plugins == null || typeof plugins !== "object" || Array.isArray(plugins)) return [];
-	const allow = plugins.allow;
-	if (!Array.isArray(allow)) return [];
-	return allow.filter((e) => typeof e === "string");
+	});
 }
-//#endregion
-//#region src/rules/lark-plugin-allow.ts
-const LARK_PLUGIN = "openclaw-lark";
-const LEGACY_LARK_PLUGIN = "feishu-openclaw-plugin";
-const LARK_PLUGIN_NAMES$1 = [LARK_PLUGIN, LEGACY_LARK_PLUGIN];
-let LarkPluginAllowRule = class LarkPluginAllowRule extends DiagnoseRule {
-	validate(ctx) {
-		const allow = getAllow(ctx.config);
-		if (LARK_PLUGIN_NAMES$1.some((name) => allow.includes(name))) return { pass: true };
-		const installed = detectInstalledLarkPlugin(getExtensionsDir(ctx.configPath));
-		if (installed == null) return { pass: true };
-		return {
-			pass: false,
-			message: `plugins.allow 缺少飞书插件 ${installed}（已在 extensions/ 下装但未启用）`
-		};
+function isLarkCliAvailable$2() {
+	try {
+		return (0, node_child_process.spawnSync)("lark-cli", ["--version"], {
+			encoding: "utf-8",
+			timeout: 5e3,
+			stdio: [
+				"ignore",
+				"pipe",
+				"ignore"
+			]
+		}).status === 0;
+	} catch {
+		return false;
 	}
-	repair(ctx) {
-		const installed = detectInstalledLarkPlugin(getExtensionsDir(ctx.configPath));
-		if (installed == null) return;
-		if (ctx.config.plugins == null || typeof ctx.config.plugins !== "object" || Array.isArray(ctx.config.plugins)) {
-			ctx.config.plugins = { allow: [installed] };
-			return;
-		}
-		const pluginsMap = ctx.config.plugins;
-		const rawAllow = pluginsMap.allow;
-		const original = Array.isArray(rawAllow) ? rawAllow : [];
-		const stringAllow = original.filter((e) => typeof e === "string");
-		if (LARK_PLUGIN_NAMES$1.some((name) => stringAllow.includes(name))) return;
-		original.push(installed);
-		pluginsMap.allow = original;
+}
+function readConfig(configPath) {
+	try {
+		const raw = node_fs.default.readFileSync(configPath, "utf-8");
+		const parsed = loadJSON5().parse(raw);
+		return parsed != null && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : null;
+	} catch {
+		return null;
 	}
-};
-LarkPluginAllowRule = __decorate([Rule({
-	key: "lark_plugin_allow",
-	description: "当飞书插件（openclaw-lark 或旧版名）已在磁盘安装但未加入 plugins.allow 时，自动添加",
-	dependsOn: ["config_syntax_check"],
-	repairMode: "standard",
-	level: "critical"
-})], LarkPluginAllowRule);
-function getAllow(config) {
-	const plugins = config.plugins;
-	if (plugins == null || typeof plugins !== "object" || Array.isArray(plugins)) return [];
-	const allow = plugins.allow;
-	if (!Array.isArray(allow)) return [];
-	return allow.filter((e) => typeof e === "string");
 }
 /**
-* fs-only 检测：`<extDir>/<name>/package.json` 存在即视为已装。
-* 优先级 openclaw-lark（新版）> feishu-openclaw-plugin（legacy）。
-* 不读 package.json 内容，只判存在性，避开 JSON 损坏。
+* Resolve the feishu app secret for the given appId.
+*
+* Lookup order:
+*   1. channels.feishu.appSecret  (single-agent: feishu.appId === appId)
+*   2. channels.feishu.accounts[key].appSecret  (multi-agent: account.appId === appId)
+*
+* Value interpretation:
+*   - string  → use directly
+*   - object  → secret is managed by a provider; use `feishuAppSecret` param instead
+*
+* Returns null when the secret cannot be determined.
 */
-function detectInstalledLarkPlugin(extDir) {
-	for (const name of [LARK_PLUGIN, LEGACY_LARK_PLUGIN]) if (pluginPackageJsonExists(extDir, name)) return name;
+function resolveAppSecret(appId, config, feishuAppSecret) {
+	const feishu = getNestedMap(config, "channels", "feishu");
+	if (!feishu) return null;
+	let rawSecret;
+	if (typeof feishu.appId === "string" && feishu.appId === appId) rawSecret = feishu.appSecret;
+	else {
+		const accounts = asRecord(feishu.accounts);
+		if (accounts) for (const [, val] of Object.entries(accounts)) {
+			const account = asRecord(val);
+			if (account?.appId === appId) {
+				rawSecret = account.appSecret ?? feishu.appSecret;
+				break;
+			}
+		}
+	}
+	if (typeof rawSecret === "string" && rawSecret) return rawSecret;
+	if (rawSecret != null && typeof rawSecret === "object") return feishuAppSecret ?? null;
 	return null;
 }
-function pluginPackageJsonExists(extDir, pluginDir) {
-	try {
-		return node_fs.default.existsSync(node_path.default.join(extDir, pluginDir, "package.json"));
-	} catch {
-		return false;
+/**
+* Resolve the agents.md path for the given appId from the openclaw config.
+*
+* Case 1: appId matches channels.feishu.appId (single-agent path)
+*   → WORKSPACE_DIR/AGENTS.md
+*
+* Case 2: appId found in channels.feishu.accounts (multi-agent path)
+*   → find account key where account.appId === appId
+*   → find binding where match.channel=feishu && match.accountId=that key
+*   → if agentId === 'main'  → WORKSPACE_DIR/agents.md
+*   → else find agent in agents.list by id → agent.workspace/agents.md
+*
+* Returns null when the path cannot be determined.
+*/
+function resolveAgentsMdPath(appId, config) {
+	const feishu = getNestedMap(config, "channels", "feishu");
+	if (!feishu) {
+		console.error("resolveAgentsMdPath: channels.feishu not found");
+		return null;
+	}
+	if (typeof feishu.appId === "string" && feishu.appId === appId) {
+		console.error(`resolveAgentsMdPath: case=single-agent feishu.appId=${feishu.appId}`);
+		return node_path.default.join(WORKSPACE_DIR, "workspace", "AGENTS.md");
+	}
+	const accounts = asRecord(feishu.accounts);
+	if (!accounts) {
+		console.error("resolveAgentsMdPath: feishu.accounts not found");
+		return null;
+	}
+	let accountId;
+	for (const [key, val] of Object.entries(accounts)) if (asRecord(val)?.appId === appId) {
+		accountId = key;
+		break;
+	}
+	if (!accountId) {
+		console.error(`resolveAgentsMdPath: no account found with appId=${appId} in feishu.accounts keys=[${Object.keys(accounts).join(",")}]`);
+		return null;
+	}
+	console.error(`resolveAgentsMdPath: found accountId=${accountId}`);
+	const bindings = Array.isArray(config.bindings) ? config.bindings : [];
+	let agentId;
+	for (const b of bindings) {
+		const binding = asRecord(b);
+		if (!binding) continue;
+		const match = asRecord(binding.match);
+		if (match?.channel === "feishu" && match?.accountId === accountId) {
+			if (typeof binding.agentId === "string") {
+				agentId = binding.agentId;
+				break;
+			}
+		}
+	}
+	if (!agentId) {
+		console.error(`resolveAgentsMdPath: no binding found for accountId=${accountId} in bindings(count=${bindings.length})`);
+		return null;
+	}
+	console.error(`resolveAgentsMdPath: found agentId=${agentId}`);
+	if (agentId === "main") {
+		console.error("resolveAgentsMdPath: case=multi-agent-main");
+		return node_path.default.join(WORKSPACE_DIR, "workspace", "AGENTS.md");
+	}
+	const agentsObj = asRecord(config.agents);
+	const list = Array.isArray(agentsObj?.list) ? agentsObj.list : [];
+	for (const a of list) {
+		const agent = asRecord(a);
+		if (agent?.id === agentId) {
+			const ws = typeof agent.workspace === "string" ? agent.workspace : node_path.default.join(WORKSPACE_DIR, "workspace");
+			console.error(`resolveAgentsMdPath: case=multi-agent-custom agentId=${agentId} workspace=${ws}`);
+			return node_path.default.join(ws, "AGENTS.md");
+		}
 	}
+	console.error(`resolveAgentsMdPath: agentId=${agentId} not found in agents.list(count=${list.length})`);
+	return null;
 }
-//#endregion
-//#region src/rules/old-miaoda-plugins-cleanup.ts
-const NEW_MIAODA = "openclaw-extension-miaoda";
-const OLD_PLUGIN_NAMES = Object.freeze([
-	"openclaw-feishu-greeting",
-	"openclaw-miaoda-keepalive",
-	"feishu-greeting",
-	"miaoda-keepalive"
-]);
-function getPluginMaps(config) {
-	const rawAllow = asRecord(config.plugins)?.allow;
+function appendPeToAgentsMd(agentsMdPath) {
+	const dir = node_path.default.dirname(agentsMdPath);
+	if (!node_fs.default.existsSync(dir)) node_fs.default.mkdirSync(dir, { recursive: true });
+	const existing = node_fs.default.existsSync(agentsMdPath) ? node_fs.default.readFileSync(agentsMdPath, "utf-8") : "";
+	if (existing.includes(`<lark-cli-pe>`)) {
+		console.error(`lark-cli-init: <${PE_XML_TAG}> already present in ${agentsMdPath}, skipping`);
+		return;
+	}
+	const sep = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
+	node_fs.default.appendFileSync(agentsMdPath, `${sep}${PE_PLACEHOLDER}`, "utf-8");
+	console.error(`lark-cli-init: appended PE placeholder to ${agentsMdPath}`);
+}
+/**
+* Collect every Feishu bot appId declared in the openclaw config.
+* Covers both single-agent (channels.feishu.appId) and multi-agent
+* (channels.feishu.accounts[*].appId) layouts. Returns a deduplicated list.
+*/
+function collectFeishuAppIds(configPath) {
+	const config = readConfig(configPath ?? CONFIG_PATH);
+	if (!config) return [];
+	const feishu = getNestedMap(config, "channels", "feishu");
+	if (!feishu) return [];
+	const appIds = /* @__PURE__ */ new Set();
+	const topAppId = feishu.appId;
+	if (typeof topAppId === "string" && topAppId.trim()) appIds.add(topAppId.trim());
+	const accounts = asRecord(feishu.accounts);
+	if (accounts) for (const val of Object.values(accounts)) {
+		const appId = asRecord(val)?.appId;
+		if (typeof appId === "string" && appId.trim()) appIds.add(appId.trim());
+	}
+	return [...appIds];
+}
+function runLarkCliInit(opts) {
+	const configPath = opts.configPath ?? CONFIG_PATH;
+	if (!isLarkPluginInstalled(configPath)) {
+		console.error("lark-cli-init: skipping — openclaw-lark plugin not installed");
+		return {
+			ok: true,
+			skipped: true,
+			skipReason: "openclaw-lark plugin not installed"
+		};
+	}
+	if (!isLarkCliAvailable$2()) {
+		console.error("lark-cli-init: skipping — lark-cli command not found");
+		return {
+			ok: true,
+			skipped: true,
+			skipReason: "lark-cli command not found"
+		};
+	}
+	const config = readConfig(configPath);
+	if (!config) return {
+		ok: false,
+		error: `could not read config at ${configPath}`
+	};
+	const agentsMdPath = resolveAgentsMdPath(opts.appId, config);
+	console.error(`lark-cli-init: resolved agents.md path=${agentsMdPath ?? "(null)"}`);
+	if (!agentsMdPath) return {
+		ok: false,
+		error: `could not resolve agents.md path for appId=${opts.appId}`
+	};
+	const appSecret = resolveAppSecret(opts.appId, config, opts.feishuAppSecret);
+	if (!appSecret) return {
+		ok: false,
+		error: `could not resolve appSecret for appId=${opts.appId}`
+	};
+	console.error(`lark-cli-init: running lark-cli config init --name ${opts.appId} --app-id ${opts.appId} --brand feishu --app-secret-stdin --force-init`);
+	const initRes = (0, node_child_process.spawnSync)("lark-cli", [
+		"config",
+		"init",
+		"--name",
+		opts.appId,
+		"--app-id",
+		opts.appId,
+		"--brand",
+		"feishu",
+		"--app-secret-stdin",
+		"--force-init"
+	], {
+		stdio: [
+			"pipe",
+			"pipe",
+			"pipe"
+		],
+		encoding: "utf-8",
+		input: appSecret
+	});
+	const configInitStdout = initRes.stdout?.trim() || void 0;
+	const configInitStderr = initRes.stderr?.trim() || void 0;
+	if (configInitStdout) console.error(`lark-cli config init stdout: ${configInitStdout}`);
+	if (configInitStderr) console.error(`lark-cli config init stderr: ${configInitStderr}`);
+	if (initRes.error) return {
+		ok: false,
+		configInitStdout,
+		configInitStderr,
+		error: `lark-cli config init spawn error: ${initRes.error.message}`
+	};
+	if (initRes.status !== 0) return {
+		ok: false,
+		configInitExitCode: initRes.status ?? void 0,
+		configInitStdout,
+		configInitStderr,
+		error: `lark-cli config init exited with code ${initRes.status}`
+	};
+	appendPeToAgentsMd(agentsMdPath);
 	return {
-		entries: getNestedMap(config, "plugins", "entries"),
-		installs: getNestedMap(config, "plugins", "installs"),
-		allow: Array.isArray(rawAllow) ? rawAllow : void 0
+		ok: true,
+		configInitExitCode: 0,
+		agentsMdPath
 	};
 }
-function hasNewMiaoda({ entries, installs, allow }) {
-	return asRecord(entries?.[NEW_MIAODA]) != null || asRecord(installs?.[NEW_MIAODA]) != null || (allow?.includes(NEW_MIAODA) ?? false);
-}
-function findResiduals({ entries, installs, allow }, extensionsDir) {
-	return OLD_PLUGIN_NAMES.filter((name) => entries?.[name] != null || installs?.[name] != null || (allow?.includes(name) ?? false) || node_fs.default.existsSync(node_path.default.join(extensionsDir, name)));
+//#endregion
+//#region src/rules/agents-md-lark-cli-pe.ts
+function isLarkCliAvailable$1() {
+	try {
+		return (0, node_child_process.spawnSync)("lark-cli", ["--version"], {
+			encoding: "utf-8",
+			timeout: 5e3,
+			stdio: [
+				"ignore",
+				"pipe",
+				"ignore"
+			]
+		}).status === 0;
+	} catch {
+		return false;
+	}
 }
-let OldMiaodaPluginsCleanupRule = class OldMiaodaPluginsCleanupRule extends DiagnoseRule {
+let AgentsMdLarkCliPeRule = class AgentsMdLarkCliPeRule extends DiagnoseRule {
 	validate(ctx) {
-		const maps = getPluginMaps(ctx.config);
-		if (!hasNewMiaoda(maps)) return { pass: true };
-		const residuals = findResiduals(maps, getExtensionsDir(ctx.configPath));
-		if (residuals.length === 0) return { pass: true };
+		if (!isLarkCliAvailable$1()) return { pass: true };
+		const missingPath = collectExistingAgentsMdPaths(ctx).find((filePath) => {
+			return !node_fs.default.readFileSync(filePath, "utf-8").includes(`<${PE_XML_TAG}>`);
+		});
+		if (!missingPath) return { pass: true };
 		return {
 			pass: false,
-			message: "旧 miaoda 插件残留: " + residuals.sort().join(",")
+			message: `${missingPath} 中缺少 lark-cli-pe PE 内容，需要追加`
 		};
 	}
 	repair(ctx) {
-		const maps = getPluginMaps(ctx.config);
-		if (!hasNewMiaoda(maps)) return;
-		const extensionsDir = getExtensionsDir(ctx.configPath);
-		const { entries, installs, allow } = maps;
-		const oldSet = new Set(OLD_PLUGIN_NAMES);
-		if (allow) for (let i = allow.length - 1; i >= 0; i--) {
-			const v = allow[i];
-			if (typeof v === "string" && oldSet.has(v)) allow.splice(i, 1);
-		}
-		for (const name of OLD_PLUGIN_NAMES) {
-			if (entries && name in entries) delete entries[name];
-			if (installs && name in installs) delete installs[name];
-			const target = node_path.default.join(extensionsDir, name);
-			const rel = node_path.default.relative(extensionsDir, target);
-			if (!rel || rel.startsWith("..") || node_path.default.isAbsolute(rel)) continue;
-			try {
-				node_fs.default.rmSync(target, {
-					recursive: true,
-					force: true
-				});
-			} catch (e) {
-				console.error(`[old_miaoda_plugins_cleanup] rmSync ${target} failed: ${e.message}`);
-			}
+		if (!isLarkCliAvailable$1()) return;
+		for (const filePath of collectExistingAgentsMdPaths(ctx)) {
+			const content = node_fs.default.readFileSync(filePath, "utf-8");
+			if (content.includes(`<lark-cli-pe>`)) continue;
+			const sep = content.length > 0 && !content.endsWith("\n") ? "\n" : "";
+			node_fs.default.appendFileSync(filePath, `${sep}${PE_PLACEHOLDER}`, "utf-8");
+			console.error(`agents-md-lark-cli-pe: appended PE to ${filePath}`);
 		}
 	}
 };
-OldMiaodaPluginsCleanupRule = __decorate([Rule({
-	key: "old_miaoda_plugins_cleanup",
-	description: "当新版 openclaw-extension-miaoda 已存在时，清理过时插件引用（openclaw-feishu-greeting、openclaw-miaoda-keepalive 等）",
+AgentsMdLarkCliPeRule = __decorate([Rule({
+	key: "agents_md_lark_cli_pe",
+	description: "检测各智能体 AGENTS.md 中是否缺失 lark-cli-pe PE 内容，lark-cli 存在时自动追加",
 	dependsOn: ["config_syntax_check"],
 	repairMode: "standard",
 	level: "silent"
-})], OldMiaodaPluginsCleanupRule);
+})], AgentsMdLarkCliPeRule);
 //#endregion
-//#region src/rules/builtin-plugin-missing.ts
+//#region src/rules/miaoda-official-plugins-install-spec-unlock.ts
 /**
-* install-extension --all 安装的内置扩展插件列表（manifest role=extension）。
-* 与 miaoda-official-plugins-install-spec-unlock.ts 中的 OFFICIAL_PLUGIN_NAMES 保持一致。
+* Official miaoda-side plugins that must track manifest — version-locked specs
+* here block upgrades. Third-party / user-installed plugins are intentionally
+* out of scope (users may pin them deliberately).
 */
-const BUILTIN_EXTENSION_PLUGINS = new Set([
+const OFFICIAL_PLUGIN_NAMES = new Set([
+	"openclaw-extension-miaoda",
+	"openclaw-extension-miaoda-coding",
+	"openclaw-guardian-plugin",
+	"openclaw-mem0-plugin",
+	"openclaw-lark"
+]);
+const LOCKED_NPM_SPEC = /^(@[a-z0-9][\w.-]*\/)?[a-z0-9][\w.-]*@[^@/:#\s]+$/i;
+function isLockedNpmSpec(spec) {
+	return typeof spec === "string" && LOCKED_NPM_SPEC.test(spec);
+}
+function unlockSpec(spec) {
+	const slash = spec.indexOf("/");
+	const cut = slash === -1 ? spec.indexOf("@") : spec.indexOf("@", slash + 1);
+	return spec.slice(0, cut);
+}
+/** Yield `[key, lockedSpec]` for every official-plugin install whose `spec` is locked. */
+function* iterLockedOfficialInstalls(config) {
+	const installs = getNestedMap(config, "plugins", "installs");
+	if (!installs) return;
+	for (const [key, entry] of Object.entries(installs)) {
+		if (!OFFICIAL_PLUGIN_NAMES.has(key)) continue;
+		const spec = asRecord(entry)?.spec;
+		if (isLockedNpmSpec(spec)) yield [key, spec];
+	}
+}
+let MiaodaOfficialPluginsInstallSpecUnlockRule = class MiaodaOfficialPluginsInstallSpecUnlockRule extends DiagnoseRule {
+	validate(ctx) {
+		const locked = [...iterLockedOfficialInstalls(ctx.config)].map(([k]) => k);
+		if (locked.length === 0) return { pass: true };
+		return {
+			pass: false,
+			message: "plugins.installs 中官方插件存在锁版本的 spec: " + locked.sort().join(",")
+		};
+	}
+	repair(ctx) {
+		for (const [key, spec] of iterLockedOfficialInstalls(ctx.config)) setNestedValue(ctx.config, [
+			"plugins",
+			"installs",
+			key,
+			"spec"
+		], unlockSpec(spec));
+	}
+};
+MiaodaOfficialPluginsInstallSpecUnlockRule = __decorate([Rule({
+	key: "miaoda_official_plugins_install_spec_unlock",
+	description: "移除官方妙搭插件安装条目中的锁版本 npm spec，使其跟随最新 manifest 版本",
+	dependsOn: ["config_syntax_check"],
+	repairMode: "standard",
+	level: "silent"
+})], MiaodaOfficialPluginsInstallSpecUnlockRule);
+//#endregion
+//#region src/rules/miaoda-plugin-allow.ts
+const MIAODA_PLUGIN = "openclaw-extension-miaoda";
+let MiaodaPluginAllowRule = class MiaodaPluginAllowRule extends DiagnoseRule {
+	validate(ctx) {
+		if (!isPluginInstalledOnDisk(getExtensionsDir(ctx.configPath), MIAODA_PLUGIN)) return { pass: true };
+		if (getAllow$1(ctx.config).includes(MIAODA_PLUGIN)) return { pass: true };
+		return {
+			pass: false,
+			message: `plugins.allow 缺少 ${MIAODA_PLUGIN}（已在 extensions/ 下装但未启用）`
+		};
+	}
+	repair(ctx) {
+		if (!isPluginInstalledOnDisk(getExtensionsDir(ctx.configPath), MIAODA_PLUGIN)) return;
+		const plugins = ctx.config.plugins;
+		if (plugins == null || typeof plugins !== "object" || Array.isArray(plugins)) {
+			ctx.config.plugins = { allow: [MIAODA_PLUGIN] };
+			return;
+		}
+		const pluginsMap = plugins;
+		const rawAllow = pluginsMap.allow;
+		const allow = Array.isArray(rawAllow) ? rawAllow : [];
+		if (allow.includes(MIAODA_PLUGIN)) return;
+		allow.push(MIAODA_PLUGIN);
+		pluginsMap.allow = allow;
+	}
+};
+MiaodaPluginAllowRule = __decorate([Rule({
+	key: "miaoda_plugin_allow",
+	description: "当 openclaw-extension-miaoda 已在磁盘安装但未在 allow 列表中时，将其添加到 plugins.allow（实验性）",
+	dependsOn: ["config_syntax_check"],
+	repairMode: "standard",
+	level: "critical",
+	profile: "standard"
+})], MiaodaPluginAllowRule);
+function getAllow$1(config) {
+	const plugins = config.plugins;
+	if (plugins == null || typeof plugins !== "object" || Array.isArray(plugins)) return [];
+	const allow = plugins.allow;
+	if (!Array.isArray(allow)) return [];
+	return allow.filter((e) => typeof e === "string");
+}
+//#endregion
+//#region src/rules/lark-plugin-allow.ts
+const LARK_PLUGIN = "openclaw-lark";
+const LEGACY_LARK_PLUGIN = "feishu-openclaw-plugin";
+const LARK_PLUGIN_NAMES = [LARK_PLUGIN, LEGACY_LARK_PLUGIN];
+let LarkPluginAllowRule = class LarkPluginAllowRule extends DiagnoseRule {
+	validate(ctx) {
+		const allow = getAllow(ctx.config);
+		if (LARK_PLUGIN_NAMES.some((name) => allow.includes(name))) return { pass: true };
+		const installed = detectInstalledLarkPlugin(getExtensionsDir(ctx.configPath));
+		if (installed == null) return { pass: true };
+		return {
+			pass: false,
+			message: `plugins.allow 缺少飞书插件 ${installed}（已在 extensions/ 下装但未启用）`
+		};
+	}
+	repair(ctx) {
+		const installed = detectInstalledLarkPlugin(getExtensionsDir(ctx.configPath));
+		if (installed == null) return;
+		if (ctx.config.plugins == null || typeof ctx.config.plugins !== "object" || Array.isArray(ctx.config.plugins)) {
+			ctx.config.plugins = { allow: [installed] };
+			return;
+		}
+		const pluginsMap = ctx.config.plugins;
+		const rawAllow = pluginsMap.allow;
+		const original = Array.isArray(rawAllow) ? rawAllow : [];
+		const stringAllow = original.filter((e) => typeof e === "string");
+		if (LARK_PLUGIN_NAMES.some((name) => stringAllow.includes(name))) return;
+		original.push(installed);
+		pluginsMap.allow = original;
+	}
+};
+LarkPluginAllowRule = __decorate([Rule({
+	key: "lark_plugin_allow",
+	description: "当飞书插件（openclaw-lark 或旧版名）已在磁盘安装但未加入 plugins.allow 时，自动添加",
+	dependsOn: ["config_syntax_check"],
+	repairMode: "standard",
+	level: "critical"
+})], LarkPluginAllowRule);
+function getAllow(config) {
+	const plugins = config.plugins;
+	if (plugins == null || typeof plugins !== "object" || Array.isArray(plugins)) return [];
+	const allow = plugins.allow;
+	if (!Array.isArray(allow)) return [];
+	return allow.filter((e) => typeof e === "string");
+}
+/**
+* fs-only 检测：`<extDir>/<name>/package.json` 存在即视为已装。
+* 优先级 openclaw-lark（新版）> feishu-openclaw-plugin（legacy）。
+* 不读 package.json 内容，只判存在性，避开 JSON 损坏。
+*/
+function detectInstalledLarkPlugin(extDir) {
+	for (const name of [LARK_PLUGIN, LEGACY_LARK_PLUGIN]) if (pluginPackageJsonExists(extDir, name)) return name;
+	return null;
+}
+function pluginPackageJsonExists(extDir, pluginDir) {
+	try {
+		return node_fs.default.existsSync(node_path.default.join(extDir, pluginDir, "package.json"));
+	} catch {
+		return false;
+	}
+}
+//#endregion
+//#region src/rules/old-miaoda-plugins-cleanup.ts
+const NEW_MIAODA = "openclaw-extension-miaoda";
+const OLD_PLUGIN_NAMES = Object.freeze([
+	"openclaw-feishu-greeting",
+	"openclaw-miaoda-keepalive",
+	"feishu-greeting",
+	"miaoda-keepalive"
+]);
+function getPluginMaps(config) {
+	const rawAllow = asRecord(config.plugins)?.allow;
+	return {
+		entries: getNestedMap(config, "plugins", "entries"),
+		installs: getNestedMap(config, "plugins", "installs"),
+		allow: Array.isArray(rawAllow) ? rawAllow : void 0
+	};
+}
+function hasNewMiaoda({ entries, installs, allow }) {
+	return asRecord(entries?.[NEW_MIAODA]) != null || asRecord(installs?.[NEW_MIAODA]) != null || (allow?.includes(NEW_MIAODA) ?? false);
+}
+function findResiduals({ entries, installs, allow }, extensionsDir) {
+	return OLD_PLUGIN_NAMES.filter((name) => entries?.[name] != null || installs?.[name] != null || (allow?.includes(name) ?? false) || node_fs.default.existsSync(node_path.default.join(extensionsDir, name)));
+}
+let OldMiaodaPluginsCleanupRule = class OldMiaodaPluginsCleanupRule extends DiagnoseRule {
+	validate(ctx) {
+		const maps = getPluginMaps(ctx.config);
+		if (!hasNewMiaoda(maps)) return { pass: true };
+		const residuals = findResiduals(maps, getExtensionsDir(ctx.configPath));
+		if (residuals.length === 0) return { pass: true };
+		return {
+			pass: false,
+			message: "旧 miaoda 插件残留: " + residuals.sort().join(",")
+		};
+	}
+	repair(ctx) {
+		const maps = getPluginMaps(ctx.config);
+		if (!hasNewMiaoda(maps)) return;
+		const extensionsDir = getExtensionsDir(ctx.configPath);
+		const { entries, installs, allow } = maps;
+		const oldSet = new Set(OLD_PLUGIN_NAMES);
+		if (allow) for (let i = allow.length - 1; i >= 0; i--) {
+			const v = allow[i];
+			if (typeof v === "string" && oldSet.has(v)) allow.splice(i, 1);
+		}
+		for (const name of OLD_PLUGIN_NAMES) {
+			if (entries && name in entries) delete entries[name];
+			if (installs && name in installs) delete installs[name];
+			const target = node_path.default.join(extensionsDir, name);
+			const rel = node_path.default.relative(extensionsDir, target);
+			if (!rel || rel.startsWith("..") || node_path.default.isAbsolute(rel)) continue;
+			try {
+				node_fs.default.rmSync(target, {
+					recursive: true,
+					force: true
+				});
+			} catch (e) {
+				console.error(`[old_miaoda_plugins_cleanup] rmSync ${target} failed: ${e.message}`);
+			}
+		}
+	}
+};
+OldMiaodaPluginsCleanupRule = __decorate([Rule({
+	key: "old_miaoda_plugins_cleanup",
+	description: "当新版 openclaw-extension-miaoda 已存在时，清理过时插件引用（openclaw-feishu-greeting、openclaw-miaoda-keepalive 等）",
+	dependsOn: ["config_syntax_check"],
+	repairMode: "standard",
+	level: "silent"
+})], OldMiaodaPluginsCleanupRule);
+//#endregion
+//#region src/rules/builtin-plugin-missing.ts
+/**
+* install-extension --all 安装的内置扩展插件列表（manifest role=extension）。
+* 与 miaoda-official-plugins-install-spec-unlock.ts 中的 OFFICIAL_PLUGIN_NAMES 保持一致。
+*/
+const BUILTIN_EXTENSION_PLUGINS = new Set([
 	"openclaw-lark",
 	"openclaw-extension-miaoda",
 	"openclaw-extension-miaoda-coding",
@@ -3420,11 +3849,14 @@ FeishuPluginLarkUpgradeRule = __decorate([Rule({
 	usesVars: ["recommendedOpenclawTag"]
 })], FeishuPluginLarkUpgradeRule);
 /**
-* Core predicate: returns true when the lark plugin needs upgrading for a
-* non-fork plugin, based on version compatibility with the current openclaw.
+* 核心判断：非 fork 插件是否需要升级 lark，基于当前 openclaw 版本的兼容性。
+*
+* 被 FeishuPluginLarkUpgradeRule.validate 和 needsLarkUpgrade 共用。
+* 调用方需在调用前自行处理 fork 插件的情况（fork 插件不走本函数）。
 *
-* Shared by FeishuPluginLarkUpgradeRule.validate and needsLarkUpgrade.
-* Callers must handle fork plugin cases before invoking this function.
+* - 有 recommendedOc：走 resolveUpgradeDirection 判断方向是否为 'lark'
+* - 无 recommendedOc（doctor 无推荐版本）：legacy 插件直接需要升级；
+*   非 legacy 则检查当前版本是否在兼容表内
 */
 function isLarkUpgradeNeededFromCC(cc) {
 	const { ocCur, recommendedOc, installed, isLegacy } = cc;
@@ -3526,9 +3958,8 @@ function extractScopedNameFromSpec$1(spec) {
 	return at === -1 ? spec : spec.slice(0, at);
 }
 /**
-* Returns true if the installed feishu plugin is version-incompatible with
-* the current openclaw (or is a legacy plugin that must be replaced).
-* Used by the upgrade_lark_needed rule and the upgrade-lark pre-check gate.
+* 判断已安装的飞书插件是否与当前 openclaw 版本不兼容（或为需要替换的 legacy 插件）。
+* 被 upgrade-lark 前置检测门控（--check-only 和正式安装模式）调用。
 */
 function needsLarkUpgrade(ctx) {
 	const cc = resolveCompatContext({
@@ -3547,177 +3978,6 @@ function needsLarkUpgrade(ctx) {
 	return isLarkUpgradeNeededFromCC(cc);
 }
 //#endregion
-//#region src/channels-probe.ts
-const FEISHU_INVALID_CONFIG_MSG = "channels.feishu: invalid config: must NOT have additional properties";
-const CHANNEL_LINE_RE = /^-\s+Feishu\s+([^:]+):\s+(.+)$/;
-/**
-* Port of Python `_account_is_working` from the feishu-channel-success-rate skill.
-*
-* Strips colon-prefixed key:value bits (dm:, bot:, in:, out:, token:, allow:,
-* intents:, groups:, health:) and evaluates the canonical health formula.
-*
-* @param ignoreProbeFailed  When true, "probe failed" is not treated as a failure condition.
-* @param gatewayReachable   When false, only enabled+configured is required — the service
-*   is not started yet so "running" cannot be present, but config presence is sufficient.
-*/
-function accountIsWorking(bits, ignoreProbeFailed = true, gatewayReachable = true) {
-	const bitTokens = /* @__PURE__ */ new Set();
-	let hasError = false;
-	let hasProbeFailed = false;
-	for (const raw of bits) {
-		const b = raw.trim();
-		if (!b) continue;
-		if (b.startsWith("error:")) {
-			hasError = true;
-			continue;
-		}
-		if (b === "probe failed") {
-			hasProbeFailed = true;
-			continue;
-		}
-		bitTokens.add(b.split(":")[0]);
-	}
-	if (!bitTokens.has("enabled") || !bitTokens.has("configured")) return false;
-	if (!gatewayReachable) return true;
-	if (bitTokens.has("works")) return true;
-	if (bitTokens.has("running") && !hasError && (ignoreProbeFailed || !hasProbeFailed)) return true;
-	return false;
-}
-/**
-* Parse the raw stdout of `openclaw channels status --probe`.
-* Port of Python `extract_channels_probe` from the feishu-channel-success-rate skill.
-*/
-function parseChannelsProbeOutput(text, { ignoreProbeFailed = true } = {}) {
-	const gatewayReachable = text.includes("Gateway reachable");
-	const feishuConfigInvalid = text.includes(FEISHU_INVALID_CONFIG_MSG);
-	const accounts = [];
-	let anyAccountWorking = false;
-	for (const line of text.split("\n")) {
-		const m = CHANNEL_LINE_RE.exec(line.trim());
-		if (!m) continue;
-		const [, acct, rest] = m;
-		const bits = rest.split(",").map((b) => b.trim());
-		const isWorking = accountIsWorking(bits, ignoreProbeFailed, gatewayReachable);
-		if (isWorking) anyAccountWorking = true;
-		accounts.push({
-			id: acct.trim(),
-			bits,
-			isWorking,
-			raw: line.trim()
-		});
-	}
-	return {
-		gatewayReachable,
-		feishuConfigInvalid,
-		accounts,
-		anyAccountWorking
-	};
-}
-/**
-* Run `openclaw channels status --probe` and return a structured result.
-*
-* The command may exit non-zero when some bot accounts fail their probe — that
-* is still useful output.  We therefore try to parse stdout even when the
-* process exits with a non-zero code, falling back to an unavailable result
-* only when there is genuinely no output to parse.
-*
-* @param timeoutMs         Maximum wait time.  Default is 60 s because v2026.4.x
-*   lacks a per-request HTTP timeout and can block indefinitely.
-* @param ignoreProbeFailed When true, accounts with "probe failed" are still
-*   counted as working.  Pass true for upgrade-gate checks where probe failures
-*   reflect network conditions rather than plugin misconfiguration.
-*/
-function runChannelsProbe(timeoutMs = 6e4, { ignoreProbeFailed = true } = {}) {
-	let stdout = "";
-	let stderrText = "";
-	let execError;
-	try {
-		stdout = (0, node_child_process.execSync)("openclaw channels status --probe", {
-			encoding: "utf-8",
-			timeout: timeoutMs,
-			stdio: [
-				"ignore",
-				"pipe",
-				"pipe"
-			]
-		});
-	} catch (e) {
-		const err = e;
-		const stdoutRaw = err.stdout;
-		stdout = typeof stdoutRaw === "string" ? stdoutRaw : stdoutRaw?.toString("utf-8") ?? "";
-		execError = err.message;
-		const stderrRaw = err.stderr;
-		stderrText = (typeof stderrRaw === "string" ? stderrRaw : stderrRaw?.toString("utf-8") ?? "").trim();
-		if (stderrText) console.error(`channels-probe: stderr from CLI: ${stderrText}`);
-	}
-	if (stdout.trim()) return {
-		available: true,
-		...parseChannelsProbeOutput(stdout, { ignoreProbeFailed })
-	};
-	return {
-		available: false,
-		gatewayReachable: false,
-		feishuConfigInvalid: stderrText.includes(FEISHU_INVALID_CONFIG_MSG),
-		accounts: [],
-		anyAccountWorking: false,
-		error: execError ?? "no output from openclaw channels status --probe"
-	};
-}
-//#endregion
-//#region src/rules/upgrade-lark-needed.ts
-/**
-* Detects the condition that warrants running `upgrade-lark`:
-*   - feishu plugin version incompatible with current openclaw, OR
-*   - openclaw channels status --probe reports feishu channel config invalid; AND
-*   - channels are not working.
-*
-* Both conditions must be true simultaneously. If version is compatible and
-* feishu config is valid, or channels are working, the rule passes (no action needed).
-*
-* feishuConfigInvalid is read from the channels probe output rather than running a
-* separate `openclaw status` call, since only `openclaw channels status --probe`
-* reliably surfaces the schema validation error.
-*
-* profile: experimental — runs only in full sweep mode, not in standard doctor.
-* level: silent — telemetry/sweep-only, does not trigger page-level repair UI.
-*/
-let UpgradeLarkNeededRule = class UpgradeLarkNeededRule extends DiagnoseRule {
-	validate(ctx) {
-		let versionIncompatible = false;
-		try {
-			versionIncompatible = needsLarkUpgrade(ctx);
-		} catch {}
-		let probeResult;
-		try {
-			probeResult = runChannelsProbe(6e4);
-		} catch {
-			probeResult = {
-				available: false,
-				gatewayReachable: false,
-				feishuConfigInvalid: false,
-				accounts: [],
-				anyAccountWorking: false
-			};
-		}
-		const feishuConfigInvalid = probeResult.feishuConfigInvalid;
-		if (!(versionIncompatible || feishuConfigInvalid)) return { pass: true };
-		if (probeResult.anyAccountWorking) return { pass: true };
-		return {
-			pass: false,
-			action: "upgrade_lark",
-			message: `飞书插件需要升级且 channels 不可用（版本不兼容=${versionIncompatible}, feishu配置无效=${feishuConfigInvalid}），建议执行 upgrade-lark 命令升级飞书插件`
-		};
-	}
-};
-UpgradeLarkNeededRule = __decorate([Rule({
-	key: "upgrade_lark_needed",
-	description: "检测飞书插件版本不兼容且 channels 不可用，判断是否需要执行 upgrade-lark 升级",
-	dependsOn: ["config_syntax_check"],
-	repairMode: "check-only",
-	level: "silent",
-	profile: "experimental"
-})], UpgradeLarkNeededRule);
-//#endregion
 //#region src/rules/cleanup-install-backup-dirs.ts
 const DIR_PREFIX = ".openclaw-install-";
 function resolveExtensionsDir(configPath) {
@@ -3800,7 +4060,7 @@ function extractScopedNameFromSpec(spec) {
 	const at = spec.indexOf("@", 1);
 	return at === -1 ? spec : spec.slice(0, at);
 }
-function isLarkCliAvailable$1() {
+function isLarkCliAvailable() {
 	try {
 		return (0, node_child_process.spawnSync)(LARK_CLI_NAME$1, ["--version"], {
 			encoding: "utf-8",
@@ -3841,7 +4101,7 @@ function installLarkCliOnce(tag) {
 let LarkCliMissingForInstalledLarkPluginRule = class LarkCliMissingForInstalledLarkPluginRule extends DiagnoseRule {
 	validate(ctx) {
 		if (!isTargetForkPlugin(readInstalledLarkPlugin(ctx))) return { pass: true };
-		if (isLarkCliAvailable$1()) return { pass: true };
+		if (isLarkCliAvailable()) return { pass: true };
 		return {
 			pass: false,
 			message: `${FORK_PACKAGE_NAME}@${TARGET_VERSION} 已安装，但 lark-cli 不可用；将执行一次 lark-cli 安装`
@@ -3849,7 +4109,7 @@ let LarkCliMissingForInstalledLarkPluginRule = class LarkCliMissingForInstalledL
 	}
 	repair(ctx) {
 		if (!isTargetForkPlugin(readInstalledLarkPlugin(ctx))) return;
-		if (isLarkCliAvailable$1()) return;
+		if (isLarkCliAvailable()) return;
 		installLarkCliOnce(ctx.vars.recommendedOpenclawTag ?? TARGET_VERSION);
 	}
 };
@@ -3862,6 +4122,117 @@ LarkCliMissingForInstalledLarkPluginRule = __decorate([Rule({
 	usesVars: ["recommendedOpenclawTag"]
 })], LarkCliMissingForInstalledLarkPluginRule);
 //#endregion
+//#region src/rules/feishu-bot-channel-config.ts
+/**
+* Ensures each bot account's channel config is correct:
+*   1. `allowFrom` contains its own `creatorOpenID` from larkApps
+*   2. `appSecret` is either the canonical provider-ref or matches larkApps plaintext
+*
+* Covers both multi-account (channels.feishu.accounts) and single-account
+* (channels.feishu.appId + allowFrom at top level) layouts.
+*/
+let FeishuBotChannelConfigRule = class FeishuBotChannelConfigRule extends DiagnoseRule {
+	validate(ctx) {
+		const larkApps = ctx.vars.larkApps;
+		if (!larkApps || larkApps.length === 0) return { pass: true };
+		const feishu = asRecord(getNestedMap(ctx.config, "channels", "feishu"));
+		if (!feishu) return { pass: true };
+		const issues = [];
+		const accounts = asRecord(feishu.accounts);
+		if (accounts) for (const [accountId, account] of Object.entries(accounts)) {
+			const bot = asRecord(account);
+			if (!bot) continue;
+			const appId = bot.appId;
+			if (typeof appId !== "string" || !appId.startsWith("cli_")) continue;
+			const larkApp = larkApps.find((e) => e.larkAppID === appId);
+			if (!larkApp) continue;
+			this.checkBot(accountId, bot, larkApp, issues);
+		}
+		const singleAppId = feishu.appId;
+		if (typeof singleAppId === "string" && singleAppId.startsWith("cli_") && !accounts) {
+			const larkApp = larkApps.find((e) => e.larkAppID === singleAppId);
+			if (larkApp) this.checkBot("feishu", feishu, larkApp, issues);
+		}
+		if (issues.length === 0) return { pass: true };
+		return {
+			pass: false,
+			message: issues.join("; ")
+		};
+	}
+	/** Check a single bot entry (either an account object or the feishu channel itself).
+	*  appSecret is validated based on its current type:
+	*  - object → must match canonical provider-ref
+	*  - string → must match larkApps plaintext
+	*/
+	checkBot(label, bot, larkApp, issues) {
+		const creatorOpenID = larkApp.creatorOpenID;
+		const allowFrom = Array.isArray(bot.allowFrom) ? bot.allowFrom : [];
+		if (typeof creatorOpenID === "string" && creatorOpenID !== "") {
+			if (!allowFrom.includes(creatorOpenID)) issues.push(`${label} allowFrom missing creatorOpenID ${creatorOpenID.length > 8 ? creatorOpenID.slice(0, 4) + "***" + creatorOpenID.slice(-4) : "***"}`);
+		} else if (allowFrom.length === 0) issues.push(`${label} allowFrom is empty (creatorOpenID unavailable, cannot auto-fix)`);
+		const secret = bot.appSecret;
+		if (typeof secret === "object" && secret !== null && !Array.isArray(secret)) {
+			if (!matchMap(secret, DEFAULT_FEISHU_APP_SECRET)) issues.push(`${label} appSecret is a provider-ref but not the canonical one`);
+		} else if (typeof secret === "string") {
+			if (secret !== larkApp.appSecret) issues.push(`${label} appSecret plaintext mismatch`);
+		} else issues.push(`${label} appSecret has unexpected type ${typeof secret}`);
+	}
+	repair(ctx) {
+		const larkApps = ctx.vars.larkApps;
+		if (!larkApps || larkApps.length === 0) return;
+		const feishu = asRecord(getNestedMap(ctx.config, "channels", "feishu"));
+		if (!feishu) return;
+		const accounts = asRecord(feishu.accounts);
+		if (accounts) for (const [, account] of Object.entries(accounts)) {
+			const bot = asRecord(account);
+			if (!bot) continue;
+			const appId = bot.appId;
+			if (typeof appId !== "string" || !appId.startsWith("cli_")) continue;
+			const larkApp = larkApps.find((e) => e.larkAppID === appId);
+			if (!larkApp) continue;
+			this.fixBot(bot, larkApp);
+		}
+		const singleAppId = feishu.appId;
+		if (typeof singleAppId === "string" && singleAppId.startsWith("cli_") && !accounts) {
+			const larkApp = larkApps.find((e) => e.larkAppID === singleAppId);
+			if (larkApp) this.fixBot(feishu, larkApp);
+		}
+	}
+	/** Fix a single bot entry in-place.
+	*  appSecret is repaired based on its current type:
+	*  - object → fix to canonical provider-ref
+	*  - string → fix to larkApps plaintext
+	*/
+	fixBot(bot, larkApp) {
+		const creatorOpenID = larkApp.creatorOpenID;
+		if (typeof creatorOpenID === "string" && creatorOpenID !== "") {
+			const allowFrom = Array.isArray(bot.allowFrom) ? [...bot.allowFrom] : [];
+			if (!allowFrom.includes(creatorOpenID)) {
+				allowFrom.push(creatorOpenID);
+				bot.allowFrom = allowFrom;
+			}
+		}
+		const secret = bot.appSecret;
+		if (typeof secret === "object" && secret !== null && !Array.isArray(secret)) {
+			if (!matchMap(secret, DEFAULT_FEISHU_APP_SECRET)) bot.appSecret = { ...DEFAULT_FEISHU_APP_SECRET };
+		} else if (typeof secret === "string") {
+			if (secret !== larkApp.appSecret) bot.appSecret = larkApp.appSecret;
+		}
+	}
+};
+FeishuBotChannelConfigRule = __decorate([Rule({
+	key: "feishu_bot_channel_config",
+	description: "确保飞书配置中 bot 账号的 allowFrom 包含其创建者 openID 且 appSecret 值正确",
+	dependsOn: [
+		"config_syntax_check",
+		"feishu_default_account",
+		"feishu_bot_id"
+	],
+	repairMode: "standard",
+	usesVars: ["larkApps"],
+	level: "critical"
+})], FeishuBotChannelConfigRule);
+//#endregion
 //#region src/check.ts
 /** Telemetry-aware entry: returns both the legacy CheckResult (for stdout)
 *  AND a DoctorReport-shape payload (for `openclaw.report_cli_run`). The
@@ -4302,33 +4673,6 @@ function finalize$1(results, aborted) {
 	};
 }
 //#endregion
-//#region src/paths.ts
-/**
-* Central directory for all ephemeral diagnose/reset artifacts: task status
-* files (`reset-<taskId>.json`) and human-readable step logs
-* (`reset-<taskId>.log`). Having everything under one dir makes debugging a
-* stuck reset much easier — `ls /tmp/openclaw-diagnose/` shows every recent
-* run, and each run's log is right next to its state.
-*/
-const DIAGNOSE_DIR = "/tmp/openclaw-diagnose";
-function resetResultFile(taskId) {
-	return `${DIAGNOSE_DIR}/reset-${taskId}.json`;
-}
-function resetLogFile(taskId) {
-	return `${DIAGNOSE_DIR}/reset-${taskId}.log`;
-}
-/** Sandbox workspace root where openclaw config + agent state lives. */
-const WORKSPACE_DIR = "/home/gem/workspace/agent";
-/** File containing the provider key used by the openclaw miaoda provider. */
-const PROVIDER_FILE_PATH = "/home/gem/workspace/.force/openclaw/miaoda-provider-key";
-/** File containing the miaoda openclaw secrets JSON. */
-const SECRETS_FILE_PATH = "/home/gem/workspace/.force/openclaw/miaoda-openclaw-secrets.json";
-/** Absolute path to the openclaw config JSON. */
-const CONFIG_PATH = `${WORKSPACE_DIR}/openclaw.json`;
-function upgradeLarkLogFile(runId) {
-	return `${DIAGNOSE_DIR}/upgrade-lark-${(/* @__PURE__ */ new Date()).toISOString().slice(0, 19).replace(/:/g, "-")}-${runId.slice(0, 8)}.log`;
-}
-//#endregion
 //#region src/run-log.ts
 let currentRunContext;
 /**
@@ -4464,9 +4808,10 @@ function makeLogger(logFile) {
 /**
 * Start an async reset task: spawn a detached child process and return the taskId.
 *
-* The child process runs: node cli.js reset --worker --task-id=xxx --ctx=base64
+* The child process runs: node cli.js reset --worker --task-id=xxx
+* The worker fetches ctx from innerApi itself — no --ctx passthrough.
 */
-function startAsyncReset(ctxBase64) {
+function startAsyncReset() {
 	const taskId = (0, node_crypto.randomUUID)();
 	const resultFile = resetResultFile(taskId);
 	const log = makeLogger(resetLogFile(taskId));
@@ -4490,8 +4835,7 @@ function startAsyncReset(ctxBase64) {
 		process.argv[1],
 		"reset",
 		"--worker",
-		`--task-id=${taskId}`,
-		`--ctx=${ctxBase64}`
+		`--task-id=${taskId}`
 	], {
 		detached: true,
 		stdio: "ignore",
@@ -4858,308 +5202,48 @@ function updatePluginInstalls(configPath, installedPkgs) {
 		if (!PLUGINS_TO_AUTO_ENABLE.includes(pkg.name)) continue;
 		if (!Array.isArray(plugins.allow)) plugins.allow = [];
 		const allow = plugins.allow;
-		if (!allow.includes(pkg.name)) allow.push(pkg.name);
-		if (!plugins.entries || typeof plugins.entries !== "object" || Array.isArray(plugins.entries)) plugins.entries = {};
-		const entries = plugins.entries;
-		entries[pkg.name] = {
-			...asRecord(entries[pkg.name]) ?? {},
-			enabled: true
-		};
-	}
-	const tmpPath = configPath + ".installs-tmp";
-	node_fs.default.writeFileSync(tmpPath, JSON.stringify(config, null, 2), "utf-8");
-	moveSafe(tmpPath, configPath);
-	console.error(`[install-extension] plugins.installs updated: ${updated} entry(ies) in ${configPath}` + (skipped > 0 ? ` (${skipped} package(s) without installMetadata skipped)` : ""));
-}
-function installOne$1(pkg, tarball, homeBase) {
-	const destDir = node_path.default.join(homeBase, pkg.installPath);
-	const stagingDir = destDir + ".new";
-	const oldDir = destDir + ".old";
-	node_fs.default.mkdirSync(node_path.default.dirname(destDir), { recursive: true });
-	if (node_fs.default.existsSync(stagingDir)) node_fs.default.rmSync(stagingDir, {
-		recursive: true,
-		force: true
-	});
-	node_fs.default.mkdirSync(stagingDir);
-	try {
-		extractTarballTolerant(tarball, stagingDir, { stripComponents: 1 });
-		if (!node_fs.default.existsSync(node_path.default.join(stagingDir, "package.json"))) throw new Error(`extension tarball missing package.json: ${pkg.name}`);
-	} catch (e) {
-		try {
-			node_fs.default.rmSync(stagingDir, {
-				recursive: true,
-				force: true
-			});
-		} catch {}
-		throw e;
-	}
-	const hadOld = node_fs.default.existsSync(destDir);
-	if (hadOld) moveSafe(destDir, oldDir);
-	moveSafe(stagingDir, destDir);
-	if (hadOld && node_fs.default.existsSync(oldDir)) node_fs.default.rmSync(oldDir, {
-		recursive: true,
-		force: true
-	});
-}
-//#endregion
-//#region src/lark-cli-init.ts
-const LARK_PLUGIN_NAMES = ["openclaw-lark", "feishu-openclaw-plugin"];
-const PE_XML_TAG = "lark-cli-pe";
-const PE_PLACEHOLDER = `
-<${PE_XML_TAG}>
-**【强制要求 - 无例外】飞书所有操作必须先读 feishu-lark-cli skill。未读skill不得调用任何飞书工具，违者视为操作失误。**
-</${PE_XML_TAG}>
-`;
-function isLarkPluginInstalled(configPath) {
-	const extDir = getExtensionsDir(configPath);
-	return LARK_PLUGIN_NAMES.some((name) => {
-		try {
-			return node_fs.default.existsSync(node_path.default.join(extDir, name, "package.json"));
-		} catch {
-			return false;
-		}
-	});
-}
-function isLarkCliAvailable() {
-	try {
-		return (0, node_child_process.spawnSync)("lark-cli", ["--version"], {
-			encoding: "utf-8",
-			timeout: 5e3,
-			stdio: [
-				"ignore",
-				"pipe",
-				"ignore"
-			]
-		}).status === 0;
-	} catch {
-		return false;
-	}
-}
-function readConfig(configPath) {
-	try {
-		const raw = node_fs.default.readFileSync(configPath, "utf-8");
-		const parsed = loadJSON5().parse(raw);
-		return parsed != null && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : null;
-	} catch {
-		return null;
-	}
-}
-/**
-* Resolve the feishu app secret for the given appId.
-*
-* Lookup order:
-*   1. channels.feishu.appSecret  (single-agent: feishu.appId === appId)
-*   2. channels.feishu.accounts[key].appSecret  (multi-agent: account.appId === appId)
-*
-* Value interpretation:
-*   - string  → use directly
-*   - object  → secret is managed by a provider; use `feishuAppSecret` param instead
-*
-* Returns null when the secret cannot be determined.
-*/
-function resolveAppSecret(appId, config, feishuAppSecret) {
-	const feishu = getNestedMap(config, "channels", "feishu");
-	if (!feishu) return null;
-	let rawSecret;
-	if (typeof feishu.appId === "string" && feishu.appId === appId) rawSecret = feishu.appSecret;
-	else {
-		const accounts = asRecord(feishu.accounts);
-		if (accounts) for (const [, val] of Object.entries(accounts)) {
-			const account = asRecord(val);
-			if (account?.appId === appId) {
-				rawSecret = account.appSecret ?? feishu.appSecret;
-				break;
-			}
-		}
-	}
-	if (typeof rawSecret === "string" && rawSecret) return rawSecret;
-	if (rawSecret != null && typeof rawSecret === "object") return feishuAppSecret ?? null;
-	return null;
-}
-/**
-* Resolve the agents.md path for the given appId from the openclaw config.
-*
-* Case 1: appId matches channels.feishu.appId (single-agent path)
-*   → WORKSPACE_DIR/AGENTS.md
-*
-* Case 2: appId found in channels.feishu.accounts (multi-agent path)
-*   → find account key where account.appId === appId
-*   → find binding where match.channel=feishu && match.accountId=that key
-*   → if agentId === 'main'  → WORKSPACE_DIR/agents.md
-*   → else find agent in agents.list by id → agent.workspace/agents.md
-*
-* Returns null when the path cannot be determined.
-*/
-function resolveAgentsMdPath(appId, config) {
-	const feishu = getNestedMap(config, "channels", "feishu");
-	if (!feishu) {
-		console.error("resolveAgentsMdPath: channels.feishu not found");
-		return null;
-	}
-	if (typeof feishu.appId === "string" && feishu.appId === appId) {
-		console.error(`resolveAgentsMdPath: case=single-agent feishu.appId=${feishu.appId}`);
-		return node_path.default.join(WORKSPACE_DIR, "workspace", "AGENTS.md");
-	}
-	const accounts = asRecord(feishu.accounts);
-	if (!accounts) {
-		console.error("resolveAgentsMdPath: feishu.accounts not found");
-		return null;
-	}
-	let accountId;
-	for (const [key, val] of Object.entries(accounts)) if (asRecord(val)?.appId === appId) {
-		accountId = key;
-		break;
-	}
-	if (!accountId) {
-		console.error(`resolveAgentsMdPath: no account found with appId=${appId} in feishu.accounts keys=[${Object.keys(accounts).join(",")}]`);
-		return null;
-	}
-	console.error(`resolveAgentsMdPath: found accountId=${accountId}`);
-	const bindings = Array.isArray(config.bindings) ? config.bindings : [];
-	let agentId;
-	for (const b of bindings) {
-		const binding = asRecord(b);
-		if (!binding) continue;
-		const match = asRecord(binding.match);
-		if (match?.channel === "feishu" && match?.accountId === accountId) {
-			if (typeof binding.agentId === "string") {
-				agentId = binding.agentId;
-				break;
-			}
-		}
-	}
-	if (!agentId) {
-		console.error(`resolveAgentsMdPath: no binding found for accountId=${accountId} in bindings(count=${bindings.length})`);
-		return null;
-	}
-	console.error(`resolveAgentsMdPath: found agentId=${agentId}`);
-	if (agentId === "main") {
-		console.error("resolveAgentsMdPath: case=multi-agent-main");
-		return node_path.default.join(WORKSPACE_DIR, "workspace", "AGENTS.md");
-	}
-	const agentsObj = asRecord(config.agents);
-	const list = Array.isArray(agentsObj?.list) ? agentsObj.list : [];
-	for (const a of list) {
-		const agent = asRecord(a);
-		if (agent?.id === agentId) {
-			const ws = typeof agent.workspace === "string" ? agent.workspace : node_path.default.join(WORKSPACE_DIR, "workspace");
-			console.error(`resolveAgentsMdPath: case=multi-agent-custom agentId=${agentId} workspace=${ws}`);
-			return node_path.default.join(ws, "AGENTS.md");
-		}
-	}
-	console.error(`resolveAgentsMdPath: agentId=${agentId} not found in agents.list(count=${list.length})`);
-	return null;
-}
-function appendPeToAgentsMd(agentsMdPath) {
-	const dir = node_path.default.dirname(agentsMdPath);
-	if (!node_fs.default.existsSync(dir)) node_fs.default.mkdirSync(dir, { recursive: true });
-	const existing = node_fs.default.existsSync(agentsMdPath) ? node_fs.default.readFileSync(agentsMdPath, "utf-8") : "";
-	if (existing.includes(`<${PE_XML_TAG}>`)) {
-		console.error(`lark-cli-init: <${PE_XML_TAG}> already present in ${agentsMdPath}, skipping`);
-		return;
-	}
-	const sep = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
-	node_fs.default.appendFileSync(agentsMdPath, `${sep}${PE_PLACEHOLDER}`, "utf-8");
-	console.error(`lark-cli-init: appended PE placeholder to ${agentsMdPath}`);
-}
-/**
-* Collect every Feishu bot appId declared in the openclaw config.
-* Covers both single-agent (channels.feishu.appId) and multi-agent
-* (channels.feishu.accounts[*].appId) layouts. Returns a deduplicated list.
-*/
-function collectFeishuAppIds(configPath) {
-	const config = readConfig(configPath ?? CONFIG_PATH);
-	if (!config) return [];
-	const feishu = getNestedMap(config, "channels", "feishu");
-	if (!feishu) return [];
-	const appIds = /* @__PURE__ */ new Set();
-	const topAppId = feishu.appId;
-	if (typeof topAppId === "string" && topAppId.trim()) appIds.add(topAppId.trim());
-	const accounts = asRecord(feishu.accounts);
-	if (accounts) for (const val of Object.values(accounts)) {
-		const appId = asRecord(val)?.appId;
-		if (typeof appId === "string" && appId.trim()) appIds.add(appId.trim());
-	}
-	return [...appIds];
-}
-function runLarkCliInit(opts) {
-	const configPath = opts.configPath ?? CONFIG_PATH;
-	if (!isLarkPluginInstalled(configPath)) {
-		console.error("lark-cli-init: skipping — openclaw-lark plugin not installed");
-		return {
-			ok: true,
-			skipped: true,
-			skipReason: "openclaw-lark plugin not installed"
-		};
-	}
-	if (!isLarkCliAvailable()) {
-		console.error("lark-cli-init: skipping — lark-cli command not found");
-		return {
-			ok: true,
-			skipped: true,
-			skipReason: "lark-cli command not found"
-		};
-	}
-	const config = readConfig(configPath);
-	if (!config) return {
-		ok: false,
-		error: `could not read config at ${configPath}`
-	};
-	const agentsMdPath = resolveAgentsMdPath(opts.appId, config);
-	console.error(`lark-cli-init: resolved agents.md path=${agentsMdPath ?? "(null)"}`);
-	if (!agentsMdPath) return {
-		ok: false,
-		error: `could not resolve agents.md path for appId=${opts.appId}`
-	};
-	const appSecret = resolveAppSecret(opts.appId, config, opts.feishuAppSecret);
-	if (!appSecret) return {
-		ok: false,
-		error: `could not resolve appSecret for appId=${opts.appId}`
-	};
-	console.error(`lark-cli-init: running lark-cli config init --name ${opts.appId} --app-id ${opts.appId} --brand feishu --app-secret-stdin --force-init`);
-	const initRes = (0, node_child_process.spawnSync)("lark-cli", [
-		"config",
-		"init",
-		"--name",
-		opts.appId,
-		"--app-id",
-		opts.appId,
-		"--brand",
-		"feishu",
-		"--app-secret-stdin",
-		"--force-init"
-	], {
-		stdio: [
-			"pipe",
-			"pipe",
-			"pipe"
-		],
-		encoding: "utf-8",
-		input: appSecret
+		if (!allow.includes(pkg.name)) allow.push(pkg.name);
+		if (!plugins.entries || typeof plugins.entries !== "object" || Array.isArray(plugins.entries)) plugins.entries = {};
+		const entries = plugins.entries;
+		entries[pkg.name] = {
+			...asRecord(entries[pkg.name]) ?? {},
+			enabled: true
+		};
+	}
+	const tmpPath = configPath + ".installs-tmp";
+	node_fs.default.writeFileSync(tmpPath, JSON.stringify(config, null, 2), "utf-8");
+	moveSafe(tmpPath, configPath);
+	console.error(`[install-extension] plugins.installs updated: ${updated} entry(ies) in ${configPath}` + (skipped > 0 ? ` (${skipped} package(s) without installMetadata skipped)` : ""));
+}
+function installOne$1(pkg, tarball, homeBase) {
+	const destDir = node_path.default.join(homeBase, pkg.installPath);
+	const stagingDir = destDir + ".new";
+	const oldDir = destDir + ".old";
+	node_fs.default.mkdirSync(node_path.default.dirname(destDir), { recursive: true });
+	if (node_fs.default.existsSync(stagingDir)) node_fs.default.rmSync(stagingDir, {
+		recursive: true,
+		force: true
+	});
+	node_fs.default.mkdirSync(stagingDir);
+	try {
+		extractTarballTolerant(tarball, stagingDir, { stripComponents: 1 });
+		if (!node_fs.default.existsSync(node_path.default.join(stagingDir, "package.json"))) throw new Error(`extension tarball missing package.json: ${pkg.name}`);
+	} catch (e) {
+		try {
+			node_fs.default.rmSync(stagingDir, {
+				recursive: true,
+				force: true
+			});
+		} catch {}
+		throw e;
+	}
+	const hadOld = node_fs.default.existsSync(destDir);
+	if (hadOld) moveSafe(destDir, oldDir);
+	moveSafe(stagingDir, destDir);
+	if (hadOld && node_fs.default.existsSync(oldDir)) node_fs.default.rmSync(oldDir, {
+		recursive: true,
+		force: true
 	});
-	const configInitStdout = initRes.stdout?.trim() || void 0;
-	const configInitStderr = initRes.stderr?.trim() || void 0;
-	if (configInitStdout) console.error(`lark-cli config init stdout: ${configInitStdout}`);
-	if (configInitStderr) console.error(`lark-cli config init stderr: ${configInitStderr}`);
-	if (initRes.error) return {
-		ok: false,
-		configInitStdout,
-		configInitStderr,
-		error: `lark-cli config init spawn error: ${initRes.error.message}`
-	};
-	if (initRes.status !== 0) return {
-		ok: false,
-		configInitExitCode: initRes.status ?? void 0,
-		configInitStdout,
-		configInitStderr,
-		error: `lark-cli config init exited with code ${initRes.status}`
-	};
-	appendPeToAgentsMd(agentsMdPath);
-	return {
-		ok: true,
-		configInitExitCode: 0,
-		agentsMdPath
-	};
 }
 //#endregion
 //#region ../../openclaw-slardar/lib/client.js
@@ -7005,6 +7089,60 @@ function mergeCoreBackupAndOrigins(configPath, vars, resetData, log) {
 	log(`allowedOrigins: added ${added.length} (${JSON.stringify(added)}), total now ${mergedOrigins.length}`);
 }
 /**
+* Fix bot account allowFrom and appSecret using larkApps from innerApi.
+*
+* For each bot account (key starts with `bot-cli_`):
+*   - allowFrom must contain the bot's own creatorOpenID from larkApps
+*   - appSecret must be either the canonical provider-ref or match larkApps plaintext
+*
+* Runs after mergeCoreBackupAndOrigins so it operates on the final config state.
+*/
+function fixBotChannelConfig(configPath, larkApps, log) {
+	if (!larkApps || larkApps.length === 0) {
+		log("no larkApps data, skip bot channel config fix");
+		return;
+	}
+	const config = loadJSON5().parse(node_fs.default.readFileSync(configPath, "utf-8"));
+	const accounts = asRecord(getNestedMap(config, "channels", "feishu")?.accounts);
+	if (!accounts) {
+		log("no feishu accounts in config, skip bot channel config fix");
+		return;
+	}
+	let fixCount = 0;
+	for (const [, account] of Object.entries(accounts)) {
+		const bot = asRecord(account);
+		if (!bot) continue;
+		const appId = bot.appId;
+		if (typeof appId !== "string" || !appId.startsWith("cli_")) continue;
+		const larkApp = larkApps.find((e) => e.larkAppID === appId);
+		if (!larkApp) continue;
+		const creatorOpenID = larkApp.creatorOpenID;
+		if (typeof creatorOpenID === "string" && creatorOpenID !== "") {
+			const allowFrom = Array.isArray(bot.allowFrom) ? [...bot.allowFrom] : [];
+			if (!allowFrom.includes(creatorOpenID)) {
+				allowFrom.push(creatorOpenID);
+				bot.allowFrom = allowFrom;
+				fixCount++;
+			}
+		}
+		const secret = bot.appSecret;
+		let needsFix = false;
+		if (typeof secret === "object" && secret !== null && !Array.isArray(secret)) {
+			if (!matchMap(secret, DEFAULT_FEISHU_APP_SECRET)) needsFix = true;
+		} else if (typeof secret === "string") {
+			if (secret !== larkApp.appSecret) needsFix = true;
+		} else needsFix = true;
+		if (needsFix) {
+			bot.appSecret = { ...DEFAULT_FEISHU_APP_SECRET };
+			fixCount++;
+		}
+	}
+	if (fixCount > 0) {
+		node_fs.default.writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
+		log(`fixed ${fixCount} bot channel config issue(s) (allowFrom/appSecret)`);
+	} else log("bot channel config ok, no fixes needed");
+}
+/**
 * Step 7: Verify startup scripts landed in configDir/scripts/.
 *
 * Scripts are extracted directly to configDir/scripts/ during stageTemplate —
@@ -7149,6 +7287,7 @@ async function runReset(input, taskId, resultFile) {
 		await step5InstallOpenclaw(openclawTag, ossFileMap, log);
 		step(6);
 		mergeCoreBackupAndOrigins(configPath, vars, resetData, log);
+		fixBotChannelConfig(configPath, vars.larkApps, log);
 		step(7);
 		verifyStartupScripts(configDir, log);
 		step(8);
@@ -7947,7 +8086,8 @@ function normalizeCtx(raw) {
 			reset: {
 				templateVars: r.reset.templateVars ?? {},
 				coreBackup: r.reset.coreBackup
-			}
+			},
+			larkApps: Array.isArray(r.larkApps) ? r.larkApps : []
 		};
 	}
 	const vars = r.vars ?? {};
@@ -7972,7 +8112,8 @@ function normalizeCtx(raw) {
 		reset: {
 			templateVars: resetData.templateVars ?? {},
 			coreBackup: resetData.coreBackup
-		}
+		},
+		larkApps: Array.isArray(r.larkApps) ? r.larkApps : []
 	};
 }
 function fillApp(src) {
@@ -8037,7 +8178,8 @@ function buildCheckInput(raw, configPathOverride) {
 			providerFilePath: PROVIDER_FILE_PATH,
 			secretsFilePath: SECRETS_FILE_PATH,
 			templateVars: ctx.app.templateVars,
-			recommendedOpenclawTag: ctx.app.recommendedOpenclawTag
+			recommendedOpenclawTag: ctx.app.recommendedOpenclawTag,
+			larkApps: ctx.larkApps
 		},
 		templateVars: ctx.app.templateVars
 	};
@@ -8069,7 +8211,8 @@ function buildRepairInput(raw, configPathOverride) {
 			providerFilePath: PROVIDER_FILE_PATH,
 			secretsFilePath: SECRETS_FILE_PATH,
 			templateVars: ctx.app.templateVars,
-			recommendedOpenclawTag: ctx.app.recommendedOpenclawTag
+			recommendedOpenclawTag: ctx.app.recommendedOpenclawTag,
+			larkApps: ctx.larkApps
 		},
 		repairData: {
 			secretsContent: ctx.secrets.secretsContent,
@@ -8105,7 +8248,8 @@ function buildResetInput(raw, configPathOverride) {
 			providerFilePath: PROVIDER_FILE_PATH,
 			secretsFilePath: SECRETS_FILE_PATH,
 			templateVars: ctx.app.templateVars,
-			recommendedOpenclawTag: ctx.app.recommendedOpenclawTag
+			recommendedOpenclawTag: ctx.app.recommendedOpenclawTag,
+			larkApps: ctx.larkApps
 		},
 		resetData: {
 			templateVars: ctx.reset.templateVars,
@@ -10336,6 +10480,139 @@ function finalize(results, aborted) {
 	};
 }
 //#endregion
+//#region src/channels-probe.ts
+const FEISHU_INVALID_CONFIG_MSG = "channels.feishu: invalid config: must NOT have additional properties";
+const CHANNEL_LINE_RE = /^-\s+(?:Feishu|openclaw-lark|@larksuite\/openclaw-lark)\s+([^:]+):\s+(.+)$/i;
+/**
+* 判断单个飞书账号是否处于"可用"状态。
+* 移植自 feishu-channel-success-rate skill 的 Python `_account_is_working`。
+*
+* 会先剥离 "key:value" 形式的 bit（dm:、bot:、in:、out:、token:、allow:、
+* intents:、groups:、health: 等），再按以下公式判断：
+*
+* @param ignoreProbeFailed  为 true 时忽略 "probe failed" bit，不视为失败。
+*   升级前置检测中传 true，因为 probe 失败通常反映网络状况而非配置问题。
+* @param gatewayReachable   为 false 时（gateway 尚未启动），只要 enabled+configured
+*   即视为可用；为 true 时还需要 running/works 且无 error: bit。
+*/
+function accountIsWorking(bits, ignoreProbeFailed = true, gatewayReachable = true) {
+	const bitTokens = /* @__PURE__ */ new Set();
+	let hasError = false;
+	let hasProbeFailed = false;
+	for (const raw of bits) {
+		const b = raw.trim();
+		if (!b) continue;
+		if (b.startsWith("error:")) {
+			hasError = true;
+			continue;
+		}
+		if (b === "probe failed") {
+			hasProbeFailed = true;
+			continue;
+		}
+		bitTokens.add(b.split(":")[0]);
+	}
+	if (!bitTokens.has("enabled") || !bitTokens.has("configured")) return false;
+	if (!gatewayReachable) return true;
+	if (bitTokens.has("works")) return true;
+	if (bitTokens.has("running") && !hasError && (ignoreProbeFailed || !hasProbeFailed)) return true;
+	return false;
+}
+/**
+* 解析 `openclaw channels status --probe` 的原始 stdout。
+* 移植自 feishu-channel-success-rate skill 的 Python `extract_channels_probe`。
+*/
+function parseChannelsProbeOutput(text, { ignoreProbeFailed = true } = {}) {
+	const gatewayReachable = text.includes("Gateway reachable");
+	const feishuConfigInvalid = text.includes(FEISHU_INVALID_CONFIG_MSG);
+	const accounts = [];
+	let anyAccountWorking = false;
+	for (const line of text.split("\n")) {
+		const m = CHANNEL_LINE_RE.exec(line.trim());
+		if (!m) continue;
+		const [, acct, rest] = m;
+		const bits = rest.split(",").map((b) => b.trim());
+		const isWorking = accountIsWorking(bits, ignoreProbeFailed, gatewayReachable);
+		if (isWorking) anyAccountWorking = true;
+		accounts.push({
+			id: acct.trim(),
+			bits,
+			isWorking,
+			raw: line.trim()
+		});
+	}
+	return {
+		gatewayReachable,
+		feishuConfigInvalid,
+		accounts,
+		anyAccountWorking
+	};
+}
+/**
+* 执行 `openclaw channels status --probe`，返回结构化结果。
+*
+* 部分 bot 账号 probe 失败时命令会以非零退出码退出，但 stdout 仍有可用内容。
+* 因此即使退出码非零，也尝试解析 stdout；只有真正没有任何输出时才返回 unavailable。
+*
+* @param timeoutMs         最长等待时长，默认 60 s。v2026.4.x 缺少单请求 HTTP 超时，
+*   可能无限阻塞，此超时是唯一保护。
+* @param ignoreProbeFailed 为 true 时，"probe failed" 账号仍计入"可用"。
+*   升级前置检测中应传 true，避免网络抖动导致误判为不可用。
+*/
+function runChannelsProbe(timeoutMs = 6e4, { ignoreProbeFailed = true } = {}) {
+	let stdout = "";
+	let stderrText = "";
+	let execError;
+	try {
+		stdout = (0, node_child_process.execSync)("openclaw channels status --probe", {
+			encoding: "utf-8",
+			timeout: timeoutMs,
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			]
+		});
+	} catch (e) {
+		const err = e;
+		const stdoutRaw = err.stdout;
+		stdout = typeof stdoutRaw === "string" ? stdoutRaw : stdoutRaw?.toString("utf-8") ?? "";
+		execError = err.message;
+		const stderrRaw = err.stderr;
+		stderrText = (typeof stderrRaw === "string" ? stderrRaw : stderrRaw?.toString("utf-8") ?? "").trim();
+		if (stderrText) console.error(`channels-probe: stderr from CLI: ${stderrText}`);
+	}
+	if (stdout.trim()) return {
+		available: true,
+		rawOutput: stdout.trim(),
+		...parseChannelsProbeOutput(stdout, { ignoreProbeFailed })
+	};
+	return {
+		available: false,
+		gatewayReachable: false,
+		feishuConfigInvalid: stderrText.includes(FEISHU_INVALID_CONFIG_MSG),
+		accounts: [],
+		anyAccountWorking: false,
+		error: execError ?? "no output from openclaw channels status --probe"
+	};
+}
+/**
+* 判断 channels probe 结果是否处于"仅一个 Feishu 默认账号、enabled 但未配置"的状态。
+*
+* 这是插件全新安装后的初始状态：npx 工具创建了一个默认账号占位，但用户尚未
+* 填写 AppID / Secret，因此账号显示为 enabled 但 not configured。
+* 此时 anyAccountWorking=false（configured 缺失），但安装本身是成功的。
+*
+* 用于安装后校验的补充分支：当安装前 channels 不可用，且安装后恰好处于此状态时，
+* 视为安装成功，不触发回滚。
+*/
+function isDefaultOnlyState(result) {
+	if (result.accounts.length !== 1) return false;
+	const acct = result.accounts[0];
+	const bitTokens = new Set(acct.bits.map((b) => b.trim().split(":")[0]));
+	return bitTokens.has("enabled") && !bitTokens.has("configured");
+}
+//#endregion
 //#region src/innerapi/reportCliRun.ts
 /**
 * CLI-side client for studio_server's `openclaw.report_cli_run` inner
@@ -10415,7 +10692,7 @@ async function reportCliRun(opts) {
 //#region src/help.ts
 const BIN = "mclaw-diagnose";
 function versionBanner() {
-	return `v0.1.15-alpha.0`;
+	return `v0.1.15-alpha.10`;
 }
 const COMMANDS = [
 	{
@@ -10519,16 +10796,12 @@ EXIT CODES
 		hidden: true,
 		summary: "Run rule-engine check only",
 		help: `USAGE
-  ${BIN} check [--ctx=<base64>]
+  ${BIN} check
 
 DESCRIPTION
   Runs the rule engine against the sandbox's current openclaw config and
-  returns { failedRules }. Used by sandbox_console's push-style callers
-  that already own the ctx — end-users should prefer \`doctor\`.
-
-OPTIONS
-  --ctx=<base64>   Opaque ctx JSON (base64). When absent, fetched from
-                   innerapi (same path as doctor).
+  returns { failedRules }. Ctx is fetched from innerapi automatically.
+  End-users should prefer \`doctor\`.
 `
 	},
 	{
@@ -10536,16 +10809,11 @@ OPTIONS
 		hidden: true,
 		summary: "Apply standard-mode repairs",
 		help: `USAGE
-  ${BIN} repair [--ctx=<base64>]
+  ${BIN} repair
 
 DESCRIPTION
-  Runs repair for the failing rules listed inside the ctx's repairData.
-  Intended for sandbox_console's push path — end-users should use
-  \`doctor --fix\` instead.
-
-OPTIONS
-  --ctx=<base64>   Opaque ctx JSON (base64). When absent, fetched from
-                   innerapi.
+  Runs repair for the failing rules. Ctx is fetched from innerapi
+  automatically. End-users should use \`doctor --fix\` instead.
 `
 	},
 	{
@@ -10553,14 +10821,15 @@ OPTIONS
 		hidden: true,
 		summary: "Re-initialize sandbox via the 9-step reset pipeline",
 		help: `USAGE
-  ${BIN} reset --async  [--ctx=<base64>]
-  ${BIN} reset --worker --task-id=<id> [--ctx=<base64>]
+  ${BIN} reset --async
+  ${BIN} reset --worker --task-id=<id>
 
 DESCRIPTION
   Two-phase pipeline driven asynchronously: the --async invocation spawns
   a detached worker and returns { taskId } immediately; the --worker
   invocation (spawned by --async) runs the actual 9 steps and writes
   progress to /tmp/openclaw-diagnose/reset-<taskId>.json.
+  Ctx is fetched from innerapi automatically.
 
   Poll progress with \`${BIN} get_reset_task --task-id=<id>\`.
 
@@ -10568,7 +10837,6 @@ OPTIONS
   --async           Start a detached worker and return taskId on stdout.
   --worker          Internal — run the 9-step pipeline (launched by --async).
   --task-id=<id>    Required with --worker; identifies the progress file.
-  --ctx=<base64>    Opaque ctx JSON; fetched from innerapi when absent.
 `
 	},
 	{
@@ -10591,7 +10859,7 @@ OPTIONS
 		hidden: true,
 		summary: "Download + install the openclaw tarball",
 		help: `USAGE
-  ${BIN} install-openclaw <tag> [--ctx=<base64> | --oss_file_map=<base64>]
+  ${BIN} install-openclaw <tag> [--oss_file_map=<base64>]
 
 DESCRIPTION
   Downloads the openclaw@<tag> tgz via the signed OSS URL found in the
@@ -10603,9 +10871,9 @@ ARGUMENTS
   <tag>                Openclaw version tag, e.g. 2026.4.11.
 
 OPTIONS
-  --ctx=<base64>       Opaque ctx; ossFileMap is extracted from it.
   --oss_file_map=...   Pre-built OSS URL map (base64 JSON); skips innerapi
-                       entirely. Wins over --ctx when both provided.
+                       entirely. When absent, ossFileMap is fetched from
+                       innerapi automatically.
 `
 	},
 	{
@@ -10631,8 +10899,7 @@ OPTIONS
   --home_base=<dir>    Override the /home/gem base (tests).
   --config_path=<p>    Override the openclaw.json path (tests).
   --skip-config-update Leave plugins.installs in openclaw.json untouched.
-  --ctx=<base64>       Opaque ctx; see install-openclaw for semantics.
-  --oss_file_map=...   Pre-built OSS URL map (base64 JSON).
+  --oss_file_map=...   Pre-built OSS URL map (base64 JSON); skips innerapi.
 `
 	},
 	{
@@ -10659,7 +10926,6 @@ OPTIONS
   --cli=<name>         CLI package to install by short name or scoped
                        packageName (repeatable, at least one required).
   --home_base=<dir>    Override the /home/gem base (tests).
-  --ctx=<base64>       Opaque ctx; ossFileMap is extracted from it.
   --oss_file_map=...   Pre-built OSS URL map (base64 JSON); skips innerapi.
 
 EXAMPLES
@@ -10720,12 +10986,17 @@ EXIT CODES
 		hidden: false,
 		summary: "Upgrade the Feishu/Lark plugin via @larksuite/openclaw-lark-tools",
 		help: `USAGE
-  ${BIN} upgrade-lark [--scene=<scene>] [--caller=<n>] [--trace-id=<id>]
+  ${BIN} upgrade-lark [--check] [--skip-restart] [--scene=<scene>] [--caller=<n>] [--trace-id=<id>]
 
 DESCRIPTION
   Upgrades the Feishu/Lark plugin by running:
     npx -y @larksuite/openclaw-lark-tools update --use-existing
 
+  Before the upgrade, a pre-check gate runs to verify the upgrade is needed:
+    - version incompatible OR feishu channel config invalid, AND
+    - no feishu account is currently working
+  If the gate is not triggered, the command skips with exit code 0.
+
   Before the upgrade, the following files are backed up:
     - openclaw.json
     - extensions/openclaw-lark/  (if present)
@@ -10736,6 +11007,10 @@ DESCRIPTION
   If the upgrade command fails, or validation fails, the backed-up files are
   restored to roll back the changes.
 
+  After a successful upgrade, the openclaw service is restarted via
+    /opt/force/bin/openclaw_scripts/restart.sh
+  Pass --skip-restart to skip this step (e.g. when restart is handled externally).
+
   Execution is logged to /tmp/openclaw-diagnose/upgrade-lark-<runId>.log.
 
   Output is a single JSON object on stdout:
@@ -10743,16 +11018,24 @@ DESCRIPTION
     { "ok": false, "error": "...", "stderr": "...", "exitCode": 1,
       "rollbackOk": true, "validationError": "...", "logFile": "..." }
 
+  With --check:
+    { "ok": true, "skipped": true, "upgradeNeeded": false, "logFile": "..." }
+    { "ok": true, "skipped": true, "upgradeNeeded": true,  "logFile": "..." }  ← exit 1
+
 OPTIONS
+  --check            Diagnose only: run the pre-check gate and report whether
+                     upgrade is needed without installing. Exit 1 if needed.
+  --skip-restart     Skip the post-install service restart (default: restart).
   --scene=<scene>    Telemetry label forwarded to Slardar only.
                      Known values: PageUpgradeLark, etc. Custom strings accepted.
   --caller=<name>    Optional metadata passed to innerapi.
   --trace-id=<id>    Optional log-correlation id.
 
 EXIT CODES
-  0    Success: upgrade ran and all validations passed.
+  0    Success: upgrade ran and all validations passed; or gate skipped upgrade.
   1    Failure: npx error, validation failed, or git commit failed.
        File rollback was attempted (see rollbackOk in the JSON output).
+       With --check: exit 1 means upgrade IS needed.
 `
 	},
 	{
@@ -10841,8 +11124,7 @@ OPTIONS
   --role=<role>        Package role (e.g. template, config).
   --name=<name>        Package name within the role.
   --dir=<dir>          Target dir (defaults to dirname(pkg.installPath)).
-  --ctx=<base64>       Opaque ctx; ossFileMap is extracted from it.
-  --oss_file_map=...   Pre-built OSS URL map (base64 JSON).
+  --oss_file_map=...   Pre-built OSS URL map (base64 JSON); skips innerapi.
 `
 	}
 ];
@@ -10918,31 +11200,31 @@ function planVarsFields(opts = {}) {
 *
 * Per-command group needs:
 *
-*   doctor / check    app (rule-driven)
-*   repair            app + secrets   (writes secretsContent / providerKeyContent)
-*   reset             app + secrets + install + reset (the works)
+*   doctor / check    app + larkApps
+*   repair            app + secrets + larkApps
+*   reset             app + secrets + install + reset + larkApps
 *   install-*         install only
 *
 * Empty result (`{}`) means "no group needed" — the CLI can skip the
 * `fetchCtxViaInnerApi` call entirely and run with a synthetic empty ctx.
-* Happens e.g. when the user pinned `--rule=<key>` to a vars-free rule on
-* `doctor`.
 */
 function planCtxPopulate(opts) {
 	if (opts.command === "install") return { install: true };
 	const populate = {};
-	const appFields = planVarsFields({
+	if (planVarsFields({
 		disabled: opts.disabled,
 		onlyRules: opts.onlyRules,
 		profile: opts.profile
-	});
-	if (appFields.length > 0) populate.app = appFields;
-	if (opts.command === "repair") populate.secrets = true;
-	else if (opts.command === "reset") {
+	}).length > 0) populate.app = true;
+	if (opts.command === "repair") {
+		populate.secrets = true;
+		populate.larkApps = true;
+	} else if (opts.command === "reset") {
 		populate.secrets = true;
 		populate.install = true;
 		populate.reset = true;
-	}
+		populate.larkApps = true;
+	} else if (opts.command === "doctor" || opts.command === "check") populate.larkApps = true;
 	return populate;
 }
 //#endregion
@@ -10996,33 +11278,84 @@ function reportDoctorRunToSlardar(opts) {
 		}
 	});
 }
-function readLogFile(filePath) {
-	try {
-		return node_fs.default.readFileSync(filePath, "utf-8");
-	} catch {
-		return "";
-	}
-}
+/**
+* 向 Slardar 上报 upgrade-lark 运行结果（upgrade_lark_run 事件）。
+*
+* ## 标准字段
+* - durationMs：整条命令的总耗时（从 CLI 入口到 runUpgradeLark 返回），含重启阶段。
+* - status：success / failed
+*
+* ## extraCategories（字符串维度）
+* - scene：调用方标识（如 PageUpgradeLark）
+* - check_only：是否为 --check 仅诊断模式
+* - skipped："true" 表示前置门控未触发跳过安装（含 --check 模式），"false" 表示执行了安装
+* - skip_reason：跳过原因描述（skipped=true 时有值，"check" 表示 --check 模式）
+* - exit_code：npx 子进程退出码（跳过安装时为空）
+* - rollback_ok：回滚是否成功（未触发回滚时为空）
+* - validation_error：安装后校验失败的错误信息
+* - error_msg：命令级错误信息
+* - result：执行结果一行摘要（"success: ..."/"failed: ..."/"skipped: ..."/"check: ..."）
+* - log_file：日志文件绝对路径，便于在沙箱中定位完整日志
+*
+* ## extraMetrics（数值指标，单位毫秒）
+* 未执行的阶段上报 -1 作为哨兵值，便于与"运行了 0ms"区分。
+* - pre_probe_ms：[Pre-check A] 升级前 channels probe 耗时
+* - version_check_ms：[Pre-check B] 版本兼容性检测耗时
+* - backup_ms：[1/6] 文件备份耗时
+* - npx_install_ms：[3/6] npx install 耗时（不含安装后 5s 等待）
+* - post_probe_ms：[4/5] 安装后 channels probe 耗时
+* - doctor_fix_ms：[6/6] doctor --fix 耗时
+* 注：[7/7] 重启耗时写入日志但未单独上报，包含在 durationMs 总耗时中。
+*/
 function reportUpgradeLarkToSlardar(opts) {
-	console.error(`[slardar] upgrade_lark_run scene=${opts.scene ?? ""} success=${opts.success} exitCode=${opts.exitCode ?? ""} rollbackOk=${opts.rollbackOk ?? ""}`);
-	const logContent = readLogFile(opts.logFile);
+	console.error(`[slardar] upgrade_lark_run scene=${opts.scene ?? ""} checkOnly=${opts.checkOnly} skipped=${opts.skipped ?? false} success=${opts.success} exitCode=${opts.exitCode ?? ""} rollbackOk=${opts.rollbackOk ?? ""}`);
+	const t = opts.timing ?? {};
 	reportTask({
 		eventName: "upgrade_lark_run",
 		durationMs: opts.durationMs,
 		status: opts.success ? "success" : "failed",
 		extraCategories: {
 			scene: opts.scene ?? "",
+			check_only: String(opts.checkOnly),
+			skipped: String(opts.skipped ?? false),
+			skip_reason: opts.skipReason ?? "",
 			exit_code: String(opts.exitCode ?? ""),
 			rollback_ok: opts.rollbackOk != null ? String(opts.rollbackOk) : "",
 			validation_error: opts.validationError ?? "",
 			error_msg: opts.error ?? "",
-			log_content: logContent
+			result: opts.resultSummary,
+			log_file: opts.logFile
+		},
+		extraMetrics: {
+			pre_probe_ms: t.preProbeMs ?? -1,
+			version_check_ms: t.versionCheckMs ?? -1,
+			backup_ms: t.backupMs ?? -1,
+			npx_install_ms: t.npxInstallMs ?? -1,
+			post_probe_ms: t.postProbeMs ?? -1,
+			doctor_fix_ms: t.doctorFixMs ?? -1
 		}
 	});
 }
+/**
+* 将 upgrade-lark 运行结果归纳为一行摘要字符串，用于 Slardar result 字段。
+*
+* 格式：
+*   "check: upgrade needed"
+*   "check: no upgrade needed"
+*   "skipped: <skipReason>"
+*   "success: upgrade installed"
+*   "success: new default account (plugin installed, awaiting config)"
+*   "failed: <error>"
+*/
+function buildUpgradeLarkResultSummary(opts) {
+	if (opts.checkOnly && opts.skipped) return opts.upgradeNeeded ? "check: upgrade needed" : "check: no upgrade needed";
+	if (opts.skipped) return `skipped: ${opts.skipReason ?? "pre-check gate"}`;
+	if (opts.ok) return "success: upgrade installed";
+	return `failed: ${opts.error ?? opts.validationError ?? "unknown error"}${opts.rollbackOk === false ? " (rollback FAILED)" : opts.rollbackOk ? " (rolled back)" : ""}`;
+}
 //#endregion
 //#region src/upgrade-lark.ts
-/** Plugin directories under extensions/ that are backed up before upgrade */
+/** 升级前需备份的 extensions/ 下的插件目录 */
 const FEISHU_PLUGIN_DIRS = ["openclaw-lark", "feishu-openclaw-plugin"];
 function backupFiles(opts) {
 	const { workspaceDir, configPath, backupDir, log } = opts;
@@ -11034,6 +11367,7 @@ function backupFiles(opts) {
 			node_fs.default.copyFileSync(configPath, node_path.default.join(backupDir, "openclaw.json"));
 			log(`  backed up: openclaw.json (${stat.size} bytes)`);
 		} else log(`  skipped: openclaw.json (not found)`);
+		node_fs.default.mkdirSync(node_path.default.join(backupDir, "extensions"), { recursive: true });
 		const extSrc = node_path.default.join(workspaceDir, "extensions");
 		for (const pluginDir of FEISHU_PLUGIN_DIRS) {
 			const src = node_path.default.join(extSrc, pluginDir);
@@ -11046,32 +11380,43 @@ function backupFiles(opts) {
 		}
 		return { ok: true };
 	} catch (e) {
+		const msg = `backup failed: ${e.message}`;
+		log(`ERROR: ${msg}`);
 		return {
 			ok: false,
-			error: `backup failed: ${e.message}`
+			error: msg
 		};
 	}
 }
 function restoreFiles(opts) {
 	const { workspaceDir, configPath, backupDir, log } = opts;
 	try {
+		if (node_fs.default.existsSync(configPath)) {
+			node_fs.default.rmSync(configPath, { force: true });
+			log(`  deleted: openclaw.json`);
+		}
+		const extDst = node_path.default.join(workspaceDir, "extensions");
+		for (const pluginDir of FEISHU_PLUGIN_DIRS) {
+			const dst = node_path.default.join(extDst, pluginDir);
+			if (node_fs.default.existsSync(dst)) {
+				node_fs.default.rmSync(dst, {
+					recursive: true,
+					force: true
+				});
+				log(`  deleted: extensions/${pluginDir}`);
+			}
+		}
 		const configBackup = node_path.default.join(backupDir, "openclaw.json");
 		if (node_fs.default.existsSync(configBackup)) {
 			node_fs.default.copyFileSync(configBackup, configPath);
 			log(`  restored: openclaw.json`);
-		}
-		const extDst = node_path.default.join(workspaceDir, "extensions");
+		} else log(`  skipped restore: openclaw.json (not in backup — was not present before upgrade)`);
 		for (const pluginDir of FEISHU_PLUGIN_DIRS) {
 			const backupSrc = node_path.default.join(backupDir, "extensions", pluginDir);
 			if (node_fs.default.existsSync(backupSrc)) {
-				const dst = node_path.default.join(extDst, pluginDir);
-				if (node_fs.default.existsSync(dst)) node_fs.default.rmSync(dst, {
-					recursive: true,
-					force: true
-				});
-				node_fs.default.cpSync(backupSrc, dst, { recursive: true });
+				node_fs.default.cpSync(backupSrc, node_path.default.join(extDst, pluginDir), { recursive: true });
 				log(`  restored: extensions/${pluginDir}`);
-			}
+			} else log(`  skipped restore: extensions/${pluginDir} (not in backup — was not present before upgrade)`);
 		}
 		return true;
 	} catch (e) {
@@ -11125,7 +11470,7 @@ function countFeishuBots(configPath) {
 		return 0;
 	}
 }
-/** Run channels probe, log results, and return the result. Never throws. */
+/** 执行 channels probe 并将结果写入日志，从不抛出异常（异常时返回全零结果）。 */
 function probeChannels(label, log, timeoutMs) {
 	try {
 		const r = runChannelsProbe(timeoutMs);
@@ -11133,6 +11478,7 @@ function probeChannels(label, log, timeoutMs) {
 		if (r.error) log(`  ${label} error: ${r.error}`);
 		if (r.gatewayReachable != null) log(`  ${label} gatewayReachable: ${r.gatewayReachable}`);
 		for (const acct of r.accounts ?? []) log(`  ${label} account ${acct.id}: isWorking=${acct.isWorking} bits=[${acct.bits.join(",")}]`);
+		if (r.rawOutput) log(`  ${label} raw output:\n${r.rawOutput}`);
 		return r;
 	} catch (e) {
 		log(`  ${label} channels probe threw: ${e.message}`);
@@ -11148,7 +11494,7 @@ function probeChannels(label, log, timeoutMs) {
 function runUpgradeLark(opts) {
 	const cwd = opts.cwd ?? "/home/gem/workspace/agent";
 	const configPath = opts.configPath ?? CONFIG_PATH;
-	const logFile = upgradeLarkLogFile(opts.runId);
+	const logFile = upgradeLarkLogFile(opts.runId, opts.checkOnly);
 	const log = makeLogger(logFile);
 	const fsOpts = {
 		workspaceDir: cwd,
@@ -11163,12 +11509,16 @@ function runUpgradeLark(opts) {
 	log(`  cwd        : ${cwd}`);
 	log(`  configPath : ${configPath}`);
 	log(`${"=".repeat(60)}`);
+	const timing = {};
 	log("");
 	log("── [Pre-check A] channels probe（升级前）────────────────");
-	const beforeChannels = probeChannels("before", log, 6e4);
+	const t_preProbeStart = Date.now();
+	const beforeChannels = probeChannels("before", log, 3e5);
+	timing.preProbeMs = Date.now() - t_preProbeStart;
 	log("");
 	log("── [Pre-check B] 版本兼容预检 ───────────────────────────");
 	let versionIncompatible = false;
+	const t_versionCheckStart = Date.now();
 	try {
 		const rawConfig = node_fs.default.readFileSync(configPath, "utf-8");
 		versionIncompatible = needsLarkUpgrade({
@@ -11184,6 +11534,7 @@ function runUpgradeLark(opts) {
 	} catch (e) {
 		log(`  version-compat pre-check error: ${e.message} — version signal unavailable`);
 	}
+	timing.versionCheckMs = Date.now() - t_versionCheckStart;
 	const feishuConfigInvalid = beforeChannels.feishuConfigInvalid;
 	log(`  feishu config invalid  : ${feishuConfigInvalid}`);
 	log("");
@@ -11201,6 +11552,8 @@ function runUpgradeLark(opts) {
 			ok: true,
 			skipped: true,
 			skipReason: reason,
+			upgradeNeeded: false,
+			timing,
 			logFile
 		};
 	}
@@ -11214,19 +11567,38 @@ function runUpgradeLark(opts) {
 			ok: true,
 			skipped: true,
 			skipReason: reason,
+			upgradeNeeded: false,
+			timing,
 			logFile
 		};
 	}
 	log(`  PROCEED: requiresLarkUpgrade=true (version=${versionIncompatible}, feishuConfig=${feishuConfigInvalid}) AND channels not working → running upgrade`);
+	if (opts.checkOnly) {
+		log(`  --check 模式：需要升级 — 不执行安装，直接返回`);
+		log(`${"=".repeat(60)}`);
+		log("upgrade-lark check complete");
+		log(`${"=".repeat(60)}`);
+		return {
+			ok: true,
+			skipped: true,
+			skipReason: "check",
+			upgradeNeeded: true,
+			timing,
+			logFile
+		};
+	}
 	log("");
 	log("── [1/6] 文件备份 ────────────────────────────────────────");
 	log(`before-state: botCount=${countFeishuBots(configPath)}`);
+	const t_backupStart = Date.now();
 	const backup = backupFiles(fsOpts);
+	timing.backupMs = Date.now() - t_backupStart;
 	if (!backup.ok) {
 		log(`ERROR: ${backup.error}`);
 		return {
 			ok: false,
 			error: backup.error,
+			timing,
 			logFile
 		};
 	}
@@ -11244,6 +11616,7 @@ function runUpgradeLark(opts) {
 	else log(`  skipped: ${localOpenclawBin} (not found)`);
 	log("");
 	log("── [3/6] npx install (@larksuite/openclaw-lark-tools update) ──");
+	const t_npxStart = Date.now();
 	const npxResult = (0, node_child_process.spawnSync)("npx", [
 		"-y",
 		"@larksuite/openclaw-lark-tools",
@@ -11256,8 +11629,9 @@ function runUpgradeLark(opts) {
 			"pipe",
 			"pipe"
 		],
-		timeout: 12e4
+		timeout: 6e5
 	});
+	timing.npxInstallMs = Date.now() - t_npxStart;
 	const npxStdout = npxResult.stdout?.trim() ?? "";
 	const npxStderr = npxResult.stderr?.trim() ?? "";
 	const npxExitCode = npxResult.status ?? 1;
@@ -11282,6 +11656,7 @@ function runUpgradeLark(opts) {
 			stderr: npxStderr,
 			exitCode: npxExitCode,
 			rollbackOk,
+			timing,
 			logFile
 		};
 	};
@@ -11304,16 +11679,21 @@ function runUpgradeLark(opts) {
 	} catch (e) {
 		log(`  version-compat post-check error: ${e.message} — version signal unavailable`);
 	}
-	const afterChannels = probeChannels("after", log, 6e4);
+	const t_postProbeStart = Date.now();
+	const afterChannels = probeChannels("after", log, 3e5);
+	timing.postProbeMs = Date.now() - t_postProbeStart;
 	log(`  feishu config invalid after: ${afterChannels.feishuConfigInvalid}`);
 	const stillNeedsUpgrade = (afterVersionIncompatible || afterChannels.feishuConfigInvalid) && !afterChannels.anyAccountWorking;
-	log(`  post-check: stillNeedsUpgrade=${stillNeedsUpgrade} (version=${afterVersionIncompatible}, feishuConfig=${afterChannels.feishuConfigInvalid}, channelsWorking=${afterChannels.anyAccountWorking})`);
-	if (stillNeedsUpgrade) return doRollback(`post-install diagnosis still shows anomaly: versionIncompatible=${afterVersionIncompatible}, feishuConfigInvalid=${afterChannels.feishuConfigInvalid}, anyAccountWorking=${afterChannels.anyAccountWorking}`);
-	log("  post-install diagnosis: ok (upgrade conditions resolved)");
+	const isNewDefaultOnly = !afterVersionIncompatible && !afterChannels.feishuConfigInvalid && !beforeChannels.anyAccountWorking && isDefaultOnlyState(afterChannels);
+	log(`  post-check: stillNeedsUpgrade=${stillNeedsUpgrade} (version=${afterVersionIncompatible}, feishuConfig=${afterChannels.feishuConfigInvalid}, channelsWorking=${afterChannels.anyAccountWorking}) isNewDefaultOnly=${isNewDefaultOnly}`);
+	if (stillNeedsUpgrade && !isNewDefaultOnly) return doRollback(`post-install diagnosis still shows anomaly: versionIncompatible=${afterVersionIncompatible}, feishuConfigInvalid=${afterChannels.feishuConfigInvalid}, anyAccountWorking=${afterChannels.anyAccountWorking}`);
+	if (isNewDefaultOnly) log("  post-install diagnosis: ok (new default account — plugin installed, awaiting configuration)");
+	else log("  post-install diagnosis: ok (upgrade conditions resolved)");
 	log("");
 	log("── [6/6] doctor --fix ────────────────────────────────────");
 	const fixArgs = ["doctor", "--fix"];
 	if (opts.scene) fixArgs.push(`--scene=${opts.scene}`);
+	const t_doctorFixStart = Date.now();
 	const fixResult = (0, node_child_process.spawnSync)(process.execPath, [cliScript, ...fixArgs], {
 		cwd,
 		encoding: "utf-8",
@@ -11325,10 +11705,31 @@ function runUpgradeLark(opts) {
 		timeout: 6e4,
 		env: process.env
 	});
+	timing.doctorFixMs = Date.now() - t_doctorFixStart;
 	if (fixResult.stdout?.trim()) log(`doctor(fix) stdout:\n${fixResult.stdout.trim()}`);
 	if (fixResult.stderr?.trim()) log(`doctor(fix) stderr:\n${fixResult.stderr.trim()}`);
 	log(`doctor(fix) exit: ${fixResult.status ?? "null"}${fixResult.error ? ` error: ${fixResult.error.message}` : ""}`);
 	log("");
+	log("── [7/7] 重启 openclaw 服务 ──────────────────────────────");
+	const restartScript = "/opt/force/bin/openclaw_scripts/restart.sh";
+	if (opts.skipRestart) log("  skipped: --skip-restart");
+	else if (node_fs.default.existsSync(restartScript)) {
+		const t_restart = Date.now();
+		const restartResult = (0, node_child_process.spawnSync)("bash", [restartScript], {
+			encoding: "utf-8",
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			],
+			timeout: 3e4
+		});
+		const restartMs = Date.now() - t_restart;
+		if (restartResult.stdout?.trim()) log(`  restart stdout:\n${restartResult.stdout.trim()}`);
+		if (restartResult.stderr?.trim()) log(`  restart stderr:\n${restartResult.stderr.trim()}`);
+		log(`  restart.sh exit: ${restartResult.status ?? "null"} (${restartMs}ms)${restartResult.error ? ` error: ${restartResult.error.message}` : ""}`);
+	} else log(`  skipped: ${restartScript} not found`);
+	log("");
 	log(`${"=".repeat(60)}`);
 	log("upgrade-lark completed successfully");
 	log(`${"=".repeat(60)}`);
@@ -11337,6 +11738,7 @@ function runUpgradeLark(opts) {
 		stdout: npxStdout,
 		stderr: npxStderr,
 		exitCode: npxExitCode,
+		timing,
 		logFile
 	};
 }
@@ -11345,21 +11747,6 @@ function runUpgradeLark(opts) {
 const args = node_process.default.argv.slice(2);
 const mode = args.find((a) => !a.startsWith("-"));
 /**
-* Decode `--ctx=<base64>` into an opaque JSON object. Returns undefined when
-* the flag isn't present — the caller decides whether to fall back to the
-* innerapi or to error out.
-*
-* The object's shape is not enforced here; downstream code consumes it via
-* either `normalizeCtx()` (new path) or direct field access for the legacy
-* check/repair/reset contract still used by sandbox_console push.
-*/
-function parseCtxFlag(args) {
-	const ctxArg = args.find((a) => a.startsWith("--ctx="));
-	if (!ctxArg) return void 0;
-	const b64 = ctxArg.slice(6);
-	return JSON.parse(Buffer.from(b64, "base64").toString("utf-8"));
-}
-/**
 * Pull the first non-flag positional after the mode name.
 * (The mode itself is args[0] in the filtered set, so we skip index 0.)
 */
@@ -11387,8 +11774,8 @@ function getMultiFlag(args, name) {
 * case but is no longer consulted.
 */
 async function reportRun(command, rc, _raw, invocation, durationMs, outcome, slardar = {
-	scene,
-	profile,
+	scene: void 0,
+	profile: "standard",
 	fix: false
 }) {
 	console.error(`${command}: telemetry calling report_cli_run`);
@@ -11452,7 +11839,7 @@ async function main() {
 	console.error(`${mode}: begin argv=[${args.join(" ")}] version=${getVersion()} traceId=${traceId ?? "-"} caller=${caller ?? "-"} runIdGenerated=${rc.generated}`);
 	switch (mode) {
 		case "check": {
-			const raw = parseCtxFlag(args) ?? await fetchCtxViaInnerApi({
+			const raw = await fetchCtxViaInnerApi({
 				populate: planCtxPopulate({
 					command: "check",
 					profile
@@ -11477,7 +11864,7 @@ async function main() {
 			break;
 		}
 		case "repair": {
-			const raw = parseCtxFlag(args) ?? await fetchCtxViaInnerApi({
+			const raw = await fetchCtxViaInnerApi({
 				populate: planCtxPopulate({
 					command: "repair",
 					profile
@@ -11548,27 +11935,15 @@ async function main() {
 			break;
 		}
 		case "reset":
-			if (args.includes("--async")) {
-				const ctxArg = args.find((a) => a.startsWith("--ctx="));
-				let ctxBase64;
-				if (ctxArg) ctxBase64 = ctxArg.slice(6);
-				else {
-					const fetched = await fetchCtxViaInnerApi({
-						populate: planCtxPopulate({ command: "reset" }),
-						caller,
-						traceId
-					});
-					ctxBase64 = Buffer.from(JSON.stringify(fetched), "utf-8").toString("base64");
-				}
-				console.log(JSON.stringify(startAsyncReset(ctxBase64)));
-			} else if (args.includes("--worker")) {
+			if (args.includes("--async")) console.log(JSON.stringify(startAsyncReset()));
+			else if (args.includes("--worker")) {
 				const taskId = args.find((a) => a.startsWith("--task-id="))?.slice(10);
 				if (!taskId) {
 					console.error("Error: --task-id=<id> is required for worker");
 					node_process.default.exit(1);
 				}
 				const resultFile = resetResultFile(taskId);
-				const raw = parseCtxFlag(args) ?? await fetchCtxViaInnerApi({
+				const raw = await fetchCtxViaInnerApi({
 					populate: planCtxPopulate({ command: "reset" }),
 					caller,
 					traceId
@@ -11592,7 +11967,7 @@ async function main() {
 					return;
 				}
 			} else {
-				console.error("Usage: reset --async [--ctx=<base64>] | reset --worker --task-id=<id> [--ctx=<base64>]");
+				console.error("Usage: reset --async | reset --worker --task-id=<id>");
 				node_process.default.exit(1);
 			}
 			break;
@@ -11608,14 +11983,14 @@ async function main() {
 		case "install-openclaw": {
 			const tag = getPositionalTag(args, "install-openclaw");
 			if (!tag) {
-				console.error("Usage: install-openclaw <tag> [--ctx=<base64> | --oss_file_map=<base64>]");
+				console.error("Usage: install-openclaw <tag> [--oss_file_map=<base64>]");
 				node_process.default.exit(1);
 			}
 			const ossFileMapFlag = getFlag(args, "oss_file_map");
 			let installOssFileMap;
 			let rawForTelemetry;
 			if (!ossFileMapFlag) {
-				rawForTelemetry = parseCtxFlag(args) ?? await fetchCtxViaInnerApi({
+				rawForTelemetry = await fetchCtxViaInnerApi({
 					populate: planCtxPopulate({ command: "install" }),
 					caller,
 					traceId
@@ -11650,7 +12025,7 @@ async function main() {
 		case "install-extension": {
 			const tag = getPositionalTag(args, "install-extension");
 			if (!tag) {
-				console.error("Usage: install-extension <tag> (--all | --extension=<name>...) [--home_base=<dir>] [--config_path=<path>] [--skip-config-update] [--ctx=<base64> | --oss_file_map=<base64>]");
+				console.error("Usage: install-extension <tag> (--all | --extension=<name>...) [--home_base=<dir>] [--config_path=<path>] [--skip-config-update] [--oss_file_map=<base64>]");
 				node_process.default.exit(1);
 			}
 			const all = args.includes("--all");
@@ -11662,7 +12037,7 @@ async function main() {
 			let installOssFileMap;
 			let rawForTelemetry;
 			if (!ossFileMapFlag) {
-				rawForTelemetry = parseCtxFlag(args) ?? await fetchCtxViaInnerApi({
+				rawForTelemetry = await fetchCtxViaInnerApi({
 					populate: planCtxPopulate({ command: "install" }),
 					caller,
 					traceId
@@ -11708,12 +12083,12 @@ async function main() {
 		case "install-cli": {
 			const tag = getPositionalTag(args, "install-cli");
 			if (!tag) {
-				console.error("Usage: install-cli <tag> --cli=<name>... [--home_base=<dir>] [--ctx=<base64> | --oss_file_map=<base64>]");
+				console.error("Usage: install-cli <tag> --cli=<name>... [--home_base=<dir>] [--oss_file_map=<base64>]");
 				node_process.default.exit(1);
 			}
 			const names = getMultiFlag(args, "cli");
 			if (names.length === 0) {
-				console.error("Usage: install-cli <tag> --cli=<name>... [--home_base=<dir>] [--ctx=<base64> | --oss_file_map=<base64>]");
+				console.error("Usage: install-cli <tag> --cli=<name>... [--home_base=<dir>] [--oss_file_map=<base64>]");
 				node_process.default.exit(1);
 			}
 			const homeBase = getFlag(args, "home_base");
@@ -11721,7 +12096,7 @@ async function main() {
 			let installOssFileMap;
 			let rawForTelemetry;
 			if (!ossFileMapFlag) {
-				rawForTelemetry = parseCtxFlag(args) ?? await fetchCtxViaInnerApi({
+				rawForTelemetry = await fetchCtxViaInnerApi({
 					populate: planCtxPopulate({ command: "install" }),
 					caller,
 					traceId
@@ -11769,7 +12144,7 @@ async function main() {
 		case "download-resource": {
 			const tag = getPositionalTag(args, "download-resource");
 			if (!tag) {
-				console.error("Usage: download-resource <tag> --role=<role> --name=<name> [--dir=<dir>] [--ctx=<base64> | --oss_file_map=<base64>]");
+				console.error("Usage: download-resource <tag> --role=<role> --name=<name> [--dir=<dir>] [--oss_file_map=<base64>]");
 				node_process.default.exit(1);
 			}
 			const role = getFlag(args, "role");
@@ -11783,7 +12158,7 @@ async function main() {
 			let installOssFileMap;
 			let rawForTelemetry;
 			if (!ossFileMapFlag) {
-				rawForTelemetry = parseCtxFlag(args) ?? await fetchCtxViaInnerApi({
+				rawForTelemetry = await fetchCtxViaInnerApi({
 					populate: planCtxPopulate({ command: "install" }),
 					caller,
 					traceId
@@ -11858,21 +12233,39 @@ async function main() {
 			break;
 		}
 		case "upgrade-lark": {
+			const checkOnly = args.includes("--check");
+			const skipRestart = args.includes("--skip-restart");
 			const result = runUpgradeLark({
 				runId: rc.runId,
-				scene
+				scene,
+				checkOnly,
+				skipRestart
 			});
 			const upgradeDurationMs = Date.now() - t0;
 			console.log(JSON.stringify(result));
 			reportUpgradeLarkToSlardar({
 				scene,
+				checkOnly,
 				durationMs: upgradeDurationMs,
 				success: result.ok,
+				skipped: result.skipped,
+				skipReason: result.skipReason,
 				logFile: result.logFile,
+				resultSummary: buildUpgradeLarkResultSummary({
+					ok: result.ok,
+					checkOnly,
+					skipped: result.skipped,
+					skipReason: result.skipReason,
+					upgradeNeeded: result.upgradeNeeded,
+					error: result.error,
+					validationError: result.validationError,
+					rollbackOk: result.rollbackOk
+				}),
 				exitCode: result.exitCode,
 				rollbackOk: result.rollbackOk,
 				validationError: result.validationError,
-				error: result.error
+				error: result.error,
+				timing: result.timing
 			});
 			try {
 				await reportCliRun({
@@ -11890,14 +12283,16 @@ async function main() {
 			} catch (e) {
 				console.error(`[telemetry] reportCliRun failed: ${e.message}`);
 			}
-			if (!result.ok) {
+			if (!result.ok || checkOnly && result.upgradeNeeded) {
 				node_process.default.exitCode = 1;
 				return;
 			}
 			break;
 		}
 		case "channels-probe": {
-			const result = runChannelsProbe(getFlag(args, "timeout") ? Number(getFlag(args, "timeout")) : void 0);
+			const timeoutRaw = getFlag(args, "timeout");
+			const parsed = timeoutRaw != null ? Number(timeoutRaw) : NaN;
+			const result = runChannelsProbe(timeoutRaw != null ? Number.isNaN(parsed) ? 6e4 : Math.max(1e3, parsed) : void 0);
 			console.log(JSON.stringify(result));
 			break;
 		}