dsh-prompt-customizer 0.4.0 → 0.4.2

package/lib/promotion.js

@@ -1,80 +1,80 @@
-/**
- * Epoch-aware 晋级 tracker —— 行为对标 agent-presets 实验预设里的
- * compaction-epoch.mjs：晋级由 durable 会话事件推导（默认首个
- * `tool/call` 或 `assistant/message`），compaction 之后复位（首个压缩后
- * 请求回到 bootstrap 态，直到新的晋级信号），subagent 视为恒已晋级。
- *
- * 状态按 session.id 记忆，冷会话扫一遍 durable log 后 O(1)，因此 resume
- * / reload 重建出相同的阶段。
- */
-
-/** 默认的晋级信号事件。 */
-const DEFAULT_PROMOTE_EVENTS = ['tool/call', 'assistant/message']
-
-/** 构建一个晋级 tracker；promoteEvents 可换成单事件数组。 */
-export function createPromotion(promoteEvents = DEFAULT_PROMOTE_EVENTS) {
-  const promote = new Set(promoteEvents)
-  /** sessionId -> { boundary, promoted } */
-  const state = new Map()
-
-  /** 从 durable log 冷扫描。 */
-  const scan = (session) => {
-    let boundary = -1
-    let promoted = false
-    for (const event of session.events ?? []) {
-      const seq = event.seq ?? 0 // 没有 seq 的事件视为边界之后
-      if (event.type === 'compaction/end') {
-        boundary = seq
-        promoted = false
-        continue
-      }
-      if (promote.has(event.type) && seq > boundary) promoted = true
-    }
-    const entry = { boundary, promoted }
-    state.set(session.id, entry)
-    return entry
-  }
-
-  return {
-    /**
-     * 当前 agent 的阶段。agent 缺席（纯清单读取等）或子代理一律已晋级；
-     * ponytail: 只覆盖 compaction 边界这一种 epoch，未跟踪 fork 语义。
-     * 升级路径：参照 anchored-standard 的 fork-aware 边界扩展 scan。
-     */
-    status(agent) {
-      const session = agent?.session
-      if (!session) return { boundary: -1, promoted: true }
-      if ((session.header?.delegationDepth ?? 0) > 0) return { boundary: -1, promoted: true }
-      return state.get(session.id) ?? scan(session)
-    },
-
-    /** 增量喂入 `session/event`，避免每次装配全量扫描。 */
-    observe(session, event) {
-      const entry = state.get(session.id)
-      if (entry === undefined) return
-      const seq = event.seq ?? 0
-      if (event.type === 'compaction/end') {
-        state.set(session.id, { boundary: seq, promoted: false })
-        return
-      }
-      if (promote.has(event.type) && seq > entry.boundary && !entry.promoted) {
-        state.set(session.id, { ...entry, promoted: true })
-      }
-    },
-  }
-}
-
-/**
- * 解析一个会话所属的 agent 预设 id：header 记录创建时值，
- * `agent-preset/selected` 事件记录空白期切换后的值，后者优先。
- */
-export function presetOfSession(session) {
-  if (!session) return undefined
-  let preset = typeof session.header?.agentPreset === 'string' ? session.header.agentPreset : undefined
-  for (const event of session.events ?? []) {
-    if (event.type === 'agent-preset/selected' && typeof event.data?.agentPreset === 'string') {
-      preset = event.data.agentPreset
-    }
-  }
-  return preset
-}
+/**
+ * Epoch-aware 晋级 tracker —— 行为对标 agent-presets 实验预设里的
+ * compaction-epoch.mjs：晋级由 durable 会话事件推导（默认首个
+ * `tool/call` 或 `assistant/message`），compaction 之后复位（首个压缩后
+ * 请求回到 bootstrap 态，直到新的晋级信号），subagent 视为恒已晋级。
+ *
+ * 状态按 session.id 记忆，冷会话扫一遍 durable log 后 O(1)，因此 resume
+ * / reload 重建出相同的阶段。
+ */
+
+/** 默认的晋级信号事件。 */
+const DEFAULT_PROMOTE_EVENTS = ['tool/call', 'assistant/message']
+
+/** 构建一个晋级 tracker；promoteEvents 可换成单事件数组。 */
+export function createPromotion(promoteEvents = DEFAULT_PROMOTE_EVENTS) {
+  const promote = new Set(promoteEvents)
+  /** sessionId -> { boundary, promoted } */
+  const state = new Map()
+
+  /** 从 durable log 冷扫描。 */
+  const scan = (session) => {
+    let boundary = -1
+    let promoted = false
+    for (const event of session.events ?? []) {
+      const seq = event.seq ?? 0 // 没有 seq 的事件视为边界之后
+      if (event.type === 'compaction/end') {
+        boundary = seq
+        promoted = false
+        continue
+      }
+      if (promote.has(event.type) && seq > boundary) promoted = true
+    }
+    const entry = { boundary, promoted }
+    state.set(session.id, entry)
+    return entry
+  }
+
+  return {
+    /**
+     * 当前 agent 的阶段。agent 缺席（纯清单读取等）或子代理一律已晋级；
+     * ponytail: 只覆盖 compaction 边界这一种 epoch，未跟踪 fork 语义。
+     * 升级路径：参照 anchored-standard 的 fork-aware 边界扩展 scan。
+     */
+    status(agent) {
+      const session = agent?.session
+      if (!session) return { boundary: -1, promoted: true }
+      if ((session.header?.delegationDepth ?? 0) > 0) return { boundary: -1, promoted: true }
+      return state.get(session.id) ?? scan(session)
+    },
+
+    /** 增量喂入 `session/event`，避免每次装配全量扫描。 */
+    observe(session, event) {
+      const entry = state.get(session.id)
+      if (entry === undefined) return
+      const seq = event.seq ?? 0
+      if (event.type === 'compaction/end') {
+        state.set(session.id, { boundary: seq, promoted: false })
+        return
+      }
+      if (promote.has(event.type) && seq > entry.boundary && !entry.promoted) {
+        state.set(session.id, { ...entry, promoted: true })
+      }
+    },
+  }
+}
+
+/**
+ * 解析一个会话所属的 agent 预设 id：header 记录创建时值，
+ * `agent-preset/selected` 事件记录空白期切换后的值，后者优先。
+ */
+export function presetOfSession(session) {
+  if (!session) return undefined
+  let preset = typeof session.header?.agentPreset === 'string' ? session.header.agentPreset : undefined
+  for (const event of session.events ?? []) {
+    if (event.type === 'agent-preset/selected' && typeof event.data?.agentPreset === 'string') {
+      preset = event.data.agentPreset
+    }
+  }
+  return preset
+}

package/lib/schema.js

@@ -1,125 +1,125 @@
-import Schema from '@deepseek-ai/schemastery'
-import { DEFAULT_ENV_BLOCKLIST } from './vars.js'
-
-/** 本插件的设置命名空间（小写 kebab-case）。 */
-export const NS = 'prompt-customizer'
-
-/**
- * 插件的配置 schema，同时作为设置命名空间的 schema。
- * GUI 的编辑以这个形状写入 `~/.dsh/settings.yaml`。
- */
-export const Config = Schema.object({
-  // 按名称屏蔽这些提示词段（从装配后的系统提示词中过滤掉）。
-  sections: Schema.array(Schema.string()).default([]),
-  // 每阶段独立段屏蔽（与 tools 阶段化对称）：引导期 / 压缩受控期的额外
-  // 屏蔽名单，非空时在该阶段生效并优先于全局 sections；空列表回落全局。
-  sectionsBootstrap: Schema.array(Schema.string()).default([]),
-  sectionsCompaction: Schema.array(Schema.string()).default([]),
-  // 按名称替换某个段的文本（保持原顺序）。
-  replace: Schema.dict(Schema.string()).default({}),
-  // 注入 / 覆盖段（按 名称 + 顺序 + 文本）。`custom` 标记本插件生成的段
-  // （隐藏标记，用于识别其为可删除，跨预设依然成立，不依赖名字碰撞）。
-  // `phase` 控制阶段生效：`always` 恒定；`bootstrap` 只在会话未晋级时注入；
-  // `compaction` 只在「压缩后仍未晋级」时注入（独立于 bootstrap，拥有自己的
-  // order 空间）；`active` 只在晋级后注入（晋级 = 首个 durable 的 tool/call
-  // 或 assistant/message；compaction 之后复位，subagent 视为已晋级）。
-  inject: Schema.array(Schema.object({
-    name: Schema.string().required(),
-    order: Schema.number().default(120),
-    text: Schema.string().required(),
-    phase: Schema.string().default('always'),
-    custom: Schema.boolean().default(false),
-  })).default([]),
-  // 工具目录过滤：只有 exclude 黑名单（列出的工具对模型隐藏）。三份名单对应三个
-  // 阶段，各管各的、互不继承：`exclude` 只在已晋级（常驻期）生效，`bootstrap`
-  // 只在未晋级（引导期）生效，`compaction` 只在「compaction 之后仍未晋级」的
-  // 阶段生效；空名单 = 该阶段什么都不隐藏。没有白名单语义 —— 见 lib/effective.js
-  // 的 applyToolFilter 注释。
-  tools: Schema.object({
-    exclude: Schema.array(Schema.string()).default([]),
-    // 该阶段要「加回来」的工具：被该阶段裁掉、但注册表里仍有的，装配时查回
-    // schema 追加。注册表里没有的（别的预设独有）加不进来。
-    add: Schema.array(Schema.string()).default([]),
-    bootstrap: Schema.object({
-      exclude: Schema.array(Schema.string()).default([]),
-      add: Schema.array(Schema.string()).default([]),
-    }).default({}),
-    compaction: Schema.object({
-      exclude: Schema.array(Schema.string()).default([]),
-      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(),
-    name: Schema.string().required(),
-    data: Schema.object({
-      sections: Schema.array(Schema.string()),
-      // 每阶段独立段屏蔽名单：缺省 = 旧文件，应用时保留当前值不抹掉。
-      sectionsBootstrap: Schema.array(Schema.string()),
-      sectionsCompaction: Schema.array(Schema.string()),
-      replace: Schema.dict(Schema.string()),
-      // 相对顺序：每个条目记录它应跟随的前一段，以及这段属于哪个阶段
-      // （缺省 always = 旧快照的单一全局序；同名不同 phase 的条目 = 该段在
-      // 多个阶段各有自己的位置）。
-      order: Schema.array(Schema.object({
-        name: Schema.string().required(),
-        after: Schema.string(),
-        text: Schema.string(),
-        custom: Schema.boolean().default(false),
-        phase: Schema.string(),
-      })),
-      tools: Schema.object({
-        exclude: Schema.array(Schema.string()),
-        add: Schema.array(Schema.string()),
-        bootstrap: Schema.object({
-          exclude: Schema.array(Schema.string()),
-          add: Schema.array(Schema.string()),
-        }),
-        compaction: Schema.object({
-          exclude: Schema.array(Schema.string()),
-          add: Schema.array(Schema.string()),
-        }),
-      }),
-    }),
-  })).default([]),
-  // 当前已应用预设的 id（同一时间只有一个生效）。
-  activePreset: Schema.string(),
-  // 按 agent 预设 id 的字段级覆盖：某个 agent 预设的 override 中，非空的
-  // 字段整体接管全局默认，空缺 / 空列表的字段继续回落全局。键是
-  // dsh-agent-presets 的预设目录名（即会话 header.agentPreset 记录的 id）。
-  overrides: Schema.dict(Schema.object({
-    sections: Schema.array(Schema.string()),
-    sectionsBootstrap: Schema.array(Schema.string()),
-    sectionsCompaction: Schema.array(Schema.string()),
-    replace: Schema.dict(Schema.string()),
-    inject: Schema.array(Schema.object({
-      name: Schema.string().required(),
-      order: Schema.number().default(120),
-      text: Schema.string().required(),
-      phase: Schema.string().default('always'),
-      custom: Schema.boolean().default(false),
-    })),
-    tools: Schema.object({
-      exclude: Schema.array(Schema.string()),
-      add: Schema.array(Schema.string()),
-      bootstrap: Schema.object({
-        exclude: Schema.array(Schema.string()),
-        add: Schema.array(Schema.string()),
-      }),
-      compaction: Schema.object({
-        exclude: Schema.array(Schema.string()),
-        add: Schema.array(Schema.string()),
-      }),
-    }),
-  })).default({}),
+import Schema from '@deepseek-ai/schemastery'
+import { DEFAULT_ENV_BLOCKLIST } from './vars.js'
+
+/** 本插件的设置命名空间（小写 kebab-case）。 */
+export const NS = 'prompt-customizer'
+
+/**
+ * 插件的配置 schema，同时作为设置命名空间的 schema。
+ * GUI 的编辑以这个形状写入 `~/.dsh/settings.yaml`。
+ */
+export const Config = Schema.object({
+  // 按名称屏蔽这些提示词段：常驻期（晋级后）的独立屏蔽名单。
+  sections: Schema.array(Schema.string()).default([]),
+  // 每阶段独立段屏蔽（与 tools 阶段化对称）：引导期 / 压缩受控期各自的
+  // 屏蔽名单。三态互不继承、互不影响 —— 一个阶段的屏蔽不波及另一个阶段。
+  sectionsBootstrap: Schema.array(Schema.string()).default([]),
+  sectionsCompaction: Schema.array(Schema.string()).default([]),
+  // 按名称替换某个段的文本（保持原顺序）。
+  replace: Schema.dict(Schema.string()).default({}),
+  // 注入 / 覆盖段（按 名称 + 顺序 + 文本）。`custom` 标记本插件生成的段
+  // （隐藏标记，用于识别其为可删除，跨预设依然成立，不依赖名字碰撞）。
+  // `phase` 控制阶段生效：`always` 恒定；`bootstrap` 只在会话未晋级时注入；
+  // `compaction` 只在「压缩后仍未晋级」时注入（独立于 bootstrap，拥有自己的
+  // order 空间）；`active` 只在晋级后注入（晋级 = 首个 durable 的 tool/call
+  // 或 assistant/message；compaction 之后复位，subagent 视为已晋级）。
+  inject: Schema.array(Schema.object({
+    name: Schema.string().required(),
+    order: Schema.number().default(120),
+    text: Schema.string().required(),
+    phase: Schema.string().default('always'),
+    custom: Schema.boolean().default(false),
+  })).default([]),
+  // 工具目录过滤：只有 exclude 黑名单（列出的工具对模型隐藏）。三份名单对应三个
+  // 阶段，各管各的、互不继承：`exclude` 只在已晋级（常驻期）生效，`bootstrap`
+  // 只在未晋级（引导期）生效，`compaction` 只在「compaction 之后仍未晋级」的
+  // 阶段生效；空名单 = 该阶段什么都不隐藏。没有白名单语义 —— 见 lib/effective.js
+  // 的 applyToolFilter 注释。
+  tools: Schema.object({
+    exclude: Schema.array(Schema.string()).default([]),
+    // 该阶段要「加回来」的工具：被该阶段裁掉、但注册表里仍有的，装配时查回
+    // schema 追加。注册表里没有的（别的预设独有）加不进来。
+    add: Schema.array(Schema.string()).default([]),
+    bootstrap: Schema.object({
+      exclude: Schema.array(Schema.string()).default([]),
+      add: Schema.array(Schema.string()).default([]),
+    }).default({}),
+    compaction: Schema.object({
+      exclude: Schema.array(Schema.string()).default([]),
+      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(),
+    name: Schema.string().required(),
+    data: Schema.object({
+      sections: Schema.array(Schema.string()),
+      // 每阶段独立段屏蔽名单：缺省 = 旧文件，应用时保留当前值不抹掉。
+      sectionsBootstrap: Schema.array(Schema.string()),
+      sectionsCompaction: Schema.array(Schema.string()),
+      replace: Schema.dict(Schema.string()),
+      // 相对顺序：每个条目记录它应跟随的前一段，以及这段属于哪个阶段
+      // （缺省 always = 旧快照的单一全局序；同名不同 phase 的条目 = 该段在
+      // 多个阶段各有自己的位置）。
+      order: Schema.array(Schema.object({
+        name: Schema.string().required(),
+        after: Schema.string(),
+        text: Schema.string(),
+        custom: Schema.boolean().default(false),
+        phase: Schema.string(),
+      })),
+      tools: Schema.object({
+        exclude: Schema.array(Schema.string()),
+        add: Schema.array(Schema.string()),
+        bootstrap: Schema.object({
+          exclude: Schema.array(Schema.string()),
+          add: Schema.array(Schema.string()),
+        }),
+        compaction: Schema.object({
+          exclude: Schema.array(Schema.string()),
+          add: Schema.array(Schema.string()),
+        }),
+      }),
+    }),
+  })).default([]),
+  // 当前已应用预设的 id（同一时间只有一个生效）。
+  activePreset: Schema.string(),
+  // 按 agent 预设 id 的字段级覆盖：某个 agent 预设的 override 中，非空的
+  // 字段整体接管全局默认，空缺 / 空列表的字段继续回落全局。键是
+  // dsh-agent-presets 的预设目录名（即会话 header.agentPreset 记录的 id）。
+  overrides: Schema.dict(Schema.object({
+    sections: Schema.array(Schema.string()),
+    sectionsBootstrap: Schema.array(Schema.string()),
+    sectionsCompaction: Schema.array(Schema.string()),
+    replace: Schema.dict(Schema.string()),
+    inject: Schema.array(Schema.object({
+      name: Schema.string().required(),
+      order: Schema.number().default(120),
+      text: Schema.string().required(),
+      phase: Schema.string().default('always'),
+      custom: Schema.boolean().default(false),
+    })),
+    tools: Schema.object({
+      exclude: Schema.array(Schema.string()),
+      add: Schema.array(Schema.string()),
+      bootstrap: Schema.object({
+        exclude: Schema.array(Schema.string()),
+        add: Schema.array(Schema.string()),
+      }),
+      compaction: Schema.object({
+        exclude: Schema.array(Schema.string()),
+        add: Schema.array(Schema.string()),
+      }),
+    }),
+  })).default({}),
 })

package/lib/sectionOps.d.mts

@@ -1,32 +1,32 @@
-/** sectionOps.mjs 的类型声明（仅供电类型检查；运行时代码在 .mjs 中）。 */
-
-/** 名义阶段键：引导期 / 常驻期 / 压缩受控期（恒定全部显示）。 */
-export type PhaseKey = 'bootstrap' | 'active' | 'compaction'
-
-export function sectionListOf(key: PhaseKey): 'global' | 'bootstrap' | 'compaction'
-export function injectPhaseOf(key: PhaseKey): 'bootstrap' | 'active' | 'compaction'
-export function acceptsInjectFor(key: PhaseKey, phase: string): boolean
-export function deniedNames(cfg: unknown, key: PhaseKey): string[]
-/** 本部分当前的注入身份：phase 注入阶段、names 可见段名、custom 自定义段名、
- *  text 本阶段生效的用户文本（自定义段文本 + 系统段在本阶段的替换文本）、
- *  order 本阶段草稿序（都是 name → 值 的映射 / 集合）。 */
-export function injectedAt(cfg: unknown, key: PhaseKey): {
-  phase: 'bootstrap' | 'active' | 'compaction'
-  names: Set<string>
-  custom: Set<string>
-  text: Map<string, string>
-  order: Map<string, number>
-}
-export function blockPatch(cfg: unknown, key: PhaseKey, name: string, blocked: boolean): Record<string, unknown>
-export function reorderInsert<T extends object>(
-  rows: T[],
-  dragName: string,
-  targetName: string,
-  pos: 'above' | 'below',
-  newRow?: T | null,
-): T[] | null
-export function phaseInjectEntries<T extends object>(
-  cfg: unknown,
-  key: PhaseKey,
-  rows: T[],
-): Array<Record<string, unknown>>
+/** sectionOps.mjs 的类型声明（仅供电类型检查；运行时代码在 .mjs 中）。 */
+
+/** 名义阶段键：引导期 / 常驻期 / 压缩受控期（恒定全部显示）。 */
+export type PhaseKey = 'bootstrap' | 'active' | 'compaction'
+
+export function sectionListOf(key: PhaseKey): 'global' | 'bootstrap' | 'compaction'
+export function injectPhaseOf(key: PhaseKey): 'bootstrap' | 'active' | 'compaction'
+export function acceptsInjectFor(key: PhaseKey, phase: string): boolean
+export function deniedNames(cfg: unknown, key: PhaseKey): string[]
+/** 本部分当前的注入身份：phase 注入阶段、names 可见段名、custom 自定义段名、
+ *  text 本阶段生效的用户文本（自定义段文本 + 系统段在本阶段的替换文本）、
+ *  order 本阶段草稿序（都是 name → 值 的映射 / 集合）。 */
+export function injectedAt(cfg: unknown, key: PhaseKey): {
+  phase: 'bootstrap' | 'active' | 'compaction'
+  names: Set<string>
+  custom: Set<string>
+  text: Map<string, string>
+  order: Map<string, number>
+}
+export function blockPatch(cfg: unknown, key: PhaseKey, name: string, blocked: boolean): Record<string, unknown>
+export function reorderInsert<T extends object>(
+  rows: T[],
+  dragName: string,
+  targetName: string,
+  pos: 'above' | 'below',
+  newRow?: T | null,
+): T[] | null
+export function phaseInjectEntries<T extends object>(
+  cfg: unknown,
+  key: PhaseKey,
+  rows: T[],
+): Array<Record<string, unknown>>