DSH HUB
HomePlugin StoreCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

libukai /

awesome-deepseek-harness

Topic repository only

DeepSeek Harness 终极指南:快速入门、资源推荐、精选插件与实用工具 |The Ultimate Guide to DeepSeek Harness: QuickStart, Resources, Plugins&Toolkit

★ 109 Stars28 Forks26 IssuesN/A Community rating0 Confirmed installs
View on GitHubProject homepage
READMESource: main@2afca228

Agent = Model + Harness — 一只连接 DSH 生态的发光鲸鱼

简体中文 · English · 日本語

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

Awesome GitHub topic: dsh-plugin GitHub Stars Issues welcome

本项目秉持少而精的原则,精选并收录 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 插件项目集合

社区资源

分析教程

教程 形式 内容
DeepSeek Harness 从零到一 中文教程与 Demo 包含原理、源码拆解、8 个 Demo 和 mini-harness 教学项目
DeepSeek Harness:从开机到拆开 中文实测电子书 提供 PDF、EPUB 和 HTML,收录完整系统提示词、129 行默认启动清单与三份原始会话日志
解剖 DeepSeek Harness 交互式源码专题 拆解会话、上下文、工具、沙箱、Code Mode 和 Subagent 等核心机制
Cordis 在做什么:从 DeepSeek Harness 看 中文架构短文 从插件作者视角解释 Cordis 心智模型,讨论复杂度如何转移到系统内部
DeepSeek Harness 白皮书 中英双语手册 14 章覆盖安装、插件开发、安全与成本,提供在线阅读、PDF 和可运行示例;内容采用 CC BY-NC-SA 4.0,基于 0.1.0-rc.6

社区讨论

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

长帖 作者与背景 内容摘要
从早期参与者视角理解 DSH Jiayuan (JY) Zhang;作者自述提前一个月获得仓库访问权限 将 DSH 同时理解为可运行的 Coding Agent 和 Agent 开发框架;用“乐高汽车”解释一切皆插件,并讨论 Runtime 自扩展、自进化软件雏形、当前成熟度和函数式编程特征。
从 Agent Runtime / Agent OS 视角理解 DSH Anionex;内测参与者与插件作者 从模型、工具、策略、存储、上下文、界面和 Loop 的可组合性解释 DSH,并讨论 Agent 对运行时的有限观察与自扩展。
玩了一夜 DeepSeek Harness,我发现它在用《我的世界》的方式干掉 Claude Code 品玩;发布首夜的媒体观察 用《我的世界》的原版、Mod、CurseForge 与整合包类比 DSH 本体、插件、目录和发行版,并记录首夜的兼容性与安全争议。
从源码对照 DSH 与 Codex:声明式插件 vs 可替换 Agent Loop 鸭哥;读完源码后与 Codex 逐行对照。展开文见 yage.ai 将 Codex 的声明式插件与 DSH 的命令式进程内插件对照,认为日常写代码并不需要 Cordis 的复杂度;唯一结构性优势是 Agent Loop 本身可热替换,从而为自进化 Harness 提供物理插槽。

第三方客户端

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

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

桌面与发行版

项目 平台 / 形态 说明
DeepSeek Harness Desktop (anywhere-labs) macOS (Apple Silicon) / Windows · Electron 基于官方 Runtime 与 Web UI 打包本地服务、系统托盘和桌面窗口;v2.0.0 已提供桌面 Profile 与 pnpm 服务,插件市场、移动遥控和 Channels 仍在规划中
dsh-desktop macOS / Windows · Electron · 早期 原样复用官方 Web UI,并让长任务常驻托盘;关闭渲染层 Node 集成、限制导航、更新包校验 SHA-256,但 Agent 进程仍拥有普通用户级文件权限,发行包也尚未正式开发者签名
DeepSeek Harness Desktop (steven-kid) macOS / Windows / Linux · Electron · 早期 保持原版 Web UI 的最小桌面壳,使用随机回环端口、Electron 沙箱和 contextIsolation,发行包通过跨平台启动冒烟测试;macOS 尚未公证,Windows 尚未商业签名
DeepSeek Harness Desktop App macOS / Windows · Electron · 早期工作台 在同一 DSH 运行链上增加项目、Git Worktree、浏览器、Canvas、Site 和 Office 产物;当前为 v0.0.1,安装包仍处于实机验收早期
TinyWhale macOS · Electron · 发行版 Fork 直接 Fork deepseek-ai/deepseek-harness 并增加独立桌面壳;连接已有 Web UI,或启动完整的 dsh web Runtime,不属于插件
Oh-DSH macOS / Linux / Windows · 社区发行版 将 DSH、Node.js 与本地能力打包为 Desktop、Web 和 TUI 三种形态,提供分层安装包与统一的 ohdsh 启动器
DSH Desktop macOS / Windows · Electron 管理本地 Harness、工作区、随机端口、Profile、插件和会话的跨平台桌面端
dsh-launcher Windows · WebView2 提供静默启动、独立窗口、便携包和 MSI 的轻量启动器

终端、移动与 Web 体验

项目 类型 说明
dsh-TUI TUI Bundle Claude Code 风格全屏终端、流式状态、上下文仪表与会话回退
dsh-tianshu-tui TUI Bundle 基于天枢演进的完整终端交互层,状态来自 DSH 会话事件流
dsh-tui TUI Bundle · 早期 支持本地 DeepSeek 与离线运行;仍处于活跃开发期,移植前的测试套件尚未恢复运行
dsh-mini-tui TUI 插件 · 早期 直接连接 DSH Runtime 的轻量终端界面;MIT、v0.2.0,通过 npm 安装,并以 DSH 0.1.0-rc.6 开发与测试
Orbis 移动远控 · Beta 通过 DSH 插件完成设备配对、端到端加密传输和多设备实时更新
dsh-web-ui Web UI 集合 汇总任务看板、Git Graph、移动界面、皮肤、宠物和运行统计等组件
dsh-web Docker Web · 早期 通过 Docker 部署完整 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-omicos:把 OmicOS 生物信息学能力接入 DSH,提供持久 Python / R 内核、能力目录、后台任务和执行过程视图;GPL-3.0-only、npm 0.2.1。分析工具以 permission_mode: full 运行并可能启动本地内核,云模型和高级套餐需要 OmicOS 账号。

上下文、会话与输入

  • 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-credentials-keyring:用 Windows Credential Manager、macOS Keychain 或 Linux Secret Service 替代明文凭据文件,并在无 Secret Service 的 Linux 上 fail closed;MIT、0.1.0,有内存后端测试但尚无 npm / Release,真实系统钥匙串仍待逐平台烟测,标注为早期。
  • dsh-win32:为 Windows 提供沙箱内可运行的持久 Shell、极简模式和 doctor 体检;MIT、v0.12.0,基于 DSH 0.1.0-rc.6,现已修复 SIGTERM、管道和后台任务清理,并以 85 项测试和三系统矩阵验证。Windows 控制台进程在优雅终止失败后可能升级为强制终止;可选沙箱还会下载 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-lark:使用飞书官方 Node SDK 和 WebSocket 长连接把 DSH 接入飞书 / Lark,无需公网回调;MIT、npm / GitHub v0.1.1。默认只申请三项消息权限,凭据从环境变量读取;实际运行会接收并以机器人身份发送外部消息。
  • 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-wakatime:把 DSH 文件操作、AI 代码行数和项目耗时上报到 WakaTime;MIT、npm 0.1.1,有测试但项目仍新,标注为早期。需要 WakaTime API Key,会写入 ~/.wakatime/dsh-wakatime/ 并在缺少 CLI 时自动下载或更新 wakatime-cli。

开发工具

  • 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 验证,项目仍新,标注为早期。
  • dshpack:把 Skills、MCP、Profile Patch 和权限默认值打包成可安装、可分享、可审计的 DSH Profile;默认拒绝构建脚本,支持 dry-run、固定来源、凭据扫描和事务回滚。MIT、M0 预发布,尚无 npm,init / pack 仍未实现,标注为早期。
  • hooks-adapter:让 DSH 直接复用 Claude Code、Codex 和 OpenCode 的 hooks 配置,并提供 Shell、Webhook、LLM 与子 Agent Handler;MIT、仓库声明 111 项测试但尚无 Release,自动发现的 hooks 可执行命令和外发数据,标注为早期。

致谢

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

滑动变祖器:当前状态为梁子,点击进入完整交互版

—/ 5

No ratings yet

Manifest verification required

Commit 2afca22815d2

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout