从安装到多 Agent，
把 DSH 真正用起来
DeepSeek Harness（DSH）是 DeepSeek AI 开发、用于连接模型、工具和多个 Agent 的开源任务编排框架；52DSH 是独立中文社区，提供中文教程、插件目录、配置排障和可复现案例，不是 DeepSeek Harness 官方网站。
DeepSeek Harness v0.2.2-rc.2 已发布
这是 GitHub 预发布版；复核时精确版本尚未发布到 npm。npm 默认安装版本为 0.2.2-rc.1，仍属候选版。旧教程保留各自的适用版本，升级前先核对 Session 格式、插件接口与数据备份。
据官方 Release 说明，0.2.2-rc.2 的主要变化：网页搜索默认改用 DeepSeek Search API，旧提供方和自定义配置需按升级指南调整；归档会话默认清理符合条件的 Git 工作树（保留分支与提交）；AgentTeam 改用统一的具名子代理，自定义插件与 SDK 集成需要迁移；桌面端可在设置中切换正式版与开发版更新渠道。本站尚未按固定源码复核这些变化，进入 npm 前不改默认命令。
默认安装切到 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 字段，见备份与回退条件。
本周新增与复核内容
按真实发布日期汇总教程、插件审阅、排障内容和官方版本跟踪，不用更新时间制造虚假新鲜度。
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 Web UI 输入框不可用：先选择 Workspace
按未添加、未选中、选择报错与任务失败四种状态排查 DSH 工作区；保留 rc.1 操作，补充 0.1.7-alpha.1 首次默认工作区的触发条件。
来源复核 →你现在想用 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 和机器可读内容索引跟踪教程与插件变化；插件事实数据同时维护在开源注册表中。