简体中文 · English

Oh-DSH

一套 DSH runtime，多种可独立安装的交互方式。

Oh-DSH Desktop

Oh-DSH 把 DeepSeek Harness、Node.js 和本地能力打包成可安装的 Desktop、 Web 与 TUI 发行版。模型仍运行在云端；Oh-DSH 负责 Workspace、终端、 Git Review、浏览器、窗口集成和插件生命周期。 ## 🎉 官方收录 Oh-DSH 已进入 DeepSeek Harness 官方社区展示。终端端基于同样获得社区认可的 [dsh-TUI](https://github.com/ccch1mneyyy/dsh-TUI) 上游插件，并保留完整署名。

DeepSeek Harness 官方社区展示

## 下载与安装从 [GitHub Releases](https://github.com/hust-open-atom-club/oh-dsh/releases/latest) 选择需要的发行形态： | 发行形态 | 包含内容 | 适合场景 | | --- | --- | --- | | 完整版 | **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 包解压后即可启动： ```sh tar -xzf oh-dsh-web-*.tar.gz cd oh-dsh-web-*/ ./bin/ohdsh web ``` 默认地址是。Windows 使用： ```bat bin\ohdsh.cmd web ``` TUI-only 包同样解压即用： ```sh tar -xzf oh-dsh-tui-*.tar.gz cd oh-dsh-tui-*/ ./bin/ohdsh tui ``` ### 安装统一命令 macOS 完整版可将应用内的启动器加入 `PATH`： ```sh sudo ln -sf \ "/Applications/Oh-DSH Desktop.app/Contents/Resources/bin/ohdsh" \ /usr/local/bin/ohdsh ``` Web-only 与 TUI-only 包可直接运行 `./bin/ohdsh`，也可以把它加入 `PATH`。 ## 启动方式 ```sh ohdsh desktop # 启动 Oh-DSH Desktop ohdsh web # 启动 Oh-DSH Web ohdsh tui # 启动 Oh-DSH TUI ``` 使用 `ohdsh web --help` 或 `ohdsh tui --help` 查看对应选项。 ## 从源码运行需要 Node.js、pnpm 和平台构建工具： ```sh 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`。

更多界面

### 插件市场 ![Oh-DSH 插件市场](./assets/oh-dsh-plugin-marketplace.png) ### Oh-DSH 皮肤 ![Oh-DSH 跨界面皮肤](./assets/oh-dsh-desktop-skins.png)

## 文档 - [设计与插件边界](./docs/design.md) - [安装、操作与排错](./docs/usage.md) ## 上游依赖 | 上游仓库 | Oh-DSH 中的用途 | | --- | --- | | [DeepSeek Harness](https://github.com/deepseek-harness/deepseek-harness) | DSH runtime、会话与插件加载器 | | [dsh-TUI](https://github.com/ccch1mneyyy/dsh-TUI) | **Oh-DSH TUI 的直接上游插件**，提供终端渲染、交互和命令体系 | | [DSH-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar) | Git Review、文件与 PTY Host 能力 | `dsh-TUI` 以固定提交的 Git submodule 存放在 `upstream/dsh-TUI`。 Oh-DSH 保留其上游实现与署名，并负责 `ohdsh tui` 启动器、`~/.ohdsh` 数据隔离、统一标题、跨端皮肤及发行打包。详细边界见设计文档。 ## License [MIT](./LICENSE)