0xsline/awesome-deepseek-harness · 上手攻略
- 仓库：0xsline/awesome-deepseek-harness
- 链接：https://github.com/0xsline/awesome-deepseek-harness
- 分类：AI Agent 生态 · DeepSeek Harness 插件合集
- 作者：Jay
- 更新：2026-08-20
这是什么
DeepSeek Harness（DSH）是 DeepSeek 官方推出的 AI Agent 运行时，而 0xsline/awesome-deepseek-harness 是一个精选生态导航库——它汇总了来自官方 dsh-external/hub 目录和 GitHub dsh-plugin 公开话题的所有插件、工具与基础设施，按功能分成 20 个分类，方便使用者快速找到适合自己场景的扩展包，而非在 GitHub 浩如烟海的库里盲目搜索。
本质上，这是一个人工审核过的 DSH 生态地图，覆盖范围从核心 Agent 编排到浏览器远程操控，从内存/知识库管理到安全治理、Office 文档、通知通道等。
解决什么问题
DeepSeek Harness 本身只提供基础运行时和少量内置能力。用户若想扩展功能（如深度研究、记忆持久化、代码沙箱、视觉检查、多 Agent 协作），需要从 GitHub 找到合适的插件再手动安装。这个过程有几个痛点：
- 发现成本高：DSH 插件散落在 thousands of 个人仓库里，没有统一目录。
- 质量参差不齐：并非所有带
dsh-plugin话题的仓库都真正可用，版本维护状况差异极大。 - 安装方式不统一：官方 CLI 安装流程与社区自发格式混用，新手容易踩坑。
本仓库用分类目录 + 安装命令示例一次性解决这三个问题。
快速安装
第一步：安装 DeepSeek Harness 运行时
npx @deepseek-ai/dsh web
要求本地有 Node.js（建议 v18+）。安装完成后运行 dsh --version 确认版本。
⚠️ 注意：
npx方式安装的是 latest 版本。若需要特定版本或离线环境，官方也提供npm install -g @deepseek-ai/dsh，但具体版本号请以 GitHub Releases 页面为准。
第二步：安装插件包
DSH 通过 pnpm 管理插件包，支持多种来源格式：
# 从 GitHub 安装（推荐）
dsh plugin --profile web add "github:owner/repo#ref"
# 从 npm 安装
dsh plugin --profile web add "npm:package-name"
# 从本地路径安装
dsh plugin --profile web add "file:/absolute/path/to/package"
⚠️ 只有在
package.json中声明了dsh.bundle.patch字段的包才会激活为 profile 层；普通依赖会被安装但保持静默不激活。
安装完成后，重启 DSH 进程使插件生效：
# 在 DSH Web UI 中：Settings → Plugins 查看已装插件
# 或通过命令行重启
dsh --profile web restart
核心用法
DSH 插件生态极其庞大，按使用频率和影响力整理如下重点类别：
🔍 深度研究类
| 插件 | 功能 | 安装命令（参考） |
|---|---|---|
dsh-deepresearch |
DeepResearch 官方插件（cordis 版） | dsh plugin --profile web add "github:dsh-external/dsh-deepresearch" |
dsh-deep-research |
自适应深度研究编排器（workflow engine） | dsh plugin --profile web add "github:dsh-external/dsh-deep-research" |
dsh-deepread |
五种阅读模式（quick/deep/知识图谱/费曼/书籍） | dsh plugin --profile web add "github:xiehuan123/dsh-deepread" |
⚠️ 具体安装命令中的
#ref（分支/标签）未在目录中列出，实际安装时请替换为main或对应 release tag。
🧠 记忆与上下文管理
| 插件 | 功能 |
|---|---|
dsh-context |
上下文组成透视面板：每个请求的 token 花费、压缩/注入事件 |
dsh-scope |
每日 token 用量热力图 + KV 缓存命中率 |
dsh-simple-memory |
每会话 Markdown 记忆侧车，支持交叉项目搜索 |
dsh-hme |
跨会话长期记忆（Φ 斐波那契上限 + 标签索引归档） |
billion-context-dsh |
模型驱动上下文压缩（ACP），模型自行决定何时压缩 |
dsh-compressor（Headroom 移植） |
压缩工具输出，节省 up to 20% context |
🤖 多 Agent 与编排
| 插件 | 功能 |
|---|---|
dsh-plan-execute |
双模型计划/执行路由：规划模型思考，执行模型行动 |
dsh-collaboration |
多 Agent 协作套件：team_call / team_message / team_status |
dsh-agent-team-gui |
Composer 中的持久多模型 Squad 管理 |
dsh-background-agents |
持久后台子 Agent，支持随时消息/中断、per-child 工具范围限制 |
dsh-self-evolving |
证据驱动的自演化引擎（生成候选 → Loader 准入 → Harbor 评估） |
🔧 工程与 Git
| 插件 | 功能 |
|---|---|
dsh-dual-model-eval |
跨多个模型并行运行编码评测，隔离 Git worktree |
dsh-agent-arena |
隔离 worktree 中评测编码 Agent，支持确定性验证 |
zoahdev/dsh-github-intelligence |
16 个生态系统的只读开发者情报（GitHub/GitLab/npm/PyPI 等） |
🌐 搜索与网络
| 插件 | 功能 |
|---|---|
dsh-web-search-pro |
多引擎路由搜索（DeepSeek/Exa/DDG/Bing/Jina + GitHub/Bilibili/YouTube 等） |
dsh-tavily |
Tavily 搜索，支持多 API key 轮换与故障转移 |
dsh-hacker-news |
实时 HN 内容、Algolia 搜索、用户画像 |
💬 工具调用（Tool Use）
DSH 本身最重要的能力是将模型的原生工具调用语法翻译为 OpenAI 兼容的 tool_calls 结构化输出，支持 streaming 和多轮工具结果回传。当前支持模板家族包括 DeepSeek-V4 DSML、Qwen JSON / function XML、GLM XML、DeepSeek-V2/V2-Lite/VL2 等。但需注意：
⚠️ DeepSeek-V2/V2-Lite/VL2 当前官方模板未包含工具语法，因此不支持工具调用；Nemotron-3-Super 在 INT4/HQQ4 运行时模式下工具调用可靠性有限（autoregressive 退化明显）。具体支持情况请参阅 ADVANCED.md 工具支持表。
典型适用场景
- 在 DSH 上搭建深度研究 Agent：组合
dsh-deepresearch+dsh-tavily+dsh-context，让 Agent 具备多跳 web 搜索与上下文预算感知能力。 - 构建多 Agent 协作系统：用
dsh-collaboration定义专家 Agent 角色池，通过team_call按需调度，典型场景是多角色代码审查（规划 Agent + 评审 Agent + 修复 Agent）。 - 本地记忆增强：在需要跨会话记忆的场景（如长期项目助手），用
dsh-simple-memory或dsh-hme替代纯上下文注入。 - 量化/消费者显卡用户：虽然本仓库本身不涉及运行模型，但 DSH 生态中的
billion-context-dsh和dsh-compressor对 VRAM 受限用户特别有用。
坑与注意
- 插件激活需要 bundle 声明：不是所有
npm install过的包都会出现在 DSH 中——只有package.json声明了dsh.bundle.patch的才会激活为 profile 层。如果某个插件安装后不生效，先检查包是否声明了该字段。 - 重启才能加载新插件：安装插件后必须重启 DSH 进程或
dsh --profile web restart，否则插件不会出现在 Settings → Plugins 中。 - 某些插件依赖 org 访问权限：README 明确注明，部分
dsh-external仓库链接可能仍需要组织权限，普通 GitHub 账号无法访问。 - 旧版安装方式已废弃：文档中明确指出
&path:子路径和旧版 Repository Plugin 安装方式已废弃，不要沿用过时博客/视频中的安装命令。 - 工具调用支持度因模型而异：同一 DSH 版本对不同模型家族的 tool-call 翻译能力差异显著，不要假设"DSH 支持 tool calling = 我的模型支持 tool calling"。
与同类对比
| 对比项 | 本仓库 | GitHub Topics (dsh-plugin) | DeepSeek 官方 Hub |
|---|---|---|---|
| 覆盖规模 | 精选子集（有目录结构） | 全部公开仓库（噪声多） | 官方认证（数量有限） |
| 分类体系 | 20 个细分类目 | 无结构（纯列表） | 按官方定义分类 |
| 安装命令示例 | ✅ 有（bundle 流程） | ❌ | ✅ |
| 维护更新 | 依赖社区投稿 | 自动聚合 | 官方维护，但速度慢 |
| 质量门槛 | 中等（0xsline 人工维护） | 低（无门槛） | 高（官方审核） |
一句话推荐结论
想在 DeepSeek Harness 上快速找到经过整理的可用插件？这个 awesome 列表是目前最完整的生态导航，尤其适合需要多 Agent 协作、上下文管理或深度研究能力的用户——但安装前务必核对对应仓库的 stars 最近更新时间，避免踩到已停止维护的插件坑。
来源：GitHub README（0xsline/awesome-deepseek-harness）+ CATALOG.md（通过 README 内链接）