Skip to content
Back to search

oh-dsh

一套 DSH runtime,Desktop、Web 与 TUI 三种开发体验。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hust-open-atom-club--oh-dsh/badge.svg)](/listings/hust-open-atom-club--oh-dsh)

HTML

<a href="/listings/hust-open-atom-club--oh-dsh"><img src="/api/listings/hust-open-atom-club--oh-dsh/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 233 lines · 1 finding marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <strong>简体中文</strong> ·
  3. <a href="./README.en.md">English</a>
  4. </p>
  5. <div align="center">
  6. <img src="./assets/dsh-whale.png" width="128" alt="Oh-DSH whale">
  7. <h1>Oh-DSH</h1>
  8. <p><strong>一套 DSH runtime,Desktop、Web 与 TUI 三种开发体验。</strong></p>
  9. <p>把 AI Agent、Workspace、本地工具与插件生态带到你习惯的界面。</p>
  10. </div>
  11. <p align="center">
  12. <a href="https://github.com/hust-open-atom-club/oh-dsh/releases/latest"><img alt="GitHub release" src="https://img.shields.io/github/v/release/hust-open-atom-club/oh-dsh?display_name=tag&amp;sort=semver&amp;style=flat-square&amp;color=2f81f7"></a>
  13. <a href="https://github.com/hust-open-atom-club/oh-dsh/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/hust-open-atom-club/oh-dsh?style=flat-square&amp;color=f5a623"></a>
  14. <img alt="Desktop, Web and TUI" src="https://img.shields.io/badge/Desktop%20%7C%20Web%20%7C%20TUI-3b82f6?style=flat-square">
  15. <img alt="macOS, Linux and Windows" src="https://img.shields.io/badge/macOS%20%7C%20Linux%20%7C%20Windows-111827?style=flat-square">
  16. <a href="./LICENSE"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-34a853?style=flat-square"></a>
  17. </p>
  18. <p align="center">
  19. <a href="https://github.com/hust-open-atom-club/oh-dsh/releases/latest"><strong>下载最新版</strong></a>
  20. ·
  21. <a href="./docs/usage.zh.md">使用文档</a>
  22. ·
  23. <a href="./docs/design.zh.md">设计文档</a>
  24. </p>
  25. <p align="center">
  26. <img src="./assets/oh-dsh-surfaces.svg" alt="Oh-DSH 三种交互界面:Web、Desktop 与 TUI" width="100%">
  27. </p>
  28. Oh-DSH 将 DeepSeek Harness、Node.js、本地开发工具和内置插件打包为可安装的
  29. Desktop、Web 与 TUI 发行版。模型服务仍可按需运行在云端;Workspace、终端、
  30. Git Review、浏览器、文件、会话与插件状态由本地工作台统一组织。
  31. ## 主要能力
  32. <table>
  33. <tr>
  34. <td width="50%" valign="top">
  35. <h3>🖥️ 三种交互界面</h3>
  36. <p>使用同一个 <code>ohdsh</code> 命令启动 Desktop、Web 或 TUI。三端共享会话、凭据、皮肤与插件缓存,同时保留独立 Profile。</p>
  37. </td>
  38. <td width="50%" valign="top">
  39. <h3>🧰 本地开发工作台</h3>
  40. <p>内置 Workspace、PTY 终端、浏览器、文件浏览、Side chat 与 Trajectory;面板可以折叠、固定、分屏或全屏展开。</p>
  41. </td>
  42. </tr>
  43. <tr>
  44. <td width="50%" valign="top">
  45. <h3>🔍 Git Review</h3>
  46. <p>查看工作区改动与 commit diff,在代码行上添加 review comment,并在同一个侧边栏完成分支、提交和推送操作。</p>
  47. </td>
  48. <td width="50%" valign="top">
  49. <h3>🧩 插件市场</h3>
  50. <p>Desktop、Web 与 TUI 都能检索、预览和安装插件,并共享同一套交易与恢复状态。目录会标明插件实际生效的界面:安装可能在所有终端都成功,但某些插件只在 Web 或 Desktop 生效、在 TUI 不生效,界面上会明确区分。</p>
  51. </td>
  52. </tr>
  53. <tr>
  54. <td width="50%" valign="top">
  55. <h3>🎨 跨端皮肤</h3>
  56. <p><code>@oh-dsh/skins</code> 为 Desktop、Web 与 TUI 提供统一主题,并针对各界面的布局和可读性分别适配。</p>
  57. </td>
  58. <td width="50%" valign="top">
  59. <h3>📦 可拆分发行</h3>
  60. <p>按需安装完整版、Web-only 或 TUI-only。每种发行都自带固定版本的 DSH 与 Node runtime,不要求单独安装运行环境。</p>
  61. </td>
  62. </tr>
  63. </table>
  64. ## 下载与安装
  65. ### 首选:命令行安装
  66. Linux 与 macOS 使用仓库根目录的 `install.sh` 安装最新稳定版。默认安装
  67. TUI,并将 `ohdsh` 注册到 `~/.local/bin`;新开一个终端后即可使用:
  68. ```sh
  69. curl -fsSL \
  70. https://raw.githubusercontent.com/hust-open-atom-club/oh-dsh/main/install.sh \
  71. | bash
  72. ```
  73. 需要 Web 或 Desktop 时显式选择发行形态:
  74. ```sh
  75. curl -fsSL \
  76. https://raw.githubusercontent.com/hust-open-atom-club/oh-dsh/main/install.sh \
  77. | bash -s -- --surface web
  78. curl -fsSL \
  79. https://raw.githubusercontent.com/hust-open-atom-club/oh-dsh/main/install.sh \
  80. | bash -s -- --surface desktop
  81. ```
  82. Windows 使用仓库根目录的 `install.ps1`;不带参数时同样默认安装 TUI:
  83. ```powershell
  84. irm https://raw.githubusercontent.com/hust-open-atom-club/oh-dsh/main/install.ps1 | iex
  85. ```
  86. 安装完成后,通过统一命令启动已安装的界面:
  87. ```sh
  88. # 终端界面
  89. ohdsh tui
  90. # Web 界面
  91. ohdsh web
  92. # Desktop 应用
  93. ohdsh desktop
  94. ```
  95. `ohdsh` 只会启动已经安装的 surface;Desktop 的直接入口
  96. `oh-dsh-desktop` 仍然保留。Linux/macOS 如果当前终端还没有加载新的 PATH,
  97. 请重新打开终端;Windows 请使用新终端。
  98. 安装器在校验发布的 SHA-256 摘要之前不会触碰旧安装,下载失败、摘要不匹配
  99. 或解压中断都保持原安装可用;重复执行同一命令即为原地升级,
  100. `--uninstall` 按 surface 卸载。完整选项、环境变量与 surface 矩阵见
  101. [安装说明](./docs/usage.zh.md#使用-installsh-安装)。
  102. ### 从 GitHub Release 手动安装
  103. 从 [GitHub Releases](https://github.com/hust-open-atom-club/oh-dsh/releases/latest)
  104. 选择需要的发行形态:
  105. | 发行形态 | 包含内容 | 适合场景 |
  106. | --- | --- | --- |
  107. | 完整版 | **Oh-DSH Desktop**、Web、TUI、Node runtime 和内置插件 | 本地开发工作台 |
  108. | Web-only | **Oh-DSH Web**、Node runtime 和内置 Web 插件,不含 Electron | 浏览器、服务器或轻量安装 |
  109. | TUI-only | **Oh-DSH TUI**、Node runtime 和终端插件,不含 Electron | SSH 与纯终端环境 |
  110. - **macOS**:打开 DMG,将 **Oh-DSH Desktop** 拖入 Applications。
  111. - **Windows**:运行安装包,或解压便携版后启动。
  112. - **Linux**:直接运行 AppImage,或使用 `apt` 安装 deb。
  113. 安装脚本是推荐入口;Release 资产适合需要手动选择包或离线分发的场景。
  114. ## 使用
  115. ```sh
  116. ohdsh desktop # 启动 Oh-DSH Desktop
  117. ohdsh gui # Desktop 的启动别名
  118. ohdsh web # 启动 Oh-DSH Web
  119. ohdsh web --port 3080 # 指定 Web 端口
  120. ohdsh tui # 启动 Oh-DSH TUI
  121. ```
  122. 三端默认共同使用 `~/.ohdsh` 存放缓存、配置、会话、凭据与插件状态。
  123. 设置 `OH_DSH_HOME` 可以统一更换数据目录;运行 `ohdsh web --help` 或
  124. `ohdsh tui --help` 可以查看界面专属选项。
  125. 图片输入由 DSH 原生多模态模型(如 DeepSeek V4 Flash)直接处理:复制、粘贴、
  126. 缩略图与提交全部由原生 attachment rail 负责,无需额外的视觉桥接插件或单独的
  127. API Key。详情见[图片输入使用说明](./docs/usage.zh.md#图片输入)。
  128. <details>
  129. <summary><strong>从源码运行</strong></summary>
  130. 需要 Node.js、pnpm 和平台构建工具:
  131. ```sh
  132. git submodule update --init --recursive
  133. pnpm install
  134. pnpm run build:dsh
  135. pnpm run build
  136. pnpm run stage:dsh
  137. export PATH="$PWD/bin:$PATH"
  138. ohdsh desktop
  139. ohdsh web
  140. ohdsh tui
  141. ```
  142. 本地开发时,也可以用仓库根目录的 Makefile 快速启动指定交互端:
  143. ```sh
  144. make build
  145. make tui ARGS="--lang zh" # 只暂存并启动 TUI
  146. make web ARGS="--port 3080" # 只暂存并启动 Web
  147. make desktop # 只暂存并启动 Desktop
  148. ```
  149. `make tui` 默认使用 inline 模式,从当前终端光标位置继续渲染;需要
  150. alternate screen 时传入 `ARGS="--fullscreen"`。每个 Make 目标只会暂存
  151. 对应交互端的 Oh-DSH package,不会把其它交互端一起带入开发 runtime。Make
  152. 默认使用 `~/.ohdsh`,也可以覆盖:`OH_DSH_HOME=/tmp/ohdsh make tui`。
  153. Desktop、Web 和 TUI 共享同一组 Agent preset;其中 `liangshen`(梁神模式)会在
  154. 首轮保持 Minimal 双工具,首次工具调用后开放完整工具目录,压缩后重新锚定。
  155. Web/Desktop 可在设置页的 Agent preset 中选择,TUI 可输入 `/preset liangshen`。
  156. 打包完整版使用对应平台的 `dist:mac`、`dist:linux` 或 `dist:win`;只打包
  157. Web 使用 `pnpm run dist:web`;只打包 TUI 使用 `pnpm run dist:tui`。
  158. </details>
  159. <details>
  160. <summary><strong>更多界面</strong></summary>
  161. ### 插件市场
  162. ![Oh-DSH 插件市场](./assets/oh-dsh-plugin-marketplace.png)
  163. ### Oh-DSH 皮肤
  164. ![Oh-DSH 跨界面皮肤](./assets/oh-dsh-desktop-skins.png)
  165. </details>
  166. ## 文档
  167. - [安装、操作与排错](./docs/usage.zh.md)
  168. - [架构设计与插件边界](./docs/design.zh.md)
  169. ## 插件推荐
  170. | 推荐项目 | 说明 |
  171. | --- | --- |
  172. | [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) | DSH runtime、会话与插件加载器 |
  173. | [dsh-TUI](https://github.com/ccch1mneyyy/dsh-TUI) | **Oh-DSH TUI 的直接上游插件**,提供终端渲染、交互和命令体系 |
  174. | [DSH-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar) | Git Review、文件与 PTY Host 能力 |
  175. | [dshfind](https://dshfind.com/) | DSH 插件超市与学习社区,提供插件、生态与 DeepSeek Harness 周边推荐 |
  176. Oh-DSH 保留上游实现与署名,并在其上提供统一启动器、Profile、数据目录、
  177. 跨端皮肤、界面适配和发行打包。详细边界见[设计文档](./docs/design.zh.md)。
  178. ## License
  179. [MIT](./LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.