hust-open-atom-club/oh-dsh
一套 DSH runtime,Desktop、Web 与 TUI 三种开发体验。
Listed
247
Dev
Bundle verified
What it does
Community distribution: TUI, desktop, and Web UI as one bundle with layered installation.
Best for
- Users who want Desktop, Web, and TUI experiences backed by one packaged DSH runtime.
- Teams that want sessions, credentials, themes, and plugin state shared across interfaces while retaining separate profiles.
- Users seeking a ready-to-run full, Web-only, or TUI-only distribution with Node bundled.
Not ideal for
- Users who only need one small plugin added to an existing official DSH installation rather than a separate community distribution.
- Workflows requiring every installed plugin to function identically in Desktop, Web, and TUI; plugin interface support can differ.
- Source-based installation where the user cannot provide Node.js, pnpm, and platform build tools.
README
简体中文 · English

Oh-DSH
一套 DSH runtime,Desktop、Web 与 TUI 三种开发体验。
把 AI Agent、Workspace、本地工具与插件生态带到你习惯的界面。
Oh-DSH 将 DeepSeek Harness、Node.js、本地开发工具和内置插件打包为可安装的 Desktop、Web 与 TUI 发行版。模型服务仍可按需运行在云端;Workspace、终端、 Git Review、浏览器、文件、会话与插件状态由本地工作台统一组织。
主要能力
🖥️ 三种交互界面使用同一个 |
🧰 本地开发工作台内置 Workspace、PTY 终端、浏览器、文件浏览、Side chat 与 Trajectory;面板可以折叠、固定、分屏或全屏展开。 |
🔍 Git Review查看工作区改动与 commit diff,在代码行上添加 review comment,并在同一个侧边栏完成分支、提交和推送操作。 |
🧩 插件市场Desktop、Web 与 TUI 都能检索、预览和安装插件,并共享同一套交易与恢复状态。目录会标明插件实际生效的界面:安装可能在所有终端都成功,但某些插件只在 Web 或 Desktop 生效、在 TUI 不生效,界面上会明确区分。 |
🎨 跨端皮肤
|
📦 可拆分发行按需安装完整版、Web-only 或 TUI-only。每种发行都自带固定版本的 DSH 与 Node runtime,不要求单独安装运行环境。 |
下载与安装
从 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 | SSH 与纯终端环境 |
- macOS:打开 DMG,将 Oh-DSH Desktop 拖入 Applications。
- Windows:运行安装包,或解压便携版后启动。
-
Linux:直接运行 AppImage,或使用
apt安装 deb。
Web-only 与 TUI-only 包解压后即可运行:
# Web UI,默认监听 http://127.0.0.1:3080
./bin/ohdsh web
# Terminal UI
./bin/ohdsh tui
Windows 使用 bin\ohdsh.cmd web 或 bin\ohdsh.cmd 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 gui # Desktop 的启动别名
ohdsh web # 启动 Oh-DSH Web
ohdsh web --port 3080 # 指定 Web 端口
ohdsh tui # 启动 Oh-DSH TUI
三端默认共同使用 ~/.ohdsh 存放缓存、配置、会话、凭据与插件状态。
设置 OH_DSH_HOME 可以统一更换数据目录;运行 ohdsh web --help 或
ohdsh tui --help 可以查看界面专属选项。
内置的 @oh-dsh/vision 为三端提供同一个 view_image 工具,让用户对 Workspace
内的本地图片、HTTP(S) 图片或 image data URL 做 OCR、读图与界面诊断。图片复制、
粘贴、缩略图和提交继续由 DSH 原生 attachment rail 负责;插件在 Host 的最终图片
能力校验处放行 DeepSeek V4,并在固定的 text-only 适配器序列化同一轮请求前,通过
配置的视觉后端描述原生附件。不另加输入栏气泡或引用协议。TUI 通过 Workspace
图片路径或 URL 使用同一能力。
凭据与后端配置见图片识别使用说明;云端/本地 Key 与 Vision
设置也可以在原生“设置 → 插件 → 插件配置 → Vision”卡片中修改。
Frequently Asked QuestionsFAQ
Use the verified command dsh plugin --profile default add github:hust-open-atom-club/oh-dsh in a DSH-enabled shell. The command resolves the public package metadata and keeps the plugin attached to the catalog identity shown on this page.
Compatibility follows the bundle and profile status shown above. If a profile is not detected, keep the plugin disabled there and check the repository documentation before enabling it in production.
The GitHub link and activity metadata are the source of truth for releases and maintenance. Revisit this page after a new release to confirm the catalog has observed the latest version.