@dsh-plus/secret-env 0.1.29 → 0.1.30

package/lib/client.js

@@ -108,7 +108,7 @@ window.__ModuleLoader__.load({
 			unsaved: "未保存",
 			loading: "加载中…",
 			unavailable: "配置服务不可用。",
-			readOnly: "当前部署无 settings provider，配置为只读；请编辑 settings.yaml。",
+			readOnly: "当前部署无 settings provider，配置为只读；请在 profile 的 cordis.patch.yml 行级配置。",
 			invalidNumber: "请输入正整数。",
 			collapse: "收起",
 			expand: "展开",
@@ -125,7 +125,7 @@ window.__ModuleLoader__.load({
 			unsaved: "Unsaved",
 			loading: "Loading…",
 			unavailable: "Settings service unavailable.",
-			readOnly: "No settings provider in this deployment; config is read-only. Edit settings.yaml.",
+			readOnly: "No settings provider in this deployment; config is read-only. Configure it at the profile row in cordis.patch.yml.",
 			invalidNumber: "Enter a positive integer.",
 			collapse: "Collapse",
 			expand: "Expand",
@@ -754,6 +754,105 @@ ${extra}
 				}))
 			];
 		}
+		/** 菜单展开期的按键处理（捕获阶段先於 Lexical/官方管线截获，已消费则阻止冒泡）。 */
+		function handleMenuKey(event, ctx) {
+			const list = ctx.candidates;
+			if (event.key === "ArrowDown" || event.key === "ArrowUp") {
+				event.preventDefault();
+				event.stopPropagation();
+				const delta = event.key === "ArrowDown" ? 1 : -1;
+				ctx.setHighlight((prev) => (prev + delta + list.length) % list.length);
+				return;
+			}
+			if (event.key === "Enter" || event.key === "Tab") {
+				const entry = list[ctx.highlight] ?? list[0];
+				if (entry !== void 0) {
+					event.preventDefault();
+					event.stopPropagation();
+					ctx.pick(entry);
+				}
+				return;
+			}
+			if (event.key === "Escape") {
+				event.preventDefault();
+				event.stopPropagation();
+				ctx.suppressed.current = ctx.hit;
+				ctx.setHit(null);
+			}
+		}
+		/** IME 组合期间不介入：在编辑器根上挂组合态监听，返回解绑函数。 */
+		function bindCompositionGuards(root, composing) {
+			const onStart = () => {
+				composing.current = true;
+			};
+			const onEnd = () => {
+				composing.current = false;
+			};
+			root.addEventListener("compositionstart", onStart);
+			root.addEventListener("compositionend", onEnd);
+			return () => {
+				root.removeEventListener("compositionstart", onStart);
+				root.removeEventListener("compositionend", onEnd);
+			};
+		}
+		/** composer 卡片之外按下即关闭（对齐官方菜单的外部 dismiss 语义）。 */
+		function bindOutsideDismiss(wrap, dismiss) {
+			const onDown = (event) => {
+				if (!(event.target instanceof Node)) return;
+				if ((wrap?.closest("[data-composer-card]"))?.contains(event.target) === true) return;
+				dismiss();
+			};
+			document.addEventListener("pointerdown", onDown, true);
+			return () => document.removeEventListener("pointerdown", onDown, true);
+		}
+		/** 展开态候选面板（闭合态的常驻锚点容器由调用方渲染）。 */
+		function SecretPanel(props) {
+			const { candidates, highlight, wrapRef, t, onHighlight, onPick } = props;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				className: "dse-menuWrap",
+				ref: wrapRef,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "dse-menu",
+					role: "listbox",
+					"aria-label": t("menu.aria"),
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "dse-menuTitle",
+						children: t("menu.title")
+					}), candidates.map((entry, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+						type: "button",
+						role: "option",
+						"aria-selected": index === highlight,
+						title: `$${entry.envName}`,
+						className: `dse-menuItem${index === highlight ? " dse-menuItemActive" : ""}`,
+						onMouseEnter: () => onHighlight(index),
+						onMouseDown: (event) => {
+							event.preventDefault();
+							onPick(entry);
+						},
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: "dse-menuName",
+								children: entry.name
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: "dse-menuDesc",
+								children: entry.description
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								className: "dse-menuBadges",
+								children: [entry.once === true ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: "dse-badge",
+									children: t("scopeOnce")
+								}) : null, /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: "dse-badge dse-badgeDim",
+									children: entry.scope === "session" ? t("scopeSession") : entry.scope === "inherited" ? t("scopeInherited") : t("scopeGlobal")
+								})]
+							})
+						]
+					}, `${entry.scope}:${entry.name}`))]
+				})
+			});
+		}
 		function SecretMenu(props) {
 			const { sessionId, t, insertToken } = props;
 			const input = (props.useInput ?? ((_selector) => FALLBACK_INPUT))((state) => state);
@@ -799,18 +898,7 @@ ${extra}
 			(0, react.useEffect)(() => {
 				const root = editorRootOf(wrapRef.current);
 				if (root === null) return;
-				const onStart = () => {
-					composingRef.current = true;
-				};
-				const onEnd = () => {
-					composingRef.current = false;
-				};
-				root.addEventListener("compositionstart", onStart);
-				root.addEventListener("compositionend", onEnd);
-				return () => {
-					root.removeEventListener("compositionstart", onStart);
-					root.removeEventListener("compositionend", onEnd);
-				};
+				return bindCompositionGuards(root, composingRef);
 			}, []);
 			const pick = (entry) => {
 				if (hit === null) return;
@@ -834,42 +922,22 @@ ${extra}
 				const root = editorRootOf(wrapRef.current);
 				if (root === null) return;
 				const onKey = (event) => {
-					const list = candidatesRef.current;
-					if (event.key === "ArrowDown" || event.key === "ArrowUp") {
-						event.preventDefault();
-						event.stopPropagation();
-						const delta = event.key === "ArrowDown" ? 1 : -1;
-						setHighlight((prev) => (prev + delta + list.length) % list.length);
-						return;
-					}
-					if (event.key === "Enter" || event.key === "Tab") {
-						const entry = list[highlightRef.current] ?? list[0];
-						if (entry !== void 0) {
-							event.preventDefault();
-							event.stopPropagation();
-							pickRef.current(entry);
-						}
-						return;
-					}
-					if (event.key === "Escape") {
-						event.preventDefault();
-						event.stopPropagation();
-						suppressedRef.current = hit;
-						setHit(null);
-					}
+					handleMenuKey(event, {
+						candidates: candidatesRef.current,
+						highlight: highlightRef.current,
+						hit,
+						suppressed: suppressedRef,
+						pick: (entry) => pickRef.current(entry),
+						setHighlight,
+						setHit
+					});
 				};
 				root.addEventListener("keydown", onKey, true);
 				return () => root.removeEventListener("keydown", onKey, true);
 			}, [open, hit]);
 			(0, react.useEffect)(() => {
 				if (!open) return;
-				const onDown = (event) => {
-					if (!(event.target instanceof Node)) return;
-					if ((wrapRef.current?.closest("[data-composer-card]"))?.contains(event.target) === true) return;
-					setHit(null);
-				};
-				document.addEventListener("pointerdown", onDown, true);
-				return () => document.removeEventListener("pointerdown", onDown, true);
+				return bindOutsideDismiss(wrapRef.current, () => setHit(null));
 			}, [open]);
 			(0, react.useEffect)(() => {
 				setHighlight((prev) => candidates.length === 0 ? 0 : Math.min(prev, candidates.length - 1));
@@ -878,49 +946,13 @@ ${extra}
 				className: "dse-menuWrap",
 				ref: wrapRef
 			});
-			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-				className: "dse-menuWrap",
-				ref: wrapRef,
-				children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-					className: "dse-menu",
-					role: "listbox",
-					"aria-label": t("menu.aria"),
-					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-						className: "dse-menuTitle",
-						children: t("menu.title")
-					}), candidates.map((entry, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
-						type: "button",
-						role: "option",
-						"aria-selected": index === highlight,
-						title: `$${entry.envName}`,
-						className: `dse-menuItem${index === highlight ? " dse-menuItemActive" : ""}`,
-						onMouseEnter: () => setHighlight(index),
-						onMouseDown: (event) => {
-							event.preventDefault();
-							pick(entry);
-						},
-						children: [
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-								className: "dse-menuName",
-								children: entry.name
-							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-								className: "dse-menuDesc",
-								children: entry.description
-							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
-								className: "dse-menuBadges",
-								children: [entry.once === true ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-									className: "dse-badge",
-									children: t("scopeOnce")
-								}) : null, /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-									className: "dse-badge dse-badgeDim",
-									children: entry.scope === "session" ? t("scopeSession") : entry.scope === "inherited" ? t("scopeInherited") : t("scopeGlobal")
-								})]
-							})
-						]
-					}, `${entry.scope}:${entry.name}`))]
-				})
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SecretPanel, {
+				candidates,
+				highlight,
+				wrapRef,
+				t,
+				onHighlight: setHighlight,
+				onPick: pick
 			});
 		}
 		//#endregion

package/lib/index.d.ts

@@ -21,7 +21,7 @@ declare const Config: z<Schemastery.ObjectS<NoInfer<{
   secrets: z<NoInfer<SecretMetaInput[]>, NoInfer<SecretMeta[]>, "volatile-defined">;
   masked: z<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
 }>>, "plain">;
-/** 活动字段形态（0.1.7 loader 解析产物：volatile 字段为活动引用）。 */
+/** 活动字段形态（loader 解析产物：volatile 字段为活动引用）。 */
 type SecretEnvConfigFields = Schemastery.TypeT<typeof Config>;
 /** 平面配置形态（消费面的读取形态，由活动引用解包得到）。 */
 type SecretEnvConfig = UnwrapVolatile<SecretEnvConfigFields>;

package/lib/index.js

@@ -13,7 +13,7 @@ const SETTINGS_NS = "dsh-plus-secret-env";
 //#region src/config.ts
 /**
 * 配置单一事实源：cordis 行级 Config（组合默认值）与 settings namespace
-* （用户层，$DSH_HOME/settings.yaml 热生效）共用同一 schemastery schema。
+* （用户层＝profile 行级覆盖层 cordis.patch.yml，热生效）共用同一 schemastery schema。
 * `secrets` 只是全局密钥的**元数据索引**（后缀/描述/创建时间），
 * 值永远走 dsh-credentials seam（$DSH_HOME/.credentials.yaml），不进本文件。
 * @module secret-env/config

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/secret-env",
-  "version": "0.1.29",
+  "version": "0.1.30",
   "description": "dsh-plus service+ui plugin: 密钥环境变量——以 $DSH_VAR_* 变量名向 agent 暴露密钥（全局持久/会话级/一次性），执行期经 dsh-shell-env 原生注入，值不进消息流，不影响缓存率",
   "type": "module",
   "main": "lib/index.js",
@@ -19,7 +19,7 @@
     "src"
   ],
   "dependencies": {
-    "@dsh-plus/shared": "0.1.35"
+    "@dsh-plus/shared": "0.1.36"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5-alpha.1",

package/src/client/menu.tsx

@@ -7,7 +7,15 @@
  * bail 通道 'slash/input-insert-text'（span + draftRev CAS，编辑器内应用）。
  * @module secret-env/client/menu
  */
-import { type ReactElement, useEffect, useRef, useState } from 'react'
+import {
+  type Dispatch,
+  type MutableRefObject,
+  type ReactElement,
+  type SetStateAction,
+  useEffect,
+  useRef,
+  useState,
+} from 'react'
 
 import { fetchSecrets, type SecretList } from './api.ts'
 import type { Translate } from './i18n.ts'
@@ -116,6 +124,123 @@ function toCandidates(list: SecretList): SecretCandidate[] {
   ]
 }
 
+interface MenuKeyContext {
+  candidates: SecretCandidate[]
+  highlight: number
+  hit: SecretHit | null
+  suppressed: MutableRefObject<SecretHit | null>
+  pick: (entry: SecretCandidate) => void
+  setHighlight: Dispatch<SetStateAction<number>>
+  setHit: Dispatch<SetStateAction<SecretHit | null>>
+}
+
+/** 菜单展开期的按键处理（捕获阶段先於 Lexical/官方管线截获，已消费则阻止冒泡）。 */
+function handleMenuKey(event: KeyboardEvent, ctx: MenuKeyContext): void {
+  const list = ctx.candidates
+  if (event.key === 'ArrowDown' || event.key === 'ArrowUp') {
+    event.preventDefault()
+    event.stopPropagation()
+    const delta = event.key === 'ArrowDown' ? 1 : -1
+    ctx.setHighlight((prev) => (prev + delta + list.length) % list.length)
+    return
+  }
+  if (event.key === 'Enter' || event.key === 'Tab') {
+    const entry = list[ctx.highlight] ?? list[0]
+    if (entry !== undefined) {
+      event.preventDefault()
+      event.stopPropagation()
+      ctx.pick(entry)
+    }
+    return
+  }
+  if (event.key === 'Escape') {
+    event.preventDefault()
+    event.stopPropagation()
+    ctx.suppressed.current = ctx.hit
+    ctx.setHit(null)
+  }
+}
+
+/** IME 组合期间不介入：在编辑器根上挂组合态监听，返回解绑函数。 */
+function bindCompositionGuards(
+  root: HTMLElement,
+  composing: MutableRefObject<boolean>,
+): () => void {
+  const onStart = (): void => {
+    composing.current = true
+  }
+  const onEnd = (): void => {
+    composing.current = false
+  }
+  root.addEventListener('compositionstart', onStart)
+  root.addEventListener('compositionend', onEnd)
+  return () => {
+    root.removeEventListener('compositionstart', onStart)
+    root.removeEventListener('compositionend', onEnd)
+  }
+}
+
+/** composer 卡片之外按下即关闭（对齐官方菜单的外部 dismiss 语义）。 */
+function bindOutsideDismiss(wrap: HTMLElement | null, dismiss: () => void): () => void {
+  const onDown = (event: PointerEvent): void => {
+    if (!(event.target instanceof Node)) return
+    const card = wrap?.closest('[data-composer-card]')
+    if (card?.contains(event.target) === true) return
+    dismiss()
+  }
+  document.addEventListener('pointerdown', onDown, true)
+  return () => document.removeEventListener('pointerdown', onDown, true)
+}
+
+interface SecretPanelProps {
+  candidates: SecretCandidate[]
+  highlight: number
+  wrapRef: MutableRefObject<HTMLDivElement | null>
+  t: Translate
+  onHighlight: (index: number) => void
+  onPick: (entry: SecretCandidate) => void
+}
+
+/** 展开态候选面板（闭合态的常驻锚点容器由调用方渲染）。 */
+function SecretPanel(props: SecretPanelProps): ReactElement {
+  const { candidates, highlight, wrapRef, t, onHighlight, onPick } = props
+  return (
+    <div className="dse-menuWrap" ref={wrapRef}>
+      <div className="dse-menu" role="listbox" aria-label={t('menu.aria')}>
+        <div className="dse-menuTitle">{t('menu.title')}</div>
+        {candidates.map((entry, index) => (
+          <button
+            key={`${entry.scope}:${entry.name}`}
+            type="button"
+            role="option"
+            aria-selected={index === highlight}
+            title={`$${entry.envName}`}
+            className={`dse-menuItem${index === highlight ? ' dse-menuItemActive' : ''}`}
+            onMouseEnter={() => onHighlight(index)}
+            onMouseDown={(event) => {
+              event.preventDefault()
+              onPick(entry)
+            }}
+          >
+            <span className="dse-menuName">{entry.name}</span>
+            <span className="dse-menuDesc">{entry.description}</span>
+            <span className="dse-menuBadges">
+              {entry.once === true ? <span className="dse-badge">{t('scopeOnce')}</span> : null}
+              <span className="dse-badge dse-badgeDim">
+                {entry.scope === 'session'
+                  ? t('scopeSession')
+                  : entry.scope === 'inherited'
+                    ? t('scopeInherited')
+                    : t('scopeGlobal')}
+              </span>
+            </span>
+          </button>
+        ))}
+      </div>
+    </div>
+  )
+}
+
 export function SecretMenu(props: SecretMenuProps): ReactElement | null {
   const { sessionId, t, insertToken } = props
   // useInput 是标准钩子 prop，必须无条件调用；旧壳缺席时回落常量（菜单永不展开）。
@@ -182,18 +307,7 @@ export function SecretMenu(props: SecretMenuProps): ReactElement | null {
   useEffect(() => {
     const root = editorRootOf(wrapRef.current)
     if (root === null) return
-    const onStart = (): void => {
-      composingRef.current = true
-    }
-    const onEnd = (): void => {
-      composingRef.current = false
-    }
-    root.addEventListener('compositionstart', onStart)
-    root.addEventListener('compositionend', onEnd)
-    return () => {
-      root.removeEventListener('compositionstart', onStart)
-      root.removeEventListener('compositionend', onEnd)
-    }
+    return bindCompositionGuards(root, composingRef)
   }, [])
 
   const pick = (entry: SecretCandidate): void => {
@@ -217,29 +331,15 @@ export function SecretMenu(props: SecretMenuProps): ReactElement | null {
     const root = editorRootOf(wrapRef.current)
     if (root === null) return
     const onKey = (event: KeyboardEvent): void => {
-      const list = candidatesRef.current
-      if (event.key === 'ArrowDown' || event.key === 'ArrowUp') {
-        event.preventDefault()
-        event.stopPropagation()
-        const delta = event.key === 'ArrowDown' ? 1 : -1
-        setHighlight((prev) => (prev + delta + list.length) % list.length)
-        return
-      }
-      if (event.key === 'Enter' || event.key === 'Tab') {
-        const entry = list[highlightRef.current] ?? list[0]
-        if (entry !== undefined) {
-          event.preventDefault()
-          event.stopPropagation()
-          pickRef.current(entry)
-        }
-        return
-      }
-      if (event.key === 'Escape') {
-        event.preventDefault()
-        event.stopPropagation()
-        suppressedRef.current = hit
-        setHit(null)
-      }
+      handleMenuKey(event, {
+        candidates: candidatesRef.current,
+        highlight: highlightRef.current,
+        hit,
+        suppressed: suppressedRef,
+        pick: (entry) => pickRef.current(entry),
+        setHighlight,
+        setHit,
+      })
     }
     root.addEventListener('keydown', onKey, true)
     return () => root.removeEventListener('keydown', onKey, true)
@@ -248,14 +348,7 @@ export function SecretMenu(props: SecretMenuProps): ReactElement | null {
   // 点 composer 卡片之外处关闭（对齐官方菜单的外部 dismiss 语义）。
   useEffect(() => {
     if (!open) return
-    const onDown = (event: PointerEvent): void => {
-      if (!(event.target instanceof Node)) return
-      const card = wrapRef.current?.closest('[data-composer-card]')
-      if (card?.contains(event.target) === true) return
-      setHit(null)
-    }
-    document.addEventListener('pointerdown', onDown, true)
-    return () => document.removeEventListener('pointerdown', onDown, true)
+    return bindOutsideDismiss(wrapRef.current, () => setHit(null))
   }, [open])
 
   // 高亮随候选集变化收敛到合法范围。
@@ -267,39 +360,15 @@ export function SecretMenu(props: SecretMenuProps): ReactElement | null {
     // 锚点常驻：闭合态也要挂载容器，检测效果依赖它定位 composer 编辑器根。
     return <div className="dse-menuWrap" ref={wrapRef} />
   }
+
   return (
-    <div className="dse-menuWrap" ref={wrapRef}>
-      <div className="dse-menu" role="listbox" aria-label={t('menu.aria')}>
-        <div className="dse-menuTitle">{t('menu.title')}</div>
-        {candidates.map((entry, index) => (
-          <button
-            key={`${entry.scope}:${entry.name}`}
-            type="button"
-            role="option"
-            aria-selected={index === highlight}
-            title={`$${entry.envName}`}
-            className={`dse-menuItem${index === highlight ? ' dse-menuItemActive' : ''}`}
-            onMouseEnter={() => setHighlight(index)}
-            onMouseDown={(event) => {
-              event.preventDefault()
-              pick(entry)
-            }}
-          >
-            <span className="dse-menuName">{entry.name}</span>
-            <span className="dse-menuDesc">{entry.description}</span>
-            <span className="dse-menuBadges">
-              {entry.once === true ? <span className="dse-badge">{t('scopeOnce')}</span> : null}
-              <span className="dse-badge dse-badgeDim">
-                {entry.scope === 'session'
-                  ? t('scopeSession')
-                  : entry.scope === 'inherited'
-                    ? t('scopeInherited')
-                    : t('scopeGlobal')}
-              </span>
-            </span>
-          </button>
-        ))}
-      </div>
-    </div>
+    <SecretPanel
+      candidates={candidates}
+      highlight={highlight}
+      wrapRef={wrapRef}
+      t={t}
+      onHighlight={setHighlight}
+      onPick={pick}
+    />
   )
 }

package/src/config.ts

@@ -1,6 +1,6 @@
 /**
  * 配置单一事实源：cordis 行级 Config（组合默认值）与 settings namespace
- * （用户层，$DSH_HOME/settings.yaml 热生效）共用同一 schemastery schema。
+ * （用户层＝profile 行级覆盖层 cordis.patch.yml，热生效）共用同一 schemastery schema。
  * `secrets` 只是全局密钥的**元数据索引**（后缀/描述/创建时间），
  * 值永远走 dsh-credentials seam（$DSH_HOME/.credentials.yaml），不进本文件。
  * @module secret-env/config
@@ -10,7 +10,7 @@ import type { UnwrapVolatile } from '@dsh-plus/shared'
 
 import { SETTINGS_NS as NS_LITERAL } from './ns.ts'
 
-/** settings 命名空间（字面量即合法命名空间，0.1.2-alpha.2 起编译期校验）。 */
+/** settings 命名空间（字面量即合法命名空间，编译期校验）。 */
 export const SETTINGS_NS = NS_LITERAL
 
 /** 一条全局密钥的元数据（值不在此处）。 */
@@ -36,7 +36,7 @@ const SecretMetaSchema: z<SecretMetaInput, SecretMeta> = z.object({
   createdAt: z.string().description('创建时间 ISO').default(''),
 })
 
-// 0.1.7：全字段 `.volatile()`——条目进入 settings describe 视图（卡片可读写），
+// 全字段 `.volatile()`——条目进入 settings describe 视图（卡片可读写），
 // loader 原位提交活动引用，索引读取现取即热。
 export const Config = z.object({
   secrets: z
@@ -51,7 +51,7 @@ export const Config = z.object({
     .volatile(),
 })
 
-/** 活动字段形态（0.1.7 loader 解析产物：volatile 字段为活动引用）。 */
+/** 活动字段形态（loader 解析产物：volatile 字段为活动引用）。 */
 export type SecretEnvConfigFields = Schemastery.TypeT<typeof Config>
 /** 平面配置形态（消费面的读取形态，由活动引用解包得到）。 */
 export type SecretEnvConfig = UnwrapVolatile<SecretEnvConfigFields>

package/src/service.ts

@@ -39,7 +39,7 @@ import {
 import { envNameOf, suffixOf } from './names.ts'
 import { SETTINGS_NS } from './ns.ts'
 
-/** settings 服务窄面（0.1.7 只需 update 写入用户层；describe 读由 loader 并入 config）。 */
+/** settings 服务窄面（只需 update 写入用户层；describe 读由 loader 并入 config）。 */
 interface SettingsLike {
   update(ns: string, patch: Record<string, unknown>): Promise<void>
 }
@@ -69,7 +69,7 @@ export class SecretEnvService extends Service {
 
   constructor(ctx: Context, config: SecretEnvConfig | SecretEnvConfigFields | undefined) {
     super(ctx, 'secretEnv')
-    // 0.1.7 替代 installSection/setSource：活动引用原位提交——索引读取经
+    // 替代 installSection/setSource：活动引用原位提交——索引读取经
     // readIndex 现取平面快照，用户层写入走 loader 落盘 + 原位提交热生效。
     this.base = config !== undefined ? unwrapVolatile(config) : { secrets: [], masked: [] }
     this.readIndex = config !== undefined ? () => unwrapVolatile(config) : undefined