前言¶
在 DeepSeek Harness(DSH)里做智能体时,工具列表通常由插件在启动或会话初始化时写入 Agent 的 schema。能力一多,要么提前把所有插件都挂上,要么遇到「当前 schema 里没有、但任务又需要」的能力时,只能改配置或换一套工具集。
dsh-alfandega 面向后者:用单个按需(on-demand)工具,在 schema 之外按语义查找工具与 Skill,并把命中的工具注册到发起请求的作用域里。下面介绍它是什么、能做什么,以及安装与使用时需要核对的信息来源。
这是什么¶
songjongdevsecops/dsh-alfandega 是由维护者 songjongdevsecops 发布的 DSH 插件,在 SkillHub 社区目录中归类为工作流。
官方简介(英文原文)如下:
DeepSeek Harness plugin: one on-demand tool that finds tools and skills outside the agent schema by meaning and registers the found tool in the requesting scope.
一句话:Agent 不必事先在 schema 里列出所有外部工具;在需要时通过该插件提供的工具做语义检索,再把找到的工具挂到当前请求所在的作用域。
DSH 生态强调「一切皆插件」;SkillHub(skillhub.cn)是社区整理的目录站点,与 DeepSeek、幻方无官方从属关系,安装前仍以仓库源码与许可证为准。
核心功能¶
依据上述简介,可核实的能力边界如下。
单个按需工具¶
插件对外提供一个 on-demand 工具,而不是预先展开一长串固定工具名。智能体在对话中按需调用它,而不是在 schema 里静态声明所有候选。
在 Agent schema 之外按语义查找¶
查找对象是不在当前 Agent schema 中的工具与 Skill。匹配方式强调 by meaning(按语义/含义),而不是仅靠与已注册工具名完全一致的关键字。
注册到请求作用域¶
检索命中后,将找到的工具注册到 requesting scope(发起本次查找的作用域)。这样后续同一会话或同一作用域内的调用可以直接使用新注册的工具,而无需重启 DSH 或手工改全局插件列表。
公开资料中未提供具体检索实现、索引来源或注册 API 的细节;以上三点均来自插件简介原文。
安装与启用¶
编写本文时,预抓取的 GitHub README 不可用;直接访问 https://github.com/songjongdevsecops/dsh-alfandega 亦未拿到可引用的安装说明。因此本文不包含未经原文核实的 dsh plugin add … 命令。
建议按下面顺序核对:
- 打开 SkillHub 目录页:
https://www.skillhub.cn/plugins/songjongdevsecops/dsh-alfandega
查看是否列出与 DSH 版本匹配的官方安装命令。 - 当 GitHub 仓库 README 可访问时,以 README 中的安装与启用步骤为准。
- 安装前阅读插件源码与许可证;插件在当前 dsh 进程权限下运行,与本地其它 DSH 插件相同。
若目录页与 README 均未给出命令,请勿凭仓库名自行拼接安装参数,以免与维护者实际发布方式不一致。
典型用法(逻辑流程)¶
公开文档中暂无可逐行复制的配置示例或 CLI 片段。根据简介,可理解的调用链如下,供你在 README 补齐后对照验证。
- 在 DSH 中启用
dsh-alfandega,保证智能体侧能看到该 on-demand 工具。 - 当任务需要的能力不在当前 Agent schema 时,由智能体调用该工具,并用自然语言或任务描述表达「需要什么能力」(对应简介中的语义查找)。
- 插件在 schema 外检索工具与 Skill;命中后把对应工具注册到当前请求的作用域。
- 在同一作用域内继续任务,使用刚注册的工具完成后续步骤。
具体工具名、参数 schema、以及「作用域」在 DSH 中的精确定义,需以仓库文档为准。
适用场景与注意¶
适合谁
- 希望减少「为每一种可能能力预先注册工具」的配置负担的 DSH / 智能体开发者。
- 工作流类场景:任务中途才明确需要某外部工具或 Skill,且该能力未写在初始 schema 里。
- 愿意接受「先发现、再注册、再调用」两阶段流程,而不是静态工具清单的团队。
使用注意
- 插件以当前 dsh 进程权限运行;安装前务必审查源码与许可证,并了解注册进来的第三方工具会继承相同权限边界。
- 语义查找可能命中错误或过宽的结果;在生产环境应结合人工确认或策略约束,公开简介未描述内置的安全过滤。
- GitHub 上该仓库在核对时无法作为可读文档来源(页面不可访问或未公开);星标等元数据以目录页展示为准(线索记载为 0 star),实际以你访问时页面为准。
- 社区目录与 GitHub 均由维护者与社区提供,不等同于官方应用商店审核结果。
结尾¶
dsh-alfandega 把「在 Agent schema 外按语义找工具与 Skill,并注册到请求作用域」收敛成一个按需工具,适合工作流里动态扩能力的场景。安装命令与示例请以 SkillHub 与 GitHub README 的最新原文为准。
- 目录页:https://www.skillhub.cn/plugins/songjongdevsecops/dsh-alfandega
- GitHub:https://github.com/songjongdevsecops/dsh-alfandega