DSH-Plugin 教程

DeepSeek Harness Plugin（DSH plugin）是什么、怎么下载安装、怎么配置使用——DSH-Plugin 教程从概念到上手，一篇篇讲清楚。

围绕 DeepSeek Harness Plugin（DSH plugin）生态，按「概念 → 安装 → 上手 → 进阶」排序，下设概念与架构、安装、配置、更新、卸载、故障排查、插件开发 7 个分类专栏，配套常见问题，DSH-Plugin 教程帮你从零跑通第一个 DSH plugin。

DSH-Plugin 教程列表

全部8概念与架构1安装与快速上手2配置与使用1更新与升级1卸载与清理1故障排查1插件开发1
配置与使用2026-08-19

DSH 怎么配置和使用？配置文件、模型密钥与 profile 详解

DSHDeepSeek Harness配置profilecordis.patch.ymlAPI Key

DSH 的配置都落在 $DSH_HOME（默认 ~/.dsh）下：profile 目录里是插件依赖和 cordis.patch.yml，模型密钥在 Web UI 设置里填。本文讲清配置存在哪、怎么查看（dsh --dump-config）、怎么改，以及端口、工作区等常用用法。

插件开发2026-08-19

DSH 插件怎么开发？从最小插件到打包安装

DSH pluginDeepSeek Harness插件开发Cordisbundle

DSH 插件是一个导出 apply 函数的 TypeScript 模块，基于 Cordis：通过 name 命名、inject 声明依赖、ctx 注册能力、Config schema 接受配置。本文从最小插件写起，讲清打包成 bundle、用 dsh plugin add 装进 profile 的完整流程。

安装与快速上手2026-08-19

DSH plugin 怎么安装？dsh plugin add 命令与 GitHub 仓库安装验证

DSH pluginDeepSeek Harness插件安装dsh plugin addpnpm

安装 DSH plugin 的核心命令是 dsh plugin --profile web add，后面跟插件包名或 GitHub 仓库地址，框架会把参数转发给 pnpm 完成安装。本文给出完整命令、真实插件示例、安装后的验证方法，以及首次安装 git 插件的注意事项。

故障排查2026-08-19

DSH 常见问题排查：端口 3080 占用、插件不加载、模型连不上、Web UI 空白怎么办

DSHDeepSeek HarnessDSH plugin常见问题排查

DSH 新手最容易遇到四类问题：端口 3080 被占用、插件装完不加载、模型连不上、Web UI 空白。本文给出每个问题的排查命令和解决步骤，附官方文档与配置排查工具，帮你快速跑通 DSH。

卸载与清理2026-08-19

DSH plugin 怎么卸载？dsh plugin remove 命令与 DSH 清理指南

DSH pluginDeepSeek Harness卸载dsh plugin remove清理

卸载 DSH plugin 用 dsh plugin --profile web remove <包名>，命令会转发给 pnpm 移除依赖。想彻底卸载 DSH 本体，npx 方式没有全局安装，删除 ~/.dsh 数据目录即可；源码构建的还要清理仓库和 pnpm 缓存。

更新与升级2026-08-19

DSH 怎么更新？npx 与 git pull 更新本体，插件用 dsh plugin update

DSHDeepSeek HarnessDSH plugin更新升级

DSH 处于开发者预览阶段，迭代很快。npx 方式每次运行都会拉取最新版，源码构建用 git pull 更新，DSH plugin 则通过 dsh plugin --profile web update 升级。本文覆盖 DSH 本体和插件的完整更新流程。

概念与架构2026-08-14

DeepSeek Harness（DSH）是什么？智能体框架的「一切皆插件」架构

DeepSeek HarnessDSH智能体框架Cordis插件

DeepSeek Harness（DSH）是 DeepSeek AI 开源的智能体框架，命令行工具 dsh，核心理念是「一切皆插件」——模型、工具、界面、技能都通过插件接入，由 Cordis 驱动。当前处于开发者预览阶段，官方做内核、社区做生态。

安装与快速上手2026-08-14

DeepSeek Harness 怎么安装？从 npx 一键运行到源码构建

DeepSeek HarnessDSH安装npx构建

DeepSeek Harness 的安装方式主要有两种：用 npx 一键运行 Web UI，或从源码克隆构建。本文给出两种方式的完整命令、前置要求（Node.js 18+）和启动后的访问地址。

按场景学习 DSH-Plugin：概念、安装、配置、更新、卸载、排查与插件开发

DeepSeek Harness 是什么？DSH-Plugin「一切皆插件」架构入门

1 篇文章

DeepSeek Harness 把模型适配、工具、会话、智能体循环全做成 DSH plugin，dsh 启动器只拉起 profile 再按需组合；搞懂「一切皆插件」，后面装插件、配模型、做开发就通了。

进入分类

DSH-Plugin 怎么安装？npx 一行命令到跑通第一个插件

2 篇文章

npx @deepseek-ai/dsh 一行拉起 DeepSeek Harness，再 dsh plugin --profile web add 装进第一个 DSH plugin，重启 dsh web 就能跑；源码构建适合要改代码的人。

进入分类

DSH-Plugin 怎么配置？profile、模型密钥与 Web UI 设置

1 篇文章

配置从 profile 起步，每个 profile 对应 ~/.dsh/profiles 下一个目录；在 Web UI 的 Settings → Models 填模型 API Key、选工作区，再用 dsh --dump-config 核对组合结果。

进入分类

DSH-Plugin 怎么更新？npx 自动更新与源码重新构建

1 篇文章

npx 装的 DeepSeek Harness 每次启动自动拉最新；源码构建走 git pull → pnpm install → pnpm run build，DSH plugin 用 dsh plugin update 单独升级，升级前先备份会话。

进入分类

DSH-Plugin 怎么卸载？删插件到彻底移除 DeepSeek Harness

1 篇文章

只删插件用 dsh plugin remove，不碰会话数据；彻底卸载 DeepSeek Harness 时，npx 装删 ~/.dsh，源码构建再清仓库与 pnpm 缓存，只影响你指定的 profile。

进入分类

DSH-Plugin 故障排查：端口占用、插件不加载、模型连不上

1 篇文章

3080 端口被占用换 --port，git 插件被 allowBuilds 拦截改 pnpm-workspace.yaml，模型连不上查 Settings → Models 的 API Key；先 dsh --dump-config 看配置，再对症修。

进入分类

DeepSeek Harness 插件开发：从零写一个 DSH-Plugin

1 篇文章

从克隆 deepseek-harness 仓库起步，理解 DSH-Plugin 装进 profile 后由 pnpm 管依赖、dsh plugin 转发命令；用独立 profile 隔离调试，再 dsh --dump-config 验证加载。

进入分类

DeepSeek Harness 常见问题：DSH-Plugin 怎么安装、配置、更新与排查

DSH-Plugin 教程适合什么人看？零基础新手能学会吗？

适合想快速上手 DeepSeek Harness Plugin（DSH plugin）的开发者，零基础也没关系：从安装 DeepSeek Harness 到装第一个 DSH plugin，再到理解「一切皆插件」架构，按顺序阅读即可。

DSH-Plugin 教程按什么顺序看效果最好？先看概念还是先安装？

建议按「概念 → 安装 → 上手 → 进阶」的顺序：先理解 DeepSeek Harness Plugin（DSH）与「一切皆插件」架构，再完成安装，接着跑通第一个 DSH plugin，最后再看进阶用法。列表中的文章已按此排序，顺着读即可。

DSH plugin 有哪些安装方式？npx 和源码构建怎么选？

常见三种：npx 临时拉取官方发布包（零配置，卸载即删 ~/.dsh）、克隆源码自行构建（适合调试与二次开发）、以及通过 dsh plugin add 把插件装进指定 profile。快速体验选 npx，长期使用或开发选源码构建，详细步骤见「安装」分类。

DeepSeek Harness 更新之后，DSH plugin 会不兼容吗？怎么避免？

有可能。DeepSeek Harness（DSH）处于开发者预览阶段，存在破坏性更新，升级前先确认每个 DSH plugin 的兼容版本、备份 ~/.dsh/sessions 会话数据，升级后跑一遍常用流程验证。具体操作见「更新升级」分类。

想开发自己的 DSH plugin，应该从哪开始？

先理解 DSH plugin 与 profile 的关系：插件装进 profile 后由 pnpm 管理依赖，dsh plugin 命令转发给 profile 目录里的 pnpm。建议克隆官方 deepseek-harness 仓库作参考，用一个独立 profile（如 --profile dev）隔离调试。入门路径见「插件开发」分类。

DeepSeek Harness 出问题了自己能怎么排查？有没有排查顺序？

可以，按三步走：先判断报错发生在启动期、插件期还是模型期；再用 dsh --dump-config 确认当前配置组合是否正确；最后针对具体现象处理——端口占用换 --port、插件不加载检查 allowBuilds、模型连不上核对 API Key。常用解法集中在「故障排查」分类。

DSH-Plugin 教程和插件中心有什么关系？能从教程里直接安装插件吗？

插件中心收录可安装的 DSH plugin，教程则讲解「怎么装、怎么用、怎么理解 DeepSeek Harness Plugin」。两者互链：教程指向插件中心，插件详情页也会给出对应教程。安装请以插件中心的收录信息为准。

为什么 DSH-Plugin 教程里的命令总在变？版本更新太快怎么办？

DeepSeek Harness Plugin（DSH）处于开发者预览阶段，接口与命令会有破坏性更新，教程里的命令也会跟着变。本站会随官方变更同步修订，并以「更新于」标注每篇的复核时间，建议优先参考更新日期较近的文章。

教程里的 DSH-Plugin 命令在 macOS、Windows、Linux 上都能用吗？

大部分命令跨平台通用，但涉及路径、包管理器或权限的部分可能因系统而异，教程会在差异处单独标注。遇到报错时，优先对照你所在平台的说明。

发现 DSH-Plugin 教程有错误或内容过时了，怎么反馈给网站？

DeepSeek Harness Plugin（DSH）处于快速迭代期，教程难免跟不上最新版本。发现错误或过时内容时，可以通过 GitHub Issues 反馈，我们核实后会及时修订，并更新文章的「更新于」日期。