@lark-apaas/openclaw-scripts-diagnose-cli 0.1.15-alpha.1 → 0.1.15-alpha.2

package/dist/index.cjs

@@ -52,7 +52,7 @@ node_assert = __toESM(node_assert);
 * it terse and parseable.
 */
 function getVersion() {
-	return "0.1.15-alpha.1";
+	return "0.1.15-alpha.2";
 }
 //#endregion
 //#region src/rule-engine/base.ts
@@ -10581,7 +10581,7 @@ async function reportCliRun(opts) {
 //#region src/help.ts
 const BIN = "mclaw-diagnose";
 function versionBanner() {
-	return `v0.1.15-alpha.1`;
+	return `v0.1.15-alpha.2`;
 }
 const COMMANDS = [
 	{
@@ -10875,7 +10875,7 @@ EXIT CODES
 		hidden: false,
 		summary: "Upgrade the Feishu/Lark plugin via @larksuite/openclaw-lark-tools",
 		help: `USAGE
-  ${BIN} upgrade-lark [--check-only] [--scene=<scene>] [--caller=<n>] [--trace-id=<id>]
+  ${BIN} upgrade-lark [--check] [--scene=<scene>] [--caller=<n>] [--trace-id=<id>]
 
 DESCRIPTION
   Upgrades the Feishu/Lark plugin by running:
@@ -10903,12 +10903,12 @@ DESCRIPTION
     { "ok": false, "error": "...", "stderr": "...", "exitCode": 1,
       "rollbackOk": true, "validationError": "...", "logFile": "..." }
 
-  With --check-only:
+  With --check:
     { "ok": true, "skipped": true, "upgradeNeeded": false, "logFile": "..." }
     { "ok": true, "skipped": true, "upgradeNeeded": true,  "logFile": "..." }  ← exit 1
 
 OPTIONS
-  --check-only       Diagnose only: run the pre-check gate and report whether
+  --check       Diagnose only: run the pre-check gate and report whether
                      upgrade is needed without installing. Exit 1 if needed.
   --scene=<scene>    Telemetry label forwarded to Slardar only.
                      Known values: PageUpgradeLark, etc. Custom strings accepted.
@@ -10919,7 +10919,7 @@ EXIT CODES
   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-only: exit 1 means upgrade IS needed.
+       With --check: exit 1 means upgrade IS needed.
 `
 	},
 	{
@@ -11162,10 +11162,18 @@ function reportDoctorRunToSlardar(opts) {
 		}
 	});
 }
-/** 读取日志文件全文；文件不存在或读取失败时返回空字符串。 */
-function readLogFile(filePath) {
+/**
+* 读取日志文件末尾最多 maxBytes 个字节。
+* 日志头部为固定 banner，有价值的内容（错误、探测结果、回滚状态）集中在末尾。
+* 从尾部截取保证 Slardar 字段限制内优先保留关键内容。
+*/
+function readLogFileTail(filePath, maxBytes = 4e3) {
 	try {
-		return node_fs.default.readFileSync(filePath, "utf-8");
+		const buf = node_fs.default.readFileSync(filePath);
+		if (buf.length <= maxBytes) return buf.toString("utf-8");
+		let start = buf.length - maxBytes;
+		while (start < buf.length && buf[start] !== 10) start++;
+		return buf.subarray(start + 1).toString("utf-8");
 	} catch {
 		return "";
 	}
@@ -11174,21 +11182,22 @@ function readLogFile(filePath) {
 * 向 Slardar 上报 upgrade-lark 运行结果（upgrade_lark_run 事件）。
 *
 * extraCategories 记录字符串维度：scene、exit_code、rollback_ok、
-* validation_error、error_msg、log_content（日志文件全文）。
+* validation_error、error_msg、log_content（日志文件末尾 4000 字节，含关键结果）。
 *
 * extraMetrics 记录各阶段耗时（毫秒）；未执行的阶段上报 -1 作为哨兵值，
 * 便于在 Slardar 查询时区分"未运行"和"运行了 0ms"。
 */
 function reportUpgradeLarkToSlardar(opts) {
-	console.error(`[slardar] upgrade_lark_run scene=${opts.scene ?? ""} success=${opts.success} exitCode=${opts.exitCode ?? ""} rollbackOk=${opts.rollbackOk ?? ""}`);
+	console.error(`[slardar] upgrade_lark_run scene=${opts.scene ?? ""} checkOnly=${opts.checkOnly} success=${opts.success} exitCode=${opts.exitCode ?? ""} rollbackOk=${opts.rollbackOk ?? ""}`);
 	const t = opts.timing ?? {};
-	const logContent = readLogFile(opts.logFile);
+	const logContent = readLogFileTail(opts.logFile);
 	reportTask({
 		eventName: "upgrade_lark_run",
 		durationMs: opts.durationMs,
 		status: opts.success ? "success" : "failed",
 		extraCategories: {
 			scene: opts.scene ?? "",
+			check_only: String(opts.checkOnly),
 			exit_code: String(opts.exitCode ?? ""),
 			rollback_ok: opts.rollbackOk != null ? String(opts.rollbackOk) : "",
 			validation_error: opts.validationError ?? "",
@@ -11413,14 +11422,14 @@ function runUpgradeLark(opts) {
 	}
 	log(`  PROCEED: requiresLarkUpgrade=true (version=${versionIncompatible}, feishuConfig=${feishuConfigInvalid}) AND channels not working → running upgrade`);
 	if (opts.checkOnly) {
-		log(`  check-only: upgrade IS needed — returning without installing`);
+		log(`  --check 模式：需要升级 — 不执行安装，直接返回`);
 		log(`${"=".repeat(60)}`);
-		log("upgrade-lark check-only complete");
+		log("upgrade-lark check complete");
 		log(`${"=".repeat(60)}`);
 		return {
 			ok: true,
 			skipped: true,
-			skipReason: "check-only",
+			skipReason: "check",
 			upgradeNeeded: true,
 			timing,
 			logFile
@@ -12050,7 +12059,7 @@ async function main() {
 			break;
 		}
 		case "upgrade-lark": {
-			const checkOnly = args.includes("--check-only");
+			const checkOnly = args.includes("--check");
 			const result = runUpgradeLark({
 				runId: rc.runId,
 				scene,
@@ -12060,6 +12069,7 @@ async function main() {
 			console.log(JSON.stringify(result));
 			reportUpgradeLarkToSlardar({
 				scene,
+				checkOnly,
 				durationMs: upgradeDurationMs,
 				success: result.ok,
 				logFile: result.logFile,

package/package.json

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