@lmzhen/dsh-evolution-core 0.6.0 → 0.7.0

package/lib/index.js

@@ -8923,7 +8923,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#review",
-		summary: "Activity units between skill-review injections."
+		summary: "Activity units between skill-review injections.",
+		label: "技能审查间隔",
+		hint: "每多少活动单位触发一次技能审查注入。",
+		control: "number",
+		unit: "次",
+		values: ""
 	},
 	{
 		id: "reviewMemoryInterval",
@@ -8933,7 +8938,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#review",
-		summary: "Activity units between memory-review injections."
+		summary: "Activity units between memory-review injections.",
+		label: "记忆审查间隔",
+		hint: "每多少活动单位触发一次记忆审查注入。",
+		control: "number",
+		unit: "次",
+		values: ""
 	},
 	{
 		id: "skillReviewTrigger",
@@ -8943,7 +8953,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#review",
-		summary: "Which channel may inject a skill review (cadence, completion, both)."
+		summary: "Which channel may inject a skill review (cadence, completion, both).",
+		label: "审查触发通道",
+		hint: "哪个通道可以注入技能审查：cadence＝按间隔、completion＝按完成、both＝两者。",
+		control: "select",
+		unit: "",
+		values: "cadence|completion|both"
 	},
 	{
 		id: "skillReviewCompletionMinToolCalls",
@@ -8953,7 +8968,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#review",
-		summary: "Tool calls a task needs before the completion channel injects."
+		summary: "Tool calls a task needs before the completion channel injects.",
+		label: "完成通道最少工具调用",
+		hint: "走完成通道时，任务至少经过多少次工具调用才注入。",
+		control: "number",
+		unit: "次",
+		values: ""
 	},
 	{
 		id: "reviewEnabled",
@@ -8963,7 +8983,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#review",
-		summary: "Master switch for the review plugin."
+		summary: "Master switch for the review plugin.",
+		label: "启用审查插件",
+		hint: "审查插件的总开关。",
+		control: "switch",
+		unit: "",
+		values: ""
 	},
 	{
 		id: "reviewMode",
@@ -8973,7 +8998,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#review",
-		summary: "Run the review in the parent session (inject) or on a subagent."
+		summary: "Run the review in the parent session (inject) or on a subagent.",
+		label: "审查运行方式",
+		hint: "inject＝在父会话内注入，subagent＝交给子代理运行。",
+		control: "select",
+		unit: "",
+		values: "subagent|inject"
 	},
 	{
 		id: "reviewWakeInject",
@@ -8983,7 +9013,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-review",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#review",
-		summary: "Deliver the deferred review as a waking follow-up message."
+		summary: "Deliver the deferred review as a waking follow-up message.",
+		label: "审查后续唤醒注入",
+		hint: "把延后的审查作为唤醒消息投递。",
+		control: "switch",
+		unit: "",
+		values: ""
 	},
 	{
 		id: "reviewProvider",
@@ -9053,7 +9088,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "tool-skill-manage",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#write-caps",
-		summary: "Character cap on a SKILL.md body (tighten-only)."
+		summary: "Character cap on a SKILL.md body (tighten-only).",
+		label: "SKILL.md 正文字符上限",
+		hint: "SKILL.md 正文的字符上限（只许收紧）。",
+		control: "number",
+		unit: "字符",
+		values: ""
 	},
 	{
 		id: "maxSkillFileBytes",
@@ -9063,7 +9103,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "tool-skill-manage",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#write-caps",
-		summary: "Byte cap on one support file (tighten-only)."
+		summary: "Byte cap on one support file (tighten-only).",
+		label: "支持文件字节上限",
+		hint: "单个支持文件的字节上限（只许收紧）。",
+		control: "number",
+		unit: "字节",
+		values: ""
 	},
 	{
 		id: "maxSkillNameLength",
@@ -9073,7 +9118,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "tool-skill-manage",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#write-caps",
-		summary: "Character cap on a skill name (tighten-only)."
+		summary: "Character cap on a skill name (tighten-only).",
+		label: "技能名字符上限",
+		hint: "技能名的字符上限（只许收紧）。",
+		control: "number",
+		unit: "字符",
+		values: ""
 	},
 	{
 		id: "maxDescriptionLength",
@@ -9083,7 +9133,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "tool-skill-manage",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#write-caps",
-		summary: "Character cap on a skill description (tighten-only)."
+		summary: "Character cap on a skill description (tighten-only).",
+		label: "技能描述字符上限",
+		hint: "技能描述的字符上限（只许收紧）。",
+		control: "number",
+		unit: "字符",
+		values: ""
 	},
 	{
 		id: "descriptionStrict",
@@ -9093,7 +9148,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "tool-skill-manage",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#write-caps",
-		summary: "Refuse a description over the authoring bar instead of advising."
+		summary: "Refuse a description over the authoring bar instead of advising.",
+		label: "描述严格档",
+		hint: "描述超过写作门槛时拒绝写入，而不是只提示。",
+		control: "switch",
+		unit: "",
+		values: ""
 	},
 	{
 		id: "strictCrossSource",
@@ -9103,7 +9163,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "tool-skill-manage",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#write-caps",
-		summary: "Refuse writes whose catalog entry resolves outside the family."
+		summary: "Refuse writes whose catalog entry resolves outside the family.",
+		label: "跨源严格档",
+		hint: "目录项解析到家族之外时拒绝写入。",
+		control: "switch",
+		unit: "",
+		values: ""
 	},
 	{
 		id: "citationPolicy",
@@ -9113,7 +9178,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "tool-skill-manage",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#write-caps",
-		summary: "Refuse a move that would leave a dangling reference, or verify it."
+		summary: "Refuse a move that would leave a dangling reference, or verify it.",
+		label: "引用校验档",
+		hint: "移动或合并时对引用的处置：verify＝校验、refuse＝直接拒绝。",
+		control: "select",
+		unit: "",
+		values: "verify|refuse"
 	},
 	{
 		id: "referenceRewrite",
@@ -9143,7 +9213,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "tool-skill-manage",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#write-caps",
-		summary: "Warn about an oversize support file, or refuse the write."
+		summary: "Warn about an oversize support file, or refuse the write.",
+		label: "支持文件超限档",
+		hint: "支持文件超出字符上限时：report＝只报告、enforce＝拒写。",
+		control: "select",
+		unit: "",
+		values: "report|enforce"
 	},
 	{
 		id: "memoryChars",
@@ -9153,7 +9228,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "memory-files",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#memory",
-		summary: "Character budget the memory store enforces for MEMORY.md."
+		summary: "Character budget the memory store enforces for MEMORY.md.",
+		label: "MEMORY.md 字符预算",
+		hint: "memory 存储对 MEMORY.md 的字符上限。",
+		control: "number",
+		unit: "字符",
+		values: ""
 	},
 	{
 		id: "userChars",
@@ -9163,7 +9243,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "memory-files",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#memory",
-		summary: "Character budget the memory store enforces for USER.md."
+		summary: "Character budget the memory store enforces for USER.md.",
+		label: "USER.md 字符预算",
+		hint: "memory 存储对 USER.md 的字符上限。",
+		control: "number",
+		unit: "字符",
+		values: ""
 	},
 	{
 		id: "memoryEnabled",
@@ -9183,7 +9268,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "tool-memory",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#memory",
-		summary: "Characters of one memory entry shown in a tool result preview."
+		summary: "Characters of one memory entry shown in a tool result preview.",
+		label: "条目预览字符数",
+		hint: "单条记忆预览保留多少字符。",
+		control: "number",
+		unit: "字符",
+		values: ""
 	},
 	{
 		id: "addDatePrefix",
@@ -9193,7 +9283,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "memory-files",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#memory",
-		summary: "Prefix stored memory entries with their date heading."
+		summary: "Prefix stored memory entries with their date heading.",
+		label: "记忆条目加日期前缀",
+		hint: "写入记忆时为条目加上日期标题。",
+		control: "switch",
+		unit: "",
+		values: ""
 	},
 	{
 		id: "maxConsolidationFailures",
@@ -9203,7 +9298,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "memory-files",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#memory",
-		summary: "Consolidation failures one turn tolerates before the tool gives up."
+		summary: "Consolidation failures one turn tolerates before the tool gives up.",
+		label: "合并失败容忍次数",
+		hint: "一轮内合并失败多少次后工具放弃。",
+		control: "number",
+		unit: "次",
+		values: ""
 	},
 	{
 		id: "curatorIntervalHours",
@@ -9213,7 +9313,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Minimum hours between deterministic curation passes."
+		summary: "Minimum hours between deterministic curation passes.",
+		label: "策展间隔",
+		hint: "两次确定性策展之间至少间隔多少小时。",
+		control: "number",
+		unit: "小时",
+		values: ""
 	},
 	{
 		id: "staleAfterDays",
@@ -9223,7 +9328,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Inactive days before a skill counts as stale."
+		summary: "Inactive days before a skill counts as stale.",
+		label: "判为陈旧的天数",
+		hint: "技能多少天没被使用即算陈旧。",
+		control: "number",
+		unit: "天",
+		values: ""
 	},
 	{
 		id: "archiveAfterDays",
@@ -9233,7 +9343,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Inactive days before a stale skill is archived (must be >= staleAfterDays)."
+		summary: "Inactive days before a stale skill is archived (must be >= staleAfterDays).",
+		label: "归档天数",
+		hint: "陈旧技能再过多少天归档（须 ≥ 判为陈旧的天数）。",
+		control: "number",
+		unit: "天",
+		values: ""
 	},
 	{
 		id: "qualityWarnStaleAfterDays",
@@ -9243,7 +9358,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Age at which a low quality score starts warning."
+		summary: "Age at which a low quality score starts warning.",
+		label: "低质量告警天数",
+		hint: "质量分偏低时从多少天开始告警。",
+		control: "number",
+		unit: "天",
+		values: ""
 	},
 	{
 		id: "minIdleHours",
@@ -9253,7 +9373,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Idle hours required before an automatic curation pass runs."
+		summary: "Idle hours required before an automatic curation pass runs.",
+		label: "空闲门槛",
+		hint: "至少空闲多少小时才跑自动策展。",
+		control: "number",
+		unit: "小时",
+		values: ""
 	},
 	{
 		id: "minIdleFailOpen",
@@ -9263,7 +9388,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Let the idle gate open when the activity probe is unavailable."
+		summary: "Let the idle gate open when the activity probe is unavailable.",
+		label: "空闲探针失败时放行",
+		hint: "活动探针不可用时，是否让空闲门槛直接放行。",
+		control: "switch",
+		unit: "",
+		values: ""
 	},
 	{
 		id: "llmReview",
@@ -9273,7 +9403,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Enable the LLM nomination pass on top of the deterministic lifecycle."
+		summary: "Enable the LLM nomination pass on top of the deterministic lifecycle.",
+		label: "启用 LLM 提名",
+		hint: "在确定性生命周期之上再跑一遍 LLM 提名。",
+		control: "switch",
+		unit: "",
+		values: ""
 	},
 	{
 		id: "curatorReviewMaxTokens",
@@ -9283,7 +9418,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Token budget of the curator LLM review."
+		summary: "Token budget of the curator LLM review.",
+		label: "策展 LLM token 预算",
+		hint: "策展 LLM 审查可用的 token 预算。",
+		control: "number",
+		unit: "token",
+		values: ""
 	},
 	{
 		id: "curatorReviewTimeoutMs",
@@ -9293,7 +9433,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Wall-clock bound of the curator LLM review."
+		summary: "Wall-clock bound of the curator LLM review.",
+		label: "策展 LLM 超时",
+		hint: "策展 LLM 审查的墙钟上限。",
+		control: "number",
+		unit: "毫秒",
+		values: ""
 	},
 	{
 		id: "healthSoftBodyChars",
@@ -9303,7 +9448,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Body character line the health view judges against."
+		summary: "Body character line the health view judges against.",
+		label: "正文软带",
+		hint: "健康视图判定正文长度的软带。",
+		control: "number",
+		unit: "字符",
+		values: ""
 	},
 	{
 		id: "healthStampDensityPerKb",
@@ -9313,7 +9463,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Stamp density per KB that flags log-like content in a body."
+		summary: "Stamp density per KB that flags log-like content in a body.",
+		label: "标记密度阈值",
+		hint: "每 KB 出现多少个时间标记就算「像日志」。",
+		control: "number",
+		unit: "处/KB",
+		values: ""
 	},
 	{
 		id: "healthChurnMinPatches",
@@ -9323,7 +9478,12 @@ const PARAM_EXPOSURE = Object.freeze([
 		owner: "evolution-curator",
 		applies: "live",
 		docAnchor: "PARAMETERS.md#curator",
-		summary: "Patches without a read that flag a write-ghost skill."
+		summary: "Patches without a read that flag a write-ghost skill.",
+		label: "空写判定补丁数",
+		hint: "多少次改动都没有任何读取，即判为「写幽灵」。",
+		control: "number",
+		unit: "处",
+		values: ""
 	},
 	{
 		id: "evolution-curator.enabled",

package/lib/types/params.d.ts

@@ -60,6 +60,15 @@ export type ParamAuthority = 'code' | 'cordis' | 'install';
  * `applies` is the SETTINGS-side timing: 'none' means the parameter is not
  * writable through the user layer (a cordis.yml change still follows the
  * deployment's patch-reload policy).
+ *
+ * UI METADATA (0.7.0): every E3 row carries the optional tail
+ * `label, hint, control, unit, values` — in that order, directly after
+ * `summary`, still one entry per line. E3 is the only tier the settings cards
+ * render, so the card's Chinese name, help text, control kind, unit suffix and
+ * value domain come from THIS registry and nowhere else; the browser half is
+ * generated from this text (`gen-param-client-view.mjs`). Non-E3 rows must NOT
+ * carry the tail (there is no UI surface for them), and `control: 'select'`
+ * requires a non-empty pipe-joined `values`.
  */
 export interface ParamExposure {
     id: string;
@@ -70,6 +79,16 @@ export interface ParamExposure {
     applies: 'live' | 'restart' | 'none';
     docAnchor: string;
     summary: string;
+    /** Card label (Chinese, short). Required on E3 rows. */
+    label?: string;
+    /** Card help text (Chinese, one sentence). Required on E3 rows. */
+    hint?: string;
+    /** Which control the card renders for this field. Required on E3 rows. */
+    control?: 'number' | 'switch' | 'select' | 'text';
+    /** Unit suffix shown next to a number (empty when it carries none). */
+    unit?: string;
+    /** Pipe-joined allowed values; non-empty exactly when control is 'select'. */
+    values?: string;
 }
 /**
  * The parameter registry. G1/S1.1 seeds it with the review group (G-C); the

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-core",
   "description": "Shared stores, prompts, signals and lifecycle logic for the dsh-evolution plugin family (community build)",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "publishConfig": {
     "access": "public"
   },