awesome-deepseek-harness

简体中文 · English · 日本語

DeepSeek Harness 终极指南：资料、教程、插件与工具

本项目秉持少而精的原则，精选并收录 DeepSeek Harness 相关优质资源，与更多 AI 从业者共同构建更繁荣的 Agent 生态。

如果这个项目对你有帮助，欢迎点一个 ⭐；也欢迎关注 𝕏 @李不凯正在研究，获取更多 Agent 实践内容。

目录

• 目录
• 快速开始
  • 启动 Web UI
  • 从源码运行
  • 使用 Python SDK
  • 安装插件
• 官方资源
  • 安装集成
  • 源码仓库
  • 官方文档
  • 讨论社区
• 社区资源
  • 分析教程
  • 社区讨论
• 第三方客户端
  • 桌面与发行版
  • 终端、移动与 Web 体验
• 精选插件
  • 工作流与 Agent
  • 上下文、会话与输入
  • 浏览器、视觉与界面
  • 沙箱与执行
  • 主题与皮肤
• 外部集成
• 开发工具
• 致谢

快速开始

DeepSeek Harness（简称 DSH 或 dsh）是 DeepSeek AI 开源的 Agent Harness 项目。它基于 Cordis，采用 Everything is a Plugin（一切皆插件） 的架构：模型适配器、工具、会话日志、界面和 Agent Loop 都可以通过插件树组合与替换。

启动 Web UI

安装 Node.js 22.19.x 或 24+（推荐 24+）后执行：

npx @deepseek-ai/dsh web

默认访问 http://127.0.0.1:3080。进入 Settings → Models 配置模型服务后即可创建会话。详细步骤见官方快速开始和模型服务配置。

从源码运行

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

使用 Python SDK

官方 Python SDK 支持通过内置运行时以编程方式调用 Harness，无需在系统中安装 Node.js。当前要求 Python 3.10+，支持情况和平台限制以官方 Python SDK 指南为准。

python -m venv .venv
. .venv/bin/activate
python -m pip install deepseek-harness-sdk

安装插件

web 和 headless 是发行版内置的 Profile。外部插件以声明 dsh.bundle 的 Bundle 加入指定 Profile：

dsh plugin --profile web add <package-or-git-spec>
dsh --profile web --dump-config

从 Git 仓库安装时，建议固定 commit，并先检查安装脚本。pnpm 可能要求显式授权依赖的构建脚本；这些构建脚本会在 Agent 沙箱之外执行。完整机制见官方插件打包与安装教程。

官方资源

官方提供开源仓库、配套论文和较完整的参考文档，并持续运营开发者社区。

安装集成

• @deepseek-ai/dsh：官方 CLI 与 Web UI 的 npm 启动包
• deepseek-harness-sdk：用于程序化集成 DSH 的官方 Python SDK

源码仓库

• GitHub：查看源码、Issue、版本与贡献者
• Paper：基于 Cordis 的产品架构详解论文

官方文档

• 中文官网：了解产品定位和核心理念
• 帮助文档：使用、插件开发与架构参考入口

讨论社区

• GitHub Discussions：问题反馈、使用交流和提案讨论
• Discord DeepSeek：官方 Discord 社区，以中文讨论为主
• "DeepSeek Harness"：X 上有关 DSH 的实时搜索结果
• # dsh-plugin：GitHub 上的 DSH 插件项目集合

社区资源

分析教程

社区讨论

收录包含完整论述、实践细节或一手背景的公开社交媒体长帖，补充官方资料未覆盖的背景与实践细节。

第三方客户端

以下项目提供了独立的用户界面、发行形态或产品化组装，而不只是单个工具能力。

分类说明： 发行版或 Fork 会直接复用、修改或重新打包完整的 DSH Runtime，不能通过 dsh plugin 安装，因此不属于插件；独立客户端则通过 Web、RPC、ACP 或配套桥接插件连接 DSH。它们仍然是 Harness 生态的重要组成部分。

桌面与发行版

终端、移动与 Web 体验

项目被收录不代表已经签名、公证、自包含或适合生产环境；请查看各项目 README 和 Releases 中的当前说明。

精选插件

工作流与 Agent

• dsh-toolkit：时间、编码、JSON、计算器、CSV、正则、Markdown、Diff 等确定性工具合集。
• dsh-deep-research：面向 DSH 的自适应深度研究编排器。
• dsh-101：在 DSH 中阅读和理解官方文档的学习模式。
• dsh-auto-approval：使用规则和模型分类工具调用，输出 allow / deny 自动审批决策。
• mstar-harness：以 Skill 驱动的 Harness / Loop Engineering 工作流插件。
• dsh-agent-teams：为 DSH 提供 Agent Teams 能力。
• dsh-automation：按计划在全新根 Agent 和 Session 中执行独立任务，保留定义修订、运行历史和明确的工作区与权限边界。
• dsh-plannotator：对 Agent 计划逐段批注并提交结构化反馈，提供草稿隔离、版本绑定和过期计划拒绝。
• dsh-record-replay：录制 macOS 桌面工作流并生成 Skill；当前依赖 Xcode Command Line Tools 和独立的 open-record-replay 本地源码副本。
• dsh-science-workbench：面向可复现实验的工作台，把 Cell、图表、反馈与重跑链路记录到 Manifest，并保存环境快照和输入输出哈希；MIT、v0.1.1，功能仍处早期。

上下文、会话与输入

• dsh-context-doctor：审计 AGENTS.md、Skill 目录和工具 Schema 的上下文 Token 成本与冲突。
• dsh-memory-evolve：跨会话记忆、后台演进和分支感知能力。
• dsh-noema：为 DSH 接入本地优先的 Noema 长期记忆，支持工作前召回、设置页管理和从 Codex、Claude Code、Cursor 等导入已有记忆；MIT、0.1.0-rc.1，已在 DSH 0.1.0-rc.6 验证，项目仍新，标注为早期。
• dsh-at-file：在输入框中通过 @file 搜索工作区文件并附加内容。
• dsh-message-edit：分支式消息编辑、重试、重新生成和版本时间线。
• dsh-prompt-studio：编辑系统提示词片段并提供实时预览。
• dsh-turn-rewind：基于持久 Change Ledger 回退对话和工作区状态。
• dsh-compaction-instant：以确定性编译替代 LLM 摘要，并通过 recall / search 恢复被压缩内容；替换内置压缩器时需要使用 npm alias，属于较深的运行时改造。
• dsh-whale-report：从会话事件日志只读生成日报、周报、月报、年报和自定义区间报告，不改写会话历史；MIT、v0.2.0，仍属早期。

浏览器、视觉与界面

• dsh-browser：Chrome 侧边栏扩展，让 DSH 直接操作当前浏览器页面。
• dsh-vision-toolkit：图片问答、长截图 OCR、UI 还原、Grounding 和像素对比。
• dsh-computer-use：原生 macOS Computer Use Bundle，优先使用 Accessibility，拒绝过期观察并按应用、Session 和操作范围管理权限；当前为早期 0.1.0，需从源码检出目录安装。
• modlens：通过粘贴图片和模型路由让纯文本模型获得视觉能力，是以独立视觉工具处理工作区图片之外的另一种方案。
• ModSearch：为 DSH 补充 Web 搜索、X 搜索和网页正文读取，返回结构化证据；MIT，已发布 v5.4.2，不同搜索通道可能依赖外部 CLI、登录、API Key、额度与各自服务条款。
• dsh-better-browser：通过外部 Kimi WebBridge 操作保留登录态的真实浏览器，按任务维护标签页会话；需另行安装并运行 WebBridge。
• dsh-web-review：在 DSH 内预览网页、点选元素并提交选择器、可访问名称和修改意图，附真实前端修改评测套件；当前仓库尚未声明许可证。
• dsh-mcp-apps：让 DSH Web 成为 MCP Apps Host，在带 CSP 和 Permission Policy 的沙箱 iframe 中渲染交互应用；MIT、v0.1.1，但项目仍新，标注为早期。
• dsh-genui：在回复中渲染图表、表单、Mermaid、3D 场景等交互组件，并将操作事件送回模型；MIT、尚无正式 Release，当前主要通过 Git 安装，标注为早期。
• DSH-better-sidebar：集成文件、终端、Git、子 Agent 和第三方 Tab 的侧边栏工作台。
• dsh-openpencil：在 DSH 中预览和编辑 OpenPencil 设计。
• dsh-visualize：在对话流中生成沙箱化的可交互 HTML 卡片。
• dsh-notification：按任务结果和关键词配置桌面通知。
• dsh-share：一键生成并分享 DSH 对话内容。

沙箱与执行

• sandbox-micro：提供 fail-closed 的 microsandbox microVM 能力；安装后 Provider 与模型工具均默认关闭，必须分别显式启用，平台检查失败时不会降级为无约束宿主执行。含测试目录但尚无正式 Release；package.json 声明 BSD-3-Clause，但仓库根目录没有 LICENSE 文件，标注为早期。
• dsh-win32：为 Windows 提供沙箱内可运行的持久 Shell、极简模式和 doctor 体检；MIT、v0.9.3，基于 DSH 0.1.0-rc.6。可选的沙箱模式会下载 GPLv2 BusyBox，缺少 pnpm 时 setup 会通过 Corepack 启用，需明确知情后执行。

主题与皮肤

• dsh-deep-whale：DSH Web GUI 的鲸鱼娘主题皮肤集合；当前包含可热插拔的 maid-atelier Web Client Bundle，可通过 dsh plugin --profile web add ... 安装和卸载。项目采用 CC BY-NC-SA 4.0，禁止商业性使用。

外部集成

• Ollama：Ollama 官方提供的启动方式，不是 DeepSeek 官方发行包。通过 ollama launch dsh 安装并启动 DSH、选择 Ollama 模型和配置 Web 搜索；独立设置写入 ~/.ollama/launch/dsh/settings.yaml，不会改动 ~/.dsh/settings.yaml。当前标注为开发者预览。
• Sealos Skills：由 Sealos 团队维护的 DSH Profile Bundle，提供应用部署、数据库、对象存储等八个云原生 Skills；实际使用会操作外部 Sealos Cloud 资源，需要账号与相关凭据，登录会写入 ~/.sealos/kubeconfig，部分流程需放宽沙箱权限。package.json 声明 MIT，但仓库根目录当前缺少 LICENSE 文件。
• Nowledge Mem：为 DSH 提供 Working Memory、提示时检索、MCP 工具和会话捕获；依赖外部 Nowledge Mem 产品与 nmem CLI，适合与开源插件分开评估。
• Open Design：本地优先的开源设计应用，通过原生 DSH Runtime 适配提供结构化流式输出、模型发现、取消和会话恢复；Apache-2.0，属于大型独立产品而非普通插件。
• dsh-multica-runtime：连接 Multica 与 DSH 的早期运行时桥接；当前包标记为 private、UNLICENSED，安装与分发边界仍不完整。
• dsh-lark-bot：把本地 DSH 接入飞书 / Lark，提供流式卡片、工作区、会话恢复与审批；采用 AGPL-3.0，应用凭据以权限 600 的明文配置保存在本机。
• dsh-qqbot：腾讯团队维护的 QQ Bot 插件，支持扫码绑定、私聊与群聊会话隔离及重启恢复；MIT、0.1.0，绑定过程会把凭据保存到本地 Profile。
• LoongSuite DSH Plugin：把 Agent Turn、模型调用、工具执行和 Token 使用转成 OpenTelemetry GenAI Trace，可发送到 Jaeger、Tempo、SigNoz、Langfuse 等 OTLP 后端；Apache-2.0、Beta，已在 DSH 0.1.0-rc.6 的 Headless 与 Web Profile 验证。内容采集默认关闭，启用后可能外发源码、凭据和个人数据。

开发工具

• dsh-plugin-check：检查 Manifest、Patch、构建陷阱和目录收录状态。
• dsh-fail-logger：脱敏、去重并分类记录工具失败，将机器维护的实录沉淀进 Skill；只记录问题，不自动修改行为。
• deepseek-harness-action：在 GitHub Actions 中使用 DSH 做 PR Review、CI 诊断、自动修复和 Issue → PR；写权限默认关闭，并将验证放在无凭据容器中运行。
• Awesome DSH Plugins Radar：自动扫描并分别展示发现、静态、编译和运行级信号的兼容性雷达；MIT、数据高速变化且尚无 Release，“运行可用”不等于安全审计或内容质量，标注为早期。
• dsh-market：DSH 内置插件市场，可浏览、搜索、安装、更新和卸载登记在 awesome-dsh-plugin 的项目；MIT、v1.9.0。构建脚本默认阻止，安装端点仅接受同源 POST，但目录收录不代表安全背书。
• dsh-suite：中英双语 DSH 生态索引，提供插件搜索、create-dsh-plugin 脚手架和基础兼容性元数据；目录每小时刷新，并每天把收录包安装到临时 Profile 做兼容性检查。安装成功不等于安全审计或质量保证。
• deepseek-harness-plugin-mcp：让其他 Agent 通过 MCP 发现、检查、安装和调用 DSH 插件；安装与运行默认关闭，只有显式启用 --allow-install / --allow-runtime 才会产生对应副作用。
• dsh-payload-capture：捕获并落盘上行模型 API Payload，便于调试请求组装。
• dsh-custom-tool：通过 Monaco 编辑器创建和管理沙箱化 JavaScript 工具。
• dsh-open-in-vscode：从 Web UI 直接在 VS Code 中打开当前工作区。
• dsh-movein：一条命令把 Claude Code 的 Skills、MCP、hooks 和全局指令迁入 DSH；默认预演，CLAUDE.md 由 DSH 原生读取，会话历史不在范围内。MIT，已在 DSH 0.1.0-rc.6 验证，项目仍新，标注为早期。

致谢

感谢 DeepSeek Harness 团队、Cordis 社区、首批内测开发者，以及所有公开文档、插件、客户端、实践和生态索引的贡献者。