Docker 部署运维 PaiMonCai/dsh-docker-install

DSH Docker

部署 DSH。做可复现研究。

这是一个 Docker 发行与运维项目，面向 DeepSeek Harness。它不 fork DSH Core，而是把官方 npm 包稳定地封装成可安装、可更新、可持久化、可反代的容器，并在此基础上提供可选的 Research Edition。

版本来源保持单一：基础 DSH 版本见 Dockerfile 的 DSH_VERSION，Research 引擎自身版本见 research/VERSION（写入镜像并记录到每次运行，不参与镜像 tag）。研究镜像的发布 tag 跟随它实际包住的 DSH 版本。

你应该用哪个版本

| 版本 | 镜像标签 | 适合 |
| Standard | :latest / :<dsh版本> / :alpha·:next | 日常 DSH Agent、Web UI、开发环境 |
| Research Core | :research / :research-<dsh版本> / :research-alpha | 一般科研、文献、数据、可复现分析 |
| Research Economics | :research-economics / :research-economics-<dsh版本> / :research-economics-alpha | 经济学、计量、DiD / Event Study |

关系始终是：

DSH Standard
└─ Research Core
└─ Economics Pack

快速开始

推荐直接运行安装器：

curl -fsSL https://raw.githubusercontent.com/PaiMonCai/dsh-docker-install/main/install.sh | bash

安装完成后使用：

dshd

常用命令：

dshd status
dshd logs
dshd update
dshd restart
dshd token
dshd shell
dshd mounts show
dshd mounts add /opt/dsh/ssh /root/.ssh
dshd proxy setup
或查看现有配置 dshd proxy status dshd doctor

切换 Research：

dshd edition research
dshd research-pack economics

回到 Standard dshd edition standard

安装器与 dshd 菜单对每一步都做了错误隔离：某一步失败只会提示原因并回到菜单，不会中途退出脚本；已填写的配置在拉取镜像之前就会落盘，网络恢复后继续即可。
菜单里 Ctrl-C 只取消当前操作，0 / Ctrl-D 才退出。

完整安装、访问、反向代理、持久化和 API 配置见 部署与访问，交互行为细节见 Runtime 与运维。

Standard 提供什么

Standard 镜像主要解决 DSH 的运行和管理问题：

- 官方 DSH npm 包的 Docker 化；
- Web / headless / sdk / acp 等 profile 入口；
- 持久化 DSH_HOME、工作区，并支持自定义目录挂载（如 /root/.ssh）；
- Trusted Hosts、Token URL 和反向代理适配；
- Remote Settings；
- Chromium / Playwright；
- Node / Python / Go / Docker CLI 开发环境；
- 可选宿主机 Docker Socket 管理；
- 国内网络构建镜像源适配；
- 可选 sing-box sidecar 国际网络出口，支持 HTTP / SOCKS、VLESS、Trojan、Hysteria2、Shadowsocks 分享链接、订阅刷新、节点测速与 URLTest 自动故障切换；
- dshd 安装、更新、备份、恢复和诊断。

详细运行时说明见 Runtime 与运维。

自定义模型推理等级

镜像内置一个轻量 DSH Web 扩展，用于补齐自定义模型的 reasoningEfforts 编辑能力。

Models 页面 ↓ 声明模型支持哪些 reasoningEfforts ↓ DSH 原版 Composer 读取并提供推理等级选择

Models 页仍通过 DSH 官方 Settings API 保存；Composer 保持 DSH 原生的“模型 / 推理等级”交互，不做 DOM 替换。

详细设计、兼容边界和 max → xhigh 等映射方式见 自定义模型推理等级。

Research Edition

Research Edition 不是第二套 DSH，也不是“自动写论文”的独立平台。它是在 Standard 镜像上增加可复现研究能力：

Dataset
↓
Pipeline
↓
Run
↓
Result
↓
Artifact
↓
Paper

普通用户主要通过 DSH Agent 使用 Research 工具；底层 research-* CLI 继续作为稳定协议、CI 和调试入口。

Economics Pack 额外提供 Python-first 的计量工具，包括固定效应、IV、DiD、Event Study、经济数据获取和结果注册。

完整 Research Engine、Dashboard、Economics Pack、V2 架构与 RC Gate 见 Research Edition。

镜像

GHCR：

ghcr.io/paimoncai/dsh-docker-install:latest
ghcr.io/paimoncai/dsh-docker-install:<dsh版本> ghcr.io/paimoncai/dsh-docker-install:alpha ghcr.io/paimoncai/dsh-docker-install:next ghcr.io/paimoncai/dsh-docker-install:research ghcr.io/paimoncai/dsh-docker-install:research-<dsh版本> ghcr.io/paimoncai/dsh-docker-install:research-alpha ghcr.io/paimoncai/dsh-docker-install:research-economics ghcr.io/paimoncai/dsh-docker-install:research-economics-<dsh版本> ghcr.io/paimoncai/dsh-docker-install:research-economics-alpha

三类 tag 各有分工：

:<dsh版本> 锁定到具体 DSH 版本 :latest 始终跟随最新一次构建（含 alpha / rc 预发布） :alpha :next 与上游 npm dist-tag 同名，跟随上游发布通道

自动更新链路不仅会重建 :<dsh版本> 与 :latest，还会把指向该版本的
npm dist-tag 通道名原样打到镜像上，于是

docker pull <image>:alpha ≈ npm i @deepseek-ai/dsh@alpha

查询上游失败或版本不对应任何通道时，只发布版本号与 :latest，不让构建失败。

Research 镜像用同样的三类含义，只是加上 edition 前缀（:research / :research-economics 是浮动 tag，相当于研究镜像的 :latest），且版本 tag 跟随 它实际包住的 DSH 版本：:research-<dsh版本>、:research-alpha。
research/VERSION 只标识研究引擎自身版本，不参与镜像 tag。

基础镜像更新后，CI 会先发布 Standard，再把这次发布的精确镜像 digest传给 Research 构建，避免 Research 继续基于旧的 :latest；同时把解析到的通道名一并传入，让两类镜像的通道 tag 始终一致。

构建、GHCR、镜像 tag 通道对齐与自动检测上游 DSH 更新的说明见 镜像构建与自动更新。

文档

详细说明已经从根 README 拆出：

- 文档索引
- 部署与访问
- Runtime 与运维
- 国际网络出口 / sing-box
- 自定义模型推理等级
- 镜像构建与自动更新
- Research Edition

安全边界

默认部署只应把 DSH Web 暴露给受控网络或 HTTPS 反向代理。启用宿主机 Docker Socket 后，容器基本拥有宿主机 root 级 Docker 控制能力，应只在明确需要时开启。

Research Dashboard 默认是只读工作流视图，不应直接裸露到公网。

更多安全和运行时说明见 Runtime 与运维。

项目原则

这个仓库的边界保持简单：

DSH Core → 上游负责 Docker / dshd → 本仓库负责 Research Engine → 可选扩展 UI compatibility → 尽量走官方扩展点 runtime state → 始终由 DSH 自己拥有

不为了“方便”维护第二套 DSH 状态，不把 UI 适配描述成安全沙箱，也不让 Research 层反向接管 DSH Core。