dsh-skill-router
意图级技能自动路由插件（DeepSeek Harness）——让 AI 在"该用技能的时候"自动用上技能。
深挖一个问题：DSH 会把
<available_skills>技能目录注入上下文，但是否加载技能完全依赖模型自主判断。
技能一多，模型注意力就会漏掉该用的技能——"该用技能的时候不用"。
dsh-skill-router 在agent/pre-step钩子里对每条用户消息做自动路由，命中即把技能全文注入上下文，
模型无需再手动调skill工具。
特性
- 两级路由：中文感知的启发式打分（bigram 切段去虚词 + 拉丁 token 重叠 + 技能名/触发短语命中）零成本快速命中；弱信号才调 LLM 判定（hybrid 模式，默认）
- 复用官方注入管线：命中即按
skill-invocation源注入技能全文——与/技能名手势（dsh-tool-skill）完全同一机制，UI 正常展示 - 零侵入：任何异常都不会阻断 agent 循环（路由失败只意味着退回现状）；不注册任何工具、不占工具目录
- 防误伤：每 agent 近期已注入技能不重复注入；短消息（继续/嗯）不路由；
/技能名手势由官方负责自动跳过 - 与实验预设兼容：
anchored-standard类组合（无skill加载工具）默认自动让位；cot 系预设（cot-gw / cot-dyn）自动识别——组合存在skill_load/skill_search等按需通道时视为可路由，自动注入与按需发现并存；全新会话首条消息不注入（保住首轮 Minimal 锚定）
工作原理
用户消息 → 启发式打分（零 LLM 成本）
├─ 强命中(≥minScore) → 直接注入技能全文（不调 LLM）
└─ 弱信号 → LLM 判定（12s 超时/失败回退启发式第一名）
→ createUserMessage + skill-invocation 源注入注入发生在 agent/pre-step（与 dsh-tool-skill 同一事件、同一注入管线），模型在同一个 step 就能看到技能正文并直接使用。
安装
方式一：运行时注入（dsh-super-injector）
dev_inject_plugin <本仓库目录>方式二：profile bundles（持久）
在 profile package.json 的 dependencies 加 link: 依赖、bundles 数组加包名，重启即装配（见 dsh-super-injector 文档）。
配置
| 字段 | 默认 | 说明 |
|---|---|---|
enabled |
true |
总开关 |
mode |
hybrid |
hybrid / heuristic（零 LLM）/ llm（全判定） |
llmProvider / llmModel |
空 | 指定判定模型；留空自动选第一个可用 provider |
maxSkillsPerMessage |
2 |
每条消息最多注入技能数 |
minScore |
0.5 |
启发式强命中阈值 |
llmTimeoutMs |
12000 |
LLM 判定超时 |
skipShortMessages |
true |
"继续/嗯"等短消息不路由 |
respectOnDemandPresets |
true |
组合无任何技能加载/发现通道（严格 on-demand，如 anchored-standard）时让位；存在 skill 或 onDemandLoaderTools 中任一工具（standard / cot-gw / cot-dyn）时正常自动路由 |
onDemandLoaderTools |
['skill_load', 'skill_search'] |
视为"已提供按需技能通道"的工具名；cot 类预设的 skill_load / skill_search 命中即默认开启路由。至少 1 个（空数组为无效配置：装配校验失败；程序化直调时自动回退默认值） |
与 cot 系预设（cot-gw / cot-dyn）整合
dsch_cot_gw_dyn 的思维链保护预设移除了 9KB 技能目录注入、改由 skill_search/skill_load 按需发现。两者互补：cot 系解决"能力可达、请求面收敛"，本插件解决"模型该用技能时漏用"。本插件升级版（v0.2）自动识别该系预设并正常路由，无需手动改配置。
cot-dyn 推荐装配（preset 内嵌，见 dsh_cot_gw_dyn 的整合说明）：
- id: skill-router
name: 'dsh-skill-router'
disabled: true # 默认禁用：未安装该包时预设照常可用；安装包后删除此行（或改 false）
config:
respectOnDemandPresets: true # 自动识别（cot-dyn 挂载了 skill_load，默认即开启路由）
onDemandLoaderTools: ['skill_load', 'skill_search']
maxSkillsPerMessage: 1 # 思维链保护：一次只注入一个技能全文
mode: hybrid安全设计：preset 内嵌行默认
disabled: true——DSH 装配时完全跳过 disabled 行（不解析包），因此未安装 dsh-skill-router 的机器上预设照常挂载；安装包后删除该字段即可启用。注：cot-gw 的请求面不含 skill 工具（仅 gateway 可转发），router 的自动注入是其技能可达的补强通道；如希望 cot-gw 保持"零注入"纯度，可对该会话设
enabled: false（或注入时不启用该插件行）。
与实验预设（anchored-standard / router-standard）的兼容性
| 预设 | 关系 |
|---|---|
| 默认 standard | 无冲突：保留 dsh-tool-skill 目录注入，本插件是纯增强 |
router-standard |
无冲突：它做 spec/react 任务模式路由，技能侧保留 dsh-tool-skill |
anchored-standard（及 anchored-wsl） |
默认自动让位：该组合故意移除技能目录注入、改由 skill_search/skill_load 按需发现，且首轮有 bootstrap 门禁。本插件检测到当前 agent 没有 skill 加载工具时默认不注入（respectOnDemandPresets: true）；全新会话首条消息也不注入，两条防线共同保住首轮 Minimal 锚定 |
| cot-gw / cot-dyn（思维链保护预设） | 自动识别、正常路由：该系组合没有 skill 工具，但挂载了 skill_load/skill_search 按需通道（onDemandLoaderTools 默认命中）。自动注入的仅是 user 文本（不触碰请求工具面），与 cot 系"请求面收敛 + 文本注入不影响思维链"的实验结论兼容；首条消息仍跳过，保住锚定 |
实测结果
用真实会话技能目录（17 个技能）做的功能测试（test-router.mjs，无 LLM 环境验证启发式路径）：
| 用户消息 | 自动注入 |
|---|---|
| 帮我写一份公文 | official-document-writing ✓ |
| 把这份 PDF 转成 Markdown | markitdown-skill ✓ |
| 帮我整理一下今天的工作 | daily-work-assistant ✓ |
| 深度调研一下国产大模型市场 | deep-research ✓ |
| dsh 打不开了，帮我诊断 | dsh-maintenance ✓ |
| 写一份向上级报送的专项报告 | report-drafting ✓ |
| 用 gh 查一下这个 PR | github ✓ |
| 继续 / 嗯 | 跳过（短消息）✓ |
| B站视频转文字 / 知乎搜索 / 找海报技能 / 网页截图 | 弱信号 → 生产环境由 LLM 判定 ✓ |
开发
# 功能测试（模拟 agent/pre-step，用真实技能目录）
node test-router.mjs
# 升级验证：cot 系预设（含 skill_load 无 skill）自动识别 + 路由注入（20 项断言）
node test-integration.mjs
# 冒烟测试：用 DSH 真实依赖（schemastery/dsh-llm/dsh-skill）真实加载并跑关键路径（18 项）
node smoke.mjs
# 打分调试
node debug-scoring.mjs
smoke.mjs需要能解析@deepseek-ai/*依赖（在 DSH 运行时 node_modules 可见处运行，本机通过node_modulesjunction 指向 DSH 安装目录）。
依赖：@deepseek-ai/dsh-llm（createUserMessage、ctx.llm.stream）、@deepseek-ai/dsh-skill（ctx.skills.snapshot/get、renderSkillContent、isModelInvocable）、@deepseek-ai/schemastery（Config）。
License
MIT