@lmzhen/dsh-evolution-commands 0.22.0 → 0.24.0

package/lib/index.js

@@ -2,9 +2,10 @@ import { createRequire } from "node:module";
 import z from "@deepseek-ai/schemastery";
 import { effectiveSessionPolicy } from "@lmzhen/dsh-evolution-approval";
 import { createUserMessage } from "@deepseek-ai/dsh-llm";
-import { DEFAULT_SKILL_LIMITS, MAX_TIMER_DELAY_MS, PARAM_EXPOSURE, PARAM_GROUP_LABELS, absentHostServices, appendEvolutionEvent, applyNamespaceMigration, assertSkillsRootAliasRetired, buildLearnPrompt, canonicalWriteId, clampedNumber, classifyNamespaceMigration, composePresetEntry, elapsedSince, errorText, eventsFile, evolutionHome, evolutionRoot, isDeprecatedParamId, isMissingPath, isPresent, isUnknown, liveBool, mergePresetRow, newRunRegistry, newSkillLibrary, paramSettingsId, partitionVersions, planNamespaceMigration, policyStageLimits, presetPatchText, presetRowBlock, presetRowBody, presetRowId, probeText, reportsSweepLockTarget, resolveBasePresetPatch, resolveParamId, resolveRootConfig, scopedProbeReport, sweepReports, transactIo } from "@lmzhen/dsh-evolution-core";
+import { DEFAULT_SKILL_LIMITS, MAX_TIMER_DELAY_MS, PARAM_EXPOSURE, PARAM_GROUP_LABELS, absentHostServices, appendEvolutionEvent, applyNamespaceMigration, asRecord, assertSkillsRootAliasRetired, atomicWriteFiles, buildLearnPrompt, canonicalWriteId, clampedNumber, classifyNamespaceMigration, composePresetEntry, elapsedSince, errorText, eventsFile, evolutionHome, evolutionRoot, isDeprecatedParamId, isPresent, isRecord, isUnknown, liveBool, mergePresetRow, newRunRegistry, newSkillLibrary, paramSettingsId, partitionVersions, planNamespaceMigration, policyStageLimits, presetPatchText, presetRowBlock, presetRowBody, presetRowId, probeText, reportsSweepLockTarget, resolveBasePresetPatch, resolveParamId, resolveRootConfig, scopedProbeReport, sweepReports, transactIo } from "@lmzhen/dsh-evolution-core";
 import { buildEnrichment, buildMaintainFacts, enrichmentSnapshotOptions, runMaintain, snapshotFromLibrary } from "@lmzhen/dsh-evolution-maintenance";
-import { copyFileSync, existsSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { preferProvider } from "@lmzhen/dsh-evolution-io";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 //#region lib/types/migration.js
@@ -194,7 +195,7 @@ async function objectOf(read) {
 	if (read === void 0) return void 0;
 	try {
 		const value = await read();
-		return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+		return isRecord(value) ? value : void 0;
 	} catch {
 		return;
 	}
@@ -272,10 +273,10 @@ function presetProfileTarget(ctx) {
 * @returns the refusal text, or undefined when the base is usable here.
 */
 function baseRefusalReason(entry, servicePresent) {
-	if (typeof entry.unsupported === "string" && entry.unsupported !== "") return `Base "${entry.name}" is registered as UNSUPPORTED: ${entry.unsupported}`;
+	if (typeof entry.unsupported === "string" && entry.unsupported !== "") return `基底「${entry.name}」被登记为 UNSUPPORTED（不受支持）：${entry.unsupported}`;
 	const service = entry.requires?.service;
 	if (typeof service !== "string" || service === "") return void 0;
-	return servicePresent(service) ? void 0 : `Base "${entry.name}" requires the "${service}" service, which this deployment does not provide — the generated preset would refuse to mount.`;
+	return servicePresent(service) ? void 0 : `基底 "${entry.name}" 需要 "${service}" 服务，而本部署没有提供它 —— 生成的预设会拒绝挂载。`;
 }
 /**
 * Resolve the platform base preset patch one `--base` composes.
@@ -422,7 +423,7 @@ function profilePatchText(profileDir) {
 function installExclusionTarget(mounted) {
 	if (mounted === void 0 || mounted.dir === "") return {
 		kind: "undecidable",
-		reason: "no profile is mounted in this process, so the double-mount question cannot be answered here"
+		reason: "本进程没有挂载 profile，因此无法在这里回答双挂载问题"
 	};
 	let manifestFailure;
 	const declared = profileBundles(mounted.dir, (error) => {
@@ -431,7 +432,7 @@ function installExclusionTarget(mounted) {
 	const manifestCode = manifestFailure?.code;
 	if (manifestFailure !== void 0 && manifestCode !== "ENOENT") return {
 		kind: "undecidable",
-		reason: "the mounted profile manifest could not be read"
+		reason: "读不出已挂载 profile 的清单"
 	};
 	return {
 		kind: "mounted",
@@ -521,7 +522,7 @@ function presetIssues(presets) {
 * @returns one readable line per divergence, empty when there is nothing to compare.
 */
 function paramDivergences(platform) {
-	if (platform.configuration === void 0) return ["the platform configuration surface (configEditor.configuration) is not mounted here — parameter divergences were NOT checked"];
+	if (platform.configuration === void 0) return ["平台上没有挂载配置面（configEditor.configuration）：参数差异没有被检查"];
 	const issues = [];
 	for (const row of platform.configuration) {
 		const override = asMapping(row.override);
@@ -538,7 +539,7 @@ function paramDivergences(platform) {
 		}
 	}
 	if (platform.plugins === void 0) {
-		issues.push("the platform plugin-row surface (pluginManager.listPlugins) is not mounted here — declared-but-unreachable parameters were NOT checked");
+		issues.push("平台上没有挂载插件行面（pluginManager.listPlugins）：已声明但不可达的参数没有被检查");
 		return issues;
 	}
 	const live = liveRowTails(platform.plugins);
@@ -579,7 +580,7 @@ function liveRowTails(plugins) {
 * @returns the mapping, or undefined for anything else.
 */
 function asMapping(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+	return asRecord(value);
 }
 /** Profile bundle rows for evolution-family packages across all profiles.
 *
@@ -920,7 +921,7 @@ async function diagnose(ctx, options = {}) {
 	const conflicts = [];
 	const bundles = collectEvolutionBundles(home, (error, scope) => {
 		const detail = error instanceof Error ? error.message : String(error);
-		conflicts.push(scope === "profiles-dir" ? `the home profiles directory could not be enumerated (${detail}) — bundle-based install-form and conflict checks are DEGRADED and may miss installed bundles` : `a profile manifest could not be read or parsed (${detail}) — this profile's bundle rows are UNKNOWN, so the install-form and conflict checks are DEGRADED and may miss installed bundles`);
+		conflicts.push(scope === "profiles-dir" ? `本 home 的 profiles 目录无法枚举（${detail}）：基于 bundle 的安装形态与冲突检查已降级（DEGRADED），可能漏掉已安装的 bundle` : `本 profile 清单读不出来或无法解析（${detail}）：本 profile 的 bundle 行为未知，因此安装形态与冲突检查已降级（DEGRADED），可能漏掉已安装的 bundle`);
 	});
 	const has = (name) => ctx.get(name) !== void 0;
 	const capabilityAbsence = absentHostServices(has);
@@ -1078,7 +1079,7 @@ async function probeBounded(work, label) {
 		timer = setTimeout(() => {
 			resolve({
 				ok: false,
-				message: `${label} did not answer within ${PROBE_TIMEOUT_MS}ms — the corpus is blocked (a concurrent writer can stall the observation) or the service is wedged; isolate the most recently written session and re-run`
+				message: `${label} 在 ${PROBE_TIMEOUT_MS}ms 内没有应答：语料被阻塞（并发写入方可能拖住观测），或服务卡死。请隔离最近写入的会话后重试。`
 			});
 		}, PROBE_TIMEOUT_MS);
 	});
@@ -1288,9 +1289,24 @@ const SOURCE_LABELS = Object.freeze({
 });
 /** What the E-tiers mean, so the count line reads without the docs. */
 const TIER_LEGEND = "档位：E0 固定／E1 只读／E2 安装时定／E3 你可改／E4 装完固化。";
+/**
+* The source column's word for one row (F-1).
+*
+* `unregistered` covers TWO different facts: the owner publishes no settings namespace (the value
+* really cannot be written — E-315/E-316) and the settings service itself is missing (then whether
+* the value could be written is UNKNOWN). Without a provider the column must not claim "不可改", or it
+* contradicts the legend and the footer of the very same output.
+* @param row - the row's surface facts.
+* @param providerMounted - whether a settings provider answered.
+* @returns the label for the source column.
+*/
+function sourceLabel(row, providerMounted) {
+	const label = SOURCE_LABELS[row.source] ?? row.source;
+	return providerMounted || row.source !== "unregistered" ? label : "未知";
+}
 function renderParamRows(rows, options) {
 	const header = pad("参数", 36) + pad("分组", 12) + pad("档位", 6) + pad("生效", 8) + pad("来源", 10) + "当前值";
-	const body = rows.map((row) => pad(row.id, 36) + pad(PARAM_GROUP_LABELS[row.group], 12) + pad(row.tier, 6) + pad(APPLIES_LABELS[row.applies] ?? row.applies, 8) + pad(SOURCE_LABELS[row.source] ?? row.source, 10) + renderValue(row.value));
+	const body = rows.map((row) => pad(row.id, 36) + pad(PARAM_GROUP_LABELS[row.group], 12) + pad(row.tier, 6) + pad(APPLIES_LABELS[row.applies] ?? row.applies, 8) + pad(sourceLabel(row, options.providerMounted), 10) + renderValue(row.value));
 	const tiers = [
 		"E0",
 		"E1",
@@ -1347,116 +1363,160 @@ function renderParamJson(rows) {
 }
 //#endregion
 //#region lib/types/registry.js
+/** The flags the TABLE declares for one subcommand (name → `--flag`), DERIVED from its usage. */
+function flagsOf(name) {
+	const entry = COMMAND_ENTRIES.find((candidate) => entryName(candidate) === name);
+	return entry === void 0 ? [] : entryFlags(entry);
+}
+/** C7 shape, DERIVED: the subcommand name is the first token of `usage` (variants use `|`). */
+function entryName(entry) {
+	const [head = ""] = entry.usage.split(" ");
+	return head.split("|")[0] ?? "";
+}
+/** C7 shape, DERIVED: the flags a `usage` declares, in the form `--flag` (value flags keep their name). */
+function entryFlags(entry) {
+	const found = [];
+	for (const match of entry.usage.matchAll(/--[a-z][a-z-]*/g)) if (!found.includes(match[0])) found.push(match[0]);
+	return found;
+}
 const COMMAND_ENTRIES = [
 	{
+		readonly: true,
 		usage: "pending [--detail]",
 		summary: "列出暂存的写入（--detail 显示参数）"
 	},
 	{
+		readonly: false,
 		usage: "approve <id>",
 		summary: "执行一条已批准的写入"
 	},
 	{
+		readonly: false,
 		usage: "reject <id>",
 		summary: "丢弃一条暂存写入，不执行"
 	},
 	{
+		readonly: false,
 		usage: "release <id>",
-		summary: "把卡在执行中的写入放回待批窗口（先确认效果再批准 or reject)"
+		summary: "把卡在执行中的写入放回待批窗口（先确认效果再批准或驳回）"
 	},
 	{
+		readonly: true,
 		usage: "doctor [--json]",
 		summary: "只读自检：安装形态、冲突、环境、服务（--json 供脚本用）"
 	},
 	{
+		readonly: false,
 		usage: "curator run|pause|resume|status|report|scope",
 		summary: "立即运行一次自动整理，或暂停／恢复／查看状态"
 	},
 	{
+		readonly: true,
 		usage: "mutations",
 		summary: "列出技能改动记录"
 	},
 	{
+		readonly: false,
 		usage: "restore",
 		summary: "从最近的快照恢复技能"
 	},
 	{
+		readonly: false,
 		usage: "consolidate <target> <sources...> [--plan <runId>]",
 		summary: "把若干技能合并进一个总括技能"
 	},
 	{
+		readonly: false,
 		usage: "skill restore <name>",
 		summary: "按名字恢复一个已归档的技能"
 	},
 	{
+		readonly: true,
 		usage: "skill history <name>",
 		summary: "列出某个技能的内容版本（含时间、动作、字符数、哈希前缀）"
 	},
 	{
+		readonly: false,
 		usage: "skill undo <name> [--to v<N>]",
 		summary: "把某个技能的内容回退到某一版（默认上一版；只动内容，撤销本身也记为一版）"
 	},
 	{
+		readonly: false,
 		usage: "skill pin <name>",
 		summary: "钉住一个技能：免于删除、后台审查与生命周期整理（立即生效、随时可解钉；与 skill_manage 的 pin 动作同一语义，不走审批）"
 	},
 	{
+		readonly: false,
 		usage: "skill unpin <name>",
 		summary: "解钉一个技能：撤销上面的冻结（立即生效、不走审批）"
 	},
 	{
+		readonly: true,
 		usage: "skills health",
 		summary: "技能库结构体检"
 	},
 	{
+		readonly: false,
 		usage: "skills refresh",
 		summary: "丢弃目录缓存并重新读取技能树"
 	},
 	{
+		readonly: false,
 		usage: "learn [request]",
 		summary: "向本会话发一条学习请求"
 	},
 	{
+		readonly: false,
 		usage: "maintain [--timeout=<ms> | --facts]",
 		summary: "起一次维护扫描并立即回 run id（后台跑；--facts 为 0 token 预览）"
 	},
 	{
+		readonly: true,
 		usage: "maintain status [<id>]",
 		summary: "看维护扫描：在飞的那次（含已跑多久）或某个 run 的终态"
 	},
 	{
+		readonly: true,
 		usage: "maintain report [<id>]",
 		summary: "读某个 run 的结果正文（省略 id 取本 home 最新一条；没有结果就明说，不装成空结果）"
 	},
 	{
+		readonly: false,
 		usage: "maintain handoff [<id>]",
 		summary: "把某次维护报告交给模型：注入指针与汇报协议，模型只汇报、等你确认后再动手"
 	},
 	{
+		readonly: false,
 		usage: "maintain cancel [<id>]",
 		summary: "停掉在飞的那次维护扫描（省略 id 仅当最新一条是本进程在跑的那次）"
 	},
 	{
+		readonly: false,
 		usage: "migrate",
 		summary: "把旧设置文档里家族的旧分区迁进现在的行（幂等；已迁移过就报「已一致」）"
 	},
 	{
+		readonly: false,
 		usage: "policy set <id> <value> [--expect <revision>]",
-		summary: "通过设置服务写入一个你可改的参数 (E3 only; E1/E2 stay in cordis.yml)"
+		summary: "通过设置服务写入一个你可改的参数 （仅 E3；E1/E2 仍留在 cordis.yml）"
 	},
 	{
+		readonly: true,
 		usage: "params [--group <name>] [--json]",
-		summary: "列出全部参数：分组、档位、生效时机、来源与当前值（--json feeds scripts)"
+		summary: "列出全部参数：分组、档位、生效时机、来源与当前值（--json 便于脚本处理）"
 	},
 	{
+		readonly: false,
 		usage: "preset install [--base <name>[,<name>...]]",
 		summary: "把自进化 Agent 预设**行**写进当前 profile 的 patch 层（`profiles/<p>/cordis.patch.yml`；bases 来自 agent 包的 bases.json）"
 	},
 	{
+		readonly: false,
 		usage: "restructure <name> \"<heading>\" <to_file> [--plan <runId>]",
 		summary: "把技能正文的一节移到 references 文件"
 	},
 	{
+		readonly: true,
 		usage: "replay",
 		summary: "比较不同会话与重启之间的计划结果（从活动记录回填）"
 	}
@@ -1474,6 +1534,137 @@ function renderHelpText() {
 	].join("\n");
 }
 //#endregion
+//#region lib/types/parse.js
+/**
+* F-4/G7.4 (C7): the ONE parser for the /evolution command surface.
+*
+* The surface used to answer each subcommand with its own regex (`^params(?: --group ([a-z-]+))?(?: --json)?$`
+* and nine siblings), so `params --json --group review` and `params --group=review` were refused as
+* "not a subcommand", while a sibling regex accepted `=` — and a mistyped group name degraded into the
+* generic error instead of the one that lists the known groups.
+*
+* This parser is order- and `=`-tolerant, matches the subcommand name case-insensitively, keeps a flag
+* VALUE's case intact (the domain layer is the one that validates it), and answers a SYNTAX failure when a
+* declared value flag is left without its value (F-3: `policy set a.b --expect 3` must not read
+* `--expect 3` as the value).
+*
+* @module @lmzhen/dsh-evolution-commands/parse
+*/
+/** The flags whose declared form takes a value (`--group <name>`, `--expect <revision>`, …). */
+/**
+* Exported so the command-table gate can tie it to the table's usage lines (P2: two declarations of
+* "which flags take a value" would otherwise be free to drift apart).
+*/
+const VALUE_FLAGS = [
+	"group",
+	"expect",
+	"base",
+	"to",
+	"timeout",
+	"plan"
+];
+/**
+* Narrow a parse result: true when it is the syntax failure rather than a command.
+* @param result - what {@link parseSubcommand} answered.
+* @returns whether the line was refused.
+*/
+function isParseFailure(result) {
+	return result.kind !== void 0;
+}
+/**
+* Split a command line into tokens: whitespace separates, and a double-quoted run is ONE token with its
+* quotes removed (the `restructure <name> "<heading>" <to_file>` form needs that; the old regexes each
+* carried their own quoting rule).
+* @param input - the text after `/evolution`.
+* @returns the tokens, in order.
+*/
+function tokenize(input) {
+	const tokens = [];
+	let current = "";
+	let quoted = false;
+	for (const char of input.trim()) {
+		if (char === String.fromCharCode(34)) {
+			quoted = !quoted;
+			continue;
+		}
+		if (!quoted && /\s/.test(char)) {
+			if (current !== "") {
+				tokens.push(current);
+				current = "";
+			}
+			continue;
+		}
+		current += char;
+	}
+	if (current !== "") tokens.push(current);
+	return tokens;
+}
+/**
+* Read one SUB-FORM line: `maintain status`, `maintain report`, … — the shape the regexes used to own.
+*
+* A sub-form matches only when: the line parses, the name matches, the first positional is the sub-form,
+* and every flag the line carries is DECLARED by the table (an undeclared flag keeps the old
+* "unknown arguments" answer instead of silently becoming a bare flag).
+* @param input - the text after `/evolution`.
+* @param name - the subcommand name the table declares (e.g. `maintain`).
+* @param sub - the sub-form word (e.g. `status`).
+* @param declaredFlags - the flags the table declares for `name` (`flagsOf(name)`).
+* @returns the parsed command, or null when this line is not that sub-form.
+*/
+function subcommandOf(input, name, sub, declaredFlags) {
+	const parsed = parseSubcommand(input);
+	if (isParseFailure(parsed) || parsed.name !== name) return null;
+	if (parsed.positionals[0] !== sub) return null;
+	for (const flag of parsed.flags.keys()) if (!declaredFlags.includes("--" + flag)) return null;
+	return parsed;
+}
+/**
+* Parse one command line into its name, flags and positionals.
+* @param input - the text after `/evolution`.
+* @returns the parsed command, or the syntax failure that refused it.
+*/
+function parseSubcommand(input) {
+	const [first, ...rest] = tokenize(input);
+	if (first === void 0) return {
+		kind: "unknown-subcommand",
+		name: ""
+	};
+	const name = first.toLowerCase();
+	const flags = /* @__PURE__ */ new Map();
+	const positionals = [];
+	for (let index = 0; index < rest.length; index += 1) {
+		const token = rest[index];
+		if (token === void 0) continue;
+		if (!token.startsWith("--")) {
+			positionals.push(token);
+			continue;
+		}
+		const equals = token.indexOf("=");
+		const flag = (equals < 0 ? token : token.slice(0, equals)).slice(2);
+		if (equals >= 0) {
+			flags.set(flag, token.slice(equals + 1));
+			continue;
+		}
+		if (!VALUE_FLAGS.includes(flag)) {
+			flags.set(flag, true);
+			continue;
+		}
+		const next = rest[index + 1];
+		if (next === void 0 || next.startsWith("--")) return {
+			kind: "missing-value",
+			name,
+			flag
+		};
+		flags.set(flag, next);
+		index += 1;
+	}
+	return {
+		name,
+		flags,
+		positionals
+	};
+}
+//#endregion
 //#region lib/types/index.js
 /**
 * Human commands for the evolution family: /evolution learn|pending|curator|restore|consolidate|skills refresh.
@@ -1508,12 +1699,12 @@ function newestRun(registry) {
 /** Sentence F, ONE wording for the three id-less forms (design `10` cell 13): an index that could
 * not be read must never answer as "there is no recent run" (G2/0.20.0). */
 function unreadableIndex(note) {
-	return `The home's run index is not readable (${note ?? "unknown reason"}) — this is NOT "there is no recent run".`;
+	return `本 home 的运行索引读不出来（${note ?? "原因未知"}）：这不等于「最近没有运行」。`;
 }
 /** The explicit-id twin of {@link unreadableIndex}, worded like `maintain status` so the four
 * readers cannot drift (review P1-1). */
 function unreadableForId(id, note) {
-	return `Run ${id} is not in this process's history, and the home's run index is not readable (${note ?? "unknown reason"}) — that is NOT proof the run never happened.`;
+	return `运行 ${id} 不在本进程的历史里，且本 home 的运行索引读不出来（${note ?? "原因未知"}）：但这不能证明那次运行没发生过。`;
 }
 /** The reader-facing report path: the `.md` digest beside the run's `.json` result. */
 function reportDigestPath(record) {
@@ -1650,7 +1841,7 @@ function apply(ctx, rawConfig = {}) {
 		const ioRegistry = ioCtx.get("evolutionIo");
 		if (!ioRegistry) return;
 		const registry = newRunRegistry({
-			io: ioRegistry.provider(),
+			io: preferProvider(ioRegistry, ["fs"]),
 			home: evolutionHome(),
 			warn: (message) => {
 				ctx.logger.warn(message);
@@ -1658,7 +1849,7 @@ function apply(ctx, rawConfig = {}) {
 		});
 		runs = registry;
 		registry.load().then((loaded) => {
-			if (!loaded.ok) ctx.logger.warn(`evolution-commands: the run index is not usable — ${loaded.note ?? "unknown reason"}`);
+			if (!loaded.ok) ctx.logger.warn(`evolution-commands: the run index is not usable — ${loaded.note ?? "原因未知"}`);
 			else if (loaded.note !== void 0) ctx.logger.warn(`evolution-commands: ${loaded.note}`);
 		}).catch((error) => {
 			ctx.logger.warn(`evolution-commands: could not read the run index (${error instanceof Error ? error.message : String(error)})`);
@@ -1691,15 +1882,15 @@ function apply(ctx, rawConfig = {}) {
 				return err(errorText("e-306-this-deployment-stages-foreground", { a1: what }));
 			};
 			const approval = ctx.get("evolutionApproval");
-			const pendingMatch = /^pending(?: --detail)?$/.exec(input);
-			if (pendingMatch) {
+			const pendingParsed = parseSubcommand(input);
+			if (!isParseFailure(pendingParsed) && pendingParsed.name === "pending") {
 				if (!approval) return err(errorText("e-301-approval-service-not-mounted"));
 				const listed = [...await approval.list("pending"), ...await approval.list("executing")];
 				const pending = [...new Map(listed.map((row) => [row.id, row])).values()];
 				const ttlMs = typeof approval.ttlMs === "number" && Number.isFinite(approval.ttlMs) ? approval.ttlMs : 0;
-				const ttlNote = ttlMs > 0 ? `\n(staged writes expire after ${ttlMs} ms: an expired write is closed as REJECTED and is never executed — stage it again if it is still wanted)` : "\n(staged writes never expire — the window waits for a decision; set the evolution-approval row pendingTtlMs to bound it)";
-				if (pending.length === 0) return ok("No pending evolution writes." + ttlNote);
-				const detailed = pendingMatch[0] === "pending --detail";
+				const ttlNote = ttlMs > 0 ? `\n（暂存写入 ${ttlMs} 毫秒后过期：过期即关闭为 REJECTED，且永不执行。若仍需要，请重新暂存。）` : "\n(staged writes never expire — the window waits for a decision; set the evolution-approval row pendingTtlMs to bound it)";
+				if (pending.length === 0) return ok("没有待批准的自进化写入。" + ttlNote);
+				const detailed = pendingParsed.flags.get("detail") === true;
 				const nowMs = Date.now();
 				const attribution = (p) => {
 					const age = elapsedSince(p.createdAt, nowMs);
@@ -1740,22 +1931,22 @@ function apply(ctx, rawConfig = {}) {
 				const curator = ctx.get("evolutionCurator");
 				if (!curator) return err(errorText("e-302-curator-service-not-mounted"));
 				const result = await curator.run({ ignoreGates: true });
-				if (result.skipped !== void 0) return ok(`Curator run skipped (${result.skipped}): no curation pass was executed.\nrunId=${result.report.runId}`);
-				return ok(`Curator run complete: ${result.stale.length} stale, ${result.archived.length} archived, ${result.errors.length} failed.\nrunId=${result.report.runId}${result.report.snapshotPath ? `\nsnapshot=${result.report.snapshotPath}` : ""}`);
+				if (result.skipped !== void 0) return ok(`策展轮已跳过（${result.skipped}）：未执行策展过程。\nrunId=${result.report.runId}`);
+				return ok(`策展轮完成：${result.stale.length} 项过期，${result.archived.length} 项已归档，${result.errors.length} 项失败。\nrunId=${result.report.runId}${result.report.snapshotPath ? `\nsnapshot=${result.report.snapshotPath}` : ""}`);
 			}
 			if (input === "curator pause" || input === "curator resume") {
 				const curator = ctx.get("evolutionCurator");
 				if (!curator) return err(errorText("e-302-curator-service-not-mounted"));
 				const paused = input === "curator pause";
 				await curator.setPaused(paused);
-				const notPersisted = ctx.get("evolutionState") !== void 0 ? "" : "\nNOTE: no evolution state service is mounted — this setting is NOT persisted and will not survive this process.";
-				return ok((paused ? "Curator automatic curation paused. Manual /evolution curator run is unaffected; resume with /evolution curator resume." : "Curator automatic curation resumed. The next scheduled pass waits one interval (first-run defer semantics).") + notPersisted);
+				const notPersisted = ctx.get("evolutionState") !== void 0 ? "" : "\n注意：没有挂载 evolution 状态服务 —— 该设置不会被持久化，也不会在此进程之后保留。";
+				return ok((paused ? "策展自动轮已暂停。手动 /evolution curator run 不受影响；用 /evolution curator resume 恢复。" : "策展自动轮已恢复。下一次定时轮要等一个间隔（首轮延后语义）。") + notPersisted);
 			}
 			if (input === "curator status") {
 				const curator = ctx.get("evolutionCurator");
 				if (!curator) return err(errorText("e-302-curator-service-not-mounted"));
 				const state = await curator.status();
-				if (!state) return ok("No curator state yet: the first automatic pass is deferred until the interval elapses.");
+				if (!state) return ok("还没有策展状态：首个自动轮次要等间隔到达后才会执行。");
 				const lastRun = typeof state.lastRunAt === "number" && Number.isFinite(state.lastRunAt) && state.lastRunAt > 0 ? new Date(state.lastRunAt).toISOString() : "unknown";
 				return ok([
 					`paused=${state.paused}`,
@@ -1769,9 +1960,9 @@ function apply(ctx, rawConfig = {}) {
 				if (!curator) return err(errorText("e-302-curator-service-not-mounted"));
 				const records = await curator.skills.listMutations();
 				const usable = Array.isArray(records) ? records.filter((row) => typeof row === "object" && row !== null && typeof row.at === "string" && typeof row.skillName === "string" && typeof row.action === "string" && typeof row.summary === "string") : [];
-				if (usable.length === 0) return ok("No mutation records yet.");
+				if (usable.length === 0) return ok("还没有写入记录。");
 				const recent = usable.slice(-5).reverse().map((record) => `${record.at.slice(0, 19)}  ${record.skillName}  ${record.action}  ${record.summary}`);
-				return ok(`Mutations: ${usable.length} recorded (recent 5):\n${recent.join("\n")}`);
+				return ok(`写入记录：已记录 ${usable.length} 条（最近 5 条）：\n${recent.join("\n")}`);
 			}
 			if (input === "curator scope") {
 				const curator = ctx.get("evolutionCurator");
@@ -1791,8 +1982,8 @@ function apply(ctx, rawConfig = {}) {
 				const curator = ctx.get("evolutionCurator");
 				if (!curator) return err(errorText("e-302-curator-service-not-mounted"));
 				const report = await curator.latestReport();
-				if (!report) return ok("No curator report available.");
-				if (typeof report !== "object" || typeof report.runId !== "string" || typeof report.startedAt !== "string" || !Array.isArray(report.archived) || !Array.isArray(report.failed)) return err("Report file unreadable.");
+				if (!report) return ok("暂无策展报告。");
+				if (typeof report !== "object" || typeof report.runId !== "string" || typeof report.startedAt !== "string" || !Array.isArray(report.archived) || !Array.isArray(report.failed)) return err("报告文件读不出来。");
 				const reportAny = report;
 				const nameOf = (item) => typeof item === "object" && item !== null && typeof item.name === "string" ? item.name : "?";
 				const reasonOf = (item) => typeof item === "object" && item !== null && typeof item.reason === "string" ? item.reason : "?";
@@ -1809,7 +2000,7 @@ function apply(ctx, rawConfig = {}) {
 			}
 			if (input === "restore" || input.startsWith("restore ")) {
 				const tail = input.slice(7).trim();
-				if (tail !== "") return err(`\`restore\` takes no arguments (got "${tail}"). Use \`restore\` for a whole-tree rollback, or \`skill restore <name>\` for one skill.`);
+				if (tail !== "") return err(`\`restore\` 不接受参数（收到 "${tail}"）。\`restore\` 做整树回滚，\`skill restore <name>\` 恢复单个技能。`);
 				const restoreRefusal = unreplayableWriteRefusal("restore");
 				if (restoreRefusal) return restoreRefusal;
 				const curator = ctx.get("evolutionCurator");
@@ -1825,7 +2016,7 @@ function apply(ctx, rawConfig = {}) {
 				const planTail = /\s--plan\s+(\S+)\s*$/.exec(input) ?? null;
 				const planRunId = planTail?.[1] ?? void 0;
 				const [target, ...sources] = (planTail ? input.slice(0, planTail.index) : input).slice(12).trim().split(/\s+/).filter(Boolean);
-				if (!target || sources.length === 0) return err("Usage: /evolution consolidate <target> <source...>");
+				if (!target || sources.length === 0) return err("用法：/evolution consolidate <target> <source...>");
 				const curator = ctx.get("evolutionCurator");
 				const result = curator ? await curator.consolidate(target, sources) : {
 					ok: false,
@@ -1836,7 +2027,7 @@ function apply(ctx, rawConfig = {}) {
 			}
 			if (input.startsWith("skill restore ")) {
 				const name = input.slice(14).trim();
-				if (!name) return err("Usage: /evolution skill restore <name>");
+				if (!name) return err("用法：/evolution skill restore <name>");
 				const skillRestoreRefusal = unreplayableWriteRefusal("skill restore");
 				if (skillRestoreRefusal) return skillRestoreRefusal;
 				const curator = ctx.get("evolutionCurator");
@@ -1848,22 +2039,22 @@ function apply(ctx, rawConfig = {}) {
 			}
 			if (input.startsWith("skill history ")) {
 				const name = input.slice(14).trim();
-				if (!name) return err("Usage: /evolution skill history <name>");
+				if (!name) return err("用法：/evolution skill history <name>");
 				const curator = ctx.get("evolutionCurator");
 				if (!curator) return err(errorText("e-302-curator-service-not-mounted"));
 				const versions = await curator.history(name);
-				if (versions.length === 0) return ok(`No content versions are recorded for "${name}" yet — they appear after the next write through skill_manage.`);
+				if (versions.length === 0) return ok(`技能 "${name}" 还没有内容版本：下一次经 skill_manage 写入后才会出现。`);
 				const groups = partitionVersions(versions);
 				const row = (entry) => `v${entry.v}\t${entry.at}\t${entry.action}\t${entry.chars} chars\t${entry.hash.slice(0, 12)}`;
-				const lines = [`Content versions for "${name}" (oldest first, ${groups.content.length} of at most the retained count):`, ...groups.content.map(row)];
-				if (groups.support.length > 0) lines.push("Support-file versions (history only — undo restores SKILL.md, not these bytes):", ...groups.support.map(row));
+				const lines = [`技能 "${name}" 的内容版本（由旧到新，${groups.content.length} 条，最多保留这么多）：`, ...groups.content.map(row)];
+				if (groups.support.length > 0) lines.push("支撑文件版本（仅在历史里 —— 撤销恢复的是 SKILL.md，不是这些字节）：", ...groups.support.map(row));
 				return ok(lines.join("\n"));
 			}
 			if (input.startsWith("skill undo ")) {
 				const rest = input.slice(11).trim();
 				const toMatch = /--to\s+v?(\d+)\s*$/.exec(rest);
 				const name = (toMatch?.index === void 0 ? rest : rest.slice(0, toMatch.index)).trim();
-				if (!name) return err("Usage: /evolution skill undo <name> [--to v<N>]");
+				if (!name) return err("用法：/evolution skill undo <name> [--to v<N>]");
 				const skillUndoRefusal = unreplayableWriteRefusal("skill undo");
 				if (skillUndoRefusal) return skillUndoRefusal;
 				const curator = ctx.get("evolutionCurator");
@@ -1877,12 +2068,12 @@ function apply(ctx, rawConfig = {}) {
 			if (input === "skill pin" || input.startsWith("skill pin ") || input === "skill unpin" || input.startsWith("skill unpin ")) {
 				const pinned = !input.startsWith("skill unpin");
 				const name = input.slice(pinned ? 10 : 12).trim();
-				if (!name) return err(`Usage: /evolution skill ${pinned ? "pin" : "unpin"} <name>`);
+				if (!name) return err(`用法：/evolution skill ${pinned ? "pin" : "unpin"} <name>`);
 				const ioRegistry = ctx.get("evolutionIo");
-				if (!ioRegistry) return err("Evolution IO registry not mounted — skill pinning unavailable.");
+				if (!ioRegistry) return err("未挂载 evolution-io 注册表：无法固定或取消固定技能。");
 				const result = await newSkillLibrary({
 					config: { root: skillsRootValue },
-					io: ioRegistry.provider(),
+					io: preferProvider(ioRegistry, ["fs"]),
 					ctx,
 					limits: {
 						...DEFAULT_SKILL_LIMITS,
@@ -1895,14 +2086,14 @@ function apply(ctx, rawConfig = {}) {
 				const curator = ctx.get("evolutionCurator");
 				if (!curator) return err(errorText("e-302-curator-service-not-mounted"));
 				const [rows, observed] = await Promise.all([curator.healthView(), curator.usageObserved()]);
-				const banner = observed ? "" : "Usage observation not yet established — churn (write-ghost) rows are suppressed.";
+				const banner = observed ? "" : "使用观测尚未建立 —— 频繁变动（写入幽灵）行已被抑制。";
 				const line = (row) => `${row.verdict.padEnd(18)} ${row.name}${row.reasons.length > 0 ? ` — ${row.reasons.join("; ")}` : ""}`;
 				if (rows.length === 0) return ok(banner ? `Structure health: all skills healthy. ${banner}` : "Structure health: all skills healthy.");
 				return ok([banner ? `Structure health (${rows.length} degraded): ${banner}` : `Structure health (${rows.length} degraded):`, ...rows.map(line)].join("\n"));
 			}
 			if (input === "skills refresh") {
 				ctx.emit("evolution/skills-refresh");
-				return ok("Skill catalog refresh requested: caches dropped, catalog re-read on next lookup.");
+				return ok("已请求重读技能目录：缓存已丢弃，下次查询时重新读取。");
 			}
 			if (input === "learn" || input.startsWith("learn ")) {
 				const request = rawInputTrimmed === "learn" ? "" : rawInputTrimmed.slice(6).trim();
@@ -1934,14 +2125,15 @@ function apply(ctx, rawConfig = {}) {
 				}).catch((error) => {
 					ctx.logger.warn(`evolution-commands: failed to record learn event: ${String(error)}`);
 				});
-				return woke ? ok("Learning request sent to this session. Follow it now.") : ok("Learning request queued for this session — this host exposes no wake-up channel, so it is read on your next message.");
+				return woke ? ok("已向本会话发送学习请求，请现在执行。") : ok("学习请求已排入本会话队列：本宿主没有唤醒通道，会在你下一条消息时读取。");
 			}
-			if (input === "maintain --facts") {
+			const factsParsed = parseSubcommand(input);
+			if (!isParseFailure(factsParsed) && factsParsed.name === "maintain" && factsParsed.flags.get("facts") === true && factsParsed.positionals.length === 0) {
 				const ioRegistry = ctx.get("evolutionIo");
-				if (!ioRegistry) return err("Evolution IO registry not mounted — maintenance facts unavailable.");
+				if (!ioRegistry) return err("未挂载 evolution-io 注册表：维护事实不可用。");
 				const library = newSkillLibrary({
 					config: { root: skillsRootValue },
-					io: ioRegistry.provider()
+					io: preferProvider(ioRegistry, ["fs"])
 				});
 				const enrichment = await buildEnrichment(ctx, library);
 				const readFailures = [];
@@ -1952,29 +2144,31 @@ function apply(ctx, rawConfig = {}) {
 						ctx.logger.warn(`evolution-maintenance: skipping unreadable skill "${name}": ${error instanceof Error ? error.message : String(error)}`);
 					}
 				});
-				if (snapshots.length === 0 && readFailures.length > 0) return err(`maintenance scan could not read ${readFailures.length} listed skill(s) (${readFailures.slice(0, 10).join(", ")}${readFailures.length > 10 ? ", …" : ""}) and read no skill at all — the library was NOT audited; fix the unreadable skills (or their directory names) and run the scan again`);
-				if (snapshots.length === 0 && skillsRootValue !== "" && !await ioRegistry.provider().exists(skillsRootValue)) return err(`maintenance scan found an empty skill library, but the configured skill root does not exist (${skillsRootValue}) — point the skillsRoot config at a real directory (a literal \`~\` is not expanded) and run the scan again`);
-				if (snapshots.length === 0) return ok("Maintenance scan: empty skill library. Nothing to do.");
+				if (snapshots.length === 0 && readFailures.length > 0) return err(`维护扫描读不出 ${readFailures.length} 个已登记技能（${readFailures.slice(0, 10).join(", ")}${readFailures.length > 10 ? ", …" : ""}），且一个技能都没读到：技能库未被审计。请修好读不出的技能（或它们的目录名）后重新扫描`);
+				if (snapshots.length === 0 && skillsRootValue !== "" && !await preferProvider(ioRegistry, ["fs"]).exists(skillsRootValue)) return err(`维护扫描发现技能库为空，但配置的技能根目录不存在（${skillsRootValue}）：请把 skillsRoot 指向真实目录（字面量 \`~\` 不会被展开），然后重新扫描`);
+				if (snapshots.length === 0) return ok("维护扫描：技能库为空，无需处理。");
 				const { facts } = buildMaintainFacts(snapshots, enrichment.usageObservedValue, void 0);
-				return ok(`Maintenance facts (0-token preview):\n${facts}`);
+				return ok(`维护事实（零 token 预览）：\n${facts}`);
 			}
-			const maintainArgs = /^maintain(?:\s+--timeout[ =](\d+))?\s*$/.exec(input);
-			if (maintainArgs) {
-				const runTimeoutMs = maintainArgs[1] ? Number(maintainArgs[1]) : config.maintainTimeoutMs ?? 6e5;
-				if (!Number.isSafeInteger(runTimeoutMs) || runTimeoutMs <= 0 || runTimeoutMs > MAX_TIMER_DELAY_MS) return err(maintainArgs[1] ? `Invalid --timeout value: expected a positive integer number of milliseconds up to ${MAX_TIMER_DELAY_MS} (e.g. /evolution maintain --timeout 600000).` : `The maintainTimeoutMs config is invalid: expected a positive integer number of milliseconds up to ${MAX_TIMER_DELAY_MS}. Fix the evolution-commands row config (maintainTimeoutMs), then retry.`);
+			const maintainParsed = parseSubcommand(input);
+			const maintainFlagsDeclared = [...isParseFailure(maintainParsed) ? [] : maintainParsed.flags.keys()].every((flag) => flagsOf("maintain").includes("--" + flag));
+			if (!isParseFailure(maintainParsed) && maintainParsed.name === "maintain" && maintainParsed.positionals.length === 0 && maintainFlagsDeclared) {
+				const timeoutFlag = maintainParsed.flags.get("timeout");
+				const runTimeoutMs = typeof timeoutFlag === "string" ? Number(timeoutFlag) : config.maintainTimeoutMs ?? 6e5;
+				if (!Number.isSafeInteger(runTimeoutMs) || runTimeoutMs <= 0 || runTimeoutMs > MAX_TIMER_DELAY_MS) return err(timeoutFlag !== void 0 ? `--timeout 值不合法：应为不超过 ${MAX_TIMER_DELAY_MS} 的正整数毫秒（例如 /evolution maintain --timeout 600000）。` : `maintainTimeoutMs 配置不合法：应为不超过 ${MAX_TIMER_DELAY_MS} 的正整数毫秒。请修正 evolution-commands 行的配置（maintainTimeoutMs）后重试。`);
 				const registry = runs;
-				if (!registry) return err("Evolution IO registry not mounted — maintenance scan unavailable.");
+				if (!registry) return err("未挂载 evolution-io 注册表：维护扫描不可用。");
 				const synced = await syncRuns(registry);
 				if (!synced.ok) ctx.logger.warn(`evolution-commands: ${synced.note ?? "run index unreadable"} — the in-flight guard cannot see other processes' runs`);
 				else if (synced.note !== void 0) ctx.logger.warn(`evolution-commands: ${synced.note}`);
 				const ioRegistry = ctx.get("evolutionIo");
 				const subagents = ctx.get("subagents");
-				if (!ioRegistry) return err("Evolution IO registry not mounted — maintenance scan unavailable.");
-				if (!subagents) return err("Subagents service not mounted — maintenance scan unavailable.");
+				if (!ioRegistry) return err("未挂载 evolution-io 注册表：维护扫描不可用。");
+				if (!subagents) return err("未挂载子智能体服务：维护扫描不可用。");
 				const running = registry.inFlight();
 				if (running) {
 					const elapsed = Math.max(1, Math.round((Date.now() - running.startedAt) / 1e3));
-					return err(`Maintenance run ${running.id} is already running (started ~${elapsed}s ago) — re-submitting now would start a second scan. Status: /evolution maintain status ${running.id}; stop it: /evolution maintain cancel ${running.id}.`);
+					return err(`维护运行 ${running.id} 已经在进行中（约 ${elapsed}s 前启动）：现在重交会再开一次扫描。查看状态：/evolution maintain status ${running.id}；停止它：/evolution maintain cancel ${running.id}。`);
 				}
 				const cooldownMs = clampedNumber(config.maintainCooldownMs, 3e4, { min: 0 });
 				const lastSettled = registry.lastSettledAt();
@@ -1982,7 +2176,7 @@ function apply(ctx, rawConfig = {}) {
 				if (cooldownMs > 0 && sinceLast < cooldownMs) {
 					const remaining = Math.ceil((cooldownMs - sinceLast) / 1e3);
 					const latest = registry.runs().find((record) => record.state !== "running");
-					return err(`Maintenance cooldown active (${remaining}s)${latest === void 0 ? "" : ` — latest run ${latest.id}`}; re-running now would spend another model call.`);
+					return err(`维护冷却中（${remaining}s）${latest === void 0 ? "" : `，最近一次运行 ${latest.id}`}：现在重跑会再消耗一次模型调用。`);
 				}
 				const runHome = evolutionHome();
 				const runRoot = evolutionRoot();
@@ -1992,7 +2186,7 @@ function apply(ctx, rawConfig = {}) {
 					try {
 						const library = newSkillLibrary({
 							config: { root: skillsRootValue },
-							io: ioRegistry.provider()
+							io: preferProvider(ioRegistry, ["fs"])
 						});
 						const enrichment = await buildEnrichment(ctx, library);
 						const outcome = await runMaintain({
@@ -2004,7 +2198,7 @@ function apply(ctx, rawConfig = {}) {
 							logger: { warn: (message) => {
 								ctx.logger.warn(message);
 							} },
-							rootExists: skillsRootValue === "" ? void 0 : () => ioRegistry.provider().exists(skillsRootValue),
+							rootExists: skillsRootValue === "" ? void 0 : () => preferProvider(ioRegistry, ["fs"]).exists(skillsRootValue),
 							skillRoot: skillsRootValue
 						}, {
 							timeoutMs: runTimeoutMs,
@@ -2013,7 +2207,7 @@ function apply(ctx, rawConfig = {}) {
 							enrichment: () => enrichment
 						});
 						const endedAt = Date.now();
-						const resultRef = await writeMaintainReport(ioRegistry.provider(), {
+						const resultRef = await writeMaintainReport(preferProvider(ioRegistry, ["fs"]), {
 							runId: handle.id,
 							...outcome.ok ? {
 								verdict: outcome.verdict,
@@ -2037,7 +2231,7 @@ function apply(ctx, rawConfig = {}) {
 							...outcome.ok ? {} : { failure: handle.signal.aborted ? "cancelled: the scan was stopped before it settled" : outcome.error ?? "Maintenance scan failed." }
 						});
 						if (outcome.ok) {
-							appendEvolutionEvent(ioRegistry.provider(), eventsFile(runRoot), {
+							appendEvolutionEvent(preferProvider(ioRegistry, ["fs"]), eventsFile(runRoot), {
 								type: "maintain",
 								source: "manual",
 								runId: handle.id,
@@ -2073,7 +2267,7 @@ function apply(ctx, rawConfig = {}) {
 							} catch (error) {
 								ctx.logger.warn(`evolution-commands: automatic report handoff failed (${String(error)})`);
 							}
-						} else ctx.logger.warn(`evolution-commands: maintenance run ${handle.id} produced no plan (${outcome.error ?? "unknown reason"})`);
+						} else ctx.logger.warn(`evolution-commands: maintenance run ${handle.id} produced no plan (${outcome.error ?? "原因未知"})`);
 					} catch (error) {
 						const aborted = handle.signal.aborted;
 						const failure = aborted ? "cancelled: the scan was stopped before it settled" : `Maintenance scan failed: ${error instanceof Error ? error.message : String(error)}`;
@@ -2091,93 +2285,93 @@ function apply(ctx, rawConfig = {}) {
 					`- stop:   /evolution maintain cancel ${handle.id}`
 				].join("\n"));
 			}
-			const maintainStatus = /^maintain\s+status(?:\s+(\S+))?\s*$/.exec(input);
-			if (maintainStatus) {
+			const maintainStatus = subcommandOf(input, "maintain", "status", flagsOf("maintain"));
+			if (maintainStatus !== null) {
 				const registry = runs;
-				if (!registry) return err("Evolution IO registry not mounted — run status unavailable.");
+				if (!registry) return err("未挂载 evolution-io 注册表：无法查看运行状态。");
 				const synced = await syncRuns(registry);
-				const wanted = maintainStatus[1];
+				const wanted = maintainStatus.positionals[1];
 				if (wanted !== void 0) {
 					const record = registry.find(wanted);
 					if (!record) {
-						if (!synced.ok) return err(`Run ${wanted} is not in this process's history, and the home's run index is not readable (${synced.note ?? "unknown reason"}) — that is NOT proof the run never happened.`);
-						return err(`No run ${wanted} in this home — /evolution maintain status lists the recent ones.`);
+						if (!synced.ok) return err(`运行 ${wanted} 不在本进程的历史里，且本 home 的运行索引读不出来（${synced.note ?? "原因未知"}）：但这不能证明那次运行没发生过。`);
+						return err(`本 home 里没有 ${wanted} 这次运行：用 /evolution maintain status 查看最近的几次。`);
 					}
-					return ok(synced.ok ? renderRunRecord(record) : `${renderRunRecord(record)}\n(index not readable: ${synced.note ?? "unknown reason"} — only this process's view is shown)`);
+					return ok(synced.ok ? renderRunRecord(record) : `${renderRunRecord(record)}\n(运行索引读不出来：${synced.note ?? "原因未知"} — only this process's view is shown)`);
 				}
-				if (!synced.ok) return err(`The run history of this home is not readable (${synced.note ?? "unknown reason"}) — this is NOT "no runs". Fix or remove <evolutionHome>/runs.json to start a clean history.`);
+				if (!synced.ok) return err(`本 home 的运行历史读不出来（${synced.note ?? "原因未知"}）：这「不是」没有运行。要开始干净的历史，请修好或删除 <evolutionHome>/runs.json。`);
 				const all = registry.runs();
-				if (all.length === 0) return ok("No maintenance run recorded in this home yet — /evolution maintain starts one.");
+				if (all.length === 0) return ok("本 home 还没有维护运行记录：用 /evolution maintain 启动一次。");
 				const live = all.filter((record) => record.state === "running");
 				const recent = all.filter((record) => record.state !== "running").slice(0, 5);
 				return ok([live.length === 0 ? "No maintenance run in flight." : `In flight:\n${live.map(renderRunRecord).join("\n")}`, recent.length === 0 ? "" : `Recent:\n${recent.map(renderRunRecord).join("\n")}`].filter((part) => part !== "").join("\n"));
 			}
-			const maintainReport = /^maintain\s+report(?:\s+(\S+))?\s*$/.exec(input);
-			if (maintainReport) {
+			const maintainReport = subcommandOf(input, "maintain", "report", flagsOf("maintain"));
+			if (maintainReport !== null) {
 				const registry = runs;
-				if (!registry) return err("Evolution IO registry not mounted — run results unavailable.");
+				if (!registry) return err("未挂载 evolution-io 注册表：无法查看运行结果。");
 				const synced = await syncRuns(registry);
-				const wanted = maintainReport[1];
+				const wanted = maintainReport.positionals[1];
 				if (wanted === void 0 && !synced.ok) return err(unreadableIndex(synced.note));
 				const record = wanted === void 0 ? newestRun(registry) : registry.find(wanted);
 				if (!record) {
 					if (wanted !== void 0) {
 						if (!synced.ok) return err(unreadableForId(wanted, synced.note));
-						return err(`No run ${wanted} in this home — /evolution maintain status lists the recent ones.`);
+						return err(`本 home 里没有 ${wanted} 这次运行：用 /evolution maintain status 查看最近的几次。`);
 					}
-					return err("No maintenance run recorded in this home yet — /evolution maintain starts one.");
+					return err("本 home 还没有维护运行记录：用 /evolution maintain 启动一次。");
 				}
-				if (wanted === void 0 && record.state === "running") return err(`The newest run ${record.id} is still running — its report appears when it settles; /evolution maintain status ${record.id} shows where it is.`);
+				if (wanted === void 0 && record.state === "running") return err(`最新一次运行 ${record.id} 仍在进行：它结束后才会出报告；用 /evolution maintain status ${record.id} 查看进度。`);
 				const ioRegistry = ctx.get("evolutionIo");
-				if (!ioRegistry) return err("Evolution IO registry not mounted — run results unavailable.");
-				const probed = await readRunReport(ioRegistry.provider(), record);
-				if (probed.kind === "missing") return err(`Run ${record.id} (${record.state}) has NO result: no report was written${record.failure === void 0 ? "" : ` (${record.failure})`}.`);
-				if (probed.kind === "unknown") return err(`Run ${record.id} has a report that could not be read (${probed.reason}) — this is not "no result".`);
+				if (!ioRegistry) return err("未挂载 evolution-io 注册表：无法查看运行结果。");
+				const probed = await readRunReport(preferProvider(ioRegistry, ["fs"]), record);
+				if (probed.kind === "missing") return err(`运行 ${record.id}（${record.state}）没有结果：没有写出报告${record.failure === void 0 ? "" : `（${record.failure}）`}。`);
+				if (probed.kind === "unknown") return err(`运行 ${record.id} 有报告但读不出来（${probed.reason}）：这「不是」没有结果。`);
 				return ok(probed.text);
 			}
-			const maintainCancel = /^maintain\s+cancel(?:\s+(\S+))?\s*$/.exec(input);
-			if (maintainCancel) {
+			const maintainCancel = subcommandOf(input, "maintain", "cancel", flagsOf("maintain"));
+			if (maintainCancel !== null) {
 				const registry = runs;
-				if (!registry) return err("Evolution IO registry not mounted — run cancellation unavailable.");
+				if (!registry) return err("未挂载 evolution-io 注册表：无法取消运行。");
 				const synced = await syncRuns(registry);
-				const wanted = maintainCancel[1];
+				const wanted = maintainCancel.positionals[1];
 				if (wanted === void 0 && !synced.ok) return err(unreadableIndex(synced.note));
 				const record = wanted === void 0 ? newestRun(registry) : registry.find(wanted);
 				if (!record) {
 					if (wanted !== void 0) {
 						if (!synced.ok) return err(unreadableForId(wanted, synced.note));
-						return err(`No run ${wanted} in this home — /evolution maintain status lists the recent ones.`);
+						return err(`本 home 里没有 ${wanted} 这次运行：用 /evolution maintain status 查看最近的几次。`);
 					}
-					return err("No maintenance run recorded in this home yet — /evolution maintain starts one.");
+					return err("本 home 还没有维护运行记录：用 /evolution maintain 启动一次。");
 				}
-				const idlessHint = wanted === void 0 ? " Pass an id to cancel a specific run: /evolution maintain status lists them." : "";
+				const idlessHint = wanted === void 0 ? " 要取消某次运行请带上 id：/evolution maintain status 会列出它们。" : "";
 				if (!registry.cancel(record.id)) {
-					if (record.state === "running") return err(`Run ${record.id} is running in ANOTHER process sharing this home — it can only be cancelled there.`);
-					return err(`Run ${record.id} is already ${record.state} — nothing to cancel.${idlessHint}`);
+					if (record.state === "running") return err(`运行 ${record.id} 正在共享本 home 的另一个进程里运行：只能在那里取消。`);
+					return err(`运行 ${record.id} 已经是 ${record.state}：没有可取消的东西。${idlessHint}`);
 				}
-				return ok(`Maintenance run ${record.id} cancelled — the scan stops at its next checkpoint. /evolution maintain status ${record.id} shows the terminal state.`);
+				return ok(`维护运行 ${record.id} 已取消：扫描会在下一个检查点停止。用 /evolution maintain status ${record.id} 查看终态。`);
 			}
-			const maintainHandoff = /^maintain\s+handoff(?:\s+(\S+))?\s*$/.exec(input);
-			if (maintainHandoff) {
+			const maintainHandoff = subcommandOf(input, "maintain", "handoff", flagsOf("maintain"));
+			if (maintainHandoff !== null) {
 				const registry = runs;
-				if (!registry) return err("Evolution IO registry not mounted — the report cannot be handed over.");
+				if (!registry) return err("未挂载 evolution-io 注册表：无法交付报告。");
 				const synced = await syncRuns(registry);
-				const wanted = maintainHandoff[1];
+				const wanted = maintainHandoff.positionals[1];
 				if (wanted === void 0 && !synced.ok) return err(unreadableIndex(synced.note));
 				const record = wanted === void 0 ? newestRun(registry) : registry.find(wanted);
 				if (!record) {
 					if (wanted !== void 0) {
 						if (!synced.ok) return err(unreadableForId(wanted, synced.note));
-						return err(`No run ${wanted} in this home — /evolution maintain status lists the recent ones.`);
+						return err(`本 home 里没有 ${wanted} 这次运行：用 /evolution maintain status 查看最近的几次。`);
 					}
-					return err("No maintenance run recorded in this home yet — /evolution maintain starts one.");
+					return err("本 home 还没有维护运行记录：用 /evolution maintain 启动一次。");
 				}
-				if (wanted === void 0 && record.state === "running") return err(`The newest run ${record.id} is still running — its report appears when it settles; /evolution maintain status ${record.id} shows where it is.`);
+				if (wanted === void 0 && record.state === "running") return err(`最新一次运行 ${record.id} 仍在进行：它结束后才会出报告；用 /evolution maintain status ${record.id} 查看进度。`);
 				const ioRegistry = ctx.get("evolutionIo");
-				if (!ioRegistry) return err("Evolution IO registry not mounted — the report cannot be handed over.");
-				const probed = await readRunReport(ioRegistry.provider(), record);
-				if (probed.kind === "missing") return err(`Run ${record.id} (${record.state}) has NO result: no report was written${record.failure === void 0 ? "" : ` (${record.failure})`}.`);
-				if (probed.kind === "unknown") return err(`Run ${record.id} has a report that could not be read (${probed.reason}) — this is not "no result".`);
+				if (!ioRegistry) return err("未挂载 evolution-io 注册表：无法交付报告。");
+				const probed = await readRunReport(preferProvider(ioRegistry, ["fs"]), record);
+				if (probed.kind === "missing") return err(`运行 ${record.id}（${record.state}）没有结果：没有写出报告${record.failure === void 0 ? "" : `（${record.failure}）`}。`);
+				if (probed.kind === "unknown") return err(`运行 ${record.id} 有报告但读不出来（${probed.reason}）：这「不是」没有结果。`);
 				const missingAgent = agentMissing("handoff");
 				if (missingAgent) return missingAgent;
 				const woke = deliverHandoff(invocationAgent, createUserMessage({
@@ -2198,12 +2392,12 @@ function apply(ctx, rawConfig = {}) {
 					}
 				}));
 				if (woke === void 0) return err(errorText("e-305-the-invocation-agent-exposes", { a1: "this maintenance handoff" }));
-				return ok(woke ? `Handed run ${record.id} to the model — report: ${reportDigestPath(record)}. It will read the file and follow the action lines.` : `Handed run ${record.id} to the model, queued — this host exposes no wake-up channel, so it is read on your next message.`);
+				return ok(woke ? `已把运行 ${record.id} 交给模型 —— 报告：${reportDigestPath(record)}。它会读取该文件并执行其中的行动项。` : `已把运行 ${record.id} 交给模型并排队 —— 本宿主没有唤醒通道，因此会在你下一条消息时被读取。`);
 			}
-			if (/^maintain\b/.test(input)) return err("Unknown maintain arguments: expected `maintain`, `maintain --timeout <ms>` / `maintain --timeout=<ms>`, `maintain status [<id>]`, `maintain report [<id>]`, `maintain handoff [<id>]` or `maintain cancel [<id>]`. Got: " + input);
-			const presetInstall = /^preset install(?: --base (\S+))?$/.exec(input);
-			if (presetInstall !== null || /^preset\b/.test(input)) {
-				if (presetInstall === null) return err("Unknown preset arguments: expected `preset install` or `preset install --base <name>[,<name>...]` (the names live in the agent package's bases.json). Got: " + input);
+			if (/^maintain\b/.test(input)) return err("未知的 maintain 参数：应为 `maintain`、`maintain --timeout <ms>` / `maintain --timeout=<ms>`、`maintain status [<id>]`、`maintain report [<id>]`、`maintain handoff [<id>]` 或 `maintain cancel [<id>]`。实际收到：" + input);
+			const presetParsed = parseSubcommand(input);
+			const presetInstall = isParseFailure(presetParsed) || presetParsed.name !== "preset" ? null : presetParsed.positionals[0] === "install" && presetParsed.positionals.length === 1 && [...presetParsed.flags.keys()].every((flag) => flagsOf("preset").includes("--" + flag)) ? presetParsed : false;
+			if (presetInstall !== null && presetInstall !== false) {
 				{
 					const mounted = presetProfileTarget(ctx);
 					const exclusion = installExclusionTarget(mounted === void 0 ? void 0 : {
@@ -2211,77 +2405,84 @@ function apply(ctx, rawConfig = {}) {
 						dir: mounted.profileDir,
 						bundles: mounted.bundles
 					});
-					if (exclusion.kind === "undecidable") return err(`Refusing to install the layered Evolution preset: ${exclusion.reason} — the all/preset double-mount check could not run. Resolve access to this profile and retry, or install via the layered installer, which enforces the same exclusion up front.`);
+					if (exclusion.kind === "undecidable") return err(`拒绝安装分层 Evolution 预设：${exclusion.reason}：all/preset 双重挂载检查无法执行。请解决该 profile 的访问权限后重试，或改用分层安装器——它会在安装前就执行同一套排除检查。`);
 					const installedBundles = exclusion.bundles;
 					const allBundle = installedBundles.find((name) => name === "dsh-evolution-all" || name.endsWith("/dsh-evolution-all"));
 					const presetBundle = installedBundles.find((name) => name === "dsh-evolution-preset" || name.endsWith("/dsh-evolution-preset"));
-					if (allBundle || presetBundle) return err(`Refusing to install the layered Evolution preset: "${allBundle ?? presetBundle}" is installed in this profile — its model rows (tool-memory / tool-skill-manage / tool-session-query / skill-catalog) would double-mount with the preset's and the profile fails loud at startup. Keep ONE: remove the ${allBundle ? "evolution-all bundle" : "evolution-preset bundle"} before installing the layered preset (see /evolution doctor).`);
+					if (allBundle || presetBundle) return err(`拒绝安装分层 Evolution 预设：本 profile 里已安装「${allBundle ?? presetBundle}」：它的模型行（tool-memory / tool-skill-manage / tool-session-query / skill-catalog）会与预设的重复挂载，profile 启动时会直接报错。只保留一个：安装分层预设前先移除 ${allBundle ? "evolution-all bundle" : "evolution-preset bundle"}（见 /evolution doctor）。`);
 				}
 				try {
 					const source = resolveAgentPresetDir(import.meta.url);
 					const table = readAgentPresetBases(source);
-					const requestedRaw = presetInstall[1] ?? table.defaultBase;
+					const baseFlag = presetInstall.flags.get("base");
+					const requestedRaw = typeof baseFlag === "string" ? baseFlag : table.defaultBase;
 					const requested = [...new Set(requestedRaw.split(",").map((part) => part.trim()).filter((part) => part !== ""))];
-					if (requested.length === 0) return err(`No agent-preset base named — ${join(source, "bases.json")} lists ${table.entries.map((entry) => entry.name).join(", ")}`);
+					if (requested.length === 0) return err(`没有指定 agent-preset 基名：${join(source, "bases.json")} 里列出的是 ${table.entries.map((entry) => entry.name).join(", ")}`);
 					const selected = [];
 					for (const name of requested) {
 						const entry = table.entries.find((candidate) => candidate.name === name);
-						if (entry === void 0) return err(`Unknown agent-preset base "${name}" — ${join(source, "bases.json")} lists ${table.entries.map((candidate) => candidate.name).join(", ")}`);
+						if (entry === void 0) return err(`未知的 agent-preset 基名「${name}」：${join(source, "bases.json")} 里列出的是 ${table.entries.map((candidate) => candidate.name).join(", ")}`);
 						selected.push(entry);
 					}
 					const deltaPath = join(source, "agent.cordis.yml");
-					if (!existsSync(deltaPath)) return err(`Preset file missing from ${source} — is the dsh-evolution-agent-preset package installed?`);
+					if (!existsSync(deltaPath)) return err(`预设文件在 ${source} 里缺失：是否装了 dsh-evolution-agent-preset 包？`);
 					const profile = presetProfileTarget(ctx);
-					if (profile === void 0) return err("No profile is mounted in this process, so there is no profile patch to write the preset row into — run the command in a session started by `dsh --profile <name>`.");
+					if (profile === void 0) return err("本进程没有挂载任何 profile，因此没有可写入预设行的 profile 补丁：请在由 `dsh --profile <name>` 启动的会话里执行该命令。");
 					const delta = readFileSync(deltaPath, "utf8");
-					const current = existsSync(profile.patchPath) ? readFileSync(profile.patchPath, "utf8") : "";
-					let merged = current;
-					const written = [];
-					for (const base of selected) {
-						const refusal = baseRefusalReason(base, (name) => ctx.get(name) !== void 0);
-						if (refusal !== void 0) return err(refusal);
-						const basePatch = resolvePresetBasePatch(base.name, profile);
-						const rowId = presetRowId(base.id);
-						const entryText = composePresetEntry(readFileSync(basePatch, "utf8"), delta, {
-							rowId,
-							id: base.id,
-							name: base.display.name,
-							description: base.display.description,
-							order: base.display.order
+					const hmr = ctx.get("hmr");
+					const commit = () => {
+						const current = existsSync(profile.patchPath) ? readFileSync(profile.patchPath, "utf8") : "";
+						let merged = current;
+						const written = [];
+						for (const base of selected) {
+							const refusal = baseRefusalReason(base, (name) => ctx.get(name) !== void 0);
+							if (refusal !== void 0) return err(refusal);
+							const basePatch = resolvePresetBasePatch(base.name, profile);
+							const rowId = presetRowId(base.id);
+							const entryText = composePresetEntry(readFileSync(basePatch, "utf8"), delta, {
+								rowId,
+								id: base.id,
+								name: base.display.name,
+								description: base.display.description,
+								order: base.display.order
+							});
+							const next = mergePresetRow(merged, entryText, rowId);
+							written.push(next === merged ? `${base.name} → ${profile.patchPath} (already current)` : `${base.name} → ${rowId} in ${profile.patchPath}`);
+							merged = next;
+						}
+						if (merged !== current) atomicWriteFiles(dirname(profile.patchPath), [{
+							name: PROFILE_PATCH_FILENAME$1,
+							content: presetPatchText(merged)
+						}], void 0, (message) => {
+							ctx.logger.warn(message);
 						});
-						const next = mergePresetRow(merged, entryText, rowId);
-						written.push(next === merged ? `${base.name} → ${profile.patchPath} (already current)` : `${base.name} → ${rowId} in ${profile.patchPath}`);
-						merged = next;
-					}
-					if (merged !== current) atomicWriteFiles(dirname(profile.patchPath), [{
-						name: PROFILE_PATCH_FILENAME$1,
-						content: presetPatchText(merged)
-					}], void 0, (message) => {
-						ctx.logger.warn(message);
-					});
-					return ok(`Evolution agent preset row installed (${written.join("; ")}). Restart the session switcher to select it.`);
+						return ok(`已写入 evolution agent preset 行（${written.join("; ")}）。重启会话切换器后即可选中它。`);
+					};
+					const runExclusive = hmr?.runExclusive;
+					if (runExclusive === void 0) return commit();
+					return await runExclusive.call(hmr, commit);
 				} catch (error) {
-					return err(`Preset install failed: ${error instanceof Error ? error.message : String(error)}`);
+					return err(`预设安装失败：${error instanceof Error ? error.message : String(error)}`);
 				}
 			}
 			if (input.startsWith("restructure ")) {
-				const planTail = /\s--plan\s+(\S+)\s*$/.exec(rawInputTrimmed) ?? null;
-				const planRunId = planTail?.[1] ?? void 0;
-				const rest = planTail ? rawInputTrimmed.slice(0, planTail.index) : rawInputTrimmed;
-				const match = /^restructure\s+(\S+)\s+"([^"]+)"\s+(\S+)$/.exec(rest);
-				if (!match) return err("Usage: /evolution restructure <name> \"<## heading>\" <to_file>");
-				const name = match[1] ?? "";
-				const heading = match[2] ?? "";
-				const toFile = match[3] ?? "";
-				if (!toFile.startsWith("references/")) return err("to_file must live under references/ (log/detail destination).");
+				const restParsed = parseSubcommand(rawInputTrimmed);
+				if (isParseFailure(restParsed) || restParsed.name !== "restructure") return err("用法：/evolution restructure <name> \"<## heading>\" <to_file>");
+				const name = restParsed.positionals[0] ?? "";
+				const heading = restParsed.positionals[1] ?? "";
+				const toFile = restParsed.positionals[2] ?? "";
+				if (name === "" || heading === "" || toFile === "") return err("用法：/evolution restructure <name> \"<## heading>\" <to_file>");
+				const planFlag = restParsed.flags.get("plan");
+				const planRunId = typeof planFlag === "string" ? planFlag : void 0;
+				if (!toFile.startsWith("references/")) return err("to_file 必须位于 references/ 之下（日志或明细的落地位置）。");
 				const ioRegistry = ctx.get("evolutionIo");
-				if (!ioRegistry) return err("Evolution IO registry not mounted — restructure unavailable.");
+				if (!ioRegistry) return err("未挂载 evolution-io 注册表：无法重构。");
 				if (approval) {
 					const session = invocationAgent?.session;
 					const sessionPolicy = effectiveSessionPolicy(ctx, session);
 					const stagesForeground = approval.isEnabled !== false && sessionPolicy !== "never" && approval.stageForeground !== false;
 					if (stagesForeground && session === void 0) return err(errorText("e-306-this-deployment-stages-foreground-2"));
-					if (stagesForeground && !approval.hasRunner("skill")) return err("Restructure cannot be staged: no skill replay runner is registered — mount the tool-skill-manage row (evolution-agent preset, or evolution-all) or disable evolution-approval.");
+					if (stagesForeground && !approval.hasRunner("skill")) return err("无法暂存重构：没有注册技能回放运行器：请挂载 tool-skill-manage 行（evolution-agent 预设或 evolution-all），或禁用 evolution-approval。");
 					const decision = await approval.request({
 						kind: "skill",
 						summary: `/evolution restructure ${name}${planRunId ? ` (plan ${planRunId})` : ""}`,
@@ -2308,7 +2509,7 @@ function apply(ctx, rawConfig = {}) {
 				}
 				const result = await newSkillLibrary({
 					config: { root: skillsRootValue },
-					io: ioRegistry.provider(),
+					io: preferProvider(ioRegistry, ["fs"]),
 					ctx,
 					threatExemptLabels: config.threatExemptLabels,
 					limits: {
@@ -2328,8 +2529,8 @@ function apply(ctx, rawConfig = {}) {
 				if (!replay) return err(errorText("e-303-replay-service-not-mounted"));
 				return ok(replay.compare().report);
 			}
-			const paramsMatch = /^params(?: --group ([a-z-]+))?(?: --json)?$/.exec(input);
-			if (paramsMatch) {
+			const paramsParsed = parseSubcommand(input);
+			if (!isParseFailure(paramsParsed) && paramsParsed.name === "params") {
 				const provider = ctx.get("settings");
 				const sections = /* @__PURE__ */ new Map();
 				if (provider?.describe !== void 0) try {
@@ -2344,21 +2545,23 @@ function apply(ctx, rawConfig = {}) {
 					return err(errorText("e-307-the-settings-service-could", { a1: error instanceof Error ? error.message : String(error) }));
 				}
 				const rows = paramSurfaceRows(sections, PARAM_EXPOSURE);
-				const group = paramsMatch[1];
+				const groupFlag = paramsParsed.flags.get("group");
+				const group = typeof groupFlag === "string" ? groupFlag : void 0;
 				const selected = group === void 0 ? rows : rows.filter((row) => row.group === group);
 				if (group !== void 0 && selected.length === 0) return err(errorText("e-308-unknown-parameter-group-group", {
 					a1: group,
 					a2: paramGroups(PARAM_EXPOSURE).join(", ")
 				}));
-				if (input.endsWith("--json")) return ok(renderParamJson(selected));
+				if (paramsParsed.flags.get("json") === true) return ok(renderParamJson(selected));
 				return ok(renderParamRows(selected, { providerMounted: provider !== void 0 }));
 			}
-			const policySetMatch = /^policy set ([A-Za-z][A-Za-z0-9.-]*) (.+?)(?: --expect (\d+))?$/.exec(input);
-			if (policySetMatch) {
+			const policyParsed = parseSubcommand(input);
+			if (isParseFailure(policyParsed) && policyParsed.name === "policy" && policyParsed.kind === "missing-value") return err("/evolution policy set 需要在 --" + (policyParsed.flag ?? "") + "；用法：policy set <id> <value> [--expect <revision>]");
+			if (!isParseFailure(policyParsed) && policyParsed.name === "policy" && policyParsed.positionals[0] === "set") {
 				const provider = ctx.get("settings");
 				if (provider?.update === void 0 || provider.describe === void 0) return err(errorText("e-311-no-settings-service-is"));
-				const rawId = policySetMatch[1] ?? "";
-				const rawValue = policySetMatch[2] ?? "";
+				const rawId = policyParsed.positionals[1] ?? "";
+				const rawValue = policyParsed.positionals[2] ?? "";
 				let id;
 				try {
 					id = canonicalWriteId(rawId);
@@ -2389,13 +2592,24 @@ function apply(ctx, rawConfig = {}) {
 				}));
 				const current = descriptor.value;
 				const resolved = typeof current === "object" && current !== null ? current : void 0;
-				const expectedRaw = policySetMatch[3];
+				const expectFlag = policyParsed.flags.get("expect");
+				const expectedRaw = typeof expectFlag === "string" ? expectFlag : void 0;
 				const expected = expectedRaw === void 0 ? descriptor.revision : Number(expectedRaw);
 				if (expectedRaw !== void 0 && descriptor.revision !== void 0 && Number(expectedRaw) !== descriptor.revision) return err(errorText("e-309-revision-conflict-you-sent", {
 					a1: expectedRaw,
 					a2: descriptor.revision
 				}));
 				const value = parseParamValue(rawValue);
+				const floorId = entry.relation?.atLeast;
+				if (floorId !== void 0 && typeof value === "number") {
+					const sibling = resolved?.[floorId];
+					const floor = typeof sibling === "number" ? sibling : NaN;
+					if (Number.isFinite(floor) && value < floor) return err(errorText("e-322-a-parameter-would-break-a", {
+						a1: id,
+						a2: String(floor),
+						a3: String(value)
+					}));
+				}
 				try {
 					await provider.update(namespace, { [id]: value }, expected);
 				} catch (error) {
@@ -2437,17 +2651,16 @@ function apply(ctx, rawConfig = {}) {
 				return ok(renderDoctorText(report));
 			}
 			if (input === "" || input === "help") return ok(`自进化：记忆、技能、会话回顾、技能整理——状态、待批准写入与维护。\n${renderHelpText()}`);
-			return err(`/evolution ${input} is not a subcommand this build answers (a known subcommand whose argument is missing lands here too).\n${renderHint()}`);
+			return err(`/evolution ${input} 不是本构建能应答的子命令（已知子命令但缺参数也会落到这里）。\n${renderHint()}`);
 		} };
 		/** The registered definition: declared members only (A46). */
 		const evolutionCommand = {
 			name: "evolution",
 			description: "自进化：状态与待批准写入",
-			recordInput: false,
 			input: { hint: renderHint() },
 			handler: (invocation) => commandBody.run(invocation).catch((error) => ({
 				kind: "error",
-				text: `evolution: command failed: ${error instanceof Error ? error.message : String(error)}\nRun /evolution doctor to inspect services and state files; a corrupted state file is quarantined as <file>.corrupt for inspection.`
+				text: `evolution：命令失败：${error instanceof Error ? error.message : String(error)}\n请运行 /evolution doctor 检查服务与状态文件；损坏的状态文件会被隔离为 <file> 以便检查。`
 			}))
 		};
 		commandCtx.effect(() => commands.register(evolutionCommand));
@@ -2558,121 +2771,6 @@ function resolveAgentPresetDir(importMetaUrl) {
 		return overlayCandidate;
 	}
 }
-const defaultFs = {
-	writeFileSync: (path, data) => {
-		writeFileSync(path, data);
-	},
-	existsSync: (path) => existsSync(path),
-	copyFileSync: (from, to) => {
-		copyFileSync(from, to);
-	},
-	renameSync: (from, to) => {
-		renameSync(from, to);
-	},
-	rmSync: (path, options) => {
-		rmSync(path, options);
-	},
-	mtime: (path) => {
-		try {
-			return statSync(path).mtimeMs;
-		} catch (error) {
-			if (isMissingPath(error)) return null;
-			throw error;
-		}
-	}
-};
-/**
-* S6.3 (E-40): atomically replace a set of files within one directory.
-* Each file is staged to a sibling `<name>.tmp`, then renamed into place
-* (atomic on the same filesystem); a pre-existing file keeps a single
-* `<name>.bak`. A failure at ANY staging step removes the staged temps and
-* leaves the previous files untouched — a half-written target is impossible
-* up to the staging and backup phases.
-*
-* F-211: the rename COMMIT phase does not carry the same guarantee. When a
-* filesystem refuses to overwrite the destination, the code removes it and
-* retries the rename; if the retry ALSO fails the destination is gone. The
-* single `.bak` created above still holds the previous content, so the target
-* is restored from it (best-effort) before the original rename error is
-* rethrown, so a failed commit never leaves the file missing.
-*
-* V4-17: the `.bak` is refreshed to the committed content after every
-* successful commit, so a later failed commit always recovers to the most
-* recent good generation (a once-at-first-install `.bak` could otherwise
-* restore content several installs old). The recovery error names the `.bak`
-* source (and mtime when available) so the caller knows the generation it
-* restored from.
-*/
-function atomicWriteFiles(targetDir, writes, fs = defaultFs, logger = console.warn) {
-	const stage = (name) => join(targetDir, `${name}.tmp`);
-	const dupes = [...new Set(writes.map((write) => write.name).filter((name, index, all) => all.indexOf(name) !== index))];
-	if (dupes.length > 0) throw new Error(`atomicWriteFiles: duplicate input names: ${dupes.join(", ")}`);
-	try {
-		for (const { name, content } of writes) fs.writeFileSync(stage(name), content);
-		for (const { name } of writes) {
-			const finalPath = join(targetDir, name);
-			const bakPath = join(targetDir, `${name}.bak`);
-			if (fs.existsSync(finalPath) && !fs.existsSync(bakPath)) fs.copyFileSync(finalPath, bakPath);
-		}
-		const committed = [];
-		for (const { name } of writes) {
-			const finalPath = join(targetDir, name);
-			const bakPath = join(targetDir, `${name}.bak`);
-			const tmp = stage(name);
-			try {
-				fs.renameSync(tmp, finalPath);
-				committed.push(name);
-			} catch {
-				try {
-					fs.rmSync(finalPath, { force: true });
-				} catch (removeError) {
-					const already = committed.length > 0 ? `; already committed: ${committed.join(", ")}` : "";
-					throw new Error(`atomicWriteFiles: could not remove "${name}" to replace it (${removeError instanceof Error ? removeError.message : String(removeError)})${already}`);
-				}
-				try {
-					fs.renameSync(tmp, finalPath);
-					committed.push(name);
-				} catch (renameError) {
-					const already = committed.length > 0 ? `; already committed: ${committed.join(", ")}` : "";
-					if (fs.existsSync(bakPath)) {
-						try {
-							fs.copyFileSync(bakPath, finalPath);
-						} catch {
-							throw new Error(`atomicWriteFiles: "${name}" was removed but recovery from ${bakPath} failed (${renameError instanceof Error ? renameError.message : String(renameError)}); verify the file manually${already}`);
-						}
-						const bakMtime = fs.mtime?.(bakPath);
-						const when = bakMtime !== null && bakMtime !== void 0 && Number.isFinite(bakMtime) ? ` (bak mtime ${new Date(bakMtime).toISOString()})` : "";
-						throw new Error(`atomicWriteFiles: "${name}" was removed during commit and restored from the last good generation ${bakPath}${when}; original error: ${renameError instanceof Error ? renameError.message : String(renameError)}${already}`);
-					}
-					throw new Error(`${renameError instanceof Error ? renameError.message : String(renameError)}${already}`);
-				}
-			}
-		}
-		for (const { name } of writes) {
-			const finalPath = join(targetDir, name);
-			try {
-				if (fs.existsSync(finalPath)) fs.copyFileSync(finalPath, join(targetDir, `${name}.bak`));
-			} catch (refreshError) {
-				logger(`atomicWriteFiles: committed "${name}" but failed to refresh its .bak (${refreshError instanceof Error ? refreshError.message : String(refreshError)}); a later failed commit will recover to an OLDER generation`);
-			}
-		}
-	} catch (error) {
-		const cleanupFailures = [];
-		for (const { name } of writes) try {
-			fs.rmSync(stage(name), {
-				force: true,
-				recursive: true
-			});
-		} catch (cleanupError) {
-			cleanupFailures.push(`${name}: ${cleanupError instanceof Error ? cleanupError.message : String(cleanupError)}`);
-		}
-		if (cleanupFailures.length > 0) {
-			const original = error instanceof Error ? error.message : String(error);
-			throw new Error(`${original} (staged-temp cleanup also failed: ${cleanupFailures.join("; ")})`);
-		}
-		throw error;
-	}
-}
 /** F-328: render staged args for `pending --detail`, truncated to 500 chars.
 * args may be non-JSON (a tool produced garbage), so the render is fail-safe.
 * V4-19: a truncation is marked with `…(truncated N chars)` so the operator is