@dsh-plus/secret-env 0.1.0 → 0.1.2

package/src/client/client.ts

@@ -1,22 +1,26 @@
 /**
  * 浏览器半入口：
- * - settings.section 官方插槽注册「密钥变量」独立设置页（全局管理）；
- * - conversation.input.right session 作用域插槽注册 composer 钥匙胶囊
- *   （会话级密钥面板；会话 id 由插槽 inject 工厂直接供给）。
+ * - settings.section 官方插槽注册「环境变量」独立设置页
+ *   （全局管理 + 继承变量屏蔽 + 会话变量管理）；
+ * - conversation.input.overlay 注册两个 session 作用域浮层：
+ *   `$` 触发补全菜单与 /var 命令唤起的会话变量面板；
+ * - commandUi 注册 /var 斜杠命令（官方 popupSelect 壳 → 打开总线 → 面板）。
  * 数据均经同源 HTTP 端点（值不上行经任何对话通道）。
  * @module @dsh-plus/secret-env/client
  */
 import type { Context } from '@deepseek-ai/cordis'
 
-import { ComposerSecret } from './composer.tsx'
+import { registerVarCommand } from './command.ts'
 import { en, NS, zh } from './i18n.ts'
-import { SecretsSection } from './section.tsx'
+import { SecretMenu, type TokenSpanLike } from './menu.tsx'
+import { SessionPanelHost } from './panel-host.tsx'
+import { SecretsSection, type SessionsListLike } from './section.tsx'
 import { injectSecretEnvStyle } from './styles.ts'
 
 export const name = 'dsh-plus-secret-env'
 
 /** 浏览器半需要的 cordis 服务 key（loader 据此注入；package.json 的 dsh.client.inject 管包加载顺序）。 */
-export const inject = ['slots', 'locale'] as const
+export const inject = ['slots', 'locale', 'sessions'] as const
 
 interface SlotsLike {
   inject(key: string, callback: () => unknown): unknown
@@ -28,9 +32,21 @@ interface LocaleLike {
   bind(ns: string): (key: string) => string
 }
 
+/** 会话作用域句柄的结构子集（dsh-api-session-controller 客户端 sessions 服务）。 */
+interface SessionScopeLike {
+  bail(subject: unknown, event: string, payload: Record<string, unknown>): unknown
+}
+
+interface SessionsLike extends SessionsListLike {
+  scope(sessionId: string): SessionScopeLike | undefined
+  subagentAddress?(sessionId: string): unknown
+}
+
 interface ClientContext {
   slots: SlotsLike
   locale: LocaleLike
+  sessions: SessionsLike
+  inject(keys: readonly string[], callback: (scope: never) => void): unknown
   effect(execute: () => () => void, label?: string): unknown
 }
 
@@ -54,24 +70,53 @@ export function apply(ctx: Context): void {
         id: 'dsh-plus-secret-env',
         order: 16,
         label: () => t('nav'),
-        inject: () => ({ t }),
+        inject: () => ({ t, sessions: c.sessions }),
       },
       SecretsSection,
     ),
   )
 
-  // composer 工具行钥匙胶囊（conversation.input.right：session 作用域 list 槽，
-  // inject 工厂收框架解析的 sessionId）。
-  c.slots.inject('conversation.input.right', () =>
+  // `/var` 斜杠命令（commandUi 由 dsh-client-ui-commands 客户端半提供）。
+  registerVarCommand(c, c.sessions, t)
+
+  // `$` 触发补全菜单（conversation.input.overlay：composer 卡片内浮层）。
+  // 插入走官方会话作用域 bail 通道 slash/input-insert-text（span+draftRev CAS）。
+  c.slots.inject('conversation.input.overlay', () =>
     c.slots.register(
       {
-        name: 'conversation.input.right',
-        id: 'dsh-plus-secret-env',
-        order: 40,
+        name: 'conversation.input.overlay',
+        id: 'dse-secret-menu',
+        order: 10,
+        locale: NS,
+        inject: (sessionId: string) => ({
+          sessionId,
+          insertToken: (text: string, span: TokenSpanLike): boolean => {
+            const actx = c.sessions.scope(sessionId)
+            if (actx === undefined) return false
+            return (
+              actx.bail(actx, 'slash/input-insert-text', {
+                text,
+                span: { start: span.start, end: span.end, draftRev: span.draftRev },
+              }) === true
+            )
+          },
+        }),
+      },
+      SecretMenu,
+    ),
+  )
+
+  // `/var` 唤起的会话变量面板（同一 overlay 槽，监听打开总线）。
+  c.slots.inject('conversation.input.overlay', () =>
+    c.slots.register(
+      {
+        name: 'conversation.input.overlay',
+        id: 'dse-secret-panel',
+        order: 20,
         locale: NS,
         inject: (sessionId: string) => ({ sessionId }),
       },
-      ComposerSecret,
+      SessionPanelHost,
     ),
   )
 }

package/src/client/command.ts

@@ -0,0 +1,62 @@
+/**
+ * `/var` 斜杠命令（dsh-client-ui-commands 的 commandUi 服务）：
+ * contribution 仅支持官方 popupSelect 壳（kind 唯一），故命令提供单个
+ * 「打开面板」动作，选中后经打开总线唤起本会话的变量面板——
+ * 完全自定义的 React 面板只能在自己占有的 overlay 槽渲染。
+ * 子代理会话不提供本命令（对齐官方 /model 的可用性过滤）。
+ * @module secret-env/client/command
+ */
+import { requestOpenSessionPanel } from './panel-bus.ts'
+
+/** commandUi 服务的结构子集（dsh-client-ui-commands CommandUiContract）。 */
+interface CommandUiLike {
+  register(contribution: {
+    name: string
+    description: string
+    available(session: { sessionId: string }): boolean
+    ui: {
+      kind: 'popupSelect'
+      options(session: { sessionId: string }): Promise<readonly { id: string; label: string }[]>
+      onSelect(option: { id: string }, session: { sessionId: string }): void | Promise<void>
+    }
+  }): () => void
+}
+
+interface CommandScope {
+  commandUi: CommandUiLike
+  effect(execute: () => () => void, label?: string): unknown
+}
+
+interface CommandHostContext {
+  inject(keys: readonly string[], callback: (scope: CommandScope) => void): unknown
+}
+
+interface SessionsAvailabilityLike {
+  subagentAddress?(sessionId: string): unknown
+}
+
+/** 注册 /var 命令（commandUi 服务缺席时 inject 回调不触发，自然跳过）。 */
+export function registerVarCommand(
+  ctx: CommandHostContext,
+  sessions: SessionsAvailabilityLike,
+  t: (key: string) => string,
+): void {
+  ctx.inject(['commandUi'], (scope) => {
+    scope.effect(
+      () =>
+        scope.commandUi.register({
+          name: 'var',
+          description: t('command.description'),
+          available: (session) => sessions.subagentAddress?.(session.sessionId) === undefined,
+          ui: {
+            kind: 'popupSelect',
+            options: () => Promise.resolve([{ id: 'open', label: t('command.openPanel') }]),
+            onSelect: (_option, session) => {
+              requestOpenSessionPanel(session.sessionId)
+            },
+          },
+        }),
+      'secret-env: /var contribution',
+    )
+  })
+}

package/src/client/common.ts

@@ -1,7 +1,9 @@
 /**
- * 浏览器半共享小件：错误码文案映射与复制助手（设置页与会话控件共用）。
+ * 浏览器半共享小件：错误码文案映射、复制助手与变量名输入规则
+ * （设置页与会话控件共用；名称规则与 node 半 names.ts 同源）。
  * @module secret-env/client/common
  */
+import { type NameError, normalizeSuffix, validateSuffix } from '../names.ts'
 import { ApiError } from './api.ts'
 
 /** 端点错误 → 本地化文案（未知码回落 internal）。 */
@@ -12,6 +14,17 @@ export function errorText(t: (key: string) => string, error: unknown): string {
   return text === `error.${code}` ? t('error.internal') : text
 }
 
+/** 名称输入的实时规范化：键入即转大写（去空白交给保存时的 normalizeSuffix）。 */
+export function liveName(raw: string): string {
+  return raw.toUpperCase()
+}
+
+/** 名称输入的实时校验：空串不标错（必填兜底），其余按 names.ts 规则判定。 */
+export function nameErrorOf(raw: string): NameError | null {
+  if (raw.trim() === '') return null
+  return validateSuffix(normalizeSuffix(raw))
+}
+
 /** 复制文本到剪贴板（clipboard API 缺席时退 execCommand）。 */
 export async function copyText(text: string): Promise<boolean> {
   try {

package/src/client/i18n.ts

@@ -7,22 +7,18 @@ import { commonEn, commonZh, mergeDict } from '@dsh-plus/shared/client'
 export const NS = 'dsh-plus-secret-env'
 
 const ownZh = {
-  nav: '密钥变量',
-  title: '密钥变量',
+  nav: '环境变量',
+  title: '环境变量',
   description:
-    '以 $DSH_SECRET_* 变量名向 agent 暴露密钥：值在每次 shell 调用时由宿主注入，不进入对话记录与提示词，不影响上下文缓存。',
+    '以 $DSH_VAR_* 变量名向 agent 暴露值（密钥、链接等）：值在每次 shell 调用时由宿主注入，不进入对话记录与提示词，不影响上下文缓存。',
   // 设置页（全局）
-  globalList: '全局密钥',
-  colName: '变量名（模型可见）',
-  colDescription: '描述',
-  colState: '状态',
-  colActions: '操作',
+  globalList: '全局变量',
   configured: '已配置',
   unconfigured: '未配置',
   readonly: '只读来源',
-  addGlobal: '添加全局密钥',
-  nameLabel: '变量名后缀',
-  nameHint: '大写字母/数字/下划线，如 GITHUB_TOKEN；模型实际使用 $DSH_SECRET_ 前缀拼接后的完整名。',
+  addGlobal: '添加全局变量',
+  nameLabel: '变量名',
+  nameHint: '大写字母/数字/下划线，如 GITHUB_TOKEN；模型实际使用 $DSH_VAR_ 前缀拼接后的完整名。',
   valueLabel: '值',
   valueHint: '写入后不可回读；保存于宿主凭据库，不进入对话。',
   descLabel: '描述（可选）',
@@ -30,23 +26,46 @@ const ownZh = {
   save: '保存',
   saving: '保存中…',
   delete: '删除',
-  deleteConfirm: '确认删除 {name}？该变量将立即对后续命令失效。',
   copy: '复制变量名',
   copied: '已复制',
-  emptyGlobal: '暂无全局密钥。添加后 agent 即可通过变量名引用。',
+  emptyGlobal: '暂无全局变量。添加后 agent 即可通过变量名引用。',
   loadFailed: '加载失败，请稍后重试。',
   retry: '重试',
-  // 会话注入控件
-  sessionSecrets: '会话密钥',
-  sessionEmpty: '本会话暂无有默认值的密钥。',
+  // 继承变量
+  inheritedList: '继承变量（宿主环境）',
+  inheritedNote: '来自宿主进程环境，默认纳入注入',
+  inheritedEmpty: '宿主环境中没有可继承的 DSH_VAR_* 变量。',
+  maskGlobal: '全局屏蔽',
+  unmaskGlobal: '恢复注入',
+  maskedBadge: '已屏蔽',
+  maskedGlobalBadge: '已全局屏蔽',
+  // 设置页会话管理
+  sessionManage: '会话变量',
+  sessionPick: '选择会话',
+  sessionPickEmpty: '暂无会话',
+  // 会话面板
+  sessionSecrets: '会话变量',
+  sessionList: '会话变量',
+  sessionEmpty: '本会话暂无变量。',
   sessionHint: '仅当前会话的 shell 命令可用；会话结束或一次性使用即失效。',
-  addSession: '添加会话密钥',
+  addSession: '添加会话变量',
   onceLabel: '一次性（首次使用后销毁）',
+  globalInSession: '全局变量（可在本会话屏蔽）',
+  inheritedInSession: '继承变量（可在本会话屏蔽）',
+  maskSession: '在本会话屏蔽',
+  unmaskSession: '在本会话恢复',
   close: '关闭',
   refresh: '刷新',
   scopeGlobal: '全局',
   scopeSession: '会话',
   scopeOnce: '一次性',
+  scopeInherited: '继承',
+  // `$` 触发补全菜单
+  'menu.title': '变量',
+  'menu.aria': '变量候选',
+  // /var 斜杠命令
+  'command.description': '管理本会话的环境变量（密钥、链接等）',
+  'command.openPanel': '打开会话变量面板',
   // 错误码
   'error.invalid-name': '变量名不合法：大写字母开头，仅字母/数字/下划线，≤64 字符。',
   'error.empty-value': '值不能为空。',
@@ -58,22 +77,18 @@ const ownZh = {
 }
 
 const ownEn = {
-  nav: 'Secret Variables',
-  title: 'Secret Variables',
+  nav: 'Env Variables',
+  title: 'Env Variables',
   description:
-    'Expose secrets to the agent as $DSH_SECRET_* variables: values are injected by the host into each shell call, never enter the transcript or prompt, and do not affect context caching.',
-  globalList: 'Global secrets',
-  colName: 'Variable (model-visible)',
-  colDescription: 'Description',
-  colState: 'State',
-  colActions: 'Actions',
+    'Expose values (keys, links, etc.) to the agent as $DSH_VAR_* variables: values are injected by the host into each shell call, never enter the transcript or prompt, and do not affect context caching.',
+  globalList: 'Global variables',
   configured: 'Configured',
   unconfigured: 'Not configured',
   readonly: 'Read-only source',
-  addGlobal: 'Add global secret',
-  nameLabel: 'Name suffix',
+  addGlobal: 'Add global variable',
+  nameLabel: 'Variable name',
   nameHint:
-    'Uppercase letters/digits/underscore, e.g. GITHUB_TOKEN; the model uses the full name with the $DSH_SECRET_ prefix.',
+    'Uppercase letters/digits/underscore, e.g. GITHUB_TOKEN; the model uses the full name with the $DSH_VAR_ prefix.',
   valueLabel: 'Value',
   valueHint: 'Write-only after saving; stored in the host credential store, never in chat.',
   descLabel: 'Description (optional)',
@@ -81,23 +96,42 @@ const ownEn = {
   save: 'Save',
   saving: 'Saving…',
   delete: 'Delete',
-  deleteConfirm: 'Delete {name}? The variable stops working for subsequent commands immediately.',
   copy: 'Copy variable name',
   copied: 'Copied',
-  emptyGlobal: 'No global secrets yet. Once added, the agent can reference them by name.',
+  emptyGlobal: 'No global variables yet. Once added, the agent can reference them by name.',
   loadFailed: 'Failed to load. Try again later.',
   retry: 'Retry',
-  sessionSecrets: 'Session secrets',
-  sessionEmpty: 'No session secrets yet.',
+  inheritedList: 'Inherited variables (host env)',
+  inheritedNote: 'From the host process environment; injected by default',
+  inheritedEmpty: 'No inheritable DSH_VAR_* variables in the host environment.',
+  maskGlobal: 'Mask globally',
+  unmaskGlobal: 'Resume injection',
+  maskedBadge: 'Masked',
+  maskedGlobalBadge: 'Masked globally',
+  sessionManage: 'Session variables',
+  sessionPick: 'Select session',
+  sessionPickEmpty: 'No sessions',
+  sessionSecrets: 'Session variables',
+  sessionList: 'Session variables',
+  sessionEmpty: 'No session variables yet.',
   sessionHint:
     'Available to shell commands of this session only; expires when the session ends or after one use.',
-  addSession: 'Add session secret',
+  addSession: 'Add session variable',
   onceLabel: 'One-time (destroyed after first use)',
+  globalInSession: 'Global variables (can be masked in this session)',
+  inheritedInSession: 'Inherited variables (can be masked in this session)',
+  maskSession: 'Mask in this session',
+  unmaskSession: 'Resume in this session',
   close: 'Close',
   refresh: 'Refresh',
   scopeGlobal: 'global',
   scopeSession: 'session',
   scopeOnce: 'once',
+  scopeInherited: 'inherited',
+  'menu.title': 'Variables',
+  'menu.aria': 'Variable suggestions',
+  'command.description': "Manage this session's env variables (keys, links, etc.)",
+  'command.openPanel': 'Open the session variable panel',
   'error.invalid-name':
     'Invalid name: start with an uppercase letter; letters/digits/underscore only, ≤64 chars.',
   'error.empty-value': 'Value must not be empty.',

package/src/client/menu-core.ts

@@ -0,0 +1,103 @@
+/**
+ * `$` 触发补全的纯核心（零 DOM / React / cordis，node 直接单测）：
+ * - detectSecretTrigger：光标处 `$<query>` 命中检测（边界规则对齐官方
+ *   input-trigger 的 / 与 @：起草开头、空白后、标点后开闸；词中 $ 不触发）；
+ * - filterCandidates：按 query 过滤+排序（前缀命中优先）；
+ * - applyChipCorrection：渲染文本偏移 → 草稿投影偏移的芯片修正。
+ * @module secret-env/client/menu-core
+ */
+
+/** 一次 `$` 命中：query 为 $ 到光标间的文本，[start, end) 为草稿投影中的令牌区间。 */
+export interface SecretHit {
+  readonly query: string
+  readonly start: number
+  readonly end: number
+}
+
+/** 菜单候选项（全局/会话/继承密钥的统一视图，纯展示数据）。 */
+export interface SecretCandidate {
+  readonly envName: string
+  readonly name: string
+  readonly description: string
+  readonly scope: 'global' | 'session' | 'inherited'
+  readonly once?: boolean
+}
+
+const WORD_CHAR = /[\p{L}\p{N}_]/u
+const TOKEN_CHAR = /^[A-Za-z0-9_]$/
+
+/**
+ * 检测光标处的 `$` 触发令牌。词法：
+ * - 从光标向左扫描，token 字符（字母/数字/下划线）继续，空白直接判负；
+ * - 遇到 `$` 时校验词边界：起草开头 / 前字符为空白 / 前字符为非词字符（标点）
+ *   才开闸——`foo$BAR` 这类词中 $ 不触发（与官方 URL 内 / 不触发同理）；
+ * - 其余字符（如 `{`、`(`）终止扫描。
+ */
+export function detectSecretTrigger(draft: string, caret: number): SecretHit | null {
+  if (caret <= 0 || caret > draft.length) return null
+  for (let i = caret - 1; i >= 0; i--) {
+    const ch = draft.charAt(i)
+    if (/\s/u.test(ch)) return null
+    if (ch !== '$') {
+      if (!TOKEN_CHAR.test(ch)) return null
+      continue
+    }
+    if (i > 0) {
+      const prev = draft.charAt(i - 1)
+      if (!/\s/u.test(prev) && WORD_CHAR.test(prev)) return null
+    }
+    return { query: draft.slice(i + 1, caret), start: i, end: caret }
+  }
+  return null
+}
+
+/** 两个命中的等价判定（抑制重复 setState）。 */
+export function sameHit(a: SecretHit | null, b: SecretHit | null): boolean {
+  if (a === null || b === null) return a === b
+  return a.query === b.query && a.start === b.start && a.end === b.end
+}
+
+/** 按 query 过滤候选（大小写不敏感；变量名前缀命中排前，其余子串命中随后）。 */
+export function filterCandidates(
+  entries: readonly SecretCandidate[],
+  query: string,
+): SecretCandidate[] {
+  const q = query.toUpperCase()
+  const prefixed: SecretCandidate[] = []
+  const partial: SecretCandidate[] = []
+  for (const entry of entries) {
+    if (q === '') {
+      prefixed.push(entry)
+      continue
+    }
+    if (entry.envName.toUpperCase().includes(q) || entry.name.toUpperCase().includes(q)) {
+      if (entry.name.toUpperCase().startsWith(q) || entry.envName.toUpperCase().includes(`_${q}`)) {
+        prefixed.push(entry)
+      } else {
+        partial.push(entry)
+      }
+    }
+  }
+  return [...prefixed, ...partial]
+}
+
+/** 一处芯片修正对：光标前芯片的渲染文本长与草稿投影长。 */
+export interface ChipCorrection {
+  readonly rendered: number
+  readonly draft: number
+}
+
+/**
+ * 渲染文本偏移 → 草稿投影偏移。contenteditable 中芯片（引用装饰器）的
+ * 渲染文本与其草稿投影长度不等，光标渲染偏移需逐芯片修正。
+ */
+export function applyChipCorrection(
+  renderedOffset: number,
+  chipsBeforeCaret: readonly ChipCorrection[],
+): number {
+  let offset = renderedOffset
+  for (const chip of chipsBeforeCaret) {
+    offset -= chip.rendered - chip.draft
+  }
+  return Math.max(0, offset)
+}