dsh-plugin-prompt-tool 0.6.2 → 0.7.0

package/README.md

@@ -23,12 +23,13 @@ dsh --profile prompt-tool                                          # 首次启
 - 🧑‍🤝‍🧑 **子代理三态**：`subagents: none / inherit / only`，身份类提示词可只注入子代理
 - 🗂️ **内容与执行分离**：每条提示词配置渲染为 `~/.dsh/.agent-presets/<预设>/prompt-configs/` 下的 yml，引擎按文件名数字前缀顺序扫描
 - 🧩 **三层合并**：引擎默认（按 params 生成）< 模板默认 promptConfigs < 预设 promptConfigs，同名 `id` 覆盖
-- 🖥️ **独立工作台**：侧边栏「提示词工具」入口（主会话/子代理/注入层/技能设置/预设配置五页）+ 设置面板提示词配置页（列表/表单/模板插入/保存前校验）
+- 🖥️ **官方 slot 工作台**：`shell.overlay` 驱动的左上角悬浮按钮通过 body portal 落在对话界面层，右侧抽屉（主会话/子代理/技能设置/预设配置/角色管理五页）仍由官方 slot 承载；`settings.plugins.tab` 提供基础设置，`sidebar.footer.action` 几何探针跟随 264px 起步、可拉伸及 56px 折叠宽度，UI 挂载全部交给官方 SlotRegistry，无宿主 DOM 选择器
 - 🧪 **七种内容策略**：`static / first-turn-anchor / guide-auto / custom-fallback / instruction-hint / placeholder / world-book`（world-book 支持 ST selectiveLogic 选择性触发：任一/副键全中/排除）
 - 🛡️ **失败不伤会话**：单条失败跳过 + `warnOnce`；配置错误挂载时 fail loud；`dedupe: session` 持久幂等
 - 🎭 **SillyTavern 导入**：JSON 预设卡片一键转换为本地预设——`prompts[]` 映射提示词配置、setvar/getvar 收集进顶层 `variables`（未定义自定义宏自动登记空值占位）、`enable_web_search` 按开关装配工具；采样参数剥离（模型设置 UI 管理）
 - 🎴 **角色卡库**：SillyTavern 角色卡（PNG tEXt chunk `ccv3`/`chara`，或 chara_card JSON）导入独立库（`.characters/<id>/`，含原图/转换参数/角色记忆），按需「导入到当前预设」（`chara-<卡>-` 前缀合并、幂等可移除），多文件自动合并
-- 📚 **世界书**：`character_book` 转 world-book 策略配置（`keys` 命中触发 / `constant` 常驻 / `useRegex` 正则 / `selectiveLogic` 组合逻辑），与模块卡片同一存储与编辑（模块列表「世界书」过滤 + 批量启用/禁用）
+- 📚 **世界书**：`character_book` 转 world-book 策略配置（`keys` 命中触发 / `constant` 常驻 / 正则键自动检测 / `selectiveLogic` 组合逻辑），与模块卡片同一存储与编辑（模块列表「世界书」过滤 + 批量启用/禁用）
+- 🛠️ **自定义工具**：preset.yml `customTools` 段声明式定义模型工具（执行器 shell/http/delegate/fs/ask-user，`{{args.x}}` 参数插值），`tool-config-engine` 引擎行运行时注册；模块列表「自定义工具」卡片 JSON 编辑
 - 🧩 **模板变量**：预设级 `variables` 段（`{{key}}` 插值源）——模块列表顶部「模板变量」卡片统一编辑（可折叠/清空/停用/失焦自动保存）；锚定匹配引擎（anchor-match）统一 custom-fallback 与 world-book 的匹配语义
 - 💬 **会话变量工具**：`session_var`（list/get/set/clear）——模型维护角色状态（`{{心情}}` 等），会话级覆盖预设默认；ST 运行时宏（`{{lastusermessage}}` / `{{lastcharmessage}}`）从会话事件提取
 
@@ -38,22 +39,23 @@ dsh --profile prompt-tool                                          # 首次启
 
 | 层 | 职责 |
 |---|---|
-| `hostDefaults` | settings 层默认值（开关/路径），被用户 settings 覆盖 |
-| `params` | 引擎行为默认（锚定/引导/PTC/门控/模型/工具），被运行时 settings 覆盖 |
-| `moduleConfigs` | 引擎组合行级 config（persona 文本/超时/白名单） |
+| `params` | 引擎行为参数（锚定/引导/PTC/门控/模型/工具），经参数桥落位组合行；UI 可管理，优先级最高 |
+| `moduleConfigs` | 行级 config 直写通道（参数桥未覆盖的键：超时/环境白名单/ST 导入等），不锁定覆盖 UI 可管理参数 |
 | `promptConfigs` | 注入提示词配置（策略/层/位置/时机），与目录、settings 三源合并 |
 
 ### params 一览（全部可选，缺省 = 官方默认）
 
 | 分类 | 键 |
 |---|---|
-| 锚定 | `firstTurnAnchor` `firstTurnCustom` `firstTurnText` `firstTurnWord` `firstTurnBuild` `firstTurnInspect` `firstTurnDeep` |
-| 引导 | `guideCustom` `guideText` `guideComplexPattern` `guideWeak` `guideDeep` `buildPattern` `complexPattern` |
+| 锚定 | `firstTurnAnchor` `firstTurnCustom` `firstTurnText` `firstTurnWord`（空 = 自动从锚句派生确认词）`firstTurnBuild` `firstTurnInspect` `firstTurnDeep` |
+| 引导 | `guideCustom` `guideText` `guideWeak` `guideDeep`（复杂判定 fallback 复用锚定的 `complexPattern`） |
 | PTC/门控 | `usePtcMode` `bootstrapMaxTokens` `injectPrompt` `allowKinds` |
-| 人设 | 模块列表的 `persona-main`（system-section + `deployment:persona`，complete 互斥 + suppressRuntimeContext）；`subagentPersona`（子代理显式，缺省经 scope 链继承主会话） |
+| 人设 | 配置卡：主会话 = `persona-main` 卡（system-section + `deployment:persona`，complete 互斥 + suppressRuntimeContext）；子代理独立人设 = 新建配置卡（system-section + `audience=subagent` + 人设段），装配时替换主会话人设（不继承）；无子代理卡 = scope 链继承主会话 |
 | 工具集 | `toolFilterAllow` `toolFilterDeny`（子代理 toolFilter；主对话 tool-filter 模块共用） |
 | 深度 | `maxDepth`（0 禁止委派 / `provider-managed` / 正整数） |
 
+> 注：`injectPrompt`（params）= 锚定确认后注入 preset.md 的开关；`injectAgentsPrompt`（settings）= 把 AGENTS.md 内容作为 instruction-hint 提示文本的开关。两者功能不同，勿混淆。
+
 模型参数在 **preset.yml 顶层 `model` / `subagentModel` 段**（官方 `agent-default-model` 同构）：
 
 | 段 | 键 |
@@ -111,7 +113,7 @@ dsh --profile prompt-tool                                          # 首次启
 `character_book` 条目转 world-book 策略配置（与普通模块同一存储/编辑）：
 
 - **注入语义**：`constant` 常驻注入；有 `keys` 命中聊天内容才注入；无 keys 全局每次注入
-- **匹配选项**：`caseSensitive` / `wholeWords` / `useRegex`（keys 按正则）
+- **匹配选项**：`caseSensitive` / `wholeWords`；正则形态键（`/regex/` 或含特殊字符）自动检测
 - **管理**：模块列表顶部下拉选「世界书」过滤（完整模块卡片编辑 + 批量启用/禁用）；
   模型工具 `world_book_list/upsert/delete`（`note` 写入角色卡记忆）
 - **ST 变量**：`setvar`/`getvar` 收集进顶层 `variables`、未定义自定义宏自动登记空值占位；

package/engine/anchor-match.mjs

@@ -12,8 +12,8 @@
  *
  * 模式：
  *   scan   = 全文扫描（world-book 消息批匹配）；
- *   prefix = 文本开头匹配（custom-fallback 首轮 reasoning 锚定确认：ASCII 词边界前缀，
- *            非 ASCII 直 prefix）。
+ *   prefix = 文本开头匹配（custom-fallback 首轮 reasoning 锚定确认：确认词集合任一
+ *            前缀命中——ASCII 词边界前缀，非 ASCII 直 prefix）。
  */
 
 /** 组合逻辑（ST world_info_logic 映射）。 */
@@ -29,13 +29,38 @@ export function escapeRegExp(text) {
   return String(text).replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
 }
 
-/** 单键正则编译（逐键匹配：any/all/not 需要精确的命中键数，捕获组会干扰 match 计数）。 */
+/** ST 正则键检测（对齐 world-info.js parseRegexFromString）：
+ *  仅 /pattern/flags 显式包裹的键按正则匹配，其余一律字面（含 {{user}} 等
+ *  含花括号/正则特殊字符的普通键——ST 不做特殊字符自动检测）。 */
+export function isRegexKey(key) {
+  return parseRegexFromString(key) !== undefined
+}
+
+/** 键 → RegExp（仅 /pattern/flags 形态，模式内未转义 / 分隔符视为非法）；否则 undefined。 */
+export function parseRegexFromString(key) {
+  const m = /^\/([\s\S]+?)\/([gimsuy]*)$/u.exec(key)
+  if (m === null) return undefined
+  // ST 官方：模式内未转义的 / 分隔符非法（其它引擎无法解析该正则）。
+  if (/(^|[^\\])\//.test(m[1])) return undefined
+  try {
+    return new RegExp(m[1].replaceAll('\\/', '/'), m[2])
+  } catch {
+    return undefined
+  }
+}
+
+/** 单键正则编译（逐键匹配：any/all/not 需要精确的命中键数，捕获组会干扰 match 计数）。
+ *  useRegex 三态：true=强制正则；false=强制字面；缺省=ST 语义自动检测。 */
 function compileSingle(key, { caseSensitive, wholeWords, useRegex }) {
   const flags = caseSensitive ? '' : 'i'
-  if (useRegex) {
+  if (useRegex === true) {
     // ST use_regex=true：键原样作为正则（作者负责合法性）。
     return new RegExp(key, flags)
   }
+  if (useRegex === undefined) {
+    const auto = parseRegexFromString(key)
+    if (auto !== undefined) return auto
+  }
   if (wholeWords) {
     return new RegExp(`(^|[^\\p{L}\\p{N}])(${escapeRegExp(key)})(?![\\p{L}\\p{N}])`, `${flags}u`)
   }
@@ -57,7 +82,7 @@ function compileKeyList(list, options) {
  * @param {string[]} [options.secondaryKeys] 副键
  * @param {boolean} [options.caseSensitive]
  * @param {boolean} [options.wholeWords]
- * @param {boolean} [options.useRegex]
+ * @param {boolean} [options.useRegex] 三态：true=强制正则 / false=强制字面 / 缺省=自动检测（ST 语义）
  * @param {'any'|'all'|'not'|'notAny'} [options.logic] 组合逻辑（缺省 any）
  * @param {'scan'|'prefix'} [options.mode] 匹配模式（缺省 scan）
  * @returns {{ scan: (text: string) => { primary: number, secondary: number, active: boolean } }}
@@ -68,7 +93,7 @@ export function createAnchorMatcher(options = {}) {
     secondaryKeys = [],
     caseSensitive = false,
     wholeWords = false,
-    useRegex = false,
+    useRegex = undefined,
     logic = MATCH_LOGIC.ANY,
     mode = 'scan',
   } = options
@@ -78,13 +103,14 @@ export function createAnchorMatcher(options = {}) {
   const scan = (raw) => {
     const text = String(raw ?? '')
     if (mode === 'prefix') {
-      // custom-fallback 锚定确认：仅主键首词，文本开头匹配。
-      const word = (Array.isArray(keys) ? keys : []).map((key) => String(key).trim())
-        .find((key) => key.length > 0)
-      if (word === undefined || text.length === 0) return { primary: 0, secondary: 0, active: false }
-      const hit = /^[\x20-\x7E]+$/.test(word)
+      // custom-fallback 锚定确认：确认词集合任一前缀命中（any 语义——deep 档
+      // Let…/build 档 We…/自定义锚句首词都可作为确认信号）。
+      const words = (Array.isArray(keys) ? keys : []).map((key) => String(key).trim())
+        .filter((key) => key.length > 0)
+      if (words.length === 0 || text.length === 0) return { primary: 0, secondary: 0, active: false }
+      const hit = words.some((word) => /^[\x20-\x7E]+$/.test(word)
         ? new RegExp(`^${escapeRegExp(word.toLowerCase())}\\b`, 'i').test(text)
-        : text.startsWith(word)
+        : text.startsWith(word))
       return { primary: hit ? 1 : 0, secondary: 0, active: hit }
     }
     if (primaryList.length === 0 && secondaryList.length === 0) {

package/engine/anchor-turn.mjs

@@ -0,0 +1,68 @@
+/**
+ * anchor-turn — 在用户首条真实消息之前播种一个合成锚定轮（前置锚定）。
+ *
+ * 移植自 upstream dsh-anchored-standard shared/anchor-turn.mjs (MIT)：
+ * 锚定消息 PREPEND 进 `next-turn` inbox 队列、排在真实消息之前；dsh 每轮
+ * 只 claim 一条 next-turn 消息，所以首条模型请求 = 固定锚定提示（配合
+ * 零工具模式时 = 空工具面上的 "we" 锚定），用户真实消息由下一轮 claim——
+ * 彼时 bootstrap 已晋升、目录已开放。
+ *
+ * 与 near-anchor（first-turn-anchor 策略，消息级追加）正交：本模块是轮级
+ * 前置（真实消息延后一轮），near-anchor 是首条真实用户消息后的同轮追加。
+ *
+ * 在首条消息前（而非会话创建时）锚定，保持空白会话的预设切换器可用。
+ * 子代理默认跳过（其 brief 即计划）；includeSubagents: true 让子代理也
+ * 走锚定轮。
+ *
+ * Durability 免费：prepend 经 `agent/inbox/spliced` 事件持久化，崩溃后
+ * 队列按序恢复；inbox replay 不触发 `inserted` 通知，锚定永不重注入。
+ *
+ * Robustness：插件来源消息（含自身锚定）永不再次锚定。
+ */
+
+import { booleanOption, validateConfig } from './shared.mjs'
+
+/** Cordis plugin name used by loader diagnostics. */
+export const name = 'anchor-turn'
+
+/** 默认锚定文本（合成首轮展示给模型）。 */
+export const ANCHOR_TEXT = 'This round is a test. Tools are not open yet; all tools will open next round.'
+
+/** Every config key this plugin accepts — anything else is a typo. */
+const ALLOWED_KEYS = new Set(['enabled', 'text', 'includeSubagents'])
+
+/** 全新会话（无任何历史 user/message）才锚定。 */
+function isFreshSession(agent, includeSubagents = false) {
+  if (!includeSubagents && (agent.session.header.delegationDepth ?? 0) > 0) return false
+  return !agent.session.events.some((event) => event.type === 'user/message')
+}
+
+/** 注册首消息锚定注入。 */
+export function apply(ctx, config) {
+  const source = validateConfig(name, config, ALLOWED_KEYS)
+  if (source.enabled === false) return
+  const text = typeof source.text === 'string' && source.text.length > 0
+    ? source.text
+    : ANCHOR_TEXT
+  const includeSubagents = booleanOption(name, source.includeSubagents, 'includeSubagents', false)
+
+  ctx.on('agent/inbox/inserted', ({ agent, message }) => {
+    if (agent?.session === undefined || agent?.inbox?.prepend === undefined) return
+    if (!isFreshSession(agent, includeSubagents)) return
+    // 插件来源消息（包括我们自己的锚定）永不再次锚定。
+    if (message?.source?.kind === 'plugin') return
+    agent.inbox.prepend('next-turn', {
+      id: typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function'
+        ? crypto.randomUUID()
+        : `anchor-turn-${Date.now()}-${Math.random().toString(36).slice(2)}`,
+      role: 'user',
+      content: [{ type: 'text', text }],
+      source: {
+        kind: 'plugin',
+        plugin: name,
+        form: 'notice',
+        summary: 'zero-tool anchor turn',
+      },
+    })
+  })
+}

package/engine/classify-task.mjs

@@ -0,0 +1,35 @@
+/**
+ * classify-task — 任务分类器（能力归一）。
+ *
+ * buildPattern（构建任务正则）与 complexPattern（复杂任务正则）→ 三档分类
+ * （complex / build / fix）。锚定策略（first-turn-anchor）三档判定与引导策略
+ * （guide-auto）复杂判定共用本分类器——正则构建与判定逻辑单一实现，
+ * 避免两个策略各自 new RegExp + test（历史重复实现）。
+ *
+ * 参数缺省 = 对应分类不生效：buildRe/complexRe 未配置时跳过该分支
+ * （classify 落 fix；isComplex 恒 false）。
+ */
+export function createTaskClassifier({ buildPattern, complexPattern }) {
+  const buildRe = typeof buildPattern === 'string' && buildPattern.length > 0
+    ? new RegExp(buildPattern, 'i')
+    : undefined
+  const complexRe = typeof complexPattern === 'string' && complexPattern.length > 0
+    ? new RegExp(complexPattern, 'i')
+    : undefined
+  return {
+    /** 锚定三档判定可用：两档正则都配置。 */
+    get ready() {
+      return buildRe !== undefined && complexRe !== undefined
+    },
+    /** 三档分类：complex > build > fix（fix 为兜底档）。 */
+    classify(text) {
+      if (complexRe !== undefined && complexRe.test(text)) return 'complex'
+      if (buildRe !== undefined && buildRe.test(text)) return 'build'
+      return 'fix'
+    },
+    /** 复杂判定（引导 fallback 用；正则未配置 = false）。 */
+    isComplex(text) {
+      return complexRe !== undefined && complexRe.test(text)
+    },
+  }
+}

package/engine/code-presentation.mjs

@@ -0,0 +1,103 @@
+/**
+ * code-presentation - 晋升后 PTC mode wire 呈现。
+ *
+ * 从 tool-bootstrap 拆出的独立关注点：bootstrap 负责首轮工具目录窄化，
+ * 本模块只负责晋升后把工具呈现切换为 PTC mode（单 run_code，由
+ * tools.presentAs('ptc') 提供）。"只要 PTC 不要 bootstrap" = 组合只挂本行；
+ * PTC+bootstrap = 同时挂两行（行序：tool-bootstrap 在前，本行在后）。
+ *
+ * 相位与 tool-bootstrap / context-gate 同源：epoch-aware promotion
+ * （compaction-epoch.mjs）。晋升后（tool/call 或 assistant/message，按
+ * promoteOn，默认 either）应用 PTC mode；compaction/end 释放（压缩后回到
+ * 受控相位，重新晋升再应用）。
+ *
+ * SUBAGENTS: includeSubagents=false（默认）时子代理（delegationDepth > 0）
+ * 首次请求即应用呈现（继承完整目录语义）；true 时子代理跟随主会话相位。
+ *
+ * Robustness: 应用/释放失败降级（绝不 brick 会话）；invalid config fail at
+ * apply time，即 preset 挂载处可见可修。
+ */
+
+import { createEpochPromotion } from './compaction-epoch.mjs'
+import { booleanOption, parsePromoteOn, validateConfig } from './shared.mjs'
+
+/** Cordis plugin name used by loader diagnostics. */
+export const name = 'code-presentation'
+
+/** 无 inject：监听器只在使用时触碰 ctx 服务（同 tool-bootstrap 纪律）。 */
+export const inject = []
+
+/** Every config key this plugin accepts — anything else is a typo. */
+const ALLOWED_KEYS = new Set(['usePtcMode', 'includeSubagents', 'promoteOn'])
+
+/** Register the post-promotion Code Mode presentation. */
+export function apply(ctx, config) {
+  const source = validateConfig(name, config, ALLOWED_KEYS)
+  // 默认 false：PTC mode 呈现是 opt-in，未声明 = 原生完整工具目录。
+  const usePtcMode = booleanOption(name, source.usePtcMode, 'usePtcMode', false)
+  if (!usePtcMode) return
+  const includeSubagents = booleanOption(name, source.includeSubagents, 'includeSubagents', false)
+  const promoteEvents = parsePromoteOn(name, source.promoteOn)
+  const promotion = createEpochPromotion(promoteEvents, { includeSubagents })
+
+  const presentationBySession = new WeakMap()
+  const agentBySession = new WeakMap()
+  const presentationState = (session) => {
+    let state = presentationBySession.get(session)
+    if (state === undefined) {
+      state = { applied: false, disposer: undefined }
+      presentationBySession.set(session, state)
+    }
+    return state
+  }
+  const applyCodePresentation = (agent) => {
+    const session = agent?.session
+    if (session === undefined) return
+    const state = presentationState(session)
+    if (state.applied) return
+    const tools = agent.ctx?.tools
+    if (tools === undefined || typeof tools.presentAs !== 'function') return
+    state.disposer = tools.presentAs('ptc')
+    state.applied = true
+  }
+  const releaseCodePresentation = (session) => {
+    const state = presentationBySession.get(session)
+    if (state === undefined) return
+    if (typeof state.disposer === 'function') {
+      try { state.disposer() } catch { /* never brick the session */ }
+    }
+    state.disposer = undefined
+    state.applied = false
+  }
+
+  ctx.on('session/event', (session, event) => promotion.observe(session, event))
+  ctx.on('session/event', (session, event) => {
+    if (event.type === 'compaction/end') {
+      releaseCodePresentation(session)
+      return
+    }
+    if (event.type !== 'step/end' && event.type !== 'turn/end') return
+    const agent = agentBySession.get(session)
+    if (agent !== undefined && promotion.status(agent).promoted) applyCodePresentation(agent)
+  })
+
+  ctx.on('system-prompt/assemble', async (_assembly, context, next) => {
+    // Downstream errors propagate untouched; only this filter's own logic is guarded.
+    const assembled = await next()
+    try {
+      const agent = context.agent
+      if (agent === undefined || agent.session === undefined) return assembled
+      agentBySession.set(agent.session, agent)
+      if ((agent.session?.header?.delegationDepth ?? 0) > 0 && !includeSubagents) {
+        // 默认：子代理继承完整目录 → 直接应用呈现。
+        applyCodePresentation(agent)
+        return assembled
+      }
+      if (promotion.status(agent).promoted) applyCodePresentation(agent)
+      return assembled
+    } catch {
+      // 呈现失败不阻断会话：保持原样。
+      return assembled
+    }
+  })
+}

package/engine/compositions/library/anchor-turn.yml

@@ -0,0 +1,10 @@
+# module: anchor-turn
+# source: engine/compositions/library/anchor-turn.yml (本地附加,上游 dsh-anchored-standard 移植)
+# 前置锚定轮：用户首条真实消息前 prepend 合成锚定轮（配合 zero-tool 模式 =
+# 空工具面上的 "we" 锚定）。默认 enabled: false（挂载即禁用，行为不变）；
+# 启用 = params.anchorTurn（UI 开关）或本行 config.enabled: true。
+
+- id: anchor-turn
+  name: ./engine/anchor-turn.mjs
+  config:
+    enabled: false

package/engine/compositions/library/bootstrap-filesystem.yml

@@ -1,5 +1,5 @@
 # module: bootstrap-filesystem
-# source: E:\Documents\GitHub\deepseek-harness/apps/cli/config/agent-presets/minimal/agent.cordis.yml
+# source: D:\AI\GitHub\deepseek-harness/packages/preset/agent-presets/presets/minimal/agent.cordis.yml
 # local patches: 1
 
 - id: bootstrap-filesystem

package/engine/compositions/library/code-presentation.yml

@@ -0,0 +1,8 @@
+# module: code-presentation
+# source: engine/compositions/source/local/code-presentation.yml (本地附加,非官方模块)
+# 晋升后 Code Mode (PTC) wire 呈现（从 tool-bootstrap 拆出，与目录窄化解耦）：
+# "只要 PTC 不要 bootstrap" = modules 只挂本行；PTC+bootstrap = 同时挂两行。
+# usePtcMode 默认 false（opt-in）；params.usePtcMode 显式覆盖（参数桥）。
+
+- id: code-presentation
+  name: ./engine/code-presentation.mjs

package/engine/compositions/library/command-goal.yml

@@ -0,0 +1,11 @@
+# module: command-goal
+# source: D:\AI\GitHub\deepseek-harness/packages/preset/agent-presets/presets/standard/agent.cordis.yml
+# local patches: 0
+
+# ── goals ───────────────────────────────────────────────────────────────────
+
+# The goal service and session driver stay on the host plane, where the Gateway
+# can resolve them. The human command and model-facing tool register into this
+# preset's scoped layers.
+- id: command-goal
+  name: '@deepseek-ai/dsh-command-goal'

package/engine/compositions/library/compaction.yml

@@ -1,5 +1,5 @@
 # module: compaction
-# source: E:\Documents\GitHub\deepseek-harness/apps/cli/config/agent-presets/standard/agent.cordis.yml
+# source: D:\AI\GitHub\deepseek-harness/packages/preset/agent-presets/presets/standard/agent.cordis.yml
 # local patches: 0
 
 # ── compaction ──────────────────────────────────────────────────────────────

package/engine/compositions/library/context-gate.yml

@@ -1,12 +1,11 @@
 # module: context-gate
-# source: preset/engine/compositions/source/local/context-gate.yml (本地附加,非官方模块)
+# source: engine/compositions/source/local/context-gate.yml (本地附加,非官方模块)
 
 - id: context-gate
   name: ./engine/context-gate.mjs
   config:
     promoteOn: either
     includeSubagents: false
-    allowKinds: __allowKinds__
 
 # ── bootstrap ───────────────────────────────────────────────────────────────
 

package/engine/compositions/library/cot-drip.yml

@@ -0,0 +1,11 @@
+# module: cot-drip
+# source: engine/compositions/library/cot-drip.yml (本地附加,上游 dsh-anchored-standard 移植)
+# 深思维持节拍：每 N 次工具结果滴入一条 "We …" 重申提醒（additionalContexts）。
+# 默认 enabled: false（挂载即禁用）；启用 = params.cotDrip（UI 开关）。
+
+- id: cot-drip
+  name: ./engine/cot-drip.mjs
+  config:
+    enabled: false
+    every: 4
+    maxPerTurn: 1

package/engine/compositions/library/custom-bash.yml

@@ -1,5 +1,5 @@
 # module: custom-bash
-# source: preset/engine/compositions/source/local/custom-bash.yml (本地附加,非官方模块)
+# source: engine/compositions/source/local/custom-bash.yml (本地附加,非官方模块)
 
 - id: custom-bash
   name: ./engine/custom-bash.mjs

package/engine/compositions/library/delegation.yml

@@ -1,6 +1,6 @@
 # module: delegation
-# source: E:\Documents\GitHub\deepseek-harness/apps/cli/config/agent-presets/standard/agent.cordis.yml
-# local patches: 2（SUBAGENT-CONFIG token ×2：子代理完整配置（模型/人设/工具集/深度），随预设参数渲染）
+# source: D:\AI\GitHub\deepseek-harness/packages/preset/agent-presets/presets/standard/agent.cordis.yml
+# local patches: 0
 
 # ── delegation and workflows ────────────────────────────────────────────────
 
@@ -36,20 +36,24 @@
       config:
         provider: spawn
         toolName: subagent
+        modelSelectionSettings: true
         backgroundMode: continuable
-        __subagentConfig__
 
+    # Fork omits model selection so provider/model stay equal to the parent and
+    # the inherited history remains eligible for KV Cache reuse. This preset
+    # keeps fork continuable and accepts its child-scoped `report` additions invalidating
+    # that prefix; issue #2124 tracks cache-preserving continuable fork.
     - id: tool-subagent-fork
       name: '@deepseek-ai/dsh-tool-subagent'
       config:
         provider: fork
         toolName: subagent_fork
         backgroundMode: continuable
-        __subagentConfig__
 
-    # Production dsh does not install these optional providers. An opting-in
-    # Profile mounts each provider once on the host plane; copy this preset,
-    # then remove `disabled` from the matching tool row.
+    # Production dsh does not install these optional providers. Install the
+    # matching Bundle in this Profile and restart the Host, then copy this
+    # preset and remove `disabled` from the matching tool row. Host availability
+    # alone grants no tool.
     - id: tool-subagent-codex
       name: '@deepseek-ai/dsh-tool-subagent'
       disabled: true

package/engine/compositions/library/deliberation-gate.yml

@@ -0,0 +1,11 @@
+# module: deliberation-gate
+# source: engine/compositions/library/deliberation-gate.yml (本地附加,上游 dsh-anchored-standard 移植)
+# 轨迹深度门：首工具调用前流式深思 < minChars 时 deny 一次（规划式提示）。
+# 默认 enabled: false（挂载即禁用）；启用 = params.deliberationGate（UI 开关）。
+
+- id: deliberation-gate
+  name: ./engine/deliberation-gate.mjs
+  config:
+    enabled: false
+    minChars: 400
+    maxGatesPerTurn: 1

package/engine/compositions/library/persistent-shell.yml

@@ -1,5 +1,5 @@
 # module: persistent-shell
-# source: E:\Documents\GitHub\deepseek-harness/apps/cli/config/agent-presets/minimal/agent.cordis.yml
+# source: D:\AI\GitHub\deepseek-harness/packages/preset/agent-presets/presets/minimal/agent.cordis.yml
 # local patches: 2
 
 - id: persistent-shell
@@ -14,12 +14,14 @@
 
     - id: terminal-bash
       name: '@deepseek-ai/dsh-terminal-bash'
+      disabled: !!js process.platform === 'win32'
       config:
         shellPath: !!js "process.getBuiltinModule?.('node:fs')?.existsSync('/bin/bash') ? '/bin/bash' : 'bash'"
         timeoutMs: 300000
 
     - id: persistent-bash
       name: '@deepseek-ai/dsh-tool-bash-persistent'
+      disabled: !!js process.platform === 'win32'
       config:
         timeoutMs: 300000
         description: |-
@@ -32,5 +34,26 @@
           * Please avoid commands that may produce a very large amount of output.
           * Please run long lived commands in the background, e.g. 'sleep 10 &' or start a server in the background.
 
+    - id: terminal-pwsh
+      name: '@deepseek-ai/dsh-terminal-bash'
+      disabled: !!js process.platform !== 'win32'
+      config:
+        shellDialect: pwsh
+        timeoutMs: 300000
+
+    - id: persistent-pwsh
+      name: '@deepseek-ai/dsh-tool-pwsh-persistent'
+      disabled: !!js process.platform !== 'win32'
+      config:
+        timeoutMs: 300000
+        description: |-
+          Run commands in a PowerShell shell
+          * When invoking this tool, the contents of the "command" parameter does NOT need to be XML-escaped.
+          * You don't have access to the internet via this tool.
+          * State is persistent across command calls and discussions with the user.
+          * Use native Windows paths (C:\...) and $env:NAME variables; this is PowerShell, not bash.
+          * Please avoid commands that may produce a very large amount of output.
+          * Please run long lived commands in the background, e.g. 'Start-Job' or start a server with Start-Process.
+
 # The bare local filesystem shadows the host's sandboxed provider only for this
-# preset. The editor shares that realm and requires absolute paths.
+# preset. The editor shares that realm and requires absolute paths.

package/engine/compositions/library/persona.yml

@@ -1,7 +1,11 @@
 # module: persona
-# source: deepseek-harness official standard agent preset (persona)
-# persona 差异（creative/minimal/anchored）由 preset.yml moduleConfigs 参数传递。
+# source: D:\AI\GitHub\deepseek-harness/packages/preset/agent-presets/presets/standard/agent.cordis.yml
+# local patches: 0
 
+# ── identity ────────────────────────────────────────────────────────────────
+
+# The preset's own persona, shadowing the deployment default for this agent.
+# `{{model}}` and `{{cwd}}` resolve from the agent's own route and workspace.
 - id: persona
   name: '@deepseek-ai/dsh-persona'
   config:

package/engine/compositions/library/planning.yml

@@ -1,5 +1,5 @@
 # module: planning
-# source: E:\Documents\GitHub\deepseek-harness/apps/cli/config/agent-presets/standard/agent.cordis.yml
+# source: D:\AI\GitHub\deepseek-harness/packages/preset/agent-presets/presets/standard/agent.cordis.yml
 # local patches: 0
 
 # ── plan mode ───────────────────────────────────────────────────────────────

package/engine/compositions/library/prompt-config-engine.yml

@@ -1,5 +1,5 @@
 # module: prompt-config-engine
-# source: preset/engine/compositions/source/local/prompt-config-engine.yml (本地附加,非官方模块)
+# source: engine/compositions/source/local/prompt-config-engine.yml (本地附加,非官方模块)
 
 - id: prompt-config-engine
   name: ./engine/prompt-config-engine.mjs

package/engine/compositions/library/run-code-env.yml

@@ -1,5 +1,5 @@
 # module: run-code-env
-# source: preset/engine/compositions/source/local/run-code-env.yml (本地附加,非官方模块)
+# source: engine/compositions/source/local/run-code-env.yml (本地附加,非官方模块)
 
 - id: run-code-env
   name: ./engine/run-code-env.mjs

package/engine/compositions/library/skill-filesystem.yml

@@ -1,5 +1,5 @@
 # module: skill-filesystem
-# source: E:\Documents\GitHub\deepseek-harness/apps/cli/config/agent-presets/standard/agent.cordis.yml
+# source: D:\AI\GitHub\deepseek-harness/packages/preset/agent-presets/presets/standard/agent.cordis.yml
 # local patches: 0
 
 # ── skills ──────────────────────────────────────────────────────────────────

package/engine/compositions/library/skill-search.yml

@@ -1,5 +1,5 @@
 # module: skill-search
-# source: preset/engine/compositions/source/local/skill-search.yml (本地附加,非官方模块)
+# source: engine/compositions/source/local/skill-search.yml (本地附加,非官方模块)
 
 - id: skill-search
   name: ./engine/skill-search.mjs

package/engine/compositions/library/str-replace-editor.yml

@@ -1,5 +1,5 @@
 # module: str-replace-editor
-# source: E:\Documents\GitHub\deepseek-harness/apps/cli/config/agent-presets/minimal/agent.cordis.yml
+# source: engine/compositions/source/local/str-replace-editor.yml (本地附加,非官方模块)
 # 官方 minimal 内置工具（filesystem group 内的 str-replace-editor 行）拆出为独立模块：
 # 复用宿主 sandbox 的 ctx.fs，不挂 fs-local 裸文件系统。
 # maxOutputChars 参数化：params.strReplaceEditorMaxOutputChars（默认官方值 16000）。
@@ -7,4 +7,4 @@
 - id: str-replace-editor
   name: '@deepseek-ai/dsh-tool-str-replace-editor'
   config:
-    maxOutputChars: __strReplaceEditorMaxOutputChars__
+    maxOutputChars: 16000

package/engine/compositions/library/tool-ask-user.yml

@@ -1,5 +1,5 @@
 # module: tool-ask-user
-# source: E:\Documents\GitHub\deepseek-harness/apps/cli/config/agent-presets/standard/agent.cordis.yml
+# source: D:\AI\GitHub\deepseek-harness/packages/preset/agent-presets/presets/standard/agent.cordis.yml
 # local patches: 0
 
 # ── remaining model-facing rows ─────────────────────────────────────────────

package/engine/compositions/library/tool-bash.yml

@@ -1,5 +1,5 @@
 # module: tool-bash
-# source: E:\Documents\GitHub\deepseek-harness/apps/cli/config/agent-presets/standard/agent.cordis.yml
+# source: D:\AI\GitHub\deepseek-harness/packages/preset/agent-presets/presets/standard/agent.cordis.yml
 # local patches: 1
 
 # ── shell ───────────────────────────────────────────────────────────────────