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 個值得優先安裝的外掛,涵蓋各個分類。
