@oh-dsh/desktop
Oh-DSH：基于 DeepSeek Harness 的可安装桌面端、Web 端和 TUI 界面
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:hust-open-atom-club/oh-dsh#c6fdd2705f70a077755ce64315ce5265c632f475
Desktop 以 @oh-dsh/desktop 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
简体中文 · English
一套 DSH runtime，Desktop、Web 与 TUI 三种开发体验。
把 AI Agent、Workspace、本地工具与插件生态带到你习惯的界面。
Oh-DSH 三种交互界面：Web、Desktop 与 TUI
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，不要求单独安装运行环境。 |
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 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 与纯终端环境 |
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。详情见图片输入使用说明。
需要 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
本地开发时，也可以用仓库根目录的 Makefile 快速启动指定交互端：
make build
make tui ARGS="--lang zh" # 只暂存并启动 TUI
make web ARGS="--port 3080" # 只暂存并启动 Web
make desktop # 只暂存并启动 Desktop
make tui 默认使用 inline 模式，从当前终端光标位置继续渲染；需要
alternate screen 时传入 ARGS="--fullscreen"。每个 Make 目标只会暂存
对应交互端的 Oh-DSH package，不会把其它交互端一起带入开发 runtime。Make
默认使用 ~/.ohdsh，也可以覆盖：OH_DSH_HOME=/tmp/ohdsh make tui。
Desktop、Web 和 TUI 共享同一组 Agent preset；其中 liangshen（梁神模式）会在
首轮保持 Minimal 双工具，首次工具调用后开放完整工具目录，压缩后重新锚定。
Web/Desktop 可在设置页的 Agent preset 中选择，TUI 可输入 /preset liangshen。
打包完整版使用对应平台的 dist:mac、dist:linux 或 dist:win；只打包
Web 使用 pnpm run dist:web；只打包 TUI 使用 pnpm run dist:tui。
| 推荐项目 | 说明 |
|---|---|
| DeepSeek Harness | DSH runtime、会话与插件加载器 |
| dsh-TUI | Oh-DSH TUI 的直接上游插件，提供终端渲染、交互和命令体系 |
| DSH-better-sidebar | Git Review、文件与 PTY Host 能力 |
| dshfind | DSH 插件超市与学习社区，提供插件、生态与 DeepSeek Harness 周边推荐 |
Oh-DSH 保留上游实现与署名，并在其上提供统一启动器、Profile、数据目录、 跨端皮肤、界面适配和发行打包。详细边界见设计文档。