dsh-plugin-prompt-tool 0.6.2 → 0.7.0

package/engine/layers.mjs

@@ -1,8 +1,8 @@
-/**
- * layers — 非 pre-step 的五个官方层级接线。
- * 所有注册都只作用于本插件提示词配置;单条失败 warnOnce 后继续。
- */
-
+/**
+ * layers — 非 pre-step 的五个官方层级接线。
+ * 所有注册都只作用于本插件提示词配置;单条失败 warnOnce 后继续。
+ */
+
 import {
   getService,
   isDelegated,
@@ -11,60 +11,85 @@ import {
   parseToolNames,
 } from './shared.mjs'
 import { interpolateVariables, interpolateStatic } from './interpolate.mjs'
-
-const name = 'prompt-config-engine'
-
-/** 单条文本型配置的完整文本:texts 数组按空行拼接（单一文本字段）。 */
-function configText(config) {
-  return config.texts
-    .map((item) => interpolateStatic(item, config.variables))
-    .filter((item) => item.length > 0)
-    .join('\n\n')
-}
-
-/** agent/request 与 tools/* 层的作用域过滤。 */
-function matchesAgentScope(config, agent) {
-  if (agent === undefined) return true
-  const delegated = isDelegated(agent.session)
-  if (config.audience === 'main' && delegated) return false
-  if (config.audience === 'subagent' && !delegated) return false
-  return matchesModel(config.modelScope, agent.options?.model)
-}
-
-/** 文本型层分组:merged 模式按位置分组,否则每条独立。 */
-function textLayerGroups(configs) {
-  const sorted = [...configs].sort((a, b) => a.order - b.order)
-  const groups = []
-  const index = new Map()
-  for (const config of sorted) {
-    const key = config.mergeMode === 'merged' ? `merged:${config.position ?? ''}` : undefined
-    if (key === undefined) {
-      groups.push([config])
-      continue
-    }
-    let at = index.get(key)
-    if (at === undefined) {
-      at = groups.length
-      index.set(key, at)
-      groups.push([])
-    }
-    groups[at].push(config)
-  }
-  return groups
-}
-
+
+const name = 'prompt-config-engine'
+
+/** 单条文本型配置的完整文本:texts 数组按空行拼接（单一文本字段）。 */
+function configText(config) {
+  return config.texts
+    .map((item) => interpolateStatic(item, config.variables))
+    .filter((item) => item.length > 0)
+    .join('\n\n')
+}
+
+/** agent/request 与 tools/* 层的作用域过滤。 */
+function matchesAgentScope(config, agent) {
+  if (agent === undefined) return true
+  const delegated = isDelegated(agent.session)
+  if (config.audience === 'main' && delegated) return false
+  if (config.audience === 'subagent' && !delegated) return false
+  return matchesModel(config.modelScope, agent.options?.model)
+}
+
+/** 文本型层分组:merged 模式按位置分组,否则每条独立。 */
+function textLayerGroups(configs) {
+  const sorted = [...configs].sort((a, b) => a.order - b.order)
+  const groups = []
+  const index = new Map()
+  for (const config of sorted) {
+    const key = config.mergeMode === 'merged' ? `merged:${config.position ?? ''}` : undefined
+    if (key === undefined) {
+      groups.push([config])
+      continue
+    }
+    let at = index.get(key)
+    if (at === undefined) {
+      at = groups.length
+      index.set(key, at)
+      groups.push([])
+    }
+    groups[at].push(config)
+  }
+  return groups
+}
+
+/** persona 段标记（官方 deployment:persona + 旧名 persona）。 */
+function isPersonaSection(config) {
+  const sectionName = config?.params?.sectionName
+  return sectionName === 'deployment:persona' || sectionName === 'persona'
+}
+
 /** system-section:注册静态 system prompt 段(支持官方 {{variable}} 渲染与 merged 拼接)。 */
 function wireSystemSections(ctx, configs, warnOnce) {
-  const systemPrompt = getService(ctx, 'systemPrompt')
-  if (systemPrompt === undefined || typeof systemPrompt.section !== 'function') {
-    if (configs.length > 0) warnOnce(`${name}: systemPrompt service unavailable — system-section configs skipped`)
-    return
-  }
-  for (const group of textLayerGroups(configs)) {
-    const base = group[0]
-    try {
-      const text = group.map((config) => configText(config)).filter((item) => item.length > 0).join('\n\n')
-      if (text.length === 0) continue
+  const systemPrompt = getService(ctx, 'systemPrompt')
+  if (systemPrompt === undefined || typeof systemPrompt.section !== 'function') {
+    if (configs.length > 0) warnOnce(`${name}: systemPrompt service unavailable — system-section configs skipped`)
+    return
+  }
+  // 子代理 persona 分支卡（audience=subagent + 人设段标记）：不独立注册（同名段冲突），
+  // 作为主 persona 段的子代理分支——装配时子代理使用子卡文本（替换主会话人设）。
+  const subPersona = configs
+    .filter((config) => config.audience === 'subagent' && isPersonaSection(config))
+    .sort((a, b) => a.order - b.order)[0]
+  const registerable = configs.filter((config) => !(config.audience === 'subagent' && isPersonaSection(config)))
+  for (const group of textLayerGroups(registerable)) {
+    const base = group[0]
+    try {
+      const groupText = group.map((config) => configText(config)).filter((item) => item.length > 0).join('\n\n')
+      if (groupText.length === 0) continue
+      const hasAudience = group.some((config) => config.audience != null)
+      // persona 主段 + 存在子代理分支：text 按 agent 分支（子代理 = 子卡文本，替换语义；
+      // 无子卡 = 继承主 persona）。官方 AssembleContext 运行时含 agent（assembleContextFor 注入）。
+      const isPersonaMain = base.audience == null && isPersonaSection(base)
+      const text = isPersonaMain && subPersona !== undefined
+        ? (context) => isDelegated(context?.agent?.session) ? configText(subPersona) : groupText
+        : hasAudience
+          ? (context) => group
+              .filter((config) => matchesAgentScope(config, context?.agent))
+              .map((config) => configText(config))
+              .filter((item) => item.length > 0)
+              .join('\n\n')
+          : groupText
       keepDisposer(ctx, systemPrompt.section({
         name: typeof base.params?.sectionName === 'string' && base.params.sectionName.length > 0 ? base.params.sectionName : base.id,
         order: base.order,
@@ -81,144 +106,144 @@ function wireSystemSections(ctx, configs, warnOnce) {
     }
   }
 }
-
-/** runtime-context:注册动态运行时上下文(晋升后由 context-gate 差分投影;支持 merged 拼接与 placeholder 函数 provider)。 */
-function wireRuntimeContexts(ctx, configs, warnOnce) {
-  const systemPrompt = getService(ctx, 'systemPrompt')
-  if (systemPrompt === undefined || typeof systemPrompt.context !== 'function') {
-    if (configs.length > 0) warnOnce(`${name}: systemPrompt service unavailable — runtime-context configs skipped`)
-    return
-  }
-  const staticConfigs = configs.filter((config) => config.strategy !== 'placeholder')
-  for (const group of textLayerGroups(staticConfigs)) {
-    const base = group[0]
-    try {
-      const text = group.map((config) => configText(config)).filter((item) => item.length > 0).join('\n\n')
-      if (text.length === 0) continue
-      keepDisposer(ctx, systemPrompt.context({
-        name: typeof base.params?.contextName === 'string' && base.params.contextName.length > 0 ? base.params.contextName : base.id,
-        order: base.order,
-        text,
-      }), `${name}: context ${base.id}`)
-    } catch (error) {
-      warnOnce(`${name}: runtime-context config ${base.id} failed: ${String(error?.message ?? error)}`)
-    }
-  }
-  // placeholder:官方 context 接受函数 provider,在每次 assembly 时动态填充。
-  const placeholders = configs.filter((config) => config.strategy === 'placeholder')
-    .sort((a, b) => a.order - b.order)
-  for (const config of placeholders) {
-    try {
-      const resolver = config.resolve
-      keepDisposer(ctx, systemPrompt.context({
-        name: typeof config.params?.contextName === 'string' && config.params.contextName.length > 0 ? config.params.contextName : config.id,
-        order: config.order,
-        text: async (assembly) => {
-          const agent = assembly?.agent
-          const session = agent?.session
-          const resolved = await resolver({ ctx, agent, session, decision: { kind: 'ok', messages: [] }, messages: [] })
-          if (resolved === null || resolved === undefined) return ''
-          const variables = { ...config.variables, ...(resolved.variables !== null && typeof resolved.variables === 'object' ? resolved.variables : {}) }
-          if (config.texts.length > 0) return interpolateVariables(config.texts.join('\n\n'), variables, session)
-          return typeof resolved.text === 'string' ? interpolateVariables(resolved.text, variables, session) : ''
-        },
-      }), `${name}: context ${config.id}`)
-    } catch (error) {
-      warnOnce(`${name}: runtime-context placeholder ${config.id} failed: ${String(error?.message ?? error)}`)
-    }
-  }
-}
-
-/** agent-request:对冻结的 LlmCallConfig 做浅合并 / 整体替换。 */
-function wireAgentRequests(ctx, configs, warnOnce) {
-  for (const config of configs) {
-    ctx.on('agent/request', async (payload, next) => {
-      const base = await next()
-      try {
-        if (!matchesAgentScope(config, payload?.agent)) return base
-        const patch = config.params?.patch !== null && typeof config.params?.patch === 'object' && !Array.isArray(config.params.patch)
-          ? config.params.patch
-          : {}
-        if (config.params?.replace === true) return { ...patch }
-        return { ...base, ...patch }
-      } catch (error) {
-        warnOnce(`${name}: agent-request config ${config.id} failed: ${String(error?.message ?? error)}`)
-        return base
-      }
-    })
-  }
-}
-
-/** 把流替换为提示词配置文本的最小合法 chunk 序列。 */
-async function* replacedStream(text) {
-  yield { type: 'block-start', index: 0, blockType: 'text' }
-  yield { type: 'text-delta', index: 0, text }
-  yield { type: 'block-end', index: 0, block: { type: 'text', text } }
-}
-
-/** llm-stream:pass 透传;replace 用提示词配置文本替代整个模型流。 */
-function wireLlmStreams(ctx, configs, warnOnce) {
-  for (const config of configs) {
-    ctx.on('llm/stream', (options, next) => {
-      try {
-        const mode = config.params?.mode ?? 'pass'
-        if (mode === 'replace' && config.texts.length > 0 && matchesModel(config.modelScope, options?.model)) {
-          return replacedStream(config.texts.join('\n\n'))
-        }
-        return next()
-      } catch (error) {
-        warnOnce(`${name}: llm-stream config ${config.id} failed: ${String(error?.message ?? error)}`)
-        return next()
-      }
-    })
-  }
-}
-
-/** tool-pipeline:pre-execute 判定、execute 包装、post-execute 结果替换/阻断。 */
-function wireToolPipelines(ctx, configs, warnOnce) {
-  for (const config of configs) {
-    const names = parseToolNames(config.params?.toolNames)
-    const matchesTool = (exec) => names.length === 0 || names.includes(exec?.name)
-    ctx.on('tools/pre-execute', async (exec, next) => {
-      try {
-        if (!matchesTool(exec) || !matchesAgentScope(config, exec?.agent)) return next()
-        const decision = config.params?.preDecision ?? 'allow'
-        if (decision === 'allow') return next()
-        if (decision === 'deny') {
-          return { kind: 'deny', reason: String(config.params?.denyReason ?? `${config.name}: denied by prompt config`) }
-        }
-        if (decision === 'ask') return { kind: 'ask' }
-        return next()
-      } catch (error) {
-        warnOnce(`${name}: tool-pipeline(pre) config ${config.id} failed: ${String(error?.message ?? error)}`)
-        return next()
-      }
-    })
-    ctx.on('tools/post-execute', async (exec, result, next) => {
-      try {
-        if (!matchesTool(exec) || !matchesAgentScope(config, exec?.agent)) return next()
-        const action = config.params?.postAction ?? 'accept'
-        if (action === 'accept') return next()
-        if (action === 'replace' && config.texts.length > 0) {
-          return { kind: 'accept', content: [{ type: 'text', text: config.texts.join('\n\n') }] }
-        }
-        if (action === 'block') {
-          return { kind: 'block', feedback: [{ type: 'text', text: config.texts.length > 0 ? config.texts.join('\n\n') : `${config.name}: blocked by prompt config` }] }
-        }
-        return next()
-      } catch (error) {
-        warnOnce(`${name}: tool-pipeline(post) config ${config.id} failed: ${String(error?.message ?? error)}`)
-        return next()
-      }
-    })
-  }
-}
-
-/** 把非 pre-step 提示词配置接入其声明的官方层级通道。 */
-export function wireLayers(ctx, configs, warnOnce) {
-  wireSystemSections(ctx, configs.filter((config) => config.layer === 'system-section'), warnOnce)
-  wireRuntimeContexts(ctx, configs.filter((config) => config.layer === 'runtime-context'), warnOnce)
-  wireAgentRequests(ctx, configs.filter((config) => config.layer === 'agent-request'), warnOnce)
-  wireLlmStreams(ctx, configs.filter((config) => config.layer === 'llm-stream'), warnOnce)
-  wireToolPipelines(ctx, configs.filter((config) => config.layer === 'tool-pipeline'), warnOnce)
-}
+
+/** runtime-context:注册动态运行时上下文(晋升后由 context-gate 差分投影;支持 merged 拼接与 placeholder 函数 provider)。 */
+function wireRuntimeContexts(ctx, configs, warnOnce) {
+  const systemPrompt = getService(ctx, 'systemPrompt')
+  if (systemPrompt === undefined || typeof systemPrompt.context !== 'function') {
+    if (configs.length > 0) warnOnce(`${name}: systemPrompt service unavailable — runtime-context configs skipped`)
+    return
+  }
+  const staticConfigs = configs.filter((config) => config.strategy !== 'placeholder')
+  for (const group of textLayerGroups(staticConfigs)) {
+    const base = group[0]
+    try {
+      const text = group.map((config) => configText(config)).filter((item) => item.length > 0).join('\n\n')
+      if (text.length === 0) continue
+      keepDisposer(ctx, systemPrompt.context({
+        name: typeof base.params?.contextName === 'string' && base.params.contextName.length > 0 ? base.params.contextName : base.id,
+        order: base.order,
+        text,
+      }), `${name}: context ${base.id}`)
+    } catch (error) {
+      warnOnce(`${name}: runtime-context config ${base.id} failed: ${String(error?.message ?? error)}`)
+    }
+  }
+  // placeholder:官方 context 接受函数 provider,在每次 assembly 时动态填充。
+  const placeholders = configs.filter((config) => config.strategy === 'placeholder')
+    .sort((a, b) => a.order - b.order)
+  for (const config of placeholders) {
+    try {
+      const resolver = config.resolve
+      keepDisposer(ctx, systemPrompt.context({
+        name: typeof config.params?.contextName === 'string' && config.params.contextName.length > 0 ? config.params.contextName : config.id,
+        order: config.order,
+        text: async (assembly) => {
+          const agent = assembly?.agent
+          const session = agent?.session
+          const resolved = await resolver({ ctx, agent, session, decision: { kind: 'ok', messages: [] }, messages: [] })
+          if (resolved === null || resolved === undefined) return ''
+          const variables = { ...config.variables, ...(resolved.variables !== null && typeof resolved.variables === 'object' ? resolved.variables : {}) }
+          if (config.texts.length > 0) return interpolateVariables(config.texts.join('\n\n'), variables, session)
+          return typeof resolved.text === 'string' ? interpolateVariables(resolved.text, variables, session) : ''
+        },
+      }), `${name}: context ${config.id}`)
+    } catch (error) {
+      warnOnce(`${name}: runtime-context placeholder ${config.id} failed: ${String(error?.message ?? error)}`)
+    }
+  }
+}
+
+/** agent-request:对冻结的 LlmCallConfig 做浅合并 / 整体替换。 */
+function wireAgentRequests(ctx, configs, warnOnce) {
+  for (const config of configs) {
+    ctx.on('agent/request', async (payload, next) => {
+      const base = await next()
+      try {
+        if (!matchesAgentScope(config, payload?.agent)) return base
+        const patch = config.params?.patch !== null && typeof config.params?.patch === 'object' && !Array.isArray(config.params.patch)
+          ? config.params.patch
+          : {}
+        if (config.params?.replace === true) return { ...patch }
+        return { ...base, ...patch }
+      } catch (error) {
+        warnOnce(`${name}: agent-request config ${config.id} failed: ${String(error?.message ?? error)}`)
+        return base
+      }
+    })
+  }
+}
+
+/** 把流替换为提示词配置文本的最小合法 chunk 序列。 */
+async function* replacedStream(text) {
+  yield { type: 'block-start', index: 0, blockType: 'text' }
+  yield { type: 'text-delta', index: 0, text }
+  yield { type: 'block-end', index: 0, block: { type: 'text', text } }
+}
+
+/** llm-stream:pass 透传;replace 用提示词配置文本替代整个模型流。 */
+function wireLlmStreams(ctx, configs, warnOnce) {
+  for (const config of configs) {
+    ctx.on('llm/stream', (options, next) => {
+      try {
+        const mode = config.params?.mode ?? 'pass'
+        if (mode === 'replace' && config.texts.length > 0 && matchesModel(config.modelScope, options?.model)) {
+          return replacedStream(config.texts.join('\n\n'))
+        }
+        return next()
+      } catch (error) {
+        warnOnce(`${name}: llm-stream config ${config.id} failed: ${String(error?.message ?? error)}`)
+        return next()
+      }
+    })
+  }
+}
+
+/** tool-pipeline:pre-execute 判定、execute 包装、post-execute 结果替换/阻断。 */
+function wireToolPipelines(ctx, configs, warnOnce) {
+  for (const config of configs) {
+    const names = parseToolNames(config.params?.toolNames)
+    const matchesTool = (exec) => names.length === 0 || names.includes(exec?.name)
+    ctx.on('tools/pre-execute', async (exec, next) => {
+      try {
+        if (!matchesTool(exec) || !matchesAgentScope(config, exec?.agent)) return next()
+        const decision = config.params?.preDecision ?? 'allow'
+        if (decision === 'allow') return next()
+        if (decision === 'deny') {
+          return { kind: 'deny', reason: String(config.params?.denyReason ?? `${config.name}: denied by prompt config`) }
+        }
+        if (decision === 'ask') return { kind: 'ask' }
+        return next()
+      } catch (error) {
+        warnOnce(`${name}: tool-pipeline(pre) config ${config.id} failed: ${String(error?.message ?? error)}`)
+        return next()
+      }
+    })
+    ctx.on('tools/post-execute', async (exec, result, next) => {
+      try {
+        if (!matchesTool(exec) || !matchesAgentScope(config, exec?.agent)) return next()
+        const action = config.params?.postAction ?? 'accept'
+        if (action === 'accept') return next()
+        if (action === 'replace' && config.texts.length > 0) {
+          return { kind: 'accept', content: [{ type: 'text', text: config.texts.join('\n\n') }] }
+        }
+        if (action === 'block') {
+          return { kind: 'block', feedback: [{ type: 'text', text: config.texts.length > 0 ? config.texts.join('\n\n') : `${config.name}: blocked by prompt config` }] }
+        }
+        return next()
+      } catch (error) {
+        warnOnce(`${name}: tool-pipeline(post) config ${config.id} failed: ${String(error?.message ?? error)}`)
+        return next()
+      }
+    })
+  }
+}
+
+/** 把非 pre-step 提示词配置接入其声明的官方层级通道。 */
+export function wireLayers(ctx, configs, warnOnce) {
+  wireSystemSections(ctx, configs.filter((config) => config.layer === 'system-section'), warnOnce)
+  wireRuntimeContexts(ctx, configs.filter((config) => config.layer === 'runtime-context'), warnOnce)
+  wireAgentRequests(ctx, configs.filter((config) => config.layer === 'agent-request'), warnOnce)
+  wireLlmStreams(ctx, configs.filter((config) => config.layer === 'llm-stream'), warnOnce)
+  wireToolPipelines(ctx, configs.filter((config) => config.layer === 'tool-pipeline'), warnOnce)
+}

package/engine/run-code-env.mjs

@@ -18,9 +18,14 @@
  * native 模式自动空转。
  */
 
+import { validateConfig } from './shared.mjs'
+
 /** Cordis 插件名，供 loader 诊断使用。 */
 export const name = 'run-code-env'
 
+/** Every config key this plugin accepts — anything else is a typo. */
+const ALLOWED_KEYS = new Set(['enabled', 'envKeys'])
+
 /** 需要 tools 视图与 systemPrompt 段。shellEnv 为机会型读取，不写进 inject。 */
 export const inject = ['tools', 'systemPrompt']
 
@@ -166,7 +171,7 @@ export function patchRunCodeTool(tool, ctx, keys) {
 
 /** 注册 PTC env 注入：只在目标 scope 出现 run_code 时生效。 */
 export function apply(ctx, config) {
-  const source = config === undefined ? {} : config
+  const source = validateConfig(name, config, ALLOWED_KEYS)
   const enabled = source.enabled !== false
   const keys = normalizeEnvKeys(source.envKeys)
 
@@ -197,7 +202,8 @@ export function apply(ctx, config) {
   if (enabled) {
     ctx.systemPrompt.section({
       name: 'tools:run-code-env',
-      order: 160,
+      // alpha.1 官方 SDK 提示段固定在 5000；对齐保留在 per-tool 指导之后。
+      order: 5000,
       text: (context) => {
         const schemas = ctx.tools.schemas(context?.scope)
         if (!Array.isArray(schemas) || !schemas.some((schema) => schema?.name === 'run_code')) return ''

package/engine/schema.mjs

@@ -120,7 +120,7 @@ export const KNOWN_FILLS = new Set(['instruction-hint', 'env-facts', 'skill-cata
 /** 层能力矩阵：每个字段只在对应注入层生效。客户端表单据此动态渲染。 */
 export const LAYER_FIELD_POLICIES = {
   'pre-step': { position: true, dedupe: true, promotion: true, audience: true, modelScope: true, merge: true, order: true, role: true, placeholder: true },
-  'system-section': { position: false, dedupe: false, promotion: false, audience: false, modelScope: false, merge: true, order: true, role: false, placeholder: false },
+  'system-section': { position: false, dedupe: false, promotion: false, audience: true, modelScope: false, merge: true, order: true, role: false, placeholder: false },
   'runtime-context': { position: false, dedupe: false, promotion: false, audience: false, modelScope: false, merge: true, order: true, role: false, placeholder: true },
   'agent-request': { position: false, dedupe: false, promotion: false, audience: true, modelScope: true, merge: false, order: true, role: false, placeholder: false },
   'llm-stream': { position: false, dedupe: false, promotion: false, audience: false, modelScope: true, merge: false, order: true, role: false, placeholder: false },

package/engine/strategies.mjs

@@ -7,6 +7,7 @@
 
 import { extractText } from './shared.mjs'
 import { MATCH_LOGIC, createAnchorMatcher } from './anchor-match.mjs'
+import { createTaskClassifier } from './classify-task.mjs'
 import { createInstructionHintResolver, createPlaceholderResolver } from './fillers.mjs'
 
 const name = 'prompt-config-engine'
@@ -17,30 +18,30 @@ const name = 'prompt-config-engine'
  */
 function createFirstTurnAnchorResolver(config) {
   const useCustom = config.params?.useCustom === true
-  const customText = typeof config.params?.firstTurnText === 'string' ? config.params.firstTurnText : ''
+  // 自定义文本统一读 text（与 guide-auto 同契约）；firstTurnText 旧键兼容。
+  const customText = typeof config.params?.text === 'string'
+    ? config.params.text
+    : (typeof config.params?.firstTurnText === 'string' ? config.params.firstTurnText : '')
   const buildPattern = typeof config.params?.buildPattern === 'string' ? config.params.buildPattern : ''
   const complexPattern = typeof config.params?.complexPattern === 'string' ? config.params.complexPattern : ''
   const firstTurnBuild = typeof config.params?.firstTurnBuild === 'string' ? config.params.firstTurnBuild : ''
   const firstTurnInspect = typeof config.params?.firstTurnInspect === 'string' ? config.params.firstTurnInspect : ''
   const firstTurnDeep = typeof config.params?.firstTurnDeep === 'string' ? config.params.firstTurnDeep : ''
-  const buildRe = buildPattern.length > 0 ? new RegExp(buildPattern, 'i') : undefined
-  const complexRe = complexPattern.length > 0 ? new RegExp(complexPattern, 'i') : undefined
+  const classifier = createTaskClassifier({ buildPattern, complexPattern })
   return ({ messages }) => {
     if (useCustom) {
       const text = customText.trim()
       return text.length > 0 ? { text } : null
     }
-    if (buildRe === undefined || complexRe === undefined || (firstTurnBuild.length === 0 && firstTurnInspect.length === 0 && firstTurnDeep.length === 0)) {
+    if (!classifier.ready || (firstTurnBuild.length === 0 && firstTurnInspect.length === 0 && firstTurnDeep.length === 0)) {
       return null
     }
     const userIndex = messages.findIndex((message) => message?.source?.kind === 'user')
     if (userIndex < 0) return null
     const taskText = extractText(messages[userIndex])
     if (taskText.length === 0) return null
-    let anchor
-    if (complexRe.test(taskText)) anchor = firstTurnDeep
-    else if (buildRe.test(taskText)) anchor = firstTurnBuild
-    else anchor = firstTurnInspect
+    const kind = classifier.classify(taskText)
+    const anchor = kind === 'complex' ? firstTurnDeep : kind === 'build' ? firstTurnBuild : firstTurnInspect
     return anchor.length > 0 ? { text: anchor } : null
   }
 }
@@ -48,14 +49,17 @@ function createFirstTurnAnchorResolver(config) {
 /**
  * guide-auto:晋升后每轮用户消息后的弱/深度引导。
  * 正则与引导文本全部来自 config.params（由 preset.yml 单一配置源下发）。
+ * 复杂任务判定 fallback 复用锚定功能的 complexPattern（guideComplexPattern
+ * 冗余副本已移除）——锚定与引导是独立功能，仅分类器共用。
  */
 function createGuideAutoResolver(config) {
   const useCustom = config.params?.useCustom === true
   const customText = typeof config.params?.text === 'string' ? config.params.text : ''
-  const guideComplexPattern = typeof config.params?.guideComplexPattern === 'string' ? config.params.guideComplexPattern : ''
+  const complexPattern = typeof config.params?.complexPattern === 'string' ? config.params.complexPattern : ''
   const guideWeak = typeof config.params?.guideWeak === 'string' ? config.params.guideWeak : ''
   const guideDeep = typeof config.params?.guideDeep === 'string' ? config.params.guideDeep : ''
-  const guideComplexRe = guideComplexPattern.length > 0 ? new RegExp(guideComplexPattern, 'i') : undefined
+  // 复杂判定 fallback 复用锚定分类器（buildPattern 不参与引导判定）。
+  const classifier = createTaskClassifier({ complexPattern })
   return ({ messages }) => {
     const userIndex = messages.findIndex((message) => message?.source?.kind === 'user')
     if (userIndex < 0) return null
@@ -66,7 +70,7 @@ function createGuideAutoResolver(config) {
       return guide.length > 0 ? { text: guide } : null
     }
     if (guideWeak.length === 0 && guideDeep.length === 0) return null
-    return { text: (text.length > 120 || (guideComplexRe !== undefined && guideComplexRe.test(text))) ? guideDeep : guideWeak }
+    return { text: (text.length > 120 || classifier.isComplex(text)) ? guideDeep : guideWeak }
   }
 }
 
@@ -81,8 +85,13 @@ function createCustomFallbackResolver(config) {
   const firstTurnWord = typeof config.params?.firstTurnWord === 'string' && config.params.firstTurnWord.length > 0
     ? config.params.firstTurnWord
     : 'we'
-  // 锚定匹配经 anchor-match 引擎（prefix 模式：首轮 reasoning 开头命中锚定词）。
-  const anchor = createAnchorMatcher({ keys: [firstTurnWord], mode: 'prefix' })
+  // 确认词集合：writePreset 派生的 anchorWords 优先（锚句信号词多词 prefix，任一命中即
+  // 确认——deep 档 Let…/自定义锚句首词都覆盖）；旧产物无 anchorWords 时回退 firstTurnWord 单词。
+  const anchorWords = Array.isArray(config.params?.anchorWords) && config.params.anchorWords.length > 0
+    ? config.params.anchorWords.map(String).filter((word) => word.length > 0)
+    : [firstTurnWord]
+  // 锚定匹配经 anchor-match 引擎（prefix 模式：首轮 reasoning 开头命中任一确认词）。
+  const anchor = createAnchorMatcher({ keys: anchorWords, mode: 'prefix' })
 
   const anchorScanned = new Map()
 
@@ -140,7 +149,9 @@ function createWorldBookResolver(config) {
     secondaryKeys: Array.isArray(config.params?.secondaryKeys) ? config.params.secondaryKeys : [],
     caseSensitive: config.params?.caseSensitive === true,
     wholeWords: config.params?.wholeWords === true,
-    useRegex: config.params?.useRegex === true,
+    // 三态透传：undefined=ST 语义自动检测（/regex/ 或含特殊字符键按正则）；
+    // 存量配置显式 true/false 仍强制对应行为。
+    useRegex: config.params?.useRegex,
     logic,
   })
   // ST 语义：constant 或无任何键的条目恒注入（always active）。