前言¶
DeepSeek Harness (DSH) 的设计理念之一是插件化。团队 Skill Base 是集中存放和管理 Skills 的中心，但在实际开发中，从 Skill Base 获取并安装 Skills 往往需要手动操作或借助外部工具。internal-skill-workshop 是一个 DSH Web 插件，它通过提供可视化的目录界面，解决了在 DSH 环境中直接浏览、登录和安装团队 Skills 的需求。
是什么¶
这是一个团队目录客户端插件。它通过 DSH 的 Settings 界面连接到配置的 Skill Base 服务器，提供以下能力：
* 配置管理：提供 DSH 设置入口，用于管理团队 Skill Base 的地址。
* 默认地址：管理员可在配置文件中预设共享的服务器地址，团队成员无需每次手动输入。
* 公共浏览：无需账号即可浏览公开目录中的 Skills。
* 私有访问：通过验证码机制登录，访问私有 Skills。
* 一键安装：将 Skills 下载并安装到 DSH 的用户 Skill 目录。
* 元数据展示：显示作者、版本、可见性、类型、兼容工具及标签等信息。
安装与启用¶
使用官方安装命令将插件添加到 DSH Web。
dsh plugin --profile web add internal-skill-workshop
安装完成后，需要重启 DSH Web，然后在界面中打开 Settings -> Internal Skill Workshop。
配置与使用¶
基础配置¶
管理员可以在 DSH 的 cordis.patch.yml 配置文件中为该插件预设默认的 Skill Base 地址。
- id: internal-skill-workshop
config:
baseUrl: https://skills.company.example
成员也可以在插件界面中保存个人的地址，个人配置会覆盖默认配置。
使用流程¶
- 打开 Settings -> Internal Skill Workshop。
- 确认或输入 Skill Base 的根地址（注意不要包含
/api后缀）。 - 此时可以立即搜索并浏览公开的 Skills。
- 若要查看私有 Skills，选择 Get code。系统会跳转至 Skill Base 页面，登录后复制生成的验证码，再粘贴回插件中。
- 选择目标 Skill，点击 Install 即可完成安装。
安全与凭证¶
该插件从不要求输入 Skill Base 密码。它通过一个安全流程来获取访问令牌：
- 验证码机制：插件生成一个 5 分钟内有效的一次性验证码，用户在 Skill Base 页面登录并使用该代码换取 Skill Base 的个人访问令牌（PAT）。
- 存储位置：DSH 主机将 PAT 存储在
$DSH_HOME/internal-skill-workshop/credentials中。 - 权限控制：存储文件仅在平台支持的地方设置为仅所有者可读。
- 安全边界：浏览器仅通过 Loopback DSH RPC 与主机通信。主机验证 Skill Base URL，拒绝远程 HTTP、凭证、查询字符串、片段和重定向。安装过程为暂存后原子性重命名。
限制与注意事项¶
该插件对资源和请求有限制，具体如下：
- 文件大小：下载的压缩包限制为 50 MB，解压后限制为 100 MB，文件条目限制为 2,000 个。
- 响应限制：Skill Base 的 JSON 响应限制为 5 MB。
- 兼容性：需要 Node.js 版本 >= 18。
- 更新机制：当前版本不支持更新或替换已存在且包含本地修改的 Skills。安装前会检查目标目录是否存在，若存在则拒绝覆盖。
- 协议要求：连接远程服务器必须使用 HTTPS，本地开发环境除外。
该插件专注于客户端目录浏览与安装，不包含或部署 Skill Base 服务器本身。
