Nexus：只需一键，与不兼容/插件错误/环境调试说拜拜。再也不担心官方更新导致各种报错了。

[chelal233]

大家好，最近做了一个开源项目 Nexus Launcher，想分享希望尝鲜/版本更新时不想折腾的朋友。

项目地址：dsh-nexus

起因很简单：我希望使用 Harness 时，可以少花一些时间处理运行环境、进程和版本切换，把精力放在实际任务上。哪怕是一台刚安装完的纯净的操作系统，只要装上启动器立马就能跑dsh，不需要思考有没有环境，要不要单独安装什么包之类的……

但方便不应该以限制选择为代价。因此，Nexus 的设计重点是：帮用户管理 Harness，同时保留用户对版本、运行环境和插件的选择权。

它能做什么？

• 准备运行环境：桌面包内置 Node/npm/pnpm，减少首次配置步骤。
• 管理 Harness 版本：准备不同的上游版本，再由用户决定什么时候切换。
• 使用自己的 Harness：除了 Nexus 管理的版本，也可以关联已经构建好的外部目录。
• 选择使用方式：可以在系统浏览器中使用，也有可选的独立窗口入口。
• 接收任务通知：提供系统通知和终端提醒，可以选择事件类型，以及“仅失焦”或“始终”提醒。
• 处理启动问题：提供启动检查、配置修复引导、诊断与恢复入口，让报错更容易定位。
• 自由选择插件市场：可以选择安装市场，也可以不装，继续按自己的方式管理插件。
• 支持将本地配置好的插件、profile、harness环境导出，在隔离互联网（简称内网环境）下一键导入，实现无缝切换、无痛恢复。

Nexus 自身更新与 Harness 版本切换是分开的，不希望更新一个启动器，就迫使用户跟着更换自己的 Harness。

平台和安装方式
目前提供 Windows、macOS 的 x64 / ARM64 构建。
Windows 除了安装包，也提供 ZIP 免安装包，完整解压后即可运行。界面和使用文档都有中文、英文版本。

下载地址：release

目前的状态
项目仍在持续迭代，欢迎试用和反馈。

这里也说明一个实际边界：Nexus 能帮助管理版本和环境，但 Harness 或插件自身的数据格式变化，仍然可能影响跨版本使用。切换版本前，重要数据建议先备份。

这次最希望收到的是实际使用反馈：

• 第一次安装和启动，是否足够清楚？
• 出错时，提示能不能帮助你找到下一步？
• 切换 Harness 版本、选择插件市场的流程，是否符合你的习惯？
• 哪些日常操作还需要反复打开终端处理？

遇到问题欢迎到 GitHub 提 Issue。附上系统、Nexus/Harness 版本和复现步骤会更方便定位，日志中的凭据记得先脱敏。

[chelal233]

Nexus v0.1.7 → v0.1.8 核心改动

1. 接入 Harness 官方桌面端
   直接启动当前受管版本自带的 Desktop，移除 Nexus 自制客户端外壳；仅在上游与当前平台支持时显示入口。
2. 优化工作台与托盘
   Web／Desktop 统一归入 Harness，明确运行状态和操作关系，保留醒目的配置切换入口。托盘补齐桌面端启动、Web／Desktop 中止、配置与维护入口。
3. 启动故障提供可执行修复方案
   区分出错插件、缺失服务和等待中的插件，根据明确证据推荐修复；支持确认后暂时禁用相关插件并重新检查，保留包和数据。
4. 完善客户端启动验证
   不再把“进程运行”或“网页可访问”直接视为启动成功。增加客户端插件与核心服务检查，明确展示检查中、功能受限、启动失败和未验证状态。
5. 减少重复运行时，改善首次启动
   Nexus 与官方 Desktop 共享匹配版本的 Electron，预组装离线依赖并复用校验缓存；准备过程增加阶段、耗时和取消操作。
6. 完善离线导出与导入
   完整离线包携带所需运行时，同系统、同架构导入后无需联网补装；修复目录迁移、Unix 可执行权限及链接恢复问题。
7. 扩展平台支持与发布验证
   完善 macOS 签名资源校验，新增 Linux ARM64 的 AppImage、DEB、RPM。五个平台均通过 CI 和安装包检查；Linux ARM64 当前提供 Nexus 图形启动器与 Web Harness，暂不提供上游未支持的官方 Desktop。

[scarlett518]

感谢分享，试下效果

[chelal233]

Nexus v0.1.8 → v0.1.9 核心改动

1. 官方桌面窗口能正常打开，托盘操作与工作台一致。 修复 Windows 上进程已经启动但窗口不显示的问题；托盘启动、停止、打开网页和终端复用工作台流程，检查结果、修复提示与状态刷新保持一致。工作台补齐 Desktop 关闭和重启，停止失败时不会继续启动第二个实例。
2. 不再把“还在启动”误报为失败。 请求等待时间覆盖后台准备和兼容性检查；通信超时后先核对实际状态，避免重复启动或误弹插件修复。“可用，有警告”会列出相关可选插件与原因。
3. Desktop 启动报错会回到 Nexus。 官方客户端配置或插件加载失败时，启动器主动提示并展开诊断，同一次失败只提醒一次。即使进程已退出、结构化记录缺失或损坏，也读取官方错误报告并保留首个错误，帮助查找缺失服务的提供方，而不是把等待中的插件全部判为故障。
4. Web 检查通过后才自动打开网页。 修复先打开报错网页、随后才提示修复的体验；核心服务未就绪时在启动器中显示原因和诊断入口，不会自动停用插件。

新增和改进的机制

1. 减少 Web 和 Desktop 的重复启动准备。 对已验证的 Harness 0.1.6-alpha.2，正常 Web 启动直接观察本次正式进程的启动信号及实际网页客户端，不再先启动隔离实例再启动正式实例。旧记录不能让新进程提前成功；手动检查、配置/版本切换检查及不支持此接口的版本仍使用隔离检查。依赖复制采用有限并行，减少重复扫描和桌面运行时重复读取，保留完整性与链接检查。同机同配置单次 Web 对比从约 67 秒降至 10.4 秒；这不是重启系统后的冷缓存测试，也不是所有机器的速度承诺。
2. 桌面端也有启动检查。 检查实际官方客户端的加载结果，不以进程存在代替成功。检查不受支持或等待过久时显示“未验证”；失败时保留官方修复入口。检查只覆盖启动阶段，不承诺捕获运行中的全部业务错误。
3. 配置与终端操作范围更清楚。 Web 显示选中的配置档，Desktop 明确使用独立的 desktop 配置，二者插件设置不会自动同步。DSH 终端打开时列出绑定配置、工作目录、数据目录、Harness 来源及 Desktop 配置目录，说明 dsh 与 npm/pnpm 的目标区别；这是打开时的快照，切换配置后应重开终端。配置档展开后按插件清单、快照清单、已保存检查点排列。
4. 更新由用户确认后下载。 发现新版本只提示可更新；点击后先打开确认窗口，确认下载后显示进度，校验完成才提供“稍后重启”与“更新并重启”。下载完成不会直接安装；应用更新前请保存工作，更新会停止 Harness 并重启 Nexus。
5. 新装插件市场默认使用 dshmarket 1.52.0。 上游修正了官方 Desktop 配置识别及部分请求来源检查，减少误操作 Web 配置的情况。该版本仅作为首次安装默认值，不自动替换已有配置中的市场，也不代表下面列出的 Desktop 包管理问题已解决。

已知缺陷与兼容边界

• 官方 Desktop 内插件市场的安装、更新或重启仍可能失败。 dshmarket 1.52.0 虽识别 Desktop 配置，但包管理操作尚未完整接入官方 Desktop 提供的环境；升级市场不能保证消除 dsh/pnpm 或重启报错。Nexus 不伪造配置来源、不强行回退 Web，也不自动改写上游插件，等待上游修复。
• 第三方命令输出乱码未作为本版通用修复交付。 排查时在单台机器验证过输出解码修正，但这不在 Nexus 安装包内，插件更新可能覆盖该本地修改。已损坏的 Harness 依赖链接也不会仅因升级 Nexus 而自动恢复；本版不宣称解决所有依赖损坏。
• 启动检查不是完整运行时监控。 “未验证”不等于确认失败，启动通过也不代表每个会话、工具、插件功能都兼容。首次准备仍受磁盘、插件数量和配置影响。
• 平台范围不扩大到上游未支持的平台。 官方 Desktop 提供 Windows x64、macOS Intel/Apple Silicon；Windows ARM64 和 Linux ARM64 提供 Web 模式。Linux ARM64 提供 AppImage、DEB、RPM，但不等于所有麒麟、统信或其他发行版均经过真机验收。
• 离线原则不变。 Nexus 自带必需运行时；取得 Harness 后，桌面准备和同系统同架构的完整离线包导入不需要联网。第三方插件下载仍需要网络，配置/数据部分包不能替代完整离线包。

[chelal233]

Nexus v0.1.9 → v0.1.10 核心改动

修复的问题

1. 检查没通过，就不会再打开报错网页。 以前 Harness 进程运行且已有 URL 时，工作台和托盘可能允许打开浏览器，即使界面同时显示“客户端未就绪”。现在工作台、托盘、通知跳转及自动打开统一要求本次客户端检查通过；执行打开动作前还会重新读取状态，防止旧按钮状态误放行。检查中、未验证、核心服务受阻时保留停止、诊断和修复入口，不把进程存在当作可用。

2. 从托盘启动也能知道结果。 Windows 使用原生托盘气泡提示正在启动、已就绪、失败或未验证，点击可回到工作台处理。通知按本次启动去重，旧进程的成功记录不能让新启动提前报喜；停止与取消也会结束对应提醒。托盘气泡已由用户在 Windows 真机验收。

3. 停止、取消和重启更一致。 Web 托盘重启复用工作台流程；启动检查中可取消，取消绑定当前启动任务，旧菜单不会取消新的任务。Desktop 工作台和托盘共用重启逻辑，停止失败不启动第二个实例；重启等待停止期间再点停止，会取消后续启动。

4. Desktop 报错也有明确处理方向。 Web 和 Desktop 共用启动错误分类，区分缺失依赖、配置损坏、接口不兼容和服务等待，保留官方错误并提供依赖检查、配置管理和日志入口。明确提示 Desktop 使用独立的 desktop 配置，不会因为某插件在等待服务就认定它有故障。

5. Windows 状态文件短暂占用不再立即判为启动失败。 Desktop 状态写入遇到短暂共享冲突时，最多约 0.5 秒有限重试，保留原子替换和旧状态，永久错误仍报告。

新增和改进的机制

1. 离线依赖修复：先预览，再确认。 维护页根据所选 Harness 的锁文件与本地包身份检查缺失链接，支持 pnpm 11 的缩短目录名。只补能验证名称和版本的缺失链接，不下载、不覆盖已有文件或损坏链接；执行前保存锁文件、相关清单和修复计划，执行后逐项记录并复检。过期预览必须重新检查，修复完成仍需启动对应模式验证。
2. 减少重复缓存等待，同时保留检查。 桌面运行时缓存检查改为最多 16 个文件系统请求并行，仍遍历全部条目、验证链接范围，损坏时仍重建。同机 8,909 项缓存的只读对比中，这一阶段从约 1.5–1.8 秒降至 0.5–0.7 秒，结果与原记录一致；不代表完整冷启动耗时或所有机器的提速幅度。
3. 能看见启动时间花在哪里。 Web 展示输入检查、兼容检查和创建进程阶段耗时；Desktop 展示准备阶段明细。结束后计时冻结，新启动重新计时，不把后续使用时间算作启动耗时。
4. 更新前可以先看具体变化。 更新确认窗口在版本号旁增加“查看更新内容”，打开对应版本的 GitHub 发布页。确认下载、进度、下载校验、稍后重启及确认安装的流程保留；隔离 Windows 更新测试覆盖中断后恢复及重启后的版本、文件摘要检查。

已知缺陷与兼容边界

• 上游 Desktop 插件市场的包管理问题仍未代修。 dshmarket 在官方 Desktop 内安装、更新或重启仍可能失败；本版没有伪造 PATH、服务或配置来源，也没有强制回退 Web，仍需上游修复。
• 依赖修复有明确范围。 只处理 Nexus 管理的 Harness 版本中可验证的本地缺失链接，外部源码、已有损坏链接、缺少包文件等情况可能需要其他修复。它不是一键重装所有依赖，也不证明所有插件启动成功。
• 启动检查不等于全面运行时监控。 未验证不等于已确认失败；检查通过不覆盖全部对话、工具和第三方插件功能。首次准备仍受磁盘、配置和插件数量影响。
• 系统通知可能被操作系统隐藏。 Windows 通知设置、勿扰模式等可能影响气泡展示，工作台和托盘状态仍保留检查结果。Windows 的用户验收不替代 macOS/Linux 通知的真机验收。
• 平台与离线原则不变。 官方 Desktop 仍面向 Windows x64、macOS Intel/Apple Silicon；Windows ARM64 和 Linux ARM64 提供 Web 模式。Linux ARM64 提供 AppImage、DEB、RPM，不保证每种信创发行版均完成真机验收。Nexus 自带运行时；下载 Harness 后及导入同系统同架构完整离线包后的准备不依赖网络，第三方插件下载仍需要联网。

[chelal233]

Nexus v0.1.10 → v1.0.0 核心改动

使用体验与修复

• Harness 未启动，也能管理和修复配置。 插件清单、启用、禁用、安装、检查及移除优先复用所选 Harness 的官方管理器和保护规则；新插件默认保持禁用，禁用不会删除依赖。旧版本保留兼容入口。
• 正常启动先运行，失败才诊断。 减少每次启动前重复拷贝和兼容检查；只有证据明确指向缺失依赖时，才允许有限修复并重试一次。配置、版本或停止操作发生变化时，旧恢复任务不会继续启动。
• 启动超时与真正失败分别留档。 超时只表示尚未确认就绪，不会擅自停止或重启仍在运行的 Harness；之后若发生真实失败，仍会保存新的错误证据。
• 修复 Desktop 的旧官方包遮蔽问题。 启动时绑定当前版本的官方模块，并备份遮蔽它们的旧官方包，避免旧 settings 提供方与新接口冲突。第三方插件和配置保持原样。
• 离线修复更可控。 配置修复提供预览、备份、复查与恢复路径；不以禁用所有等待服务的插件代替定位。Node、pnpm 和 Git 优先使用明确指定的路径，否则使用内置工具，未采用系统环境优先的新规则。
• 版本切换更直接。 安装准备完成后可直接切换至该版本；上游 0.1.7 的兼容判断按实际能力和构建目标处理，不用版本白名单决定启动加速。
• 配置与历史记录更清晰。 快照、检查点按本机时区显示时间，详情使用抽屉并提供可读配置和源码视图；补齐插件版本、仓库链接、问题标记及删除相关入口。
• 设置错误不再静默忽略。 修复随机端口 0 等配置传递问题；明确工具路径覆盖的适用范围，日志级别或系统开机启动设置失败时显示原因。

离线工具与分发材料

• 内置完整 Git 命令行、SSH 和 Git LFS，不捆绑可选 GCM 网页登录助手及其依赖。不会修改用户系统或全局 Git 配置；需要额外登录助手时可显式指定自行配置的 Git。
• 运行所需工具仍随 Nexus 提供。Git 及相关组件的对应源码作为独立附件与安装包一同提供，不计入日常运行时加载；再次分发二进制时应同时满足其源码交付条件。
• 发行流程校验通知原文摘要、源码清单、源码附件和安装包来源，材料不完整时不放行发布。

已知限制与验收范围

• Nexus 负责启动、就绪判断及离线修复，不承诺捕获所有第三方插件运行时错误。会话管理插件历史 JSON 错误在隔离官方 Desktop 后端中未复现：相关接口返回 200 和有效 JSON，不能据此宣称原故障已修复或确认上游有错。
• 官方 Desktop 仅在上游与 Electron 支持的交集内启用。Nexus 支持某个平台，不等于对应 Harness 提供该平台的 Desktop。
• 切回旧 Harness 槽位不会降级上游会话数据格式；升级前请保留数据备份。
• 自动化测试、真实子进程测试、Windows 隔离安装升级与五平台 CI 分开记录；跳过项不计通过。CI 安装包冒烟不替代所有发行版、输入法、显示器和完整业务流程的真机验收。