euanguo/dsh-studio 预览 preview

euanguo/dsh-studio

桌面端Desktop 原生Native ⭐ 7 MIT 编程Coding生态Ecosystem

DSH Studio — a local development workbench for DeepSeek Harness: project tree, Git review, terminal, and plugin marketplace (Desktop + Web)

项目介绍Project Overview

DSH Studio 是基于 DeepSeek Harness runtime 构建的本地开发工作台客户端,将 AI Agent、项目工作区、终端、文件浏览、Git Review 与插件市场整合到 Desktop / Web 同构应用中。它按 Project → Worktree → Session 三层组织多项目,支持智能生成提交信息和行级 diff 审阅,适合在单窗口内完成编码、审查与提交流程。模型推理仍在云端运行,浏览器与终端受 Web-only 沙箱限制。

DSH Studio is a local development workstation client built on the DeepSeek Harness runtime, combining an AI Agent, project workspaces, terminal, file browser, Git Review, and plugin marketplace into isomorphic Desktop and Web applications. It organizes multiple projects in a Project to Worktree to Session hierarchy, with AI-generated commit messages and line-level diff review for end-to-end coding, reviewing, and committing in a single window. Model inference still runs in the cloud, and the Web-only build imposes sandbox limits on the browser and terminal.

或使用命令行安装(适合开发者)Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add github:euanguo/dsh-studio

euanguo/dsh-studio 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

简体中文 · English

DSH Studio

DSH Studio

面向 DeepSeek Harness 的本地开发工作台

对话、文件、Git Review、终端与插件,都在同一个项目工作区里。

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

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

DSH Studio 工作台
左栏项目树 · 中间多标签会话区(对话 / 终端 / 浏览器)· 右栏 Git 面板

DSH Studio 基于 DeepSeek Harness runtime 构建,把 AI Agent、Workspace、本地开发工具和插件生态装进一个可安装的 Desktop / Web 工作台。模型服务仍在云端按需运行;项目、会话、终端、文件、Git Review、浏览器和插件状态全部由本地工作区统一组织。

核心特性

🗂️ 多项目工作区
Project → Worktree → Session 三层组织,支持分组、别名与项目图标自动探测。
🧰 一站式工具区
项目级 PTY、文件浏览与预览、浏览器、Subagent,不用在多个窗口间切换。
🔍 Git Review
staged / unstaged / untracked 分区、提交历史、commit 文件树与行级审阅目标。
🤖 智能提交
根据当前变更一键生成提交信息,模型与思考强度可配置。
🖥️ Desktop + Web 同构
同一套 runtime、Profile、插件与数据边界,Desktop 提供原生窗口与 PTY。
🧩 插件市场
多来源插件浏览与安装,候选预览、审批、来源锁定与恢复流程完整。

界面预览

🗂️ 项目树与自动图标

左栏按 Project → Worktree → Session 三层组织工作上下文。每个项目的图标从项目目录的静态资源自动探测——优先读取 package.json 声明的 icon 字段,其次搜索项目内的 PNG 文件,也可以取项目主页 favicon 或 Git 平台头像——不需要手动配置就能显示项目专属图标。

左栏项目树 自动探测的项目图标
项目树:dsh-studio 项目下挂 main / dev 两个分支 项目图标:自动读取自项目静态资源

自动探测不理想时,右键项目即可换用内置图标或上传自定义 PNG。多项目、多分支、项目分组、别名、搜索和视图状态都会持久化保存。

🔍 Git Review 与智能提交

右栏 Git 面板把暂存区、未暂存、未跟踪分区和提交历史集中在同一个面板。点击「生成提交信息」,模型会根据当前变更自动写出提交标题和正文;生成后可以直接在输入框里修改,确认后一键提交全部暂存变更。

智能生成提交信息
已暂存 2 个文件,提交信息由模型根据变更内容生成

每个分区都有「查看全部」:点击后暂存文件会展开为中心区域的独立标签页,左侧保留文件树导航,对照代码和 diff 更直观。

查看全部暂存文件
「查看全部」打开的暂存文件标签页,左侧为文件树

📄 Diff 查看器

点击 Git 面板中的任意文件,右栏即打开 diff 查看器:行级 diff、图片 diff、冲突查看、行内评论目标一应俱全,committed 与 unpushed 变更都可以对比。

Diff 查看器
行级 diff,新增 / 删除行高亮,支持行内评论

📁 文件浏览

右栏切到文件标签即可浏览项目级文件树并预览文件,支持搜索、排序和快速跳转。中心区域的对话标签保持打开,看文件不打断对话。

文件浏览
项目文件树与文件预览,对话标签同时保持打开

🖥️ 项目级终端

终端作为中心标签页打开:原生 PTY、统一的 shell 解析链、项目级作用域、流式输出与重放。对话和浏览器标签同时挂在标签栏,随时切换。

项目级终端
中心区域的终端标签,与对话、浏览器标签并列

⚙️ 设置面板

通用设置、模型配置、Agent 预设、侧边栏选项和皮肤切换集中在一个面板,Desktop 与 Web 共享同一套配置。

设置面板
设置面板:通用设置 / 模型 / 插件 / Agent 预设 / 侧边栏 / 主题皮肤

🧩 插件市场

浏览和管理来自多个来源的 DSH 插件。安装前经过候选预览与审批,保留来源锁定、bundle 校验、应用和恢复流程。

插件市场
插件市场:已安装 / 未安装分类,支持搜索与来源筛选

实验性功能 · Source Control AI 正在开发中:根据项目变更生成提交信息,支持模型、思考强度和提示词模板配置。该能力尚未作为稳定发行承诺。

下载与安装

DSH Studio Releases 选择发行形态:

发行形态 包含内容 适合场景
完整版 DSH Studio、Web、Node runtime 和内置插件 本地开发工作台
Web-only DSH Studio Web、Node runtime 和 Web 插件,不含 Electron 浏览器、服务器或轻量安装
各平台安装步骤
  • macOS: 打开 DMG,将 DSH Studio 拖入 Applications。
  • Windows: 运行安装包,或解压便携版后启动。
  • Linux: 直接运行 AppImage,或使用 apt 安装 deb。

Web-only 包解压后即可运行:

# Web UI,默认监听 http://127.0.0.1:3080
./bin/dsh-studio web
安装统一命令(可选)

macOS 完整版可将应用内的启动器加入 PATH

sudo ln -sf \
  "/Applications/DSH Studio.app/Contents/Resources/bin/dsh-studio" \
  /usr/local/bin/dsh-studio

Web-only 包可直接运行 ./bin/dsh-studio,也可以把它加入 PATH

使用

dsh-studio desktop          # 启动 DSH Studio
dsh-studio gui              # Desktop 的启动别名
dsh-studio web              # 启动 DSH Studio Web
dsh-studio web --port 3080  # 指定 Web 端口

数据目录: 已安装的 Desktop 和 Web 默认共同使用 ~/.dsh-studio 存放缓存、配置、会话、凭据与插件状态。源码里的 pnpm start / pnpm dev 默认改用 ~/.dsh-studio-dev,正式版和验证实例可以同时开、互不抢数据。设置 DSH_STUDIO_HOME 可统一更换数据目录;--channel stable|devDSH_STUDIO_CHANNEL 在默认根目录之间切换。

我们基于什么构建

DSH Studio 是 hust-open-atom-club/oh-dsh 的下游 fork,并继续使用 DeepSeek Harness 提供的 DSH runtime、Profile、Session、Workspace 和插件契约。

区域 来源与边界
DSH runtime 基于 deepseek-ai/deepseek-harness 的 pinned runtime 运行
项目来源 基于 hust-open-atom-club/oh-dsh 继续开发
左栏 fork 官方 packages/client/ui-workspace,改造成 Project → Worktree → Session;官方 row 被禁用,DSH Studio 使用自己的 desktop-left-rail
右栏 Host 基于 omdsh-dev/DSH-better-sidebar 的 Host 能力改造并 vendor 到仓库内
右栏 client/UI 不是上游 UI 的原样复制;文件、Git Review、Center Surface、项目级作用域、插件注册和桌面布局由 DSH Studio 自己实现或重写
Diff / terminal 参考 分别参考 pierreorca 的公开实现和算法,保留对应归属

DSH Studio 不是简单换皮,也不是完全复制 Better Sidebar:我们复用明确标注的 runtime、Host、协议和第三方基础,在其上构建自己的项目工作区、Git Review、Center Surface、插件市场和 Desktop/Web 发行层。

文档与生态

更多参考项目
  • plugin-registry:插件来源、锁定和生命周期参考
  • dsh-hub:插件聚合、信任与候选预览参考
  • dsh-suite:插件分类与管理参考
  • pierre:diff、行内注释与虚拟化渲染参考
  • orca:终端滚动和提交生成思路参考

完整的第三方许可、固定版本与适配边界见 THIRD_PARTY_NOTICES

License

MIT

上一个 Prev dsh-gui 下一个 Next dsh-overleaf