前言¶

DeepSeek Harness（dsh）的核心理念是「一切皆插件」：模型、工具、会话、界面都可以替换。实际落地时，很多人要单独装 Node、配 profile、再一个个加 TUI 渲染器、侧边栏、皮肤、插件市场——环境凑齐之前，智能体还没跑起来。

Oh-DSH 走的是另一条路：把 DeepSeek Harness、Node.js runtime、本地开发工具和一批内置插件打成可安装发行版，用同一个 ohdsh 命令在 Desktop、Web、TUI 之间切换。它由 hust-open-atom-club（华中科技大学开放原子开源俱乐部）维护，MIT 许可，社区目录归在「客户端」。截至 2026 年 8 月 25 日查阅，GitHub 仓库约 270 星、21 forks，当前发行版本为 0.1.9。

需要先说清楚：DeepSeek Harness 本身仍是 developer preview，接口可能不兼容地变动。Oh-DSH 在 SkillHub 插件库 有收录，但该站点是社区独立索引，与 DeepSeek / 幻方没有官方从属关系，不要把它当成官方应用商店。Oh-DSH 也不是用 dsh plugin add 往现有 Harness 里挂一个包——它是一套独立的 runtime 发行版，数据目录默认在 ~/.ohdsh，与 ~/.dsh 分开。

这是什么¶

一句话定位：Oh-DSH 是把 DSH 工作台打包成可安装应用的客户端发行版，覆盖桌面应用、浏览器和终端三种交互形态。

仓库地址是 hust-open-atom-club/oh-dsh，项目主页 dsh.openatom.club。模型推理仍可按需走云端；Workspace、PTY 终端、Git Review、浏览器、文件浏览、会话与插件状态由本地工作台统一组织。三种 surface 共享会话、凭据、皮肤与插件缓存，同时保留独立 Profile。

设计文档写得很直白：ohdsh 只负责选择交互形态，运行时能力继续由 DSH Profile 和 Loader 管理，不会引入第二套插件系统。

核心功能¶

仓库 README 与设计文档（docs/design.zh.md）对得上的能力如下。

1、三种交互界面。用同一个 ohdsh 启动 Desktop（Electron）、Web（HTTP）或 TUI（终端）。完整版三端都有；也可以只装 Web-only 或 TUI-only，按需去掉 Electron。

2、本地开发工作台。内置 Workspace、PTY 终端、浏览器、文件浏览、Side chat 与 Trajectory；面板可折叠、固定、分屏或全屏。Desktop 侧栏能力跟踪上游 DSH-better-sidebar，TUI 渲染跟踪 dsh-TUI，Oh-DSH 在上游之上做统一启动器、布局、主题和发行打包。

3、Git Review。查看工作区改动与 commit diff，在代码行上加 review comment，同一侧边栏完成分支、提交和推送。

4、插件市场。Desktop、Web、TUI 都能检索、预览和安装插件，共享同一套安装事务与恢复状态。目录会标明插件实际生效的界面——有些插件只在 Web 或 Desktop 生效，TUI 不生效，界面上会明确区分。

5、跨端皮肤。@oh-dsh/skins 为三端提供统一主题 ID，分别适配 Web/Desktop CSS 与 TUI 调色板。

6、内置视觉工具。@oh-dsh/vision 在三端提供同一个 view_image 工具，对 Workspace 内本地图片、HTTP(S) 图片或 image data URL 做 OCR、读图与界面诊断；凭据可在「设置 → 插件 → Vision」里配置。

7、自带 runtime。每种发行都捆绑固定版本的 DSH 与 Node，不要求事先单独安装运行环境。安装器在改动旧安装前会校验 Release 的 SHA-256 摘要，下载失败或摘要不匹配会保持原安装可用。

安装与启用¶

Oh-DSH 的安装入口是仓库根目录的 install.sh（Linux / macOS）和 install.ps1（Windows），不是 dsh plugin add。SkillHub 目录页与 GitHub README 都指向这套安装器。

Linux 与 macOS，默认安装 TUI 并把 ohdsh 注册到 ~/.local/bin：

curl -fsSL \
  https://raw.githubusercontent.com/hust-open-atom-club/oh-dsh/main/install.sh \
  | bash

需要 Web 或 Desktop 时显式指定 surface：

curl -fsSL \
  https://raw.githubusercontent.com/hust-open-atom-club/oh-dsh/main/install.sh \
  | bash -s -- --surface web

curl -fsSL \
  https://raw.githubusercontent.com/hust-open-atom-club/oh-dsh/main/install.sh \
  | bash -s -- --surface desktop

Windows（PowerShell 5.1+，默认同样装 TUI）：

irm https://raw.githubusercontent.com/hust-open-atom-club/oh-dsh/main/install.ps1 | iex

管道执行远程脚本等于在本机跑外来代码。安装前应检查 源代码仓库 和 MIT 许可证；需要可复现安装时，用 --version 固定 Release 标签，例如 --version v0.1.9。

也可以从 GitHub Releases 手动下载：完整版含 Desktop + Web + TUI；Web-only 不含 Electron；TUI-only 容量最小，适合 SSH 与纯终端环境。macOS 拖 DMG 到 Applications，Linux 跑 AppImage 或 apt install deb，Windows 跑 NSIS 安装包。

安装完成后新开一个终端（Windows 开新 PowerShell），用统一命令启动已安装的界面：

ohdsh tui              # 终端界面
ohdsh web              # Web 界面
ohdsh web --port 3080  # 指定 Web 端口
ohdsh desktop          # Desktop 应用（gui 是别名）

ohdsh 只会启动已经安装的 surface；重复执行安装器且版本不变时为无操作，加 --force 可强制重装，--uninstall 按 surface 卸载。Web 与 TUI 可以并行安装，共享的 ohdsh 启动器会把子命令路由到对应载荷。

典型用法¶

三端默认共用 ~/.ohdsh 存放缓存、配置、会话、凭据与插件状态。要换数据目录，设置环境变量 OH_DSH_HOME：

export OH_DSH_HOME=/tmp/my-ohdsh
ohdsh web

日常开发最常见的路径：

1、装完整版或 Desktop surface，执行 ohdsh desktop，在图形界面里打开 Workspace、终端和 Git Review。

2、服务器或轻量环境只装 Web-only，执行 ohdsh web --port 3080，浏览器访问打印出来的地址。

3、SSH 远程只装 TUI-only，执行 ohdsh tui；需要 alternate screen 时加 --fullscreen。

4、在任意 surface 的插件市场里检索、预览、安装社区插件；安装事务支持隔离预览和风险确认，和人类 UI 走同一套流程。

5、升级已打包的 web/tui 发行版：ohdsh update（或 ohdsh update web / ohdsh update tui），会重新走安装脚本的校验与原子替换。Desktop 通过自带更新器检查 Release。

内置 Agent preset 里有一个 liangshen（梁神模式）：首轮保持 Minimal 双工具，首次工具调用后开放完整工具目录。Web/Desktop 在设置页选，TUI 输入 /preset liangshen。

从源码跑开发版需要 Node.js、pnpm 和平台构建工具，README 里有 git submodule update --init --recursive、pnpm run build:dsh、make tui 等步骤；普通用户走安装器即可。

适用场景与注意事项¶

适合谁：

1、想快速拿到完整 DSH 工作台，不想自己拼 Node、profile 和一堆 UI 插件的人。

2、需要在桌面、浏览器、终端之间切换，又希望会话和插件状态尽量共享的开发者。

3、看重 Git Review、侧边栏文件/终端、插件市场一体化体验，愿意用 Oh-DSH 打包好的上游组合（better-sidebar、dsh-TUI、vision 等）的人。

4、服务器或 CI 只想跑 Web/TUI、不要 Electron 的场景，可以只装对应 surface。

使用前还有几条边界：

1、独立数据目录。Oh-DSH 默认用 ~/.ohdsh，不是 ~/.dsh。已有 Harness 安装的用户，插件和 profile 不会自动迁移；若要在 Oh-DSH Desktop 里加载别的插件，需按各插件 README 把 DSH_HOME 指到 ~/.ohdsh 下对应 profile。

2、插件以当前进程权限运行。安装器会下载并解压 Release 资产，插件市场安装也会执行代码。安装前检查源码与 MIT 许可证；能固定版本就固定。

3、只支持已安装的 surface。没装 Desktop 时 ohdsh desktop 不会 magically 出现，需先跑带 --surface desktop 的安装器或下完整版 Release。

4、平台支持。官方支持 macOS、Linux、Windows（x64；macOS 另有 arm64）。Linux Desktop 走 AppImage 或 deb；macOS 未公证构建首次可能要在 Finder 里右键「打开」。

5、DeepSeek Harness 仍在 preview。Oh-DSH 捆绑固定版本 DSH，升级 Oh-DSH 不等于单独升级系统里的 dsh CLI；两者可以并存，数据目录也分开。

6、社区目录仅供参考。SkillHub 与 GitHub 星标会变动，以仓库 README 和 Release 页为准。

小结¶

Oh-DSH 把 DeepSeek Harness 从「自己拼环境」变成「下载就能用」：一个 ohdsh 命令切换 Desktop、Web、TUI，自带 Node runtime、工作台、Git Review、插件市场和跨端皮肤。它是 hust-open-atom-club 维护的 MIT 开源客户端发行版，不是 DeepSeek 官方产品，也不是往现有 dsh 里 plugin add 的普通插件。

目录页：https://www.skillhub.cn/plugins/hust-open-atom-club/oh-dsh

GitHub：https://github.com/hust-open-atom-club/oh-dsh