什么是 dsh 插件？一文看懂 DeepSeek Harness 插件

一句话答案

dsh 插件就是一个 Cordis 插件，用来扩展——或者干脆替换——DeepSeek Harness（DeepSeek 开源的智能体运行时）的某个部分。Cordis 是 dsh 底层的元框架：只负责加载、卸载和依赖解析，插件之间通过服务与事件协作。

和浏览器扩展、VS Code 插件的关键区别在于：dsh 插件不是挂在产品边缘的附加件。dsh 里一切皆插件——模型接入、工具注册表、审批策略、会话日志、沙箱、Web UI，甚至主循环本身。社区插件和内置插件平起平坐，这就是它能改变这么多东西的原因。

dsh 插件能做什么

因为插件能插进运行时的每条接缝，覆盖面非常宽：

• 给模型加工具 —— 搜索供应商、数据库连接器、标题生成器；
• 换掉 UI —— 皮肤、侧边栏、状态栏、整个面板（Web UI 是第二棵插件树，有声明好的挂载点）；
• 改变智能体行为 —— 在工具执行前后插入审批、记录或改写逻辑；加防循环、防超时的守卫；
• 提供基础设施 —— 沙箱后端、模型供应商（任何 OpenAI 兼容端点）、会话存储；
• 替换主循环 —— 另类的智能体循环、编排器与多智能体方案；
• 挂载其他 Agent —— 把本机的 Codex、Claude Code 注册成子 Agent，让 Harness 调度。

本目录把这一切分进 22 个分类——从 MCP 服务、Agent 工作流到主题皮肤和桌面宠物。

一个插件的内部构造

从概念上讲，每个 dsh 插件就是一个函数（或带生命周期钩子的对象），接收 Cordis 的上下文（context），用它声明两件事：自己提供什么（服务、工具、UI 组件），消费什么（别的插件的服务、事件）。每种能力都拆成服务 / 供应商 / 消费者三个角色，所以无论背后坐的是哪个供应商，模型看到的都是稳定接口。

生态里有一条铁律：注册必须可逆。插件被移除时，它注册过的一切随之撤销——不会渗漏进后续会话。正是这条保证，让"随手试一个网上的插件"这件事变得可以承受。

插件住在哪里：Bundle、Profile、Patch

运行中的 dsh 是一棵插件树，由配置层按固定顺序叠加组装：

1. Bundle（组合包） —— 官方成套发布的插件（默认体验）；
2. Profile —— 你在 Bundle 之上的具名组装；
3. Patch（覆盖层） —— 你的修改层，可以精确到任意一个插件条目。

上层覆盖下层。所以"你的 dsh"字面上就是一摞配置文件——这也意味着分享配置就是分享这几个文件。完整机制见配置指南。

安装到底是怎么发生的

没有 dsh install <插件> 这样的命令。安装一个插件，就是往你的 Profile / Patch 配置里加一条记录——确切的那一行写在每个插件的 README 里——然后重启，让插件树重新组装。删掉这条记录就是卸载，干净彻底。

加那一行之前，先做五分钟检查：读 README、看许可证、扫入口代码、看活跃度、优先选精选条目。插件是以智能体权限运行的代码，Harness 用沙箱档位和审批把它们围起来——但审查这关还是得自己过。完整流程：安全地安装 dsh 插件。

去哪里找插件

• 本站目录 —— 按分类、星标或更新时间浏览；详情页展示许可证、语言、活跃度与来源列表；
• dsh-plugin GitHub topic —— 社区插件的官方标记，也是外部生态发现插件的方式；
• 社区 awesome 列表 —— 生态指南里有完整地图。

常见问题

dsh 插件安全吗？ 它们是以智能体权限运行的代码，所以当成任何第三方依赖对待：读源码、查许可证、先在一次性工作区里用 read-only 试。Harness 的沙箱、审批与守卫能遏制出格行为——但不能替代你的判断。

装完插件需要重启 dsh 吗？ 需要——插件树在启动时组装，配置改动下次启动才生效。

我能自己写 dsh 插件吗？ 能——就是一个普通的 TypeScript Cordis 插件。从插件模板起步，遵守可逆注册与配置约定，给仓库加上 dsh-plugin topic，再向 awesome 列表提 PR 就能被收录。插件开发入门有完整流程。

现在有多少个 dsh 插件？ 数千个，还在增长——本目录每天同步生态，按星标、fork、更新时间与热度排名。

继续探索

• 如何安装 DeepSeek Harness 插件
• 什么是 DeepSeek Harness？ —— 这些插件插进去的运行时
• 插件开发入门 —— 自己动手写一个
• 浏览插件目录