@qpjoy/electron-launcher-app-h2o
v2.3.0
Published
Home To Oversea embed network plugin for MX-H2I AppCenter.
Readme
MX App H2O
@qpjoy/electron-launcher-app-h2o is H2O: Home To Oversea, the first
MX-H2I AppCenter built-in embed network plugin. The product direction is a
Clash-like user tool for proxy mode, PAC, Split DNS, rule status, and Internal
access visibility, while the actual privileged network work remains owned by
the MX-H2I standalone broker.
It is intentionally a normal npm-style Electron package: AppCenter can record the package name and version in Internal, cache the installed package locally, then open its entrypoint through the MX-H2I broker-session.
The default screen is user-facing: connection health, proxy mode, DNS/PAC
status, and recent activity are visible without exposing launcher internals.
Developers and support users can click Debug to inspect inherited MX-H2I
context such as broker session, socket path, package metadata, network scope,
local IP, and capability bridge state.
Development Test
From electron-dock/mx-launcher:
pnpm --filter @qpjoy/electron-launcher-app-h2o check
pnpm --filter @qpjoy/electron-launcher-app-h2o devThe demo starts with a development broker registry so UI and broker-session states can be tested without a production socket. To verify the blocked embed path:
MX_H2O_BROKER_MODE=off pnpm --filter @qpjoy/electron-launcher-app-h2o devAppCenter Link
MX-H2I ships H2O in its default AppCenter catalog:
appId:h2opackageName:@qpjoy/electron-launcher-app-h2olauncherMode:embedstandaloneChannelProductId:mx-h2inetworkScope:broker-sessionruntimeContractVersion:0.1requiredCapabilities:user.session,network.status,network.proxy,network.dns.policy,network.pac.policy,app-center-runtimeentrypoints.dev:workspace:demos/mx-app-h2o
In development, open MX-H2I, connect as guest or employee, install AppCenter,
then install H2O from AppCenter. MX-H2I resolves entrypoints.dev to this
workspace package, records the installed version and path in its local cache,
and keeps operational details available from AppCenter's Debug button. Run
this package with pnpm --filter @qpjoy/electron-launcher-app-h2o dev to test
the embed UI directly.
In production, Internal admin should upsert the AppCenter record with the same
package name and the release version. The client-side AppCenter cache stores
installedVersion, latestVersion, installSource, entrypoints, install
path, last action, and recent logs; the remote DB keeps the authoritative latest
package/version and access policy.
