StarHub

All-in-One DevOps Desktop Command Center

数据库客户端 · SSH/SFTP · Docker 面板 · AI 助手 · 原生桌面应用

项目介绍

StarHub 是一款跨平台桌面应用（Tauri 2 + Rust 主进程 + DeepSeek Harness React 工作台 + Go Sidecar），把开发运维日常高频工具整合到同一个窗口 —— 数据库、SSH/SFTP、Docker 面板与 AI 助手。目标是减少在 Navicat、Xshell、Portainer、文件管理器和 AI 对话窗口之间来回切换的成本。

前端架构：基于 DeepSeek Harness 原生 React 工作台（/starhub-react 路由）。资产、设置、SSH 终端、SFTP、数据库（MySQL/PG/SQLite/ClickHouse/SQL Server/Redis/Elasticsearch）、Docker、AI 助手、Broker、Excel 工具全部由壳内 React 工作台承载，深浅双主题、token 体系与键盘快捷键跨工作区打通。

当前版本聚焦：本地优先、单人高效、跨平台一致体验。Agent 可经 @ 资产引用在任意工作台上下文里发起 SSH / 数据库 / SFTP / Docker 操作，并配合 AI 记忆系统延续跨会话工作。

下载安装

前往 GitHub Releases 下载最新版本：

Linux 同时发布 x86_64 (amd64) 与 ARM64 (arm64 / aarch64)。产物固定在 Ubuntu 22.04 原生 runner 构建，兼容 Ubuntu 22.04+ / Debian 12+ / Fedora 38+ 等主流 glibc 桌面发行版。AppImage 已携带 WebKitGTK、GTK 和静态 Go sidecar；无 FUSE 环境可使用 ./StarHub_0.87.8_amd64.AppImage --appimage-extract-and-run。Alpine（musl）与无 FHS 兼容层的 NixOS 不属于直接兼容范围。

功能矩阵

数据库客户端（Go Sidecar 承载）

• ✅ MySQL：表结构、数据浏览、查询执行、DDL/索引/列管理、表数据 Excel 全量导出（后端直写 xlsx，分批拉取 + 进度条 + 通知中心）
• ✅ PostgreSQL / SQLite：表浏览、查询执行、数据导出
• ✅ Redis：键浏览（SCAN 分页 + 搜索 + 刷新/空态/错误）、String/Hash/List/Set/ZSet 五类值的 tab 式编辑（HDEL/SREM/ZREM/HSET/SADD/ZADD/LSET 命令拼装）、TTL 与 DB 切换、CLI db_redis_execute、新建/重命名/删除/清空键
• ✅ Elasticsearch：索引浏览、文档查询、聚合、DSL 检索表格/JSON 双视图 + 分页、索引映射/settings 详情、新建/删除索引
• ✅ ClickHouse / SQL Server：表浏览、查询执行、导出
• ✅ DB 监控 Dashboard：MySQL / PG / Redis 性能仪表盘（概览/性能/网络 tab、指标卡、连接会话、慢语句明细；Redis INFO + db_size、MySQL SHOW 系列 + 慢日志 digest 回退、PG pg_stat_activity + pg_stat_statements 扩展失败回退），30 秒自动刷新
• ✅ SQL 编辑器：CodeMirror 6 内嵌，MySQL/PG 方言高亮，schema 表/列补全，多语句拆分执行，Mod-Enter 执行 / Shift-Mod-e EXPLAIN / Tab 缩进；SQL 格式化、历史（最多 1000 条，键 starhub.sqlHistory）、多语句拆分
• ✅ DDL 生成器：MySQL/PG/ClickHouse 方言 CREATE TABLE / ADD/MODIFY/CHANGE/DROP COLUMN / CREATE+DROP INDEX 单语句合并（兼容 INFORMATION_SCHEMA 读取），索引存在性判断（不生成 DROP 不存在的索引以规避 Error 1091）
• ✅ 结果网格：原生 HTML 表格 + 虚拟滚动（ROW_HEIGHT=28/OVERSCAN=8），表头 hover 提示类型/可空/键/默认值/备注，列排序、拖拽调宽、表内搜索 + 服务端列筛选，复制 INSERT 语句、行复制、删除行、批量编辑保存（Ctrl/Cmd+S 按主键 db_mysql_update_rows 批量提交）
• ✅ 备份恢复、SQL 审计与告警
• 🚧 Oracle / MongoDB / 国产库 ODBC 桥（规划中）

SSH 终端

• xterm.js 6 渲染，FitAddon / WebLinksAddon / SearchAddon
• ZMODEM 协议支持：通过 zmodem.js 在 Webview 侧实现 rz / sz，支持远端触发本地文件选择发送 / 远端发送本地接收并保存
• 跳板机、端口转发、分屏、命令广播（多会话同时下发，单条失败不影响其他会话）、危险命令拦截
• 快捷命令管理器 + Xshell .qbl / .qblx 导入（兼容旧格式 + Xshell 8 UTF-16 + 多命令集合并）
• shell prompt 捕获 + cwd 跟踪：终端输出解析 OSC 7 + pwd 输出，隐藏回显过滤；SFTP 面板「跟随终端」一键定位远端当前目录
• 服务器网页访问：经 SSH direct-tcpip 的 Web 网关（幂等启动 + 端口校验重启 + postMessage 桥），从服务器侧出口浏览公网/内网站点，支持端到端 TLS（tokio-rustls ring provider）
• MFA / 2FA 认证：password / key / mfa 三档，kb-interactive 内联验证码面板，hostkey 自动接受不持久化
• 多标签独立会话、状态恢复、断线自动重连（应用层 keepalive）；独立窗口由 Tauri 标题栏统一关闭

SFTP 文件传输

• 壳内 SFTP 面板：与 SSH 终端共用同一 live session（经 sftp_ensure_session 复用，不重复认证），双 tab 同窗口展示
• 三栏浏览、路径面包屑、隐藏文件、新建文件夹、重命名、删除、复制路径
• SFTP 启动策略：自动诊断标准 subsystem，异常时探测 sftp-server 路径并受控降级；支持「仅标准 subsystem」和「指定远端程序」模式
• 拖拽上传 / 下载、断点续传、暂停 / 继续 / 取消 / 重试，全局传输任务条（TransferDock）
• 跟随终端当前目录、路径输入直达、连接后落到会话起始目录

Docker 面板

• 容器 / 镜像列表，资产树 DB 化（容器/镜像对象树联动工作区）
• 本地 Docker 主机 + SSH 通道连远程 Docker
• Docker Exec 交互式 TTY：可持续读写的终端会话，支持窗口尺寸同步、命令历史、Tab 补全、Ctrl 组合键
• 容器日志独立弹框：最新日志置顶 + 图标刷新 / 关闭
• Docker Compose、镜像加速、清理入口
• SSH 传输、主机密钥、跳板机参数全量解析

本地工作区

• 导入文件夹 / 文件为工作区，目录树懒加载 + 缩进参考线、明细列表（大小/修改时间）
• VSCode 式编辑体验：可点击面包屑、编辑器 tab（dirty 点/关闭钮同槽位）、底部状态栏
• 文件 CRUD、右键菜单、文本编辑 Ctrl/Cmd+S 保存，.xlsx/.csv 自动用 Excel 工具打开
• AI 全局可读本机文件（#LOCAL 绑定）

AI 助手

• OpenAI 兼容协议（GPT / Claude / DeepSeek / 通义千问 / Ollama 等），流式输出
• 多模型配置 + 会话级模型选择：每个窗口/标签页独立切换模型，互不影响；subagent 自动继承父会话模型
• Function Calling 可驱动 SSH / SFTP / DB / Docker / Redis / ES / 本地文件 / Excel / MCP / skill_save 等域工具；Planner → Executor 编排；模型工具执行成功自动产生 origin=ai 领域事件，跨工作区广播
• @ 调用 Agent、# 绑定目标（AI 工作区与各标签页内嵌助手同源支持；@ 资产选择仅绑定 AI 工具上下文，不打开工作台标签页）
• 三级记忆卡 + SQLite FTS5 会话存档：user / global / asset 三作用域记忆，压缩前 flush / 回合后 review 自动沉淀，侧边栏内置记忆管理（添加/删除/编辑），历史会话全文搜索（session_search）
• MCP Server：stdio、Streamable HTTP 与兼容 SSE，动态挂载外部 tools
• 审批统一走 dsh 权限体系：设置 → 通用 → 权限 preset（read-only / workspace-write / danger-full-access），starhub 域工具（SSH/DB 写、Redis 写、ES 写、SFTP 传输、MCP 调用、记忆写入等）恒需确认，确认卡经原生窗口弹出（180s 超时）
• 最近对话恢复 + 单条删除、每个标签页独立聊天历史；主侧边栏内嵌 AI 聊天，快速提问 Ctrl+J
• 危险命令强制确认（SSH 写、数据库写、Redis 写、ES 写、文件删除、记忆写入等）

StarHub × dsh 联动

• @ 资产引用驱动域工具：当前会话可 @ssh-1，模型自动解析为 ssh_exec(targetAsset=...)，无需切窗
• open_connection / focus_terminal 模型工具：资产已存在则聚焦标签，不存在则新开工作台
• starhub/live.snapshot 活性快照：pre-step 注入资产注册表 + 领域事件 + 任务轨迹（taskTrails ≤ 20，按目标资产去重保序），支持跨窗口任务连续性
• 共享 settings.yaml：StarHub 与 dsh 共用同一份设置，权限 preset / 模型 / Agent 预设双端一致
• stdio JSON-RPC 桥：Rust 主进程与 dsh web 进程互通 starhub/open.asset、starhub/focus.tool、starhub/registry.sync、starhub/domain.event

工作台体验

• 侧栏「工具」三级导航：大类 → 子类（终端 / 数据库 / Docker）→ 资产 → 工作台，资产数徽标 + 刷新 / 新建连接一键入口
• 多标签工作区，同一资产支持多实例；标签页可拖出为独立窗口（Tauri 标题栏统一关闭入口）
• 单击资产优先激活已有标签，避免误开重复会话
• 全局搜索 Ctrl/Command + K、命令面板 Ctrl/Command + P
• 折叠侧边栏 Ctrl/Command + B、折叠右面板 Ctrl/Command + Shift + B
• 深浅双主题、自动更新（Tauri Updater + GitHub Releases latest.json）
• 通知中心：操作历史 + 条数 / SQL / 耗时等详情
• DeepSeek Harness 原生 React 工作台，DSH shell.overlay 复用

Excel 工具

• 由 Sidecar excelize 引擎承载，导入 / 导出 / 编辑 独立工作台（与 DB 工具打通，#LOCAL 绑定本机文件）
• XLSX / CSV 双向转换，支持数据库表 → Excel 一键导出

插件与扩展

• StarHub 插件 = dsh 插件：市场 / URL / 本地 / Zip 导入，全量市场为 UI 类插件；内置插件（client-nav / host-static / tool-context / tools）幂等注册、不可启停
• UI 类插件直接进入 __DSH_BOOT__：依赖分层解析（@deepseek-ai/* 走 vendor junction，第三方尽力解析），bundled 200 OK

资产 / 设置 / 安全

• 新建 / 编辑连接对话框：类型下拉（SSH / MySQL / PG / ClickHouse / Redis / ES / Kafka / NSQ / Docker）+ 公共 + 专有字段，SSL / Redis DB 索引 / SSH 私钥文件；「测试连接」描边按钮 + 主按钮高对比；密码 / 私钥留空保持原值
• DSH 风格设置面板：侧栏分组（通用 / 模型 / 插件 / Agent 预设 / StarHub 五个子项），插件 / 审计日志 / 告警规则 / 关于 / AI 助手 tab 直渲
• 凭据托管：系统 Keyring 优先（macOS Keychain / Windows Credential Manager / Linux Secret Service），无桌面密钥环时回退会话级 Keyutils
• 审计与告警：操作历史 + 统计 + 清理；规则 CRUD + Webhook 测试

当前版本

v0.95.5 (2026-08-25)

• 🐛 新机首次安装启动窗口无响应、报「dsh 没有在运行」、第二次才正常:setup 里 block_on 阻塞主线程跑完 db+sidecar+dsh web 启动(冷启动可能超 30s 就绪上限),期间窗口消息循环停摆 → 「无响应」;dsh web 超时被杀后 dsh_web_url 只读状态不重启 → 卡死在跳板页「dsh web 未运行」需手动重开应用。修复:① setup 改用 async_runtime::spawn 后台拉起,窗口立即响应;② dsh_web_url 改调幂等 ensure_started,跳板页轮询在首启失败后自动重启自愈,无需重开;③ 就绪超时 30s→60s 留足首启冷启动余量。

v0.95.4 (2026-08-24)

• 🐛 区域截图向右/右上斜拖拽经常「断触」、只截出一小块:遮罩页拖拽改为 Pointer Events + setPointerCapture(align 踩坑记录 #10)并补 touch-action: none——指针划过右上角 ✕ 按钮/工具栏或离开窗口时选区不再中途冻结,触屏下 WebView 不再把手势当滚动/平移而中断拖拽;删除 mouseleave 即结束拖拽的脆弱路径。
• 🐛 选区几何经 8 方向穷举模拟验证方向对称,方向差异全部来自事件投递层(无 pointer capture + mouseleave 结束拖拽)。

v0.95.3 (2026-08-24)

• 🐛 GitHub Linux 构建失败根因修复:截图栈 xcap → pipewire/libspa 0.10.1 要求系统 PipeWire/spa 头 ≥ 1.0,而 ubuntu-22.04 的 0.3.48 头过旧(libspa-sys 构建时 bindgen 从系统头生成绑定,缺 flags 字段、meta 函数仍是宏)→ libspa 编译 7 错;Linux 构建基线升 ubuntu-24.04(PipeWire 1.0.5),glibc 下限 2.35 → 2.39。
• 🐛 Linux 旧系统(Ubuntu 22.04 等 PipeWire < 1.0)点击截图提示「需要系统 PipeWire ≥ 1.0(升级到 Ubuntu 24.04 及以上)」,不再静默失败;截图按钮失败从仅 console 改为可见 toast。
• 🐛 Linux 链接依赖补齐:libgbm-dev 及 xcap 官方 Linux 编译依赖清单(xcb / randr / dbus / wayland / egl)进 CI,修复 rust-lld: unable to find library -lgbm。

最近 3 个版本（完整演进见 CHANGELOG.md）。

技术栈

UI 约定遵循 DeepSeek Harness 既有组件、图标与样式（--dsw-* token），跨数据库 / SSH / Docker / AI 工作台保持视觉、交互与快捷键一致。详见 AGENTS.md § 4.4。

快捷键

开发运行

前置：Node 18+（建议 20 LTS）、Rust 1.78+、Go 1.25+、pnpm 9+。Windows 用户需要 MSVC 构建环境；macOS / Linux 用户需要 WebKitGTK / GTK 依赖（参见 Tauri 官方前置）。

# 克隆与安装
git clone https://github.com/dabaicai001/starhub.git
cd starhub
npm install
pnpm --dir vendor/deepseek-harness install   # DSH 主壳依赖

# 完整桌面开发
# scripts/dev-dsh-shell.mjs 启动 DSH 主壳 →
# sidecar:build 构建 Go Sidecar →
# build:window 构建 React 工作台 →
# tauri dev 启动桌面壳并加载 127.0.0.1:3185(开发实例端口;正式实例 3085)
npm run tauri:dev

# 单独构建 React 资产工作台（输出 dist-starhub-react/，由 Tauri resources 打包）
npm run build:window

# Node 纯逻辑测试
npm run test:utils         # crypto / ddlGenerator / sqlHistory / commandGuard / sqlTables / xshellQuickCommand / aiMention / aiCompaction
npm run test:ai-context
npm run test:ai-scroll
npm run test:ai-steering
npm run test:ssh-prompt
npm run test:terminal-cwd
npm run test:ssh-bg
npm run test:memory-guard
npm run test:ai-memory-review

# Rust 主进程（scripts/cargo-env.bat 加载 MSVC 环境，vcvars64.bat 路径取 STARHUB_VCVARS 环境变量，缺省回退 D:\c++1）
npm run cargo:check
npm run cargo:test

# Go Sidecar（自动处理 GOOS/GOARCH 与 rsrc；二进制名固定 starhub-sidecar[.exe]）
npm run sidecar:build           # debug
npm run sidecar:build:release   # release（-ldflags "-s -w"）

# 打包 DeepSeek Harness runtime（前端 dsh-web-frontend 必走 build:lib + build:web）
npm run package:dsh-runtime

打包

# 当前平台打包（自动跑 beforeBuildCommand：sidecar:build:release + build:window + package:dsh-runtime + cargo build --release + 平台打包器）
npm run tauri:build

Tauri 打包前置流程（src-tauri/tauri.conf.json 的 beforeBuildCommand 已编排）：

1. npm run sidecar:build:release — Go Sidecar release 编译（产物 sidecar/bin/starhub-sidecar[.exe]）
2. npm run build:window — React 工作台 production build（输出 dist-starhub-react/）
3. npm run package:dsh-runtime — 打包 DeepSeek Harness runtime（含 dsh-web-frontend dist + 8 个本地 starhub 包 junction + 悬空链接清扫 + node_modules .d.ts/.map 裁剪）
4. cargo build --release — Rust 主进程编译
5. NSIS / MSI（Windows）、.dmg / .app（macOS）、DEB / RPM / AppImage（Linux）打包

Windows 产物

Windows CI 把工作区 subst 到短盘符 S:\ 以规避 checkout + pnpm deploy 嵌套 node_modules 的 260 字符路径上限（NSIS File /r 中断）；package-dsh-runtime.ts 组装后裁剪 node_modules/**/*.{d.ts,d.ts.map,js.map} 进一步压路径。

Linux 产物（Ubuntu 22.04 / glibc 2.35 基线）

Linux 包必须在 Ubuntu 24.04 对应架构的原生环境构建，确保 glibc 2.39 兼容下限；截图功能依赖系统 PipeWire ≥ 1.0（Ubuntu 24.04 及以上）——旧系统（如 Ubuntu 22.04 的 PipeWire 0.3.48）上点击截图会提示升级；AppImage 不允许交叉编译。CI 使用 ubuntu-24.04 与 ubuntu-24.04-arm runner，完成后执行 bash scripts/verify-linux-bundles.sh。WSL 中可用 Docker 验证 x86_64 构建：

docker run --rm --network host \
  -v ~/.cargo:/root/.cargo -v ~/.rustup:/root/.rustup \
  -v <go-path>:/usr/local/go \
  -v $(pwd):/workspace -w /workspace ubuntu:24.04 \
  bash -c "apt-get update && apt-get install -y libwebkit2gtk-4.1-dev ... && npx tauri build"

ARM64 runner 受限于 16GB 内存，Cargo.toml 的 [profile.test] debug = 0 已关闭测试编译 debuginfo，linux-compat.yml / release.yml 对 ARM64 设置 CARGO_BUILD_JOBS=2 限制并行编译单元。Go sidecar 编译时必须指定正确的 GOOS 和 GOARCH（例如 GOOS=windows GOARCH=amd64），否则二进制无法在目标平台运行。

刷新品牌图标

仓库 scripts/refresh-icons.ps1 会从单一源图（默认 icons/app-icon-v6/02-star-chevron-s.png）重新生成 Tauri bundle.icon 全部打包图标与 README 顶图，无外部图像库依赖（使用 .NET System.Drawing，对 PNG-in-ICO 直接写 ICONDIR 头）：

# Windows PowerShell 5.1+
powershell -NoProfile -ExecutionPolicy Bypass `
  -File scripts/refresh-icons.ps1 `
  -RepoRoot .

输出：src-tauri/icons/{icon.png, 32x32.png, 128x128.png, 128x128@2x.png, icon.ico} 与 docs/assets/starhub-logo.png。SVG / .icns / iOS / Android 子目录保持原状，分别需要专用工具链。

文档

路线图

安全提示

• DB / SSH 密码、私钥和 AI API Key 应存入系统 Keyring（macOS Keychain / Windows Credential Manager / Linux Secret Service；无桌面密钥环时回退到会话级 Keyutils）
• AI 执行命令前会经过 dsh 权限 preset 与 starhub 域工具风险门；starhub_* 工具（SSH 写、数据库写、Redis 写、ES 写、SFTP 传输、MCP 调用、记忆写入等）恒需确认
• 危险命令、删除类操作和破坏性操作需要显式确认；180s 超时未应答按拒绝收口
• 生产环境连接请优先使用最小权限账号，定期轮换凭据
• ssh-keyscan hostkey 自动接受不持久化；MFA 一次性验证码不回写

贡献

仓库遵循 Conventional Commits 风格，AI Agent / 人类贡献者请先阅读 AGENTS.md：

• 跨域改动需要协调（SSH / DB / AI 互相依赖）
• 安全 / 性能 / 架构决策先开 Issue 讨论
• 一次 commit 一个主题，工作区不允许长期挂着未提交改动
• 七处版本号（package.json / Cargo.toml / Cargo.lock / tauri.conf.json / CHANGELOG.md / AGENTS.md / README.md）必须同步

License

本项目基于 MIT License 开源。

Copyright © 2026 StarHub Authors