Back to home@shengmk

godsh

godsh - GUI launcher for DeepSeek Harness (dsh): manage profiles, plugins, kernels, and dsh versions

Stars
0
Language
TypeScript
Created
Aug 28, 2026
Updated
Aug 29, 2026
GitHub repo

Introduction

godsh — dsh 环境配置启动器

一个面向 DeepSeek Harness(dsh) 的图形化环境配置启动器,整体类比 Anaconda Navigator

当前版本:v0.2.5 | Windows 10 / 11 | 桌面(Tauri 2)+ Web

AnacondaDSHgodsh
Anaconda Navigatordsh web / CLI本启动器
condadsh CLI启动器底层调用
PythonDeepSeek Harness 核心dsh 本体
conda envDSH Profile环境管理
pip/conda 包dsh plugin / bundle插件分配与安装
conda channeldshmarket / awesome-dsh-plugin插件市场

✨ 核心能力

  • 环境(Profile)管理:扫描/新建/删除/启停,状态徽标、实时日志、批量启停、端口占用视图、每环境指定 dsh 版本。
  • 插件分配(拖拽全面化):每个环境内「已分配 + 可用插件」统一列表,全部可拖动排序可跨环境拖动(如 plugin_bag → desktop),自动写回 cordis.patch.yml;启用/禁用、右键菜单。
  • 统一 Web 内核:没有 dsh-web-app 的 Profile 也能启动出 Web UI(bundle 注入);内核插件层可编辑,按环境覆盖(强制注入 / 跳过 / 跟随全局)。
  • 插件市场:搜索、安装/更新/卸载、批量安装队列(进度 1/N)、热门/最新排序。
  • DSH 本体管理:base 主环境 + 并列环境(类比 Anaconda 环境),版本检测/切换、DSH_HOME 初始化。
  • 内核管理:模板 + 实例(启停/日志/删除)。
  • 设置:主题(浅/深/跟随系统)、语言(中/英)、路径、市场源、数据备份/恢复、重置(含 dsh 全删除)。
  • 工程安全:CORS 白名单、patch 写回守护 + 自动备份、git 版本控制、单元测试 + 冒烟回归。

🚀 快速开始

方式一:桌面版(推荐)

  1. Releases 下载 godsh-0.2.5-x64-setup.exe(安装版)或 -x64.zip(便携版)。
  2. 运行并启动:应用会自动拉起内置 Node API 后端(端口 4780)。
  3. 首次使用建议点击「控制台」→「快速启动默认模板」(无 dsh 会自动安装 base + 初始化官方模板)。

方式二:Web 版 / 源码运行

git clone https://github.com/shengmk/godsh.git
cd godsh
pnpm install          # 安装依赖
pnpm build:web        # 构建前端
pnpm serve            # 启动 API + 前端(http://127.0.0.1:4780)

📖 文档

文档说明
QUICKSTART.md快速开始(安装 / 首次启动 / 三步上手)
release/RELEASE_NOTES.md版本发布说明

🏗 技术栈与结构

技术
后端Node.js ≥ 20 · TypeScript ESM · 纯 node:http · esbuild 单文件(server.mjs
前端Vite 5 · React 18 · TS · 玻璃拟态 CSS(浅色 + 深色)· React.lazy 按页分包
桌面Tauri 2(Rust,GNU/MinGW 工具链)+ WebView2 · 自包含(后端 + 模板打进资源)
安装NSIS 安装器(exe 旁放 WebView2Loader.dll)+ 便携 ZIP
测试node:test 单元测试 + PowerShell 冒烟回归(pnpm test / pnpm test:smoke
godsh/
├─ apps/
│  ├─ launcher/
│  └─ shell-web/
├─ packages/
│  ├─ core/
│  ├─ profile-manager/
│  ├─ plugin-registry/
│  ├─ allocation/
│  ├─ kernel-manager/
│  ├─ marketplace/
│  ├─ dsh-env/
│  └─ security/
├─ scripts/
└─ release/

🛠 开发命令

pnpm install          # 安装依赖
pnpm typecheck        # TypeScript 类型检查
pnpm test             # 单元测试(patch / allocation / unified-kernel)
pnpm test:smoke       # 隔离环境冒烟回归(6 组)
pnpm build:server     # 打包后端单文件 dist/server.mjs
pnpm build:web        # 构建前端 dist
pnpm serve            # 启动 API + 托管前端(http://127.0.0.1:4780)
pnpm launcher help    # CLI 命令

发布打包

# 1) 升级版本号(自动同步全部 package.json / Cargo.toml / tauri.conf / config)
pwsh -File scripts/bump-version.ps1 -Version 0.2.5

# 2) 打包发布版(tauri build 内嵌前端 + NSIS 安装器 + ZIP + 校验和)
pwsh -File scripts/make-release.ps1 -Version 0.2.5

GNU 工具链限制:构建要求项目路径不含空格。

📄 License

MIT