配置 jev key（keychain 优先，零明文）

解析顺序固定：apiKey 选项 → TYPESAFE_API_KEY → JEV_API_KEY → macOS Keychain。

security add-generic-password -s typesafe.ai -a "$USER" -w

需要换 service/account 就设 JEV_KEYCHAIN='[:]'。没配 key 时插件等价于关闭：一条 boot info、零监听器、运行期零输出。

配置项

键	默认	说明
`mode`	`'off'`	`off` / `once` / `auto`。`auto` = 本地关键词闸门，命中才问 Jev，未命中完全静默；要求非空 `autoKeywords`，且未配 `logDir` 时 boot 会打一行 info 说明无法校准
`agentsDir`	`'~/.dsh/agents'`	默认字面量按 dsh home 解析，`DSH_HOME` 照常生效
`toolName`	`'use_agent'`	gate 探的派发工具名
`provider`	`'spawn'`	gate 探的 subagent provider
`triggers`	`['/dispatch', '/jev']`	触发词表，任何 mode 下都优先于关键词闸门
`autoKeywords`	中英双语任务动词词典（见用法节）	`auto` 的本地闸门词典；中文走子串、ASCII 走词边界（允许 `s`/`es`/`ed`/`ing`/`ment`/`ments`/`d` 一个后缀，`fix` 覆盖 `fixing`、`remove` 覆盖 `removed`，但不命中 `prefix`），连字符算词分隔符，多词词条内部的词间分隔符是「任意一段非字母/数字/下划线字符」（所以 `help,me`/`help-me` 命中，而 `help_me`/`helpXme` 不命中），匹配前做 NFKC + 空白折叠（只作用于匹配副本），不分大小写；只在 `auto` 下被咨询
`timeoutMs`	`5000`	单次 jev 调用的死线（ms）。命中回合除了这次调用，还要叠加 roster 现读、脱敏组装、渲染注入这些开销——所以它不是"一个回合最坏会多等的毫秒数"，只是其中最大的一块；超时 fail-open 放行，turn 照常走，只是没有建议
`stateChars`	`1200`	state 上限
`model`	`null`	jev 模型 id，`null` 用 core 的钉版
`thresholds`	见上表	六个闸各自可配
`skipSubagentSessions`	`true`	子代理自己的 turn 不给建议（不递归）
`logDir`	`null`	传目录才开 verdict log
`redactPatterns`	`[]`	追加脱敏正则（源码字符串）
`includeDismissLine`	`true`	建议末尾的"可以无视"声明

@aiwayds/dsh-agent-dispatch

安裝

說明文件

配置 jev key（keychain 优先，零明文）

配置项