DeepSeek Harness 使用指南
deepseek-ai/deepseek-harness（命令行里叫 dsh）是 DeepSeek 官方在 2026 年公开的开源 Agent 运行时，核心口号是「everything is a plugin」——模型、工具、会话、沙箱、审批策略、UI 全部做成可替换插件。本文基于官方仓库 README、架构文档和产品页转述整理，不是逐字翻译，具体以官方持续更新的内容为准。
什么是 DeepSeek Harness
DeepSeek Harness 不是一个像 Claude Code、Codex 那样"开箱即用、界面固定"的编程助手产品，官方把它定位成一个 Agent 运行时 / 元框架（meta-framework）：负责把模型、工具、沙箱、会话记录这些能力组织起来，具体产品形态（终端 UI、Web UI、无头脚本）由插件决定。它基于一个叫 Cordis 的内核构建，Cordis 的设计思路来自论文《A Programming Paradigm for Spatiotemporal Composability》。
项目采用 MIT 协议开源，目前处于 developer preview（开发者预览） 阶段，官方在文档里明确写着接口会有破坏性变更（compatibility-breaking changes），面向的是愿意跟着项目一起快速迭代的开发者，而不是追求稳定日常驱动工具的普通用户。
安装
用 npm 一键启动
安装好 Node.js 后，直接用 npx 启动自带的 Web UI：
npx @deepseek-ai/dsh web默认会在 http://127.0.0.1:3080 启动一个本地 Web 界面，命令行里会打印出实际访问地址。
从源码构建
如果想跟主分支同步或者参与插件开发，官方推荐克隆仓库后本地构建：
git clone https://github.com/deepseek-ai/deepseek-harness
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web快速开始
官方用户指南把第一次使用拆成四步：
- 启动 Web UI：按上面的方式跑起来，命令行会打印访问地址；应用默认把启动时所在的目录当作文件系统入口。
- 配置模型：在「设置 → 模型」里填入 DeepSeek API Key 并保存，模型路由立刻生效，不需要重启服务；文档里也提到这里同时支持配置其他 provider 和兼容端点，说明它不是绑死单一模型供应商的工具。
- 选择工作区：把要处理的项目目录添加为工作区并选中它——只有选好工作区之后，会话编辑器才能正常使用。
- 发起任务：直接用自然语言描述任务（官方举的例子是"总结这个仓库并识别主要包"），Agent 会自主读写文件、执行命令、维护计划，必要时把工作拆给其他 Agent。
核心特性
插件化架构：Cordis 内核
Cordis 内核本身"没有需要打补丁的特权核心"——所有能力都是通过在其他插件旁边挂载新插件来扩展的。插件之间通过服务、类型化事件和可逆效应（reversible effects）互相协作，运行时整体是一棵按层排列的插件树，每一层还能用 cordis.patch.yml 做局部覆盖。架构文档列出的核心组件包括：
官方强调的好处是"每一部分都可替换"——换一个模型适配器、换一套工具注册表，甚至换掉会话日志或 Agent 循环本身，理论上都不需要碰核心代码，只需要挂载不同的插件。
三种打包方式：Web App / Headless
架构文档里描述了三层 profile：dsh-base 是所有 profile 的基础层，打包了模型适配器、工具、持久化、沙箱与审批策略、设置、凭证和遥测；dsh-web-app 在 base 之上加一层浏览器应用界面；dsh-headless 则加一个不需要任何服务器的一次性执行器，适合脚本化调用和 CI 场景。
会话里的四种运行模式
官方产品页另外描述了会话内可选的四种运行模式，跟上面的"打包方式"是两个不同维度：
- 标准模式：完整工具集，日常使用的默认模式。
- 代码模式：模型直接生成 TypeScript 代码来编排多步工具调用，而不是一步步单独发工具调用请求。
- 最小模式：只保留 Shell 和文件编辑器两个工具，官方说是用来做基准测试（benchmark）的精简配置。
- 创建者模式：面向插件开发者，支持运行时检查和插件实验。
完整可追溯的会话日志
DeepSeek Harness 采用追加式（append-only）的会话日志，记录系统提示词、推理过程、工具调用和结果等完整信息——文档原话是"会话日志就是模型看到的上下文的来源"。这份日志支持恢复（resume）、分支（fork）、搜索和重放，理论上可以拿同一份会话记录复现或者从中间某一步重新分叉出新的尝试。
和其他 Harness 的定位差异
拿本站已经收录的几个编程 Agent CLI 类比，DeepSeek Harness 的定位跟它们不完全在一条线上：
换句话说：Claude Code、Codex 是"官方给你一个成品工具"，OpenCode、Pi Agent 是"开源的成品级编程 Agent，产品形态基本定了、模型和部分能力可换"；DeepSeek Harness 更像是"官方给你一套搭 Agent 产品的插件内核"——它自己也能跑起来当一个能用的 Agent，但更本质的定位是给开发者一个可以拆开重新组装的运行时。选它的理由通常不是"我要立刻要一个稳定的日常编程助手"，而是"我想在插件层面深度定制 Agent 的会话、工具和运行方式"，同时要接受 developer preview 阶段的不稳定性。
社区插件生态一览
转载说明：本节转述整理自公众号「逛逛GitHub」文章《挖到 15 个宝藏插件，网友把 DeepSeek Harness 玩出了花。》（发布于 2026-08-21），不是官方文档内容，用自己的话转述整理，不是逐字照搬，具体功能和维护状态以各项目仓库为准。感谢原作者的梳理工作。配图未使用原文截图，改用各插件自己在开源许可证下发布的项目截图，来源见各图片下方说明。
DSH 的"everything is a plugin"架构催生了不少社区插件，覆盖从降低上手门槛的桌面客户端，到高阶操作能力，再到纯粹好玩的换皮肤项目。原文梳理了 15 个左右的代表性项目，按类型转述整理如下。
桌面客户端 / 一体化界面
不熟悉 Node.js、命令行的用户，可以直接用打包好的桌面客户端：dsh-desktop、deepseek-harness-desktop 都把 DSH 的 Web 界面、本地服务和插件系统打包成了 Windows/macOS 安装包，内置社区插件市场，下载安装即可用，适合第一次接触 DSH 的用户。
如果不想装桌面端、只想在浏览器里把常用插件一次装齐，dsh-web-ui-all 把任务看板、Git 记录、实时统计、远程访问等 Web 插件打成了一个全家桶，也支持只挑一两个单独装。
进阶操作能力
换皮肤类
社区最热闹的一类是纯外观/交互体验向的插件，一般不改变模型能力本身：dsh-deep-whale（深海蓝界面+双女仆角色，非商业许可证）、dsh-qq2006（复刻 2006 年 QQ 界面）、tonghuashun-webui（把 Token 用量做成同花顺风格的股票行情图）、dsh-deepcel（把 DSH 排成 Excel 表格样式）、dsh-emoji（把回复里的 Emoji 换成自定义表情包）。想要更活泼的使用体验可以按喜好挑一个装；其中 dsh-deep-whale、tonghuashun-webui、dsh-deepcel 三个项目仓库未声明开源许可证（原文也提到 dsh-deep-whale 采用非商业许可证），本节不配图，只做文字介绍。
早于 DSH、后来适配的项目
还有三个项目原本服务于更广泛的 AI Agent 生态，DSH 发布后追加了适配插件：OpenViking（字节跳动开源，给 DSH 配长期项目记忆，支持搜索/补充/删除）、Hindsight（约 2 万 Star，从聊天记录和 Git 提交里整理项目知识库，Claude Code、Codex 等多个编码工具可共用）、ModLens（把截图先转成文字/布局描述再交给纯文本模型分析，适合报错截图排查和网页结构说明）。
官方资料来源
本文核心信息来自以下官方渠道，如遇内容更新以官方原文为准：
「社区插件生态一览」一节转载整理自：
需要提醒：GitHub 上还存在另一个同名但完全无关的个人项目（一套面向 DeepSeek API 协议适配的诊断工具集），本文只涉及 DeepSeek 官方组织 deepseek-ai 名下的这一个仓库，使用时注意区分。