oh-dsh-desktop

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

<h1>Oh-DSH</h1> <p><strong>一套 DSH runtime，Desktop、Web 与 TUI 三种开发体验。</strong></p> <p>把 AI Agent、Workspace、本地工具与插件生态带到你习惯的界面。</p>

<a href="https://github.com/hust-open-atom-club/oh-dsh/releases/latest"><strong>下载最新版</strong></a> · <a href="./docs/usage.zh.md">使用文档</a> · <a href="./docs/design.zh.md">设计文档</a>

Oh-DSH 将 DeepSeek Harness、Node.js、本地开发工具和内置插件打包为可安装的 Desktop、Web 与 TUI 发行版。模型服务仍可按需运行在云端；Workspace、终端、 Git Review、浏览器、文件、会话与插件状态由本地工作台统一组织。

主要能力

  <h3>🖥️ 三种交互界面</h3>
  <p>使用同一个 <code>ohdsh</code> 命令启动 Desktop、Web 或 TUI。三端共享会话、凭据、皮肤与插件缓存，同时保留独立 Profile。</p>
  <h3>🧰 本地开发工作台</h3>
  <p>内置 Workspace、PTY 终端、浏览器、文件浏览、Side chat 与 Trajectory；面板可以折叠、固定、分屏或全屏展开。</p>
  <h3>🔍 Git Review</h3>
  <p>查看工作区改动与 commit diff，在代码行上添加 review comment，并在同一个侧边栏完成分支、提交和推送操作。</p>
  <h3>🧩 插件市场</h3>
  <p>Desktop、Web 与 TUI 都能检索、预览和安装插件，并共享同一套交易与恢复状态。目录会标明插件实际生效的界面：安装可能在所有终端都成功，但某些插件只在 Web 或 Desktop 生效、在 TUI 不生效，界面上会明确区分。</p>
  <h3>🎨 跨端皮肤</h3>
  <p><code>@oh-dsh/skins</code> 为 Desktop、Web 与 TUI 提供统一主题，并针对各界面的布局和可读性分别适配。</p>
  <h3>📦 可拆分发行</h3>
  <p>按需安装完整版、Web-only 或 TUI-only。每种发行都自带固定版本的 DSH 与 Node runtime，不要求单独安装运行环境。</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	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”卡片中修改。

<strong>从源码运行</strong>

需要 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。

<strong>更多界面</strong>

插件市场

Oh-DSH 皮肤

文档

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

插件推荐

…