前言¶
在 DeepSeek Harness(DSH)的插件生態中,插件通常以扁平的會話目錄形式提供。然而,對於生物信息學這類場景,一個精心策劃的技能庫可能包含數百個技能。直接將這些內容放入會話提示詞會導致龐大的體積(約 230 KB / 60-80k tokens),造成上下文浪費。
dsh-bioinf-routed 插件旨在解決這個問題。它將原本的目錄模式替換爲基於搜索的路由模式,允許智能體通過關鍵詞檢索技能,而非一次性加載所有內容。
插件簡介¶
這是一個融合的生物信息學資源路由插件。它繼承了 dsh-bioinf 的核心設計風格,保留了 BM25 技能搜索和場景引導功能,並在此基礎上集成了數據湖、模型註冊表(ADMET/docking/repurposing + server)、知識文檔和軟件庫等能力。這些資源被統一管理,並在一個小型模型路由器(bioinf_route)背後運行,可選 LLM 路由器進行擴展。
該插件由用戶 gsh150801 維護,採用 MIT 許可證。
核心功能¶
插件主要提供以下能力:
- BM25 風格技能搜索:支持 CJK 雙語分詞的評分機制,用於檢索技能。
- 分類樹瀏覽工具:提供頂層分類和子分類,支持按領域瀏覽。
- 生物信息學庫集成:註冊 986 個技能到上下文中,供原生
skill工具按需調用。 - Web 搜索提供程序:註冊
dsh-bioinf-anysearch到ctx.web,爲原生web_search工具提供數據源支持。 - 遠程執行工具(可選):支持通過 SSH 在配置的 GPU 訓練服務器上執行命令(如
nvidia-smi、後臺訓練、日誌輪詢和預測任務)。 - 指導提示模塊:包含路由規則(如“絕不猜測技能名稱”)以及三個場景劇本(文獻深度審閱、生物數據檢索/分析、遠程訓練/預測)。
配置與啓用¶
使用該插件需要準備本地文件和配置。
前置要求:
* 需要本地 skillsIndexFile 文件。
* 需要本地 anysearch-plugin.js 文件。
* 需要安裝 Peer Dependencies:@deepseek-ai/cordis、@deepseek-ai/dsh-skill、@deepseek-ai/dsh-tools、@deepseek-ai/dsh-web、@deepseek-ai/schemastery。
配置示例(以 cordis.patch.yml 或配置文件爲例):
- insert:
# 註冊 bioinf 技能庫和索引
- id: bioinf
name: 'file:///path/to/dsh-bioinf/lib/index.js'
config:
skillsIndexFile: '/path/to/skills_meta/_dsh_index.json'
# 註冊 Web 搜索提供程序
- id: bioinf-anysearch
name: 'file:///path/to/dsh-bioinf/lib/anysearch-plugin.js'
config:
apiKey: 'your_api_key'
典型用法¶
啓用插件後,通常需要配合 dsh-tool-skill 使用,並關閉原生目錄功能。
- 關閉原生目錄:
配置@deepseek-ai/dsh-tool-skill時,將catalog設置爲off。
- id: tool-skill
name: '@deepseek-ai/dsh-tool-skill'
config:
catalog: off
- 啓用遠程執行:
若需使用 SSH 執行遠程 GPU 任務,需在配置中設置主機和用戶信息。
config:
remote:
host: 'gpu-server.example.com'
user: 'username'
注意事項¶
- 權限與安全:插件以當前 DSH 進程的權限運行,請確保在使用前檢查源碼與許可證。
- 文件依賴:必須正確配置
skillsIndexFile和anysearch-plugin.js的路徑,否則相關功能無法加載。 - 遠程連接:使用遠程執行功能需要配置正確的 SSH 連接參數(
remote.host和remote.user)。
總結¶
dsh-bioinf-routed 通過引入搜索和路由機制,解決了大型生物信息學技能庫在 DSH 上下文中的加載瓶頸。它將資源管理與路由邏輯解耦,使智能體能夠高效地調用特定場景下的工具與文檔。