前言¶

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