前言¶
DeepSeek Harness (DSH) 生态采用插件化架构,开发者通常需要通过斜杠命令来调用 Skill。面对大量 Skill,记忆命令的成本较高,且容易出错。dsh-skills-input 插件在输入框侧边增加了 Skill 选择入口,允许用户通过界面浏览、搜索并选择 Skill,将生成的调用指令安全写入草稿。
插件定位¶
dsh-skills-input 是一个 DSH Skill 选择器和 Skill 浏览器。它帮助不熟悉命令的用户发现当前会话可用的工作方式,通过可视化的方式将宿主实际识别的调用指令注入到编辑器中。
该插件由用户 konglong87 维护,开源协议为 MIT。
核心功能¶
该插件主要提供以下能力:
- UI 入口:在输入框右侧增加“选择 Skill”按钮。
- 浏览与搜索:支持按名称搜索,并展示 Skill 的真实名称和描述。
- 草稿注入:将调用指令安全写入草稿,不自动发送,保留原有内容。
- 上下文过滤:按当前会话
cwd和项目根目录过滤,避免将其他工作区的 Skill 混入列表。 - 权限过滤:自动过滤
userInvocable === false的模型专用 Skill。 - 交互支持:支持搜索、键盘操作、暗色模式适配。
安装与启用¶
安装该插件需要启用提供特定接口的 Skill Explorer 组件。
-
安装插件
在已安装 dsh 的环境中执行以下命令:
dsh plugin --profile web add github:konglong87/dsh-skills-input
-
依赖条件
本插件不扫描磁盘,也不维护独立的 Skill 数据库。它依赖宿主提供的接口来获取 Skill 列表。请确保当前会话中已启用一个提供
/api/dsh-skill-explorer/list接口的 Skill Explorer 组件。安装并配置好依赖后,重启 web profile 即可生效。
使用流程¶
使用该插件通常需要经过以下步骤:
- 打开 dsh 对话页面,点击输入框右侧的“选择 Skill”按钮。
- 在弹出的搜索框中输入 Skill 名称的片段,使用鼠标或键盘选择目标 Skill。
- 确认选择后,插件会将
/skill-name格式的调用指令写入当前草稿。 - 检查草稿内容,确认无误后由用户自行发送。
注意事项¶
该插件仅负责发现、选择和回填草稿,不参与 Skill 的生命周期管理。
- 不负责 Skill 管理:不负责 Skill 的安装、编辑或删除。
- 无独立数据:不扫描磁盘,不维护独立的 Skill 数据库。
- 不自动执行:不自动执行 Skill,发送权始终在用户手中。
- 不修改核心:不修改 dsh 核心,仅作为客户端插件运行。
- 冲突检测:当草稿首个非空命令行已有其他斜杠命令时,插件会提示冲突并停止插入。
- 依赖提示:如果缺少 Skill Explorer 依赖,插件会显示提示信息,而不是伪装成空列表。
结语¶
dsh-skills-input 是 DSH 生态中用于简化 Skill 调用流程的实用工具。它通过复用宿主的 Skill Explorer 接口,提供了低门槛的 Skill 选择体验,适合需要频繁切换或浏览 Skill 的开发者使用。更多细节可查阅 GitHub 仓库。