awesome-deepseek-harness README

The project's README from github.com/libukai/awesome-deepseek-harness. As one markdown file: README.md.

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

简体中文 · English · 日本語

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

Awesome GitHub topic: dsh-plugin GitHub Stars Issues welcome

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

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

目录

快速开始

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

当前核验到的官方 GitHub 开发者预览版为 0.1.2-rc.1;npm latest 与 next 均已指向 0.1.2-rc.1。该 RC 增加完整历史回合导航、精确 Token / 耗时统计、子代理模型选择、ACP 标准控件、定时任务和断线重连,并以可双向继续的 send_message 取代单向 report。公开 WebFetch 默认启用但有 SSRF 防护;SQLite Session Backend 已移除(旧数据保留,导出需旧版本);DeepSeek 适配器默认附带已启用插件包名与版本(可关闭),Session 日志增量上传仍为可选且默认关闭。官方同时明示未经安全审计,Sandbox、Approval 与 Permission 不构成完全隔离保证。下方各项目标注的 DSH 版本仅代表作者声明的开发或测试基线,不应自动视为已兼容最新预览版。

启动 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 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
NanoCordis 可运行的教学实现 用约 1,600 行 TypeScript 重建 Cordis 插件框架与 DSH 形态的 Agent Runtime;MIT、npm 0.1.0、95 项测试,默认 Fake Model 无需 Key,Bash 工具仍需人工批准,真实模型凭据只从环境变量读取

社区讨论

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

长帖 作者与背景 内容摘要
从早期参与者视角理解 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 v2.0.2 固定并原样运行 DSH 0.1.1-rc.2,提供本地服务、系统托盘、恢复 / 回滚和内置插件市场;上游含破坏性更新,旧 Profile 与未适配插件可能失效,升级前应先新建安全 Profile 并保留插件清单
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 · 社区工作台 v0.1.9 在官方 Web / Profile 运行链上提供项目、Git Worktree、浏览器、Canvas、Site、Office 产物、文件 / 文件夹附件和 14 个固定 Bundle;macOS Apple Silicon 包已签名公证,Windows x64 包未签名但已在 GitHub Windows Runner 验收安装、启动、断网 Profile、恢复、卸载与残留清理。中断的插件安装会在下次启动安全重试,用户主动卸载的插件不会被自动补回
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

awesome-deepseek-harness (libukai/awesome-deepseek-harness)

Searching Database…

What is this?This is a curated, awesome-list style guide to DeepSeek Harness (DSH), DeepSeek AI's open-source Agent Harness framework. It collects the official quickstart, official resources, community tutorials, third-party clients, and curated plugins in one place.
Is this a tool I run, or just a curated list of links?It's purely a curated markdown list with no code of its own — it points to the official DSH repo, the Python SDK, tutorials, plugins, and third-party clients rather than being installable software itself.
How is the list organized?It is split into Quick Start, Official Resources (repo, paper, docs, discussion channels), Community Resources (analysis tutorials and discussion threads), Third-Party Clients (desktop/distro and terminal/mobile/web clients), and Curated Plugins grouped by category such as workflow/agent, context/session, browser/UI, sandbox, themes, and integrations.
What do I need to actually run DeepSeek Harness?For the official CLI/Web UI you need Node.js 22.19.x or 24+ (24+ recommended); alternatively the official deepseek-harness-sdk lets you drive it from Python 3.10+ without installing Node.js at all.
Is DeepSeek Harness itself stable and secure enough to trust?Not fully: the current release is only a 0.1.2-rc.1 developer preview, the project explicitly states it has not undergone a security audit, and its Sandbox, Approval, and Permission mechanisms do not guarantee complete isolation. Many third-party plugins and clients listed here are also flagged as early-stage or unsigned.
Does DeepSeek Harness send my session data anywhere by default?Incremental session log uploads are optional and disabled by default, though public WebFetch is enabled by default (with SSRF protections) and the DeepSeek model adapter by default attaches the list of enabled plugin names and versions (this can be turned off).
What does 'Everything is a Plugin' mean for DSH?DSH is built on Cordis with an Everything-is-a-Plugin architecture: model adapters, tools, session logging, the UI, and even the Agent Loop itself are all plugins that can be swapped or recombined.
Are the listed plugins and clients vetted before being added?No — the README explicitly flags many plugins and desktop clients as early-stage, same-day releases, unsigned, or lacking independent usage evidence; being listed does not imply production-readiness.
Can I install a plugin straight from a Git repository?Yes, external plugins are added to a Profile by declaring a dsh.bundle Bundle; the guide recommends pinning a commit and reviewing the install script first, since build scripts run outside the agent sandbox.
What third-party ways exist to run DSH besides the official CLI?The list includes Electron desktop apps for macOS/Windows/Linux, several TUI clients, a Dockerized web deployment (dsh-web), and a mobile remote-control app (Orbis).
Creator
libukai
Size
7.2 MB
Stars
305
Updated
CommitSep 12
Age
2mo
Commits · 90 Days