最近把本地的 AI 工作流整体迁到了 DSH 上，也就是 DeepSeek Harness，才发现之前一直在裸奔。DSH 本身是个很克制的终端 Agent 工作台，但真正拉开使用体验差距的，是它的插件生态。装没装插件、装了哪些插件，用起来的体感完全是两个项目。这篇文章就把我筛选后觉得最值得装的 14 个 DSH 插件整理成清单，同时把安装、配置、排查的完整过程一起讲清楚。如果你是刚接触 DSH，或者已经装了一堆插件但总觉得差点意思，都可以照着这份清单从零搭一遍。
1. DSH 插件生态是怎么运转的
1.1 DSH 插件不是传统 IDE 插件
先说个容易混淆的点。很多人第一次看到“DSH 插件”会下意识想到 VSCode 插件、PyCharm 插件，其实不是一回事。DSH 插件是运行在 DeepSeek Harness 进程内部的模块化功能单元，负责给 Agent 增加记忆、文件读取、工具调用、外部服务对接等能力。简单理解，VSCode 插件是给编辑器增加按钮和面板，DSH 插件是给 AI Agent 增加“手”和“眼睛”。
DSH 插件通过统一的入口加载，由插件树（plugin tree）管理依赖关系。每次 DSH 启动时，会按照 profile 中配置的插件清单逐层加载，任意一个插件加载失败，都会影响整个启动流程。这也是为什么后面要专门讲 plugin tree failed to load 的排查。
1.2 Profile、插件市场与加载器
DSH 使用 Profile 来隔离不同场景的插件组合。比如我会单独建一个webProfile 给网页浏览场景用，再建一个codingProfile 给写代码场景用。插件市场则是集中获取插件的地方，社区默认市场叫 dshmarket，通过命令添加。
dsh plugin --profile web add dshmarket这条命令把 dshmarket 注册到当前用户下的 web profile。插件的安装路径、配置项、依赖关系都会记录在 profile 目录下。加载器（loader）负责解析插件的入口文件，如果入口文件中 import 了不存在的模块，就会报failed to apply loader entry include。
1.3 装插件之前先想清楚的事
插件不是越多越好。DSH 的插件越多，启动时做的依赖检查越复杂，上下文分发也越重。我的经验是每个 Profile 控制在 8 到 15 个插件之间，按“记忆、输入解析、代码工具、外部接口”四类来规划。下面这份清单就是我在这四个维度上反复筛选后留下的 14 个，基本覆盖了日常开发和自动化任务里会用到的绝大多数场景。
2. 必装插件清单：我筛选出的 14 个 DSH 插件
2.1 记忆与上下文增强四件套
dsh-memory：临时记忆插件。作用是在多轮对话之间保存关键信息，比如用户偏好、常用路径、当前任务的中间结果。没有它，DSH 每次对话都是失忆状态。安装命令是dsh plugin --profile base add dsh-memory。配置时我习惯把保存间隔调成 300 秒，避免频繁写盘。
dsh-context：上下文压缩插件。长对话中最容易爆掉的就是上下文窗口，这个插件会把历史消息按语义压缩，只保留重要结论和未完成事项。它和 dsh-memory 的区别是：dsh-context 管的是本轮对话的上下文，dsh-memory 管的是跨会话的持久信息。两者配合才能做到“既记得住，又记得全”。
dsh-session-resume：会话恢复插件。支持dsh resume --session <id>恢复任意历史会话，连当时的插件状态、工作目录、环境变量都会一起还原。我在本地开发时经常同时开三四个任务，这个插件让我不用每次手动重建环境。
dsh-tag-store：标签化存储插件。给重要信息打标签后存入本地存储，后续可以用自然语言检索。比如我给项目里的支付模块打过pay-2025标签，之后 DSH 能直接读取相关代码片段和设计文档，不需要我再指定路径。
2.2 输入解析与多模态处理三件套
dsh-doc-reader：文档解析插件。支持读取 PDF、Word、Markdown 等格式。安装后在 DSH 里直接输入文件路径，插件会自动抽取正文内容。注意 PDF 扫描件需要额外配置 OCR 引擎，否则只能拿到乱码。
dsh-image-input：图片输入插件。可以让 DSH 处理带图片的消息，比如截图、UI 设计稿、流程图。不过这里有个大坑，后面会专门说“模型不支持 newapi”的问题。底层如果接的是 newapi 兼容接口，有些模型并不支持图片输入，必须在模型配置里明确开启 vision 能力。
dsh-url-loader：链接抓取插件。输入 URL 后自动抓取网页正文，去掉导航和广告。适合让 DSH 快速阅读文档页面。爬取频率太高会触发对方网站反爬，建议在配置里加 3 秒的请求间隔。
2.3 代码工程与诊断四件套
dsh-code-diagnose：代码诊断插件。能在不打开编辑器的情况下对指定文件或目录跑静态检查、语法诊断，并给出修复建议。热词里经常出现“大国工匠插件”“代码诊断插件”，多数情况下指的就是这类能力。安装后建议把检查规则配置成和项目的 linter 一致，避免 DSH 和 CI 的检查结果互相矛盾。
dsh-repo-map：仓库地图插件。扫描整个 Git 仓库生成目录结构和模块关系图，DSH 拿到这个地图后能快速定位相关代码，不用全文件搜索。在处理大型 monorepo 时效果尤其明显。
dsh-git-helper：Git 操作插件。让 DSH 帮你执行 git status、diff、log 等命令，并能根据当前改动生成合理的 commit message。我会限制它只能读取 git 命令的输出，不能直接执行 force push 之类的危险操作，安全上更稳妥。
dsh-runner：命令运行插件。可以让 DSH 在隔离的 shell 环境里运行测试、构建脚本，并把输出流式反馈回来。我用它来自动跑pytest和npm run build，省掉来回切换终端的麻烦。
2.4 自动化与外部接口三件套
dsh-scheduler：定时任务插件。让 DSH 在指定时间点自动执行某个命令或工作流。我会用它每天早上九点拉取项目更新，然后自动生成摘要。
dsh-notify：通知推送插件。支持把 DSH 的处理结果推送到桌面通知、钉钉、企业微信等渠道。长任务跑完时，它会通知我，不用一直盯着终端。
dsh-http-client：HTTP 请求插件。允许 DSH 直接调用 API、解析响应，并基于响应结果做下一步决策。比如让 DSH 查询天气接口，再根据天气结果安排日程。这个插件扩展性非常强，但要注意不要把密钥写在明文配置文件里，建议用环境变量引用。
3. 安装与配置的完整实操
3.1 初始化 DSH 环境
在装插件之前，先确保 DSH 本体可用。社区版通过 pip 安装即可：
pip install deepseek-harness dsh --version初始化 profile：
dsh init --profile base初始化过程会在用户目录下生成 DSH 目录，里面包含profiles/base/config.toml和 plugins 目录。之后所有插件的安装都是以这个目录为基础。
3.2 添加插件市场并安装第一个插件
把 dshmarket 添加到当前 profile：
dsh plugin --profile base add dshmarket然后安装插件：
dsh plugin --profile base install dsh-memory安装完成后可以用：
dsh plugin --profile base list查看已安装列表。正常情况下，每个插件会显示版本号和状态。
3.3 配置文件里的关键参数
DSH 的插件配置写在 profile 的 config.toml 里，每个插件一个独立的[plugin.<name>]段落。以 dsh-doc-reader 为例：
[plugin.doc-reader] enabled = true ocr_timeout = 30 max_page = 20其中enabled控制是否加载，ocr_timeout控制 OCR 超时时间，max_page限制读取的最大页数。配置改完后需要重启 DSH 或运行dsh plugin reload --profile base让配置生效。
3.4 插件树的加载顺序
插件树加载顺序由依赖关系决定，但也可以手动调整加载优先级。在配置里用priority字段控制：
[plugin.memory] enabled = true priority = 10数值越大越早加载。我一般把记忆类插件和上下文类插件设为高优先级，这样后续插件启动时就能直接使用记忆能力。遇到依赖混乱时，优先检查是否有两个插件同时声明了同一个依赖包，这是最常见的冲突来源。
4. 我踩过的坑和排查方法
4.1 plugin tree failed to load 的成因与处理
启动 DSH 时，如果报错：
error: dsh: plugin tree failed to load: failed to apply loader entry include说明有插件的入口文件里引用了不存在的模块，或者路径写错。最常见的场景是插件升级后，旧配置里还残存了旧的入口路径。排查步骤：
- 用
dsh plugin tree --profile base查看具体是哪个插件加载失败。 - 检查对应插件的入口配置，看 include 路径是否存在。
- 如果插件是最近升级的，检查版本更新日志，确认入口文件是否改名。
- 临时禁用该插件，再重新加载。
dsh plugin --profile base disable <plugin-name> dsh plugin --profile base enable <plugin-name>我遇到过两次都是因为手动改动插件目录结构导致的问题，所以后来一律用官方命令安装和卸载，不再手动复制文件。
4.2 dsh web 认证失败怎么办
运行dsh web时，终端提示：
dsh web authentication required; reopen the url printed by dsh web.这是正常流程。dsh web会打印一个本地认证 URL，需要在默认浏览器中打开并完成登录。如果一直抽风，常见原因有：浏览器没有正确关联，或者本地端口被占用。
建议先加参数禁用自动打开浏览器：
dsh web --no-open然后手动复制终端输出的 URL 到浏览器访问。如果页面显示认证失败，检查本地端口是否被其他程序占用。另外，dsh web: opening the default browser; pass --no-open to disable这条只是提示信息，不是报错，不用紧张。
4.3 图片输入模型不支持 newapi 的解决思路
用 dsh-image-input 插件时，DSH 里发了一张图，结果返回：
图片输入显示模型不支持 newapi这是因为 DSH 底层接的模型服务使用 newapi 协议，但当前配置的模型没有声明 vision 能力。可以这样解决：
- 确认使用的模型名称，比如 gpt-4o、qwen-vl-max 这类支持视觉的模型。
- 在 DSH 的模型配置中，找到
capabilities或vision字段，改为true。 - 重启 DSH 使配置生效。
如果模型本身不支持图片输入，那只能换模型。这个问题的根源多半在模型服务端，而不是插件本身，排查时先绕开插件，直接用 API 工具发一张图片测试，能快速定位问题所在。
4.4 插件市场添加失败的几种可能
添加 dshmarket 时失败，通常有这几种原因。一是网络不通，这个只能检查网络连接。二是命令格式写错了，dsh plugin --profile <name> add <market-name>注意市场名是末尾参数。三是 profile 不存在，要先用dsh init --profile <name>创建。还有一个比较隐蔽的坑：有些版本的 DSH 市场协议不兼容，需要先升级 DSH。
dsh self-update升级后再重新添加市场。如果仍然失败，可以拉取官方日志：
dsh --log-level debug plugin --profile base add dshmarket日志里会打印请求细节，根据状态码判断是网络问题还是服务端问题。
5. 从用到造：自己写一个简单的 DSH 插件
5.1 最小插件骨架
当你对现成插件不满意时，可以自己写。DSH 插件本质上是一个带入口文件的目录，结构如下：
my-plugin/ ├── plugin.toml └── entry.pyplugin.toml声明插件元信息：
id = "my-plugin" name = "我的插件" version = "0.1.0" entry = "entry.py"entry.py定义核心逻辑：
from dsh.plugin import BasePlugin, register @register class MyPlugin(BasePlugin): def run(self, context): return "hello from my plugin"写完后放在 profile 的 plugins 目录下，或者在插件市场打包上传后通过dsh plugin install安装。
5.2 本地打包与安装
自己开发的插件先在本地验证。DSH 支持直接从目录加载：
dsh plugin --profile dev add ./my-plugin如果要把插件分享给别人，可以打包成 zip 或使用 dsh-package 工具生成标准插件包，再让使用者通过市场仓库地址安装。注意插件包内不要包含绝对路径和本机密钥，避免泄露。
5.3 把多个插件串成工作流
单插件能力有限，组合起来才强大。举个例子：我让 dsh-scheduler 每天早上十点触发一个任务，任务内部先调用 dsh-url-loader 抓取指定页面，再让 dsh-doc-reader 解析附件，最后通过 dsh-notify 把摘要推到手机。这个过程不需要写胶水代码，所有插件共享 DSH 的事件总线，数据通过 context 在插件间传递。
组合时的关键是明确每个插件输出数据的格式。DSH 插件之间没有强制 schema，所以我会给每个重要插件写一小段配置，声明它输出的字段名。这样后续加新插件时，可以直接引用已有字段，不用再追溯数据来源。
我自己用这套组合已经跑通了很多日常重复劳动，最明显的变化是每天花在信息收集和整理上的时间少了一半。如果你刚接触 DSH，建议先按这份清单安装基础的几类插件，跑通一条简单工作流，再慢慢加。插件体系最忌讳一上来就装一大堆，遇到问题不好排查，最后反而回到裸用 DSH 的状态。
