Lichadai/dsh-we-need-plugin ↗★ 2

dsh-we-need-plugin

DSH We Need 插件:按发给上游的 model id 里的 DeepSeek + Flash 筛选(provider 不限,大小写不敏感),把 seed.txt 的实际内容注入为 WeNeed assistant seed;仅适用于 DSH。

套件
dsh-we-need-plugin
相容性
待驗證
Harness 依賴範圍
>=0.2.2-rc.1
版本
0.7.1
授權
MIT
最近更新
2026年11月7日

安裝

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Lichadai/dsh-we-need-plugin

0.3 使用 DeepSeek 的建议

  • 工作区保持干净,项目尽量少;及时清空不必要的文件夹、临时文件和旧项目。
  • 工具调用时间往后延:在 skill 目录不是特别大时,先让模型读 skill、做规划,最后再调用工具。不要让庞大的工具基座信息先冲散思维。
  • 工具很多、文件夹很杂、skill 很长时,优先清理上下文;不要只依赖 seed。
  • 出现 Let me、I、I will 时,先怀疑工具调用过多,或信息获取不当、过大;不要只怪模型。

0.5 使用技巧(先读这个)

这些技巧和 seed 一样重要。工具很多、工作区很杂、skill 很长时,它们比 seed 更能决定模型会不会进入 WeNeed。

0.5.1 工具尽量往后调用

  • 先让模型分析问题、做计划、想清楚要改哪些文件;不要一上来就读一堆文件、跑一堆命令。
  • 工具 schema 很多、skill catalog 很长时,先读 skill、做规划,再调用工具。
  • 如果任务不需要工具,直接让模型思考/回答;不要为了“看起来在工作”而过早调用工具。
  • 工具调用越早、越多,后面的 reasoning 越容易被工具结果和细节带偏。

0.5.2 先思考,不要急着写下来

  • 先让模型想清楚“要解决什么、分几步、每一步怎么验证”,但不要要求它立刻写文件或改代码。
  • 先让它思虑一段时间,再决定是否调用工具;尤其是大任务、跨文件任务。
  • 计划可以先留在 reasoning 里,不必马上落盘;落盘会引入额外工具步骤和上下文。

0.5.3 Skill 可以看,但不要过早调用工具

  • skill 目录不大时,先让模型读相关 skill,再做计划。
  • 不要让模型在读 skill 的同时并行调用大量工具。
  • skill 信息本身也会占上下文;读最相关的,不要把全部 skill 都塞进去。

0.5.4 其他

  • 工作区保持干净,项目少,临时文件少。
  • 工具多时,优先清理不用的工具和配置。
  • 出现 Let me、I、I will 时,先减少工具和信息,不要只加 seed。
  • seed 是概率性增强,不替代上下文管理。

0.6 模型筛选规则:什么时候生效

代码位置:index.js → isTarget()。

匹配文本默认只有:

const text = String(modelId ?? '').toLowerCase();
  • modelId 是 DSH 传给 provider 的 model id,也就是请求里的 model 字段;我们的自定义 adapter 会原样写入 body.model,delegated 模式也保留它;
  • 不是 UI 上看到的显示名;
  • 只有显式 matchName: true 时,才把 interceptModels[].name 拼进来;
  • provider 名称完全不参与匹配;
  • 默认 targetRules: [deepseek, flash],两个词必须同时出现;
  • 大小写不敏感。

真正生效要同时满足:

1. model id(或显式 matchName 时的 name)命中 targetRules;
2. 不是插件自己的 provider,且 purpose 为空;
3. 不是 tool step、压缩请求、标题/建议调用;
4. target 没有被设成 false;
5. DSH 有 ctx.llm.prepareCall(当前版本有)。

不需要 interceptModels 路由,也不需要按 provider 配置 baseURL/key。没有路由时走 delegated 模式,见 0.7。

例子:

  • deepseek-v4.1-flash:id 含两个词,命中;
  • d4/deepseek-v4.1-flash-1017:即使没配 d4 路由,也命中;
  • vendor-alias,显示名 DeepSeek-V4.1-Flash:默认 matchName: false,不命中;显式 matchName: true 并配置 name 后才命中;
  • deepseek-v4-pro:没有 flash,不命中。

怎么改:

  • 只改识别范围:改 targetRules;
  • 默认不要改 provider;任何 provider 都走原 adapter;
  • 如果模型 id 是 opaque、只有显示名可读:当前版本需要高级自定义路由(matchName: true + 完整 interceptModels 路由),见 10.8;默认不靠显示名;
  • 想让插件自己发 HTTP、精确控制字段顺序:才需要 interceptModels 路由(高级选项,见第 8/9 节);
  • 未来模型(4.1 Pro、Kimi K3.1 等)的写法见第 10 节。

0.7 它怎么工作(provider 不限)

默认发布包不注册 provider,也没有 interceptModels 路由。命中模型 id 后:

1. 过滤 skill catalog;
2. 在最后一条真实 user task 前插入 assistant seed;
3. ctx.llm.prepareCall(provider, model, controls) 取得原 provider 的调用句柄;
4. prepared.stream({ ...原 options, ...prepared.config, messages: 注入后的 messages, __weneedBypass: true });
5. 原 provider adapter 用原来的 baseURL / key / 协议发请求;
6. __weneedBypass 防止再次进入本插件,避免递归。

所以:

  • 任何 provider 都可以用,不需要提前知道供货商;
  • API key、baseURL、模型别名都沿用 DSH 原来的配置;
  • 插件只需要模型 id 里有 deepseek 和 flash;
  • delegated 模式使用原 adapter 的序列化,字段顺序由原 provider 决定;如果要严格的 DSH 自定义 wire 字段契约,才使用可选的 interceptModels 路由。

8. 配置

8.1 targetRules:哪些模型被注入

默认发布规则只有一个:

targetRules:
  - [deepseek, flash]

含义:

model id 同时包含 deepseek 和 flash
大小写不敏感
provider 不参与匹配
默认不读显示名(matchName: false)

所以 deepseek-v4-flash、deepseek-v4.1-flash、deepseek-v4.1-flash-1017 都会命中。

8.2 interceptModels:可选的高级路由

普通用户不需要配 interceptModels。 发布包默认没有它;没有路由时,插件使用原 provider adapter,自动沿用原来的 baseURL 和 API key。

只有想让插件自己发 HTTP、精确控制最终字段顺序时,才加:

intercept: true
matchName: false
targetRules:
  - [deepseek, flash]
interceptModels:
  - provider: opendesign
    id: deepseek-v4.1-flash
    name: DeepSeek-V4.1-Flash
    baseURL: https://amr-link.open-design.ai/v1
    apiKeyEnv: OPENDESIGN_API_KEY

字段含义:

字段含义
providerDSH provider route,必须完全一致;只影响这条高级路由
idDSH model id,必须完全一致
name可选显示名;只有 matchName: true 时才参与匹配
baseURL上游 base URL;插件会自动追加 /chat/completions
apiKeyEnv凭据引用名,不是 key 值
contextWindow可选上下文窗口
maxTokens可选最大输出
streamOptions某些上游不接受 stream_options 时设为 false

没有配置的 provider/model 会原样 next(),不会被误发到别的上游。