@lark-apaas/openclaw-scripts-diagnose-cli 0.1.9-alpha.1 → 0.1.10-alpha.0

package/dist/index.cjs

@@ -52,7 +52,7 @@ node_assert = __toESM(node_assert);
 * it terse and parseable.
 */
 function getVersion() {
-	return "0.1.9-alpha.1";
+	return "0.1.10-alpha.0";
 }
 //#endregion
 //#region src/rule-engine/base.ts
@@ -1523,6 +1523,133 @@ function applyVars(str, entries) {
 	return out;
 }
 //#endregion
+//#region src/rules/agents-md-paths.ts
+function collectExistingAgentsMdPaths(ctx) {
+	const paths = /* @__PURE__ */ new Set();
+	if (ctx.configPath) paths.add(node_path.default.join(node_path.default.dirname(ctx.configPath), "workspace", "AGENTS.md"));
+	const agents = asRecord(ctx.config.agents);
+	const list = Array.isArray(agents?.list) ? agents.list : [];
+	for (const item of list) {
+		const agent = asRecord(item);
+		if (typeof agent?.workspace === "string" && agent.workspace) paths.add(node_path.default.join(agent.workspace, "AGENTS.md"));
+	}
+	return [...paths].filter((filePath) => node_fs.default.existsSync(filePath));
+}
+//#endregion
+//#region src/rules/agents-md-service-commands.ts
+const SERVICE_COMMAND_REPLACEMENTS = [
+	["`sh scripts/start.sh`", "`sh /opt/force/bin/openclaw_scripts/start.sh`"],
+	["`sh scripts/restart.sh`", "`sh /opt/force/bin/openclaw_scripts/restart.sh`"],
+	["`sh scripts/stop.sh`", "`sh /opt/force/bin/openclaw_scripts/stop.sh`"]
+];
+let AgentsMdServiceCommandsRule = class AgentsMdServiceCommandsRule extends DiagnoseRule {
+	validate(ctx) {
+		const agentsMdPath = collectExistingAgentsMdPaths(ctx).find((filePath) => {
+			return hasOldServiceCommands(node_fs.default.readFileSync(filePath, "utf-8"));
+		});
+		if (!agentsMdPath) return { pass: true };
+		return {
+			pass: false,
+			message: `${agentsMdPath} 中存在旧版服务命令，需要改为 /opt/force/bin/openclaw_scripts 路径`
+		};
+	}
+	repair(ctx) {
+		for (const agentsMdPath of collectExistingAgentsMdPaths(ctx)) {
+			const content = node_fs.default.readFileSync(agentsMdPath, "utf-8");
+			const next = replaceOldServiceCommands(content);
+			if (next !== content) node_fs.default.writeFileSync(agentsMdPath, next, "utf-8");
+		}
+	}
+};
+AgentsMdServiceCommandsRule = __decorate([Rule({
+	key: "agents_md_service_commands",
+	description: "检测各智能体 AGENTS.md 中旧版 OpenClaw 服务命令，并替换为 /opt/force/bin/openclaw_scripts 路径",
+	dependsOn: ["config_syntax_check"],
+	repairMode: "standard"
+})], AgentsMdServiceCommandsRule);
+function hasOldServiceCommands(content) {
+	return SERVICE_COMMAND_REPLACEMENTS.some(([oldCmd]) => content.includes(oldCmd));
+}
+function replaceOldServiceCommands(content) {
+	let next = content;
+	for (const [oldCmd, newCmd] of SERVICE_COMMAND_REPLACEMENTS) next = next.split(oldCmd).join(newCmd);
+	return next;
+}
+//#endregion
+//#region src/rules/agents-md-resource-constrained-tools.ts
+const RESOURCE_CONSTRAINED_TOOLS_TAG = "resource_constrained_tools";
+const RESOURCE_CONSTRAINED_TOOLS_BLOCK = [
+	"<resource_constrained_tools>",
+	"### Browser tab 管理",
+	"Chrome tab 是沙箱里的**头号资源杀手**：在线上 OpenClaw 集群的 Mem Top10 里占 42%、CPU Top10 里占 70%。下面规则**全部**指 `browser` 工具自身的 action（不是别的 MCP），按\"调用前 / 调用后 / 自查 / 兜底\"四阶段顺序遵守，不要跳。",
+	"#### 调用 `browser action: \"open\"` 之前——必答两问",
+	"1. 我上一次 `open` 的 tab 是否还活着？活着 → 用 `action: \"navigate\"` + 它的 `targetId` 换 URL，**不要新开**。",
+	"2. 完成这次访问后，我下一步能不能立刻 `close`？不能 → 拆小任务，先不开。",
+	"#### 调用 `browser action: \"open\"` 之后——下一个 `browser` 工具调用必须是以下之一",
+	"- `action: \"navigate\"`（带 open 返回的 `targetId`）：复用此 tab 换 URL。",
+	"- `action: \"close\"`（带 open 返回的 `targetId`）：关闭此 tab，任务结束。",
+	"- `action: \"snapshot\"` / `\"click\"` / `\"type\"` 等：仅当**当前任务仍在这个 tab 上推进**时可用；任务做完仍必须显式 `close` 并传 `targetId`。",
+	"**严禁**下面这种序列（线上实测到的 chrome 内存 Top1 故障模式）：",
+	"    BAD:",
+	"      browser(open, url=A) → snapshot",
+	"      → browser(open, url=B) → snapshot",
+	"      → browser(open, url=C) → snapshot",
+	"      → …（任务结束未关）",
+	"      # 每次 open 都新建一个 tab；snapshot 不会关；chrome 堆栈式泄漏。",
+	"应该写成：",
+	"    GOOD:",
+	"      browser(open, url=A) → snapshot",
+	"      → browser(navigate, targetId=t1, url=B) → snapshot",
+	"      → … → browser(close, targetId=t1)",
+	"      # 始终复用同一个 tab；任务结束显式 close。",
+	"#### 异常时止损",
+	"发现 Chrome 卡顿、心跳延迟、沙箱负载升高：先 `close` 所有非活跃 tab；仍不行就让 shell 杀掉 chrome 进程（`pkill -INT chromium-browser` 或等价命令）让它按需重启，**不要**继续开新 tab。",
+	"### FFmpeg / 媒体编码使用限制",
+	"ffmpeg 默认吃满所有 CPU 核心，沙箱只有 1–2 vCPU，一次无约束转码就能拖垮心跳和 Browser。下面的规则**只针对 shell 直接调用的 `ffmpeg` / `ffprobe`**：",
+	"- **优先用 skill：** `skills/video-frames` 等媒体 skill 是已审查过的窄用例，跟着它们的写法走比自己手撸 ffmpeg 安全；只在 skill 不覆盖时才直接 shell `ffmpeg`。注意 `video-frames` 抽中后段帧用 `--time`（demuxer seek，几乎零 CPU）而非 `--index N`（会从头解码 N 帧）。",
+	"- **先 probe 再 encode：** 转码前先 `ffprobe -v error -threads 1 -show_streams -show_format -of json <input>` 拿到时长、码率、编码；能用 `-c copy` 流拷贝就绝不重编码；时长超 1200s 先 `-t` 截断或拒绝任务。",
+	"- **强制限线程：** 必须显式带 `-threads 1`（最多 `-threads 2`），滤镜链追加 `-filter_threads 1 -filter_complex_threads 1`。",
+	"- **软件编码必须 ultrafast：** x264/x265 统一 `-preset ultrafast`，禁止 `medium` 及以上预设；质量不够时降分辨率（`-vf scale=-2:720`）或降帧率（`-r 24`），不要靠提高 preset。",
+	"- **禁止并发 ffmpeg：** 同一沙箱内同时只允许一个 ffmpeg 进程，开下一个前用 `pgrep -x ffmpeg` 确认无残留；禁止 `xargs -P`、禁止循环里并行批处理。",
+	"- **必须前台 + 超时兜底：** 用 `timeout 45 ffmpeg -nostdin -hide_banner -loglevel error ...` 包一层（与上游 `MEDIA_FFMPEG_TIMEOUT_MS` 对齐，最多放宽到 `timeout 90`），ffprobe 用 `timeout 10`；禁止 `&` 后台、禁止 `nohup`，跑飞时必须能 Ctrl-C 打断。",
+	"- **中间产物即用即删：** 临时切片、调色板、`-pass 1` log 等，任务结束或失败时立即 `rm -f`，不要把 `/tmp/*.mp4`、`ffmpeg2pass-*.log` 留到下一个任务。",
+	"- **异常时硬停：** 沙箱变慢、心跳丢失、或 `frame=` 长时间不前进，立即 `pkill -INT ffmpeg`（不行就 `-KILL`）；**不要**重试相同命令，先降分辨率/preset 或改用流拷贝。",
+	"</resource_constrained_tools>"
+].join("\n");
+let AgentsMdResourceConstrainedToolsRule = class AgentsMdResourceConstrainedToolsRule extends DiagnoseRule {
+	validate(ctx) {
+		const stalePath = collectExistingAgentsMdPaths(ctx).find((filePath) => {
+			return !hasCurrentResourceConstrainedToolsBlock(node_fs.default.readFileSync(filePath, "utf-8"));
+		});
+		if (!stalePath) return { pass: true };
+		return {
+			pass: false,
+			message: `${stalePath} 中缺少或存在旧版 resource_constrained_tools，需要更新`
+		};
+	}
+	repair(ctx) {
+		for (const filePath of collectExistingAgentsMdPaths(ctx)) {
+			const content = node_fs.default.readFileSync(filePath, "utf-8");
+			const next = upsertResourceConstrainedToolsBlock(content);
+			if (next !== content) node_fs.default.writeFileSync(filePath, next, "utf-8");
+		}
+	}
+};
+AgentsMdResourceConstrainedToolsRule = __decorate([Rule({
+	key: "agents_md_resource_constrained_tools",
+	description: "检测各智能体 AGENTS.md 中 resource_constrained_tools 规则块，缺失时追加，存在时替换为当前内容",
+	dependsOn: ["config_syntax_check"],
+	repairMode: "standard"
+})], AgentsMdResourceConstrainedToolsRule);
+function hasCurrentResourceConstrainedToolsBlock(content) {
+	return content.includes(RESOURCE_CONSTRAINED_TOOLS_BLOCK);
+}
+function upsertResourceConstrainedToolsBlock(content) {
+	const tagRe = new RegExp(`<${RESOURCE_CONSTRAINED_TOOLS_TAG}>[\\s\\S]*?</${RESOURCE_CONSTRAINED_TOOLS_TAG}>`);
+	if (tagRe.test(content)) return content.replace(tagRe, RESOURCE_CONSTRAINED_TOOLS_BLOCK);
+	return `${content}${content.length > 0 && !content.endsWith("\n") ? "\n\n" : "\n"}${RESOURCE_CONSTRAINED_TOOLS_BLOCK}\n`;
+}
+//#endregion
 //#region src/rules/model-provider.ts
 const DEFAULT_API_KEY = {
 	source: "file",
@@ -9875,7 +10002,7 @@ async function reportCliRun(opts) {
 //#region src/help.ts
 const BIN = "mclaw-diagnose";
 function versionBanner() {
-	return `v0.1.9-alpha.1`;
+	return `v0.1.10-alpha.0`;
 }
 const COMMANDS = [
 	{

package/package.json

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