付费项目 · DeepSeek Harness

DeepSeek Harness:把 dsh 装进容器长期跑

dsh 是 DeepSeek Harness 的启动器。这一页说明它怎么组织配置、容器化时要挂哪些卷、升级和回滚怎么做,以及哪些不在交付范围内。

dsh 是什么

DeepSeek Harness 的命令行程序叫 dsh。它不是单个“聊天窗口”,而是一个启动器:一个 profile 就是一组插件 bundle 的有序堆栈,外加你自己的补丁层。dsh web 起 Web profile,在浏览器里用;headless、sdk、acp 这些 profile 给脚本和自动化用。

profile、插件和补丁都放在 $DSH_HOME 下,默认是 profiles/<名字>/。package.json 记录用到的 bundle 和依赖,cordis.patch.yml 是你的覆盖层,再加 home 级补丁。插件用 dsh plugin --profile <名字> <pnpm 参数> 管,本质是转发给 pnpm。

手动跑起来不难。难的是让它长期稳定:重启后自己起来、升级不把插件搞坏、出问题能退回去。

为什么要容器化

  • 依赖锁在镜像里,换机器不用重装 Node 和 pnpm。
  • $DSH_HOME 和工作区挂成卷,重建容器不丢配置和会话。
  • 固定镜像版本,升级前可以留一个能回滚的旧 tag。
  • 给容器设 CPU、内存和重启策略,别让它把整台机器拖垮。

交付什么

  • 镜像或 Compose:固定 Node 版本和 dsh 版本,非 root 运行。
  • 卷:$DSH_HOME 挂出来,工作区单独挂;两个都要能备份。
  • 端口和入口:Web 端口只监听内网,前面接 Traefik 或 cloudflared,不直接晾在公网。
  • 密钥:模型 API key 和第三方凭据走环境变量或运行时的 secret,不写进镜像,也不进 git。
  • 插件:按你的需要装,记录版本范围和禁用项;升级前先确认 engines.dsh 范围。
  • 健康检查、重启策略和日志轮转。
  • 升级步骤:备份 $DSH_HOME、换镜像 tag、验证插件和 Web 能起、不行就回滚。
  • 一份验证清单:Web 能打开、插件加载正常、会话还在、重启后自动恢复。

不包含

  • 模型权重下载、推理性能调优和 GPU 驱动。
  • 修改 dsh 上游代码;确实要改的,单独谈范围。
  • 替你申请模型 API 额度或账号。
  • 7×24 值守。交付后日常重启和升级你自己能来。

安全上的几条

Web 界面默认不暴露到公网。要外网访问,就套一层 Access 或反向代理的认证,并且只走 HTTPS。容器用非 root,挂载只给需要的目录,尤其是 Docker socket 这种不要随手挂进去。密钥只从环境注入。

适合谁

已经在本地跑 dsh web 或 headless,想让它长期在线、换机器不折腾、升级有退路的人;或者准备给团队共用一套 Harness,需要固定版本和备份策略。

怎么开始

发邮件说明:现在怎么跑 dsh、用的哪个 profile、模型后端是什么、打算放在哪台机器、要不要外网访问。确认范围后给报价。

常见问题

不用容器行不行?

行。直接装在宿主机上更简单,但升级、回滚和依赖冲突都得自己扛。容器换来的是可重复。

数据都在哪?

profile、配置和会话在 $DSH_HOME,业务文件在工作区。把这两处备份好,换机器就是挂回去。

能接本地模型吗?

能,取决于 dsh 侧的 provider 配置。交付时会按你的后端(本地推理服务或 API)配好并验证。

升级会不会丢东西?

按流程先备份 $DSH_HOME 再换 tag;插件不兼容就退回旧镜像。交付时会一起验证一次。

相关

有问题就发邮件。纠错、提问或者聊项目,都发到 [email protected]。本页也有 Markdown 版本:/zh/services/harness.md。

不确定从哪开始?

先做一次资源评估,或者把配置和目标发到邮箱。回复会说范围合不合适、下一步要什么。