LGPL-3.0 的 TypeScript DSH bundle 插件,为视觉、压缩、复核、标题与图片生成调用各自分配模型路由,用 reconcile 机制实时重配,且不改动主会话路由。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-11-16
许可证
LGPL-3.0
01它能帮你完成什么?
把某一类窄调用——上下文压缩、会话标题、审批复核——放到单独的便宜或更强模型上,同时不切换跑主对话的模型
这些调用落在插件卡片里设置的 provider/model 组合上;只替换 provider/model,超时、重试、回退与主会话路由仍由 harness 负责
主模型成本较高、希望把压缩摘要与会话标题放到便宜路由、或把自动复核放到更强模型上的使用者
在主模型只接受文本的会话里,仍然能用上图片
图片通过准入预检,纯文本路由收到可持久化的 `[image: {…}]` 文本引用,模型调用 `describe_image` 取回描述;支持图片的路由仍收到原始 `ImageBlock`
主路由只支持文本、但仍需要看懂截图与粘贴图片的会话
在会话内直接生成或编辑图片,走 profile 已经授权的 images API
工作目录 `.dsh/generated/` 下的 PNG 文件,以路径返回,主模型可用 `inspect_image` 检查
已配置 OpenAI 兼容 images 提供商、希望在同一段对话里生成并核验插图的使用者
在 profile 持续运行的情况下,从 Web UI 重新调整任意路由——提供商、模型、图片交接、压缩阈值
后续请求即按新路由执行:每个特性由 `reconcile*()` 与 disposer 成对管理,只注册或释放条件发生变化的部件
在运行中的 profile 上按特性权衡成本与质量、而不想重启的人
02如何接入 DeepSeek Harness?
前置条件
- Node.js 24.9+ 与 dsh-loader 2.x —— 插件消费的是 2.x 的 facade
- DSH 版本落在六个明确的发布族内:`0.1.5`、`0.1.6`、`0.1.7`、`0.2.0`、`0.2.1`、`0.2.2`,预发布版也算
- 要装进去的 profile —— README 的安装块里写 `<PROFILE>`,没指定时会先问你
- 已在官方 Models 页面配置好的 provider/model 路由 ID;插件卡片只是指向已有路由
- 所选视觉提供商上要有支持视觉的模型;`generate_image` 则要用上游端点确实能生成图片的模型
安装步骤
- 01
给该 profile 加上依赖:`dsh plugin --profile <PROFILE> add @dsh-plugin/dsh-auxiliary`(或该 profile 对应的插件管理器命令)
$ dsh plugin --profile <PROFILE> add @dsh-plugin/dsh-auxiliary
- 02
从 0.4.1 起该包是 bundle 插件,`dsh plugin add` 会同时把它写进 `dsh.profile.bundles`,不需要手工往 `cordis.patch.yml` 插行
$ dsh plugin add
- 03
如果 pnpm 报 `ERR_PNPM_IGNORED_BUILDS`,在 profile 的 `pnpm-workspace.yaml` 中批准 `prepack` 构建(`allowBuilds`)后重试
- 04
删掉 `cordis.patch.yml` 里 0.4.1 之前的手工插入行,否则 bundle 层与该行会把它挂载两次
- 05
确认 `node_modules/@dsh-plugin/dsh-auxiliary` 下有 `lib/index.js` 与 `lib/client.js`;若构建产物缺失,在插件目录执行 `npm run build` 后重新添加
$ npm run build
- 06
打开 loader 托管的插件配置,填入 provider/model 组合,并在 Settings → Models 里标记要使用的模型
验证接入成功
- `node_modules/@dsh-plugin/dsh-auxiliary` 下存在构建好的 `lib/`,至少含 `lib/index.js` 与 `lib/client.js`
- 让 agent 对一个 Host 可读路径执行 `inspect_image` —— README 的例子是 `Use inspect_image to analyze screenshots/error.png`
- 安装块到核验为止:不要启动 profile,只回报改了什么
03DSH 适配与能力边界
DSH bundle 插件,挂在 harness 的 LLM seam 上:用 `dsh plugin --profile <PROFILE> add @dsh-plugin/dsh-auxiliary` 安装后由 `dsh.bundle.patch` 挂载,`llm/stream` 瀑布监听器通过 `ctx.llm` 按用途重路由调用,`ctx.tools.register` 则注册 `inspect_image`、`describe_image`、`generate_image` 三个工具
按用途匹配的模型路由
插件卡片里填写的 provider/model 组合,指向 Models 页面已配置好的路由→命中的调用带着冻结的替换配置重新进入 `ctx.llm.stream()`;其余调用原样透传
特性开启后 `llm/stream` 监听器会一直装着,在没有完整路由前保持纯透传替换配置保留同一个路由标记,因此相等判断能阻止路由器匹配自己的重入视觉理解与 `inspect_image`
Host 可读的图片路径(绝对路径或工作区相对路径),以及可选的问题→所选视觉模型给出的文本回答,可按 `vision.maxTokens` 截断
通过 `ctx.attachments` seam 提交图片文件只有在 `tool.enabled` 打开且视觉路由完整时才注册该工具`tool.maxImageBytes` 限制单个文件大小,`tool.timeoutMs` 是工具调用的协作式预算图片交接与 `describe_image`
在声明能力为纯文本的路由上携带图片的会话请求→用可持久化的文本引用替换图片块,并借 `describe_image` 调用取回文本描述
交接开启期间,运行时包装会为纯文本主路由声明图片输入,使准入预检通过该请求里的图片块被文本引用替换,工具结果里的嵌套图片也会被改写改写是请求级的:中止、报错、迭代器提前关闭与插件卸载都保持宿主原有的流语义压缩路由与可选压缩引擎
Context compaction 分组里的 provider/model 组合,引擎另需 `engine.enabled` 与 `engine.compressPrompt`→所有 `purpose: 'compaction'` 摘要调用都由辅助模型承担;开启引擎后摘要按明确的压缩指令生成,并在 `engine.thresholdRatio` 处自动触发
`engine.enabled: true` 会替换自带的压缩后端;若同时加载 `@deepseek-ai/dsh-compaction-basic`,插件会给出警告并跳过自己的引擎阈值必须高于保留比例(`engine.retainRatio`,默认 16%)审批与会话标题路由
Approval model 与 Title model 分组里的 provider/model 组合→官方自动复核调用与 `purpose: 'session-title'` 调用由所选模型回答,提供商自身配置与主会话路由不受影响
只替换 provider/model,策略、输入、Session 归属、取消与判定仍走原生逻辑官方自动复核插件及其 Auto 权限模式仍需单独启用会话标题提供商保留自己的部署级配置,只有 `purpose: 'session-title'` 调用被转移图片生成与 `generate_image`
提示词,可选的 `size` 与 `n`,以及可选的 `reference` —— 单张路径或多张路径数组用于多参考图编辑→工作目录 `.dsh/generated/` 下的 PNG 文件,以路径返回
调用提供商 OpenAI 兼容 images API 的 `POST {baseURL}/images/generations` 或 `POST {baseURL}/images/edits`每次调用都通过 harness 的凭据 seam 解析 `apiKeyEnv`,绝不读 `process.env`生成的图片写入工作目录下的 `.dsh/generated/`
04适合谁?何时不该用?
适合
- 主模型成本较高、希望把压缩摘要与会话标题放到便宜路由、或把自动复核放到更强模型上的使用者
- 主路由只支持文本、但仍需要看懂截图与粘贴图片的会话
- 已配置 OpenAI 兼容 images 提供商、希望在同一段对话里生成并核验插图的使用者
- 在运行中的 profile 上按特性权衡成本与质量、而不想重启的人
不适合
- 兼容范围锁定在 Node.js 24.9+、dsh-loader 2.x 以及六个明确的 DSH 发布族:`0.1.5`、`0.1.6`、`0.1.7`、`0.2.0`、`0.2.1`、`0.2.2`(含预发布版)。README 没有列出其他版本。
- `engine.enabled: true` 会替换自带的压缩后端,因此不能与 `@deepseek-ai/dsh-compaction-basic` 同时运行:插件检测到冲突后会给出警告并跳过自己的引擎,自定义压缩指令也就不生效。
- `Allow image input` 复选框只是写入模型规范的 `input` 声明——它无法给纯文本模型加上视觉能力,所以只有在上游端点确实接受图片时才该勾选。
- 偏好设置存放在 `<profile>/config/dsh-auxiliary/config.json`;旧的 1.x `dsh-auxiliary` 设置命名空间不会被自动导入,需要手工复制,且手工改文件后要重载插件或重启。
05兼容性、维护与安全提示
- 兼容范围锁定在 Node.js 24.9+、dsh-loader 2.x 以及六个明确的 DSH 发布族:`0.1.5`、`0.1.6`、`0.1.7`、`0.2.0`、`0.2.1`、`0.2.2`(含预发布版)。README 没有列出其他版本。
- `engine.enabled: true` 会替换自带的压缩后端,因此不能与 `@deepseek-ai/dsh-compaction-basic` 同时运行:插件检测到冲突后会给出警告并跳过自己的引擎,自定义压缩指令也就不生效。
- `Allow image input` 复选框只是写入模型规范的 `input` 声明——它无法给纯文本模型加上视觉能力,所以只有在上游端点确实接受图片时才该勾选。
- 偏好设置存放在 `<profile>/config/dsh-auxiliary/config.json`;旧的 1.x `dsh-auxiliary` 设置命名空间不会被自动导入,需要手工复制,且手工改文件后要重载插件或重启。
LGPL-3.0 · 暂无发布 · 维护中,最后推送 2026-11-13
06常见问题
怎么把 dsh-auxiliary 装进 DeepSeek Harness?
在目标 profile 里执行 `dsh plugin --profile <PROFILE> add @dsh-plugin/dsh-auxiliary`(没指定 profile 就先问清楚)。从 0.4.1 起该包是声明了 `dsh.bundle.patch` 的 bundle 插件,`dsh plugin add` 会同时把它写进 `dsh.profile.bundles`,不必手工改 `cordis.patch.yml`;若 pnpm 报 `ERR_PNPM_IGNORED_BUILDS`,在 `pnpm-workspace.yaml` 的 `allowBuilds` 里批准 `prepack` 构建后重试;若 profile 里还留着 0.4.1 之前的手工插入行,要删掉,否则会被挂载两次。
它会换掉跑主对话的模型吗?
不会。每条路由只匹配一类调用——`purpose: 'compaction'`、`purpose: 'session-title'`、官方自动复核调用,或它自己注册的工具——只替换 provider/model 后重新进入 `ctx.llm.stream()`。在没有完整路由之前监听器只是纯透传,未配置的特性不会改变任何行为。
在 DSH 会话里路由在哪里配置?
在 loader 托管的插件配置里:一张折叠的卡片集中了视觉、压缩、审批、标题、图片生成与压缩引擎的设置。填入已在官方 Models 页面配置好的 provider/model ID,保存只作用于后续请求、无需重启。偏好设置存在 `<profile>/config/dsh-auxiliary/config.json`,旧 1.x 命名空间不会自动导入,手工改文件需重载插件或重启。
支持哪些 DSH 版本与运行时?
Node.js 24.9+ 与 dsh-loader 2.x,DSH 侧支持六个明确的发布族:`0.1.5`、`0.1.6`、`0.1.7`、`0.2.0`、`0.2.1`、`0.2.2`,预发布版也算。`0.1.6-alpha.2` 之前在 Settings → Plugin configuration 里配置,之后改到插件详情页。
主模型只支持文本时,图片会怎样?
默认开启图片交接:`ctx.llm.resolveModelInfo` 上的运行时包装让图片通过准入预检,纯文本请求收到可持久化的 `[image: …]` 引用,模型再调用 `describe_image` 从视觉路由取回描述;支持图片的路由仍保留原始图片块。关闭 `vision.handoff` 可恢复原有的准入与流行为;另外要注意 `Allow image input` 复选框无法给纯文本模型加上视觉能力。
07相关的 DSH 工作流
dsh-agent-teams
作者 nanmicoder
DeepSeek Harness 的 Agent Teams 多智能体协作插件,支持多个 AI Agent 组成团队,协同完成复杂任务,实现任务分配、并行执行、成员通信与团队协作。 AgentTeams plugin for DeepSeek Harness
dsh-blender-plugin
作者 sixtysevenlf
DSH × Blender 直连插件 v3.0.6:15 个模型工具让 AI 驱动 GUI Blender(视口 / 自定义视角 / 无头 worker / 作业层 / 事务回滚 / 配方库),34 family / 228 op 契约层;npm 安装 + addon zip,GUI 优先、无头备用;dsh-TUI 选中 chip / @ 提及 / /blender,随包建模 skill,支持 WSL / Windows / macOS。
dsh-free-search
作者 dddmuc
为DeepSeek Harness提供的免费网络搜索服务商:即使没有API密钥也可使用。Free web search provider for DeepSeek Harness:usable even without an API key.
dsh-bili-scroll
作者 c1overzz
DSH 插件:每天替你刷一轮 B站,读字幕挑出值得的、写一份日报,值得的 @ 你
08数据与来源
`dsh-auxiliary` is a [DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harness/) plugin that layers auxilia…
Add the plugin dependency: `dsh plugin --profile <PROFILE> add @dsh-plugin/dsh-auxiliary` (or the equivalent plugin-mana…
Since 0.4.1 the package is a bundle plugin (declares `dsh.bundle.patch`), so `dsh plugin add` also appends it to `dsh.pr…
Tools are registered with `ctx.tools.register(defineTool(...))` and announced to the model through `ctx.systemPrompt.sec…
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-16。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
