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>

下载与安装

首选：命令行安装

Linux 与 macOS 使用仓库根目录的 install.sh 安装最新稳定版。默认安装 TUI，并将 ohdsh 注册到 ~/.local/bin；新开一个终端后即可使用：

curl -fsSL \
  https://raw.githubusercontent.com/hust-open-atom-club/oh-dsh/main/install.sh \
  | bash

需要 Web 或 Desktop 时显式选择发行形态：

curl -fsSL \
  https://raw.githubusercontent.com/hust-open-atom-club/oh-dsh/main/install.sh \
  | bash -s -- --surface web

curl -fsSL \
  https://raw.githubusercontent.com/hust-open-atom-club/oh-dsh/main/install.sh \
  | bash -s -- --surface desktop

Windows 使用仓库根目录的 install.ps1；不带参数时同样默认安装 TUI：

irm https://raw.githubusercontent.com/hust-open-atom-club/oh-dsh/main/install.ps1 | iex

安装完成后，通过统一命令启动已安装的界面：

# 终端界面
ohdsh tui

# Web 界面
ohdsh web

# Desktop 应用
ohdsh desktop

ohdsh 只会启动已经安装的 surface；Desktop 的直接入口 oh-dsh-desktop 仍然保留。Linux/macOS 如果当前终端还没有加载新的 PATH， 请重新打开终端；Windows 请使用新终端。

安装器在校验发布的 SHA-256 摘要之前不会触碰旧安装，下载失败、摘要不匹配 或解压中断都保持原安装可用；重复执行同一命令即为原地升级， --uninstall 按 surface 卸载。完整选项、环境变量与 surface 矩阵见 安装说明。

从 GitHub Release 手动安装

从 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。

安装脚本是推荐入口；Release 资产适合需要手动选择包或离线分发的场景。

使用

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 可以查看界面专属选项。

图片输入由 DSH 原生多模态模型（如 DeepSeek V4 Flash）直接处理：复制、粘贴、 缩略图与提交全部由原生 attachment rail 负责，无需额外的视觉桥接插件或单独的 API Key。详情见图片输入使用说明。

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

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

…