@lmzhen/dsh-evolution-commands 0.7.0 → 0.9.0

package/lib/index.js

@@ -2,7 +2,7 @@ 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_NAMESPACES, appendEvolutionEvent, assertSkillsRootAliasRetired, buildLearnPrompt, canonicalWriteId, clampedNumber, composePresetComposition, eventsFile, evolutionRoot, isDeprecatedParamId, isMissingPath, newSkillLibrary, policyStageLimits, resolveParamId, resolveRootConfig, scopedProbeReport } from "@lmzhen/dsh-evolution-core";
+import { DEFAULT_SKILL_LIMITS, MAX_TIMER_DELAY_MS, PARAM_EXPOSURE, PARAM_GROUP_LABELS, PARAM_NAMESPACES, appendEvolutionEvent, assertSkillsRootAliasRetired, buildLearnPrompt, canonicalWriteId, clampedNumber, composePresetComposition, errorText, eventsFile, evolutionRoot, isDeprecatedParamId, isMissingPath, newSkillLibrary, policyStageLimits, resolveParamId, resolveRootConfig, scopedProbeReport } from "@lmzhen/dsh-evolution-core";
 import { buildEnrichment, buildMaintainFacts, runMaintain, snapshotFromLibrary } from "@lmzhen/dsh-evolution-maintenance";
 import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
@@ -643,15 +643,46 @@ function renderValue(value) {
 	if (typeof value === "string") return value;
 	return JSON.stringify(value);
 }
+const WIDE_CHAR = new RegExp("[" + [
+	"ᄀ-ᅟ",
+	"⺀-〾",
+	"ぁ-㏿",
+	"㐀-䶿",
+	"一-鿿",
+	"가-힣",
+	"豈-﫿",
+	"︰-﹯",
+	"＀-｠",
+	"￠-￦"
+].join("") + "]");
 /**
-* Render the rows as fixed-width text (one parameter per line, never truncated).
-* @param rows - rows from {@link paramSurfaceRows}.
-* @param options - whether the settings service answered at all.
-* @returns the command text.
+* Pad one cell to a display width, counting CJK characters as two columns.
+* @param text - the cell text.
+* @param columns - the target width in terminal columns.
+* @returns the text plus at least one space, so columns never touch.
 */
+function pad(text, columns) {
+	let used = 0;
+	for (const char of text) used += WIDE_CHAR.test(char) ? 2 : 1;
+	return text + " ".repeat(Math.max(1, columns - used));
+}
+/** Settings timing, in the operator's words. */
+const APPLIES_LABELS = Object.freeze({
+	live: "立即",
+	restart: "重启后",
+	none: "不生效"
+});
+/** Where a row's effective value comes from, in the operator's words. */
+const SOURCE_LABELS = Object.freeze({
+	user: "我改过",
+	deployment: "默认",
+	unregistered: "不可改"
+});
+/** What the E-tiers mean, so the count line reads without the docs. */
+const TIER_LEGEND = "档位：E0 固定／E1 只读／E2 安装时定／E3 你可改／E4 装完固化。";
 function renderParamRows(rows, options) {
-	const header = "PARAMETER".padEnd(36) + "GROUP".padEnd(12) + "TIER".padEnd(5) + "APPLIES".padEnd(9) + "SOURCE".padEnd(14) + "VALUE";
-	const body = rows.map((row) => row.id.padEnd(36) + row.group.padEnd(12) + row.tier.padEnd(5) + row.applies.padEnd(9) + row.source.padEnd(14) + renderValue(row.value));
+	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 tiers = [
 		"E0",
 		"E1",
@@ -660,13 +691,14 @@ function renderParamRows(rows, options) {
 		"E4"
 	].map((tier) => `${tier} ${rows.filter((row) => row.tier === tier).length}`).join(" / ");
 	const userRows = rows.filter((row) => row.source === "user").length;
-	const overrides = options.providerMounted ? `${userRows} overridden by the user.` : "overrides UNKNOWN (no settings provider).";
-	const note = options.providerMounted ? "SOURCE: user = you set it in settings; deployment = the row/policy value applies; unregistered = the owner publishes no user layer." : "settings provider not mounted — the user layer is unavailable, so every row shows its deployment face (this is NOT \"no overrides\").";
+	const counts = options.providerMounted ? `共 ${rows.length} 个参数：${tiers}；你改过的：${userRows} 项。` : `共 ${rows.length} 个参数：${tiers}；是否改过：未知（没有设置服务）。`;
+	const note = options.providerMounted ? "来源：我改过＝你在设置里改的；默认＝安装时的配置；不可改＝该功能不提供用户可改项。" : "设置服务未挂载——读不到你改过的值，所以每行显示的都是安装时的配置（这不等于「你没改过」）。";
 	return [
 		header,
 		...body,
 		"",
-		`${rows.length} parameter(s): ${tiers}; ${overrides}`,
+		counts,
+		TIER_LEGEND,
 		note
 	].join("\n");
 }
@@ -709,79 +741,79 @@ function renderParamJson(rows) {
 const COMMAND_ENTRIES = [
 	{
 		usage: "pending [--detail]",
-		summary: "list staged evolution writes (--detail shows staged args)"
+		summary: "列出暂存的写入（--detail 显示参数）"
 	},
 	{
 		usage: "approve <id>",
-		summary: "replay an approved staged write through its runner"
+		summary: "执行一条已批准的写入"
 	},
 	{
 		usage: "reject <id>",
-		summary: "drop a staged write without running it"
+		summary: "丢弃一条暂存写入，不执行"
 	},
 	{
 		usage: "release <id>",
-		summary: "return an orphaned EXECUTING write to the pending window (verify the effect first, then approve or reject)"
+		summary: "把卡在执行中的写入放回待批窗口（先确认效果再批准 or reject)"
 	},
 	{
 		usage: "doctor [--json]",
-		summary: "read-only self-check: install form, conflicts, env, services (--json feeds scripts)"
+		summary: "只读自检：安装形态、冲突、环境、服务（--json 供脚本用）"
 	},
 	{
 		usage: "curator run|pause|resume|status|report|scope",
-		summary: "run one curation pass, control or inspect automatic curation"
+		summary: "立即运行一次自动整理，或暂停／恢复／查看状态"
 	},
 	{
 		usage: "mutations",
-		summary: "list skill-mutation audit records"
+		summary: "列出技能改动记录"
 	},
 	{
 		usage: "restore",
-		summary: "restore skills from the latest snapshot"
+		summary: "从最近的快照恢复技能"
 	},
 	{
 		usage: "consolidate <target> <sources...> [--plan <runId>]",
-		summary: "merge source skills into a target umbrella skill"
+		summary: "把若干技能合并进一个总括技能"
 	},
 	{
 		usage: "skill restore <name>",
-		summary: "restore one archived skill by name"
+		summary: "按名字恢复一个已归档的技能"
 	},
 	{
 		usage: "skills health",
-		summary: "structure-health verdicts for the skill library"
+		summary: "技能库结构体检"
 	},
 	{
 		usage: "skills refresh",
-		summary: "drop the catalog caches and re-read the tree"
+		summary: "丢弃目录缓存并重新读取技能树"
 	},
 	{
 		usage: "learn [request]",
-		summary: "send a learning request to this session"
+		summary: "向本会话发一条学习请求"
 	},
 	{
 		usage: "maintain [--timeout=<ms> | --facts]",
-		summary: "run a maintenance scan (--facts: 0-token preview)"
+		summary: "运行一次维护扫描（--facts 为 0 token 预览）"
 	},
 	{
 		usage: "policy set <id> <value> [--expect <revision>]",
-		summary: "write one user-writable parameter through the settings service (E3 only; E1/E2 stay in cordis.yml)"
+		summary: "通过设置服务写入一个你可改的参数 (E3 only; E1/E2 stay in cordis.yml)"
 	},
 	{
 		usage: "params [--group <name>] [--json]",
-		summary: "list every registered parameter: group, tier, timing, source and value (--json feeds scripts)"
+		summary: "列出全部参数：分组、档位、生效时机、来源与当前值（--json feeds scripts)"
 	},
 	{
 		usage: "preset install [--base <name>[,<name>...]]",
-		summary: "generate one Evolution agent preset per named base into the user root (bases from the agent package's bases.json)"
+		summary: "按指定基础生成自进化 Agent 预设到用户 root (bases from the agent package's bases.json)"
 	},
 	{
 		usage: "restructure <name> \"<heading>\" <to_file> [--plan <runId>]",
-		summary: "move a body section into a references/ file"
+		summary: "把技能正文的一节移到 references 文件"
 	},
 	{
 		usage: "replay",
-		summary: "compare plan outcomes across sessions and restarts (backfilled from the activity store)"
+		summary: "比较不同会话与重启之间的计划结果（从活动记录回填）"
 	}
 ];
 /** The input-declaration hint (single line, ` | `-separated). */
@@ -818,7 +850,7 @@ function apply(ctx, rawConfig = {}) {
 		const commands = commandCtx.commands;
 		const evolutionCommand = {
 			name: "evolution",
-			description: "Self-evolution status and approval controls",
+			description: "自进化：状态与待批准写入",
 			recordInput: false,
 			input: { hint: renderHint() },
 			run: async (invocation) => {
@@ -833,18 +865,18 @@ function apply(ctx, rawConfig = {}) {
 					text
 				});
 				const invocationAgent = invocation.agent;
-				const agentMissing = (need) => invocationAgent === void 0 ? err(`E-305: this invocation carries no agent — \`${need}\` needs a session-backed call (run it from a session in the GUI or the CLI).`) : void 0;
+				const agentMissing = (need) => invocationAgent === void 0 ? err(errorText("e-305-this-invocation-carries-no", { a1: need })) : void 0;
 				const unreplayableWriteRefusal = (what) => {
 					if (approval === void 0) return void 0;
 					const session = invocationAgent?.session;
 					const sessionPolicy = effectiveSessionPolicy(ctx, session);
 					if (!(approval.isEnabled !== false && sessionPolicy !== "never" && approval.stageForeground !== false)) return void 0;
-					return err(`E-306: this deployment stages foreground writes, but \`/evolution ${what}\` is not replayable through the skill runner — there is nothing to stage. Run it from a session whose approval policy is 'never', or set \`stageForeground: false\` on the evolution-approval row, then repeat the command.`);
+					return err(errorText("e-306-this-deployment-stages-foreground", { a1: what }));
 				};
 				const approval = ctx.get("evolutionApproval");
 				const pendingMatch = /^pending(?: --detail)?$/.exec(input);
 				if (pendingMatch) {
-					if (!approval) return err("E-301: approval service not mounted — pending writes cannot be listed or replayed. Next: the evolution-approval row ships with evolution-host/evolution-all — run /evolution doctor to see which services are mounted.");
+					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()];
 					if (pending.length === 0) return ok("No pending evolution writes.");
@@ -860,7 +892,7 @@ function apply(ctx, rawConfig = {}) {
 					const id = input.slice(8).trim();
 					const result = approval ? await approval.approve(id) : {
 						ok: false,
-						message: "E-301: approval service not mounted. Next: the evolution-approval row ships with evolution-host/evolution-all — run /evolution doctor to see which services are mounted."
+						message: errorText("e-301-approval-service-not-mounted-2")
 					};
 					return result.ok ? ok(result.message) : err(result.message);
 				}
@@ -868,27 +900,27 @@ function apply(ctx, rawConfig = {}) {
 					const id = input.slice(7).trim();
 					const result = approval ? await approval.reject(id) : {
 						ok: false,
-						message: "E-301: approval service not mounted. Next: the evolution-approval row ships with evolution-host/evolution-all — run /evolution doctor to see which services are mounted."
+						message: errorText("e-301-approval-service-not-mounted-2")
 					};
 					return result.ok ? ok(result.message) : err(result.message);
 				}
 				if (input.startsWith("release ")) {
 					const id = input.slice(8).trim();
-					if (!approval) return err("E-301: approval service not mounted. Next: the evolution-approval row ships with evolution-host/evolution-all — run /evolution doctor to see which services are mounted.");
-					if (!approval.release) return err("E-304: the mounted approval service predates the release capability — reject the record instead.");
+					if (!approval) return err(errorText("e-301-approval-service-not-mounted-2"));
+					if (!approval.release) return err(errorText("e-304-the-mounted-approval-service"));
 					const result = await approval.release(id);
 					return result.ok ? ok(result.message) : err(result.message);
 				}
 				if (input === "curator run") {
 					const curator = ctx.get("evolutionCurator");
-					if (!curator) return err("E-302: curator service not mounted. Next: mount the evolution-curator row (evolution-host/evolution-all) and run /evolution doctor.");
+					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 (input === "curator pause" || input === "curator resume") {
 					const curator = ctx.get("evolutionCurator");
-					if (!curator) return err("E-302: curator service not mounted. Next: mount the evolution-curator row (evolution-host/evolution-all) and run /evolution doctor.");
+					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.";
@@ -896,7 +928,7 @@ function apply(ctx, rawConfig = {}) {
 				}
 				if (input === "curator status") {
 					const curator = ctx.get("evolutionCurator");
-					if (!curator) return err("E-302: curator service not mounted. Next: mount the evolution-curator row (evolution-host/evolution-all) and run /evolution doctor.");
+					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.");
 					const lastRun = typeof state.lastRunAt === "number" && Number.isFinite(state.lastRunAt) && state.lastRunAt > 0 ? new Date(state.lastRunAt).toISOString() : "unknown";
@@ -909,7 +941,7 @@ function apply(ctx, rawConfig = {}) {
 				}
 				if (input === "mutations") {
 					const curator = ctx.get("evolutionCurator");
-					if (!curator) return err("E-302: curator service not mounted. Next: mount the evolution-curator row (evolution-host/evolution-all) and run /evolution doctor.");
+					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.");
@@ -918,7 +950,7 @@ function apply(ctx, rawConfig = {}) {
 				}
 				if (input === "curator scope") {
 					const curator = ctx.get("evolutionCurator");
-					if (!curator) return err("E-302: curator service not mounted. Next: mount the evolution-curator row (evolution-host/evolution-all) and run /evolution doctor.");
+					if (!curator) return err(errorText("e-302-curator-service-not-mounted"));
 					const view = await curator.scopeView();
 					const line = (label, names) => `${label}: ${names.length}${names.length === 0 ? "" : `\n  ${names.join(", ")}`}`;
 					return ok([
@@ -932,7 +964,7 @@ function apply(ctx, rawConfig = {}) {
 				}
 				if (input === "curator report") {
 					const curator = ctx.get("evolutionCurator");
-					if (!curator) return err("E-302: curator service not mounted. Next: mount the evolution-curator row (evolution-host/evolution-all) and run /evolution doctor.");
+					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.");
@@ -958,7 +990,7 @@ function apply(ctx, rawConfig = {}) {
 					const curator = ctx.get("evolutionCurator");
 					const result = curator ? await curator.restoreSnapshot() : {
 						ok: false,
-						message: "E-302: curator service not mounted. Next: mount the evolution-curator row (evolution-host/evolution-all) and run /evolution doctor."
+						message: errorText("e-302-curator-service-not-mounted")
 					};
 					return result.ok ? ok(result.message) : err(result.message);
 				}
@@ -972,7 +1004,7 @@ function apply(ctx, rawConfig = {}) {
 					const curator = ctx.get("evolutionCurator");
 					const result = curator ? await curator.consolidate(target, sources) : {
 						ok: false,
-						message: "E-302: curator service not mounted. Next: mount the evolution-curator row (evolution-host/evolution-all) and run /evolution doctor."
+						message: errorText("e-302-curator-service-not-mounted")
 					};
 					if (!result.ok) return err(result.message);
 					return ok(planRunId ? `${result.message}\n[audit] plan=${planRunId}` : result.message);
@@ -985,13 +1017,13 @@ function apply(ctx, rawConfig = {}) {
 					const curator = ctx.get("evolutionCurator");
 					const result = curator ? await curator.restore(name) : {
 						ok: false,
-						message: "E-302: curator service not mounted. Next: mount the evolution-curator row (evolution-host/evolution-all) and run /evolution doctor."
+						message: errorText("e-302-curator-service-not-mounted")
 					};
 					return result.ok ? ok(result.message) : err(result.message);
 				}
 				if (input === "skills health") {
 					const curator = ctx.get("evolutionCurator");
-					if (!curator) return err("E-302: curator service not mounted. Next: mount the evolution-curator row (evolution-host/evolution-all) and run /evolution doctor.");
+					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 line = (row) => `${row.verdict.padEnd(18)} ${row.name}${row.reasons.length > 0 ? ` — ${row.reasons.join("; ")}` : ""}`;
@@ -1024,7 +1056,7 @@ function apply(ctx, rawConfig = {}) {
 						agent.followup(message);
 						woke = true;
 					} else if (typeof agent.inject === "function") agent.inject(message);
-					else return err("E-305: the invocation agent exposes neither `followup` nor `inject` — this learn request has no delivery channel.");
+					else return err(errorText("e-305-the-invocation-agent-exposes"));
 					const eventIo = ctx.get("evolutionIo")?.provider();
 					if (eventIo) appendEvolutionEvent(eventIo, eventsFile(evolutionRoot()), {
 						type: "learn",
@@ -1203,7 +1235,7 @@ function apply(ctx, rawConfig = {}) {
 						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("E-306: this deployment stages foreground writes, but this invocation carries no agent session — `/evolution restructure` would stage a record with no session attribution. Run it from a session in the GUI or the CLI, or set `stageForeground: false` on the evolution-approval row, then repeat the command.");
+						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.");
 						const decision = await approval.request({
 							kind: "skill",
@@ -1248,7 +1280,7 @@ function apply(ctx, rawConfig = {}) {
 				}
 				if (input === "replay") {
 					const replay = ctx.get("evolutionReplay");
-					if (!replay) return err("E-303: replay service not mounted. Next: mount the evolution-replay row (evolution-host/evolution-all) and run /evolution doctor.");
+					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);
@@ -1264,52 +1296,68 @@ function apply(ctx, rawConfig = {}) {
 							sections.set(descriptor.ns, section);
 						}
 					} catch (error) {
-						return err(`E-307: the settings service could not report its sections (${error instanceof Error ? error.message : String(error)}). /evolution params needs the user layer to tell an override from a deployment value; run /evolution doctor to see which services are mounted.`);
+						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 selected = group === void 0 ? rows : rows.filter((row) => row.group === group);
-					if (group !== void 0 && selected.length === 0) return err(`E-308: unknown parameter group "${group}" — known groups: ${paramGroups(PARAM_EXPOSURE).join(", ")}.`);
+					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));
 					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 provider = ctx.get("settings");
-					if (provider?.update === void 0 || provider.describe === void 0) return err("E-311: no settings service is mounted, so there is no user layer to write. Mount the settings row (packages/settings/settings-file) and retry; this command never edits cordis.yml — a deployment value belongs to the deployment. /evolution doctor lists the mounted services.");
+					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] ?? "";
 					let id;
 					try {
 						id = canonicalWriteId(rawId);
 					} catch (error) {
-						return err(`E-312: ${error instanceof Error ? error.message : String(error)} — /evolution params lists the canonical ids.`);
+						return err(errorText("e-312-error-instanceof-Error-error", { a1: error instanceof Error ? error.message : String(error) }));
 					}
 					const entry = PARAM_EXPOSURE.find((candidate) => candidate.id === id);
-					if (entry === void 0) return err(`E-313: unknown parameter "${id}" — /evolution params lists every registered id with its tier and user layer.`);
-					if (entry.tier !== "E3") return err(`E-314: "${id}" is a deployment parameter (tier ${entry.tier}, owner ${entry.owner}) — it is written in cordis.yml on its plugin or policy row, not from a session. /evolution params shows who may write each row.`);
+					if (entry === void 0) return err(errorText("e-313-unknown-parameter-id-evolution", { a1: id }));
+					if (entry.tier !== "E3") return err(errorText("e-314-id-is-a-deployment", {
+						a1: id,
+						a2: entry.tier,
+						a3: entry.owner
+					}));
 					const namespace = PARAM_NAMESPACES[entry.owner];
-					if (namespace === void 0) return err(`E-315: "${id}" has no user layer — owner ${entry.owner} publishes no settings namespace, so the value stays with the deployment.`);
+					if (namespace === void 0) return err(errorText("e-315-id-has-no-user", {
+						a1: id,
+						a2: entry.owner
+					}));
 					let descriptor;
 					try {
 						descriptor = provider.describe({ redactSecrets: false }).find((candidate) => candidate.ns === namespace);
 					} catch (error) {
-						return err(`E-307: the settings service could not report its sections (${error instanceof Error ? error.message : String(error)}). /evolution policy set needs the current revision to write safely; run /evolution doctor to see which services are mounted.`);
+						return err(errorText("e-307-the-settings-service-could-2", { a1: error instanceof Error ? error.message : String(error) }));
 					}
-					if (descriptor === void 0) return err(`E-316: namespace "${namespace}" is not registered — owner ${entry.owner} is not mounted in this composition, so its parameters cannot be written from here. /evolution params marks those rows 'unregistered'.`);
+					if (descriptor === void 0) return err(errorText("e-316-namespace-namespace-is-not", {
+						a1: namespace,
+						a2: entry.owner
+					}));
 					const current = descriptor.value;
 					const resolved = typeof current === "object" && current !== null ? current : void 0;
 					const expectedRaw = policySetMatch[3];
 					const expected = expectedRaw === void 0 ? descriptor.revision : Number(expectedRaw);
-					if (expectedRaw !== void 0 && descriptor.revision !== void 0 && Number(expectedRaw) !== descriptor.revision) return err(`E-309: revision conflict — you sent ${expectedRaw}, the document stands at ${descriptor.revision}. Re-read with /evolution params --json and retry.`);
+					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);
 					try {
 						await provider.update(namespace, { [id]: value }, expected);
 					} catch (error) {
 						const code = error?.code;
 						const message = error instanceof Error ? error.message : String(error);
-						if (code === "SETTINGS_CONFLICT") return err(`E-309: revision conflict — ${message}. Re-read with /evolution params --json and retry.`);
-						return err(`E-310: the settings service refused the write: ${message} — the owning plugin's rule stands (a cross-field pair, or a cap that may only be tightened). /evolution params shows the current value.`);
+						if (code === "SETTINGS_CONFLICT") return err(errorText("e-309-revision-conflict-message-Re", { a1: message }));
+						return err(errorText("e-310-the-settings-service-refused", { a1: message }));
 					}
 					return ok(renderPolicySet({
 						id,
@@ -1325,7 +1373,7 @@ function apply(ctx, rawConfig = {}) {
 					if (input === "doctor --json") return ok(JSON.stringify(report, null, 2));
 					return ok(renderDoctorText(report));
 				}
-				return ok(`Evolution: memory, skills, review, curator — self-evolution status, approval and maintenance.\n${renderHelpText()}`);
+				return ok(`自进化：记忆、技能、会话回顾、技能整理——状态、待批准写入与维护。\n${renderHelpText()}`);
 			},
 			handler: (invocation) => evolutionCommand.run(invocation).catch((error) => ({
 				kind: "error",

package/lib/types/params.d.ts

@@ -52,12 +52,6 @@ export declare function paramSurfaceRows(sections: ReadonlyMap<string, ParamSect
  * @returns distinct group names.
  */
 export declare function paramGroups(entries?: readonly ParamExposure[]): string[];
-/**
- * Render the rows as fixed-width text (one parameter per line, never truncated).
- * @param rows - rows from {@link paramSurfaceRows}.
- * @param options - whether the settings service answered at all.
- * @returns the command text.
- */
 export declare function renderParamRows(rows: readonly ParamSurfaceRow[], options: {
     providerMounted: boolean;
 }): string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-commands",
   "description": "Human commands for the evolution family (/evolution pending|curator|maintain|doctor) (community build)",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "publishConfig": {
     "access": "public"
   },
@@ -27,12 +27,12 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-approval": "^0.7.0",
-    "@lmzhen/dsh-evolution-core": "^0.7.0",
-    "@lmzhen/dsh-evolution-maintenance": "^0.7.0"
+    "@lmzhen/dsh-evolution-approval": "^0.9.0",
+    "@lmzhen/dsh-evolution-core": "^0.9.0",
+    "@lmzhen/dsh-evolution-maintenance": "^0.9.0"
   },
   "optionalDependencies": {
-    "@lmzhen/dsh-evolution-agent-preset": "^0.7.0"
+    "@lmzhen/dsh-evolution-agent-preset": "^0.9.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",