DeepSeek Harness Docker

English | 简体中文

DeepSeek Harness 最早一批非官方 Docker 镜像项目之一，自 2026 年 8 月 13 日 起持续维护。 提供 Docker Hub / GHCR 双架构镜像、Docker Compose、Rootless Podman 和 Helm 部署，持续跟进官方版本。

默认运行官方 @deepseek-ai/dsh 的 Web UI，将官方 npm 发行物装入非 root 的 Node.js 24 运行时，集成可视 Chromium/noVNC 桌面，并提供可选的插件市场和受保护局域网入口。镜像不修改 DeepSeek Harness 源码。

当前基线：@deepseek-ai/[email protected]。DeepSeek Harness 仍处于预发布阶段；升级前应重新完成本文的构建和 Smoke Test。

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

0.2.1-rc.3 新增左侧栏、会话和右侧栏的插件“更多”菜单，修复切换会话后的未发送草稿恢复，并统一 DeepSeek API Key 与账号登录的模型列表更新方式。镜像仍固定完整版本；Search / Fetch API 仍需按需开启。

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。依赖这些入口的自定义插件必须先适配。

alpha.2 迁移提醒： 工具展示模式移除 both，仅保留 native 与 ptc；自定义 Python PTC 组合需提供 sandbox 和 sandboxPolicy。agent-instructions 不再接受逐行 dshHome，应使用进程级 DSH_HOME；自定义子代理 SDK runtime 需支持 session/wait，Agent Team 的 outbox、重试和去重配置也需迁移。本镜像继续保留回环端口与现有 Caddy LAN 入口，不会因上游新增原生 HTTPS 而自动开放网络访问。详见官方更新说明。

上游版本跟踪：每日运行的 Upstream DSH version watch 会同时检查 GitHub Release 与 npm。若新版 Release 已发布但 npm 制品尚不可用，工作流会创建或刷新等待 Issue 并保留当前可安装基线；同版本 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-10-26，DSH 0.2.1-rc.3）。使用独立空白演示工作区，不包含个人会话或凭据，未配置模型，也未发起模型调用。

项目状态

…