@lmzhen/dsh-evolution-settings-ui 0.6.1 → 0.7.0

package/README.md

@@ -1,12 +1,34 @@
 # @lmzhen/dsh-evolution-settings-ui
 
-Web settings cards for the evolution family's parameter namespaces. The Host half registers nothing: the namespaces belong to the plugins that own them (evolution-review, memory-files, tool-memory, evolution-curator, tool-skill-manage), and this package's browser half claims one card per namespace in the keyed `settings.plugin.item` slot.
+Web settings section (**自进化**) for the evolution family's parameter namespaces. The Host half registers nothing: the namespaces belong to the plugins that own them (evolution-review, memory-files, tool-memory, evolution-curator, tool-skill-manage), and this package's browser half registers one settings section that hosts one card per namespace.
+
+## Where it lives
+
+The section goes through the platform's own seam — the same call the platform's 插件 section and the out-of-repo market / skins / Web-plugins sections use:
+
+    ctx.slots.register({
+      name: 'settings.section', id: 'evolution', order: 25,
+      label: () => t('title'), locale: NS,
+      children: { 'evolution.namespace.card': { kind: 'keyed', scope: 'root' } },
+    }, SettingsSection)
+
+The cards claim the keyed child slot per namespace, so a namespace the Host does not serve renders nothing, and a deployment that drops this row loses the whole section — no Host-side behaviour rides on this pair. Until 0.6.1 the cards lived inside the platform's 插件 section; 0.7.0 moved them into their own section, which is how every other feature area presents itself.
 
 ## What a card does
 
-Each card renders the namespace's user-writable (E3) fields with their current value, a source badge, a write control and a revert control. Writes go through the client settings scope (`set`/`unset`), which carries the revision it read as the write's fence; a field whose key is present in the raw user section reads as a user override even when its value equals the deployment value.
+A card renders the namespace's user-writable (E3) fields with the registry's Chinese label, its unit, a 用户/部署 source chip, a control **typed from the registry** (switch / select / number / text) holding the current value, the registry's hint, and a per-field 恢复部署默认 action when a user override exists. The card's foot carries one 放弃修改 / 保存 pair: edits live in a draft, 保存 writes only the dirty fields in order and clears the draft on success. Success is decided by READING BACK the raw user section — the client settings scope resolves a refused write (it recovers the snapshot and returns; the remote call never rejects), so a field the Host refused simply leaves no user key. When that happens the card reports it under the fields and keeps the draft, so nothing the operator typed is lost and a refusal never looks like a silent revert.
+
+Writes go through the client settings scope (`set`/`unset`), which carries the revision it read as the write's fence; a field whose key is present in the raw user section reads as a user override even when its value equals the deployment value.
+
+The field list AND the per-field UI metadata are GENERATED from the parameter registry (`packages/scripts/gen-param-client-view.mjs` writes `src/client/generated-params.ts`): id, group, the English summary, and the E3 rows' label / hint / control / unit / values. The browser half therefore cannot name a parameter the Host does not register, and cannot invent a control the registry does not declare. Regenerate after every registry edit; the family gate runs the generator with `--check`.
+
+## Styling
+
+The design system's CSS is not exported to packages outside the platform repository, so this bundle carries its own stylesheet and injects it once behind a `<style data-plugin-css="…">` tag — the mechanism the platform's own client bundles use. Every rule reads a `--dsw-alias-*` design token, so light and dark follow the theme without a colour of our own, and the field metrics (12px padding, 6px gap, 13px label, 12px hint) copy the platform's settings fields.
+
+## Copy and locale
 
-The field list is GENERATED from the parameter registry (`packages/scripts/gen-param-client-view.mjs` writes `src/client/generated-params.ts`), so the browser half cannot name a parameter the Host does not register. Regenerate after every registry edit; the family gate runs the generator with `--check`.
+Section and card copy lives in `src/client/messages.ts` as a zh/en dictionary, registered through the platform's locale seat (`ctx.locale.register(namespace, { zh, en })` plus `bind`), so the nav entry and its copy follow the UI language. The earlier note in this file — that an outside package cannot bind the locale seat — was wrong: the out-of-repo market and skins plugins bind it exactly this way.
 
 ## Build
 
@@ -14,6 +36,7 @@ The browser half ships as the client module system's lazy CJS factory artifact (
 
 ## Known limitations and deferred work
 
-- Card copy lives in this package's own dictionary (`src/client/messages.ts`) and reaches components through the inject face; the platform locale seat is not bound yet (an outside package cannot declare an in-repo locale namespace type).
-- The cards render plain controls with class names and no stylesheet: the family ships no CSS build step for client packages yet.
 - Only E3 (user-writable) rows are rendered; deployment tiers are reported by `/evolution params` and the doctor divergence section instead.
+- The section renders plain controls styled with the design tokens rather than the platform's `@deepseek-ai/dsh-client-ui-primitives` kit: that module IS available to out-of-repo bundles (the market plugin requires it), but its prop shapes are not published, and guessing them would break the live GUI.
+- An unsaved draft lives in the card's own component state and the settings shell renders only the active section, so switching to another section drops a draft that was not saved yet. Values already written are unaffected; moving the draft into an apply-time store is the 0.7.x follow-up.
+- A deployment that overrides a field through the `evolution-policy` row does not show on the card: the card reports the deployment value the settings scope serves, while the policy snapshot can differ. That divergence stays a doctor / `/evolution params` matter.

package/lib/client.js

@@ -13,62 +13,122 @@ window.__ModuleLoader__.load({
 					{
 						id: "curatorIntervalHours",
 						group: "curator",
-						doc: "Minimum hours between deterministic curation passes."
+						doc: "Minimum hours between deterministic curation passes.",
+						label: "策展间隔",
+						hint: "两次确定性策展之间至少间隔多少小时。",
+						control: "number",
+						unit: "小时",
+						values: []
 					},
 					{
 						id: "staleAfterDays",
 						group: "curator",
-						doc: "Inactive days before a skill counts as stale."
+						doc: "Inactive days before a skill counts as stale.",
+						label: "判为陈旧的天数",
+						hint: "技能多少天没被使用即算陈旧。",
+						control: "number",
+						unit: "天",
+						values: []
 					},
 					{
 						id: "archiveAfterDays",
 						group: "curator",
-						doc: "Inactive days before a stale skill is archived (must be >= staleAfterDays)."
+						doc: "Inactive days before a stale skill is archived (must be >= staleAfterDays).",
+						label: "归档天数",
+						hint: "陈旧技能再过多少天归档（须 ≥ 判为陈旧的天数）。",
+						control: "number",
+						unit: "天",
+						values: []
 					},
 					{
 						id: "qualityWarnStaleAfterDays",
 						group: "curator",
-						doc: "Age at which a low quality score starts warning."
+						doc: "Age at which a low quality score starts warning.",
+						label: "低质量告警天数",
+						hint: "质量分偏低时从多少天开始告警。",
+						control: "number",
+						unit: "天",
+						values: []
 					},
 					{
 						id: "minIdleHours",
 						group: "curator",
-						doc: "Idle hours required before an automatic curation pass runs."
+						doc: "Idle hours required before an automatic curation pass runs.",
+						label: "空闲门槛",
+						hint: "至少空闲多少小时才跑自动策展。",
+						control: "number",
+						unit: "小时",
+						values: []
 					},
 					{
 						id: "minIdleFailOpen",
 						group: "curator",
-						doc: "Let the idle gate open when the activity probe is unavailable."
+						doc: "Let the idle gate open when the activity probe is unavailable.",
+						label: "空闲探针失败时放行",
+						hint: "活动探针不可用时，是否让空闲门槛直接放行。",
+						control: "switch",
+						unit: "",
+						values: []
 					},
 					{
 						id: "llmReview",
 						group: "curator",
-						doc: "Enable the LLM nomination pass on top of the deterministic lifecycle."
+						doc: "Enable the LLM nomination pass on top of the deterministic lifecycle.",
+						label: "启用 LLM 提名",
+						hint: "在确定性生命周期之上再跑一遍 LLM 提名。",
+						control: "switch",
+						unit: "",
+						values: []
 					},
 					{
 						id: "curatorReviewMaxTokens",
 						group: "curator",
-						doc: "Token budget of the curator LLM review."
+						doc: "Token budget of the curator LLM review.",
+						label: "策展 LLM token 预算",
+						hint: "策展 LLM 审查可用的 token 预算。",
+						control: "number",
+						unit: "token",
+						values: []
 					},
 					{
 						id: "curatorReviewTimeoutMs",
 						group: "curator",
-						doc: "Wall-clock bound of the curator LLM review."
+						doc: "Wall-clock bound of the curator LLM review.",
+						label: "策展 LLM 超时",
+						hint: "策展 LLM 审查的墙钟上限。",
+						control: "number",
+						unit: "毫秒",
+						values: []
 					},
 					{
 						id: "healthSoftBodyChars",
 						group: "curator",
-						doc: "Body character line the health view judges against."
+						doc: "Body character line the health view judges against.",
+						label: "正文软带",
+						hint: "健康视图判定正文长度的软带。",
+						control: "number",
+						unit: "字符",
+						values: []
 					},
 					{
 						id: "healthStampDensityPerKb",
 						group: "curator",
-						doc: "Stamp density per KB that flags log-like content in a body."
+						doc: "Stamp density per KB that flags log-like content in a body.",
+						label: "标记密度阈值",
+						hint: "每 KB 出现多少个时间标记就算「像日志」。",
+						control: "number",
+						unit: "处/KB",
+						values: []
 					},
 					{
 						id: "healthChurnMinPatches",
 						group: "curator",
-						doc: "Patches without a read that flag a write-ghost skill."
+						doc: "Patches without a read that flag a write-ghost skill.",
+						label: "空写判定补丁数",
+						hint: "多少次改动都没有任何读取，即判为「写幽灵」。",
+						control: "number",
+						unit: "处",
+						values: []
 					}
 				]
 			},
@@ -78,22 +138,42 @@ window.__ModuleLoader__.load({
 					{
 						id: "memoryChars",
 						group: "memory",
-						doc: "Character budget the memory store enforces for MEMORY.md."
+						doc: "Character budget the memory store enforces for MEMORY.md.",
+						label: "MEMORY.md 字符预算",
+						hint: "memory 存储对 MEMORY.md 的字符上限。",
+						control: "number",
+						unit: "字符",
+						values: []
 					},
 					{
 						id: "userChars",
 						group: "memory",
-						doc: "Character budget the memory store enforces for USER.md."
+						doc: "Character budget the memory store enforces for USER.md.",
+						label: "USER.md 字符预算",
+						hint: "memory 存储对 USER.md 的字符上限。",
+						control: "number",
+						unit: "字符",
+						values: []
 					},
 					{
 						id: "addDatePrefix",
 						group: "memory",
-						doc: "Prefix stored memory entries with their date heading."
+						doc: "Prefix stored memory entries with their date heading.",
+						label: "记忆条目加日期前缀",
+						hint: "写入记忆时为条目加上日期标题。",
+						control: "switch",
+						unit: "",
+						values: []
 					},
 					{
 						id: "maxConsolidationFailures",
 						group: "memory",
-						doc: "Consolidation failures one turn tolerates before the tool gives up."
+						doc: "Consolidation failures one turn tolerates before the tool gives up.",
+						label: "合并失败容忍次数",
+						hint: "一轮内合并失败多少次后工具放弃。",
+						control: "number",
+						unit: "次",
+						values: []
 					}
 				]
 			},
@@ -103,37 +183,76 @@ window.__ModuleLoader__.load({
 					{
 						id: "reviewSkillInterval",
 						group: "review",
-						doc: "Activity units between skill-review injections."
+						doc: "Activity units between skill-review injections.",
+						label: "技能审查间隔",
+						hint: "每多少活动单位触发一次技能审查注入。",
+						control: "number",
+						unit: "次",
+						values: []
 					},
 					{
 						id: "reviewMemoryInterval",
 						group: "review",
-						doc: "Activity units between memory-review injections."
+						doc: "Activity units between memory-review injections.",
+						label: "记忆审查间隔",
+						hint: "每多少活动单位触发一次记忆审查注入。",
+						control: "number",
+						unit: "次",
+						values: []
 					},
 					{
 						id: "skillReviewTrigger",
 						group: "review",
-						doc: "Which channel may inject a skill review (cadence, completion, both)."
+						doc: "Which channel may inject a skill review (cadence, completion, both).",
+						label: "审查触发通道",
+						hint: "哪个通道可以注入技能审查：cadence＝按间隔、completion＝按完成、both＝两者。",
+						control: "select",
+						unit: "",
+						values: [
+							"cadence",
+							"completion",
+							"both"
+						]
 					},
 					{
 						id: "skillReviewCompletionMinToolCalls",
 						group: "review",
-						doc: "Tool calls a task needs before the completion channel injects."
+						doc: "Tool calls a task needs before the completion channel injects.",
+						label: "完成通道最少工具调用",
+						hint: "走完成通道时，任务至少经过多少次工具调用才注入。",
+						control: "number",
+						unit: "次",
+						values: []
 					},
 					{
 						id: "reviewEnabled",
 						group: "review",
-						doc: "Master switch for the review plugin."
+						doc: "Master switch for the review plugin.",
+						label: "启用审查插件",
+						hint: "审查插件的总开关。",
+						control: "switch",
+						unit: "",
+						values: []
 					},
 					{
 						id: "reviewMode",
 						group: "review",
-						doc: "Run the review in the parent session (inject) or on a subagent."
+						doc: "Run the review in the parent session (inject) or on a subagent.",
+						label: "审查运行方式",
+						hint: "inject＝在父会话内注入，subagent＝交给子代理运行。",
+						control: "select",
+						unit: "",
+						values: ["subagent", "inject"]
 					},
 					{
 						id: "reviewWakeInject",
 						group: "review",
-						doc: "Deliver the deferred review as a waking follow-up message."
+						doc: "Deliver the deferred review as a waking follow-up message.",
+						label: "审查后续唤醒注入",
+						hint: "把延后的审查作为唤醒消息投递。",
+						control: "switch",
+						unit: "",
+						values: []
 					}
 				]
 			},
@@ -143,42 +262,82 @@ window.__ModuleLoader__.load({
 					{
 						id: "skillContentChars",
 						group: "write-caps",
-						doc: "Character cap on a SKILL.md body (tighten-only)."
+						doc: "Character cap on a SKILL.md body (tighten-only).",
+						label: "SKILL.md 正文字符上限",
+						hint: "SKILL.md 正文的字符上限（只许收紧）。",
+						control: "number",
+						unit: "字符",
+						values: []
 					},
 					{
 						id: "maxSkillFileBytes",
 						group: "write-caps",
-						doc: "Byte cap on one support file (tighten-only)."
+						doc: "Byte cap on one support file (tighten-only).",
+						label: "支持文件字节上限",
+						hint: "单个支持文件的字节上限（只许收紧）。",
+						control: "number",
+						unit: "字节",
+						values: []
 					},
 					{
 						id: "maxSkillNameLength",
 						group: "write-caps",
-						doc: "Character cap on a skill name (tighten-only)."
+						doc: "Character cap on a skill name (tighten-only).",
+						label: "技能名字符上限",
+						hint: "技能名的字符上限（只许收紧）。",
+						control: "number",
+						unit: "字符",
+						values: []
 					},
 					{
 						id: "maxDescriptionLength",
 						group: "write-caps",
-						doc: "Character cap on a skill description (tighten-only)."
+						doc: "Character cap on a skill description (tighten-only).",
+						label: "技能描述字符上限",
+						hint: "技能描述的字符上限（只许收紧）。",
+						control: "number",
+						unit: "字符",
+						values: []
 					},
 					{
 						id: "descriptionStrict",
 						group: "write-caps",
-						doc: "Refuse a description over the authoring bar instead of advising."
+						doc: "Refuse a description over the authoring bar instead of advising.",
+						label: "描述严格档",
+						hint: "描述超过写作门槛时拒绝写入，而不是只提示。",
+						control: "switch",
+						unit: "",
+						values: []
 					},
 					{
 						id: "strictCrossSource",
 						group: "write-caps",
-						doc: "Refuse writes whose catalog entry resolves outside the family."
+						doc: "Refuse writes whose catalog entry resolves outside the family.",
+						label: "跨源严格档",
+						hint: "目录项解析到家族之外时拒绝写入。",
+						control: "switch",
+						unit: "",
+						values: []
 					},
 					{
 						id: "citationPolicy",
 						group: "write-caps",
-						doc: "Refuse a move that would leave a dangling reference, or verify it."
+						doc: "Refuse a move that would leave a dangling reference, or verify it.",
+						label: "引用校验档",
+						hint: "移动或合并时对引用的处置：verify＝校验、refuse＝直接拒绝。",
+						control: "select",
+						unit: "",
+						values: ["verify", "refuse"]
 					},
 					{
 						id: "supportFileCharPolicy",
 						group: "write-caps",
-						doc: "Warn about an oversize support file, or refuse the write."
+						doc: "Warn about an oversize support file, or refuse the write.",
+						label: "支持文件超限档",
+						hint: "支持文件超出字符上限时：report＝只报告、enforce＝拒写。",
+						control: "select",
+						unit: "",
+						values: ["report", "enforce"]
 					}
 				]
 			},
@@ -187,11 +346,95 @@ window.__ModuleLoader__.load({
 				fields: [{
 					id: "entryPreviewChars",
 					group: "memory",
-					doc: "Characters of one memory entry shown in a tool result preview."
+					doc: "Characters of one memory entry shown in a tool result preview.",
+					label: "条目预览字符数",
+					hint: "单条记忆预览保留多少字符。",
+					control: "number",
+					unit: "字符",
+					values: []
 				}]
 			}
 		];
 		//#endregion
+		//#region src/client/messages.ts
+		/**
+		* Copy for the evolution settings section and its parameter cards.
+		*
+		* The section is registered through the platform's locale seat (`ctx.locale`),
+		* which is the same route the other out-of-repo client plugins take. The earlier
+		* note in this package's README — that an outside package cannot bind the locale
+		* seat — is wrong: `locale.register(namespace, { zh, en })` is the documented
+		* call, and it is what makes the section title and its copy follow the UI
+		* language instead of shipping one hard-coded dictionary.
+		*/
+		/** Locale namespace this bundle registers. */
+		const NS = "evolution-settings";
+		/** Chinese copy (the family's primary language). */
+		const zh = {
+			title: "自进化",
+			subtitle: "审查／记忆／策展／技能四个命名空间的参数可在用户层覆盖；此处只列可改项，其余仍由部署面决定。",
+			overridden: "用户",
+			deployment: "部署",
+			loading: "正在读取设置文档…",
+			unavailable: "这个命名空间没有宿主提供服务（对应插件行未挂载）",
+			readonly: "本次会话的设置文档是只读的（内存模式）",
+			apply: "保存",
+			reset: "恢复部署默认",
+			empty: "这个命名空间没有可改项",
+			changed: "{n} 项已改",
+			discard: "放弃修改",
+			saving: "保存中…",
+			refused: "写入未被接受——宿主的校验拒绝了它（值保持原样）。原因见 /evolution params 或 /evolution doctor。",
+			cardReview: "审查",
+			cardMemory: "记忆",
+			cardToolMemory: "记忆工具",
+			cardCurator: "策展",
+			cardSkills: "技能"
+		};
+		/** English copy, key for key with {@link zh}. */
+		const en = {
+			title: "Self-evolution",
+			subtitle: "Parameters of the review, memory, curation and skill namespaces may be overridden per user; only the writable ones are listed here, everything else still comes from the deployment.",
+			overridden: "user",
+			deployment: "deployment",
+			loading: "reading the settings document…",
+			unavailable: "this namespace is not served by the Host (its owning plugin row is not mounted)",
+			readonly: "the settings document is read-only in this session (memory mode)",
+			apply: "Save",
+			reset: "Reset to deployment",
+			empty: "no writable field in this namespace",
+			changed: "{n} changed",
+			discard: "Discard",
+			saving: "Saving…",
+			refused: "The write was not accepted — the Host refused it and the value is unchanged. See /evolution params or /evolution doctor for the reason.",
+			cardReview: "Review",
+			cardMemory: "Memory",
+			cardToolMemory: "Memory tools",
+			cardCurator: "Curation",
+			cardSkills: "Skills"
+		};
+		/**
+		* Card titles per settings namespace. A namespace without an entry falls back to
+		* its raw name, so a Host that registers a new namespace still renders — the
+		* title is presentation, the namespace is the join key.
+		*/
+		const NAMESPACE_TITLES = Object.freeze({
+			"evolution-review": "cardReview",
+			"evolution-memory": "cardMemory",
+			"evolution-tool-memory": "cardToolMemory",
+			"evolution-curator": "cardCurator",
+			"evolution-skills": "cardSkills"
+		});
+		/**
+		* Resolve one message without the locale seat (tests and the fallback path).
+		* @param key - the message key.
+		* @param language - which dictionary to read; defaults to Chinese.
+		* @returns the copy this bundle carries.
+		*/
+		function message(key, language = "zh") {
+			return language === "zh" ? zh[key] : en[key];
+		}
+		//#endregion
 		//#region src/client/ParamCard.ts
 		/**
 		* One namespace's parameter card.
@@ -199,48 +442,106 @@ window.__ModuleLoader__.load({
 		* Structural local types on purpose: this package is distributed outside the
 		* platform repository and a value import of another plugin is forbidden, so the
 		* settings scope and its snapshot are declared by the shape the renderer hands
-		* over (`getSnapshot`/`subscribe`, status/value/user/writable).
+		* over (\`getSnapshot\`/\`subscribe\`, status/value/user/writable).
+		*
+		* Layout and behaviour follow the platform's own settings fields: a collapsed card
+		* header (namespace title, change count, chevron), then one block per field —
+		* label with its unit and source chip, a control HOLDING THE CURRENT VALUE, the
+		* Chinese hint — and one 放弃修改/保存 pair at the card's foot. The control is
+		* typed from the registry (\`control\`), so booleans are switches, enums are
+		* selects and numbers are numeric inputs with the unit shown beside the label.
 		*/
-		/** One cell's text: absent reads as a dash, containers as JSON. */
+		/** One cell's text: absent reads as an empty control, containers as JSON. */
 		function format(value) {
-			if (value === void 0) return "—";
+			if (value === void 0) return "";
 			if (typeof value === "string") return value;
 			return JSON.stringify(value);
 		}
-		/** Parse one typed value the way the command surface does: JSON, else raw text. */
-		function parse(draft) {
-			const text = draft.trim();
+		/**
+		* Parse one edited value into what the scope should receive.
+		* @param control - the registry's control kind for the field.
+		* @param text - the text the operator left in the control.
+		* @returns the value handed to \`set\`; a string stays raw so the Host's own
+		*   validation produces the error message the operator reads.
+		*/
+		function parseFor(control, text) {
+			const trimmed = text.trim();
+			if (control === "switch") return trimmed === "true";
+			if (control === "number") {
+				const parsed = Number(trimmed);
+				return trimmed !== "" && Number.isFinite(parsed) ? parsed : trimmed;
+			}
 			try {
-				return JSON.parse(text);
+				return JSON.parse(trimmed);
 			} catch {
-				return text;
+				return trimmed;
 			}
 		}
 		/** Whether a value is a plain section object. */
 		function isSection(value) {
 			return typeof value === "object" && value !== null && !Array.isArray(value);
 		}
-		/** One parameter row: current value, source badge, write and reset controls. */
-		function FieldRow(props) {
-			const [draft, setDraft] = (0, react.useState)("");
-			return (0, react.createElement)("div", { className: "evolution-param-row" }, (0, react.createElement)("code", null, props.field.id), (0, react.createElement)("span", { className: "evolution-param-value" }, format(props.value)), (0, react.createElement)("span", { className: "evolution-param-source" }, props.overridden ? props.t("overridden") : props.t("deployment")), (0, react.createElement)("input", {
-				value: draft,
+		/** Let the settings store settle one write before the read-back (it batches updates). */
+		async function settle() {
+			await new Promise((done) => {
+				setTimeout(done, 60);
+			});
+		}
+		/** One field's control, typed from the registry. */
+		function FieldControl(props) {
+			const { field, text } = props;
+			const common = {
+				id: "evolution-param-" + field.id,
 				disabled: props.disabled,
-				placeholder: props.field.doc,
+				className: "evolution-param-input"
+			};
+			if (field.control === "switch") return (0, react.createElement)("input", {
+				...common,
+				className: "evolution-param-check",
+				type: "checkbox",
+				checked: text === "true",
 				onChange: (event) => {
-					setDraft(event.target.value);
+					props.onChange(field.id, String(event.target.checked));
 				}
-			}), (0, react.createElement)("button", {
-				disabled: props.disabled || draft.trim() === "",
-				onClick: () => {
-					props.write(props.field.id, parse(draft));
+			});
+			if (field.control === "select") return (0, react.createElement)("select", {
+				...common,
+				className: "evolution-param-select",
+				value: text,
+				onChange: (event) => {
+					props.onChange(field.id, event.target.value);
+				}
+			}, [field.values.includes(text) || text === "" ? null : (0, react.createElement)("option", {
+				key: text,
+				value: text
+			}, text), ...field.values.map((value) => (0, react.createElement)("option", {
+				key: value,
+				value
+			}, value))]);
+			return (0, react.createElement)("input", {
+				...common,
+				type: field.control === "number" ? "number" : "text",
+				value: text,
+				onChange: (event) => {
+					props.onChange(field.id, event.target.value);
 				}
-			}, props.t("apply")), props.overridden ? (0, react.createElement)("button", {
+			});
+		}
+		/** One parameter field: label, control, hint, and its reset-to-deployment action. */
+		function FieldBlock(props) {
+			const { field, t } = props;
+			const unit = field.unit === "" ? null : (0, react.createElement)("span", { className: "evolution-param-unit" }, "（" + field.unit + "）");
+			return (0, react.createElement)("div", { className: "evolution-param-field" }, (0, react.createElement)("div", { className: "evolution-param-label" }, (0, react.createElement)("label", { htmlFor: "evolution-param-" + field.id }, field.label === "" ? field.id : field.label), unit, (0, react.createElement)("span", {
+				className: "evolution-param-source",
+				"data-user": props.overridden ? "true" : "false"
+			}, props.overridden ? t("overridden") : t("deployment"))), FieldControl(props), (0, react.createElement)("p", { className: "evolution-param-hint" }, field.hint === "" ? field.doc : field.hint), props.overridden ? (0, react.createElement)("div", { className: "evolution-param-actions" }, (0, react.createElement)("button", {
+				type: "button",
+				className: "evolution-param-button",
 				disabled: props.disabled,
 				onClick: () => {
-					props.clear(props.field.id);
+					props.clear(field.id);
 				}
-			}, props.t("reset")) : null);
+			}, t("reset"))) : null);
 		}
 		/**
 		* Render one namespace's card.
@@ -248,78 +549,246 @@ window.__ModuleLoader__.load({
 		* @returns the card.
 		*/
 		function ParamCard(props) {
-			const { t, fields, write, clear } = props;
+			const { t, fields, write, clear, namespace } = props;
+			const [open, setOpen] = (0, react.useState)(false);
+			const [draft, setDraft] = (0, react.useState)({});
+			const [busy, setBusy] = (0, react.useState)(false);
+			const [error, setError] = (0, react.useState)("");
 			const snapshot = props.useParamSection((state) => state);
-			if (snapshot.status === "loading") return (0, react.createElement)("p", null, t("loading"));
-			if (snapshot.status === "unavailable") return (0, react.createElement)("p", null, t("unavailable"));
+			if (snapshot.status === "loading") return (0, react.createElement)("p", { className: "evolution-param-note" }, t("loading"));
+			if (snapshot.status === "unavailable") return (0, react.createElement)("p", { className: "evolution-param-note" }, t("unavailable"));
 			const user = isSection(snapshot.user) ? snapshot.user : {};
 			const value = isSection(snapshot.value) ? snapshot.value : {};
 			const disabled = !snapshot.writable;
-			return (0, react.createElement)("section", { className: "evolution-params" }, (0, react.createElement)("h4", null, t("title") + " — " + props.namespace), disabled ? (0, react.createElement)("p", null, t("readonly")) : null, fields.length === 0 ? (0, react.createElement)("p", null, t("empty")) : fields.map((field) => (0, react.createElement)(FieldRow, {
+			const titleKey = NAMESPACE_TITLES[namespace];
+			const title = titleKey === void 0 ? namespace : t(titleKey);
+			const changed = fields.filter((field) => Object.hasOwn(user, field.id)).length;
+			const textOf = (field) => draft[field.id] ?? format(value[field.id]);
+			const dirty = fields.filter((field) => draft[field.id] !== void 0 && draft[field.id] !== format(value[field.id]));
+			const change = (id, next) => {
+				setDraft({
+					...draft,
+					[id]: next
+				});
+			};
+			const save = () => {
+				setBusy(true);
+				setError("");
+				(async () => {
+					try {
+						for (const field of dirty) await write(field.id, parseFor(field.control, textOf(field)));
+						let landed = isSection(props.hooks.paramSection.getSnapshot().user) ? props.hooks.paramSection.getSnapshot().user : {};
+						for (let attempt = 0; attempt < 4 && dirty.some((field) => !Object.hasOwn(landed, field.id)); attempt += 1) {
+							await settle();
+							const fresh = props.hooks.paramSection.getSnapshot();
+							landed = isSection(fresh.user) ? fresh.user : {};
+						}
+						if (dirty.some((field) => !Object.hasOwn(landed, field.id))) {
+							setError(t("refused"));
+							return;
+						}
+						setDraft({});
+					} catch (caught) {
+						setError(caught instanceof Error && caught.message !== "" ? caught.message : t("refused"));
+					} finally {
+						setBusy(false);
+					}
+				})();
+			};
+			return (0, react.createElement)("section", { className: "evolution-param-card" }, (0, react.createElement)("button", {
+				type: "button",
+				className: "evolution-param-head",
+				"aria-expanded": open ? "true" : "false",
+				onClick: () => {
+					setOpen(!open);
+				}
+			}, (0, react.createElement)("span", { className: "evolution-param-card-title" }, title), changed === 0 ? null : (0, react.createElement)("span", { className: "evolution-param-count" }, t("changed").replace("{n}", String(changed))), (0, react.createElement)("span", { className: "evolution-param-chevron" }, open ? "▲" : "▼")), open ? (0, react.createElement)("div", { className: "evolution-param-body" }, disabled ? (0, react.createElement)("p", { className: "evolution-param-note" }, t("readonly")) : null, fields.length === 0 ? (0, react.createElement)("p", { className: "evolution-param-note" }, t("empty")) : fields.map((field) => (0, react.createElement)(FieldBlock, {
 				key: field.id,
 				field,
-				value: value[field.id],
+				text: textOf(field),
 				overridden: Object.hasOwn(user, field.id),
 				disabled,
 				t,
-				write,
+				onChange: change,
 				clear
-			})));
+			})), error === "" ? null : (0, react.createElement)("p", { className: "evolution-param-error" }, error), fields.length === 0 ? null : (0, react.createElement)("div", { className: "evolution-param-footer" }, (0, react.createElement)("button", {
+				type: "button",
+				className: "evolution-param-button",
+				disabled: busy || dirty.length === 0,
+				onClick: () => {
+					setDraft({});
+					setError("");
+				}
+			}, t("discard")), (0, react.createElement)("button", {
+				type: "button",
+				className: "evolution-param-button",
+				"data-primary": "true",
+				disabled: disabled || busy || dirty.length === 0,
+				onClick: save
+			}, busy ? t("saving") : t("apply")))) : null);
 		}
 		//#endregion
-		//#region src/client/messages.ts
+		//#region src/client/seam.ts
+		/** Our card slot, hosted by the section this bundle registers. */
+		const CARD_SLOT = "evolution.namespace.card";
+		//#endregion
+		//#region src/client/SettingsSection.ts
 		/**
-		* Copy for the evolution parameter cards.
+		* The section shell: title, one-line explanation, then one card per namespace.
 		*
-		* The bundle carries its own dictionary: this package is distributed outside the
-		* platform repository, whose typed locale seats are declared per in-repo
-		* namespace. Components never inline a string — the card receives `t` through its
-		* inject face, which is where a locale-service binding would plug in later.
+		* This is the shape the platform's own settings sections use — a heading plus the
+		* child slots it declared in its registration. The cards themselves are separate
+		* registrations keyed by namespace, so a namespace the Host does not serve simply
+		* renders nothing and a deployment that drops this row loses the whole section.
+		* @module @lmzhen/dsh-evolution-settings-ui/client
 		*/
-		/** Message keys the cards render. */
-		const MESSAGES = {
-			title: "Evolution parameters",
-			overridden: "user override",
-			deployment: "deployment value",
-			loading: "reading the settings document…",
-			unavailable: "this namespace is not served by the Host (its owning plugin row is not mounted)",
-			readonly: "the settings document is read-only in this session (memory mode)",
-			apply: "Apply",
-			reset: "Reset to deployment",
-			empty: "no writable field in this namespace"
-		};
 		/**
-		* Resolve one message.
-		* @param key - the message key.
-		* @returns the copy this bundle carries.
+		* Render the section.
+		* @param face - the shell's inject face: translator and child-slot renderer.
+		* @returns the section element.
+		*/
+		function SettingsSection(face) {
+			return (0, react.createElement)("div", { className: "evolution-params" }, (0, react.createElement)("h2", { className: "evolution-params-title" }, face.t("title")), (0, react.createElement)("p", { className: "evolution-params-subtitle" }, face.t("subtitle")), ...CLIENT_PARAM_SECTIONS.map((section_) => (0, react.createElement)("div", {
+				key: section_.namespace,
+				className: "evolution-params-group"
+			}, face.renderSlot(CARD_SLOT, {}, { entryKey: section_.namespace }))));
+		}
+		//#endregion
+		//#region src/client/styles.ts
+		/**
+		* The section's stylesheet.
+		*
+		* The platform's own client bundles compile CSS Modules into a string and inject
+		* it once behind a \`<style data-plugin-css="<pkg>/<file>">\` tag; this bundle is
+		* built outside that pipeline, so it carries its own string and injects it the
+		* same way. Every rule reads the platform's design tokens (\`--dsw-alias-*\`), so
+		* the section follows the light and dark themes without owning a colour, and the
+		* field metrics (12px/6px padding-gap, 13px label, 12px hint) match the ones the
+		* platform's own settings fields use.
+		* @module @lmzhen/dsh-evolution-settings-ui/client
 		*/
-		function message(key) {
-			return MESSAGES[key];
+		/** Tag id that makes the injection idempotent. */
+		const CSS_TAG_ID = "@lmzhen/dsh-evolution-settings-ui/settings.css";
+		/** The stylesheet the section injects once. */
+		const CSS = [
+			".evolution-params{display:flex;flex-direction:column}",
+			".evolution-params-title{margin:0 0 4px;color:var(--dsw-alias-label-primary);font-size:16px;font-weight:600;line-height:1.5}",
+			".evolution-params-subtitle{margin:0 0 16px;color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:1.5}",
+			".evolution-param-card{border:.5px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-layer-1);margin-bottom:12px}",
+			".evolution-param-head{display:flex;align-items:center;gap:8px;width:100%;padding:12px 14px;background:none;border:0;text-align:left;cursor:pointer;color:inherit;font:inherit}",
+			".evolution-param-head:hover{background:var(--dsw-alias-interactive-bg-hover)}",
+			".evolution-param-card-title{flex:1;min-width:0;color:var(--dsw-alias-label-primary);font-size:13px;font-weight:500;line-height:1.5}",
+			".evolution-param-count{color:var(--dsw-alias-brand-primary);font-size:12px;line-height:1.5}",
+			".evolution-param-chevron{color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:1.5}",
+			".evolution-param-body{padding:0 14px 12px;border-top:.5px solid var(--dsw-alias-border-l3)}",
+			".evolution-param-field{display:flex;flex-direction:column;gap:6px;padding:12px 0}",
+			".evolution-param-field+.evolution-param-field{border-top:.5px solid var(--dsw-alias-border-l4)}",
+			".evolution-param-label{display:flex;align-items:center;gap:6px;color:var(--dsw-alias-label-primary);font-size:13px;font-weight:500;line-height:1.5}",
+			".evolution-param-unit{color:var(--dsw-alias-label-tertiary);font-weight:400}",
+			".evolution-param-hint{margin:0;color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:1.5}",
+			".evolution-param-value{color:var(--dsw-alias-label-secondary);font-size:12px;line-height:1.5}",
+			".evolution-param-input{width:100%;box-sizing:border-box;padding:8px 10px;border:.5px solid var(--dsw-alias-border-l2);border-radius:6px;background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);font-size:13px;line-height:1.5}",
+			".evolution-param-input:focus{outline:none;border-color:var(--dsw-alias-brand-primary)}",
+			".evolution-param-input:disabled{color:var(--dsw-alias-label-dimmed);cursor:default}",
+			".evolution-param-source{display:inline-flex;align-items:center;height:20px;padding:0 6px;border-radius:4px;background:var(--dsw-alias-bg-layer-3);color:var(--dsw-alias-label-secondary);font-size:12px;line-height:20px}",
+			".evolution-param-source[data-user=\"true\"]{background:var(--dsw-alias-brand-primary);color:var(--dsw-alias-label-primary-foreground)}",
+			".evolution-param-actions{display:flex;justify-content:flex-end;gap:8px;padding-top:12px}",
+			".evolution-param-button{padding:6px 12px;border:.5px solid var(--dsw-alias-border-l2);border-radius:6px;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);font-size:13px;line-height:1.5;cursor:pointer}",
+			".evolution-param-button:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}",
+			".evolution-param-button[data-primary=\"true\"]{background:var(--dsw-alias-button-primary-fill);color:var(--dsw-alias-label-primary-foreground);border-color:transparent}",
+			".evolution-param-button[data-primary=\"true\"]:hover:not(:disabled){background:var(--dsw-alias-button-primary-hover)}",
+			".evolution-param-button:disabled{color:var(--dsw-alias-label-dimmed);cursor:default}",
+			".evolution-param-select{width:100%;box-sizing:border-box;padding:8px 10px;border:.5px solid var(--dsw-alias-border-l2);border-radius:6px;background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);font-size:13px;line-height:1.5}",
+			".evolution-param-select:focus{outline:none;border-color:var(--dsw-alias-brand-primary)}",
+			".evolution-param-select:disabled{color:var(--dsw-alias-label-dimmed);cursor:default}",
+			".evolution-param-check{width:16px;height:16px;margin:0;accent-color:var(--dsw-alias-brand-primary);cursor:pointer}",
+			".evolution-param-check:disabled{cursor:default;opacity:.5}",
+			".evolution-param-footer{display:flex;justify-content:flex-end;gap:8px;padding:12px 0 0;border-top:.5px solid var(--dsw-alias-border-l3)}",
+			".evolution-param-note{margin:0;color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:1.5}",
+			".evolution-param-error{margin:0;color:var(--dsw-alias-state-error-primary);font-size:12px;line-height:1.5}"
+		].join("");
+		/**
+		* Inject the stylesheet once per document.
+		* @param host - the document to inject into; defaults to the global one.
+		*/
+		function injectStyles(host) {
+			const doc = host ?? globalThis.document;
+			if (doc === void 0) return;
+			if (doc.querySelector("style[data-plugin-css=\"@lmzhen/dsh-evolution-settings-ui/settings.css\"]") !== null) return;
+			const tag = doc.createElement("style");
+			tag.dataset.plugin = "@lmzhen/dsh-evolution-settings-ui";
+			tag.dataset.pluginCss = CSS_TAG_ID;
+			tag.textContent = CSS;
+			doc.head.appendChild(tag);
 		}
 		//#endregion
 		//#region src/client/index.ts
-		/** Required client services: the slot registry and the settings transport. */
-		const inject = ["slots", "settingsScope"];
+		/** Required client services: the slot registry, the settings transport, the locale seat. */
+		const inject = [
+			"slots",
+			"settingsScope",
+			"locale"
+		];
+		/** Section id and nav order (the platform's own sections sit at 0/10/15/20). */
+		const SECTION_ID = "evolution";
+		const SECTION_ORDER = 25;
 		/**
-		* Register one card per generated namespace section.
+		* Register the locale namespace, the section and its cards.
 		* @param ctx - client cordis context.
 		*/
 		function apply(ctx) {
+			injectStyles();
 			const seam = ctx;
-			seam.slots.inject("settings.plugin.item", function* () {
+			let registered = false;
+			ctx.effect(() => {
+				try {
+					const dispose = seam.locale.register(NS, {
+						zh,
+						en
+					});
+					registered = true;
+					return dispose;
+				} catch {
+					return () => {};
+				}
+			}, "evolution-settings: dictionaries");
+			let bound = null;
+			const t = (key) => {
+				if (!registered) return message(key);
+				if (bound === null) try {
+					bound = seam.locale.bind(NS);
+				} catch {
+					return message(key);
+				}
+				return bound(key);
+			};
+			seam.slots.inject("settings.section", function* () {
+				yield seam.slots.register({
+					name: "settings.section",
+					id: SECTION_ID,
+					order: 25,
+					label: () => t("title"),
+					locale: NS,
+					children: { [CARD_SLOT]: {
+						kind: "keyed",
+						scope: "root"
+					} }
+				}, SettingsSection);
+			});
+			seam.slots.inject(CARD_SLOT, function* () {
 				for (const section of CLIENT_PARAM_SECTIONS) {
 					const scope = seam.settingsScope.bind({ namespace: section.namespace });
 					const source = scope;
 					const face = () => ({
 						namespace: section.namespace,
 						fields: section.fields,
-						t: (key) => message(key),
+						t,
 						write: (field, value) => scope.set(field, value),
 						clear: (field) => scope.unset(field),
 						hooks: { paramSection: source }
 					});
 					yield seam.slots.register({
-						name: "settings.plugin.item",
+						name: CARD_SLOT,
 						key: section.namespace,
 						inject: face
 					}, ParamCard);
@@ -327,6 +796,8 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
+		exports.SECTION_ID = SECTION_ID;
+		exports.SECTION_ORDER = SECTION_ORDER;
 		exports.apply = apply;
 		exports.inject = inject;
 

package/lib/types/client/ParamCard.d.ts

@@ -4,11 +4,18 @@
  * Structural local types on purpose: this package is distributed outside the
  * platform repository and a value import of another plugin is forbidden, so the
  * settings scope and its snapshot are declared by the shape the renderer hands
- * over (`getSnapshot`/`subscribe`, status/value/user/writable).
+ * over (\`getSnapshot\`/\`subscribe\`, status/value/user/writable).
+ *
+ * Layout and behaviour follow the platform's own settings fields: a collapsed card
+ * header (namespace title, change count, chevron), then one block per field —
+ * label with its unit and source chip, a control HOLDING THE CURRENT VALUE, the
+ * Chinese hint — and one 放弃修改/保存 pair at the card's foot. The control is
+ * typed from the registry (\`control\`), so booleans are switches, enums are
+ * selects and numbers are numeric inputs with the unit shown beside the label.
  */
 import { type ReactNode } from 'react';
 import type { ClientParamField } from './generated-params.ts';
-import type { MessageKey } from './messages.ts';
+import { type MessageKey } from './messages.ts';
 import type { ParamSectionSnapshot, ParamSectionSource } from './seam.ts';
 /** Injected face: plain data and callbacks, plus the hook seat. */
 export interface ParamCardFace {
@@ -23,7 +30,7 @@ export interface ParamCardFace {
 }
 /** Props the renderer binds for one card: the inject face plus its hook seat. */
 export type ParamCardProps = ParamCardFace & {
-    /** Bound from `hooks.paramSection` by the renderer. */
+    /** Bound from \`hooks.paramSection\` by the renderer. */
     readonly useParamSection: <T>(selector: (state: ParamSectionSnapshot) => T) => T;
 };
 /**

package/lib/types/client/SettingsSection.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The section shell: title, one-line explanation, then one card per namespace.
+ *
+ * This is the shape the platform's own settings sections use — a heading plus the
+ * child slots it declared in its registration. The cards themselves are separate
+ * registrations keyed by namespace, so a namespace the Host does not serve simply
+ * renders nothing and a deployment that drops this row loses the whole section.
+ * @module @lmzhen/dsh-evolution-settings-ui/client
+ */
+import { type ReactNode } from 'react';
+import { type SectionFace } from './seam.ts';
+/**
+ * Render the section.
+ * @param face - the shell's inject face: translator and child-slot renderer.
+ * @returns the section element.
+ */
+export declare function SettingsSection(face: SectionFace): ReactNode;
+//# sourceMappingURL=SettingsSection.d.ts.map

package/lib/types/client/generated-params.d.ts

@@ -8,8 +8,18 @@
 export interface ClientParamField {
     id: string;
     group: string;
-    /** The registry summary, used as the field help text. */
+    /** The registry summary (English), kept for parity with PARAMETERS.md. */
     doc: string;
+    /** Card label, from the registry UI tail (Chinese). */
+    label: string;
+    /** Card help text, from the registry UI tail (Chinese). */
+    hint: string;
+    /** Which control the card renders. */
+    control: 'number' | 'switch' | 'select' | 'text';
+    /** Unit suffix for a number field ('' when it carries none). */
+    unit: string;
+    /** Allowed values for a select field ([] otherwise). */
+    values: readonly string[];
 }
 /** One card: the settings namespace plus the fields it exposes. */
 export interface ClientParamSection {

package/lib/types/client/index.d.ts

@@ -1,18 +1,28 @@
 /**
- * Browser half: one card per settings namespace the family registers.
+ * Browser half: one settings section ("自进化") hosting one card per namespace.
  *
- * The join key is the namespace itself — the Host half of each owning plugin
- * registers it, this half claims it in the keyed `settings.plugin.item` slot, and
- * the configuration tab pairs them. A namespace the Host does not serve renders
- * nothing, and a deployment that drops this row shows no cards at all: the pair
- * carries no Host-side behaviour.
+ * Until 0.7.0 the cards lived inside the platform's own 插件 section, because
+ * this bundle injected `@deepseek-ai/dsh-client-ui-settings-plugins` and claimed
+ * its keyed `settings.plugin.item` slot. The parameters are not a plugin
+ * inventory though — the other feature areas (market, skins, Web plugins, side
+ * cards) each register their OWN section, so this bundle now does the same:
+ * inject the settings shell, register `settings.section`, and host the cards in
+ * a keyed child slot of that section.
+ *
+ * The join key is still the namespace itself: the Host half of each owning plugin
+ * registers it, this half claims it in the keyed card slot, and the section pairs
+ * them. A namespace the Host does not serve renders nothing, and a deployment that
+ * drops this row shows no section at all: the pair carries no Host-side behaviour.
  * @module @lmzhen/dsh-evolution-settings-ui/client
  */
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
-/** Required client services: the slot registry and the settings transport. */
+/** Required client services: the slot registry, the settings transport, the locale seat. */
 export declare const inject: string[];
+/** Section id and nav order (the platform's own sections sit at 0/10/15/20). */
+export declare const SECTION_ID = "evolution";
+export declare const SECTION_ORDER = 25;
 /**
- * Register one card per generated namespace section.
+ * Register the locale namespace, the section and its cards.
  * @param ctx - client cordis context.
  */
 export declare function apply(ctx: ClientContext): void;

package/lib/types/client/messages.d.ts

@@ -1,29 +1,52 @@
 /**
- * Copy for the evolution parameter cards.
+ * Copy for the evolution settings section and its parameter cards.
  *
- * The bundle carries its own dictionary: this package is distributed outside the
- * platform repository, whose typed locale seats are declared per in-repo
- * namespace. Components never inline a string — the card receives `t` through its
- * inject face, which is where a locale-service binding would plug in later.
+ * The section is registered through the platform's locale seat (`ctx.locale`),
+ * which is the same route the other out-of-repo client plugins take. The earlier
+ * note in this package's README — that an outside package cannot bind the locale
+ * seat — is wrong: `locale.register(namespace, { zh, en })` is the documented
+ * call, and it is what makes the section title and its copy follow the UI
+ * language instead of shipping one hard-coded dictionary.
  */
-/** Message keys the cards render. */
-export declare const MESSAGES: {
-    readonly title: "Evolution parameters";
-    readonly overridden: "user override";
-    readonly deployment: "deployment value";
-    readonly loading: "reading the settings document…";
-    readonly unavailable: "this namespace is not served by the Host (its owning plugin row is not mounted)";
-    readonly readonly: "the settings document is read-only in this session (memory mode)";
-    readonly apply: "Apply";
-    readonly reset: "Reset to deployment";
-    readonly empty: "no writable field in this namespace";
+/** Locale namespace this bundle registers. */
+export declare const NS = "evolution-settings";
+/** Chinese copy (the family's primary language). */
+export declare const zh: {
+    readonly title: "自进化";
+    readonly subtitle: "审查／记忆／策展／技能四个命名空间的参数可在用户层覆盖；此处只列可改项，其余仍由部署面决定。";
+    readonly overridden: "用户";
+    readonly deployment: "部署";
+    readonly loading: "正在读取设置文档…";
+    readonly unavailable: "这个命名空间没有宿主提供服务（对应插件行未挂载）";
+    readonly readonly: "本次会话的设置文档是只读的（内存模式）";
+    readonly apply: "保存";
+    readonly reset: "恢复部署默认";
+    readonly empty: "这个命名空间没有可改项";
+    readonly changed: "{n} 项已改";
+    readonly discard: "放弃修改";
+    readonly saving: "保存中…";
+    readonly refused: "写入未被接受——宿主的校验拒绝了它（值保持原样）。原因见 /evolution params 或 /evolution doctor。";
+    readonly cardReview: "审查";
+    readonly cardMemory: "记忆";
+    readonly cardToolMemory: "记忆工具";
+    readonly cardCurator: "策展";
+    readonly cardSkills: "技能";
 };
+/** English copy, key for key with {@link zh}. */
+export declare const en: Record<keyof typeof zh, string>;
+/**
+ * Card titles per settings namespace. A namespace without an entry falls back to
+ * its raw name, so a Host that registers a new namespace still renders — the
+ * title is presentation, the namespace is the join key.
+ */
+export declare const NAMESPACE_TITLES: Readonly<Record<string, string>>;
 /** One message key. */
-export type MessageKey = keyof typeof MESSAGES;
+export type MessageKey = keyof typeof zh;
 /**
- * Resolve one message.
+ * Resolve one message without the locale seat (tests and the fallback path).
  * @param key - the message key.
+ * @param language - which dictionary to read; defaults to Chinese.
  * @returns the copy this bundle carries.
  */
-export declare function message(key: MessageKey): string;
+export declare function message(key: MessageKey, language?: 'zh' | 'en'): string;
 //# sourceMappingURL=messages.d.ts.map

package/lib/types/client/seam.d.ts

@@ -4,11 +4,15 @@
  * The package is distributed OUTSIDE the platform repository, so it declares the
  * two seams it consumes instead of importing another plugin's values (forbidden
  * by the client bundle-purity rule) or its types (which would drag the platform
- * sources into this project). The shapes are the renderer's contract: a keyed
- * `settings.plugin.item` registration, the inject face it hands back, and the
- * per-namespace settings scope the write path fences with the revision it read.
+ * sources into this project). The shapes are the shell's contract: a
+ * `settings.section` registration hosting a keyed card slot, the inject faces
+ * both hand back, the per-namespace settings scope the write path fences with the
+ * revision it read, and the locale seat the section's copy resolves through.
  * @module @lmzhen/dsh-evolution-settings-ui/client
  */
+import type { ReactNode } from 'react';
+/** Our card slot, hosted by the section this bundle registers. */
+export declare const CARD_SLOT = "evolution.namespace.card";
 /** Snapshot of one settings namespace, as the client scope reports it. */
 export interface ParamSectionSnapshot {
     status: 'loading' | 'ready' | 'unavailable';
@@ -27,23 +31,58 @@ export interface SettingsScopeLike {
     set(field: string, value: unknown): Promise<void>;
     unset(field: string): Promise<void>;
 }
-/** Registration options the keyed slot takes. */
+/** Registration options the keyed card slot under our own section takes. */
 export interface SlotRegisterOptions {
-    name: 'settings.plugin.item';
+    name: typeof CARD_SLOT;
     /** The settings namespace this card edits — the slot's key. */
     key: string;
     inject: () => unknown;
 }
+/** Options a `settings.section` registration carries (the shell's own shape). */
+export interface SectionRegisterOptions {
+    name: 'settings.section';
+    /** Section id; the shell derives the nav entry's DOM id from it. */
+    id: string;
+    /** Nav order: the platform's own sections sit at 0/10/15/20. */
+    order: number;
+    /** Lazy label: the shell re-reads it when the locale changes. */
+    label: () => string;
+    /** Locale namespace the label and the section's copy resolve through. */
+    locale: string;
+    /** Child slots this section hosts, declared for the shell's renderer. */
+    children?: Record<string, {
+        kind: 'keyed' | 'list' | 'single';
+        scope: 'root';
+    }>;
+}
+/**
+ * The face the shell hands a section component: a translator bound to our locale
+ * namespace and the renderer for the child slots we declared.
+ */
+export interface SectionFace {
+    t: (key: string) => string;
+    /** Render one child slot; `filter` selects keyed entries (e.g. `{ entryKey }`). */
+    renderSlot: (name: string, props?: Record<string, unknown>, filter?: Record<string, unknown>) => ReactNode;
+}
+/** The locale seat: register this bundle's namespace, bind a translator. */
+export interface LocaleSeat {
+    register(namespace: string, dictionaries: {
+        zh: Record<string, string>;
+        en: Record<string, string>;
+    }): () => void;
+    bind(namespace: string): (key: string) => string;
+}
 /** The slice of the client context this plugin consumes. */
 export interface ClientSeam {
     slots: {
         inject(name: string, callback: () => Generator<unknown, void, unknown>): unknown;
-        register(options: SlotRegisterOptions, component: (props: never) => unknown): () => void;
+        register(options: SlotRegisterOptions | SectionRegisterOptions, component: (props: never) => unknown): () => void;
     };
     settingsScope: {
         bind(spec: {
             namespace: string;
         }): SettingsScopeLike;
     };
+    locale: LocaleSeat;
 }
 //# sourceMappingURL=seam.d.ts.map

package/lib/types/client/styles.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The section's stylesheet.
+ *
+ * The platform's own client bundles compile CSS Modules into a string and inject
+ * it once behind a \`<style data-plugin-css="<pkg>/<file>">\` tag; this bundle is
+ * built outside that pipeline, so it carries its own string and injects it the
+ * same way. Every rule reads the platform's design tokens (\`--dsw-alias-*\`), so
+ * the section follows the light and dark themes without owning a colour, and the
+ * field metrics (12px/6px padding-gap, 13px label, 12px hint) match the ones the
+ * platform's own settings fields use.
+ * @module @lmzhen/dsh-evolution-settings-ui/client
+ */
+/** Tag id that makes the injection idempotent. */
+export declare const CSS_TAG_ID = "@lmzhen/dsh-evolution-settings-ui/settings.css";
+/** The stylesheet the section injects once. */
+export declare const CSS: string;
+/** The slice of the DOM the injection touches (this package typechecks without DOM lib). */
+interface StyleHost {
+    querySelector(selector: string): unknown;
+    createElement(tag: string): {
+        dataset: Record<string, string>;
+        textContent: string;
+    };
+    head: {
+        appendChild(node: unknown): void;
+    };
+}
+/**
+ * Inject the stylesheet once per document.
+ * @param host - the document to inject into; defaults to the global one.
+ */
+export declare function injectStyles(host?: StyleHost): void;
+export {};
+//# sourceMappingURL=styles.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-settings-ui",
   "description": "Web settings cards for the evolution family's parameter namespaces (community build)",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "publishConfig": {
     "access": "public"
   },
@@ -33,7 +33,8 @@
     "client": {
       "platform": "web",
       "inject": [
-        "@deepseek-ai/dsh-client-ui-settings-plugins"
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-locale"
       ]
     }
   },