dsh-hooks 0.10.0 → 0.12.0

package/lib/config.js

@@ -18,6 +18,7 @@ export const HOOK_EVENTS = [
     'agent/error',
     'agent/status',
     'hook/failed',
+    'usage/daily',
 ];
 /** `turn/end` reason kinds (from @deepseek-ai/dsh-session TurnEndReasonMap). */
 export const TURN_END_REASONS = [
@@ -34,9 +35,18 @@ export const TURN_END_REASONS = [
 // declaration self-contained.
 export const Config = Schema.object({
     hooks: Schema.array(Schema.object({
-        on: Schema.union([...HOOK_EVENTS]).description('触发事件：turn/start | turn/end | tree/settled | step/end | tool/call | tool/result | user/message | approval/asked | approval/decided | session/title | session/created | session/disposed | agent/created | agent/disposed | agent/error | agent/status | hook/failed'),
+        on: Schema.union([...HOOK_EVENTS]).description('触发事件：turn/start | turn/end | tree/settled | step/end | tool/call | tool/result | user/message | approval/asked | approval/decided | session/title | session/created | session/disposed | agent/created | agent/disposed | agent/error | agent/status | hook/failed | usage/daily'),
         when: Schema.union([...TURN_END_REASONS]).description('可选过滤：对 turn/end 匹配结束原因（completed/error/aborted/blocked/max-tokens/interrupted）；其他事件忽略该字段'),
-        match: Schema.dict(Schema.regExp()).description('可选通用过滤：字段 → 正则，全部匹配才触发。字段为上下文键（tool/sessionName/sessionId/error/source/cwd/content/reason/…），上下文中不存在的字段视为不匹配'),
+        match: Schema.dict(Schema.union([
+            Schema.regExp(),
+            Schema.object({
+                gt: Schema.number(),
+                gte: Schema.number(),
+                lt: Schema.number(),
+                lte: Schema.number(),
+                eq: Schema.number(),
+            }).description('数值比较（可组合，全部满足才匹配；要求上下文字段为数字）'),
+        ])).description('可选通用过滤：字段 → 正则或数值比较，全部匹配才触发。正则匹配字段的字符串表示；数值比较支持对象语法 { gt: 10000 } 或字符串语法 \'>10000\'（gt/gte/lt/lte/eq），只对数字字段生效，非数字字段永不匹配。字段为上下文键（tool/sessionName/sessionId/error/source/cwd/content/reason/turn/durationMs/runningSubagents/…），上下文中不存在的字段视为不匹配'),
         run: Schema.string().description('触发时通过系统 shell 执行的命令（与 notify 二选一）'),
         notify: Schema.union([
             Schema.object({
@@ -56,6 +66,12 @@ export const Config = Schema.object({
         timeoutMs: Schema.number().default(10000).description('单次执行超时（毫秒）'),
         retries: Schema.natural().default(0).description('非零退出码的重试次数（默认 0 不重试；spawn 失败与超时不重试）'),
         retryDelayMs: Schema.natural().default(500).description('重试基础间隔（毫秒），每次翻倍'),
+        enabled: Schema.boolean()
+            .default(true)
+            .description('停用开关：false 保留配置但跳过派发（静默跳过，不计失败；默认 true）'),
+        cwd: Schema.union([Schema.const('session'), Schema.string()]).description('执行工作目录：session 在会话工作目录执行；绝对路径在指定目录执行；缺省用插件进程目录（只作用于 run）'),
+        maxConcurrent: Schema.natural().description('该 hook 允许的最大并发进程数；超过上限的触发被丢弃（历史记 skipped）。缺省不限（0 同样视为不限）'),
+        debounceMs: Schema.natural().description('去抖窗口（毫秒）：高频事件（step/end、tool/* 等）窗口内的多次触发合并为一次 trailing 执行，携带最新上下文。缺省 0 = 不去抖'),
     }).description('一个事件 → 命令/通知的 hook 声明'))
         .default([])
         .description('事件触发时执行的外部命令列表；按声明顺序触发'),

package/lib/context.d.ts

@@ -30,7 +30,12 @@ export interface HookContext {
     error?: string;
     /** Event content snapshot: turn assistant text, tool result text, … */
     content?: string;
-    /** Aggregated token usage of the turn (turn/end), when reported. */
+    /**
+     * Wall-clock tool execution time, ms (tool/result only; undefined when the
+     * pairing tool/call was never seen, e.g. after a plugin restart).
+     */
+    toolDurationMs?: number;
+    /** Aggregated token usage of the turn (turn/end), or of the day (usage/daily). */
     usageInputTokens?: number;
     usageOutputTokens?: number;
     usageCacheReadTokens?: number;
@@ -64,6 +69,15 @@ export interface HookContext {
     hookFailedHook?: string;
     /** Consecutive failure count when the alert fired (hook/failed). */
     hookFailures?: number;
+    /**
+     * Local calendar day (`YYYY-MM-DD`) the token totals below cover
+     * (usage/daily only; turn/end carries a single turn, not a day).
+     */
+    usageDay?: string;
+    /** Turns with reported accounting that day (usage/daily). */
+    usageTurns?: number;
+    /** Distinct sessions that contributed usage that day (usage/daily). */
+    usageSessions?: number;
     timestamp: string;
 }
 export declare function toEnv(ctx: HookContext): Record<string, string>;

package/lib/context.js

@@ -35,6 +35,8 @@ export function toEnv(ctx) {
         env.DSH_HOOK_ERROR = ctx.error;
     if (ctx.content !== undefined)
         env.DSH_HOOK_CONTENT = ctx.content;
+    if (ctx.toolDurationMs !== undefined)
+        env.DSH_HOOK_TOOL_DURATION_MS = String(ctx.toolDurationMs);
     if (ctx.usageInputTokens !== undefined)
         env.DSH_HOOK_USAGE_INPUT_TOKENS = String(ctx.usageInputTokens);
     if (ctx.usageOutputTokens !== undefined)
@@ -69,6 +71,12 @@ export function toEnv(ctx) {
         env.DSH_HOOK_FAILED_HOOK = ctx.hookFailedHook;
     if (ctx.hookFailures !== undefined)
         env.DSH_HOOK_FAILURES = String(ctx.hookFailures);
+    if (ctx.usageDay !== undefined)
+        env.DSH_HOOK_USAGE_DAY = ctx.usageDay;
+    if (ctx.usageTurns !== undefined)
+        env.DSH_HOOK_USAGE_TURNS = String(ctx.usageTurns);
+    if (ctx.usageSessions !== undefined)
+        env.DSH_HOOK_USAGE_SESSIONS = String(ctx.usageSessions);
     return env;
 }
 /** Render `{{DSH_HOOK_*}}` placeholders from the context map. */

package/lib/dry-run.js

@@ -9,6 +9,7 @@ import { join } from 'node:path';
 import YAML from 'yaml';
 import { Config } from './config.js';
 import { matchFilters } from './events.js';
+import { localDayKey } from './usage.js';
 import { createHookRunner } from './runner.js';
 import { fireNotify } from './notify.js';
 /** Profile patch file for a profile name. */
@@ -48,7 +49,7 @@ export function loadHooks(profile, paths = {}) {
 }
 /** A synthetic context for the simulated event, overridable per field. */
 export function mockContext(event, overrides = {}) {
-    return {
+    const ctx = {
         event,
         sessionId: 'dry-run',
         sessionName: 'dry-run 会话',
@@ -59,25 +60,53 @@ export function mockContext(event, overrides = {}) {
         callId: 'dry-run-call',
         content: 'dry-run 模拟内容',
         timestamp: new Date().toISOString(),
-        ...overrides,
     };
+    if (event === 'usage/daily') {
+        // A daily report always describes a day that already ended, and the
+        // simulated numbers must be non-zero so `match` filters on them (e.g.
+        // `{ usageInputTokens: '>0' }`) are actually exercisable.
+        ctx.usageDay = localDayKey(new Date(Date.now() - 86_400_000));
+        ctx.usageTurns = 12;
+        ctx.usageSessions = 3;
+        ctx.usageInputTokens = 120_000;
+        ctx.usageOutputTokens = 45_000;
+        ctx.usageCacheReadTokens = 90_000;
+        ctx.usageCacheWriteTokens = 6_000;
+        ctx.usageReasoningTokens = 8_000;
+    }
+    return { ...ctx, ...overrides };
+}
+/** Render a match value (regex source, comparison op, or object form). */
+function matchText(value) {
+    if (value instanceof RegExp)
+        return value.source;
+    return JSON.stringify(value);
 }
 /** One-line hook description for report rows. */
 export function describeHook(hook) {
     const when = hook.when ? ` when=${hook.when}` : '';
     const match = hook.match && Object.keys(hook.match).length > 0
-        ? ` match=${JSON.stringify(Object.fromEntries(Object.entries(hook.match).map(([key, re]) => [key, re.source])))},`
+        ? ` match=${JSON.stringify(Object.fromEntries(Object.entries(hook.match).map(([key, re]) => [key, matchText(re)])))},`
         : '';
+    const options = [
+        hook.enabled === false ? ' enabled:false' : '',
+        hook.cwd !== undefined ? ` cwd:${hook.cwd}` : '',
+        hook.maxConcurrent !== undefined && hook.maxConcurrent > 0 ? ` maxConcurrent:${hook.maxConcurrent}` : '',
+        hook.debounceMs !== undefined && hook.debounceMs > 0 ? ` debounceMs:${hook.debounceMs}` : '',
+    ].join('');
     if (hook.run)
-        return `[${hook.on}${when}]${match} run: ${hook.run}`;
+        return `[${hook.on}${when}]${match} run: ${hook.run}${options}`;
     if (hook.notify)
-        return `[${hook.on}${when}]${match} notify: ${hook.notify.channel}${hook.notify.url ? ` ${hook.notify.url}` : ''}`;
-    return `[${hook.on}${when}]${match} (既无 run 也无 notify)`;
+        return `[${hook.on}${when}]${match} notify: ${hook.notify.channel}${hook.notify.url ? ` ${hook.notify.url}` : ''}${options}`;
+    return `[${hook.on}${when}]${match} (既无 run 也无 notify)${options}`;
 }
 /** Evaluate every hook against the simulated event/context. */
 export function evaluateHooks(hooks, event, ctx, reasonKind) {
     return hooks.map((hook, index) => {
         const summary = describeHook(hook);
+        if (hook.enabled === false) {
+            return { index: index + 1, matched: false, why: 'enabled: false（已停用）', summary };
+        }
         if (hook.on !== event) {
             return { index: index + 1, matched: false, why: `事件不匹配（${hook.on} ≠ ${event}）`, summary };
         }

package/lib/events.d.ts

@@ -1,7 +1,9 @@
 import type { Session, SessionEvent, TurnEndReason } from '@deepseek-ai/dsh-session';
 import type { HookContext } from './context.js';
-import type { HookSpec, TurnEndReasonKind } from './config.js';
+import type { HookSpec, NumericMatch, TurnEndReasonKind } from './config.js';
+import type { DailyUsageTotals, UsageTotals } from './usage.js';
 import type { AgentLike } from './types.js';
+export type { UsageTotals } from './usage.js';
 /** `approval/asked` payload (merge-extensible, declared by dsh-user-approval). */
 export interface ApprovalAskedData {
     id: string;
@@ -65,14 +67,6 @@ export declare function sessionTitle(session: Session): string | undefined;
  * their own display truncation.
  */
 export declare function turnContent(session: Session, turn: number): string | undefined;
-/** Aggregated turn usage for hook contexts (only fields actually reported). */
-export interface UsageTotals {
-    inputTokens: number;
-    outputTokens: number;
-    cacheReadTokens?: number;
-    cacheWriteTokens?: number;
-    reasoningTokens?: number;
-}
 /**
  * Sum the `usage` of every `assistant/message` of a turn. Steps without
  * reported accounting are skipped; returns undefined when no step reported
@@ -84,13 +78,15 @@ export declare function clearTurnTracking(session: Session): void;
 /** Does a declared hook match this event (type + optional `when` filter)? */
 export declare function hookMatches(spec: HookSpec, event: string, reasonKind?: TurnEndReasonKind): boolean;
 /**
- * Apply the optional `match` field → regex filters. Every declared regex
- * must match its context field (String-coerced); a field the context does
- * not carry never matches. An empty/absent `match` passes everything.
- * RegExps come pre-compiled from the config schema; non-RegExp entries are
- * rejected defensively (never match).
+ * Apply the optional `match` field → filter map. Each value is either a
+ * regex (compiled by the config schema; tested against the String-coerced
+ * field) or a numeric comparison — declared as an object (`{ gt: 10000 }`)
+ * or as a string that parses as one (`'>10000'`). Comparison semantics
+ * apply only when the context field is a number; on a non-numeric field a
+ * comparison never matches. Every declared filter must pass. An empty or
+ * absent `match` passes everything; unsupported shapes never match.
  */
-export declare function matchFilters(match: Record<string, RegExp> | undefined, ctx: HookContext): boolean;
+export declare function matchFilters(match: Record<string, RegExp | NumericMatch> | undefined, ctx: HookContext): boolean;
 export declare function turnEndContext(session: Session, turn: number, reason: TurnEndReason | string): HookContext;
 export declare function turnStartContext(session: Session, turn: number): HookContext;
 export declare function stepEndContext(session: Session, turn: number, step: number): HookContext;
@@ -126,6 +122,16 @@ export declare function treeSettledContext(session: Session, totalSubagents: num
  * session identity of the event that triggered the failing hook.
  */
 export declare function hookFailedContext(origin: HookContext, hookFailedHook: string, hookFailures: number): HookContext;
+/**
+ * Synthetic `usage/daily` context: the local calendar day that just ended,
+ * with its aggregated token usage. Emitted by index.ts when the day rolls
+ * over (detected from ordinary event traffic — no timers); `origin` supplies
+ * the session identity of the event that triggered the report.
+ *
+ * The token fields reuse the `turn/end` names on purpose: a hook reads the
+ * same variables, with the day's aggregate instead of one turn's.
+ */
+export declare function usageDailyContext(origin: HookContext, totals: DailyUsageTotals): HookContext;
 export declare function agentCreatedContext(agent: AgentLike): HookContext;
 export declare function agentDisposedContext(agent: AgentLike): HookContext;
 export declare function agentErrorContext(agent: AgentLike, turn: number | undefined, error: unknown): HookContext;

package/lib/events.js

@@ -1,6 +1,9 @@
 /** Per-session turn start timestamps for duration reporting. */
 const turnStarts = new Map();
-/** Tool name for an in-flight call, remembered at `tool/call` and consumed at `tool/result`. */
+/**
+ * Tool name + start timestamp for an in-flight call, remembered at
+ * `tool/call` and consumed at `tool/result` (name back-fill + duration).
+ */
 const callTools = new Map();
 /** Approval identity remembered at `approval/asked` and consumed at `approval/decided`. */
 const approvalTools = new Map();
@@ -139,24 +142,76 @@ export function hookMatches(spec, event, reasonKind) {
         return true;
     return spec.when === reasonKind;
 }
+/** Comparison-prefixed string syntax: `'>10000'`, `'>=5'`, `'<2'`, `'<=9'`, `'=42'`. */
+const COMPARE_STRING = /^([<>]=?|=)\s*(-?\d+(?:\.\d+)?)$/;
+const OPERATOR_SYMBOLS = {
+    '>': 'gt',
+    '>=': 'gte',
+    '<': 'lt',
+    '<=': 'lte',
+    '=': 'eq',
+};
+/** Symbol/field form of a comparison matcher: `{ gt: 10000 }`, `' > 10000'`, … */
+function numericOps(value) {
+    if (!(value instanceof RegExp))
+        return value;
+    const parsed = COMPARE_STRING.exec(value.source);
+    if (parsed === null)
+        return undefined;
+    const op = OPERATOR_SYMBOLS[parsed[1]];
+    if (op === undefined)
+        return undefined;
+    return { [op]: Number(parsed[2]) };
+}
+/** Does a numeric context field satisfy every declared comparison op? */
+function compareNumber(n, ops) {
+    if (ops.gt !== undefined && !(n > ops.gt))
+        return false;
+    if (ops.gte !== undefined && !(n >= ops.gte))
+        return false;
+    if (ops.lt !== undefined && !(n < ops.lt))
+        return false;
+    if (ops.lte !== undefined && !(n <= ops.lte))
+        return false;
+    if (ops.eq !== undefined && !(n === ops.eq))
+        return false;
+    return true;
+}
 /**
- * Apply the optional `match` field → regex filters. Every declared regex
- * must match its context field (String-coerced); a field the context does
- * not carry never matches. An empty/absent `match` passes everything.
- * RegExps come pre-compiled from the config schema; non-RegExp entries are
- * rejected defensively (never match).
+ * Apply the optional `match` field → filter map. Each value is either a
+ * regex (compiled by the config schema; tested against the String-coerced
+ * field) or a numeric comparison — declared as an object (`{ gt: 10000 }`)
+ * or as a string that parses as one (`'>10000'`). Comparison semantics
+ * apply only when the context field is a number; on a non-numeric field a
+ * comparison never matches. Every declared filter must pass. An empty or
+ * absent `match` passes everything; unsupported shapes never match.
  */
 export function matchFilters(match, ctx) {
     if (match === undefined)
         return true;
     for (const [field, pattern] of Object.entries(match)) {
-        if (!(pattern instanceof RegExp))
-            return false;
         const value = ctx[field];
         if (value === undefined)
             return false;
-        if (!pattern.test(String(value)))
-            return false;
+        if (pattern instanceof RegExp) {
+            const ops = numericOps(pattern);
+            if (ops !== undefined) {
+                // Comparison syntax: numbers only, never coerced strings.
+                if (typeof value !== 'number' || !compareNumber(value, ops))
+                    return false;
+                continue;
+            }
+            if (!pattern.test(String(value)))
+                return false;
+            continue;
+        }
+        // Object form `{ gt: … }` comes pre-typed from the schema.
+        if (typeof pattern === 'object' && pattern !== null) {
+            if (typeof value !== 'number' || !compareNumber(value, pattern))
+                return false;
+            continue;
+        }
+        return false;
     }
     return true;
 }
@@ -218,20 +273,21 @@ export function stepEndContext(session, turn, step) {
 }
 export function toolCallContext(session, turn, step, callId, name, args) {
     const key = callKey(session, callId);
-    callTools.set(key, typeof name === 'string' ? name : String(name));
+    const tool = typeof name === 'string' ? name : String(name);
+    callTools.set(key, { tool, startedAt: Date.now() });
     return {
         ...baseContext(session, 'tool/call'),
         turn,
         step,
-        tool: typeof name === 'string' ? name : String(name),
+        tool,
         callId: String(callId),
         toolArgs: typeof args === 'string' ? args.slice(0, 4000) : undefined,
     };
 }
 export function toolResultContext(session, turn, step, callId, message, error) {
     const key = callKey(session, callId);
-    const tool = callTools.get(key);
-    if (tool !== undefined)
+    const paired = callTools.get(key);
+    if (paired !== undefined)
         callTools.delete(key);
     let toolError;
     if (error !== undefined) {
@@ -245,8 +301,9 @@ export function toolResultContext(session, turn, step, callId, message, error) {
         ...baseContext(session, 'tool/result'),
         turn,
         step,
-        tool,
+        tool: paired?.tool,
         callId: String(callId),
+        toolDurationMs: paired === undefined ? undefined : Date.now() - paired.startedAt,
         toolError,
         content: content === undefined ? undefined : content.slice(0, 4000),
     };
@@ -346,6 +403,34 @@ export function hookFailedContext(origin, hookFailedHook, hookFailures) {
         timestamp: new Date().toISOString(),
     };
 }
+/**
+ * Synthetic `usage/daily` context: the local calendar day that just ended,
+ * with its aggregated token usage. Emitted by index.ts when the day rolls
+ * over (detected from ordinary event traffic — no timers); `origin` supplies
+ * the session identity of the event that triggered the report.
+ *
+ * The token fields reuse the `turn/end` names on purpose: a hook reads the
+ * same variables, with the day's aggregate instead of one turn's.
+ */
+export function usageDailyContext(origin, totals) {
+    return {
+        event: 'usage/daily',
+        sessionId: origin.sessionId,
+        sessionName: origin.sessionName,
+        cwd: origin.cwd,
+        usageDay: totals.day,
+        usageTurns: totals.turns,
+        usageSessions: totals.sessions,
+        usageInputTokens: totals.inputTokens,
+        usageOutputTokens: totals.outputTokens,
+        // Only fields some turn actually reported: an absent variable is easier to
+        // reason about (and to match on) than one that is present-but-undefined.
+        ...(totals.cacheReadTokens !== undefined ? { usageCacheReadTokens: totals.cacheReadTokens } : {}),
+        ...(totals.cacheWriteTokens !== undefined ? { usageCacheWriteTokens: totals.cacheWriteTokens } : {}),
+        ...(totals.reasoningTokens !== undefined ? { usageReasoningTokens: totals.reasoningTokens } : {}),
+        timestamp: new Date().toISOString(),
+    };
+}
 export function agentCreatedContext(agent) {
     return {
         event: 'agent/created',

package/lib/history.d.ts

@@ -9,7 +9,7 @@ export interface HookRunRecord {
     command: string;
     sessionId?: string;
     sessionName?: string;
-    outcome: 'spawned' | 'spawn-failed' | 'timeout' | 'exit-0' | 'exit-nonzero' | 'sent' | 'send-failed';
+    outcome: 'spawned' | 'spawn-failed' | 'timeout' | 'exit-0' | 'exit-nonzero' | 'skipped' | 'sent' | 'send-failed';
     exitCode?: number;
     durationMs?: number;
     /** stderr tail or error message. */

package/lib/index.d.ts

@@ -59,7 +59,7 @@ export { createHistorySink } from './history.js';
  * Model-facing announcement, installed only when the system-prompt service
  * exists (web profile). Tells agents the plugin exists and how to cooperate.
  */
-export declare const DSH_HOOKS_GUIDANCE = "\u672C\u673A\u5DF2\u5B89\u88C5 dsh-hooks \u63D2\u4EF6\uFF08DeepSeek Harness \u914D\u7F6E\u9A71\u52A8\u751F\u547D\u5468\u671F hooks\uFF09\uFF1A\u53EF\u5728 profile \u7684 cordis.patch.yml \u58F0\u660E\u300C\u4E8B\u4EF6 \u2192 \u547D\u4EE4/\u901A\u77E5\u300D\u7684 hook\uFF08turn/start\u3001turn/end\u3001tree/settled\u3001step/end\u3001tool/call\u3001tool/result\u3001user/message\u3001approval/asked\u3001approval/decided\u3001session/title\u3001session/created\u3001session/disposed\u3001agent/created\u3001agent/disposed\u3001agent/error\u3001agent/status\u3001hook/failed \u5171 17 \u7C7B\u4E8B\u4EF6\uFF09\uFF0C\u652F\u6301 when \u539F\u56E0\u8FC7\u6EE4\u3001match \u5B57\u6BB5\u6B63\u5219\u8FC7\u6EE4\u3001stdin JSON \u8F93\u5165\u3001opt-in \u91CD\u8BD5\u3001\u5185\u7F6E webhook/desktop \u901A\u77E5\u6E20\u9053\uFF1B\u6267\u884C\u5386\u53F2\u8BB0\u5F55\u4E8E ~/.dsh/dsh-hooks/history.jsonl\uFF1B`dsh-hooks dry-run <event>` \u53EF\u6A21\u62DF\u4E8B\u4EF6\u9A8C\u8BC1\u914D\u7F6E\u3002\u7528\u6237\u63D0\u5230\u300Chooks / \u94A9\u5B50 / \u751F\u547D\u5468\u671F / \u901A\u77E5\u914D\u7F6E\u300D\u65F6\u5373\u6307\u672C\u63D2\u4EF6\uFF0C\u8BF7\u636E\u6B64\u534F\u4F5C\u3002";
+export declare const DSH_HOOKS_GUIDANCE = "\u672C\u673A\u5DF2\u5B89\u88C5 dsh-hooks \u63D2\u4EF6\uFF08DeepSeek Harness \u914D\u7F6E\u9A71\u52A8\u751F\u547D\u5468\u671F hooks\uFF09\uFF1A\u53EF\u5728 profile \u7684 cordis.patch.yml \u58F0\u660E\u300C\u4E8B\u4EF6 \u2192 \u547D\u4EE4/\u901A\u77E5\u300D\u7684 hook\uFF08turn/start\u3001turn/end\u3001tree/settled\u3001step/end\u3001tool/call\u3001tool/result\u3001user/message\u3001approval/asked\u3001approval/decided\u3001session/title\u3001session/created\u3001session/disposed\u3001agent/created\u3001agent/disposed\u3001agent/error\u3001agent/status\u3001hook/failed\u3001usage/daily \u5171 18 \u7C7B\u4E8B\u4EF6\uFF09\uFF0C\u652F\u6301 when \u539F\u56E0\u8FC7\u6EE4\u3001match \u5B57\u6BB5\u6B63\u5219/\u6570\u503C\u6BD4\u8F83\u8FC7\u6EE4\uFF08\u5982 '>10000'\uFF09\u3001stdin JSON \u8F93\u5165\u3001opt-in \u91CD\u8BD5\u3001\u6267\u884C\u9009\u9879\uFF08enabled \u505C\u7528 / cwd \u5DE5\u4F5C\u76EE\u5F55 / maxConcurrent + debounceMs \u9632\u9AD8\u9891\u98CE\u66B4\uFF09\u3001\u5185\u7F6E webhook/desktop \u901A\u77E5\u6E20\u9053\uFF1B\u6267\u884C\u5386\u53F2\u8BB0\u5F55\u4E8E ~/.dsh/dsh-hooks/history.jsonl\uFF1B`dsh-hooks dry-run <event>` \u53EF\u6A21\u62DF\u4E8B\u4EF6\u9A8C\u8BC1\u914D\u7F6E\u3002\u7528\u6237\u63D0\u5230\u300Chooks / \u94A9\u5B50 / \u751F\u547D\u5468\u671F / \u901A\u77E5\u914D\u7F6E\u300D\u65F6\u5373\u6307\u672C\u63D2\u4EF6\uFF0C\u8BF7\u636E\u6B64\u534F\u4F5C\u3002";
 export declare function apply(ctx: Context, config?: Config): void;
 export declare const _internals: {
     clearTurnTracking: typeof clearTurnTracking;