前言¶
在 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 上下文中的加载瓶颈。它将资源管理与路由逻辑解耦,使智能体能够高效地调用特定场景下的工具与文档。