dabaicai001/star-deepseek-harness-desktop
StarHub 是一款跨平台桌面应用（Tauri 2 + Rust 主进程 + DeepSeek Harness React 工作台 + Go Sidecar），把开发运维日常高频工具整合到同一个窗口 —— 数据库、SSH/SFTP、Docker 面板与 AI 助手。目标是减少在 Navicat、Xshell、Portainer、文件管理器和 AI 对话窗口之间来回切换的成本。 前端架构：基于 DeepSeek Harness 原生 React 工作台（/starhub-react 路由）。资产、设置、SSH 终端、SFTP、数据库
安装Install
dsh plugin --profile web add github:dabaicai001/star-deepseek-harness-desktop把 dabaicai001/star-deepseek-harness-desktop 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
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 下载最新版本：
| 平台 | 文件格式 | 安装方式 |
|---|---|---|
| Windows | .msi / .exe (NSIS) |
双击安装 |
| Linux (Debian/Ubuntu) | .deb |
sudo apt install ./StarHub_0.87.8_amd64.deb |
| Linux (Fedora 38+ 等 glibc 2.35+ RPM 系) | .rpm |
sudo dnf install ./StarHub-0.87.8-1.x86_64.rpm |
| Linux (通用) | .AppImage |
chmod +x StarHub_0.87.8_amd64.AppImage && ./StarHub_0.87.8_amd64.AppImage |
| macOS | .dmg / .app |
拖入 Applications |
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-rustlsring 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.92.1 (2026-08-22)
- ✨ 产物行「+ N 个文件」改为打开右侧贴边 drawer(撤回 v0.91.0 行内展开):按新增/修改分组列出本轮全部变更文件(完整路径 + +/- 行数),分组标题可折叠,行点击走与徽章相同的壳内查看窗优先打开器;Esc / 遮罩 / × 三种方式关闭且焦点回到「+ N」按钮;「在文件夹中显示」移入 drawer 底栏(loopback +
canOpenPath门禁不变);v0.91.0 的.list/.collapse/.listRow/ 新增修改标记等行内展开代码与样式全部删除。 - 🐛 修复 v0.92.0 打包构建失败:
settings-tabs.client.spec.tsx残留未使用的waitForimport(tsc TS6133,package-dsh-runtimebuild 中断)。 - 🐛 修复「启用长期记忆」host 侧门禁与 v0.92.0「默认关」策略相反:memory-context pre-step 在 namespace 未写过时按开启处理(默认注入记忆卡),改为 explicit-true(未写过 = 关闭),与设置面板默认值一致;同步修正 memory-context / memory-sink / client-nav 三处「未写过视为开启」的过期注释与 README。
- 🐛 修复 memory-sink LLM 抽取的 abort 竞态:已中止 signal 在
Promise.race中会输给立即 resolve 的 generate(abortPromise 的拒绝反应排在 generate 已完成微任务之后),改为调用 generate 前检查signal.aborted。 - 🐛 修复 dsh 源面解析缺口:
tsconfig.base.json缺dsh-starhub-commit-message/dsh-starhub-memory-context/dsh-starhub-memory-sink三个显式映射(连字符包名越过dsh-*wildcard 的单捕获),vitest 此前把@deepseek-ai/dsh-starhub-memory-context静默解析到过期构建产物(lib);并补memory-sink/tsconfig.json对 memory-context 的 project reference。 - ✅
memory-context/memory-sink两包补齐至 per-file 100% 覆盖率门禁:isAutoReviewEnabled默认关语义、cardTitle global/未知 scope 兜底、pull/写入/抽取三路超时降级、pre-step 与 turn-stopping 钩子、wireLlmExtractor全分支、invariant 伴生注册。 - ✅ client-nav 设置相关文件(
ai.tsx/aiSettings.ts/memory-context.ts)补至 100%:api 在场时两个记忆开关同步 host namespace、同步拒绝静默、folder scope 标签文案。 - ✅ ui-deliverables 新增 drawer 规格 7 例(分组/打开器/三种关闭/折叠/底栏门禁/焦点),数据派生补 1 例(diff 空文本行数、diffs 缺省时 locations 兜底),全包 100%。
v0.92.0 (2026-08-22)
- ✨ AI 长期记忆自动沉淀:新增 host 包
@deepseek-ai/dsh-starhub-memory-sink,agent 回合结束(turn-stopping)后调一次独立 LLM 抽取当轮持久事实,经新增反向 RPCstarhub/memory.write写入 ai_memories(folder: 或 global scope)。 - 🔧 「启用长期记忆」与「自动沉淀记忆」两开关默认关闭:需在设置 → AI 助手显式打开后才有记忆预读注入或自动沉淀。
- 🔧 「管理记忆」弹窗在纯浏览器会话(:3085)也可打开,IPC 失败以错误文本展示,不再整体禁用。
v0.91.0 (2026-08-22)
- 🔧 AI 产物点击改为壳内查看窗优先:每轮末尾的产物文件行(ProducedFiles 徽章)与收尾正文里的行内代码文件提及(chatFileMentions)改为走与 Read/Edit 工具卡同一
viewFile通道({ kind: 'read' }),查看服务缺失(纯 dsh web)时退回 OS 默认打开;同时修复 chat view 的viewFile注入未按会话 cwd 解析相对路径就交给查看窗的问题(产物/提及多为工作区相对路径,Tauri 直读需要绝对路径)。 - 🔧 产物行升级为改动文件清单:条目标注「新增/修改」与 +/- 行数估计,点击「+ N 个文件」展开全部产物逐行清单(可逐个壳内查看),产物多时不再只看得到前几个。
- 🔧 壳内文件查看窗「变更前/变更后」红绿色块对比:逐 hunk 行级 diff,变更行带红(-)/绿(+)底色,编辑改为右栏「编辑」开关切换。
- 🔧 会话头部 git 分支胶囊支持同步线上分支:新增「同步远程」(
git fetch --all --prune)与「拉取(git pull)」;远程跟踪分支单独成组列出(过滤origin/HEAD与本地已有同名分支),点击即git checkout -b <名> --track拉取为本地跟踪分支。 - 🔧 修复分支胶囊面板遮挡与溢出:胶囊根以 z-index 9 自建堆叠上下文压过粘性 composer 遮罩;面板加宽到 340px 并按视口限高限宽,三个同步按钮均分不换行,仅分支列表滚动。
v0.90.0 (2026-08-22)
- 🔧 会话头部 git 分支胶囊新增「✨ AI」生成提交信息:点击后采集
git status --porcelain/git diff HEAD --stat/ 近期提交主题,经新增 host 插件@deepseek-ai/dsh-starhub-commit-message(POST/starhub/git/commit-message,按 GUI 默认模型路由做 one-shot LLM 调用,输入/输出/超时预算走 cordis 配置)返回草稿并回填输入框,确认或编辑后再提交;草稿对齐仓库近期提交的语言与 Conventional Commits 风格。 - 🔧 修复 Windows 下切换会话/工作区时闪出系统终端黑窗:
local_shell_exec在 Windows 经powershell.exe跑命令(分支胶囊每次会话切换都会调 git)但未带CREATE_NO_WINDOW,GUI 进程 spawn 控制台子进程即弹窗;为local_shell_exec及 harness 的mklinkjunction/诊断 spawn 统一补上CREATE_NO_WINDOW。 - 🔧 壳内文件查看窗(Read/Edit 工具卡点开)内容区撑满弹窗:共享
Modal的 content/body 现参与拉伸与内部滚动,查看窗调整为近全屏(1080px 宽、视口高减 64px),长文件不再挤在小区域里看。 - 🔧 设置 → AI 助手「管理记忆」弹窗:多条记忆时列表区独立上下滚动(原 grid 三行模板被错误/空态行挤占且列表无 overflow),弹窗加宽加高、条目排版放宽。
最近 3 个版本（完整演进见 CHANGELOG.md）。
技术栈
| 层级 | 选型 | 说明 |
|---|---|---|
| 桌面壳 | Tauri 2 + Rust (tokio 异步) | 多窗口、权限、Updater、Sidecar 管理、HostBridgeState 共享桥 |
| 工作台 | React + DeepSeek Harness | starhub-window React 入口；DSH 主壳承载设置、资产、SSH 浏览器、SFTP、AI |
| 构建 | Vite 5 + TypeScript 5（strict、exactOptionalPropertyTypes） |
build:window 产物 dist-starhub-react/ |
| 终端 | xterm.js 6 + ZMODEM.js | 终端渲染与文件传输协议；OSC 7 + pwd cwd 跟踪 + 隐藏回显过滤 |
| SQL 编辑 | CodeMirror 6 | @codemirror/state/view/lang-sql/autocomplete/commands，MySQL/PG 方言高亮 |
| 表格 / Excel | Univer Sheets 0.25.1 (vendor) | 结果网格与 Excel 工具（Sidecar excelize 协同） |
| 数据库 Sidecar | Go 1.25+ stdio JSON-RPC | 8 类适配器、连接池、流式数据、Excel 直写 |
| SSH / SFTP | russh 0.62 + russh-sftp 2 |
SSH 客户端、SFTP 客户端，exec_id 可中断 |
| 持久化 | sqlx (SQLite) + FTS5 | 本地资产/配置、会话存档全文检索 |
| 加密 | aes-gcm + argon2 + keyring-rs | 敏感数据 + 系统 Keyring 跨平台封装 |
| Web 网关 | tokio-rustls（ring provider）+ webpki-roots |
SSH direct-tcpip 之上的端到端 TLS |
| 系统监控 | sysinfo | 资源/进程指标 |
| AI 协议 | OpenAI 兼容（GPT / Claude / DeepSeek / Ollama 等） | 流式输出 + Function Calling + stdio JSON-RPC 桥 |
| MCP | stdio / Streamable HTTP / SSE | 动态挂载外部 tools |
| 自动更新 | tauri-plugin-updater 2 + GitHub Releases |
latest.json + 签名 |
UI 约定遵循 DeepSeek Harness 既有组件、图标与样式（--dsw-* token），跨数据库 / SSH / Docker / AI 工作台保持视觉、交互与快捷键一致。详见 AGENTS.md § 4.4。
快捷键
| 快捷键 | 动作 |
|---|---|
Ctrl/Command + K |
聚焦顶部资产搜索 |
Ctrl/Command + P |
打开全局命令面板 |
Ctrl/Command + B |
折叠 / 展开侧边栏 |
Ctrl/Command + Shift + B |
折叠 / 展开右侧面板 |
Ctrl/Command + W |
关闭当前标签 |
Ctrl/Command + J |
打开 AI 聊天 |
Ctrl/Command + , |
打开设置 |
Ctrl/Command + S |
数据库表格批量保存（编辑模式下）/ 工作区文件保存 |
Enter |
执行当前聚焦操作或终端输入 |
Mod-Enter（SQL 编辑器） |
执行当前 SQL |
Shift-Mod-E（SQL 编辑器） |
EXPLAIN 当前 SQL |
Ctrl + Enter（终端） |
多行输入换行 |
开发运行
前置：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: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 已编排）：
npm run sidecar:build:release— Go Sidecar release 编译（产物sidecar/bin/starhub-sidecar[.exe]）npm run build:window— React 工作台 production build（输出dist-starhub-react/）npm run package:dsh-runtime— 打包 DeepSeek Harness runtime（含 dsh-web-frontend dist + 8 个本地 starhub 包 junction + 悬空链接清扫 + node_modules.d.ts/.map裁剪）cargo build --release— Rust 主进程编译- NSIS / MSI（Windows）、
.dmg/.app（macOS）、DEB / RPM / AppImage（Linux）打包
Windows 产物
| 文件 | 路径 | 用途 |
|---|---|---|
| MSI 安装包 | src-tauri/target/release/bundle/msi/StarHub_<version>_x64_en-US.msi |
企业部署 |
| NSIS 安装包 | src-tauri/target/release/bundle/nsis/StarHub_<version>_x64-setup.exe |
双击安装 |
| 单文件可执行 | src-tauri/target/release/starhub.exe |
绿色版，免安装 |
| Go Sidecar | sidecar/bin/starhub-sidecar.exe |
数据库代理进程（externalBin 注入主安装包） |
Windows CI 把工作区
subst到短盘符S:\以规避 checkout + pnpm deploy 嵌套 node_modules 的 260 字符路径上限（NSISFile /r中断）；package-dsh-runtime.ts组装后裁剪node_modules/**/*.{d.ts,d.ts.map,js.map}进一步压路径。
Linux 产物（Ubuntu 22.04 / glibc 2.35 基线）
| 文件 | 路径 | 用途 |
|---|---|---|
| DEB 安装包 | src-tauri/target/release/bundle/deb/StarHub_<version>_{amd64,arm64}.deb |
Debian/Ubuntu，通过 APT 安装并解析依赖 |
| RPM 安装包 | src-tauri/target/release/bundle/rpm/StarHub-<version>-1.{x86_64,aarch64}.rpm |
glibc 2.35+ RPM 系，通过 DNF 安装并解析依赖 |
| AppImage | src-tauri/target/release/bundle/appimage/StarHub_<version>_{amd64,aarch64}.AppImage |
主流 glibc 桌面通用版，内置 WebKitGTK/GTK/sidecar |
Linux 包必须在 Ubuntu 22.04 对应架构的原生环境构建，确保 glibc 2.35 兼容下限；AppImage 不允许交叉编译。CI 使用
ubuntu-22.04与ubuntu-22.04-armrunner，完成后执行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:22.04 \ bash -c "apt-get update && apt-get install -y libwebkit2gtk-4.1-dev ... && npx tauri build"ARM64 runner 受限于 4GB 内存，
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 子目录保持原状，分别需要专用工具链。
文档
| 文档 | 链接 | 说明 |
|---|---|---|
| 技术方案 | docs/技术方案.md | 完整技术细节、280+ 子功能矩阵 |
| 架构图 | docs/架构图.html | 可视化架构图 |
| 设计系统 | docs/设计系统.md | token / 组件类 / 反模式 |
| 已知坑索引 | docs/已知坑索引.md | 已知坑主题索引 |
| 踩坑记录 | docs/踩坑记录.md | 已知坑详细内容 |
| 更新日志 | CHANGELOG.md | 版本演进 |
| Agent 协作指引 | AGENTS.md | AI Agent / 人类贡献者快速上手 |
| 打包配置 | src-tauri/tauri.conf.json | Tauri 2 配置 |
路线图
| 阶段 | 状态 | 重点 |
|---|---|---|
| v0.18.x ~ v0.32.x | ✅ 完成 | PostgreSQL、Kafka/NSQ、Univer 深度集成、SFTP 启动策略、Linux 跨发行版兼容、Docker 资产树 DB 化 |
| v0.40.x ~ v0.49.x | ✅ 完成 | 本地工作区、服务器网页访问（SSH Web 网关）、SFTP 暂停/继续、Xshell 快捷命令导入 |
| v0.50.x ~ v0.54.x | ✅ 完成 | AI 记忆系统三期（会话存档 FTS5 → 三级记忆卡 → 自动沉淀）、多模型配置与选择器、SFTP 跟随终端 |
| v0.55.x ~ v0.59.x | ✅ 完成 | AI 会话级模型独立、useAiChatHost 统一聊天编排、@/# mention、侧边栏 AI 聊天 + 记忆、本地工作区 VSCode 化重设计 |
| v0.70.x ~ v0.79.x | ✅ 完成 | 壳内 React 工作台化、Broker / Elasticsearch / Redis / 数据库 / SSH / SFTP 弹框化、Excel 退役、dsh 联动实施、dsh 审批体系接管命令白名单 |
| v0.81.x ~ v0.87.x | ✅ 完成 | DDL / 监控 Dashboard / SQL 编辑器 / 命令广播 / 网页访问 / 主壳 AI 面板批量化接入；DSH React 工作台迁移；MFA / hostkey 内联；品牌图标升级与 README 重写 |
| 下一步 | 📋 计划中 | Settings 代理与安全 tab、SQL 结果可编辑及无主键报错（转 K3）、Oracle / MongoDB 适配、国产库 ODBC 桥、CI/CD 流水线 |
| v1.0 | 🎯 目标 | 稳定版 GA、团队协作与企业能力 |
安全提示
- 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
相关推荐Related
-
freestylefly/awesome-gpt-image-2
Prompt as Code | GPT-Image2 工业级提示词引擎与模板库，470+ 个案例逆向工程，20+ 套工业级模板，并提炼出Skills，持续更新中
-
awesome-dsh-plugin/awesome-dsh-plugin
A curated list of plugins for DeepSeek Harness (dsh) · DeepSeek Harness 插件精选列表
-
dsh-market/dsh-market
The plugin market inside DeepSeek Harness — browse, search, one-click install · DSH 可视化插件市场
-
AdamPlatin123/awesome-dsh-plugins
DSH 插件雷达与精选榜：多路自动发现 9000+ 候选，容器真实安装路径运行级实测（四档判定），精选 Top 50 · 11 类人工策展，全量索引 PLUGINS-ALL.md，自动更新。
-
Anil-matcha/awesome-dsh-plugin
A curated list of plugins for DeepSeek Harness (dsh) - DeepSeek Harness plugin ecosystem
-
0xsline/awesome-deepseek-harness
DeepSeek Harness (DSH) ecosystem: curated plugins, tools, and infrastructure from dsh-external/hub and the public dsh-pl…
-
superdesigndev/treg
OpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn
- bruc3van/awesome-dsh-plugin 用 30 秒为你的 DeepSeek Harness找到合适的插件。 仓库由脚本每天自动抓取，再经人工逐个核实——真插件进目录，蹭热度的进黑名单，每条剔除理由公开可查。并告诉你每个插件适合谁、从哪里开始。