dabaicai001/star-dsh-desktop

StarHub

一体化 DevOps 桌面指挥中心

License: MIT
[Version]()
[Platform]()
Downloads
官网

StarHub 是一个跨平台桌面应用,把开发运维每天要用到的工具收进同一个窗口:数据库客户端、SSH 终端、SFTP 文件传输、Docker 面板、AI 助手。不用再在 Navicat、Xshell、Portainer 和 AI 对话框之间来回切换。

官网:starthub.waouzzz.cc

架构

三层进程模型:

- Rust 主进程(Tauri 2) — 桌面壳。负责多窗口管理、SSH/SFTP 会话(russh)、系统密钥环、AI 浏览器、Updater。
- Go Sidecar — 数据库与中间件代理。独立进程,经 stdio JSON-RPC 与主进程通信,承载 MySQL / PostgreSQL / SQLite / Redis / ClickHouse / SQL Server / Elasticsearch / Docker / Excel 等适配器和连接池。
- 前端(React) — 基于 DeepSeek Harness(dsh)主壳,StarHub 的工作台和插件住在 vendor/deepseek-harness 里:apps/starhub-window 是资产工作台构建入口,packages/starhub/ 是 11 个内置插件(导航、工具桥、记忆、审批、领域事件等),经 dsh 的槽位系统接入,不改上游内核。

功能

数据库:MySQL、PostgreSQL、SQLite、Redis、ClickHouse、SQL Server、Elasticsearch。表结构浏览、SQL 编辑器(CodeMirror 6,补全/格式化/历史)、虚拟滚动结果网格(可编辑、按主键批量保存)、DDL 生成、监控 Dashboard、Excel 导入导出、备份恢复、审计与告警。Oracle / MongoDB / 国产库 ODBC 在规划中。

SSH 终端:xterm.js 6,跳板机、端口转发、分屏、命令广播、危险命令拦截、ZMODEM(rz/sz)、Xshell 快捷命令导入、MFA/2FA、cwd 跟踪、断线重连。

SFTP:与终端共用同一条连接,三栏浏览、拖拽传输、断点续传、暂停/继续、全局传输任务条。

Docker:容器/镜像管理、交互式 Exec TTY、日志查看、Compose、支持经 SSH 通道连远程 Docker 主机。

AI 助手:OpenAI 兼容协议(可接 GPT / Claude / DeepSeek / Ollama 等),Function Calling 直接驱动 SSH / 数据库 / SFTP / Docker / 本地文件 / 浏览器等工具;@ 绑定资产、# 绑定上下文;无痕 AI 浏览器(14 个 browser_ 工具,Windows 走 CDP 可信输入);三级记忆卡 + 会话全文存档;MCP Server 挂载;所有 AI 发起的写操作都要经过确认卡审批并落审计日志。

AI 助手:OpenAI 兼容协议(可接 GPT / Claude / DeepSeek / Ollama 等),Function Calling 直接驱动 SSH / 数据库 / SFTP / Docker / 本地文件 / 浏览器等工具;@ 绑定资产、# 绑定上下文;无痕 AI 浏览器(14 个 browser_ 工具,Windows 走 CDP 可信输入);三级记忆卡 + 会话全文存档;MCP Server 挂载;所有 AI 发起的写操作都要经过确认卡审批并落审计日志。

AI 沙箱桌面(E2B 式):AI 在一次性 Ubuntu 24.04 桌面容器(Xvfb + Xfce + noVNC)里操作任意 Linux 桌面应用——截图回灌、窗口管理、键鼠操作、箱内命令,全程 23 个 desktop_ 工具;模板 → 实例 → 销毁,登录态可固化为新模板;画面在独立直播窗口对用户全程可见,用户可随时「接管」亲手操作(接管期间 AI 写操作自动暂停),扫码登录/输密码时可一键请人工出手。

Android 实体机直连(adb):AI 直接操作用户真实的 Android 手机(开发者模式 → USB 调试 / 无线调试)——截屏看画面、点按/滑动/滚动、按键、输入文本、按包名启动 App、设备文件传输、无线配对,共 19 个 android_* 工具;直播窗口走 bundled scrcpy-server 的 H.264 实时画面(不可用自动降级截图轮询),同样支持围观/接管;任务级授权(60 分钟)、任意 shell 恒确认 hard 档、每次写操作自动截屏留档可回放——真实设备,每一步都有据可查。

其他:本地文件工作区(VSCode 式编辑)、Excel 工具、Kafka/NSQ 元数据、系统 Keyring 凭据托管、深浅双主题、自动更新。

当前版本

v0.119.1 (2026-09-16)
- 🐛 DB 工作台 tab 条遮挡与溢出体验:标签溢出时 Chromium 默认横向滚动条(约 12px)挤占 42px 头部、遮挡标签,「新建查询」钮随标签一起滚出可视区被裁切;改为「新建查询」钉在滚动区外常驻可见,滚动区改用 4px 细滚动条、支持纵向滚轮转横向滚动,活动标签自动滚入视野,长表名限宽省略。
- 🐛 侧栏「工具」入口与「设置」透明度/几何不一致：工具按钮文字色为 tertiary（与设置行并排显得发灰），且宽度比设置行窄 4px，rail（收起）态缺 36px 圆形样式；与「设置」触发行对齐为同一几何（calc(100% + 4px) 行宽 / 36px rail 圆钮）与 label-primary 配色。
- 🐛 rz/sz 文件传输改为居中弹窗：远端执行 rz 时的 ZMODEM 提示从终端顶部内联横条（易被忽略、挤压终端首行）改为居中模态弹窗，含状态、文件名、进度条与「选择文件」「取消」按钮，接收（sz）进度同弹窗展示。
- 🐛 Redis 新建 key 后展开目标 db 显示「暂无 key」：新建 key（或 FLUSHDB）到收起状态的 db 只刷新 DBSIZE，会基于占位记录建出「有 size、无键」且 match 恰为 '' 的缓存项，之后展开该 db 被误判为完整缓存而跳过 SCAN（明明有 key 却显示「暂无 key。」）；改为从未加载的记录 match 恒为 null，缓存命中判定天然失败，展开必然真实加载键列表。

历史版本见 CHANGELOG.md。

下载

GitHub Releases 提供：

| 平台 | 产物 |
|---|---|
| Windows | .msi / NSIS .exe |
| macOS | .dmg / .app |
| Linux | .deb / .rpm / .AppImage（x86_64 与 ARM64） |

Linux 默认版在 Ubuntu 24.04 构建（glibc 2.39+，截图依赖 PipeWire ≥ 1.0）；另附 -ubuntu2204 后缀的兼容版（glibc 2.35，无区域截图），适用于 Ubuntu 22.04 / Debian 12 / Fedora 38+ 等旧系统。AppImage 自带 WebKitGTK/GTK/sidecar，无 FUSE 环境加 --appimage-extract-and-run 运行。

开发

前置：Node 20 LTS、Rust 1.78+、Go 1.25+、pnpm 9+。Windows 需要 MSVC 构建环境。

git clone https://github.com/dabaicai001/star-dsh-desktop.git
cd starhub
npm install
pnpm --dir vendor/deepseek-harness install

npm run tauri:dev        # 完整开发：构建 sidecar + React 工作台，启动桌面壳

常用命令：

| 命令 | 作用 |
|---|---|
| npm run build:window | 构建 React 工作台（输出 dist-starhub-react/） |
| npm run sidecar:build / :release | 构建 Go Sidecar |
| npm run cargo:check / cargo:test | Rust 检查 / 测试（自动加载 MSVC 环境） |
| npm run test:utils 等 | Node node --test 纯逻辑测试（见 package.json） |
| npm run package:dsh-runtime | 打包 DeepSeek Harness runtime |
| npm run tauri:build | 当前平台打包（NSIS/MSI、dmg、DEB/RPM/AppImage） |

文档

- docs/技术方案.md — 完整技术方案与功能矩阵
- docs/设计系统.md — UI token 与组件规范
- docs/踩坑记录.md + docs/已知坑索引.md — 已知坑
- CHANGELOG.md — 版本演进
- AGENTS.md — AI Agent / 贡献者协作指引（目录结构、命令、提交与发版约定）

安全

- 密码、私钥、API Key 存系统 Keyring（macOS Keychain / Windows Credential Manager / Linux Secret Service）
- AI 执行写操作（SSH 写、SQL 写、文件删除、传输等）一律弹确认卡，超时按拒绝处理
- hostkey 自动接受不持久化，MFA 验证码不回写

关于（About）

StarHub — All-in-One DevOps Desktop Command Center。把开发运维每天要用到的工具收进同一个窗口：数据库客户端 · SSH 终端 · SFTP · Docker · AI 助手，以及 AI 驱动的沙箱桌面与 Android 实体机操作。

| 项 | 值 |
|---|---|
| 当前版本 | v0.116.8 |
| 官网 | starthub.waouzzz.cc |
| 仓库 | github.com/dabaicai001/star-dsh-desktop |
| 问题反馈 | GitHub Issues |
| 协议 | MIT · Copyright © 2026 StarHub Authors |

致谢与依赖：

- AI 主壳基于 DeepSeek Harness（插件化 agent harness，vendor/deepseek-harness submodule）；
- Android 直播的 H.264 通道使用 scrcpy server（Apache-2.0，来源与 SHA256 校验见 src-tauri/resources/scrcpy/PROVENANCE.md）；
- 桌面壳 Tauri,终端 xterm.js,数据库/中间件适配由内置 Go sidecar 承载。

许可证

MIT · 版权所有 © 2026 StarHub 作者