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
Introduction
godsh — dsh 环境配置启动器
一个面向 DeepSeek Harness(dsh) 的图形化环境配置启动器,整体类比 Anaconda Navigator。
当前版本:v0.2.5 | Windows 10 / 11 | 桌面(Tauri 2)+ Web
| Anaconda | DSH | godsh |
|---|---|---|
| Anaconda Navigator | dsh web / CLI | 本启动器 |
| conda | dsh CLI | 启动器底层调用 |
| Python | DeepSeek Harness 核心 | dsh 本体 |
| conda env | DSH Profile | 环境管理 |
| pip/conda 包 | dsh plugin / bundle | 插件分配与安装 |
| conda channel | dshmarket / 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 版本控制、单元测试 + 冒烟回归。
🚀 快速开始
方式一:桌面版(推荐)
- 从 Releases 下载
godsh-0.2.5-x64-setup.exe(安装版)或-x64.zip(便携版)。 - 运行并启动:应用会自动拉起内置 Node API 后端(端口 4780)。
- 首次使用建议点击「控制台」→「快速启动默认模板」(无 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 工具链限制:构建要求项目路径不含空格。