从安装到多 Agent,
把 DSH 真正用起来
DeepSeek Harness(DSH)是 DeepSeek AI 开发、用于连接模型、工具和多个 Agent 的开源任务编排框架;52DSH 是独立中文社区,提供中文教程、插件目录、配置排障和可复现案例,不是 DeepSeek Harness 官方网站。
DeepSeek Harness v0.2.2-rc.4 已发布
这是 GitHub 预发布版;精确包已发布到 npm。npm 默认安装版本为 0.2.2-rc.1,仍属候选版。旧教程保留各自的适用版本,升级前先核对 Session 格式、插件接口与数据备份。
据官方 Release 说明,0.2.2-rc.4 是修复版:改进模型请求收到异常消息响应时的处理,并修复桌面端 LiveShare 无法创建分享的问题。此前 rc.3 新增实验性“DeepSeek 会话导入”插件并修复 Windows 桌面版应用内更新;rc.2 把网页搜索默认改为 DeepSeek Search API、归档会话默认清理符合条件的 Git 工作树(保留分支与提交)、AgentTeam 改用统一的具名子代理。rc.4 精确包在 npm 的 next 通道,npm latest 仍为 0.2.2-rc.1,本站默认命令不变;本站尚未按固定源码复核这些变化。
默认安装切到 0.2.2-rc.1
npm latest 与 next 已指向 0.2.2-rc.1,未锁版本的 npx 也会取得它。它要求 Node.js ≥24.9.0;Node 22 环境先升级,或继续显式使用 0.2.1-rc.5。
dsh-TUI 0.18.0 会被拒绝加载
本站固定版本中,dsh-TUI 0.18.0 的 DSH peer 只列到 rc.5,作者尚无新版;其余 7 个通过声明检查,但插件接口有破坏性调整,不代表能加载。
先读后改防护关闭,抓取可访问内网
文件修改防护默认关闭;缺少凭据时模型拿不到 Web 搜索工具;默认网页抓取不再拦截本机与内网地址,共享部署需自行限制网络。
版本判断:11 月 6 日核对,npm latest 已改为 0.2.2-rc.1,本站默认命令随之切换;它要求 Node.js ≥24.9.0,Node 22 环境需先升级,或继续显式使用 0.2.1-rc.5。本站仅核对官方 Release、npm 包和固定源码,未运行 DSH 或第三方插件;升级前先看Node、插件与 Profile 检查,接口和官方组合包细节见0.2.2-rc.1 变化说明。从 0.1.5 升级仍须先确认 V4 会话和模型 protocol 字段,见备份与回退条件。
本周新增与复核内容
按真实发布日期汇总教程、插件审阅、排障内容和官方版本跟踪,不用更新时间制造虚假新鲜度。
如何阅读 52DSH 插件目录的验证标签
理解社区收录、编辑验证、可能过期和已停用标签,以及安装插件前必须检查的权限、依赖与许可证。
DSH 桌面端安装与使用:下载、更新、插件、数据与卸载
在 macOS 或 Windows 安装 DeepSeek Harness 桌面端,弄清它和 npx Web 版共用哪些数据,配置 API Key、更新、插件与 dsh 命令,并安全卸载、按需清理数据。
来源复核 →DeepSeek Harness 3080 端口占用:修改端口与 Host 限制
解决 DSH Web UI 默认 3080 端口占用,提供 Windows、macOS、Linux 只读检查命令、--port 修复、验证与回滚方法。
来源复核 →DSH 升级后会话打不开:迁移失败、未知事件与恢复排查
区分 DSH 升级后旧会话迁移失败、新会话没反应、预设 prefix 缺失与 0.1.7-rc.1 会话被占用,按 provenance 等错误分流,提供备份边界和可复制的脱敏故障记录。
来源复核 →DSH 生成的文件在哪里:预览、打开与交付文件指南
说明 DSH 文件上传、侧栏预览与交付方式,按 Safari Iterator、文件资源服务不可用、路径和权限分流排查,区分 Host 打开与浏览器下载。
来源复核 →你现在想用 DSH 做什么
不需要先理解全部概念,直接进入最接近当前问题的入口。
第一次安装 DSH
从 Node.js 检查开始,启动 Web UI,再完成 Workspace 与模型验证。
更新或卸载 DSH
按安装方式操作,先确认备份与回退条件,分别处理程序、插件和数据。
DSH 启动失败或报错
按错误原文、Node 环境、端口和 Workspace 定位原因。
DSH 工作权限怎么选
按任务范围选择权限,区分沙箱与审批,定位写入失败的原因。
查找并配置插件
按实际任务筛选插件,核对中文安装、权限和兼容性。
构建多 Agent 工作流
学习任务拆分、并行执行、独立复核和结果汇总。
把常见问题直接解决
从安装、模型配置到 Headless 和多 Agent,进入可以实际执行与验收的中文内容。
从零安装并运行 DeepSeek Harness
准备 Node 环境、启动 Web UI,完成第一次 Session。
查看步骤 →模型与凭据配置 Provider、模型和服务凭据
理解配置位置、凭据边界和模型连接验证。
查看步骤 →启动失败从环境到端口排查 DSH Web UI
处理 Node、端口占用、Workspace 和 Web UI 启动问题。
查看步骤 →Headless运行一次性 Agent 任务
检查任务输出、退出码、Session 持久化和权限边界。
查看步骤 →更新维护更新、回退与卸载 DSH
按安装方式维护程序,分别处理 Profile 插件、备份与数据保留。
查看步骤 →多 Agent用 DSH 编排实现与独立复核
让主 Agent 派发任务,并汇总代码、测试和风险证据。
查看步骤 →按能力找插件,也看清权限
直接进入对应主题,比较中文功能说明、安装方式、兼容版本、外部依赖和风险边界。
模型与 Provider
接入模型、API 与本地推理服务
配置与兼容性Skills 与 MCP
扩展搜索、数据库和外部业务能力
权限与依赖记忆与会话
管理上下文、Session 和持久记忆
隐私与存储工作流与通知
组合自动化任务并接收运行结果
触发器与审计收录不等于安全认证
详情页会区分官方来源、清单核验、源码审阅和运行实测,并公开权限与风险。
主 Agent 派发任务,子 Agent 返回证据
主 Agent 统一保存目标、上下文和验收条件;Codex、Claude Code 或工具并行执行,分别返回代码、测试、风险清单和结构化数据,再由主 Agent 验收汇总。
查看完整协作案例 →- 01派发目标、必要上下文、权限和验收条件
- 02并行执行代码实现、独立审查和工具调用
- 03返回证据测试结果、风险清单和结构化数据
- 04验收汇总主 Agent 检查差异并统一输出
获取更新,也可以复用公开数据
通过 RSS、JSON Feed 和机器可读内容索引跟踪教程与插件变化;插件事实数据同时维护在开源注册表中。