star-deepseek-harness-desktop

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

官网:starthub.waouzzz.cc

架构

三层进程模型:

• 上游 Electron 桌面壳 — DeepSeek Harness 自家的 Electron 壳,零改动原样使用;品牌、签名、自动更新都是它的。StarHub 不做自己的桌面项目。
• dsh Host + starhub-bridge 插件 — Host(Node)进程里的 bridge 插件 spawn 两个 sidecar,把 sidecar 的方法面暴露成模型工具与工作台命令面。
• 两个 sidecar — Rust sidecar(sidecar-rust/)承载 SSH/SFTP、Android 真机与直播帧枢纽;Go Sidecar(sidecar/)承载 MySQL / PostgreSQL / SQLite / Redis / ClickHouse / SQL Server / Elasticsearch / Docker / Kafka 等适配器和连接池。均经 stdio 换行分帧 JSON-RPC 通信。
• 前端 — DeepSeek Harness(dsh)主壳,StarHub 的工作台和插件住在 vendor/deepseek-harness 里:apps/starhub-window 是资产工作台构建入口,packages/starhub/* 是 10 个内置插件(导航、工具桥、直播、审批、领域事件等),经 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 / 本地文件 / Android 真机等工具;@ 绑定资产、# 绑定上下文;三级记忆卡 + 会话全文存档;所有 AI 发起的写操作都要经过确认卡审批并落审计日志。

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

其他:Kafka/NSQ 元数据、深浅双主题、自动更新。

当前版本

v0.134.2 (2026-10-13)

• 🐛 🐛 修 SSH AI 助手「发消息没反应」+ 会话列表出现「未分组/未命名」幽灵会话 + 重开报 session/not-found(三个症状同一根因):助手会话以 ctx.agents.create() 建根 Agent 时没打 meta.cwd,dsh 会话模型里无 cwd 的会话一是拼不出系统提示的 {{cwd}} 段(回合在第 1 步装配失败、turn/end reason.kind=error,面板又从不渲染这类事件——表现就是「发了没反应」),二是被历史/会话列表按 not-found 拒绝(落进 _no-cwd/ 桶)。现在创建时恒打 meta.cwd(指向插件专属目录 ~/.starhub/ssh-assistant,新插件 Config 字段 sessionCwd 可覆盖,apply 时 mkdir,建不了就 fail loud),并在会话建好后调 sessionTitle 服务把显示名钉成纯服务器名(user 来源,压住自动标题;服务缺席降级为告警不阻塞)。面板侧同时补上 turn/end 错误原因的渲染(按回合号去重,重放不叠加),这类失败从此在面板里可见。宿主侧 fake host 补 sessionCwd/renames 桩与 cwd/标题断言,组合测试走插件 Config 注入临时目录并断言会话头 cwd 与 rename 接线;客户端 fold 补 turn/end 用例(28 例全绿)。

历史版本见 CHANGELOG.md。

下载

GitHub Releases 提供:

Linux / macOS 暫不发版(2026-10-09 决策 A:等上游)。桌面壳是上游 DeepSeek Harness 的 Electron 壳,它的 SUPPORTED_TARGETS 目前只有 mac-arm64 / mac-x64 / win-x64,没有 Linux target;原来的 deb/rpm 能力随 Tauri 壳一起退役。等上游出了 Linux target,加一个 CI job 即可,StarHub 不自己维护第二条打包路径。macOS 同理(缺签名/公证证书,证书就位后照抄 Windows job 改 target 名)。

开发

前置:Node 20 LTS、Rust 1.96+、Go 1.25+、pnpm 11+。Windows 需要 MSVC 构建环境。

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

npm run build:window && npm run sidecar:build && npm run sidecar-rust:build
npm run smoke:dsh-desktop   # provisioning + 宿主进程冒烟(五条断言)

常用命令:

上游 Electron 壳打包(发布链):

pnpm --dir vendor/deepseek-harness/apps/desktop run package:win:x64:unsigned

文档

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

安全

• 密码、私钥、API Key 存 sidecar 的密钥存储(文件或内存;系统 Keyring 迁移见技术方案 §六)
• AI 执行写操作(SSH 写、SQL 写、文件删除、传输等)一律弹确认卡,超时按拒绝处理
• hostkey 自动接受不持久化,MFA 验证码不回写
• 直播/接管的帧通道只绑 127.0.0.1,一次性令牌握手后即弃

关于(About)

StarHub — All-in-One DevOps Desktop Command Center。把开发运维每天要用到的工具收进同一个窗口:数据库客户端 · SSH 终端 · SFTP · Docker · Android 真机 · AI 助手。

致谢与依赖:

• AI 主壳基于 DeepSeek Harness(插件化 agent harness,vendor/deepseek-harness 整树 vendored);
• Android 直播的 H.264 通道使用 scrcpy server(Apache-2.0);
• 终端 xterm.js,数据库/中间件适配由内置 Go sidecar 承载。

License

MIT · Copyright © 2026 StarHub Authors