dsh-prompt-customizer 0.3.1 → 0.4.0

package/lib/effective.js

@@ -107,3 +107,52 @@ export function pickSectionsForStatus(config, status) {
   if (!status.promoted && Array.isArray(bootstrap) && bootstrap.length > 0) return bootstrap
   return []
 }
+
+/**
+ * 段级策略：屏蔽 → 替换 → 注入 → 排序，作用于任意来源的基础段列表。
+ *
+ * 瀑布流装配与 assemble 强制覆盖（forceSections）共用同一份实现 —— 输入
+ * `baseSections` 可以是瀑布流里其它插件过滤后的段，也可以是注册表
+ * `layers.merge()` 的原始段定义。后一种输入就是「以本插件为准」的关键：
+ * 预设插件的阶段裁段与宿主的 complete 整段接管都发生在瀑布流内/后，
+ * 而强制覆盖在方法边界用这份原始定义重建 sections，前两者再无机会改写。
+ * 条目只需 { name, text }；order 在映射时按数组序补上（与注册表顺序一致），
+ * 保证稳定排序，与注入段的虚拟 order 空间一致。
+ */
+export function applySectionPolicy(baseSections, cfg, status) {
+  const denied = new Set([...(cfg.sections ?? []), ...pickSectionsForStatus(cfg, status)])
+  const replace = cfg.replace ?? {}
+  const injectList = filterInjectByPhase(cfg.inject, status)
+  let sections = baseSections
+    .filter((section) => !denied.has(section.name))
+    .map((section, i) =>
+      Object.hasOwn(replace, section.name) ? { ...section, order: i, text: replace[section.name] } : { ...section, order: i },
+    )
+  for (const item of injectList) {
+    // 被屏蔽的段直接跳过 —— 上面已经把它们过滤掉了。
+    if (denied.has(item.name)) continue
+    const index = sections.findIndex((section) => section.name === item.name)
+    if (index >= 0) {
+      // 已存在的段：覆盖 order 来控制拼接顺序。文本按「本阶段注入文本 → 该
+      // 段当前文本」取（后者可能已被全局 replace 改过）—— injectList 已经按
+      // 阶段筛过，所以带 phase 的文本只作用在本阶段，三个阶段各改各的；全局
+      // replace 字典是跨阶段的（旧语义），只在没有阶段文本时生效。
+      sections[index] = {
+        ...sections[index],
+        text: item.text ? item.text : sections[index].text,
+        order: item.order,
+      }
+    } else if (item.custom === true || Object.hasOwn(replace, item.name) || item.text) {
+      // 装配里没有这个名字：只有「本插件自撰的 custom 段」「被替换的段」
+      // 「自带文本的注入段」才允许新建条目。只带 order 的空文本系统名必须
+      // 跳过 —— 它通常来自快照里混进的别的预设独有段名（并集池会带回来），
+      // 新建就变成一条空白幽灵段，实打实进最终提示词。
+      sections.push({ name: item.name, order: item.order, text: item.text || replace[item.name] })
+    }
+  }
+  // 虚拟 order 排序：order 缺省按 0，稳定排序保持系统段原始相对顺序；
+  // 注入段携带各自的 order（120+ 落在系统段之后，或被重排到任意断点），
+  // 以 order 升序决定注入顺序 —— 与「每阶段独立名单」配合即每阶段独立序。
+  sections.sort((a, b) => (a.order ?? 0) - (b.order ?? 0))
+  return sections
+}

package/lib/index.js

@@ -28,24 +28,32 @@
  * 另一面：若该 scope 有以 `complete: true` 注册的段（persona 整段接管），宿主
  * 会在装配瀑布流**之后**把 sections 强制还原成那一条段（见 dsh-system-prompt
  * 的 assemble 契约），本插件的段级屏蔽 / 替换 / 注入 / 排序对其完全不生效
- * （工具过滤不受影响）。预览过滤器会探测并把段名作为 `takenOverBy` 透出，
- * 让提示词 / 预览两个 Tab 就这件事说同一句话，而不是各说各话。
+ * （工具过滤不受影响）。`forceSections`（默认开）为此提供终极手段：包装宿主
+ * 的 assemble，在方法边界用注册表原始段重建 sections —— 预设插件的阶段裁段
+ * （实测 liangshen / warmupbetter 等 preset 过滤器全部 prepend: true）与
+ * complete 整段接管都无法再改写结果。关闭时预览过滤器会探测并把段名作为
+ * `takenOverBy` 透出，让提示词 / 预览两个 Tab 就这件事说同一句话。
  */
 
 import fs from 'node:fs'
 import os from 'node:os'
 import path from 'node:path'
 import { Config, NS } from './schema.js'
-import { mergeConfig, filterInjectByPhase, pickToolsFilter, pickSectionsForStatus, applyToolFilter } from './effective.js'
+import { mergeConfig, pickToolsFilter, pickSectionsForStatus, applyToolFilter, applySectionPolicy } from './effective.js'
 import { createPromotion, presetOfSession } from './promotion.js'
 import { createConfigStore, readLegacySection } from './store.js'
 import { createCatalog } from './catalog.js'
+import { registerVariables, listVariableNames } from './vars.js'
 
 export const name = 'prompt-customizer'
 // settings 仍被注入：只读 documentPath 做一次性旧版迁移。cordis 对未在
 // inject 里声明的服务调用 ctx.get 会抛错，漏声明会让整个插件加载失败。
 export const inject = ['settings', 'systemPrompt', 'tools']
 
+/** assemble 强制覆盖的「原始方法」登记键：跨插件 HMR 重载共享（Symbol.for），
+ *  重载后永远包在原始方法之上，避免层层套娃。见 apply() 里的 forceSections。 */
+const PATCHED = Symbol.for('prompt-customizer:assemble-pristine')
+
 /** harness home；ponytail: DSH_HOME 为推测的官方环境变量，若宿主日后提供
  *  正式的 home 解析 API 应换过去。回退 `~/.dsh`。 */
 function dshHome() {
@@ -166,31 +174,53 @@ export function apply(ctx, entry = {}) {
     try { ctx.logger?.warn?.(message) } catch { /* logger 缺席只是不再告警 */ }
   }
 
-  // 3) 装配瀑布流：实时应用字段级 override、屏蔽 / 替换 / 注入 / 阶段化工具过滤。
+  // 提示词变量注册（内置系统事实 + process.env 全量，黑名单过滤）：宿主只有
+  // provider / model / cwd 三个，段文本里的其余 {{name}} 一律严格报错。这里
+  // 通过官方扩展点 systemPrompt.variable() 补齐。懒同步：每次装配入口比对黑名单
+  // 签名，变了才注销重注册 —— 配置写入 / 外部手改都在下次装配自然生效。
+  let varsSignature
+  let varsDispose
+  const syncVariables = () => {
+    try {
+      const blocklist = read().envBlocklist ?? []
+      const signature = JSON.stringify(blocklist)
+      if (signature === varsSignature) return
+      try { varsDispose?.() } catch { /* 注销失败不阻塞重注册 */ }
+      varsDispose = registerVariables(ctx.get('systemPrompt'), blocklist)
+      varsSignature = signature
+    } catch (error) {
+      warnOnce(`prompt-customizer: 提示词变量注册失败（{{…}} 仍只有宿主注册的变量可用）：${String((error && error.message) || error)}`)
+    }
+  }
+
+  // 3) 装配目标解析（瀑布流与 assemble 强制覆盖共用）：生效配置 = 显式预览
+  //    提示 > 会话所属 agent 预设（字段级覆盖）> 全局默认。预览 hint 优先于
+  //    会话事件推导的阶段，让同一份配置能渲染 bootstrap / compaction / active
+  //    三种阶段视图。boundary 语义与 promotion.status 一致（-1 = 从未压缩）。
+  const resolveTarget = (context) => {
+    const raw = read()
+    const id = typeof context?.promptCustomizerPreset === 'string'
+      ? context.promptCustomizerPreset
+      : presetOfSession(context?.agent?.session)
+    const cfg = mergeConfig(raw, raw.overrides?.[id])
+    const phaseHint = typeof context?.promptCustomizerPhase === 'string'
+      ? context.promptCustomizerPhase
+      : undefined
+    const status = phaseHint === 'bootstrap' ? { promoted: false, boundary: -1 }
+      : phaseHint === 'compaction' ? { promoted: false, boundary: 1 }
+      : phaseHint === 'active' ? { promoted: true, boundary: -1 }
+      : promotion.status(context?.agent)
+    return { raw, cfg, status }
+  }
+
+  // 装配瀑布流：实时应用字段级 override、屏蔽 / 替换 / 注入 / 阶段化工具过滤。
   ctx.on('system-prompt/assemble', async (assembly, context, next) => {
     // 下游错误原样传播；只有本过滤器自身的逻辑被兜底。
     const assembled = await next()
     try {
-      const raw = read()
-      // 生效配置：显式预览提示 > 会话所属 agent 预设（字段级覆盖）> 全局默认。
-      const id = typeof context?.promptCustomizerPreset === 'string'
-        ? context.promptCustomizerPreset
-        : presetOfSession(context?.agent?.session)
-      const cfg = mergeConfig(raw, raw.overrides?.[id])
-      // 预览 hint：显式 promptCustomizerPhase 时以它替代由会话事件推导的
-      // 实际阶段，让同一份配置能渲染 bootstrap / compaction / active 三种
-      // 阶段视图。boundary 语义与 promotion.status 一致（-1 = 从未压缩）。
-      const phaseHint = typeof context?.promptCustomizerPhase === 'string'
-        ? context.promptCustomizerPhase
-        : undefined
-      const status = phaseHint === 'bootstrap' ? { promoted: false, boundary: -1 }
-        : phaseHint === 'compaction' ? { promoted: false, boundary: 1 }
-        : phaseHint === 'active' ? { promoted: true, boundary: -1 }
-        : promotion.status(context?.agent)
+      const { raw, cfg, status } = resolveTarget(context)
       const denied = new Set([...(cfg.sections ?? []), ...pickSectionsForStatus(cfg, status)])
       const replace = cfg.replace ?? {}
-      // inject 按当前阶段模式筛选（bootstrap/active/compact 三态注入互相独立）。
-      const injectList = filterInjectByPhase(cfg.inject, status)
       const te = pickToolsFilter(cfg.tools, status)
 
       // 预览专用的预过滤视图（提示词 / 工具 / 预览三个 Tab 的统一数据源）：
@@ -218,37 +248,9 @@ export function apply(ctx, entry = {}) {
       const baseSections = Array.isArray(assembled.sections) ? assembled.sections : []
       const baseTools = Array.isArray(assembled.tools) ? assembled.tools : []
 
-      let sections = baseSections
-        .filter((section) => !denied.has(section.name))
-        .map((section, i) =>
-          Object.hasOwn(replace, section.name) ? { ...section, order: i, text: replace[section.name] } : { ...section, order: i },
-        )
-      for (const item of injectList) {
-        // 被屏蔽的段直接跳过 —— 上面已经把它们过滤掉了。
-        if (denied.has(item.name)) continue
-        const index = sections.findIndex((section) => section.name === item.name)
-        if (index >= 0) {
-          // 已存在的段：覆盖 order 来控制拼接顺序。文本按「本阶段注入文本 → 该
-          // 段当前文本」取（后者可能已被全局 replace 改过）—— injectList 已经按
-          // 阶段筛过，所以带 phase 的文本只作用在本阶段，三个阶段各改各的；全局
-          // replace 字典是跨阶段的（旧语义），只在没有阶段文本时生效。
-          sections[index] = {
-            ...sections[index],
-            text: item.text ? item.text : sections[index].text,
-            order: item.order,
-          }
-        } else if (item.custom === true || Object.hasOwn(replace, item.name) || item.text) {
-          // 装配里没有这个名字：只有「本插件自撰的 custom 段」「被替换的段」
-          // 「自带文本的注入段」才允许新建条目。只带 order 的空文本系统名必须
-          // 跳过 —— 它通常来自快照里混进的别的预设独有段名（并集池会带回来），
-          // 新建就变成一条空白幽灵段，实打实进最终提示词。
-          sections.push({ name: item.name, order: item.order, text: item.text || replace[item.name] })
-        }
-      }
-      // 虚拟 order 排序：order 缺省按 0，稳定排序保持系统段原始相对顺序；
-      // 注入段携带各自的 order（120+ 落在系统段之后，或被重排到任意断点），
-      // 以 order 升序决定注入顺序 —— 与「每阶段独立名单」配合即每阶段独立序。
-      sections.sort((a, b) => (a.order ?? 0) - (b.order ?? 0))
+      // 段级策略（屏蔽 / 替换 / 注入 / 排序）由 effective.applySectionPolicy
+      // 统一实现：瀑布流与 assemble 强制覆盖共用同一份逻辑。
+      const sections = applySectionPolicy(baseSections, cfg, status)
 
       const tools = appendAddedTools(ctx, context?.scope, applyToolFilter(baseTools, te), te.add, te.exclude)
 
@@ -269,8 +271,9 @@ export function apply(ctx, entry = {}) {
         }
         // 预览才探测（运行时装配零额外开销）：有 complete 段时宿主要在水流
         // 之后把 sections 整段还原，本插件的段级定制不会进最终提示词。
+        // forceSections 开启时该接管已被 assemble 包装绕过，警告不再成立。
         const takenOver = detectCompletePrompt(ctx, context?.scope)
-        if (takenOver !== undefined) result.promptCustomizerTakenOver = takenOver
+        if (takenOver !== undefined && raw?.forceSections === false) result.promptCustomizerTakenOver = takenOver
         // 本插件实际产出的段名清单：下游还有别的手段会丢弃段（实测 liangshen
         // 引导期由预设自身规则把 20 段砍到 1 段，注册表里并没有 complete 段），
         // 所以 buildPreview 还要拿这份与最终装配比对，做机制无关的兜底探测。
@@ -283,7 +286,57 @@ export function apply(ctx, entry = {}) {
     }
   })
 
-  // 4) 共享 webserver 上的清单路由（web profile 里必有）。
+  // 4) 强制覆盖（forceSections，默认开）：包装宿主 systemPrompt.assemble。
+  //    预设插件的 prepend 军备竞赛（实测 liangshen / warmupbetter 等 preset 的
+  //    assemble 过滤器全部 `prepend: true`，standing mount 后注册永远排在本插件
+  //    前面）与宿主的 complete 整段接管（瀑布流之后还原 sections）都无法用瀑布流
+  //    位次对抗；唯一确定性的手段是在方法边界重建 sections —— 从注册表
+  //    layers.merge() 取原始段定义（全局 + scope 链遮蔽后，scope = agent 时沿
+  //    链解析到 standing 预设层），套用本插件的屏蔽 / 替换 / 注入 / 排序，
+  //    tools / contexts / variables 保持宿主与预设行为。
+  //    ponytail: 依赖宿主未承诺的 service 方法与 layers 公开字段；宿主升级可能
+  //    静默失效 —— 失效时本包装不生效、瀑布流过滤仍在，可设 forceSections: false
+  //    退回旧行为，预览的 takenOverBy / lostSections 探测仍可作运行时自检。
+  const sp = ctx.get('systemPrompt')
+  if (sp && typeof sp.assemble === 'function') {
+    // 只在首个 apply() 记一次原始方法；插件 HMR 重载重跑 apply() 时用新闭包
+    // 重新包装，但永远包在原始方法之上，避免层层套娃。
+    const pristine = sp[PATCHED]?.orig ?? sp.assemble.bind(sp)
+    sp[PATCHED] = { orig: pristine }
+    sp.assemble = async (context = {}) => {
+      // 变量先于装配同步：宿主在 pristine 内部解析 {{name}}，注册必须发生在前。
+      syncVariables()
+      const result = await pristine(context)
+      if (read()?.forceSections === false) return result
+      try {
+        const { cfg, status } = resolveTarget(context)
+        const defs = [...sp.layers.merge(context?.scope, (layer) => layer.sections).values()]
+          .sort((a, b) => a.order - b.order)
+        const baseSections = defs.map((section) => ({
+          name: section.name,
+          // 与宿主一致：动态段文本调用生成函数（可能被调用两次 —— 宿主装配
+          // 内部已调用一次；动态段通常是纯函数，可接受）。
+          text: typeof section.text === 'function' ? section.text(context) : section.text,
+        }))
+        const sections = applySectionPolicy(baseSections, cfg, status)
+        const patched = { ...result, sections }
+        // 预览的「产出 vs 模型所见」比对以强制覆盖后的最终段为准。
+        if (context?.promptCustomizerBase === true) {
+          patched.promptCustomizerEmitted = sections.map((section) => String(section.name))
+        }
+        return patched
+      } catch (error) {
+        warnOnce(`prompt-customizer: 强制覆盖 assemble 失败，本次回退为宿主结果：${String((error && error.message) || error)}`)
+        // 覆盖失效时恢复接管告警：否则 complete 段接管回来了、却因为上面的
+        // forceSections 开关 gate 而没有任何提示（静默降级）。
+        const takenOver = detectCompletePrompt(ctx, context?.scope)
+        if (takenOver !== undefined) result.promptCustomizerTakenOver = takenOver
+        return result
+      }
+    }
+  }
+
+  // 5) 共享 webserver 上的清单路由（web profile 里必有）。
   //    用 ctx.get() 保持可选 —— 未在 `inject` 中声明就去访问 ctx.webServer
   //    会抛 "cannot get property without inject"。
   const webserver = ctx.get('webServer')
@@ -304,7 +357,9 @@ export function apply(ctx, entry = {}) {
           const resolved = id ? await resolveScopeFor(ctx, id) : await resolveStandardScope(ctx)
           const scopeKey = resolved ?? (id ? await resolveStandardScope(ctx) : undefined)
           const inventory = await buildInventory(ctx, read(), scopeKey, id, catalog)
-          writeJson(res, 200, { ...inventory, scopeResolved: resolved !== undefined })
+          // 变量清单随单：先同步注册（黑名单可能刚改过），再列出当前可用名字。
+          syncVariables()
+          writeJson(res, 200, { ...inventory, scopeResolved: resolved !== undefined, variables: listVariableNames(read().envBlocklist ?? []) })
         } catch (error) {
           writeJson(res, 500, {
             ok: false,
@@ -470,6 +525,27 @@ export function apply(ctx, entry = {}) {
     })
     ctx.effect(() => disposeConfigUnset, 'prompt-customizer: config unset route')
 
+    // 恢复初始状态：清空一切定制并关闭 forceSections —— 与「不装本插件」等效，
+    // 无需卸载 / 重启（forceSections: false 时 assemble 包装直接放行宿主原样，
+    // 瀑布流里空配置的过滤是无操作）。文件本身保留，避免卸载重装后迁移逻辑
+    // 再次触发；之后要重新启用定制，把 forceSections 改回 true 或删除该行即可。
+    const disposeConfigReset = webserver.register({
+      kind: 'exact',
+      path: '/api/prompt-customizer/config/reset',
+      handler: async (_req, res) => {
+        try {
+          store.writeSection({ forceSections: false })
+          writeJson(res, 200, { ok: true, config: read() })
+        } catch (error) {
+          writeJson(res, 500, {
+            ok: false,
+            error: String(error && error.message ? error.message : error),
+          })
+        }
+      },
+    })
+    ctx.effect(() => disposeConfigReset, 'prompt-customizer: config reset route')
+
     // 批量保存路由：UI「统一保存按钮」的唯一写盘通道。body { target?, patch }，
     // patch 只认业务字段（只认下列业务字段，含每阶段独立段名单），字段值为 null 表示
     // 删除（回退默认/全局）。target 缺省写全局顶层；target 为 agent 预设 id

package/lib/schema.js

@@ -1,4 +1,5 @@
 import Schema from '@deepseek-ai/schemastery'
+import { DEFAULT_ENV_BLOCKLIST } from './vars.js'
 
 /** 本插件的设置命名空间（小写 kebab-case）。 */
 export const NS = 'prompt-customizer'
@@ -48,6 +49,15 @@ export const Config = Schema.object({
       add: Schema.array(Schema.string()).default([]),
     }).default({}),
   }).default({}),
+  // 强制覆盖（默认开）：包装宿主的 assemble，直接从注册表原始段重建最终
+  // 提示词段 —— 预设插件的阶段裁段（实测 liangshen / warmupbetter 等 preset
+  // 过滤器全部 prepend: true）与宿主 complete 整段接管都无法再改写结果；
+  // tools / contexts 保持宿主与预设行为。设 false 退回瀑布流内过滤。
+  forceSections: Schema.boolean().default(true),
+  // process.env 变量黑名单：env 全量注册为提示词变量（{{env_xxx}}），命中
+  // 本名单的键不注册 —— env 里常有密钥，进了提示词就会随请求发给模型。
+  // 条目支持 `*` 通配、大小写不敏感；预填常见密钥类键，界面可增删。
+  envBlocklist: Schema.array(Schema.string()).default(DEFAULT_ENV_BLOCKLIST),
   // 预设：完整的定制快照（提示词 + 工具配置，含每阶段独立名单与阶段目录）。
   presets: Schema.array(Schema.object({
     id: Schema.string().required(),

package/lib/vars.js

@@ -0,0 +1,147 @@
+/**
+ * 提示词变量注册 —— 让段文本里的 `{{name}}` 拿到宿主三件套之外的值。
+ *
+ * 宿主 system-prompt 只由 agent-loop 注册 provider / model / cwd 三个变量，
+ * 渲染又是严格模式：引用未注册的名字直接抛错。本模块通过官方扩展点
+ * `ctx.systemPrompt.variable(name, provider)` 追加两类变量：
+ *
+ *  1. 内置系统事实（date / time / hostname / …）——每次装配现算，天然动态；
+ *  2. process.env 全量 —— 键名规范化为 `env_<小写>` 后注册，命中黑名单的
+ *     键不注册（env 里常有密钥，进了提示词就会随请求发给模型）。
+ *
+ * 约束来自宿主：变量名必须匹配 /^[a-z][a-z0-9_]*$/；provider 返回 undefined
+ * 会让渲染抛错，所以所有 provider 都保证返回字符串；与宿主重名会抛错，
+ * 保留字直接跳过（同名注册逐个 try 兜底，别家插件先注册了也只是跳过那一个）。
+ */
+
+import os from 'node:os'
+
+/** 与宿主 system-prompt 的 VARIABLE_NAME 完全一致（不满足就不可能注册成功）。 */
+const VARIABLE_NAME = /^[a-z][a-z0-9_]*$/
+
+/** agent-loop 已注册的三个名字：重复注册会抛错，永远避开。 */
+const RESERVED = new Set(['provider', 'model', 'cwd'])
+
+/** 预填黑名单：常见密钥 / 凭据类环境变量。条目支持 `*` 通配，大小写不敏感。 */
+export const DEFAULT_ENV_BLOCKLIST = [
+  '*SECRET*',
+  '*TOKEN*',
+  '*PASSWORD*',
+  '*PASSWD*',
+  '*CREDENTIAL*',
+  '*API_KEY*',
+  '*APIKEY*',
+  '*ACCESS_KEY*',
+  '*PRIVATE_KEY*',
+  '*AUTH*',
+  '*_DSN',
+  '*CONNECTION_STRING*',
+  'DATABASE_URL',
+]
+
+/**
+ * 黑名单条目编译成匹配函数：含 `*` 按通配（`*` 匹配任意串），否则整串
+ * 精确比较；统一大小写不敏感（env 键多为大写，用户多写小写）。
+ */
+function compileEntries(blocklist) {
+  const matchers = []
+  for (const entry of Array.isArray(blocklist) ? blocklist : []) {
+    if (typeof entry !== 'string') continue
+    const text = entry.trim()
+    if (text === '') continue
+    if (text.includes('*')) {
+      const pattern = '^' + text.split('*').map((part) => part.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')).join('.*') + '$'
+      let re
+      try { re = new RegExp(pattern, 'i') } catch { continue }
+      matchers.push((key) => re.test(key))
+    } else {
+      const lower = text.toLowerCase()
+      matchers.push((key) => key.toLowerCase() === lower)
+    }
+  }
+  return matchers
+}
+
+/** env 键是否被黑名单挡下（不注册 = 提示词里引用它会得到宿主的「未注册」报错）。 */
+export function isBlockedEnvKey(key, blocklist) {
+  return compileEntries(blocklist).some((match) => match(key))
+}
+
+/**
+ * 把任意 env 键映射为合法变量名：`env_` 前缀 + 小写 + 非法字符归并为 `_`。
+ * 例：`PATH` → `env_path`，`USER.NAME` → `env_user_name`。映射结果必然
+ * 匹配宿主命名规则；空键返回 undefined。
+ */
+export function envVarName(key) {
+  const core = String(key).toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_+|_+$/g, '')
+  if (core === '') return undefined
+  const name = `env_${core}`
+  return VARIABLE_NAME.test(name) ? name : undefined
+}
+
+/** 内置系统事实变量：名字 → 无参提供器（注册时包一层保证返回字符串）。 */
+function builtinProviders() {
+  const pad = (n) => String(n).padStart(2, '0')
+  const isoDate = (d) => `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`
+  const time = (d) => `${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`
+  const weekdays = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday']
+  return {
+    date: () => isoDate(new Date()),
+    time: () => time(new Date()),
+    datetime: () => { const d = new Date(); return `${isoDate(d)} ${time(d)}` },
+    weekday: () => weekdays[new Date().getDay()],
+    hostname: () => { try { return os.hostname() } catch { return '' } },
+    platform: () => process.platform,
+    arch: () => process.arch,
+    username: () => { try { return os.userInfo().username } catch { return '' } },
+    home: () => { try { return os.homedir() } catch { return '' } },
+    shell: () => process.env.SHELL ?? process.env.COMSPEC ?? '',
+    locale: () => { try { return Intl.DateTimeFormat().resolvedOptions().locale ?? '' } catch { return '' } },
+    node_version: () => process.version,
+  }
+}
+
+/** 当前会注册的变量名清单（内置 + 未被黑名单挡下的 env）：供清单路由展示。 */
+export function listVariableNames(blocklist) {
+  const names = new Set(Object.keys(builtinProviders()))
+  const matchers = compileEntries(blocklist)
+  const seen = new Set()
+  for (const key of Object.keys(process.env)) {
+    if (matchers.some((match) => match(key))) continue
+    const name = envVarName(key)
+    if (name === undefined || seen.has(name)) continue
+    seen.add(name)
+    names.add(name)
+  }
+  return [...names].sort()
+}
+
+/**
+ * 向宿主注册全部变量，返回注销函数。黑名单变化时由调用方先注销再重注册
+ * （见 lib/index.js 的懒同步：装配入口比对签名，配置外改也在下次装配生效）。
+ */
+export function registerVariables(systemPrompt, blocklist) {
+  const disposes = []
+  const reg = (name, provider) => {
+    if (RESERVED.has(name)) return
+    try { disposes.push(systemPrompt.variable(name, provider)) } catch { /* 同名已被别处注册：跳过 */ }
+  }
+  for (const [name, provider] of Object.entries(builtinProviders())) {
+    // provider 必须返回字符串：严格渲染把 undefined 当错误。
+    reg(name, () => { const value = provider(); return typeof value === 'string' ? value : '' })
+  }
+  const matchers = compileEntries(blocklist)
+  const seen = new Set()
+  for (const key of Object.keys(process.env)) {
+    if (matchers.some((match) => match(key))) continue
+    const name = envVarName(key)
+    if (name === undefined || seen.has(name)) continue
+    seen.add(name)
+    reg(name, () => process.env[key] ?? '')
+  }
+  return () => {
+    for (const dispose of disposes) {
+      try { dispose() } catch { /* 注销失败不阻塞其余注销 */ }
+    }
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-prompt-customizer",
   "description": "System-prompt & tool customizer for DeepSeek Harness with a settings-panel UI: block / replace / inject prompt sections by name, and hide tools from the model catalog by exclude/include. Config lives in the plugin's own ~/.dsh/prompt-customizer/config.yaml (auto-migrated once from the legacy settings.yaml section).",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "type": "module",
   "private": false,
   "main": "lib/index.js",

package/src/client/PresetsTab.tsx

@@ -18,7 +18,7 @@ interface Notice {
   text: string
 }
 
-export function PresetsTab({ cfg, inv, phases, t, writePatch, writeGlobal, saveAsPreset, forkSource }: {
+export function PresetsTab({ cfg, inv, phases, t, writePatch, writeGlobal, saveAsPreset, forkSource, onReset, envBlocklist }: {
   cfg: Config
   inv: Inventory | null
   /** Panel 并行拉取的三阶段装配：快照只捕获当前装配里真实存在的段。 */
@@ -32,9 +32,15 @@ export function PresetsTab({ cfg, inv, phases, t, writePatch, writeGlobal, saveA
   saveAsPreset: (name: string) => Promise<boolean>
   /** fork 来源的显示名（当前编辑目标预设）；undefined = 全局目标，由服务端回落默认预设。 */
   forkSource: string | undefined
+  /** 恢复初始状态：清空全部定制并关闭 forceSections（与不装插件等效）。 */
+  onReset: () => void
+  /** 全局环境变量黑名单（永远顶层字段，不分作用域）；导出随行、导入并集。 */
+  envBlocklist: string[]
 }): ReactElement {
   const presets = cfg.presets ?? []
   const [name, setName] = useState('')
+  // 黑名单「添加」输入框的暂存值。
+  const [blockInput, setBlockInput] = useState('')
   // 「存为 agent 预设」的名字与在途标记（与服务端往返期间禁用按钮）。
   const [agentName, setAgentName] = useState('')
   const [creating, setCreating] = useState(false)
@@ -100,7 +106,7 @@ export function PresetsTab({ cfg, inv, phases, t, writePatch, writeGlobal, saveA
   // 时）回退为下载。saved/downloaded = 成功；用户取消单独提示，不算失败。
   const exportPreset = async (preset: Preset): Promise<void> => {
     try {
-      const res = await exportPresetFile(preset)
+      const res = await exportPresetFile(preset, undefined, envBlocklist)
       if (res.ok) show('ok', t('exportOk'))
       else if (res.cancelled) show('ok', t('exportCancel'))
       else show('error', `${t('exportFail')}${res.message ? ': ' + res.message : ''}`)
@@ -110,15 +116,24 @@ export function PresetsTab({ cfg, inv, phases, t, writePatch, writeGlobal, saveA
   }
 
   // 解析导入文本 → 去重追加 → 提示新增数量。解析失败提示错误。
+  // 单对象格式的文件还可能随行携带全局环境变量黑名单：与当前名单并集合并
+  // （只增不减），新增条数一并报进提示。
   const importParsed = (text: string): void => {
     try {
       const parsed = decodePresetExport(text)
       const next = addImportedPresets(presets, parsed, genId)
       const added = next.length - presets.length
-      if (added <= 0) show('ok', t('importNone'))
+      const fileBlock = parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)
+        && Array.isArray((parsed as { envBlocklist?: unknown }).envBlocklist)
+        ? ((parsed as { envBlocklist?: unknown[] }).envBlocklist ?? []).filter((e): e is string => typeof e === 'string')
+        : []
+      const fresh = fileBlock.filter((e) => !envBlocklist.includes(e))
+      if (fresh.length > 0) writeGlobal('envBlocklist', [...envBlocklist, ...fresh])
+      const mergedNote = fresh.length > 0 ? t('importBlockMerge', { count: fresh.length }) : ''
+      if (added <= 0) show('ok', t('importNone') + mergedNote)
       else {
         writeGlobal('presets', next)
-        show('ok', `${t('importOk')} (+${added})`)
+        show('ok', `${t('importOk')} (+${added})${mergedNote}`)
       }
     } catch (e) {
       show('error', `${t('importFail')}: ${e instanceof Error ? e.message : String(e)}`)
@@ -160,6 +175,17 @@ export function PresetsTab({ cfg, inv, phases, t, writePatch, writeGlobal, saveA
     setCreating(false)
   }
 
+  // 环境变量黑名单：全局字段，改动即写（与 forceSections 同一通道，不经草稿）。
+  const removeBlockEntry = (entry: string): void => {
+    writeGlobal('envBlocklist', envBlocklist.filter((e) => e !== entry))
+  }
+  const addBlockEntry = (): void => {
+    const entry = blockInput.trim()
+    setBlockInput('')
+    if (entry === '' || envBlocklist.includes(entry)) return
+    writeGlobal('envBlocklist', [...envBlocklist, entry])
+  }
+
   return h('div', { style: s.list }, [
     notice ? h('div', { style: notice.kind === 'ok' ? s.noticeOk : s.error }, notice.text) : null,
     h('div', { style: s.injectBox }, [
@@ -184,6 +210,58 @@ export function PresetsTab({ cfg, inv, phases, t, writePatch, writeGlobal, saveA
         h('input', { ref: fileRef, type: 'file', accept: '.json,application/json', style: { display: 'none' }, onChange: onImportFile }),
       ]),
     ]),
+    h('div', { style: s.injectBox }, [
+      h('div', { style: s.rowTitle }, t('forceTitle')),
+      h('div', { style: s.muted }, t('forceHint')),
+      h('div', { style: s.injectRow }, [
+        h('label', { style: s.switchWrap }, [
+          h('input', {
+            type: 'checkbox',
+            checked: cfg.forceSections !== false,
+            // forceSections 是全局字段，与 presets/activePreset 一样永远写顶层。
+            onChange: (e: ChangeEvent<HTMLInputElement>) => writeGlobal('forceSections', e.target.checked),
+          }),
+          h('span', { style: cfg.forceSections !== false ? s.badgeOk : s.badgeBlocked },
+            cfg.forceSections !== false ? t('forceOn') : t('forceOff')),
+        ]),
+      ]),
+    ]),
+    h('div', { style: s.injectBox }, [
+      h('div', { style: s.rowTitle }, t('envBlockTitle')),
+      h('div', { style: s.muted }, t('envBlockHint')),
+      h('div', { style: { ...s.toolWrap, marginTop: 6 } }, envBlocklist.map((entry) => h('span', {
+        key: entry,
+        style: { ...s.toolChip, display: 'inline-flex', alignItems: 'center', gap: 4 },
+      }, [
+        entry,
+        h('span', { style: { cursor: 'pointer' }, title: t('delete'), onClick: () => removeBlockEntry(entry) }, '×'),
+      ]))),
+      envBlocklist.length === 0 ? h('div', { style: s.muted }, t('envBlockEmpty')) : null,
+      h('div', { style: { ...s.injectRow, marginTop: 6 } }, [
+        h('input', {
+          style: { ...s.input, flex: 1 },
+          placeholder: t('envBlockAdd'),
+          value: blockInput,
+          onChange: (e: ChangeEvent<HTMLInputElement>) => setBlockInput(e.target.value),
+        }),
+        h('button', { style: s.mini, disabled: blockInput.trim() === '', onClick: addBlockEntry }, t('envBlockAddAction')),
+      ]),
+      h('details', { style: { marginTop: 6 } }, [
+        h('summary', { style: { ...s.muted, cursor: 'pointer' } }, `${t('envVarsTitle')} (${inv?.variables?.length ?? 0})`),
+        h('div', { style: { ...s.muted, marginTop: 4 } }, t('envVarsHint')),
+        h('div', { style: { ...s.toolWrap, marginTop: 4 } }, (inv?.variables ?? []).map((name) => h('span', { key: name, style: s.toolChip }, `{{${name}}}`))),
+      ]),
+    ]),
+    h('div', { style: s.injectBox }, [
+      h('div', { style: s.rowTitle }, t('resetTitle')),
+      h('div', { style: s.muted }, t('resetHint')),
+      h('div', { style: s.injectRow }, [
+        h('button', { style: s.mini, onClick: () => {
+          // 二次确认：清空不可撤销，必须明确点头才动手。
+          if (window.confirm(t('resetConfirm'))) onReset()
+        } }, t('resetAction')),
+      ]),
+    ]),
     presets.length === 0 ? h('div', { style: s.muted }, t('empty')) : null,
     presets.map((preset) => {
       const active = cfg.activePreset === preset.id

package/src/client/SectionsTab.tsx

@@ -137,9 +137,12 @@ export function SectionsTab({ cfg, inv, phases, target, globalSections, ownedSec
   // 逐阶段的「段级定制没进最终提示词」警示：每个部分按自己那一阶段的装配结果
   // 判定 —— 有 complete 段整段接管就说接管，否则探测本插件产出的段是否被下游
   // 丢弃（丢弃规则不止 persona complete 一种）。
+  // forceSections（默认开）已在装配入口绕开这两类压制，警示不再成立；只有
+  // 显式关闭（降级路径）或强制覆盖失效（服务端会恢复 takenOverBy）才显示。
   const partNote = (key: PhaseViewKey): ReactElement | null => {
     const view = phases?.[key]
     if (view === undefined || view === null) return null
+    if (cfg.forceSections !== false) return null
     if (view.takenOverBy !== undefined) {
       return h('div', { style: s.noticeWarn }, t('sectionsTakenOver', { name: view.takenOverBy }))
     }
@@ -463,7 +466,7 @@ export function SectionsTab({ cfg, inv, phases, target, globalSections, ownedSec
               h('textarea', { style: s.editInput, value: draft, onChange: (e: ChangeEvent<HTMLTextAreaElement>) => setDraft(e.target.value), rows: 3 }),
               h('div', { style: s.injectRow }, [
                 h('button', { style: s.mini, onClick: () => commitReplace(key, row) }, t('save')),
-                h('button', { style: s.mini, onClick: () => setEditing(null) }, t('clearInput')),
+                h('button', { style: s.mini, onClick: () => setDraft('') }, t('clearInput')),
                 !row.custom && (row.override || Object.hasOwn(cfg.replace ?? {}, row.name))
                   ? h('button', { style: s.mini, onClick: () => restoreReplace(key, row) }, t('restore'))
                   : null,