返回目录

dsh-auxiliary

精选清单收录维护状态: 活跃

dsh-plugins/dsh-auxiliary

Auxiliary models for DeepSeek Harness: vision understanding and context compression through dedicated model routes. DeepSeek Harness 辅助模型插件:为视觉理解、上下文压缩、审批审查、子代理、会话标题与图片生成提供独立的模型路由、工具与系统提示,全程不触碰主对话模型。

前往 GitHub项目主页
$ dsh plugin --profile <PROFILE> add @dsh-plugin/dsh-auxiliary

16

星标

4

Fork

TypeScript

语言

LGPL-3.0

许可证

2026-08-14

创建于

2026-11-20

最近推送

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` 则要用上游端点确实能生成图片的模型

安装步骤

  1. 01

    给该 profile 加上依赖:`dsh plugin --profile <PROFILE> add @dsh-plugin/dsh-auxiliary`(或该 profile 对应的插件管理器命令)

    $ dsh plugin --profile <PROFILE> add @dsh-plugin/dsh-auxiliary

  2. 02

    从 0.4.1 起该包是 bundle 插件,`dsh plugin add` 会同时把它写进 `dsh.profile.bundles`,不需要手工往 `cordis.patch.yml` 插行

    $ dsh plugin add

  3. 03

    如果 pnpm 报 `ERR_PNPM_IGNORED_BUILDS`,在 profile 的 `pnpm-workspace.yaml` 中批准 `prepack` 构建(`allowBuilds`)后重试

  4. 04

    删掉 `cordis.patch.yml` 里 0.4.1 之前的手工插入行,否则 bundle 层与该行会把它挂载两次

  5. 05

    确认 `node_modules/@dsh-plugin/dsh-auxiliary` 下有 `lib/index.js` 与 `lib/client.js`;若构建产物缺失,在插件目录执行 `npm run build` 后重新添加

    $ npm run build

  6. 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 适配原生运行时

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` 设置命名空间不会被自动导入,需要手工复制,且手工改文件后要重载插件或重启。
2026-08-142026-11-13作者未说明

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` 复选框无法给纯文本模型加上视觉能力。

08数据与来源

  • 作者声明github.com9228fa9d05bd…

    `dsh-auxiliary` is a [DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harness/) plugin that layers auxilia…

  • 作者声明github.com9228fa9d05bd…

    Add the plugin dependency: `dsh plugin --profile <PROFILE> add @dsh-plugin/dsh-auxiliary` (or the equivalent plugin-mana…

  • 作者声明github.com9228fa9d05bd…

    Since 0.4.1 the package is a bundle plugin (declares `dsh.bundle.patch`), so `dsh plugin add` also appends it to `dsh.pr…

  • 作者声明github.com9228fa9d05bd…

    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 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。