oh-dsh

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

主要能力

下载与安装

从 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”卡片中修改。

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

插件市场

Oh-DSH 皮肤

文档

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

插件推荐

推荐项目	说明
DeepSeek Harness	DSH runtime、会话与插件加载器
dsh-TUI	Oh-DSH TUI 的直接上游插件，提供终端渲染、交互和命令体系
DSH-better-sidebar	Git Review、文件与 PTY Host 能力
dsh-vision	跨 Desktop、Web 与 TUI 的 view_image 视觉工具参考实现
dshfind	DSH 插件超市与学习社区，提供插件、生态与 DeepSeek Harness 周边推荐

Oh-DSH 保留上游实现与署名，并在其上提供统一启动器、Profile、数据目录、 跨端皮肤、界面适配和发行打包。详细边界见设计文档。

License

MIT