DSH 快速上手:从安装到装上第一个验证过的插件
十分钟走完 DSH 的安装、插件市场选型和第一条插件安装命令——并用 dsh.so 的 L1-L5 验证徽章避坑。
DSH(DeepSeek Harness)是 DeepSeek AI 开源的智能体框架,架构上「一切皆插件」,由 Cordis 驱动。这篇教程带你十分钟走完:装 CLI → 挑插件 → 装上第一个验证过的插件。
第一步:安装 DSH CLI
DSH CLI 发布在 npm 上,全局安装:
npm install -g @deepseek-ai/dsh装完在终端里确认 dsh 命令可用(版本要求与安装选项以官方仓库 README为准)。
第二步:在插件市场挑一个插件
别急着盲目装。每个插件的能力、安全状态、验证等级都不同,推荐直接在 dsh.so 插件市场里按使用场景筛选——GitHub 集成、网页搜索、终端、视觉 OCR、数据库、通知等,每件收录都经过 GitHub API 验证与自动化安全扫描。
挑选时重点看两个徽章:
| 徽章 | 含义 |
|---|---|
| 安全 | 自动化扫描给出的风险等级(Risk),只展示、不代替你判断 |
| 验证等级 | L1 已找到 → L5 运行已测,数字越高我们实测得越深 |
第三步:安装插件
每件插件的详情页都给出可直接复制的安装命令,基本形态是:
dsh plugin add <插件名>如果你的插件要跑在 dsh web UI 里,用 web profile 安装:
dsh plugin --profile web add <插件名>验证等级怎么看?
dsh.so 对每件插件跑五级阶梯(细节见验证标准):
- L1 已找到——仓库真实存在、非空、有 README;
- L2 结构化 / L3 安装规范——元数据完整、能推导出可靠的安装方式;
- L4 安装已测——在隔离沙盒里真实安装成功;
- L5 运行已测——沙盒里连同 dsh web 一起真实启动,加载插件并跑通冒烟检查。
L4/L5 只统计当前 dsh 版本的真测结果,版本升级后旧结果自动过期重测——所以看到「安装已测」徽章,意味着在当下这个版本它真的能装上。
下一步
- 想自己写插件?看插件开发指南,按官方 Cordis 教程逐章走;
- 想把你的插件收录进来?走提交页面,收录后自动进入安全扫描与安装验证流水线;
- 需要给插件配模型 API Key?先看AI Token 免费资源汇总,从免费额度起步。
有装不上的插件,在详情页看它的验证记录定位问题;确实是注册表数据错了,欢迎反馈。