安装

1. 安装插件

在已经安装 dsh 的环境中执行：

dsh plugin --profile web add github:konglong87/dsh-skills-input

2. 安装依赖

本插件采用方案 A：复用现有 Skill Explorer。请同时安装并启用一个真正提供下面接口的 Skill Explorer 组件：

GET /api/dsh-skill-explorer/list?cwd=<当前会话 cwd>

然后重启 web profile：

dsh --profile web

需要指定端口时：

dsh --profile web --port 3080 --no-open

重要：这里要求的是提供 /api/dsh-skill-explorer/list 接口的 Skill Explorer。 不要假定所有名为 “Skill Manager” 的插件都兼容。本插件不会扫描磁盘，不会新建 Skill 数据库，也不会提供 Skill 管理后台。

项目简介

dsh-skills-input 是一个独立的 dsh composer 插件，在输入框右侧增加“选择 Skill”按钮。

它读取当前会话可见的 Skill 目录，展示真实的 Skill 名称和描述；用户选中后，插件把宿主实际识别的 /skill-name 调用指令写入草稿。原有内容会保留，消息不会自动发送，最终发送权始终交给用户。

亮点

效果

以下截图来自真实 dsh 页面，使用隔离测试环境和无外部副作用的测试 Skill。

_{桌面端：打开面板、搜索 Skill、查看描述并完成选择}

_{移动端：面板适配窄屏，选择后保留原草稿}

_{依赖缺失：明确提示需要 Skill Explorer，不误显示为空列表}

使用

1. 打开 dsh 对话页面，点击输入框右侧的“选择 Skill”。
2. 在搜索框输入名称片段，使用鼠标或键盘选择目标 Skill。
3. 查看真实名称和描述后确认选择。
4. 插件把 /skill-name 写入当前草稿，并保留原有内容。
5. 检查草稿，确认无误后由用户自行发送。

键盘操作：

V1 采用单选模型，一次只插入一个 Skill 调用指令。列表和草稿都不会被插件持久化。

兼容边界

必须提供的接口

Skill Explorer 接口返回的目录至少需要包含：

• 顶层：cwd、projectRoots、groups
• 分组：groups[].skills[]
• Skill：name、description、userInvocable
• 项目级 Skill：建议提供 path 和 level

插件会使用 projectRoots、当前会话 cwd 和 Skill 的路径信息判断作用域。当前列表只保留：

• 当前会话上下文内的 Skill
• userInvocable !== false 的 Skill
• 名称格式符合 dsh Skill 调用规则的 Skill
• 去重后的 Skill 名称

宿主契约

以下行为已经从当前 dsh 源码和真实页面核实：

• 插槽：conversation.input.right
• Client inject：slots、sessions
• 当前工作目录：sessions.list.getSnapshot().byId[sessionId].cwd
• 请求鉴权：浏览器同源请求，使用 credentials: "same-origin"，不添加自定义鉴权头
• 草稿写回：composer 提供的 inputActions.setDraft()
• Skill 调用：首个符合边界的 /skill-name 文本，由 dsh 在 agent/pre-step 阶段注入 Skill instructions

不做什么

本插件只负责“发现、选择、回填草稿”，不负责 Skill 生命周期管理。它不提供：

• Skill 安装、编辑或删除
• Skill 管理后台
• 独立 Skill 数据库
• 多 Skill 编排
• 自动发送
• dsh 核心补丁

开发与验证

git clone https://github.com/konglong87/dsh-skills-input.git
cd dsh-skills-input
npm ci
npm run build
npm test
npm pack --dry-run

目录职责：

验证记录见 docs/VERIFICATION.md，截图索引见 screenshots.json。真实 dsh 验收覆盖桌面端、移动端、草稿保留、重复选择、依赖缺失、接口失败、工作区切换、宿主识别和插件卸载。

更新与卸载

更新 GitHub 安装：

dsh plugin --profile web add github:konglong87/dsh-skills-input

查看已安装插件：

dsh plugin --profile web list

卸载插件：

dsh plugin --profile web remove dsh-skills-input

更新或卸载后请重启对应的 dsh profile。

版本与协议

• 当前版本：0.1.0
• 版本记录
• 验证记录
• MIT License

反馈问题时请附 dsh 版本、插件版本、安装方式、复现步骤和脱敏截图。请不要上传登录 token、API Key 或个人会话内容。