hust-open-atom-club/oh-dsh

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

Bundle 已验证 MIT TypeScript v0.1.6
Bundle 已验证

已收录

247

Dev

Bundle 已验证

版本v0.1.6
语言TypeScript
许可证MIT
在 GitHub 查看

功能介绍

社区发行版:TUI、桌面端与 Web UI 统一体验,分层安装、一步到位。

适合

  • 希望用同一套打包好的 DSH runtime 获得 Desktop、Web 和 TUI 体验的用户。
  • 希望跨界面共享会话、凭据、主题和插件状态,同时保留独立 profile 的团队。
  • 需要自带 Node、可直接运行的完整版、Web-only 或 TUI-only 发行包的用户。

不适合

  • 只想给现有官方 DSH 安装一个小插件、而不需要另一套社区发行版的用户。
  • 要求所有已装插件在 Desktop、Web 和 TUI 中表现完全一致的工作流;插件支持的界面可能不同。
  • 选择源码安装、但无法提供 Node.js、pnpm 和平台构建工具的环境。

README

简体中文 · English

Oh-DSH whale

Oh-DSH

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

把 AI Agent、Workspace、本地工具与插件生态带到你习惯的界面。

GitHub release GitHub stars Desktop, Web and TUI macOS, Linux and Windows MIT License

下载最新版 · 使用文档 · 设计文档

Oh-DSH Desktop 界面展示

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

主要能力

🖥️ 三种交互界面

使用同一个 ohdsh 命令启动 Desktop、Web 或 TUI。三端共享会话、凭据、皮肤与插件缓存,同时保留独立 Profile。

🧰 本地开发工作台

内置 Workspace、PTY 终端、浏览器、文件浏览、Side chat 与 Trajectory;面板可以折叠、固定、分屏或全屏展开。

🔍 Git Review

查看工作区改动与 commit diff,在代码行上添加 review comment,并在同一个侧边栏完成分支、提交和推送操作。

🧩 插件市场

Desktop、Web 与 TUI 都能检索、预览和安装插件,并共享同一套交易与恢复状态。目录会标明插件实际生效的界面:安装可能在所有终端都成功,但某些插件只在 Web 或 Desktop 生效、在 TUI 不生效,界面上会明确区分。

🎨 跨端皮肤

@oh-dsh/skins 为 Desktop、Web 与 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”卡片中修改。

常见问题常见问题

在启用了 DSH 的终端中执行已验证命令 dsh plugin --profile default add github:hust-open-atom-club/oh-dsh。命令会解析公开 package 元数据,并保持插件与本页展示的目录身份一致。