Lichadai/dsh-we-need-plugin ↗★ 2
dsh-we-need-plugin
DSH We Need 插件:按发给上游的 model id 里的 DeepSeek + Flash 筛选(provider 不限,大小写不敏感),把 seed.txt 的实际内容注入为 WeNeed assistant seed;仅适用于 DSH。
Install
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Lichadai/dsh-we-need-pluginREADME
Read the full README ↗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
字段含义:
| 字段 | 含义 |
|---|---|
provider | DSH provider route,必须完全一致;只影响这条高级路由 |
id | DSH model id,必须完全一致 |
name | 可选显示名;只有 matchName: true 时才参与匹配 |
baseURL | 上游 base URL;插件会自动追加 /chat/completions |
apiKeyEnv | 凭据引用名,不是 key 值 |
contextWindow | 可选上下文窗口 |
maxTokens | 可选最大输出 |
streamOptions | 某些上游不接受 stream_options 时设为 false |
没有配置的 provider/model 会原样 next(),不会被误发到别的上游。