oh-dsh

<p align="center"> <strong>简体中文</strong> · <a href="./README.en.md">English</a> </p>

<div align="center"> <img src="./assets/dsh-whale.png" width="136" alt="Oh-DSH whale"> <h1>Oh-DSH</h1> <p><strong>一套 DSH runtime，多种可独立安装的交互方式。</strong></p> </div>

<p align="center"> <img alt="macOS" src="https://img.shields.io/badge/macOS-12%2B-111111?logo=apple&logoColor=white"> <img alt="Linux" src="https://img.shields.io/badge/Linux-x64-FCC624?logo=linux&logoColor=black"> <img alt="Windows" src="https://img.shields.io/badge/Windows-x64-0078D6?logo=windows&logoColor=white"> <img alt="MIT" src="https://img.shields.io/badge/license-MIT-34a853"> </p>

<p align="center"> <img src="./assets/oh-dsh-desktop-overview.png" alt="Oh-DSH Desktop" width="100%"> </p>

Oh-DSH 把 DeepSeek Harness、Node.js 和本地能力打包成可安装的 Desktop、 Web 与 TUI 发行版。模型仍运行在云端；Oh-DSH 负责 Workspace、终端、 Git Review、浏览器、窗口集成和插件生命周期。

🎉 官方收录

Oh-DSH 已进入 DeepSeek Harness 官方社区展示。终端端基于同样获得社区认可的 dsh-TUI 上游插件，并保留完整署名。

<p align="center"> <img src="./assets/oh-dsh-official-showcase.png" alt="DeepSeek Harness 官方社区展示" width="100%"> </p>

下载与安装

从 GitHub Releases 选择需要的发行形态：

发行形态	包含内容	适合场景
完整版	Oh-DSH Desktop、Web、TUI、Node runtime 和内置插件	本地开发工作台
Web-only	Oh-DSH Web、Node runtime 和内置 Web 插件，不含 Electron	轻量安装、浏览器或远程使用
TUI-only	Oh-DSH TUI、Node runtime 和终端插件，不含 Electron	纯终端环境

完整版按平台提供 DMG/ZIP、AppImage/deb 和 Windows 包。macOS 打开 DMG 后， 将 Oh-DSH Desktop 拖入 Applications；Linux 可直接运行 AppImage，或用 apt 安装 deb。

Web-only 包解压后即可启动：

tar -xzf oh-dsh-web-*.tar.gz
cd oh-dsh-web-*/
./bin/ohdsh web

默认地址是 http://127.0.0.1:3080。Windows 使用：

bin\ohdsh.cmd web

TUI-only 包同样解压即用：

tar -xzf oh-dsh-tui-*.tar.gz
cd oh-dsh-tui-*/
./bin/ohdsh tui

安装统一命令

macOS 完整版可将应用内的启动器加入 PATH：

sudo ln -sf \
  "/Applications/Oh-DSH Desktop.app/Contents/Resources/bin/ohdsh" \
  /usr/local/bin/ohdsh

Web-only 与 TUI-only 包可直接运行 ./bin/ohdsh，也可以把它加入 PATH。

启动方式

ohdsh desktop   # 启动 Oh-DSH Desktop
ohdsh web       # 启动 Oh-DSH Web
ohdsh tui       # 启动 Oh-DSH TUI

使用 ohdsh web --help 或 ohdsh tui --help 查看对应选项。

从源码运行

需要 Node.js、pnpm 和平台构建工具：

git submodule update --init --recursive
pnpm install
pnpm run build:dsh
pnpm run build
pnpm run stage:dsh
export PATH="$PWD/bin:$PATH"

ohdsh desktop
ohdsh web
ohdsh tui

打包完整版使用对应平台的 dist:mac、dist:linux 或 dist:win；只打包 Web 使用 pnpm run dist:web；只打包 TUI 使用 pnpm run dist:tui。

<details> <summary><strong>更多界面</strong></summary>

插件市场

Oh-DSH 皮肤

</details>

文档

• 设计与插件边界
• 安装、操作与排错

上游依赖

上游仓库	Oh-DSH 中的用途
DeepSeek Harness	DSH runtime、会话与插件加载器
dsh-TUI	Oh-DSH TUI 的直接上游插件，提供终端渲染、交互和命令体系
DSH-better-sidebar	Git Review、文件与 PTY Host 能力

dsh-TUI 以固定提交的 Git submodule 存放在 upstream/dsh-TUI。 Oh-DSH 保留其上游实现与署名，并负责 ohdsh tui 启动器、~/.ohdsh 数据隔离、统一标题、跨端皮肤及发行打包。详细边界见设计文档。

License

MIT