deepseek-harness-docker

DeepSeek Harness Docker

English | 简体中文

DeepSeek Harness（DSH）以本地使用为中心，桌面版也延续了这一形态。企业内部推进 Agent 化，需要把运行环境部署到云上，按任务创建实例、动态分配资源，并支持快速迭代。云上运行、动态供给、快速迭代，是企业内部 Agent 化的基础。

本项目将官方 DSH npm 发行物封装为可复现的 Docker 运行环境，为通过 Kubernetes 部署和管理独立的 Agent 实例提供基础。默认提供 Web UI、非 root 的 Node.js 24 运行时与可视 Chromium/noVNC 桌面，可选插件市场和受保护局域网入口，不修改 DSH 源码。

DeepSeek Harness 最早一批非官方 Docker 镜像项目之一，自 2026 年 8 月 13 日 起持续维护。 提供 Docker Hub / GHCR 双架构镜像、Docker Compose、Rootless Podman 和 Helm 部署，持续跟进官方版本。 当前基线：@deepseek-ai/dsh@0.2.2-rc.1。DeepSeek Harness 仍处于预发布阶段；升级前应重新完成本文的构建和 Smoke Test。

0.2.2-rc.1 直接对应官方 dsh-v0.2.2-rc.1 Release 与 npm Registry 的 @deepseek-ai/dsh@0.2.2-rc.1，并非本项目自定义版本。本项目封装 npm 成品而不从源码构建，因此以可安装的官方发行物为基线，并故意不发布漂移的 Docker latest 标签。

0.2.2-rc.1 新增插件更新、引用消息、完整会话 Markdown 复制和多语言界面，并改进手机操作、缓存与会话恢复。 0.2.2 迁移： 最低 Node.js 为 24.9；自定义插件需核对 Session 投影、工具执行和 PTC 接口。Web Fetch 允许内网地址，部署需自行限制出站网络；自定义模型应显式填写容量。升级前备份数据卷，降级使用旧卷备份。详见官方说明。 alpha.4 插件兼容性： 第三方插件声明的 engines.dsh 优先用于判断 DSH 版本兼容性；未声明时继续沿用原有规则。升级第三方插件时应核对其支持范围。 alpha.3 迁移提醒： Web / Desktop 优先使用已保存凭据；Headless 默认只读取环境变量和 .env，不再读取已保存密钥。旧 Azure provider 名称 azure-openai-responses 需迁移为 azure。--from-default-profile 重建已有自定义 Profile 会替换其插件和设置，升级现有实例时请保留原 Profile。详见官方更新说明。 升级提醒： 0.1.7-alpha.1 起 Session 日志为 V4。若从更早版本升级，必须先备份 dsh-home；依赖旧日志结构的工具需要适配 V4，降级前也应恢复升级前的卷备份，而不是让旧版直接读取已迁移数据。 兼容性提醒： 自定义 spill-policy 配置必须把 maxInlineBytes 改为按估算 Token 计数的 maxInlineTokens。内置 E2B 执行后端已移除，PTC 与 Workflow 服务已重命名；若从 0.1.7-alpha.1 以前升级，还需处理 Messages-only adapter、Profile-owned 设置、Bundle Agent Preset 和 Remote readBytes 迁移。详见官方 Release。 0.2.1 兼容性提醒： 自动化任务重新成为 Web 内置能力，旧实验组合包选择会自动清理但已有任务保留。运行时 invariant 插件及各包的 ./invariant 导出已移除；子路径插件不再读取独立 package.json；输入区原 stats 扩展拆为 activity 与 usage。依赖这些入口的自定义插件必须先适配。 0.2.1-alpha.2 及更早版本： 工具模式、Python PTC、Agent 指令与子代理接口需按迁移说明调整。本镜像保留回环端口与可选 Caddy LAN 入口。 上游版本跟踪：每日运行的 Upstream DSH version watch 会同时检查 GitHub Release 与 npm。若新版 Release 已发布但 npm 制品尚不可用，工作流会创建或刷新等待 Issue 并保

📖 延伸阅读：DeepSeek Harness GitHub 仓库深度解析 · Docker、Compose 与 Helm 部署实战

🤖 Agent Skill：根目录的 SKILL.md 已作为 deepseek-harness-docker 发布到腾讯云 SkillHub，可供支持 Agent Skills 的客户端安装和使用。它指导 Agent 按本项目的安全边界完成 Docker Compose/Helm 部署、验证、升级与排障；这是部署辅助 Skill，不是 DSH 运行时插件。

_浅色界面实拍（2026-11-05，DSH 0.2.2-rc.1）。使用独立空白演示工作区，不包含个人会话或凭据，未配置模型，也未发起模型调用。_ 项目状态 DeepSeek Harness 深入分析

本节是配套技术文章的精简版。Cordis 架构、Agent 轮次和事件溯源持久化见 GitHub 仓库深度解析；镜像设计、安全模型和容器验证矩阵见 Docker、Compose 与 Helm 部署实战。 它是什么，不是什么

DeepSeek Harness 不是 DeepSeek 模型权重或推理引擎，而是一套 TypeScript AI Agent Runtime。它把模型适配、会话、工具、权限、工作区、插件、Web UI 与 Headless 入口装配在一起，最终发布为 @deepseek-ai/dsh CLI。更合适的专题归类是“AI Agent Runtime 的云原生化”，而不是“LLM 推理部署”。