awesome-deepseek-harness

这是什么？适合谁？

awesome-deepseek-harness 是对应 DeepSeek Harness（dsh）插件生态的精选列表（真实仓库为 awesome-dsh-plugin/awesome-dsh-plugin，约 11.2k Stars，CC0-1.0；网站 awesome-dsh-plugin.com）。它收录的都是可通过 dsh plugin add 一键安装的社区插件——每个插件声明了 dsh.bundle manifest，覆盖 UI 增强、用量计费、主题外观、模型与供应商、会话与消息、内存、工具能力、浏览器、视觉、语音、文档渲染、技能、自动化、Git 与代码审查、通知集成、安全权限、远程移动等 20+ 分类。

它本身是「目录/索引型」工具，核心价值在于一站式发现 DeepSeek Harness 的可扩展能力。而 DeepSeek Harness 是 DeepSeek 开源的 agent harness（deepseek-ai/deepseek-harness，约 181k Stars，MIT），主打「Everything is a Plugin」——模型、工具、沙箱、会话存储、UI、甚至 agent 循环本身都是插件。横向对比：与 Anthropic 官方的 claude-plugins-official（约 33.8k Stars，Claude 插件目录）相比，本列表聚焦 dsh 生态且插件数量更庞大、迭代更快；与 openai/codex-plugin-cc（让 Codex 在 Claude Code 里协作的官方插件）相比，本列表偏「社区精选集合」而非「单一功能插件」。

适合谁：① 已用上 DeepSeek Harness、想扩展 UI/工具/主题的开发者；② 想给 dsh 加模型供应商、内存、自动化流水线的进阶用户；③ 想研究「万物皆插件」架构、找插件范例的架构师。

使用前提：已安装 DeepSeek Harness（dsh）；有 DeepSeek API Key（BYOK，也可接其他供应商插件）。

准备工作

1. 安装 DeepSeek Harness（前置）：需 Node.js，然后：

   npx @deepseek-ai/dsh web
   

   默认启动 Web UI 于 http://127.0.0.1:3080。也可从源码跑（git clone 后 pnpm install && pnpm run build && pnpm dsh web）。
2. API Key 来源：dsh 本身免费（MIT），模型调用走你自己的 Key——DeepSeek 官方 Key 在 platform.deepseek.com 申请；也可通过「Models & Providers」类插件接入 OpenRouter、Anthropic、OpenAI 等。
3. 前置知识：会用终端执行 dsh plugin add；理解「插件会以你的权限运行第三方代码」的安全边界（见踩坑 1）。
4. 替代方案：想更省事可直接装 dsh-market 插件市场（本列表内所有插件都收录其中）；想用桌面客户端可看 dsh-desktop 或 deepseek-harness-desktop，二者已内置 dsh-market。
5. 注意：dsh 当前处于 developer preview，官方明确「THERE WILL BE COMPATIBILITY-BREAKING CHANGES」，插件与核心版本需匹配。

快速上手（4步）

第一步：安装并启动 dsh

npx @deepseek-ai/dsh web

预期结果：浏览器打开 http://127.0.0.1:3080 的 DeepSeek Harness Web UI。

第二步：安装插件市场（推荐）

dsh plugin --profile web add dshmarket

预期结果：Settings 里出现插件市场入口，可搜索、分类浏览、一键安装/升级插件。

第三步：浏览并安装一个插件

在插件市场里按分类筛选（如 UI Enhancements），点「Install」装一个 HUD 状态栏类插件，例如 a903067276-rgb/dsh-hud。预期结果：Web UI 出现 Git 状态、MCP 服务器、技能、模型与 token 用量浮窗。

第四步：用对话让 Agent 帮你找插件（可选）

dsh plugin --profile web add dsh-find-plugin

之后直接在对话里说「帮我找一个能定时发送消息的插件」。预期结果：Agent 搜索本列表并给出可安装的插件名与 dsh plugin add 命令。

常见踩坑（6条）

踩坑 1：误以为「被收录 = 经过安全审查」

• 现象：直接安装列表里的插件，导致其读取文件、使用凭证、访问网络。
• 原因：列表官方明确声明「Being on this list is not a security review」——插件会以你的权限运行第三方代码，工具审批并不沙箱化插件代码。
• 解决：安装前检查插件源码；不熟悉的插件先在不含密钥的环境试用。来源：列表安全声明。

踩坑 2：插件与 dsh 版本不兼容

• 现象：装完插件报错或功能异常。
• 原因：dsh 处于 developer preview，频繁发布兼容性破坏变更。
• 解决：保持 dsh 与插件同步更新；关注 deepseek-harness Discussions 与插件仓库的最新版。来源：dsh README。

踩坑 3：装到重复/低质量插件

• 现象：出现两个功能相同的插件（如两个 Catppuccin 主题），其中一个有明显质量缺陷。
• 原因：社区提交重复实现，审核时未去重。
• 解决：列表会清理重复/低质条目（实例：移除 NoNameLeGo/dsh-catppuccin，保留 zhijun-dai/Catppuccin-dsh-theme，见 #556），装之前看条目说明与最近更新时间。

踩坑 4：忘了先装 dsh 就想用插件

• 现象：直接执行 dsh plugin add 提示命令不存在。
• 原因：dsh 是前置依赖，列表里的插件都要装在 dsh 里。
• 解决：先 npx @deepseek-ai/dsh web（或源码安装）确认 dsh 命令可用，再装插件。

踩坑 5：用 --profile web 与默认 profile 混用

• 现象：装了插件但在 Web UI 看不到。
• 原因：dsh 支持多 profile，插件装进了错误的 profile（如默认终端 profile 而非 web profile）。
• 解决：安装时统一用 dsh plugin --profile web add <plugin>，确保与你在用的客户端 profile 一致。来源：列表 README 推荐命令。

踩坑 6：找不到「能帮我做 X」的插件

• 现象：在列表里翻半天找不到想要的能力。
• 原因：列表 20+ 分类、条目众多，人工翻找低效。
• 解决：装 dsh-find-plugin 让 Agent 按需求检索；或直接装 dsh-market 用分类过滤。

踩坑 7：在第三方桌面客户端里插件行为异常

• 现象：某插件在官方 Web UI 正常，在第三方桌面客户端里报错或失效。
• 原因：本列表「客户端无关」——只按官方协议收录，不保证适配每个第三方客户端。
• 解决：优先用官方 Web UI，或选已内置 dsh-market 的客户端（dsh-desktop / deepseek-harness-desktop）。来源：列表 README 客户端说明。

初级用法

1. 美化 Web UI：从 UI Enhancements 装一个主题或状态栏插件，立刻改变 dsh 界面观感。
2. 加一个模型供应商：从 Models & Providers 装供应商插件，把 Anthropic / OpenAI / OpenRouter 接进 dsh 使用。
3. 开启内存能力：从 Memory 分类装内存插件，让会话跨任务记住上下文。
4. 看用量与账单：从 Usage & Billing 分类装余额/用量插件，实时查看 DeepSeek token 消耗与成本。
5. 加代码审查：从 Git & Code Review 分类装插件，让 Agent 在 PR/commit 流程里自动审查代码。

高级玩法

1. 搭建个人插件栈：按「UI 增强 + 内存 + 工具能力 + 自动化」组合多个插件，把 dsh 改造成专属工作台。
2. 用 dsh-market 做统一管理：一次性接管本列表全部插件的安装、升级与主题切换，避免逐个手动 dsh plugin add。
3. 研究 dsh.bundle 规范自己写插件：列表是现成的范例库——读某个插件的 dsh.bundle manifest，照猫画虎发布自己的插件并打上 dsh-plugin topic 提高可发现性。
4. 桌面端 + 插件组合：在 dsh-desktop / deepseek-harness-desktop 里使用内置市场，把列表能力带进桌面应用。
5. 多 Agent 场景：结合 Tools & Capabilities 与 Workflow & Automation 插件，让 dsh 编排定时任务与多 Agent 协作流水线。
6. 跨生态迁移助手：从 Claude Code 迁移到 dsh 时，先在本列表按能力（HUD、内存、Git 审查、自动化）找 dsh 等价插件，降低切换成本。

小技巧

1. 优先装 dsh-market 或 dsh-find-plugin，把「翻列表」变成「搜索 + 一键装」。
2. 看插件条目时关注其最近 push 时间与 issue 活跃度，避免装到停更插件。
3. 所有插件都会运行第三方代码，把 API Key 放 dsh 凭证库、不要写在源码或浏览器存储里。
4. 给插件仓库打 dsh-plugin topic 可提升在生态内的可发现性。
5. 遇到兼容问题先升级 dsh 再升级插件，多数「插件坏了」实为版本错配。

常见问题 FAQ

Q1：这个列表/工具收费吗？模型要花钱吗？

A：列表（CC0-1.0）与 dsh（MIT）都免费开源。模型调用走你自己的 API Key，按用量计费：DeepSeek 官方 deepseek-v4-flash 输入约 $0.22/M token（闲时，cache miss）、输出 $0.66/M，闲时价为峰时一半。来源：DeepSeek 官方定价。

Q2：它和 claude-plugins-official 有什么区别？

A：两者都是「插件目录」，但生态不同：claude-plugins-official 是 Anthropic 官方维护的 Claude 插件目录（约 33.8k Stars），本列表是 dsh 生态的社区精选（约 11.2k Stars），分类更细、条目更多且明确「不评级、不做质量背书」。来源：claude-plugins-official 与 本列表。

Q3：装了列表里的插件就安全了吗？

A：不。官方明确说明「被收录 ≠ 安全审查」，插件会以你的权限运行第三方代码。务必先读源码、在不含密钥的环境试用。来源：列表安全声明。

Q4：如何安装插件？

A：在 dsh 里执行 dsh plugin --profile web add <plugin>；或先装 dsh-market（dsh plugin --profile web add dshmarket）用图形界面一键装。来源：列表 README。

Q5：dsh 稳定吗？能用于生产吗？

A：目前是 developer preview，官方明确警告会有兼容性破坏变更，建议先用于实验与个人工作流，生产需自行评估。来源：dsh README。

进阶学习建议

• 读通 Cordis 架构：dsh 的「万物皆插件」基于 Cordis 及其论文《A Programming Paradigm for Spatiotemporal Composability》——想真正掌握 dsh 的插件模型，这是必读的底层设计。
• 剖析 dsh-market 的实现：dsh-market（本列表的图形界面形态）演示了如何用一个插件去管理其他插件，是学习 dsh 插件元能力的优秀范例。
• 实战项目：给 dsh 写一个「微信桥接」插件：参考列表中已收录的 dsh-wechat-bridge（见 #2082）与 dsh-channels，仿照其 dsh.bundle manifest 发布自己的通道插件并提交本列表。
• 误区提示：不要以「列表收录」作为质量/安全背书——列表自己明确不评级、不判断质量，选型前务必独立核查源码与维护状态。

参考链接

• awesome-dsh-plugin 列表仓库
• DeepSeek Harness 官方仓库
• dsh-market 插件市场
• DeepSeek 官方定价
• DeepSeek Harness Discord 社区

本文基于官方文档和公开资料整理，AI辅助生成，MagicNetWorld 尚未完成独立实测。如有错误或过时信息，请通过 contact@magicnetworld.com 反馈。