组件安装中心 Iraryi/deepseek-harness-hub

DeepSeek Harness HUB

Everything is a Setup，一切皆安装。
用一个原生桌面控制中心发现、理解、安装、更新、修复并组合 DeepSeek Harness 生态。

English ·下载 · Setup 规范 ·参与贡献

[!IMPORTANT]
这是独立的社区发行与生态项目。DeepSeek Harness 本体由上游 deepseek-ai/deepseek-harness 开发。

一个 HUB，三层职责

| 层级 | 用户看到的东西 | 实际职责 |
| HUB 程序 | 原生桌面市场与组件管理器 | 汇总 DSHMK、精选源、GitHub、STAR、本地包、已安装组件、更新、修复和重启流程 |
| Setup Registry | 统一的 Setup 式安装页面 | 安装前展示来源身份、许可、证书/签名状态、权限、联网行为、安装证据、选项、回滚和兼容性 |
| HUB 发行层 | HUB Setup、HUB Runtime、开发构建 | 提供独立 Windows WebView2 宿主、HUB CONFIG、私有 Node.js 与离线修复 |

HUB 不会宣称任意 GitHub 源码都能直接变成可靠 EXE。在线项目会以可检查配方驱动的虚拟 Setup 界面呈现；独立 Setup EXE 属于经过验证的精选库，至少要通过安装、启动、更新和卸载回归。

下载选择

Windows 成品统一发布在 Releases。

| 资产 | 适合人群 | 网络要求 |
| Full Setup | 电脑小白、首次安装、网络不稳定 | 可离线安装内置 Runtime 与 WebView2 |
| Overlay Setup（预览） | 为已有兼容 DSH 安装增加增强功能 | 复用明确选择的 alpha.2 Runtime；独立安装，不替换本体文件 |
| Lite Setup | 希望先下载较小安装器 | 在线下载并校验 Runtime，也能导入手动下载的 Runtime ZIP |
| Portable ZIP | 试用、移动硬盘、免安装场景 | 电脑需已有 WebView2 |
| Runtime ZIP | 修复、离线搬运、Lite Setup 导入 | 自身不带安装向导 |

Full 已包含 HUB 管理概览、可选桌面增强、内嵌 CONFIG 和主动开启的局域网手机连接，不需要另外安装 Overlay。增强路线图 区分已实现能力与未来的官方 Desktop 适配。手机连接目前使用可信私人局域网内的未加密 HTTP，不是公网隧道。部分已有有效安装参考的目录项目仍需修复一键安装判定，详见当前 Release 的已知问题。

体验原则

- HUB 独立进程：与主程序拥有不同任务栏身份、图标、窗口和生命周期。
- 证据完整：详情页显示来源、版本/提交、许可证、证书状态、验证结果、安装参考、权限、依赖和预期文件变更。
- 能一键就一键：识别明确的项目使用确定性配方；网络不可靠时始终保留手动下载与导入。
- 不假装成功：不支持或安装方式模糊的项目进入辅助 Setup 流程，而不是转圈后留下半成品目录。
- 集合分离：已安装、待安装、离线、STAR、本地构建包各自管理，互不污染。
- 便于二次开发：组件暴露编辑路径和清单，便于交给 AI 或开发者定制，而不把“编辑”和“发现”混在一起。

架构

flowchart LR
Sources["DSHMK · Curated · GitHub · Local"] --> Normalize["Catalog normalizer"]
Normalize --> Evidence["Evidence + compatibility model"]
Evidence --> Hub["Native HUB application"]
Registry["Setup Registry v1"] --> Hub
Hub --> Virtual["Virtual Setup renderer"]
Hub --> Standalone["Vetted standalone Setup EXE"]
Virtual --> Runtime["DeepSeek Harness Desktop runtime"]
Standalone --> Runtime
Runtime --> Profiles["Desktop profile · HUB profile"]

详细说明见架构文档与桌面发行边界。

仓库定位

.
├─ apps/ DSH command and application entry points
├─ packages/ HUB Web UI, Setup protocol, registry, and shared DSH packages
├─ windows/ Native HUB host, Runtime, Setup builder, and release assembly
├─ registry/ Public first-party Setup catalog and JSON Schema
├─ examples/setup-package/ Minimal authoring example
├─ examples/setup-workspace/ Editable source/build/component workspace example
├─ snapshots/ Full-screen bilingual development snapshots
├─ docs/ Architecture, catalog, release, and package specifications
├─ scripts/ Dependency-free repository validation
└─ .github/ CI, issue forms, pull request policy, and release notes config

HUB 的实现就是本仓库根项目。原生宿主、Runtime、Setup 构建器、Web UI、Setup 协议、目录适配器、测试和全部共享 DSH 包都可以直接在这里修改；准确位置见源码地图。deepseek-harness-desktop 是独立的 Desktop 发行项目，不是 HUB 的源码仓库或发布中心。

从源码构建 HUB

npm run build:hub

构建脚本会检查 Node.js、pnpm 和 WebView2 SDK 等前置条件，并把结果写入仓库根目录的 dist/。开发者可以直接在根目录 pnpm 工作区修改 Web UI、原生宿主、Runtime、目录同步或 Setup 引擎。

发布一个 Setup

1. 阅读 Setup 包规范。
2. 从 examples/setup-package/manifest.json 开始。如果需要本地或 AI 辅助编辑构建，继续阅读 Custom Setup Workspaces，并从 examples/setup-workspace/manifest.json 开始。
3. 本地执行 npm run validate。
4. 创建 Setup submission Issue 并附安装证据。
5. 安装与卸载行为稳定后提交 PR。

独立 EXE 还必须提供哈希、发布者、提权声明、干净系统安装日志、启动证据、更新行为和卸载残留说明。

状态

项目仍处于早期 Release Candidate 阶段。Registry v1 有意保持保守：数据模型已经足够稳定，可供工具使用；目录内容和 Desktop UX 仍在快速演进。

开源许可

本仓库代码与第一方规范使用最宽松的 MIT License。第三方包继续遵循各自许可证；进入目录不改变原作者、所有权或许可关系。