简体中文 · English · 日本語

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

This project follows a "few but excellent" principle, curating high-quality DeepSeek Harness resources to build a more thriving Agent ecosystem with more AI practitioners.

If this project has been helpful, please feel free to give it a ⭐; you can also follow 𝕏 @李不凯正在研究 for more hands-on Agent content.

Contents

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

Quick Start

DeepSeek Harness (abbreviated as DSH or dsh) is an open-source Agent Harness project by DeepSeek AI. Built on Cordis, it adopts an Everything is a Plugin architecture: model adapters, tools, session logs, UIs and the Agent Loop can all be composed and swapped via a plugin tree.

The currently verified official GitHub developer preview is 0.1.2-rc.1; both npm latest and next now point to 0.1.2-rc.1. This RC adds full history turn navigation, precise Token / latency statistics, sub-agent model selection, ACP standard controls, scheduled tasks and reconnection on disconnection, and replaces the one-way report with send_message, which can continue in both directions. Public WebFetch is enabled by default but with SSRF protection; the SQLite Session Backend has been removed (legacy data is retained, and exporting requires an older version). The DeepSeek adapter now includes enabled plugin package names and versions by default (can be disabled), while incremental Session log uploads remain optional and off by default. The official release also explicitly states that it has not been security-audited, and that Sandbox, Approval, and Permission do not constitute a full isolation guarantee. The DSH versions noted for each project below only reflect the development or testing baseline declared by the author and should not automatically be treated as compatible with the latest preview release.

Launch the Web UI

Install Node.js 22.19.x or 24+ (24+ recommended), then run:

npx @deepseek-ai/dsh web

The default access URL is http://127.0.0.1:3080. After configuring the model service under Settings → Models, you can create a session. For detailed steps, see the official quick start and model service configuration.

Run from Source

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

Use the Python SDK

The official Python SDK lets you invoke Harness programmatically through its built-in runtime, without installing Node.js on the system. The current requirement is Python 3.10+; refer to the official Python SDK guide for supported configurations and platform limitations.

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

Install Plugins

web and headless are Profiles built into the distribution. External plugins are added to a specified Profile as Bundles that declare dsh.bundle:

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

When installing from a Git repository, it is recommended to pin a commit and to review the installation script first. pnpm may require explicit authorization of dependency build scripts; these build scripts run outside the Agent sandbox. See the official plugin packaging & installation tutorial for the full mechanism.

Official Resources

Official resources include an open-source repo, papers, reference docs, and a developer community.

Integration

• @deepseek-ai/dsh: the official npm launch package for the CLI and Web UI
• deepseek-harness-sdk: the official Python SDK for programmatic DSH integration

Source Repositories

• GitHub: browse source code, Issues, releases and contributors
• Paper: a detailed product architecture paper based on Cordis

Docs

• Chinese official site: learn about product positioning and core philosophy
• Help docs: entry points for usage, plugin development and architecture reference

Discussion Community

• GitHub Discussions: issue feedback, usage exchanges and proposal discussions
• Discord DeepSeek: the official Discord community, primarily in Chinese
• "DeepSeek Harness": real-time search results about DSH on X
• # dsh-plugin: a collection of DSH plugin projects on GitHub

Community

Tutorials & Analysis

Tutorial	Format	Content
DeepSeek Harness from Zero to One	Chinese tutorial & Demo	Covers principles, source-code breakdown, 8 Demos and the mini-harness teaching project
DeepSeek Harness: From Boot-Up to Tearing It Apart	Chinese hands-on ebook	Available in PDF, EPUB and HTML; includes complete system prompts, a 129-line default startup checklist and three raw session logs
Dissecting DeepSeek Harness	Interactive source-code feature	Breaks down core mechanisms such as sessions, context, tools, sandbox, Code Mode and Subagent
What Cordis Is Doing: A View from DeepSeek Harness	Chinese architecture short essay	Explains the Cordis mental model from a plugin author's perspective and discusses how complexity is shifted into the system internals
DeepSeek Harness Whitepaper	Bilingual (Chinese/English) manual	14 chapters covering installation, plugin development, security and cost, with online reading, PDF and runnable examples; content licensed under CC BY-NC-SA 4.0, based on 0.1.0-rc.6
NanoCordis	Runnable teaching implementation	Recreates the Cordis plugin framework and a DSH-style Agent Runtime in about 1,600 lines of TypeScript; MIT, npm 0.1.0, 95 tests, default Fake Model requires no Key, Bash tool still requires manual approval, real model credentials only read from environment variables

Discussions

Long-form public posts with full arguments or first-hand background, supplementing official material.

Long Post	Author & Background	Content Summary
Understanding DSH from an Early Participant's Perspective	Jiayuan (JY) Zhang; author states he had early repository access a month ahead	Interprets DSH as both a runnable Coding Agent and an Agent development framework; uses the "Lego car" analogy to explain that everything is a plugin, and discusses Runtime self-extension, prototypes of self-evolving software, current maturity level and functional programming characteristics.
Understanding DSH from the Agent Runtime / Agent OS Perspective	Anionex; closed-beta participant and plugin author	Explains DSH through the composability of model, tools, policies, storage, context, UI and Loop, and discusses the Agent's limited observation of the runtime and its self-extension.
After a Night Playing with DeepSeek Harness, I Found It's Killing Claude Code the Way 《Minecraft》 Does	PingWest; media observation published on the first night	Uses 《Minecraft》's vanilla edition, Mods, CurseForge and modpacks as analogies for the DSH core, plugins, directory and distribution, and records compatibility and security debates from the first night.
Comparing DSH to Codex from Source: Declarative Plugins vs Replaceable Agent Loop	鸭哥; read the source and compared line by line with Codex. Full write-up on yage.ai	Contrasts Codex's declarative plugins with DSH's imperative in-process plugins, arguing that day-to-day coding does not need Cordis's complexity; the only structural advantage is that the Agent Loop itself can be hot-swapped, providing a physical slot for a self-evolving Harness.

Third-Party Clients

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

Category Note: Distributions or Forks directly reuse, modify, or repack the full DSH Runtime and cannot be installed via dsh plugin, so they do not belong to the plugin category; standalone clients instead connect to DSH through Web, RPC, ACP, or companion bridge plugins. They remain an important part of the Harness ecosystem.

Desktop & Distributions

Project	Platform / Form	Description
DeepSeek Harness Desktop (anywhere-labs)	macOS (Apple Silicon) / Windows · Electron	v2.0.2 pins and runs DSH 0.1.1-rc.2 as-is, providing local service, system tray, recovery / rollback and a built-in plugin market; upstream contains breaking updates, old Profiles and unadapted plugins may stop working — create a fresh safe Profile and keep a plugin manifest before upgrading
dsh-desktop	macOS / Windows · Electron · Early	Reuses the official Web UI as-is and keeps long-running tasks resident in the tray; disables renderer-layer Node integration, restricts navigation, and verifies update package SHA-256, but Agent processes still hold regular user-level file permissions, and release packages are not yet officially developer-signed
DeepSeek Harness Desktop (steven-kid)	macOS / Windows / Linux · Electron · Early	A minimal desktop shell around the original Web UI, using a random loopback port, Electron sandbox and contextIsolation; release packages pass cross-platform startup smoke tests; macOS is not yet notarized, Windows is not yet commercially signed
DeepSeek Harness Desktop App	macOS / Windows · Electron · Community Workbench	v0.1.9 provides Projects, Git Worktree, Browser, Canvas, Site, Office outputs, file / folder attachments and 14 fixed Bundles on the official Web / Profile runtime chain; macOS Apple Silicon packages are signed and notarized, Windows x64 packages are unsigned but have been verified for install, launch, offline Profile, recovery, uninstall and residue cleanup on GitHub Windows Runner. Interrupted plugin installations are safely retried on next startup, and plugins explicitly uninstalled by the user are not automatically re-added
TinyWhale	macOS · Electron · Distribution Fork	Forks deepseek-ai/deepseek-harness directly and adds a standalone desktop shell; connects to an existing Web UI, or launches the full dsh web Runtime — not a plugin
Oh-DSH	macOS / Linux / Windows · Community Distribution	Packages DSH, Node.js and local capabilities into Desktop, Web and TUI forms, providing tiered installers and a unified ohdsh launcher
DSH Desktop	macOS / Windows · Electron	Cross-platform desktop client for managing local Harness, workspaces, random ports, Profiles, plugins and sessions
dsh-launcher	Windows · WebView2	A lightweight launcher providing silent start, independent window, portable package and MSI

Terminal, Mobile & Web Experiences

Project	Type	Description
dsh-TUI	TUI Bundle	Claude Code-style full-screen terminal, streaming status, context gauges and session rollback
dsh-tianshu-tui	TUI Bundle	A complete terminal interaction layer evolved from Tianshu, with state driven by DSH session event streams
dsh-tui	TUI Bundle · Early	Supports local DeepSeek and offline operation; still in active development, the pre-port test suite has not yet been restored to running
dsh-mini-tui	TUI Plugin · Early	A lightweight terminal UI that connects directly to the DSH Runtime; MIT, v0.2.0, installed via npm, developed and tested against DSH 0.1.0-rc.6
Orbis	Mobile Remote Control · Beta	Completes device pairing, end-to-end encrypted transfer and multi-device real-time updates via a DSH plugin
dsh-web-ui	Web UI Collection	Aggregates components such as task boards, Git Graph, mobile UI, skins, pets and run statistics
dsh-web	Docker Web · Early	Deploys the full Web interface, workspaces and plugin market via Docker; the project is in a high-speed development phase and requires mounting data volumes to persist configuration and sessions

Listing a project does not mean it is signed, notarized, self-contained, or production-ready; check the current notes in each project's README and Releases.

Featured Plugins

Workflows & Agents

• 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-spec-collab：把产品原始需求整理为由产品、研发与双方 AI 共审的 Git 版本化 Ready Spec，AI 只能提交 Review Item 和候选 Patch，确认与正式保存仍由人完成。Apache-2.0、npm 0.2.1，声明兼容 DSH 0.1.1-rc.1 并附测试套件；但仍为同日快速迭代项目，尚无 CI、GitHub Release 或独立使用证据，标注为早期。插件会在 ~/.dsh/spec-collab 写入协作账本与独立 Git 仓库，并启动额外 AI 审核会话；HTTP 管理面默认仅回环与同源，花名并非身份认证，对外开放前必须另配认证和可信反向代理。
• dsh-context-guard：把需求、禁令、验收条件与后续修正固化为任务契约，只有当前成功证据与当前契约匹配时才允许 Goal / Turn 完成，并能从原生 Session Event 重建与复核证书。Apache-2.0、npm / Release 0.1.0，固定 DSH 0.1.1-rc.2，仓库声明 104 项测试并在 macOS / Windows 做过原生隔离验收。它不新增自定义事件，也不是 Sandbox、Memory 或语义证明系统；命令副作用解析和证据匹配仍可能漏判，同日首发且缺少独立使用证据，因此标注为早期。
• 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-crew：从 Claude Code 或 Codex 调度真实 DSH Worker，并提供进度、状态分片和分层策略；MIT、Release / npm next 0.1.0-rc.4，声明在 DSH 0.1.1-rc.1 验证并含 MCP 与发布包烟测。会写入 ~/.config/dsh-crew/status.d/，外部模型服务可能需要 API Key；仍为预发布且没有独立测试 CI，标注为早期。
• dsh-trading：面向交易研究的 DSH 工作台，提供确定性指标、CSV 数据源和交互式图表；MIT、npm @dsh-trading/bundle@0.1.0。项目不提供订单执行接口，并以启发式规则拦截资金移动类工具，但该拦截并非完备安全边界，标注为早期。
• oh-story-dsh：把 13 个小说 Skills、7 个专业 Roles 和短剧生产流程接入 DSH 原生 Session、审批与三栏创作工作台。MIT、npm / Release 0.1.3、Node.js 24+，Peer 依赖从 DSH 0.1.1-rc.1 起，Release 声明 34 项自动化测试和 Ubuntu / macOS / Windows CI；本版复用官方 Composer 高度，为消息流增加滚动安全区与锚点几何回归，避免展开任务、流式状态和定位消息被 Composer 遮挡。构建会排除上游登录 / CDP 抓取器和独立 Dashboard；插件不读取模型凭据或另开监听端口，但会在当前 Agent 可见工具范围内读写创作项目文件、调用专业 Role，并在 DSH Web Server 上增加受 Host、Origin、Session、路径 containment 和乐观并发保护的文件路由。项目于 8 月 21 日首次发布，目前只明确验证 DSH rc.1，尚缺长期维护与独立使用证据，因此标注为早期。

上下文、会话与输入

• dsh-context：在 Web UI 的 Context 面板和 /context 命令中，按请求展示 System Prompt、工具 Schema、消息、注入、回复和工具结果的 Token 组成，并标出压缩、剪枝与缓存命中；Apache-2.0、npm / Release 0.35.0。新版加入可跳转任意层级子代理的 Agent Network，并让 File Activity 识别 PTC / Code Mode 内层调用、缺损日志与读取行范围；Host 明确声明 canOpenPath 时可点击交给系统默认程序打开文件，工作区内路径按 Session 根目录解析，搜索模式等不可证明路径不会开放。Peer 依赖仍从 ^0.1.0-rc.7 起，源码测试采用逐文件覆盖门槛并有 Bundle 烟测；无需外部服务，但 UI 会每小时至多一次查询 npm，官方 Registry 不可达时会回退到 npmmirror。
• dsh-profile-settings：在全局 settings.yaml 上增加按 Profile 隔离的 settings.patch.yml 覆盖层，支持递归合并、!unset、来源检查、热重载及设置页管理，并保持原有 ctx.settings 接口。MIT、npm / Git Tag 0.1.0、Node.js 22.6+，Peer 依赖锁定 DSH 0.1.1-rc.2 系列，含 15 个测试文件；最新 CI 的源码检查、构建与 Node 22.6 / 24 / 26 发布包烟测通过，但总流程仍在 npm 发布步骤失败，而 Registry 已可获取 0.1.0。插件默认可写 Profile 覆盖文件，promote / demote / migrate 还会跨全局与 Profile 文档改值，并以锁、原子替换和迁移备份约束写入；项目同日首发、无 GitHub Release 或独立使用证据，因此标注为早期。
• dsh-context-doctor：审计 AGENTS.md、Skill 目录和工具 Schema 的上下文 Token 成本与冲突。
• dsh-memory-evolve：跨会话记忆、后台演进和分支感知能力。
• dsh-noema：为 DSH 接入本地优先的 Noema 长期记忆，支持工作前召回、设置页管理和从 Codex、Claude Code、Cursor、Hermes 等导入已有记忆；MIT、Release / npm next 0.1.0-rc.3，已在 DSH 0.1.1-rc.1 验证并有 CI 与测试，项目仍新，标注为早期。
• EverOS Memory for DSH：把用户、助手、工具调用和结果轨迹写入本地 EverOS，并在后续会话开始前召回；Apache-2.0，插件 0.1.0 支持 DSH >=0.1.0-rc.6 <0.2.0-0，但尚未发布 npm，延迟提取还依赖未进入标签版的 EverOS 能力。轨迹可能含源码、命令和工具输出，外部模型配置需单独审查，标注为早期。
• dsh-at-file：在输入框中通过 @file 搜索工作区文件并附加内容。
• dsh-shikitor：在输入区统一发现 # 会话、@ 工作区文件、$ Skill 和 / 命令，并提供可扩展的工作区文件编辑器；MIT、npm 1.0.2，支持 DSH >=0.1.0-rc.5 <0.2.0。编辑默认自动保存，外观与路径规则保存在浏览器侧。
• dsh-message-edit：分支式消息编辑、重试、重新生成和版本时间线。
• dsh-client-auto-retry：检测 error、interrupted 或 max-tokens 后自动向原会话发送“继续”，并用宽限期、冷却和连续次数上限约束重试；MIT、npm 0.3.1，仅声明兼容 DSH 0.1.0-rc.7。默认启动时扫描最近 15 分钟的中断会话，可能继续产生模型调用和 Token 消耗；尚无可见测试或 Release，标注为早期。
• dsh-prompt-studio：编辑系统提示词片段并提供实时预览。
• dsh-turn-rewind：基于持久 Change Ledger 回退对话和工作区状态。
• dsh-filesnap：把对话与工作区文件一起回退到显式指定的轮次，并始终在新 Fork 中恢复，预先建立救援点后可用 /redo 反向撤销，不改 Git 分支、提交、Stash 或 Worktree。Apache-2.0、npm / Release 0.2.1、Node.js ^22.19 或 24+，支持 Linux / macOS / Windows x64 与 arm64；CI 从源码构建当前 DSH 并运行 10 个测试文件和客户端构建。插件通过随包 Rust filesnap 二进制捕获二进制、忽略文件及已观察到的工作区外 ctx.fs 路径，恢复时可能覆盖或按明确 Tombstone 删除文件；快照以当前用户权限明文保存在平台数据目录。卸载后，含自定义事件的已捕获 Session 需重装插件才能打开；项目同日首发且没有独立使用证据，因此标注为早期。
• dsh-compaction-instant：以确定性编译替代 LLM 摘要，并通过 recall / search 恢复被压缩内容；替换内置压缩器时需要使用 npm alias，属于较深的运行时改造。
• toolshrink：按测试、Diff、JSON、目录树、日志和安装输出的结构做内容感知压缩，并在需要时保留原始输出引用；MIT、0.1.0，目前需从源码构建并修改全局 ~/.dsh/cordis.patch.yml，暂存的原始输出会在 24 小时后清理，标注为早期。
• dsh-tool-squeeze：为测试、Diff、JSON、目录树、日志、安装输出和 HTML 提供确定性、本地优先的工具结果压缩；MIT v0.1.0，固定兼容 DSH / dsh-tools 0.1.0-rc.8，项目声明 21 项测试及可复现基准。与需源码构建并自行保留原文的 toolshrink 相比，它可直接安装 GitHub Bundle、无需额外模型或网络调用，并将完整原文交给官方 Spill Store；压缩仍有损，且项目为同日初发、无 CI 或独立使用证据，标注为早期。
• dsh-whale-report：从会话事件日志生成日报、周报、月报、年报和自定义区间报告；MIT、Release / npm 0.6.1、Node.js ^22.19 || >=24，Peer 依赖要求 DSH >=0.1.1-rc.2 <0.2.0。0.6.0 加入首个严格白名单的 Apply & Verify 操作：仅在重复 Bash 超时证据与用户明确批准后，可将 shell.timeoutMs 从 60 秒调为 120 秒并验证、审计和安全回滚；不支持任意设置、任意命令、自动修复或自动回滚。当前 Release Commit 的 CI 通过，说明包含 393 项测试与真实包验收；0.6.1 修正历史计价生效日期、启动后新会话与恢复会话的统计，可实质改变历史 Token / 成本总额，但未改变 Apply & Verify 边界。项目仍新且已具备受控配置写入能力，故标注为早期。

浏览器、视觉与界面

• dsh-browser：Chrome 侧边栏扩展，让 DSH 直接操作当前浏览器页面。
• dsh-vision-toolkit：图片问答、长截图 OCR、UI 还原、Grounding 和像素对比。
• dsh-computer-use：原生 macOS Computer Use Bundle，优先使用 Accessibility，拒绝过期观察并按应用、Session 和操作范围管理权限；当前为早期 0.1.0，需从源码检出目录安装。
• dsh-plugin-appshot：通过 macOS / Windows 全局快捷键截取当前前台窗口，并把图片作为 Attachment 送入当前 DSH Composer；MIT、npm / Release 0.4.1，新版修复 macOS 14+ Native Agent 构建，仓库包含 34 个测试路径与双平台 Native 构建。预构建包内含 macOS App 和 Windows 自包含 EXE；macOS 需要屏幕录制与辅助功能权限，Native Agent 会持久化截图并通过本机 SSE 交给 Host。包元数据未声明 Peer 依赖，开发依赖仍固定旧 DSH 0.1.0-rc.6，当前 Alpha 兼容性与高权限链路仍需实机复核，因此标注为早期。
• dsh-ios：在 DSH 对话中提供 iOS 模拟器与 USB 真机的实时画面，以及 22 个构建运行、语义 UI 自动化、SwiftUI Preview 热重载、日志、回溯和泄漏检查工具；MIT、Release / npm latest / next 0.1.0-rc.5，最新 Release Commit 的 Plugin Check 与发布流程均通过，并自报 744 个验证步骤。rc.5 为繁忙 WDA 增加快速超时、10 秒冷却和共享尺寸缓存，并为停滞 MJPEG 流增加 8 秒看门狗，但原始真机故障尚未在真实设备上复现。包的 Peer 依赖从 DSH 0.1.0-rc.6 起、README Requirements 也写 >=0.1.0-rc.6，而页首仍遗留 rc.3 / DSH 0.1.1-rc.1 的旧声明，兼容元数据尚未统一。当前仍为预发布且仅支持 macOS + 完整 Xcode；可选 AXe 首次可能下载经 SHA-256 校验的二进制，OCR 会本地编译，真机控制需用户预置并签名 WebDriverAgent，工具可执行构建和真实设备操作，因此标注为早期。
• dsh-android：把 Android 模拟器或 USB 真机的实时画面接入 DSH 对话，并提供 20 个设备发现、构建安装、语义 / OCR UI 操作、日志、进程和内存工具。MIT、Release / npm next 0.1.0-rc.4，在 DSH 0.1.1-rc.1 与 Node.js 24.11+ 上验证，含 7 组静态烟测和通过的 CI；但同日首发、全部 Release 均为预发布，npm latest 仍停在 rc.1，安装 rc.4 需显式使用 @next，因此标注为早期。运行需要 adb / Android SDK，工具可构建并安装 APK、控制设备和读取日志；OCR 仅支持 macOS 并会在首次使用时本地编译随包 Swift，浏览器路由采用回环限制与短时 HMAC Capability。
• modlens：通过粘贴图片和模型路由让纯文本模型获得视觉能力，是以独立视觉工具处理工作区图片之外的另一种方案。
• ModSearch：为 DSH 补充 Web 搜索、X 搜索和网页正文读取，返回结构化证据；MIT，已发布 v5.9.1，支持同一引擎多 API Key 轮换，并修复 Windows 自动路由只按无扩展名查找、因而漏掉原生 .exe CLI 的问题；继续对本地抓取执行 SSRF / DNS 重绑定防护，不同搜索通道可能依赖外部 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，当前源码包版本 0.9.1、最新 GitHub Release 为 v0.8.6，以 Git 安装为主，Peer 依赖已覆盖 DSH rc.8 与 0.1.1-rc.x，并有 CI，仍标注为早期。
• DSH-better-sidebar：集成文件、终端、Git、子 Agent 和第三方 Tab 的侧边栏工作台。
• dsh-openpencil：在 DSH 中预览和编辑 OpenPencil 设计。
• dsh-visualize：在对话流中生成沙箱化的可交互 HTML 卡片。
• dsh-notification：按任务结果和关键词配置桌面通知。
• dsh-locale-ja：为 DSH Web 增加日本语界面与系统日文字体，覆盖 29 个命名空间、721 条 UI 字符串；MIT、npm / Release 0.4.3、Node.js 22+，Peer 依赖锁定 @deepseek-ai/dsh-client-locale ^0.1.1-rc.2，仓库测试、字典漂移检查和每日 next DSH E2E 均通过。插件只挂载客户端本地化模块，不新增 Host 路由、凭据或外部服务。
• 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 版 DSH 的诊断、验收与安全修复工具；MIT、npm / Release 0.17.0，CI 在 Node 22.19 / 24 下覆盖 npm hoisted 与 pnpm strict 安装。新增 verify 会在隔离的临时 Home / Workspace 中，用已安装的官方 PowerShell、Subprocess 与 Workspace Write 组件验证持久状态、外部写入拒绝、恢复、取消、PTY 替换与清理，但不启动完整 Minimal Host 或发起模型请求。默认 setup 不替换官方栈，只核验组件、修复可确认的 koffi 加载问题并可创建桌面快捷方式；doctor 只读，fix 仅修复已知损坏或真实加载失败的 koffi。旧 Git Bash / BusyBox 路径仍需显式 setup --legacy，其中 Git Bash 要求 danger-full-access；工具不会自动安装 Git、PowerShell、BusyBox、WSL 或另一套 DSH Bundle。
• dsh-exec-extension：为 Headless Profile 增加一次性 Exec CLI，把 stdin、@file、工作目录、模型、超时、JSONL 输出和权限模式变为逐次参数；MIT v0.1.0，固定 DSH 0.1.0-rc.7、Node.js 22.19+，含 Node / Rust 测试与持续集成。默认仍是 workspace-write，无界面的 --approval ask 会 fail closed；--full-auto / --yolo 会自动批准，只有显式 --sandbox danger-full-access 才解除沙箱。当前仅通过固定 Git Tag 安装，Git 依赖的 prepare 在 Agent 沙箱外执行，需先审查并显式授权。

主题与皮肤

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

外部集成

• dsh-oomol：通过 OOMOL Connector 渐进式发现应用和 Action、检查 Schema 并执行已连接的 SaaS 能力；MIT、npm 0.1.4。DSH 只保存可撤销的 OOMOL MCP Key，第三方 OAuth Token 留在 OOMOL；卸载插件不会自动断开第三方账户，Action 执行目前也没有幂等键。
• Tencent Cloud ADP for DSH：腾讯云 ADP 团队维护的模型、混元 AI 搜索、API / MCP 插件市场、Skill 广场与已发布 ADP 应用集成；MIT、npm / Release 0.1.1、Node.js 22.19+ 或 24+，模拟 HTTP 测试为 CI 门槛，真实账号测试仅在显式提供环境时运行。Tool Key、SecretId / SecretKey 与逐应用 AppKey 分属三套凭据平面，值写入 DSH Credentials 或环境变量；应用 / Agent / Release 的变更操作只在启用 allowMutating 后注册且仍需审批。项目版本较早、依赖外部云账号并可改变 ADP 资源，标注为早期。
• dsh-forge：为自托管 Gitea 与 Forgejo 提供实例、仓库、Issue、分支、PR、Actions Run 与 Job Log 的只读工具；MIT、npm / Release 0.3.3，兼容 DSH Tools rc.6 与当前 rc.2，CI 会用官方 Gitea / Forgejo 与 Runner 容器做真实集成测试。建议使用最小只读 Token 的环境变量；npm 或预构建 Release 不执行本地构建，Git 源安装则会运行 prepare，需要审查并固定 Commit 后再授权。
• dsh-sonarqube：只读查询 SonarQube Community Build 的 Quality Gate、Issue、Security Hotspot、覆盖率与重复率；MIT、npm / Release 0.1.0，Peer 依赖覆盖 DSH Tools rc.8 与当前 rc.2，CI、覆盖门槛和 SonarQube 26.8.0.126808 实例核验已通过。Token 建议放环境变量，插件不返回或记录 Token；当前仍为首个版本，真实实例没有可供成功读取的 Hotspot 样本，该路径只由 Mock 测试覆盖，因此标注为早期。
• Milvus for DSH：Zilliz 团队维护的 Milvus / Zilliz Cloud 只读集成，提供集合、Schema、精确查询、标量查询、Dense、BM25 与 Hybrid Search；Apache-2.0、npm 0.1.3，固定 DSH rc.7，Milvus Token 与 Embedding Key 存入只写 DSH Credentials，查询向量只在 Host 内存生成并发送到 Milvus。仓库有单元与显式联网集成测试，但尚无 GitHub Release 或可见 CI；外部 Endpoint、Provider Key 与长期兼容性仍需部署方验证，因此标注为早期。
• Ollama：Ollama 官方提供的启动方式，不是 DeepSeek 官方发行包。通过 ollama launch dsh 安装并启动 DSH、选择 Ollama 模型和配置 Web 搜索；独立设置写入 ~/.ollama/launch/dsh/settings.yaml，不会改动 ~/.dsh/settings.yaml。当前标注为开发者预览。
• Rapid-MLX DSH Provider：从本机 Rapid-MLX 的 /v1/models 读取模型能力、推理模式和上下文窗口，避免手写 DSH Provider 元数据；Apache-2.0，已在 DSH 0.1.0-rc.7 端到端验证并含协议测试，但故意保持未发布的源码安装，标注为早期。仅连接默认回环地址，仍需单独运行 Rapid-MLX；图像输入会明确拒绝。
• 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，属于大型独立产品而非普通插件。
• HarnessRouter：把 Codex、Claude Code、Hermes、Pi 与 DSH 暴露为本机统一 UHP API 和控制台的自托管容器，而非普通 DSH 插件。Apache-2.0、Release v0.9.1，带 Gateway / Runner / UHP Conformance 测试和独立安全文档；DSH 后端固定安装 Python SDK / Runtime 0.1.0rc7，并对内部 JSON-RPC Server 0.1.0-rc.7 做不匹配即拒绝的版本检查。首次启动会从上游安装各 Harness CLI 并遵循各自许可证，Docker Volume 持久化数据库、文件、工作区与加密材料；控制台默认只绑定回环，但使用默认口令，对外暴露前必须修改并配置 TLS。容器以 root 启动后降权，Agent 按 Session 使用独立用户；Provider Key 留在回环 Relay 进程，不进入 DSH 环境。项目仍新，DSH 适配会覆盖内部私有字段、改写部分流式 Tool Call Delta，固定 Runtime 尚不含 MCP Client，也未验证当前官方 DSH 0.1.1-rc.2，因此标注为早期。
• dsh-multica-runtime：连接 Multica 与 DSH 的早期运行时桥接；当前包标记为 private、UNLICENSED，安装与分发边界仍不完整。
• dsh-imessage：通过 Photon 托管号码把一对一 iMessage 文本转成 DSH Prompt，并回发最终回答，支持会话切换、停止、审批和问题回答；MIT、npm / Release 0.2.0，固定 DSH 0.1.0-rc.6，含测试与 CI。需要 Photon 账号、发送号码和仅保留在 Host 侧的本地凭据，消息会经过 Photon；断开仅清理本地状态，不删除 Photon 云端资源。项目仍新且依赖托管服务，标注为早期。
• 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。
• dsh-im：在一个 DSH Bundle 中统一管理十个 IM 渠道与 AI Office，支持多机器人、流式回复、工作区 / 会话绑定、远程审批及超时任务结果补发。MIT、npm / Release 4.20.0、Node.js 22.19+，Release Commit 的 CI 通过。新版兼容未修改的原版 DSH 0.1.5-alpha.1，并继续覆盖此前四个原版 DSH Web profile；管理能力统一通过 Connection 的公开 /api Fetch 接口实现，不需修改或重编译 DSH。管理访问默认仅回环，trusted-host 仍受 DSH 浏览器认证及 Host / Origin 检查约束，更新和入站 TTL 管理始终仅允许回环。升级后需重启 Host 并刷新设置页；授权聊天用户仍可触发模型和工具，工作区 / 会话列表可能暴露本机路径和敏感元数据，应只向可信用户开放。
• 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 验证。内容采集默认关闭，启用后可能外发源码、凭据和个人数据。
• Tencent Cloud Agent Observability for DSH：腾讯云团队维护的 CLS 直传可观测插件，无需 OTLP Collector，把 Session、Agent Loop、模型流和工具生命周期映射为五层 Trace；Apache-2.0、npm / Release 0.0.1，支持 DSH >=0.1.0-rc.6 <0.2.0，项目很新，标注为早期。默认会把 Prompt、Response 和工具参数/结果发送到 CLS，处理敏感仓库前应关闭 captureContent 并配置最小权限与保留策略。
• Token Monitor：本地优先的跨平台桌面用量工具；当前 Release 为 v0.47.0，DSH 的 JSONL / Zstandard 会话读取与按回合 Token、Prompt、工具记录展示自 v0.46.0 加入。MIT，macOS 包已签名公证、Windows 包已签名，含 DSH 解析测试与持续集成；默认不向维护者发送遥测，可选多设备同步会向操作者指定的 Hub 发送汇总用量和账号 / 项目元数据，但不发送原始 Prompt、源码或凭据。
• dsh-wakatime：把 DSH 文件操作、AI 代码行数和项目耗时上报到 WakaTime；MIT、npm 0.1.1，有测试但项目仍新，标注为早期。需要 WakaTime API Key，会写入 ~/.wakatime/dsh-wakatime/ 并在缺少 CLI 时自动下载或更新 wakatime-cli。

开发工具

• dsh-plugin-check：检查 Manifest、Patch、构建陷阱和目录收录状态。
• DShScan：为 DSH 插件生成规则证据、风险分和安装建议，可离线扫描本地内容，也可显式联网抓取 GitHub / npm 源码、调用 npm audit 或外部 LLM；MIT、npm / Release 0.5.0，CI 和测试已覆盖 DSH 特有规则，但仍固定兼容 DSH 0.1.0-rc.6 且项目迭代很快，标注为早期。低风险结论不等于安全审计。
• DSH Plugin Upgrade Skill：为 DSH 插件升级、迁移、编写、测试、发布、审计和运行时调试提供 8 个 Skills，收录截至 0.1.2-alpha.4 的 45 张迁移卡与 12 组通用策略，并用 29 个 Harbor 任务和多组有 / 无 Skill 对照验证。MIT，可通过 npx skills add oh-my-dsh/dsh-plugin-upgrade-skill 安装，当前验证 CI 通过。统一入口会先建议只读健康检查并分阶段请求确认，但具体工作流可修改源码、安装依赖、运行测试 / Docker、打包乃至发布，必须在对应授权下使用。项目创建于 2026 年 8 月 30 日，尚无 Release，迁移卡也尚未覆盖当前 0.1.2-rc.1，故标注为早期。
• DSH Harbor：为已安装插件生成声明与源码检出的 13 类能力账本、file:line 证据、运行时工具 / Provider / 路由归属、同 Profile 冲突、跨 Profile 版本漂移与变更快照；MIT、npm next / Git Tag 0.1.0-rc.2，已在 DSH 0.1.1-rc.2 验证，Node 20 / 24、Ubuntu / Windows CI 与真实打包烟测通过。默认扫描离线只读；快照写入 ~/.config/dsh-harbor/，只有显式上游检查会读取 npm Registry 配置并联网，错误会脱敏凭据。它不是沙箱、安装门禁或策略引擎，且仍为预发布、无 GitHub Release 或独立使用证据，因此标注为早期。
• HOL Guard for DSH：在 DSH 的异步 tools/pre-execute 与最终单调 Guard 两层对工具调用做 fail-closed 本地策略检查，把模糊决策交给一次性原生审批，并保留安全回执；Apache-2.0、Release v0.3.0、Node.js 20+，另需安装 hol-guard >=2.0.1024。仓库含 14 个测试文件，CI 还用固定的官方 DSH 0.1.0-rc.5 源码跑真实 Headless 阻断测试；默认无需云账号，Cloud 同步为可选。安装会修改所选 Profile，策略可阻止工具执行并在本地 Approval Center 等待决定；保护范围仅覆盖经过 DSH ToolRuntime 的调用，不约束插件在该管线之外自行执行的代码。由于尚未证明兼容当前官方 0.1.1-rc.2，且最新运行时版本同步 Workflow 失败，标注为早期。
• dsh-fail-logger：脱敏、去重并分类记录工具失败，将机器维护的实录沉淀进 Skill；只记录问题，不自动修改行为。
• dsh-session-surgeon：扫描、检查、导出并修复无法加载、序列断裂或残留临时文件的 DSH 会话；MIT、v0.1.0，支持 DSH 0.1.0-rc.6 并从 GitHub 源码安装，标注为早期。修复默认 dry-run，--apply 会先写 .bak.<utc>；导出默认脱敏，--no-redact 会显式关闭保护。
• deepseek-harness-action：在 GitHub Actions 中使用 DSH 做 PR Review、CI 诊断、自动修复和 Issue → PR；写权限默认关闭，并将验证放在无凭据容器中运行。
• Awesome DSH Plugins Radar：自动扫描并分别展示发现、静态、编译和运行级信号的兼容性雷达；MIT、数据高速变化且尚无 Release，“运行可用”不等于安全审计或内容质量，标注为早期。
• dsh-market：DSH 内置插件市场，可浏览、搜索、安装、更新和卸载登记在 awesome-dsh-plugin 的项目；MIT、npm / Release v1.31.1。在网络分区、中国大陆路由、官方源回退与 Anywhere Labs Desktop 可恢复安装边界基础上，新版会明确解释 npm-only Desktop 无法安装 GitHub-only 项目、目录入口已失效，以及恢复、回滚或操作后 Profile 仍缺少的启动条件；1.29.3 同时回滚依赖和 Bundle 行，Tasks 面板关闭设置页后仍继续显示。安装后仍比较整个 Profile 的 Bundle 状态并检查 CJS，只报告本次引入的风险；ESM Bundle 仍不做语法检查。构建脚本默认阻止、安装端点仅同源 POST、Agent 运行时禁止更新，但代理传输不证明字节等价，目录收录也不代表安全背书。
• 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；MIT、npm 0.3.0，18 个命令已可用，包括 init、export、compose、lock、pack、事务化安装 / 更新 / 卸载和回环管理 UI。构建脚本默认拒绝，来源固定到 Commit，导出前后三次扫描凭据，冲突要求显式解决，失败会带 Journal 回滚；doctor 可能触发 DSH 重写 cordis.yml，并由 dshpack 写审计日志。Pack 格式与 CLI 仍不是稳定 API，标注为早期。
• hooks-adapter：让 DSH 直接复用 Claude Code、Codex 和 OpenCode 的 hooks 配置，并提供 Shell、Webhook、LLM 与子 Agent Handler；MIT、仓库声明 111 项测试但尚无 Release，自动发现的 hooks 可执行命令和外发数据，标注为早期。

致谢

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