@wemind/cli 1.2.0 → 1.3.0

package/dist/cli.js

@@ -973,6 +973,8 @@ function normAgentFields(j) {
 	if (typeof j.bin === "string" && j.bin.trim()) cfg.bin = j.bin.trim();
 	if (Array.isArray(j.args)) cfg.args = j.args.filter((x) => typeof x === "string");
 	else if (typeof j.args === "string" && j.args.trim()) cfg.args = j.args.trim().split(/\s+/);
+	if (Array.isArray(j.extraArgs)) cfg.extraArgs = j.extraArgs.filter((x) => typeof x === "string");
+	else if (typeof j.extraArgs === "string" && j.extraArgs.trim()) cfg.extraArgs = j.extraArgs.trim().split(/\s+/);
 	if (typeof j.shell === "boolean") cfg.shell = j.shell;
 	if (typeof j.homeEnvVar === "string" && j.homeEnvVar.trim()) cfg.homeEnvVar = j.homeEnvVar.trim();
 	if (typeof j.model === "string" && j.model.trim()) cfg.model = j.model.trim();
@@ -984,6 +986,8 @@ function normPresetOverride(j) {
 	if (typeof j?.bin === "string" && j.bin.trim()) ov.bin = j.bin.trim();
 	if (Array.isArray(j?.args)) ov.args = j.args.filter((x) => typeof x === "string");
 	else if (typeof j?.args === "string" && j.args.trim()) ov.args = j.args.trim().split(/\s+/);
+	if (Array.isArray(j?.extraArgs)) ov.extraArgs = j.extraArgs.filter((x) => typeof x === "string");
+	else if (typeof j?.extraArgs === "string" && j.extraArgs.trim()) ov.extraArgs = j.extraArgs.trim().split(/\s+/);
 	if (typeof j?.shell === "boolean") ov.shell = j.shell;
 	if (typeof j?.homeEnvVar === "string" && j.homeEnvVar.trim()) ov.homeEnvVar = j.homeEnvVar.trim();
 	if (typeof j?.model === "string" && j.model.trim()) ov.model = j.model.trim();
@@ -1053,6 +1057,7 @@ function mergeBrainConfig(existing, patch) {
 		const legacy = {};
 		if (existing?.bin) legacy.bin = existing.bin;
 		if (existing?.args?.length) legacy.args = existing.args;
+		if (existing?.extraArgs?.length) legacy.extraArgs = existing.extraArgs;
 		if (existing?.shell !== void 0) legacy.shell = existing.shell;
 		if (existing?.homeEnvVar) legacy.homeEnvVar = existing.homeEnvVar;
 		if (existing?.model) legacy.model = existing.model;
@@ -1064,20 +1069,23 @@ function mergeBrainConfig(existing, patch) {
 	const next = { agent: patch.agent };
 	if (patch.bin) next.bin = patch.bin;
 	if (patch.args) next.args = patch.args;
+	if (patch.extraArgs) next.extraArgs = patch.extraArgs;
 	if (patch.shell !== void 0) next.shell = patch.shell;
 	if (patch.homeEnvVar) next.homeEnvVar = patch.homeEnvVar;
 	if (patch.model) next.model = patch.model;
 	if (prev && prev === nextAgent) {
 		if (!patch.bin && existing?.bin) next.bin = existing.bin;
 		if (!patch.args && existing?.args?.length) next.args = existing.args;
+		if (!patch.extraArgs && existing?.extraArgs?.length) next.extraArgs = existing.extraArgs;
 		if (patch.shell === void 0 && existing?.shell !== void 0) next.shell = existing.shell;
 		if (!patch.homeEnvVar && existing?.homeEnvVar) next.homeEnvVar = existing.homeEnvVar;
 		if (!patch.model && existing?.model) next.model = existing.model;
 	}
-	if (next.bin || next.args?.length || next.shell !== void 0 || next.homeEnvVar || next.model) {
+	if (next.bin || next.args?.length || next.extraArgs?.length || next.shell !== void 0 || next.homeEnvVar || next.model) {
 		const ov = { ...presets[nextAgent] };
 		if (next.bin) ov.bin = next.bin;
 		if (next.args?.length) ov.args = next.args;
+		if (next.extraArgs?.length) ov.extraArgs = next.extraArgs;
 		if (next.shell !== void 0) ov.shell = next.shell;
 		if (next.homeEnvVar) ov.homeEnvVar = next.homeEnvVar;
 		if (next.model) ov.model = next.model;
@@ -1104,6 +1112,53 @@ function clearBrainConfig(dir = DATA_DIR) {
 	}
 }
 //#endregion
+//#region src/cline-credentials.ts
+/**
+* Cline ACP 的认证桥接。
+*
+* Cline 的 `isSessionReady()` 只自动恢复它自己的 3 种登录（`cline` / `cline-pass` / `openai-codex`），
+* 自定义/API-key provider（如 `openai-compatible`）不在 `tryRestoreAuth()` 的列表里——即使
+* `data/settings/providers.json` 里已经存在 `lastUsedProvider` 和 `apiKey`，`session/new` 也会报
+* `-32000 Authentication required`。Cline 官方给 ACP 的逃生口是 `CLINE_PROVIDER` + `CLINE_API_KEY`。
+*
+* 这里做一层**只读、按需**的桥接：父进程没有显式提供这两个变量时，把 `lastUsedProvider` 对应的
+* `settings.apiKey` 转成这两个环境变量，从而复用用户已经用 `cline auth` / 手写配置好的登录态。
+*
+* 边界（刻意收窄）：
+* - **显式环境变量永远优先**：`CLINE_PROVIDER` 或 `CLINE_API_KEY` 只要有一个已存在，就完全不接管
+*   （避免把父进程的 provider 和配置文件里的 key 错配）；
+* - 只认 `lastUsedProvider`，且该 provider 必须有非空字符串 `apiKey`；OAuth 条目（只有 `auth`、
+*   没有 `apiKey`）不处理，继续走 Cline 自己的 `tryRestoreAuth()`；
+* - 文件不存在 / JSON 坏了 / 结构不对 → 返回空表，不抛异常（登录态问题仍由原来的认证提示暴露）；
+* - 只读不写，不打印 key。
+*/
+function clineCredentialEnv(realHome, parentEnv) {
+	if (parentEnv.CLINE_PROVIDER?.trim() || parentEnv.CLINE_API_KEY?.trim()) return {};
+	if (!realHome) return {};
+	const file = path.join(realHome, "data", "settings", "providers.json");
+	let parsed;
+	try {
+		parsed = JSON.parse(fs.readFileSync(file, "utf-8"));
+	} catch {
+		return {};
+	}
+	if (!isObj$1(parsed)) return {};
+	const providerId = typeof parsed.lastUsedProvider === "string" ? parsed.lastUsedProvider.trim() : "";
+	if (!providerId) return {};
+	const providers = isObj$1(parsed.providers) ? parsed.providers : null;
+	const entry = providers && isObj$1(providers[providerId]) ? providers[providerId] : null;
+	const settings = entry && isObj$1(entry.settings) ? entry.settings : null;
+	const apiKey = settings && typeof settings.apiKey === "string" ? settings.apiKey.trim() : "";
+	if (!apiKey) return {};
+	return {
+		CLINE_PROVIDER: providerId,
+		CLINE_API_KEY: apiKey
+	};
+}
+function isObj$1(v) {
+	return !!v && typeof v === "object" && !Array.isArray(v);
+}
+//#endregion
 //#region src/profile-model.ts
 /**
 * 真实 profile 用户层（`<realHome>/profiles/<profile>/cordis.patch.yml`）的三件事：
@@ -1265,7 +1320,12 @@ const ACP_AGENT_PRESETS = {
 		name: "gemini",
 		bin: "gemini",
 		binWin: "gemini.cmd",
-		args: ["--experimental-acp"],
+		args: [
+			"--acp",
+			"--approval-mode",
+			"yolo",
+			"--skip-trust"
+		],
 		homeEnvVar: "GEMINI_CLI_HOME",
 		shell: true
 	},
@@ -1306,7 +1366,8 @@ const ACP_AGENT_PRESETS = {
 		images: false,
 		realProfile: "acp",
 		model: "[\"deepseek-account\",\"deepseek-flash\"]",
-		mcpViaAcp: true
+		mcpViaAcp: true,
+		envDefaults: { DSH_PERMISSION_MODE: "danger-full-access" }
 	},
 	qoder: {
 		name: "qoder",
@@ -1331,18 +1392,63 @@ const ACP_AGENT_PRESETS = {
 		credentialFiles: [".auth/user"],
 		identityFiles: [".auth/machine_id"]
 	},
+	cline: {
+		name: "cline",
+		bin: "cline",
+		binWin: "cline.cmd",
+		args: [
+			"--acp",
+			"--auto-approve",
+			"true"
+		],
+		shell: true,
+		images: false,
+		env: {
+			CLINE_DIR: `%HOME%${path.sep}cline`,
+			CLINE_DATA_DIR: `%HOME%${path.sep}cline${path.sep}data`,
+			CLINE_MCP_SETTINGS_PATH: `%HOME%${path.sep}cline${path.sep}mcp.json`
+		},
+		realHome: path.join(os.homedir(), ".cline"),
+		inheritDirs: [
+			"rules",
+			"skills",
+			"agents"
+		],
+		configSubdir: "cline",
+		mcpFormat: "kiro",
+		mcpConfigFile: "mcp.json",
+		catalogFile: "data/settings/cline_mcp_settings.json",
+		credentialFiles: ["data/settings/providers.json", "data/settings/models.json"],
+		credentialEnv: clineCredentialEnv
+	},
 	"claude-code": {
 		name: "claude-code",
-		bin: "npx",
-		binWin: "npx.cmd",
-		args: ["-y", "@zed-industries/claude-code-acp"],
-		shell: true
+		bin: "claude-agent-acp",
+		binWin: "claude-agent-acp.cmd",
+		args: [],
+		shell: true,
+		env: { CLAUDE_CONFIG_DIR: `%HOME%${path.sep}claude` },
+		realHome: path.join(os.homedir(), ".claude"),
+		inheritDirs: [
+			"skills",
+			"agents",
+			"commands"
+		],
+		inheritFiles: ["CLAUDE.md"],
+		configSubdir: "claude",
+		catalogFile: path.join("..", ".claude.json"),
+		credentialFiles: [".credentials.json"],
+		mcpViaAcp: true,
+		sessionMode: "bypassPermissions"
 	},
 	codex: {
 		name: "codex",
 		bin: "codex-acp",
-		binWin: "codex-acp.exe",
-		args: []
+		binWin: "codex-acp.cmd",
+		args: [],
+		shell: true,
+		envDefaults: { INITIAL_AGENT_MODE: "agent-full-access" },
+		sessionMode: "agent-full-access"
 	}
 };
 function onPath(exe) {
@@ -1351,15 +1457,45 @@ function onPath(exe) {
 }
 /**
 * `auto` 的探测顺序：按序取第一个「二进制能在 PATH 上解析到」的 agent。
-* 只收纳**原生 ACP 且二进制可直接判定**的 agent——适配器类（`claude-code` 走 `npx`、`codex` 走 `codex-acp`）不参与自动探测（`npx` 几乎总在 PATH 上，会把它们误选出来）。
+* 只收纳**原生 ACP 且二进制可直接判定**的 agent——适配器类（`claude-code` 走 `claude-agent-acp`、`codex` 走 `codex-acp`）不参与自动探测：
+* 它们是独立安装的桥接进程、各有自己的认证，误选中会让「装了但没登录」的机器静默换脑；显式选用（`wemind brain set|switch <名>`）更安全。
+* 新 agent 一律追加在末尾：老机器上已装的前几个仍按原顺序被选中，不改变既有用户的默认大脑。
 */
 const AUTO_PROBE_ORDER = [
 	"kiro",
 	"opencode",
 	"gemini",
 	"deepseek",
-	"qoder"
+	"qoder",
+	"cline"
 ];
+/**
+* 该 agent 预设里「进入 ACP 模式」的标记 token：从默认 args 中挑出含 `acp` 的项。
+* 只用于整段替换 args 时的静态提醒；适配器（claude-code / codex）的 args 为空 → 返回空数组（不检查——适配器本体就是 ACP server，没有模式参数）。
+* 不能只查裸 `acp`：qoder 是 `--acp`、gemini 是 `--acp`、deepseek 是 `--profile acp`。
+*/
+function acpModeTokens(name) {
+	const preset = ACP_AGENT_PRESETS[name];
+	return preset ? preset.args.filter((a) => /acp/i.test(a)) : [];
+}
+/**
+* 整段替换 args 时的静态提醒（**只提醒、不拒绝**）：新 args 里找不到该 agent 的 ACP 模式标记时返回文案。
+* `binOverridden`（env / brain.json 指定了自定义 bin）时不检查——自定义入口/包装脚本可能自带 ACP 模式，静态判断不可靠。
+*/
+function acpArgsWarning(name, args, binOverridden) {
+	if (binOverridden) return null;
+	const markers = acpModeTokens(name);
+	if (!markers.length) return null;
+	if (args.some((a) => /acp/i.test(a))) return null;
+	return `args 里没有 ${name} 的 ACP 模式参数（预设是 ${markers.map((m) => `\`${m}\``).join(" / ")}）——进程可能起得来但不会说 ACP，首条消息会握手超时。请把它一起写回去，或改用 --extra-args 只追加。`;
+}
+/** 运行时诊断：握手失败 / 进程在握手前退出时追加的提示；args 看起来正常、或 bin 是自定义入口时返回空串。 */
+function acpArgsHint(ag) {
+	if (ag.binOverridden) return "";
+	const markers = acpModeTokens(ag.name);
+	if (!markers.length || ag.args.some((a) => /acp/i.test(a))) return "";
+	return `（当前 args=[${ag.args.join(" ")}] 里没有 ${markers.map((m) => `\`${m}\``).join(" / ")}——若覆盖过 --args，确认没漏 ACP 模式参数；也可改用 --extra-args 只追加）`;
+}
 /** agent 在该平台的「可执行文件名」（用于 PATH 探测）。 */
 function presetExe(preset) {
 	return process.platform === "win32" ? preset.binWin ?? `${preset.bin}.exe` : preset.bin;
@@ -1390,6 +1526,21 @@ function locateBin(bin) {
 	}
 	return null;
 }
+/** 组装 spawn 用的环境变量：父进程 env → `homeEnvVar` 指向沙箱 → 从凭据文件派生的 env（父进程未提供时）→ 预设强制 `env` → 预设 `envDefaults`（父进程已设同名变量时保留父进程的，`skipped` 收集这些键供调用方记日志）。 */
+function agentEnv(ag, home, skipped = []) {
+	const env = { ...process.env };
+	if (ag.homeEnvVar) env[ag.homeEnvVar] = home;
+	for (const [k, v] of Object.entries(ag.credentialEnv?.(ag.realHome, process.env) ?? {})) if (env[k] === void 0) env[k] = v;
+	for (const [k, v] of Object.entries(ag.env ?? {})) env[k] = v.replaceAll("%HOME%", home);
+	for (const [k, v] of Object.entries(ag.envDefaults ?? {})) {
+		if (process.env[k] !== void 0) {
+			skipped.push(k);
+			continue;
+		}
+		env[k] = v.replaceAll("%HOME%", home);
+	}
+	return env;
+}
 /** 该角色「选 agent」的环境变量：worker 先看 `WEMIND_WORKER_BRAIN`，未设则回落 `WEMIND_BRAIN`。 */
 function envKeyFor(role) {
 	return (role === "worker" ? process.env.WEMIND_WORKER_BRAIN?.trim() || process.env.WEMIND_BRAIN?.trim() : process.env.WEMIND_BRAIN?.trim()) || void 0;
@@ -1430,7 +1581,10 @@ function resolveAgentCore(role, cfg, opts = {}) {
 	const bin = explicitBin || (shell ? process.platform === "win32" ? exe : preset.bin : binPath || preset.bin);
 	const available = known && binPath !== null;
 	const argsOverride = opts.ignoreEnv ? void 0 : process.env.WEMIND_BRAIN_ARGS?.trim();
-	const args = argsOverride ? argsOverride.split(/\s+/) : overrideCfg?.args && overrideCfg.args.length ? overrideCfg.args : presetOv?.args && presetOv.args.length ? presetOv.args : preset.args;
+	const baseArgs = argsOverride ? argsOverride.split(/\s+/) : overrideCfg?.args && overrideCfg.args.length ? overrideCfg.args : presetOv?.args && presetOv.args.length ? presetOv.args : preset.args;
+	const extraEnv = opts.ignoreEnv ? void 0 : process.env.WEMIND_BRAIN_EXTRA_ARGS?.trim();
+	const extraArgs = extraEnv ? extraEnv.split(/\s+/) : overrideCfg?.extraArgs && overrideCfg.extraArgs.length ? overrideCfg.extraArgs : presetOv?.extraArgs && presetOv.extraArgs.length ? presetOv.extraArgs : [];
+	const args = [...baseArgs, ...extraArgs];
 	const homeEnvVar = (opts.ignoreEnv ? void 0 : process.env.WEMIND_BRAIN_HOME_ENV?.trim()) || overrideCfg?.homeEnvVar?.trim() || presetOv?.homeEnvVar?.trim() || preset.homeEnvVar;
 	const inherit = (process.env.WEMIND_BRAIN_INHERIT ?? process.env.WECHAT_BRAIN_INHERIT ?? "1") !== "0";
 	const realHome = process.env.WEMIND_BRAIN_REAL_HOME?.trim() || process.env.WECHAT_REAL_KIRO_HOME?.trim() || preset.realHome;
@@ -1440,6 +1594,13 @@ function resolveAgentCore(role, cfg, opts = {}) {
 	const model = explicitModel || derivedModel || (isDefaultModel(rawModel) ? void 0 : preset.model);
 	const dirsEnv = process.env.WEMIND_BRAIN_INHERIT_DIRS?.trim();
 	const inheritDirs = dirsEnv ? dirsEnv.split(/[,\s]+/).filter(Boolean) : preset.inheritDirs ?? [];
+	const modeEnv = process.env.WEMIND_ACP_SESSION_MODE?.trim();
+	const sessionMode = !!modeEnv && [
+		"0",
+		"false",
+		"off",
+		"no"
+	].includes(modeEnv.toLowerCase()) ? void 0 : modeEnv || preset.sessionMode;
 	return {
 		name: preset.name,
 		bin,
@@ -1455,6 +1616,8 @@ function resolveAgentCore(role, cfg, opts = {}) {
 		mcpConfigFile: preset.mcpConfigFile ?? "settings/mcp.json",
 		catalogFile: preset.catalogFile ?? "settings/mcp.json",
 		env: preset.env ?? {},
+		envDefaults: preset.envDefaults ?? {},
+		credentialEnv: preset.credentialEnv,
 		restore: preset.restore,
 		firstFrameMs: preset.firstFrameMs,
 		heartbeatMs: preset.heartbeatMs,
@@ -1465,11 +1628,13 @@ function resolveAgentCore(role, cfg, opts = {}) {
 		model,
 		realProfile: preset.realProfile,
 		mcpViaAcp: preset.mcpViaAcp ?? false,
+		sessionMode,
 		requestedKey,
 		source,
 		known,
 		available,
-		binPath
+		binPath,
+		binOverridden: !!explicitBin
 	};
 }
 /** 解析当前要用的**对话大脑**：环境变量 > 账号 brain.json 顶层 > auto。 */
@@ -1506,6 +1671,7 @@ function resolvePresetByName(name, cfg) {
 	if (cfg?.agent?.trim().toLowerCase() === key) {
 		if (cfg.bin) base.bin = cfg.bin;
 		if (cfg.args?.length) base.args = cfg.args;
+		if (cfg.extraArgs?.length) base.extraArgs = cfg.extraArgs;
 		if (cfg.shell !== void 0) base.shell = cfg.shell;
 		if (cfg.homeEnvVar) base.homeEnvVar = cfg.homeEnvVar;
 		if (cfg.model) base.model = cfg.model;
@@ -1521,15 +1687,35 @@ function resolvePresetByName(name, cfg) {
 	};
 }
 /**
+* 适配器类 agent 的安装指引：找不到适配器二进制时**直接给出可粘贴的命令**。
+* 口径：**适配器一律全局安装**（daemon 常驻、worker 每条任务起进程；npx 每次冷启动要联网现下、版本不可复现）。
+*/
+const ADAPTER_INSTALL_HINT = { "claude-code": "`npm i -g @agentclientprotocol/claude-agent-acp`（装完得到 claude-agent-acp；Windows 上是 claude-agent-acp.cmd；**需 Node ≥22**）" };
+/**
 * 校验解析后的大脑是否可用：可用返回 null，否则返回一句面向用户的说明。
 * 供 daemon 启动校验（早失败、说人话）与 `wemind brain` / `wemind brain check` 复用。
 */
 function agentProblem(ag) {
 	if (!ag.known) return `未知 agent「${ag.requestedKey}」。可选：${Object.keys(ACP_AGENT_PRESETS).join("、")}（自定义二进制可用 WEMIND_BRAIN_BIN 或 brain set --bin 指定）`;
 	if (ag.requestedKey === "auto" && !ag.available) return `自动探测未找到可用的大脑（已试：${AUTO_PROBE_ORDER.join("、")}）。请安装其中之一，或运行 \`wemind brain set <agent 名>\``;
-	if (!ag.available) return ag.name === "deepseek" ? `找不到 DeepSeek 的「${ag.bin}」。桌面端通常有 dsh.cmd；把它的绝对路径传给 \`wemind brain set deepseek --bin "<...>\\dsh.cmd"\`` : ag.name === "qoder" ? `找不到 Qoder CLI 的「${ag.bin}」。官方安装会放在 ~/.qoder/bin/qodercli/ 并加入 PATH；确认后重开终端，或 \`wemind brain set qoder --bin "<...>\\qodercli.exe"\`` : `找不到大脑「${ag.name}」的二进制「${ag.bin}」。安装它，或运行 \`wemind brain set <agent 名>\` 切换`;
+	if (!ag.available) {
+		const hint = ADAPTER_INSTALL_HINT[ag.name];
+		if (hint) return `找不到大脑「${ag.name}」的适配器「${ag.bin}」。先装适配器：${hint}；装完仍找不到就 \`wemind brain set ${ag.name} --bin "<绝对路径>"\` 指定它。`;
+		return ag.name === "deepseek" ? `找不到 DeepSeek 的「${ag.bin}」。桌面端通常有 dsh.cmd；把它的绝对路径传给 \`wemind brain set deepseek --bin "<...>\\dsh.cmd"\`` : ag.name === "qoder" ? `找不到 Qoder CLI 的「${ag.bin}」。官方安装会放在 ~/.qoder/bin/qodercli/ 并加入 PATH；确认后重开终端，或 \`wemind brain set qoder --bin "<...>\\qodercli.exe"\`` : ag.name === "cline" ? `找不到 Cline CLI 的「${ag.bin}」。安装：\`npm i -g cline\`（Node 20+），装完后重开终端；或用 \`wemind brain set cline --bin "<...>\\cline.cmd"\`` : `找不到大脑「${ag.name}」的二进制「${ag.bin}」。安装它，或运行 \`wemind brain set <agent 名>\` 切换`;
+	}
 	return null;
 }
+/**
+* 认证失败时按 agent 补一句可执行的建议（`wemind brain check` 与 daemon 日志复用）。
+* Cline 的 ACP 只自动恢复它自己的 3 种登录；自定义 provider 必须靠环境变量——
+* 「重启 daemon」对它没用，所以不能只套用通用的「密钥/鉴权」提示。
+* 其它 agent 返回空串（不改变既有文案）。
+*/
+function authHint(agentName, message) {
+	if (agentName !== "cline") return "";
+	if (!/authentication required|authenticate|unauthorized|not authenticated/i.test(message)) return "";
+	return "Cline 的 ACP 只自动恢复 cline / cline-pass / openai-codex 三种登录；用自定义 provider（如 openai-compatible）时，请在启动 wemind 的环境里设置 CLINE_PROVIDER 与 CLINE_API_KEY（设置后重启一次 daemon）。";
+}
 //#endregion
 //#region src/agent-slot.ts
 /**
@@ -1814,6 +2000,7 @@ function applySandbox(ag) {
 	for (const n of active) servers[n] = cat[n];
 	const file = brainMcpJson(ag);
 	const next = withMcpServers(readJson$1(file) ?? {}, servers, ag.mcpFormat);
+	if (ag.mcpFormat === "opencode" && next.permission === void 0) next.permission = "allow";
 	fs.mkdirSync(path.dirname(file), { recursive: true });
 	fs.writeFileSync(file, JSON.stringify(next, null, 2), "utf-8");
 }
@@ -3043,9 +3230,9 @@ function promptRequest(ag, params) {
 async function ensureProcess(ag) {
 	if (isAlive() && initialized) return;
 	reset();
-	const env = { ...process.env };
-	if (ag.homeEnvVar) env[ag.homeEnvVar] = BRAIN_HOME;
-	for (const [k, v] of Object.entries(ag.env ?? {})) env[k] = v.replaceAll("%HOME%", BRAIN_HOME);
+	const kept = [];
+	const env = agentEnv(ag, BRAIN_HOME, kept);
+	if (kept.length) dlog$1(`env defaults kept from parent: ${kept.join(",")}`);
 	const proc = spawnAgent(ag, {
 		cwd: BRAIN_HOME,
 		env
@@ -3056,17 +3243,22 @@ async function ensureProcess(ag) {
 	proc.stdout.on("data", onStdout);
 	proc.stderr.on("data", () => {});
 	proc.on("exit", (code) => {
-		dlog$1(`acp exited code=${code}`);
+		dlog$1(`acp exited code=${code}${child === proc && !initialized ? acpArgsHint(ag) : ""}`);
 		if (child === proc) reset();
 	});
 	proc.on("error", (e) => {
 		dlog$1(`acp error ${String(e)}`);
 		if (child === proc) reset();
 	});
-	await request("initialize", {
-		protocolVersion: 1,
-		clientCapabilities: {}
-	}, REQ_TIMEOUT$1);
+	try {
+		await request("initialize", {
+			protocolVersion: 1,
+			clientCapabilities: {}
+		}, REQ_TIMEOUT$1);
+	} catch (e) {
+		dlog$1(`initialize failed: ${String(e)}${acpArgsHint(ag)}`);
+		throw e;
+	}
 	initialized = true;
 	dlog$1("initialized");
 }
@@ -3085,6 +3277,32 @@ async function applyModel(ag, sid) {
 		throw e;
 	}
 }
+/** 从 `session/new|load|resume` 的回包里取可用模式 id；agent 不报 `modes` 时返回 null（=不校验，照样尝试）。 */
+function availableModeIds(res) {
+	const list = res?.modes?.availableModes;
+	if (!Array.isArray(list)) return null;
+	const ids = list.map((m) => String(m?.id ?? m)).filter(Boolean);
+	return ids.length ? ids : null;
+}
+/** 会话建立/恢复后切到预设声明的模式（免审批：claude-code 的 bypassPermissions、codex 的 agent-full-access）。
+*  **失败只记日志、不抛**：模式不可用（如 claude-code 以 root 跑却没有 IS_SANDBOX）时进程仍可用，
+*  审批请求继续由应答器处理（默认拒绝，WEMIND_ACP_AUTO_ALLOW=1 放行）；抛错反而会把整轮打成失败。 */
+async function applySessionMode(ag, sid, modes = null) {
+	if (!ag.sessionMode) return;
+	if (modes && !modes.includes(ag.sessionMode)) {
+		dlog$1(`session mode ${ag.sessionMode} 不在 agent 报告的可用模式 [${modes.join(",")}] 里——跳过；审批请求仍由应答器处理`);
+		return;
+	}
+	try {
+		await request("session/set_mode", {
+			sessionId: sid,
+			modeId: ag.sessionMode
+		}, REQ_TIMEOUT$1);
+		dlog$1(`session mode set ${ag.sessionMode}`);
+	} catch (e) {
+		dlog$1(`session mode set failed (${String(e)})——继续；审批请求仍由应答器处理`);
+	}
+}
 async function ensureSession(ag, userId) {
 	const existing = userSessions.get(userId);
 	if (existing) return existing;
@@ -3094,12 +3312,13 @@ async function ensureSession(ag, userId) {
 	if (saved) {
 		const methods = ag.restore === "resume" ? ["resume"] : ["load", "resume"];
 		for (const method of methods) try {
-			await request(`session/${method}`, {
+			const restored = await request(`session/${method}`, {
 				sessionId: saved,
 				cwd: BRAIN_HOME,
 				mcpServers
 			}, REQ_TIMEOUT$1);
 			await applyModel(ag, saved);
+			await applySessionMode(ag, saved, availableModeIds(restored));
 			userSessions.set(userId, saved);
 			markUsed(ag.name, userId, saved);
 			dlog$1(`session/${method} ok ${saved} mcp=[${mcpServers.map((s) => s.name).join(",")}]`);
@@ -3114,6 +3333,7 @@ async function ensureSession(ag, userId) {
 	}, REQ_TIMEOUT$1);
 	if (!res?.sessionId) throw new Error("session/new returned no sessionId");
 	await applyModel(ag, res.sessionId);
+	await applySessionMode(ag, res.sessionId, availableModeIds(res));
 	userSessions.set(userId, res.sessionId);
 	map[keyOf(ag, userId)] = res.sessionId;
 	saveSessionMap$1(map);
@@ -3216,12 +3436,13 @@ async function resumeSession(userId, sessionId) {
 		const methods = ag.restore === "resume" ? ["resume"] : ["load", "resume"];
 		let lastErr = "";
 		for (const method of methods) try {
-			await request(`session/${method}`, {
+			const restored = await request(`session/${method}`, {
 				sessionId,
 				cwd: BRAIN_HOME,
 				mcpServers
 			}, REQ_TIMEOUT$1);
 			await applyModel(ag, sessionId);
+			await applySessionMode(ag, sessionId, availableModeIds(restored));
 			userSessions.set(userId, sessionId);
 			const map = loadSessionMap$1(ag);
 			map[keyOf(ag, userId)] = sessionId;
@@ -3263,6 +3484,55 @@ function heartbeatMs() {
 	return getAgent("brain").heartbeatMs;
 }
 //#endregion
+//#region src/brain-state.ts
+/**
+* daemon 启动/热切换成功后，把「这一刻真正生效的对话大脑」写进 `<账号目录>/brain-runtime.json`。
+*
+* 为什么还需要这个文件：`brain.pid` 只在 **ACP 子进程真的 spawn 之后**才有内容，而大脑是懒启动的——
+* 刚启动、还没收到消息时没有 pid 记录。此前 `wemind list` 的 `agent=` 只能显示 `brain.json`（有意「不看
+* 当前 shell 的环境变量」），于是用 `WEMIND_BRAIN=cline` 启动的 daemon 会一直显示成配置里的 deepseek，
+* 让人以为切换没生效。
+*
+* 这个文件记录的是 **daemon 进程自己的解析结果**（含来源 env/file/auto），与 CLI 端环境变量无关；
+* daemon 没运行时 `manage.ts` 不会采信它（`stop` 也会清掉），所以不会把旧状态当成现在时。
+*/
+const BRAIN_RUNTIME_FILE = "brain-runtime.json";
+/** 写入运行时大脑（原子替换；失败静默——显示用，不该影响收发）。 */
+function writeBrainState(dir, ag) {
+	const body = {
+		agent: ag.name,
+		source: ag.source,
+		bin: ag.bin,
+		args: ag.args,
+		startedAt: Date.now()
+	};
+	try {
+		fs.mkdirSync(dir, { recursive: true });
+		const file = path.join(dir, BRAIN_RUNTIME_FILE);
+		const tmp = `${file}.tmp`;
+		fs.writeFileSync(tmp, JSON.stringify(body, null, 2) + "\n", "utf-8");
+		fs.renameSync(tmp, file);
+	} catch {}
+}
+/** 读运行时大脑；没有/损坏/字段不对 → null（调用方按「没有运行时信息」处理）。 */
+function readBrainState(dir) {
+	try {
+		const j = JSON.parse(fs.readFileSync(path.join(dir, BRAIN_RUNTIME_FILE), "utf-8"));
+		if (typeof j?.agent !== "string" || !j.agent) return null;
+		const src = j.source;
+		const source = src === "env" || src === "auto" ? src : src === "file" ? "file" : "file";
+		return {
+			agent: j.agent,
+			source,
+			bin: typeof j.bin === "string" ? j.bin : "",
+			args: Array.isArray(j.args) ? j.args.filter((x) => typeof x === "string") : [],
+			startedAt: Number(j.startedAt) || 0
+		};
+	} catch {
+		return null;
+	}
+}
+//#endregion
 //#region src/brain-switch.ts
 /**
 * 运行时切换对话大脑。
@@ -3375,6 +3645,7 @@ async function runSwitch(key, opts) {
 	const note = envNote(key);
 	if (pre.already) {
 		if (opts.persist !== false) updateBrainConfig({ agent: key }, dir);
+		writeBrainState(dir, target);
 		return {
 			ok: true,
 			agent: target,
@@ -3396,6 +3667,7 @@ async function runSwitch(key, opts) {
 			await withTimeout(warmup(target, opts.userId ?? ""), TIMEOUT_MS, warmupTimeoutMsg());
 			setAgent("brain", target);
 			if (opts.persist !== false) updateBrainConfig({ agent: key }, dir);
+			writeBrainState(dir, target);
 			const ms = Date.now() - t0;
 			return {
 				ok: true,
@@ -4231,6 +4503,7 @@ function applyWorkerSandbox(ag) {
 	}
 	const file = workerMcpJson(ag);
 	const next = withMcpServers(readJson(file) ?? {}, servers, ag.mcpFormat);
+	if (ag.mcpFormat === "opencode" && next.permission === void 0) next.permission = "allow";
 	fs.mkdirSync(path.dirname(file), { recursive: true });
 	fs.writeFileSync(file, JSON.stringify(next, null, 2), "utf-8");
 }
@@ -4435,7 +4708,7 @@ function saveSessionMap(m) {
 	fs.renameSync(tmp, SESSION_MAP_FILE);
 }
 /** 一条连接：一个 ACP agent 进程 + 它自己的握手/会话/进度状态。 */
-var WorkerConn = class {
+var WorkerConn = class WorkerConn {
 	id;
 	agent;
 	/** 池用来标注「这条连接现在跑的是哪个任务」（空闲时为 undefined）。 */
@@ -4724,9 +4997,9 @@ var WorkerConn = class {
 	async ensureProcess() {
 		if (this.isAlive() && this.initialized) return;
 		this.kill();
-		const env = { ...process.env };
-		if (this.agent.homeEnvVar) env[this.agent.homeEnvVar] = WORKER_HOME;
-		for (const [k, v] of Object.entries(this.agent.env ?? {})) env[k] = v.replaceAll("%HOME%", WORKER_HOME);
+		const kept = [];
+		const env = agentEnv(this.agent, WORKER_HOME, kept);
+		if (kept.length) dlog(`${this.id} env defaults kept from parent: ${kept.join(",")}`);
 		const cwd = this.effectiveCwd();
 		const proc = spawnAgent(this.agent, {
 			cwd,
@@ -4738,17 +5011,23 @@ var WorkerConn = class {
 		proc.stdout.on("data", (d) => this.onStdout(d));
 		proc.stderr.on("data", () => {});
 		proc.on("exit", (code) => {
-			dlog(`${this.id}(${this.agent.name}) exited code=${code}`);
+			const hint = this.child === proc && !this.initialized ? acpArgsHint(this.agent) : "";
+			dlog(`${this.id}(${this.agent.name}) exited code=${code}${hint}`);
 			if (this.child === proc) this.kill();
 		});
 		proc.on("error", (e) => {
 			dlog(`${this.id}(${this.agent.name}) error ${String(e)}`);
 			if (this.child === proc) this.kill();
 		});
-		await this.request("initialize", {
-			protocolVersion: 1,
-			clientCapabilities: {}
-		}, REQ_TIMEOUT);
+		try {
+			await this.request("initialize", {
+				protocolVersion: 1,
+				clientCapabilities: {}
+			}, REQ_TIMEOUT);
+		} catch (e) {
+			dlog(`${this.id}(${this.agent.name}) initialize failed: ${String(e)}${acpArgsHint(this.agent)}`);
+			throw e;
+		}
 		this.initialized = true;
 		dlog(`${this.id} initialized`);
 	}
@@ -4766,6 +5045,30 @@ var WorkerConn = class {
 			throw e;
 		}
 	}
+	/** 从 `session/new|load|resume` 的回包里取可用模式 id；agent 不报 `modes` 时返回 null（=不校验，照样尝试）。 */
+	static availableModeIds(res) {
+		const list = res?.modes?.availableModes;
+		if (!Array.isArray(list)) return null;
+		const ids = list.map((m) => String(m?.id ?? m)).filter(Boolean);
+		return ids.length ? ids : null;
+	}
+	/** 会话建立/恢复后切到预设声明的模式（免审批）；失败只记日志、不抛——审批请求仍由应答器兜底。 */
+	async applySessionMode(sid, modes = null) {
+		if (!this.agent.sessionMode) return;
+		if (modes && !modes.includes(this.agent.sessionMode)) {
+			dlog(`${this.id} session mode ${this.agent.sessionMode} 不在可用模式 [${modes.join(",")}] 里——跳过；审批请求仍由应答器处理`);
+			return;
+		}
+		try {
+			await this.request("session/set_mode", {
+				sessionId: sid,
+				modeId: this.agent.sessionMode
+			}, REQ_TIMEOUT);
+			dlog(`${this.id} session mode set ${this.agent.sessionMode}`);
+		} catch (e) {
+			dlog(`${this.id} session mode set failed (${String(e)})——继续；审批请求仍由应答器处理`);
+		}
+	}
 	/** 取会话：内存 → 磁盘（load/resume 恢复） → 新建。key 由调用方给（每任务一个）。
 	*  `strictResume`：有旧会话但恢复失败 → 抛「接不上」，绝不静默新建空会话。 */
 	async ensureSession(key, strictResume = false) {
@@ -4777,12 +5080,13 @@ var WorkerConn = class {
 		if (saved) {
 			const methods = this.agent.restore === "resume" ? ["resume"] : ["load", "resume"];
 			for (const method of methods) try {
-				await this.request(`session/${method}`, {
+				const restored = await this.request(`session/${method}`, {
 					sessionId: saved,
 					cwd: this.effectiveCwd(),
 					mcpServers
 				}, REQ_TIMEOUT);
 				await this.applyModel(saved);
+				await this.applySessionMode(saved, WorkerConn.availableModeIds(restored));
 				this.sessions.set(key, saved);
 				dlog(`${this.id} session/${method} ok ${saved} mcp=[${mcpServers.map((s) => s.name).join(",")}]`);
 				return saved;
@@ -4797,6 +5101,7 @@ var WorkerConn = class {
 		}, REQ_TIMEOUT);
 		if (!res?.sessionId) throw new Error("session/new returned no sessionId");
 		await this.applyModel(res.sessionId);
+		await this.applySessionMode(res.sessionId, WorkerConn.availableModeIds(res));
 		this.sessions.set(key, res.sessionId);
 		const fresh = loadSessionMap(this.agent);
 		fresh[mapKey] = res.sessionId;
@@ -5730,10 +6035,13 @@ function brainFailurePlan(e) {
 		category: cat
 	};
 }
-/** 按错误类型给用户的失败提示。 */
-function brainErrorMessage(e) {
+/** 按错误类型给用户的失败提示。`agentName` 用于给特定 agent 补专属建议（如 Cline 的自定义 provider 要设环境变量）。 */
+function brainErrorMessage(e, agentName) {
 	const prov = providerIssue(e);
-	if (prov) return `（这次没答上来：${prov}。这类问题重试不会好——把账号/模型处理好后把消息再发一次就行。${prov === "密钥/鉴权有问题" || prov === "模型不可用" ? "若刚在本机改过登录态或模型配置，还要重启一次 daemon（wemind stop && wemind start）才会读到。" : ""}）`;
+	if (prov) {
+		const auth = agentName ? authHint(agentName, String(e instanceof Error ? e.message : e)) : "";
+		return `（这次没答上来：${prov}。这类问题重试不会好——把账号/模型处理好后把消息再发一次就行。${auth ? ` ${auth}` : prov === "密钥/鉴权有问题" || prov === "模型不可用" ? "若刚在本机改过登录态或模型配置，还要重启一次 daemon（wemind stop && wemind start）才会读到。" : ""}）`;
+	}
 	switch (classifyBrainError(e)) {
 		case "backend": return "（模型后端临时出错了，自动重试多次仍失败，请稍后把消息再发一次）";
 		case "timeout": return "（这次处理超时/卡住被中断了，重试也没成功——可把任务拆小一点再发）";
@@ -6221,7 +6529,7 @@ async function handleMessage(account, ctx, to, text, imageItems, createTimeMs, l
 		answer = await runWithRetry(text, images);
 	} catch (e2) {
 		ok = false;
-		answer = brainErrorMessage(e2);
+		answer = brainErrorMessage(e2, getAgent("brain").name);
 	} finally {
 		clearInterval(keepAlive);
 		clearInterval(heartbeat);
@@ -6624,6 +6932,7 @@ async function runDaemon() {
 		process.exit(78);
 	}
 	log(`brain=${agent.name} bin=${agent.bin} args=[${agent.args.join(" ")}] shell=${agent.shell} (source: ${agent.source})`);
+	writeBrainState(DATA_DIR, agent);
 	const wagent = getAgent("worker");
 	if (wagent.name !== agent.name) log(`worker=${wagent.name} bin=${wagent.bin} args=[${wagent.args.join(" ")}] (source: ${wagent.source})`);
 	const workerProblem = agentProblem(wagent);
@@ -6914,9 +7223,7 @@ function watchdogStart(key, cliPath) {
 async function checkAgent(ag, timeoutMs = 6e4) {
 	const started = Date.now();
 	const home = fs.mkdtempSync(path.join(os.tmpdir(), "wemind-brain-check-"));
-	const env = { ...process.env };
-	if (ag.homeEnvVar) env[ag.homeEnvVar] = home;
-	for (const [k, v] of Object.entries(ag.env ?? {})) env[k] = v.replaceAll("%HOME%", home);
+	const env = agentEnv(ag, home);
 	const cfgDir = path.join(home, ag.configSubdir);
 	for (const f of [...ag.credentialFiles, ...ag.identityFiles]) try {
 		const src = path.join(ag.realHome ?? "", f);
@@ -6994,22 +7301,35 @@ async function checkAgent(ag, timeoutMs = 6e4) {
 			protocolVersion: 1,
 			clientCapabilities: {}
 		});
+		const s = await req("session/new", {
+			cwd: home,
+			mcpServers: []
+		});
+		let modeNote = "";
+		if (ag.sessionMode && s?.sessionId) try {
+			await req("session/set_mode", {
+				sessionId: s.sessionId,
+				modeId: ag.sessionMode
+			});
+			modeNote = `，mode=${ag.sessionMode}`;
+		} catch (e) {
+			modeNote = `，但 session/set_mode ${ag.sessionMode} 失败（${e instanceof Error ? e.message : String(e)}）——免审批模式可能不可用，回合仍可跑但会按 agent 自己的审批流程走`;
+		}
 		return {
 			ok: true,
-			detail: `ACP 握手成功（initialize + session/new，sessionId=${(await req("session/new", {
-				cwd: home,
-				mcpServers: []
-			}))?.sessionId ?? "?"}）`,
+			detail: `ACP 握手成功（initialize + session/new，sessionId=${s?.sessionId ?? "?"}${modeNote}）`,
 			ms: Date.now() - started
 		};
 	} catch (e) {
 		const all = stderrTail.join("").trim();
 		const lines = all.split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
 		const head = lines.find((l) => /^(Error|YAMLException)\b/.test(l)) ?? lines.find((l) => /failed to parse|YAMLException/i.test(l)) ?? lines[0];
+		const msg = e instanceof Error ? e.message : String(e);
+		const hint = authHint(ag.name, msg);
 		const tail = all.slice(-400);
 		return {
 			ok: false,
-			detail: `${e instanceof Error ? e.message : String(e)}${head ? `\n  stderr: ${head}` : ""}${tail && !head?.includes(tail.trim()) ? `\n  …${tail}` : ""}`,
+			detail: `${msg}${head ? `\n  stderr: ${head}` : ""}${tail && !head?.includes(tail.trim()) ? `\n  …${tail}` : ""}${hint ? `\n  提示：${hint}` : ""}`,
 			ms: Date.now() - started
 		};
 	} finally {
@@ -7284,7 +7604,8 @@ function stopDaemon(key) {
 		"daemon.pid",
 		"brain.pid",
 		"worker.pid",
-		"workers.pid.json"
+		"workers.pid.json",
+		BRAIN_RUNTIME_FILE
 	]) try {
 		fs.unlinkSync(path.join(dir, f));
 	} catch {}
@@ -7442,6 +7763,7 @@ function cmdList() {
 			bpid: brec.pid ?? readPid(dir, "brain.pid"),
 			brainMarkers: brec.markers ?? brainPidMarkers(ag.bin, ag.args),
 			brainAgent: brec.agent,
+			brainRuntime: readBrainState(dir),
 			workers: readPidRecords(path.join(dir, "workers.pid.json")).map((w) => ({
 				pid: w.pid,
 				agent: w.agent,
@@ -7458,11 +7780,12 @@ function cmdList() {
 	]));
 	const aliveOursIn = (pid, markers) => !!pid && matchesMarkers(lines.get(pid), markers);
 	return entries.map((e) => {
-		const running = aliveOursIn(e.dpid, CLI_PID_MARKERS) ? `运行中(pid ${e.dpid})` : "已停止";
+		const runningNow = aliveOursIn(e.dpid, CLI_PID_MARKERS);
+		const running = runningNow ? `运行中(pid ${e.dpid})` : "已停止";
 		const brainPid = aliveOursIn(e.bpid, e.brainMarkers) ? `  brain(pid ${e.bpid}${e.brainAgent ? ` ${e.brainAgent}` : ""})` : "";
 		const live = e.workers.filter((w) => aliveOursIn(w.pid, w.markers));
 		const pool = live.length ? `  pool[${live.map((w) => `${w.agent}${w.taskId ? `#${w.taskId}` : ""}:${w.state}`).join(", ")}]` : "";
-		return `- ${e.a.key}${e.a.key === def ? " [默认]" : ""}  label=${e.a.label}  botId=${e.a.botId}  agent=${agentLabel(e.dir)}  ${running}${brainPid}${pool}`;
+		return `- ${e.a.key}${e.a.key === def ? " [默认]" : ""}  label=${e.a.label}  botId=${e.a.botId}  agent=${agentLabel(e.dir, runningNow ? e.brainRuntime : null)}  ${running}${brainPid}${pool}`;
 	}).join("\n");
 }
 const BRAIN_SRC_LABEL = {
@@ -7471,32 +7794,46 @@ const BRAIN_SRC_LABEL = {
 	auto: "自动探测（未配置）"
 };
 /** list 用：账号「配置 / 自动探测」得到的大脑标签（不看当前 shell 的 env，避免误导）。 */
-function agentLabel(dir) {
+function configAgentLabel(dir) {
 	const cfg = loadBrainConfig(dir);
 	if (cfg?.agent && cfg.agent.toLowerCase() !== "auto") return cfg.agent;
 	const picked = AUTO_PROBE_ORDER.find((k) => presetAvailable(k));
 	return picked ? `${picked}（自动）` : "（无可用）";
 }
+/**
+* list 用的 agent 列：daemon **在跑**时优先显示它实际生效的大脑（`brain-runtime.json`，
+* 来自 daemon 自己的解析，含 `WEMIND_BRAIN` 覆盖/热切换结果）；daemon 没跑时仍只显示配置/自动探测。
+* 运行时与配置不一致时把两者都写出来，避免「看着是 deepseek、实际在跑 cline」。
+*/
+function agentLabel(dir, runtime = null) {
+	const cfg = configAgentLabel(dir);
+	if (!runtime?.agent?.trim()) return cfg;
+	const name = runtime.agent.trim();
+	if (name === cfg.replace(/（[^）]*）$/, "")) return cfg;
+	return `${name}（运行，来源 ${runtime.source}；配置 ${cfg}）`;
+}
 /** `wemind brain`（show）：打印某账号大脑的「配置」与「生效」情况。 */
 function describeBrain(key) {
 	const cfg = loadBrainConfig(accountDir(key));
 	const ag = resolveAgent(cfg);
 	const problem = agentProblem(ag);
-	const cfgLine = cfg ? `brain.json → agent=${cfg.agent}${cfg.bin ? ` bin=${cfg.bin}` : ""}${cfg.args ? ` args=[${cfg.args.join(" ")}]` : ""}${cfg.shell !== void 0 ? ` shell=${cfg.shell}` : ""}${cfg.model ? ` model=${cfg.model}` : ""}` : "（未设置 brain.json）";
+	const cfgLine = cfg ? `brain.json → agent=${cfg.agent}${cfg.bin ? ` bin=${cfg.bin}` : ""}${cfg.args ? ` args=[${cfg.args.join(" ")}]` : ""}${cfg.extraArgs ? ` extra_args=[${cfg.extraArgs.join(" ")}]` : ""}${cfg.shell !== void 0 ? ` shell=${cfg.shell}` : ""}${cfg.model ? ` model=${cfg.model}` : ""}` : "（未设置 brain.json）";
 	const lines = [
 		`账号 ${key}`,
 		`  配置：${cfgLine}`,
 		`  请求：${ag.requestedKey}    来源：${BRAIN_SRC_LABEL[ag.source]}`,
-		`  生效：name=${ag.name}  bin=${ag.bin}  args=[${ag.args.join(" ")}]  shell=${ag.shell}  home_env=${ag.homeEnvVar ?? "(无)"}  model=${ag.model ?? "(agent 默认)"}`,
+		`  生效：name=${ag.name}  bin=${ag.bin}  args=[${ag.args.join(" ")}]  shell=${ag.shell}  home_env=${ag.homeEnvVar ?? "(无)"}  model=${ag.model ?? "(agent 默认)"}  session_mode=${ag.sessionMode ?? "(无)"}`,
 		`  可用：${problem ? `❌ ${problem}` : `✅ ${ag.binPath ?? ag.bin}`}`,
 		`  可选 agent：${Object.keys(ACP_AGENT_PRESETS).join("、")}`,
 		`  自动探测顺序：${AUTO_PROBE_ORDER.join(" → ")}`
 	];
+	const argsWarn = acpArgsWarning(ag.name, ag.args, ag.binOverridden);
+	if (argsWarn) lines.push(`  ⚠️ ${argsWarn}`);
 	const hint = ag.realProfile && ag.realHome && ag.inherit ? acpOverrideHint(ag.realHome, ag.realProfile) : null;
 	if (hint) lines.push("", hint);
 	return lines.join("\n");
 }
-/** `wemind brain set <agent 名|auto>`：把选择按账号写入磁盘（可选 --bin/--args/--shell/--model；--restart 立即重启 daemon）。 */
+/** `wemind brain set <agent 名|auto>`：把选择按账号写入磁盘（可选 --bin/--args/--extra-args/--shell/--model；--restart 立即重启 daemon）。 */
 async function cmdBrainSet(agentName, key, opts) {
 	const agent = agentName.trim().toLowerCase();
 	if (agent !== "auto" && !ACP_AGENT_PRESETS[agent]) throw new Error(`未知 agent「${agentName}」。可选：auto、${Object.keys(ACP_AGENT_PRESETS).join("、")}（自定义二进制用 --bin 搭配任一 agent）`);
@@ -7505,7 +7842,7 @@ async function cmdBrainSet(agentName, key, opts) {
 		if (agent === "auto") throw new Error("`auto` 是「自动探测」，不绑定具体 agent，不能配 --model；请指定具体 agent（如 brain set deepseek --model …）");
 	}
 	const dir = accountDir(key);
-	const customized = opts.bin !== void 0 || opts.args !== void 0 || opts.shell !== void 0 || opts.model !== void 0;
+	const customized = opts.bin !== void 0 || opts.args !== void 0 || opts.extraArgs !== void 0 || opts.shell !== void 0 || opts.model !== void 0;
 	if (!opts.restart && !customized && bridgeReady(key)) {
 		const r = await cmdBrainSwitch(agent, key, false);
 		return r.startsWith("❌") ? `${r}\n（brain.json **没有被改写**：换大脑失败就不写入磁盘——这是「失败就退回原来那个」的代价。想强制写入再重启：wemind brain set ${agent} --restart）` : r;
@@ -7513,17 +7850,24 @@ async function cmdBrainSet(agentName, key, opts) {
 	const patch = { agent };
 	if (opts.bin) patch.bin = opts.bin;
 	if (opts.args !== void 0) patch.args = opts.args.trim() ? opts.args.trim().split(/\s+/) : [];
+	if (opts.extraArgs !== void 0) patch.extraArgs = opts.extraArgs.trim() ? opts.extraArgs.trim().split(/\s+/) : [];
 	if (opts.shell !== void 0) patch.shell = opts.shell;
 	if (opts.model !== void 0) patch.model = opts.model.trim();
+	const before = loadBrainConfig(dir);
 	const cfg = updateBrainConfig(patch, dir);
-	const lines = [`已设置 ${key} 的大脑：agent=${agent}${cfg.bin ? ` bin=${cfg.bin}` : ""}${cfg.args ? ` args=[${cfg.args.join(" ")}]` : ""}${cfg.model ? ` model=${cfg.model}` : ""}`, `配置文件：${brainConfigPath(dir)}`];
+	const lines = [`已设置 ${key} 的大脑：agent=${agent}${cfg.bin ? ` bin=${cfg.bin}` : ""}${cfg.args ? ` args=[${cfg.args.join(" ")}]` : ""}${cfg.extraArgs ? ` extra_args=[${cfg.extraArgs.join(" ")}]` : ""}${cfg.model ? ` model=${cfg.model}` : ""}`, `配置文件：${brainConfigPath(dir)}`];
+	if (opts.args !== void 0) {
+		const binOverridden = opts.bin !== void 0 || !!before?.presets?.[agent]?.bin || before?.agent?.trim().toLowerCase() === agent && !!before?.bin;
+		const warn = acpArgsWarning(agent, cfg.args ?? [], binOverridden);
+		if (warn) lines.push(`⚠️ ${warn}`);
+	}
 	if (opts.restart) if (aliveOurs(readPid(dir, "daemon.pid"))) {
 		startDaemon(key);
 		lines.push(`已重启 daemon（账号 ${key}）。`);
 	} else lines.push(`daemon 未在运行，未重启（用 wemind start ${key} 启动）。`);
 	else if (customized && bridgeReady(key)) {
-		const viaSwitch = opts.bin !== void 0 || opts.args !== void 0 || opts.model !== void 0;
-		lines.push(`（带 --bin/--args/--shell/--model 的改动不能由 brain set 当场应用：控制桥只认 agent 名。重启后生效——wemind stop ${key} && wemind start ${key}${viaSwitch ? `；不想重启的话，接着执行 wemind brain switch ${agent} 也能当场应用（它按 name/bin/args/model 判断是不是同一个，改过就会真切换）` : ""}）`);
+		const viaSwitch = opts.bin !== void 0 || opts.args !== void 0 || opts.extraArgs !== void 0 || opts.model !== void 0;
+		lines.push(`（带 --bin/--args/--extra-args/--shell/--model 的改动不能由 brain set 当场应用：控制桥只认 agent 名。重启后生效——wemind stop ${key} && wemind start ${key}${viaSwitch ? `；不想重启的话，接着执行 wemind brain switch ${agent} 也能当场应用（它按 name/bin/args/model 判断是不是同一个，改过就会真切换）` : ""}）`);
 	} else if (daemonAlive(key)) lines.push(`（daemon 在跑但不是当前版本（不认控制桥）：盘已写好，重启一次才生效——wemind stop ${key} && wemind start ${key}）`);
 	else lines.push(`（daemon 需重启才生效：wemind start ${key}）`);
 	return lines.join("\n");
@@ -7546,6 +7890,7 @@ async function cmdBrain(rest) {
 	const FLAGS = /* @__PURE__ */ new Set([
 		"--bin",
 		"--args",
+		"--extra-args",
 		"--shell",
 		"--no-shell",
 		"--model",
@@ -7568,6 +7913,7 @@ async function cmdBrain(rest) {
 	};
 	const bin = takeFlag("--bin");
 	const argsOverride = takeFlag("--args");
+	const extraArgsOverride = takeFlag("--extra-args");
 	const model = takeFlag("--model");
 	const restart = argv.includes("--restart");
 	if (restart) argv.splice(argv.indexOf("--restart"), 1);
@@ -7578,7 +7924,7 @@ async function cmdBrain(rest) {
 	}
 	while (argv.includes("--worker")) argv.splice(argv.indexOf("--worker"), 1);
 	const unknown = argv.filter((x) => x.startsWith("--"));
-	if (unknown.length) throw new Error(`未知参数：${unknown.join(" ")}（可用：--bin --args --shell --no-shell --model --restart）`);
+	if (unknown.length) throw new Error(`未知参数：${unknown.join(" ")}（可用：--bin --args --extra-args --shell --no-shell --model --restart）`);
 	const pos = argv.filter((x) => x && !x.startsWith("--"));
 	const first = (pos[0] || "").toLowerCase();
 	if (first && !(/* @__PURE__ */ new Set([
@@ -7593,16 +7939,17 @@ async function cmdBrain(rest) {
 	switch (sub) {
 		case "show": return describeBrain(pickKey(pos[1]));
 		case "set":
-			if (!pos[1]) throw new Error("用法: brain set <agent 名|auto> [--bin X] [--args \"…\"] [--shell|--no-shell] [--model X|auto] [--restart] [<key|label>]");
+			if (!pos[1]) throw new Error("用法: brain set <agent 名|auto> [--bin X] [--args \"…\"] [--extra-args \"…\"] [--shell|--no-shell] [--model X|auto] [--restart] [<key|label>]");
 			return await cmdBrainSet(pos[1], pickKey(pos[2]), {
 				bin,
 				args: argsOverride,
+				extraArgs: extraArgsOverride,
 				shell,
 				model,
 				restart
 			});
 		case "switch": {
-			if (bin !== void 0 || argsOverride !== void 0 || shell !== void 0 || model !== void 0) throw new Error("`brain switch` 只接受 agent 名（换大脑是「换一个已装好的 agent」，不能带 --bin/--args/--model）。\n需要自定义二进制用 `brain set <agent 名> --bin …`（那是配置变更，只写入磁盘——之后 `wemind brain switch <同名 agent>` 可当场应用，或重启 daemon）；换模型用 `brain set <agent 名> --model …`。");
+			if (bin !== void 0 || argsOverride !== void 0 || extraArgsOverride !== void 0 || shell !== void 0 || model !== void 0) throw new Error("`brain switch` 只接受 agent 名（换大脑是「换一个已装好的 agent」，不能带 --bin/--args/--extra-args/--model）。\n需要自定义二进制用 `brain set <agent 名> --bin …`（那是配置变更，只写入磁盘——之后 `wemind brain switch <同名 agent>` 可当场应用，或重启 daemon）；追加参数用 `brain set <agent 名> --extra-args …`；换模型用 `brain set <agent 名> --model …`。");
 			if (!pos[1]) throw new Error("用法: brain switch <agent 名|auto> [--worker] [<key|label>]");
 			const worker = rest.includes("--worker");
 			return await cmdBrainSwitch(pos[1], pickKey(pos[2]), worker);
@@ -8110,8 +8457,8 @@ function helpText() {
   list                           列出账号、别名、运行状态（含 brain 进程与 worker 池）
   start [key|label]              启动某账号的 daemon（省略 = 默认账号）
   stop [key|label]               停止某账号的 daemon（连带 brain 与全部 worker 进程树；省略 = 默认账号）
-  brain set <agent 名|auto> [--bin X] [--args "…"] [--shell|--no-shell] [--model X|auto] [--restart] [<key|label>]
-                                 改账号大脑**配置**（写 brain.json；只给 agent 名且 daemon 认桥时当场应用；带 --bin/--args/--shell/--model 只写盘——除 --shell 外可用同名 brain switch 当场应用）
+  brain set <agent 名|auto> [--bin X] [--args "…"] [--extra-args "…"] [--shell|--no-shell] [--model X|auto] [--restart] [<key|label>]
+                                 改账号大脑**配置**（写 brain.json；只给 agent 名且 daemon 认桥时当场应用；带 --bin/--args/--extra-args/--shell/--model 只写盘——除 --shell 外可用同名 brain switch 当场应用；--extra-args 追加在预设参数后，不会漏掉 ACP 子命令）
   brain unset|check|show [<key|label>]   清除配置 / 真机 ACP 自检 / 查看配置与生效情况
   logout <key|label>             停 daemon + 通知下线 + 清凭证（保留目录，可重登）
   delete <key|label>             停 daemon + 删除目录 + 移除注册