@wemind/cli 1.0.0 → 1.1.0

package/README.md

@@ -16,7 +16,14 @@ wemind version           # → wemind 1.0.0 (@wemind/cli, node 24.x, win32-x64)
 npx -y @wemind/cli list
 ```
 
-要求：**Node.js >= 20**；想让它真的会「思考」，需要 PATH 上有一个支持 **ACP** 的 agent CLI（`kiro-cli` / `opencode` / 桌面端 `dsh` 等；未配置时自动探测 `kiro → opencode → gemini → deepseek`）。
+要求：**Node.js >= 20**；想让它真的会「思考」，需要 PATH 上有一个支持 **ACP** 的 agent CLI（`kiro-cli` / `opencode` / 桌面端 `dsh` / `qodercli` 等；未配置时自动探测 `kiro → opencode → gemini → deepseek → qoder`）。
+
+## 升级
+
+```bash
+npm i -g @wemind/cli@latest
+wemind stop <账号> && wemind start <账号>   # 已在运行的 daemon 不会自动加载新代码
+```
 
 ## 三步上手
 
@@ -53,7 +60,7 @@ wemind brain check                   # ③ 验证大脑能说 ACP（initialize +
 ## 数据与安全
 
 - 所有状态在 `~/.wemind/<账号>/`（可用 `WEMIND_HOME` 改根目录）：`account.json` 登录凭证、`state.json` 游标、`allowFrom.json` 授权清单、`brain-home/` 大脑沙箱、`daemon.log` 日志。
-- ⚠️ **daemon 用 `--trust-all-tools`**：能给这个 bot 发消息的人，即可让大脑在本机执行任意工具（shell / 写文件）。唯一安全闸是**发件人授权（allowFrom）**：扫码登录者自动授权，**勿清空**。
+- ⚠️ **daemon 会让大脑免确认执行工具**（kiro 预设 `--trust-all-tools`；qoder 预设 `--yolo`）：能给这个 bot 发消息的人，即可让大脑在本机执行任意工具（shell / 写文件）。唯一安全闸是**发件人授权（allowFrom）**：扫码登录者自动授权，**勿清空**。
 - `account.json` 里 bot token 是明文（POSIX 上 chmod 600；Windows 请用目录权限或磁盘加密）。
 - 同一个 bot token **只能有一个消费者**：`wemind` daemon 与 `@wemind/wechat-mcp` 二选一，否则互相抢消息。
 
@@ -78,10 +85,122 @@ wemind brain check                   # ③ 验证大脑能说 ACP（initialize +
 ## 文档
 
 - 完整文档：<https://github.com/imwangpan/WeMind>
+- 新手一步步教程：[docs/新手教程.md](https://github.com/imwangpan/WeMind/blob/main/docs/新手教程.md)
+- 发布与版本规则：[docs/发布-wemind-npm.md](https://github.com/imwangpan/WeMind/blob/main/docs/发布-wemind-npm.md)
 - AI 协作者入口：[AGENTS.md](https://github.com/imwangpan/WeMind/blob/main/AGENTS.md)
 - 接入其它 ACP agent：[docs/接入其它-ACP-Agent.md](https://github.com/imwangpan/WeMind/blob/main/docs/接入其它-ACP-Agent.md)
+- Qoder 接入：[docs/接入-Qoder.md](https://github.com/imwangpan/WeMind/blob/main/docs/接入-Qoder.md)
 - Daemon 常驻原理：[docs/repowiki/10-部署与运维.md](https://github.com/imwangpan/WeMind/blob/main/docs/repowiki/10-部署与运维.md)
 
+## 维护者：发布新版本
+
+本包（包名 `@wemind/cli`，命令 `wemind`）通过 GitHub Actions（[`.github/workflows/wemind-publish.yml`](../../.github/workflows/wemind-publish.yml)）发布到 npm。**下面的命令都在 WeMind 仓库根目录运行**，不是在 `packages/wechat-daemon` 子目录。
+
+> ⚠️ **本包比 `@wemind/wechat-mcp` 多一处要改**：版本号除了 `package.json` 和 `package-lock.json`，还有源码常量 `src/version.ts` 的 `CLI_VERSION`（`wemind version` 的输出就来自它）。漏改会让单测与 CI 直接失败——仓库自带 `npm run check:version` 专门挡这个。
+
+### 第一步：判断要不要发版
+
+| 你改了什么 | 需要发版吗 |
+| --- | --- |
+| `packages/wechat-daemon/src/**` 或 `packages/wechat-ilink-core/src/**`（内核会内联进来） | ✅ 要 |
+| 只改了 `*.md` 文档 | ❌ 不用（CI 仍跑检查，但版本没变会跳过发布） |
+| 只改了 `packages/wechat-mcp/**` | ❌ 与本包无关，发的是另一个包 |
+
+> 同一个版本号**不能重复发布**。所以「有没有改代码」不是关键，「有没有升版本号」才是——没升就只会跑检查、不发布。
+
+### 第二步：选版本号
+
+| 参数 | 示例 | 什么时候用 |
+| --- | --- | --- |
+| `patch` | `1.0.0` → `1.0.1` | Bug 修复、兼容性改动（**最常用**） |
+| `minor` | `1.0.0` → `1.1.0` | 新增向后兼容的能力（如新增内置大脑预设、新增子命令） |
+| `major` | `1.0.0` → `2.0.0` | 不兼容改动（如删子命令、改数据目录布局、改 CLI 参数） |
+
+### 第三步：升版本号（三处必须同步）
+
+**方式 A：用 npm 改 `package.json` + lock，再手改 `version.ts`（推荐）**
+
+```powershell
+# ① 改 package.json 与 package-lock.json
+npm version patch --workspace @wemind/cli --no-git-tag-version
+
+# ② 手工同步源码常量（npm 不会帮你改这个）
+#    编辑 packages/wechat-daemon/src/version.ts：
+#    export const CLI_VERSION = "1.0.1";   ← 与上一步的版本一致
+
+# ③ 自检三处是否一致（不一致会 exit 1）
+npm run check:version
+```
+
+- `--workspace @wemind/cli`：只动本包，不改根项目、mcp、core 的版本；
+- `--no-git-tag-version`：不自动创建 commit 或 tag，改完由你自己检查提交。
+
+**方式 B：全部手动**
+
+1. 编辑 `packages/wechat-daemon/package.json` 的 `"version"`；
+2. 编辑 `packages/wechat-daemon/src/version.ts` 的 `CLI_VERSION`；
+3. 回到仓库根目录刷新锁文件：
+
+```powershell
+npm install --package-lock-only --ignore-scripts
+```
+
+> 不要手动编辑 `package-lock.json`。上面这条只重算 lockfile 元数据，不重装 `node_modules`、不跑依赖的安装脚本。
+
+### 第四步：本地校验
+
+```powershell
+npm run check:version    # 包名 + 三处版本一致（package.json / version.ts / lock）
+npm run lint && npm run typecheck && npm run build && npm test
+npm pack --dry-run --workspace @wemind/cli    # 应看到 4 个文件：cli.js / cli.js.map / README.md / package.json
+```
+
+> ⚠️ **`npm publish` 不会自动 build**。CI 会 build，但本地 `npm pack` 前必须先 `npm run build`，否则打出来是旧产物（`dist/` 在 `.gitignore` 里）。
+>
+> `prepack` 守卫（`scripts/prepack-guard.mjs`）会兜底拒绝：产物目录为空、`bin` 缺失、或声明了 sourcemap 却没把 `.map` 带进包。
+
+### 第五步：提交并推送
+
+```powershell
+git add packages/wechat-daemon/package.json packages/wechat-daemon/src/version.ts package-lock.json
+git add packages/wechat-daemon/src packages/wechat-ilink-core/src   # 有源码改动时
+git commit -m "chore: release @wemind/cli 1.0.1"
+git push origin main
+```
+
+推送到 `main` 后，工作流依次执行：
+
+```
+check-version（三处一致）→ npm ci → lint → format:check → typecheck → build → test
+→ npm pack --dry-run（prepack 守卫确认包内容）
+→ 把 tarball 真装到临时目录跑 wemind version / help（装包冒烟）
+→ 检查 npm 上是否已存在该版本
+→ 不存在则 npm publish（带 provenance 来源证明）；已存在则跳过并输出 notice
+```
+
+**看到 `Publish to npm` 显示 skipped 是正常的**：说明这个版本已发过（比如你只改了文档、没升版本）。想真正发版，回到第二步升版本号。
+
+### 第六步：发布后验收
+
+```powershell
+npm view @wemind/cli version                        # 应显示新版本号
+npm i -g @wemind/cli@latest && wemind version       # → wemind <新版本> (@wemind/cli, node …, <platform>-<arch>)
+wemind list                                         # 应能正确识别在跑的账号与进程
+```
+
+已装用户升级：`npm i -g @wemind/cli@latest`，然后 `wemind stop <账号> && wemind start <账号>` ——**正在运行的 daemon 不会自动加载新代码**。
+
+### 常见坑
+
+| 现象 | 原因 | 处理 |
+| --- | --- | --- |
+| CI 在 `check-version` 就红了 | 只改了 `package.json`，没同步 `version.ts` | 改 `CLI_VERSION` 后重推 |
+| CI 绿了但 npm 上没新版本 | 版本号没升，被跳过 | 升版本号后再推 |
+| CI 报 lock 版本不一致 | 没跑 `npm install --package-lock-only` | 补跑第三步 |
+| `npm pack` 出来是空壳 | 没先 `npm run build` | 先 build 再 pack |
+| `prepack` 守卫拒绝发布 | 产物为空 / `bin` 缺失 / 声明了 sourcemap 但 `.map` 不在包里 | 按守卫提示补 build 或检查 `files` |
+| `npm publish` 报 403 / EOTP | 本地直发需要交互式 2FA | **不要本地发**，走 CI（Trusted Publisher 已配好） |
+
 ## License
 
 MIT

package/dist/cli.js

@@ -940,7 +940,7 @@ const ACP_AGENT_PRESETS = {
 		realHome: path.join(os.homedir(), ".dsh"),
 		inheritDirs: ["skills"],
 		inheritFiles: ["AGENTS.md"],
-		credentialFile: ".credentials.yaml",
+		credentialFiles: [".credentials.yaml"],
 		restore: "resume",
 		firstFrameMs: 6e4,
 		heartbeatMs: 6e4,
@@ -948,6 +948,29 @@ const ACP_AGENT_PRESETS = {
 		model: "[\"deepseek-account\",\"deepseek-flash\"]",
 		mcpViaAcp: true
 	},
+	qoder: {
+		name: "qoder",
+		bin: "qodercli",
+		binWin: "qodercli.exe",
+		fallbackBinPaths: process.platform === "win32" ? [path.join(os.homedir(), ".qoder", "bin", "qodercli", "qodercli.exe")] : [],
+		args: ["--acp", "--yolo"],
+		env: { QODER_CONFIG_DIR: `%HOME%${path.sep}qoder` },
+		realHome: path.join(os.homedir(), ".qoder"),
+		inheritDirs: [
+			"memory",
+			"skills",
+			"agents",
+			"commands"
+		],
+		inheritFiles: ["AGENTS.md"],
+		configSubdir: "qoder",
+		mcpFormat: "kiro",
+		mcpConfigFile: "settings.json",
+		catalogFile: "settings.json",
+		settingsBase: "settings.json",
+		credentialFiles: [".auth/user"],
+		identityFiles: [".auth/machine_id"]
+	},
 	"claude-code": {
 		name: "claude-code",
 		bin: "npx",
@@ -975,7 +998,8 @@ const AUTO_PROBE_ORDER = [
 	"kiro",
 	"opencode",
 	"gemini",
-	"deepseek"
+	"deepseek",
+	"qoder"
 ];
 /** 预设在该平台的「可执行文件名」（用于 PATH 探测）。 */
 function presetExe(preset) {
@@ -1015,16 +1039,17 @@ function resolveAgent(cfg) {
 		key = "kiro";
 	}
 	const preset = ACP_AGENT_PRESETS[key];
+	const overrideCfg = envKey && cfg?.agent?.trim() && cfg.agent.trim().toLowerCase() !== requestedKey ? null : cfg;
 	const shellEnv = process.env.WEMIND_BRAIN_SHELL?.trim();
-	const shell = shellEnv !== void 0 && shellEnv !== "" ? shellEnv === "1" || shellEnv.toLowerCase() === "true" : cfg?.shell ?? preset.shell ?? false;
-	const explicitBin = process.env.WEMIND_BRAIN_BIN?.trim() || (preset.name === "kiro" ? process.env.KIRO_CLI_BIN?.trim() : void 0) || cfg?.bin?.trim() || "";
+	const shell = shellEnv !== void 0 && shellEnv !== "" ? shellEnv === "1" || shellEnv.toLowerCase() === "true" : overrideCfg?.shell ?? preset.shell ?? false;
+	const explicitBin = process.env.WEMIND_BRAIN_BIN?.trim() || (preset.name === "kiro" ? process.env.KIRO_CLI_BIN?.trim() : void 0) || overrideCfg?.bin?.trim() || "";
 	const exe = presetExe(preset);
-	const binPath = explicitBin ? locateBin(explicitBin) : onPath(exe);
+	const binPath = explicitBin ? locateBin(explicitBin) : onPath(exe) ?? (preset.fallbackBinPaths ?? []).find((p) => fs.existsSync(p)) ?? null;
 	const bin = explicitBin || (shell ? process.platform === "win32" ? exe : preset.bin : binPath || preset.bin);
 	const available = known && binPath !== null;
 	const argsOverride = process.env.WEMIND_BRAIN_ARGS?.trim();
-	const args = argsOverride ? argsOverride.split(/\s+/) : cfg?.args && cfg.args.length ? cfg.args : preset.args;
-	const homeEnvVar = process.env.WEMIND_BRAIN_HOME_ENV?.trim() || cfg?.homeEnvVar?.trim() || preset.homeEnvVar;
+	const args = argsOverride ? argsOverride.split(/\s+/) : overrideCfg?.args && overrideCfg.args.length ? overrideCfg.args : preset.args;
+	const homeEnvVar = process.env.WEMIND_BRAIN_HOME_ENV?.trim() || overrideCfg?.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;
 	const dirsEnv = process.env.WEMIND_BRAIN_INHERIT_DIRS?.trim();
@@ -1048,7 +1073,9 @@ function resolveAgent(cfg) {
 		firstFrameMs: preset.firstFrameMs,
 		heartbeatMs: preset.heartbeatMs,
 		images: preset.images ?? true,
-		credentialFile: preset.credentialFile,
+		credentialFiles: preset.credentialFiles ?? [],
+		identityFiles: preset.identityFiles ?? [],
+		settingsBase: preset.settingsBase,
 		model: preset.model,
 		mcpViaAcp: preset.mcpViaAcp ?? false,
 		requestedKey,
@@ -1065,7 +1092,7 @@ function resolveAgent(cfg) {
 function agentProblem(ag) {
 	if (!ag.known) return `未知大脑预设「${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 <预设>\``;
-	if (!ag.available) return ag.name === "deepseek" ? `找不到 DeepSeek 的「${ag.bin}」。桌面端通常有 dsh.cmd；把它的绝对路径传给 \`wemind brain set deepseek --bin "<...>\\dsh.cmd"\`` : `找不到大脑「${ag.name}」的二进制「${ag.bin}」。安装它，或运行 \`wemind brain set <预设>\` 切换`;
+	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 <预设>\` 切换`;
 	return null;
 }
 //#endregion
@@ -1306,22 +1333,32 @@ function readJson$1(file) {
 	}
 }
 /**
-* 把 agent 的凭据文件同步进沙箱（如 DSH 的 `.credentials.yaml`）。
-* 新者胜：首次复制；真实 home 的 token 刷新后覆盖沙箱；沙箱自己刷新过则保留沙箱版本。
+* 把 agent 的凭据文件同步进沙箱（如 DSH 的 `.credentials.yaml`、Qoder 的 `.auth/user`）。
+* - `newer`：首次复制；真实 home 的 token 刷新后覆盖沙箱；沙箱自己刷新过则保留沙箱版本。
+* - `always`：内容不同即覆盖（标识类文件，如 Qoder 的 `.auth/machine_id`——agent 在缺凭据时会自造一个，
+*   它比真实文件新，「新者胜」会把错的留下，导致永远认证失败）。
 * 这是敏感文件，仅放在账号沙箱内；Windows 无 POSIX 600，建议专用账号 + 目录 ACL。
 */
-function syncCredentialFile$1() {
-	if (!AG$1.credentialFile || !AG$1.realHome) return;
-	const src = path.join(AG$1.realHome, AG$1.credentialFile);
-	const dst = path.join(BRAIN_CONFIG_DIR, AG$1.credentialFile);
+function syncCredentialFile$1(file, mode) {
+	if (!AG$1.realHome) return;
+	const src = path.join(AG$1.realHome, file);
+	const dst = path.join(BRAIN_CONFIG_DIR, file);
 	try {
 		if (!fs.existsSync(src)) return;
 		fs.mkdirSync(path.dirname(dst), { recursive: true });
+		if (mode === "always") {
+			if (!(fs.existsSync(dst) && fs.readFileSync(src).equals(fs.readFileSync(dst)))) fs.copyFileSync(src, dst);
+			return;
+		}
 		const s = fs.statSync(src);
 		const d = fs.existsSync(dst) ? fs.statSync(dst) : null;
 		if (!d || s.mtimeMs > d.mtimeMs + 1e3) fs.copyFileSync(src, dst);
 	} catch {}
 }
+function syncCredentials$1() {
+	for (const f of AG$1.credentialFiles) syncCredentialFile$1(f, "newer");
+	for (const f of AG$1.identityFiles) syncCredentialFile$1(f, "always");
+}
 function loadCatalog$1() {
 	return readMcpServers(readJson$1(CATALOG$1), AG$1.mcpFormat);
 }
@@ -1398,10 +1435,41 @@ function syncOpencodeBase$1() {
 	fs.mkdirSync(BRAIN_CONFIG_DIR, { recursive: true });
 	fs.writeFileSync(BRAIN_MCP_JSON, JSON.stringify(parsed, null, 2), "utf-8");
 }
+/** Qoder 这类「设置与 MCP 同文件」的 agent：以真实 settings.json 为基底生成沙箱设置。
+*  剥离必须由沙箱权威决定的键：
+*  - `mcpServers`：MCP 只能来自沙箱 curated（防 wechat 回环）；
+*  - `enabledPlugins`：插件可自带 MCP，且沙箱不继承 `plugins/`；
+*  - `providers` / `model`：自定义供应商（BYOK）含明文密钥，`model` 又可能指向已剥离的供应商。
+*  并强制 `general.enableAutoUpdate=false`：否则每个沙箱都会各下一份约 210 MB 的 CLI。 */
+function settingsBase$1() {
+	let parsed = null;
+	try {
+		parsed = JSON.parse(fs.readFileSync(path.join(AG$1.realHome, AG$1.settingsBase), "utf-8"));
+	} catch {}
+	const base = parsed && typeof parsed === "object" && !Array.isArray(parsed) ? { ...parsed } : {};
+	delete base.mcpServers;
+	delete base.enabledPlugins;
+	delete base.providers;
+	delete base.model;
+	const general = base.general;
+	base.general = {
+		...general && typeof general === "object" && !Array.isArray(general) ? general : {},
+		enableAutoUpdate: false
+	};
+	return base;
+}
+function syncSettingsBase$1() {
+	fs.mkdirSync(BRAIN_CONFIG_DIR, { recursive: true });
+	fs.writeFileSync(BRAIN_MCP_JSON, JSON.stringify(settingsBase$1(), null, 2), "utf-8");
+}
 /** 继承真实配置目录的「非 MCP」设置（模型/免确认等），让大脑与日常使用同款配置；mcp 段保持沙箱权威。
 *  `mcpViaAcp` 预设没有文件式 MCP/settings 可继承，跳过（模型走 preset.model + set_config_option）。 */
 function syncSettings$1() {
 	if (AG$1.mcpViaAcp) return;
+	if (AG$1.settingsBase && AG$1.realHome) {
+		syncSettingsBase$1();
+		return;
+	}
 	if (!AG$1.inherit || !AG$1.realHome) return;
 	if (AG$1.mcpFormat === "opencode") syncOpencodeBase$1();
 	else syncKiroSettings$1();
@@ -1411,7 +1479,7 @@ function ensureBrainHome() {
 	syncSettings$1();
 	applySandbox();
 	mirrorRealKiro$1();
-	syncCredentialFile$1();
+	syncCredentials$1();
 }
 function addMcp(name) {
 	if (FORBIDDEN.has(name)) return `不允许加载「${name}」（防回环）。`;
@@ -1480,6 +1548,43 @@ function spawnAgent(agent, opts = {}) {
 	});
 }
 //#endregion
+//#region src/session-map.ts
+/**
+* brainstorm/worker 共用的 session 映射键规则：`<agent>:<key>`。
+* 换大脑后各 agent 的会话互不覆盖，切回原大脑仍能 session/load 回原上下文。
+*/
+function sessionKey(agent, key) {
+	return `${agent}:${key}`;
+}
+/**
+* 把磁盘上的映射归一成 `<agent>:<key>` 形式。
+* - 已带前缀的条目原样保留（其它 agent 的会话不动）；
+* - 旧格式（裸 key）由「当时那个 agent」写入、已无从得知是哪个 → 归给当前 agent；
+*   若同名的新格式条目已存在，则保留新格式（它的归属确定），只丢掉裸条目。
+* migrated=true 时调用方应立即回写，避免下次换 agent 时旧条目再被继承一次。
+*/
+function normalizeSessionMap(raw, agent) {
+	const map = {};
+	const legacy = [];
+	if (!raw || typeof raw !== "object" || Array.isArray(raw)) return {
+		map,
+		migrated: false
+	};
+	for (const [k, v] of Object.entries(raw)) {
+		if (typeof v !== "string") continue;
+		if (k.includes(":")) map[k] = v;
+		else legacy.push([k, v]);
+	}
+	for (const [k, v] of legacy) {
+		const nk = sessionKey(agent, k);
+		if (!map[nk]) map[nk] = v;
+	}
+	return {
+		map,
+		migrated: legacy.length > 0
+	};
+}
+//#endregion
 //#region src/acp-brain.ts
 /**
 * ACP 大脑：维护一个常驻的 ACP agent 进程（JSON-RPC over stdio，换行分隔）。
@@ -1546,13 +1651,17 @@ function reset$1() {
 	assembling$1.clear();
 	stdoutBuf$1 = "";
 }
+const keyOf$1 = (userId) => sessionKey(AGENT$1.name, userId);
 function loadSessionMap$1() {
+	let raw;
 	try {
-		const j = JSON.parse(fs.readFileSync(SESSION_MAP_FILE$1, "utf-8"));
-		return j && typeof j === "object" ? j : {};
+		raw = JSON.parse(fs.readFileSync(SESSION_MAP_FILE$1, "utf-8"));
 	} catch {
 		return {};
 	}
+	const { map, migrated } = normalizeSessionMap(raw, AGENT$1.name);
+	if (migrated) saveSessionMap$1(map);
+	return map;
 }
 function saveSessionMap$1(m) {
 	fs.mkdirSync(DATA_DIR, { recursive: true });
@@ -1776,7 +1885,7 @@ async function ensureSession$1(userId) {
 	if (existing) return existing;
 	const mcpServers = AGENT$1.mcpViaAcp ? activeMcpServers() : [];
 	const map = loadSessionMap$1();
-	const saved = map[userId];
+	const saved = map[keyOf$1(userId)];
 	if (saved) {
 		const methods = AGENT$1.restore === "resume" ? ["resume"] : ["load", "resume"];
 		for (const method of methods) try {
@@ -1800,7 +1909,7 @@ async function ensureSession$1(userId) {
 	if (!res?.sessionId) throw new Error("session/new returned no sessionId");
 	await applyModel$1(res.sessionId);
 	userSessions.set(userId, res.sessionId);
-	map[userId] = res.sessionId;
+	map[keyOf$1(userId)] = res.sessionId;
 	saveSessionMap$1(map);
 	dlog$1(`session/new ok ${res.sessionId} mcp=[${mcpServers.map((s) => s.name).join(",")}]`);
 	return res.sessionId;
@@ -1859,7 +1968,7 @@ async function askBrain(userId, message, onProgress, images) {
 /** 用户主动开新会话：丢弃旧 session（含磁盘映射），重建一个全新 session。 */
 async function newSession(userId) {
 	const map = loadSessionMap$1();
-	delete map[userId];
+	delete map[keyOf$1(userId)];
 	saveSessionMap$1(map);
 	userSessions.delete(userId);
 	await ensureProcess$1();
@@ -2007,19 +2116,28 @@ function readJson(file) {
 		return null;
 	}
 }
-/** 同 brain：把凭据文件（如 DSH 的 .credentials.yaml）新者胜地同步进 worker 沙箱。 */
-function syncCredentialFile() {
-	if (!AG.credentialFile || !AG.realHome) return;
-	const src = path.join(AG.realHome, AG.credentialFile);
-	const dst = path.join(WORKER_CONFIG_DIR, AG.credentialFile);
+/** 同 brain：把凭据文件（如 DSH 的 `.credentials.yaml`、Qoder 的 `.auth/user`）同步进 worker 沙箱。
+*  `newer`=新者胜；`always`=内容不同即覆盖（标识类文件必须与真实目录一致，见 mcp-sandbox.ts）。 */
+function syncCredentialFile(file, mode) {
+	if (!AG.realHome) return;
+	const src = path.join(AG.realHome, file);
+	const dst = path.join(WORKER_CONFIG_DIR, file);
 	try {
 		if (!fs.existsSync(src)) return;
 		fs.mkdirSync(path.dirname(dst), { recursive: true });
+		if (mode === "always") {
+			if (!(fs.existsSync(dst) && fs.readFileSync(src).equals(fs.readFileSync(dst)))) fs.copyFileSync(src, dst);
+			return;
+		}
 		const s = fs.statSync(src);
 		const d = fs.existsSync(dst) ? fs.statSync(dst) : null;
 		if (!d || s.mtimeMs > d.mtimeMs + 1e3) fs.copyFileSync(src, dst);
 	} catch {}
 }
+function syncCredentials() {
+	for (const f of AG.credentialFiles) syncCredentialFile(f, "newer");
+	for (const f of AG.identityFiles) syncCredentialFile(f, "always");
+}
 function loadCatalog() {
 	return readMcpServers(readJson(CATALOG), AG.mcpFormat);
 }
@@ -2091,8 +2209,34 @@ function syncOpencodeBase() {
 	fs.mkdirSync(WORKER_CONFIG_DIR, { recursive: true });
 	fs.writeFileSync(WORKER_MCP_JSON, JSON.stringify(parsed, null, 2), "utf-8");
 }
+/** Qoder 这类「设置与 MCP 同文件」的 agent：与 brain 相同的基底疗法（剥离 MCP/插件/自定义供应商 + 关自动更新）。 */
+function settingsBase() {
+	let parsed = null;
+	try {
+		parsed = JSON.parse(fs.readFileSync(path.join(AG.realHome, AG.settingsBase), "utf-8"));
+	} catch {}
+	const base = parsed && typeof parsed === "object" && !Array.isArray(parsed) ? { ...parsed } : {};
+	delete base.mcpServers;
+	delete base.enabledPlugins;
+	delete base.providers;
+	delete base.model;
+	const general = base.general;
+	base.general = {
+		...general && typeof general === "object" && !Array.isArray(general) ? general : {},
+		enableAutoUpdate: false
+	};
+	return base;
+}
+function syncSettingsBase() {
+	fs.mkdirSync(WORKER_CONFIG_DIR, { recursive: true });
+	fs.writeFileSync(WORKER_MCP_JSON, JSON.stringify(settingsBase(), null, 2), "utf-8");
+}
 function syncSettings() {
 	if (AG.mcpViaAcp) return;
+	if (AG.settingsBase && AG.realHome) {
+		syncSettingsBase();
+		return;
+	}
 	if (!AG.inherit || !AG.realHome) return;
 	if (AG.mcpFormat === "opencode") syncOpencodeBase();
 	else syncKiroSettings();
@@ -2148,7 +2292,7 @@ function ensureWorkerHome() {
 	syncSettings();
 	applyWorkerSandbox();
 	mirrorRealKiro();
-	syncCredentialFile();
+	syncCredentials();
 }
 //#endregion
 //#region src/worker-acp.ts
@@ -2229,13 +2373,17 @@ function reset() {
 	assembling.clear();
 	stdoutBuf = "";
 }
+const keyOf = (key) => sessionKey(AGENT.name, key);
 function loadSessionMap() {
+	let raw;
 	try {
-		const j = JSON.parse(fs.readFileSync(SESSION_MAP_FILE, "utf-8"));
-		return j && typeof j === "object" ? j : {};
+		raw = JSON.parse(fs.readFileSync(SESSION_MAP_FILE, "utf-8"));
 	} catch {
 		return {};
 	}
+	const { map, migrated } = normalizeSessionMap(raw, AGENT.name);
+	if (migrated) saveSessionMap(map);
+	return map;
 }
 function saveSessionMap(m) {
 	fs.mkdirSync(DATA_DIR, { recursive: true });
@@ -2456,7 +2604,7 @@ async function ensureSession(key) {
 	if (existing) return existing;
 	const mcpServers = AGENT.mcpViaAcp ? workerMcpServers() : [];
 	const map = loadSessionMap();
-	const saved = map[key];
+	const saved = map[keyOf(key)];
 	if (saved) {
 		const methods = AGENT.restore === "resume" ? ["resume"] : ["load", "resume"];
 		for (const method of methods) try {
@@ -2480,7 +2628,7 @@ async function ensureSession(key) {
 	if (!res?.sessionId) throw new Error("session/new returned no sessionId");
 	await applyModel(res.sessionId);
 	taskSessions.set(key, res.sessionId);
-	map[key] = res.sessionId;
+	map[keyOf(key)] = res.sessionId;
 	saveSessionMap(map);
 	dlog(`session/new ok ${res.sessionId} mcp=[${mcpServers.map((s) => s.name).join(",")}]`);
 	return res.sessionId;
@@ -2525,7 +2673,7 @@ async function askWorker(instruction, onProgress) {
 /** 开新任务会话：丢弃旧 session（含磁盘映射），下次 askWorker 全新开始。 */
 function newWorkerSession() {
 	const map = loadSessionMap();
-	delete map[TASK_KEY];
+	delete map[keyOf(TASK_KEY)];
 	saveSessionMap(map);
 	taskSessions.delete(TASK_KEY);
 }
@@ -3585,6 +3733,13 @@ async function checkAgent(ag, timeoutMs = 6e4) {
 	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 cfgDir = path.join(home, ag.configSubdir);
+	for (const f of [...ag.credentialFiles, ...ag.identityFiles]) try {
+		const src = path.join(ag.realHome ?? "", f);
+		if (!ag.realHome || !fs.existsSync(src)) continue;
+		fs.mkdirSync(path.dirname(path.join(cfgDir, f)), { recursive: true });
+		fs.copyFileSync(src, path.join(cfgDir, f));
+	} catch {}
 	const proc = spawnAgent(ag, {
 		cwd: home,
 		env
@@ -3694,7 +3849,7 @@ async function checkAgent(ag, timeoutMs = 6e4) {
 * 与 package.json 的 version 必须一致——单测 version.test.ts 会读 package.json 校验，
 * 避免「发了新版本、CLI 还报旧版本号」这种排查成本极高的小漂移。
 */
-const CLI_VERSION = "1.0.0";
+const CLI_VERSION = "1.1.0";
 /**
 * npm 包名（与 package.json 的 name 一致，单测校验）。
 * 命令名是 `wemind`，但**包名**是 `@wemind/cli`——两者不同，所以 `npx` 不能靠「唯一 bin」自动解析，