在 DeepSeek Harness (DSH) 的开发中,模型经常需要调用 plugin_manager list_bundles 来获取当前 profile 的 bundle 列表。然而,这个动作默认会返回每个 bundle 的完整声明行,数据量巨大。实测中,某个 profile 里 @deepseek-ai/dsh-base 的声明行就有 94 条。这导致模型在上下文中消耗大量 token,却往往只需要知道 bundle 的名称和状态。
deadbushxw/dsh-plugin-query-enhance 是一个 DSH Host 侧插件,旨在解决这一问题。它不改变底层逻辑,而是通过“投影”和“新工具”两种机制,降低模型调用 bundle 查询工具的成本。
核心功能¶
插件主要提供两项互补的能力:
- 返回瘦身:
list_bundles与list_plugins依然可用,但返回的每条记录只包含摘要信息(如name、version、enabled),去掉了rows、description等大字段。投影发生在 Host 内部序列化之前,意味着这些字节根本没有产生,而不是产生了再被忽略。 - 参数化查询工具:新增
plugin_query工具,支持按name、match、enabled等条件筛选。模型可以精准地查询“哪个 bundle 声明了某个模块”,而不需要把所有 bundle 的所有行都拉出来。
这两个机制都没有改动 @deepseek-ai/dsh-plugin-manager,Web 侧边栏继续直接读服务,卸载即恢复原有行为。
安装与启用¶
安装即 bundle 安装。DSH 会把包写进当前 profile、注册 Loader 行并热应用。安装后需要重启 DSH。
plugin_manager install_bundle github:deadbushxw/dsh-plugin-query-enhance
配置项位于 bundle 自身的 cordis.patch.yml 中,由包导出的 Config schema 校验。没有额外的配置文件或设置页。
典型用法¶
安装完成后,你可以使用以下命令:
plugin_manager list_bundles
plugin_manager list_plugins
plugin_query match="@deepseek-ai/dsh-plugin-manager"
plugin_query name="@deepseek-ai/dsh-base"
适用场景与注意¶
适合需要频繁查询 bundle 状态或依赖关系的 DSH/Agent 开发者。
- 依赖项:插件依赖
@deepseek-ai/schemastery。如果通过本地目录安装,需在克隆目录下执行npm install;通过github:安装则无需此步骤。 - 权限:插件以当前 DSH 进程权限运行。安装前建议检查源码与许可证。
- 生效方式:修改配置或安装后,必须重启 DSH 才能重新装载模块。
总结¶
该插件通过投影和工具增强,解决了 list 动作数据过载的问题,让模型能更高效地使用 bundle 管理接口。