electerm 5.5.15 → 5.5.35

package/README.md

@@ -1,263 +1,152 @@
 <h1 align="center" style="padding-top: 60px;padding-bottom: 40px;">
     <a href="https://electerm.org">
-        <img src="https://github.com/electerm/electerm-resource/raw/master/static/images/electerm.png", alt="" />
+        <img src="https://github.com/electerm/electerm-resource/raw/master/static/images/electerm.png" alt="electerm" />
     </a>
 </h1>
 
-[![GitHub version](https://badgers.space/github/release/electerm/electerm?corner_radius=m)](https://github.com/electerm/electerm/releases)
-[![Build Status](https://github.com/electerm/electerm/actions/workflows/mac-test-1.yml/badge.svg)](https://github.com/electerm/electerm/actions)
-[![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/electerm/electerm/blob/master/LICENSE)
-[![GitHub Sponsors](https://img.shields.io/github/sponsors/electerm?label=Sponsors)](https://github.com/sponsors/electerm)
-[![star](https://atomgit.com/electerm/electerm/star/badge.svg)](https://atomgit.com/electerm/electerm)
-
-[English](README.md) | [中文](build/docs/README_cn.md) | [日本語](build/docs/README_jp.md)
-
-Open-sourced terminal/ssh/sftp/telnet/serialport/RDP/VNC/Spice/ftp client(Linux, Mac, Windows, Android, HarmonyOS, iOS).
-
-Besides mainstream Windows/macOS/Linux/Android, electerm also supports HarmonyOS, iOS, and older systems — Ubuntu 18, Windows 7, macOS 10+, and special Chinese Linux distributions such as UOS, Kylin, and LoongArch (both old-world and new-world).
-
-<p>
-  <a href="https://electerm.org">Homepage / Downloads</a> ·
-  <a href="https://theme.electerm.org">Theme</a> ·
-  <a href="https://github.com/electerm/electerm-web-docker">Docker</a> ·
-  <a href="https://demo.electerm.org">Online demo</a> ·
-  <a href="https://github.com/electerm/electerm-android">Android</a> ·
-  <a href="https://github.com/electerm/electerm-harmony">HarmonyOS</a> ·
-  <a href="https://apps.apple.com/cn/app/electerm/id6792971552">Apple App Store</a> ·
-  <a href="https://appgallery.huawei.com/app/detail?id=org.electerm.electerm">Huawei AppGallery</a> ·
-  <a href="https://www.microsoft.com/store/apps/9NCN7272GTFF">Microsoft Store</a> ·
-  <a href="https://snapcraft.io/electerm">Snap Store</a> ·
-  <a href="https://repos.electerm.org/deb">deb repo</a> ·
-  <a href="https://repos.electerm.org/rpm">rpm repo</a>
-</p>
-
-<div>🌐 <strong><a href="https://cloud.electerm.org">electerm online</a></strong> — Public free online electerm app</div>
-<div>🤖 <strong><a href="https://ai.electerm.org">electerm AI</a></strong> — Free AI for electerm users</div>
-<div>💻 <strong><a href="https://github.com/electerm/electerm-web">electerm-web</a></strong> — Web app version running in browser (including mobile device)</div>
-
-## Sponsors
-
-<div align="center">
-  <a href="https://www.atlascloud.ai/?ref=PCAEL2&utm_source=github&utm_medium=link&utm_campaign=electerm">
-    <img src="https://github.com/electerm/electerm-resource/blob/master/static/images/atlas-cloud.png?raw=true" alt="Atlas Cloud" height="200" />
-  </a>
-</div>
-
-[Atlas Cloud](https://www.atlascloud.ai/?ref=PCAEL2&utm_source=github&utm_medium=link&utm_campaign=electerm) provides OpenAI-compatible AI APIs and model access for AI-powered workflows in electerm.
-
-----
-
-<div align="center">
-  <br />
-  <br />
-  <a href="https://go.apimart.ai/gh-electerm">
-    <img src="https://github.com/electerm/electerm-resource/blob/master/static/images/apimart.jpg?raw=true" alt="ApiMart" width="200" />
-  </a>
-  <br />
-  <br />
-</div>
-
-Thanks to APIMart for sponsoring electerm! APIMart is a low-cost API platform for AI image & video generation — GPT-Image-2 from $0.006/image, 160+ images per dollar. One async API covers both image and video: submit a task, get an ID, fetch results via polling or callback. Batch tens of thousands of images without timeouts, switch models without changing code. Pay-as-you-go with no monthly fee — [sign up here to get started](https://go.apimart.ai/gh-electerm).
-
-----
-
-<div align="center">
-  <a href="https://www.apismart.ai">
-    <img src="https://github.com/electerm/electerm-resource/blob/master/static/images/apismart400x400.png?raw=true" alt="ApiSmart" width="200" />
-  </a>
-</div>
-
-[ApiSmart](https://www.apismart.ai) provides unified access to leading AI models through a single API. Use one API key to connect with LLM, image, and video models through an OpenAI-compatible interface, without managing multiple providers separately. Switch models easily, simplify billing, and improve reliability with intelligent routing and automatic failover. Build and scale AI applications faster with one streamlined API platform.
-
-----
-
-<div align="center">
-
-<a href="https://www.digitalocean.com/?refcode=c10bcb28b846&utm_campaign=Referral_Invite&utm_medium=Referral_Program&utm_source=badge"><img align="middle" src="https://web-platforms.sfo2.cdn.digitaloceanspaces.com/WWW/Badge%202.svg" alt="DigitalOcean Referral Badge" /></a>&nbsp;&nbsp;&nbsp;<a href="https://oss-directory.vercel.app"><img align="middle" src="https://github.com/electerm/electerm-resource/blob/master/static/images/vercel-oss-2005.png?raw=true" alt="Vercel OSS Program" /></a>
-
-</div>
-
-<div align="center">
-    <img src="https://github.com/electerm/electerm-resource/raw/master/static/images/electerm-banner-1.jpg", alt="" />
-</div>
-
-## Features
-
-- Works as a terminal/file manager, ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client
-- Support Window 7+(X64/ARM64), HarmonyOS，Android, iOS, Mac OS 10.15+(x64/arm64), Linux(x64/arm64/Loong64 new world & old world), even old Linux with glibc 2.17+ like UOS/Kylin/Ubuntu 18.04 etc
-- Global hotkey to toggle window visibility (similar to guake, default is `ctrl + 2`)
-- 🇺🇸 🇨🇳 🇧🇷 🇷🇺 🇪🇸 🇫🇷 🇹🇷 🇭🇰 🇯🇵 🇸🇦 🇩🇪 🇰🇷 🇮🇩 🇵🇱 Multi-language support([electerm-locales](https://github.com/electerm/electerm-locales), contributions/fixes welcome)
-- Double click to directly edit (small) remote files.
-- All kind of auth methods: publicKey, password, ssh agent, certificates, otp, netbird etc.
-- Support Zmodem(rz, sz), and [Trzsz](https://github.com/trzsz/trzsz)(trz/tsz).
-- Support ssh related features: tunnel, connection hopping.
-- Customizable UI: themes, background image, transparent window(Mac, win).
-- Global/session proxy.
-- Quick commands/triggers to do predefined tasks and automattic operations
-- Sync data including bookmarks to github/gitee secret gist/webdav/custom server/electerm cloud
-- Quick input/mirror input to one or all terminals.
-- AI assistant integration (supporting multiple LLM API formats — OpenAI Chat Completions, OpenAI Responses, and Anthropic Messages) to help with command suggestions, script writing, and explaining selected terminal content, create bookmarks/themes, and agent mode to directly do terminal operations
-- MCP (Model Context Protocol) widget for AI assistants and external tools integration - see [MCP Widget Usage Guide](https://github.com/electerm/electerm/wiki/MCP-Widget-Usage-Guide)
-- Deep link support: Open connections with URLs like `telnet://192.168.2.31:34554` or `ssh://user@host:22` - see [Deep link support wiki](https://github.com/electerm/electerm/wiki/Deep-link-support)
-- Command line usage: check [wiki](https://github.com/electerm/electerm/wiki/Command-line-usage)
+[![npm version](https://img.shields.io/npm/v/electerm.svg)](https://www.npmjs.com/package/electerm)
+[![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/electerm/electerm-npm/blob/master/LICENSE)
+[![GitHub release](https://badgers.space/github/release/electerm/electerm?corner_radius=m)](https://github.com/electerm/electerm/releases)
 
-## Install
+[English](https://github.com/electerm/electerm-npm/blob/master/README.md) | [中文](https://github.com/electerm/electerm-npm/blob/master/README_cn.md)
 
-- For Mac user: `brew install --cask electerm`
-- With snap: `sudo snap install electerm --classic`
-- For some Linux distribution, you can find it from OS default App store(Ubuntu, Deepin, Mint...).
-- For some linux OS, the `rpm`, `deb`, or `snap` release may not work, you can try the `tar.gz` or `.appImage` release.
-- For Windows users, you can install it from [windows store](https://www.microsoft.com/store/apps/9NCN7272GTFF), command-line installer [winget](https://github.com/microsoft/winget-cli) and [scoop](https://github.com/lukesampson/scoop) is also recommended:
+> This is the **npm installer for electerm**, not the electerm app itself.
+> The app source lives in [electerm/electerm](https://github.com/electerm/electerm).
+> This repo ([electerm/electerm-npm](https://github.com/electerm/electerm-npm)) only contains the npm installer and its publish workflow.
 
-```powershell
-# winget https://github.com/microsoft/winget-cli
-winget install electerm.electerm
+## What is this?
 
-# scoop https://github.com/lukesampson/scoop
-scoop bucket add dorado https://github.com/chawyehsu/dorado
-scoop install dorado/electerm
-```
+`npm i -g electerm` installs a small installer that detects your OS / CPU architecture, downloads the matching prebuilt electerm binary from [electerm releases](https://github.com/electerm/electerm/releases), and launches it via the `electerm` command.
 
-- Install from Debian repository (for Debian/Ubuntu-based systems) with `apt` command
+The package version always tracks the electerm release version, so `electerm@5.5.16` installs the `v5.5.16` binaries.
 
-Check [https://repos.electerm.org/deb](https://repos.electerm.org/deb)
+## Install
 
-- Install from npm
+Requirements: Node.js >= 16.
 
 ```bash
 npm i -g electerm
-
 ```
 
-## Upgrade
+This runs `postinstall` (`node npm/install.js`), which downloads the binary for your platform. No manual download needed.
 
-- Auto upgrade: When a new version is released, you will get an upgrade notification after you start electerm again. You can then click the upgrade button to upgrade.
-- Download: Just download the latest edition, reinstall.
-- Npm: If you install from npm, just run `npm i -g electerm` again.
-- If use Snap or some other distribution system, these systems may provide upgrades.
+If the download fails (network / proxy), you can retry without reinstalling the package:
 
-## Known issues
+```bash
+node "$(npm root -g)/electerm/npm/install.js"
+```
 
-[https://github.com/electerm/electerm/wiki/Know-issues](https://github.com/electerm/electerm/wiki/Know-issues)
+### Use a GitHub proxy (optional)
 
-## Troubleshoot
+If `github.com` is slow or blocked, set `GITHUB_PROXY` before installing:
 
-[https://github.com/electerm/electerm/wiki/Troubleshoot](https://github.com/electerm/electerm/wiki/Troubleshoot)
+```bash
+GITHUB_PROXY=https://your-proxy.example npm i -g electerm
+```
 
-## Discussion
+Only `github.com` URLs are proxied.
 
-[![Discord](https://img.shields.io/badge/Discord-Join-blue?logo=discord)](https://discord.gg/855W7g8EVd)
+## Usage
 
-[Discussion board](https://github.com/electerm/electerm/discussions)
+```bash
+electerm
+```
 
-![electerm-wechat-group-qr.jpg](https://electerm.org/electerm-wechat-group-qr.jpg)
+- macOS: installs `electerm.app` into `/Applications`, then launches `/Applications/electerm.app/Contents/MacOS/electerm`.
+- Windows: launches `<global-node-modules>/electerm/electerm/electerm.exe`.
+- Linux: launches `<global-node-modules>/electerm/electerm/electerm` (adds `--no-sandbox` automatically unless `chrome-sandbox` is root-owned with mode `4755`).
 
-## Support
+Extra CLI args are passed through to the app, e.g. `electerm --help`.
 
-Would love to hear from you, please tell me what you think, [submit an issue](https://github.com/electerm/electerm/issues), [Start a new discussion](https://github.com/electerm/electerm/discussions/new), [create/fix language files](https://github.com/electerm/electerm-locales) or create pull requests, all welcome.
+## Upgrade / reinstall / uninstall
 
-## Sponsor this project
+```bash
+# upgrade to latest
+npm i -g electerm@latest
 
-github sponsor
+# install a specific version (matches electerm release tag vX.Y.Z)
+npm i -g electerm@5.5.16
 
-[https://github.com/sponsors/electerm](https://github.com/sponsors/electerm)
+# force re-download the binary for the current version
+node "$(npm root -g)/electerm/npm/install.js"
 
-kofi
+# uninstall
+npm rm -g electerm
+```
 
-[https://ko-fi.com/zhaoxudong](https://ko-fi.com/zhaoxudong)
+On macOS, uninstalling the npm package does not remove `/Applications/electerm.app` — delete it manually if needed.
 
-wechat donate
+## Supported platforms
 
-[![wechat donate](https://electerm.org/electerm-wechat-donate.png)](https://github.com/electerm)
+| OS | Arch | Asset installed |
+| --- | --- | --- |
+| Windows 10+ | x64, ia32 | `electerm-<ver>-win-x64.tar.gz` |
+| Windows 10+ | arm64 | `electerm-<ver>-win-arm64.tar.gz` |
+| Windows 7 | x64 | `electerm-<ver>-win7.tar.gz` |
+| macOS 11+ | x64 | `electerm-<ver>-mac-x64.dmg` |
+| macOS 11+ | arm64 | `electerm-<ver>-mac-arm64.dmg` |
+| macOS 10.x | x64 | `electerm-<ver>-mac10-x64.dmg` |
+| Linux | x64, arm64, armv7l, loong64 | `electerm-<ver>-linux-<arch>.tar.gz` |
+| Linux (glibc < 2.34) | x64, arm64, armv7l, loong64 | `electerm-<ver>-linux-<arch>-legacy.tar.gz` |
+| Linux | riscv64, ppc64le | `electerm-<ver>-linux-<arch>.tar.gz` (no legacy variant) |
 
-TRON TRN20
+Notes:
 
-[![TRN20 donate](https://github.com/electerm/electerm-resource/blob/master/static/images/trn20.png?raw=true)]
+- 32-bit Node (`ia32`) on a 64-bit host installs the 64-bit build.
+- On Linux with glibc < 2.34 (e.g. UOS / Kylin / Ubuntu 18.04), the `-legacy` (glibc 2.17+) build is picked automatically where published.
+- `riscv64` / `ppc64le` (little-endian only) have no `-legacy` build; the standard build is used even on old glibc.
+- On Linux you may optionally enable the Electron sandbox:
+  `sudo chown root:root <pkg>/electerm/chrome-sandbox && sudo chmod 4755 <pkg>/electerm/chrome-sandbox`.
 
-Address: TXk3pQNmQu1vihH76RaEFnK9wg13x4LLCZ
+## How it works
 
-## Dev
+1. `postinstall` reads the latest version from `https://electerm.org/version.html` and the release asset list from `https://electerm.org/data/electerm-github-release.json`.
+2. It resolves the asset for `os.platform()` / `os.arch()` (plus win7 / mac10 / linux-legacy detection).
+3. It downloads and extracts it to `<package>/electerm/` (Linux/Windows) or installs the `.app` to `/Applications` (macOS).
+4. The `electerm` bin script (`npm/electerm`) finds and launches that binary.
 
-```bash
-# May only works in Linux
-# needs nodejs/npm, suggest using nvm to install nodejs/npm
-# with nodejs 24.x
+Publishing is driven by the electerm release itself via [`npm.yml`](https://github.com/electerm/electerm-npm/blob/master/.github/workflows/npm.yml) — see [CONTRIBUTING.md](https://github.com/electerm/electerm-npm/blob/master/CONTRIBUTING.md).
 
-git clone git@github.com:electerm/electerm.git
-cd electerm
-npm config set legacy-peer-deps true
-npm i
+## About electerm
 
-# start vite dev server, requires port 5570
-npm start
+Electerm is an open-sourced terminal / ssh / sftp / telnet / serialport / RDP / VNC / Spice / ftp client for Linux, Mac, Windows, Android, HarmonyOS and iOS.
 
-# in a separate terminal session run app
-npm run app
+It also supports older / special systems: Ubuntu 18, Windows 7, macOS 10+, UOS / Kylin / LoongArch (old-world and new-world), riscv64 and ppc64le Linux.
 
-# code format check
-npm run lint
+Highlights (full docs in the [main repo](https://github.com/electerm/electerm)):
 
-# code format fix
-npm run fix
-```
-
-## Test
+- Terminal + file manager, ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice
+- Global hotkey to toggle window (`ctrl + 2` by default)
+- Multi-language support ([electerm-locales](https://github.com/electerm/electerm-locales))
+- Public key / password / ssh-agent / certificate / OTP auth, tunnels, jump hosts
+- Zmodem (`rz`/`sz`) and [trzsz](https://github.com/trzsz/trzsz) (`trz`/`tsz`)
+- Themes, transparency, background image
+- Global / session proxy, quick commands, sync via gist / webdav / electerm cloud
+- AI assistant, MCP widget, deep links (`ssh://`, `telnet://`), CLI usage
 
-```bash
-npm run b
-npm run prepare-test
-cp ./build/.sample.env ./.env
+Related links / projects:
 
-# edit .env, fill your test host/username/password, may only works in mac OS
-npm run test
-```
+- [Homepage / downloads](https://electerm.org) · [Releases](https://github.com/electerm/electerm/releases) · [Videos](https://electerm.org/videos)
+- [Theme](https://theme.electerm.org) · [Docker](https://github.com/electerm/electerm-web-docker) · [Online demo](https://demo.electerm.org)
+- [Android](https://github.com/electerm/electerm-android) · [HarmonyOS](https://github.com/electerm/electerm-harmony) · [Web version](https://github.com/electerm/electerm-web)
+- [electerm online](https://cloud.electerm.org) · [electerm AI](https://ai.electerm.org)
+- [Apple App Store](https://apps.apple.com/cn/app/electerm/id6792971552) · [Huawei AppGallery](https://appgallery.huawei.com/app/detail?id=org.electerm.electerm) · [Microsoft Store](https://www.microsoft.com/store/apps/9NCN7272GTFF) · [Snap Store](https://snapcraft.io/electerm)
+- [deb repo](https://repos.electerm.org/deb) · [rpm repo](https://repos.electerm.org/rpm)
 
-## Test build
+## Issues / support
 
-```bash
-# May only works in Linux
-# Install yarn first(to do yarn autoclean)
-# See https://yarnpkg.com/en/docs/install
-
-# Build linux only with -l
-npm i
-npm run b
-npm run pb
-./node_modules/.bin/electron-builder --linux tar.gz
-# or replace tar.gz to rpm/deb/AppImage
-# check dist/ folder
-
-# build for linux arm/
-./node_modules/.bin/electron-builder --linux --arm64
-```
+- Installer problems (`npm i -g electerm` fails, wrong binary, launch failure): open an issue in [electerm-npm](https://github.com/electerm/electerm-npm/issues).
+- App bugs / feature requests: open an issue in [electerm/electerm](https://github.com/electerm/electerm/issues) or start a [discussion](https://github.com/electerm/electerm/discussions).
+- Language files: [electerm-locales](https://github.com/electerm/electerm-locales).
 
-## Video guide
+## Contributing
 
-- [https://electerm.org/videos](https://electerm.org/videos)
+This repo only holds the installer (`npm/`) and the publish workflow. See [CONTRIBUTING.md](https://github.com/electerm/electerm-npm/blob/master/CONTRIBUTING.md) for layout, tests (`npm test`, `npm run test-network`, `npm run pack-check`) and the release-driven publishing flow.
 
 ## Change log
 
-Visit [Releases](https://github.com/electerm/electerm/releases).
-
-## Contact author
-
-[zxdong@gmail.com](mailto:zxdong@gmail.com)
-
+See [electerm releases](https://github.com/electerm/electerm/releases) — the npm version tracks it 1:1.
 
 ## License
 
 MIT
-
-## Star History
-
-<p>
- <a href="https://www.star-history.com/electerm/electerm"><img src="https://api.star-history.com/badge?repo=electerm/electerm" alt="Star History Rank" /></a>
-</p>
-
-<a href="https://www.star-history.com/?repos=electerm%2Felecterm&type=date&legend=top-left">
- <picture>
-   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=electerm/electerm&type=date&legend=top-left&sealed_token=DvPlttPaLtq6RPIWRANYX08-8ZJyrJalhombrkDcg1IwWOMPMIplgi85q0FiwrbhE3lRIi_yxvOWdell731CGQvzlfJMt2Sa6VfCvQ80BwEtQ6RpPchEiw" />
-   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=electerm/electerm&type=date&legend=top-left&sealed_token=DvPlttPaLtq6RPIWRANYX08-8ZJyrJalhombrkDcg1IwWOMPMIplgi85q0FiwrbhE3lRIi_yxvOWdell731CGQvzlfJMt2Sa6VfCvQ80BwEtQ6RpPchEiw" />
-   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=electerm/electerm&type=date&legend=top-left&sealed_token=DvPlttPaLtq6RPIWRANYX08-8ZJyrJalhombrkDcg1IwWOMPMIplgi85q0FiwrbhE3lRIi_yxvOWdell731CGQvzlfJMt2Sa6VfCvQ80BwEtQ6RpPchEiw" />
- </picture>
-</a>

package/README_cn.md

@@ -0,0 +1,152 @@
+<h1 align="center" style="padding-top: 60px;padding-bottom: 40px;">
+    <a href="https://electerm.org">
+        <img src="https://github.com/electerm/electerm-resource/raw/master/static/images/electerm.png" alt="electerm" />
+    </a>
+</h1>
+
+[![npm version](https://img.shields.io/npm/v/electerm.svg)](https://www.npmjs.com/package/electerm)
+[![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/electerm/electerm-npm/blob/master/LICENSE)
+[![GitHub release](https://badgers.space/github/release/electerm/electerm?corner_radius=m)](https://github.com/electerm/electerm/releases)
+
+[English](https://github.com/electerm/electerm-npm/blob/master/README.md) | [中文](https://github.com/electerm/electerm-npm/blob/master/README_cn.md)
+
+> 这是 **electerm 的 npm 安装器**，不是 electerm 应用本身。
+> 应用源码在 [electerm/electerm](https://github.com/electerm/electerm)。
+> 本仓库（[electerm/electerm-npm](https://github.com/electerm/electerm-npm)）只包含 npm 安装器和发布流程。
+
+## 这是什么？
+
+`npm i -g electerm` 会安装一个小安装器：自动识别你的操作系统 / CPU 架构，从 [electerm releases](https://github.com/electerm/electerm/releases) 下载对应的预编译二进制包，并通过 `electerm` 命令启动。
+
+包版本与 electerm 发行版版本一一对应，例如 `electerm@5.5.16` 安装的就是 `v5.5.16` 的二进制包。
+
+## 安装
+
+要求：Node.js >= 16。
+
+```bash
+npm i -g electerm
+```
+
+安装过程会自动执行 `postinstall`（`node npm/install.js`）下载对应平台的二进制包，无需手动下载。
+
+如果下载失败（网络 / 代理问题），无需重装包，直接重试即可：
+
+```bash
+node "$(npm root -g)/electerm/npm/install.js"
+```
+
+### 使用 GitHub 代理（可选）
+
+如果 `github.com` 访问缓慢或被屏蔽，可在安装前设置 `GITHUB_PROXY`：
+
+```bash
+GITHUB_PROXY=https://your-proxy.example npm i -g electerm
+```
+
+只有 `github.com` 的 URL 会走代理。
+
+## 使用
+
+```bash
+electerm
+```
+
+- macOS：把 `electerm.app` 安装到 `/Applications`，然后启动 `/Applications/electerm.app/Contents/MacOS/electerm`。
+- Windows：启动 `<global-node-modules>/electerm/electerm/electerm.exe`。
+- Linux：启动 `<global-node-modules>/electerm/electerm/electerm`（除非 `chrome-sandbox` 已是 root 属主且权限为 `4755`，否则会自动加上 `--no-sandbox`）。
+
+多余的命令行参数会透传给应用，例如 `electerm --help`。
+
+## 升级 / 重装 / 卸载
+
+```bash
+# 升级到最新版
+npm i -g electerm@latest
+
+# 安装指定版本（对应 electerm 发行版 tag vX.Y.Z）
+npm i -g electerm@5.5.16
+
+# 强制重新下载当前版本的二进制包
+node "$(npm root -g)/electerm/npm/install.js"
+
+# 卸载
+npm rm -g electerm
+```
+
+macOS 上卸载 npm 包不会删除 `/Applications/electerm.app`，如需删除请手动处理。
+
+## 支持的平台
+
+| 系统 | 架构 | 安装的包 |
+| --- | --- | --- |
+| Windows 10+ | x64, ia32 | `electerm-<ver>-win-x64.tar.gz` |
+| Windows 10+ | arm64 | `electerm-<ver>-win-arm64.tar.gz` |
+| Windows 7 | x64 | `electerm-<ver>-win7.tar.gz` |
+| macOS 11+ | x64 | `electerm-<ver>-mac-x64.dmg` |
+| macOS 11+ | arm64 | `electerm-<ver>-mac-arm64.dmg` |
+| macOS 10.x | x64 | `electerm-<ver>-mac10-x64.dmg` |
+| Linux | x64, arm64, armv7l, loong64 | `electerm-<ver>-linux-<arch>.tar.gz` |
+| Linux（glibc < 2.34） | x64, arm64, armv7l, loong64 | `electerm-<ver>-linux-<arch>-legacy.tar.gz` |
+| Linux | riscv64, ppc64le | `electerm-<ver>-linux-<arch>.tar.gz`（无 legacy 版本） |
+
+说明：
+
+- 64 位机器上的 32 位 Node（`ia32`）会安装 64 位构建。
+- glibc < 2.34 的 Linux（如 UOS / 麒麟 / Ubuntu 18.04），在有 `-legacy`（glibc 2.17+）构建时会自动选用。
+- `riscv64` / `ppc64le`（仅小端）没有 `-legacy` 构建，即使是旧 glibc 也会用标准构建。
+- Linux 可选开启 Electron sandbox：
+  `sudo chown root:root <pkg>/electerm/chrome-sandbox && sudo chmod 4755 <pkg>/electerm/chrome-sandbox`。
+
+## 工作原理
+
+1. `postinstall` 从 `https://electerm.org/version.html` 读取最新版本，从 `https://electerm.org/data/electerm-github-release.json` 读取发行版资源列表。
+2. 根据 `os.platform()` / `os.arch()`（外加 win7 / mac10 / linux-legacy 识别）确定要下载的资源。
+3. 下载并解压到 `<package>/electerm/`（Linux/Windows），macOS 则把 `.app` 安装到 `/Applications`。
+4. `electerm` 可执行脚本（`npm/electerm`）负责找到并启动该二进制文件。
+
+发布由 electerm 发行版自动触发（[`npm.yml`](https://github.com/electerm/electerm-npm/blob/master/.github/workflows/npm.yml)），详见 [CONTRIBUTING.md](https://github.com/electerm/electerm-npm/blob/master/CONTRIBUTING.md)。
+
+## 关于 electerm
+
+Electerm 是开源的 terminal / ssh / sftp / telnet / serialport / RDP / VNC / Spice / ftp 客户端，支持 Linux、Mac、Windows、Android、HarmonyOS 和 iOS。
+
+同时支持老旧 / 特殊系统：Ubuntu 18、Windows 7、macOS 10+、UOS / 麒麟 / 龙芯 LoongArch（新世界和旧世界）、riscv64 和 ppc64le Linux。
+
+主要特性（完整文档见[主仓库](https://github.com/electerm/electerm)）：
+
+- 终端 + 文件管理，ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice
+- 全局快捷键切换窗口（默认 `ctrl + 2`）
+- 多语言支持（[electerm-locales](https://github.com/electerm/electerm-locales)）
+- 公钥 / 密码 / ssh-agent / 证书 / OTP 登录，隧道、跳板机
+- Zmodem（`rz`/`sz`）与 [trzsz](https://github.com/trzsz/trzsz)（`trz`/`tsz`）
+- 主题、透明窗口、背景图
+- 全局 / 会话代理、快捷命令、经 gist / webdav / electerm cloud 同步
+- AI 助手、MCP 组件、deep link（`ssh://`、`telnet://`）、命令行用法
+
+相关链接 / 项目：
+
+- [官网 / 下载](https://electerm.org) · [Releases](https://github.com/electerm/electerm/releases) · [视频教程](https://electerm.org/videos)
+- [主题](https://theme.electerm.org) · [Docker](https://github.com/electerm/electerm-web-docker) · [在线演示](https://demo.electerm.org)
+- [Android](https://github.com/electerm/electerm-android) · [HarmonyOS](https://github.com/electerm/electerm-harmony) · [网页版](https://github.com/electerm/electerm-web)
+- [electerm online](https://cloud.electerm.org) · [electerm AI](https://ai.electerm.org)
+- [Apple App Store](https://apps.apple.com/cn/app/electerm/id6792971552) · [华为应用市场](https://appgallery.huawei.com/app/detail?id=org.electerm.electerm) · [Microsoft Store](https://www.microsoft.com/store/apps/9NCN7272GTFF) · [Snap Store](https://snapcraft.io/electerm)
+- [deb 源](https://repos.electerm.org/deb) · [rpm 源](https://repos.electerm.org/rpm)
+
+## 问题反馈 / 支持
+
+- 安装器问题（`npm i -g electerm` 失败、下错二进制、启动失败）：请提 issue 到 [electerm-npm](https://github.com/electerm/electerm-npm/issues)。
+- 应用本身的 bug / 功能建议：请提 issue 到 [electerm/electerm](https://github.com/electerm/electerm/issues)，或发起 [discussion](https://github.com/electerm/electerm/discussions)。
+- 语言文件：[electerm-locales](https://github.com/electerm/electerm-locales)。
+
+## 参与贡献
+
+本仓库只放安装器（`npm/`）和发布流程。目录结构、测试（`npm test`、`npm run test-network`、`npm run pack-check`）与发行版驱动的发布流程见 [CONTRIBUTING.md](https://github.com/electerm/electerm-npm/blob/master/CONTRIBUTING.md)。
+
+## 更新日志
+
+见 [electerm releases](https://github.com/electerm/electerm/releases) —— npm 版本与之 1:1 对应。
+
+## License
+
+MIT

package/npm/install.js

@@ -17,7 +17,29 @@ const { phin, download, extractTarGz, GITHUB_PROXY, applyProxy } = require('./ut
 
 const plat = os.platform()
 const arch = os.arch()
-const { homepage } = require('../package.json')
+
+/**
+ * In the published package this file is at <pkg>/npm/install.js so the manifest
+ * is one level up. In this repo the layout is identical (npm/install.js next to
+ * the root manifest), so the first candidate is the one that resolves. The
+ * second is kept for checkouts that nest the installer deeper. Look in both so
+ * the installer can be required (and tested) straight from the repo.
+ */
+function readHomepage () {
+  for (const p of ['../package.json', '../../package.json']) {
+    try {
+      const { homepage } = require(p)
+      if (homepage) {
+        return homepage
+      }
+    } catch (e) {
+      // not here, try the next location
+    }
+  }
+  return 'https://electerm.org'
+}
+
+const homepage = readHomepage()
 
 const releaseInfoUrl = `${homepage}/data/electerm-github-release.json?_=${+new Date()}`
 const versionUrl = `${homepage}/version.html?_=${+new Date()}`
@@ -120,6 +142,111 @@ function isLinuxLegacy (platform) {
   }
 }
 
+// ---------------------------------------------------------------------------
+// Architecture -> release asset resolution
+// ---------------------------------------------------------------------------
+
+// Every Linux release asset we can install, keyed by `os.arch()`.
+//
+// `legacy: true` means a `-legacy` variant (glibc 2.17+) is published as well.
+// riscv64 and ppc64le have no legacy variant on purpose: the Electron runtime
+// for those architectures is only published built against a newer glibc, so
+// there is nothing to fall back to and the legacy flag must be ignored there
+// instead of producing a `linux-riscv64-legacy.tar.gz` that does not exist.
+//
+// `ia32` (32-bit node on a 64-bit host) maps to x64 on purpose: the kernel runs
+// the 64-bit build fine, and electron has no 32-bit build any more.
+const LINUX_TARGETS = {
+  x64: { name: 'linux-x64', legacy: true },
+  ia32: { name: 'linux-x64', legacy: true },
+  arm64: { name: 'linux-arm64', legacy: true },
+  aarch64: { name: 'linux-arm64', legacy: true },
+  arm: { name: 'linux-armv7l', legacy: true },
+  armv7l: { name: 'linux-armv7l', legacy: true },
+  loong64: { name: 'linux-loong64', legacy: true },
+  riscv64: { name: 'linux-riscv64', legacy: false },
+  ppc64le: { name: 'linux-ppc64le', legacy: false },
+  // node reports `ppc64` for both endiannesses, we only publish little endian
+  ppc64: { name: 'linux-ppc64le', legacy: false, littleEndianOnly: true }
+}
+
+const SUPPORTED_LINUX_ARCHES = Object.keys(LINUX_TARGETS).sort().join(', ')
+
+/**
+ * Resolve the release asset to install for the running platform/arch.
+ *
+ * @param {string} platform - os.platform()
+ * @param {string} arch - os.arch()
+ * @param {object} options
+ * @param {boolean} options.win7 - Windows 7 or earlier detected
+ * @param {boolean} options.mac10 - macOS 10.x detected
+ * @param {boolean} options.legacy - Linux with glibc < 2.34 detected
+ * @param {string} options.endianness - os.endianness(), only used for ppc64
+ * @returns {{type: string, filePattern: string, legacyUnavailable?: boolean}|{type: 'unsupported', reason: string}}
+ */
+function getDownloadTarget (platform, arch, options = {}) {
+  const {
+    win7,
+    mac10,
+    legacy,
+    endianness = os.endianness()
+  } = options
+
+  if (platform === 'win32') {
+    if (win7) {
+      return { type: 'win7', filePattern: 'win7.tar.gz' }
+    }
+    if (arch === 'arm64') {
+      return { type: 'win-arm64', filePattern: 'win-arm64.tar.gz' }
+    }
+    if (arch === 'x64' || arch === 'ia32') {
+      return { type: 'win-x64', filePattern: 'win-x64.tar.gz' }
+    }
+    return { type: 'unsupported', reason: `Windows on "${arch}" is not supported` }
+  }
+
+  if (platform === 'darwin') {
+    if (mac10) {
+      return { type: 'mac10-x64', filePattern: 'mac10-x64.dmg' }
+    }
+    if (arch === 'arm64') {
+      return { type: 'mac-arm64', filePattern: 'mac-arm64.dmg' }
+    }
+    if (arch === 'x64' || arch === 'ia32') {
+      return { type: 'mac-x64', filePattern: 'mac-x64.dmg' }
+    }
+    return { type: 'unsupported', reason: `macOS on "${arch}" is not supported` }
+  }
+
+  if (platform === 'linux') {
+    const entry = LINUX_TARGETS[arch]
+    if (!entry) {
+      return {
+        type: 'unsupported',
+        reason: `Linux architecture "${arch}" is not supported (supported: ${SUPPORTED_LINUX_ARCHES})`
+      }
+    }
+    if (entry.littleEndianOnly && endianness === 'BE') {
+      return {
+        type: 'unsupported',
+        reason: `Linux ${arch} big-endian is not supported, only little-endian (ppc64le) builds are published`
+      }
+    }
+    const useLegacy = !!legacy && entry.legacy
+    const type = useLegacy ? `${entry.name}-legacy` : entry.name
+    const result = {
+      type,
+      filePattern: `${type}.tar.gz`
+    }
+    if (legacy && !entry.legacy) {
+      result.legacyUnavailable = true
+    }
+    return result
+  }
+
+  return { type: 'unsupported', reason: `Platform "${platform}" is not supported` }
+}
+
 // ---------------------------------------------------------------------------
 // Launch the extracted binary
 // ---------------------------------------------------------------------------
@@ -160,7 +287,7 @@ async function runLinux (folderName, filePattern) {
   rm('-rf', [target, extractDir])
 
   console.log('  Fetching release info...')
-  const releaseInfo = await getReleaseInfo(r => r.name.includes(filePattern))
+  const releaseInfo = await getReleaseInfo(r => r.name.endsWith(filePattern))
   if (!releaseInfo) {
     throw new Error(`No release found for pattern: ${filePattern}`)
   }
@@ -471,7 +598,7 @@ async function main () {
   console.log('========================================')
   console.log('electerm binary installer')
   console.log('========================================')
-  console.log(`Platform: ${plat}, Architecture: ${arch}`)
+  console.log(`Platform: ${plat}, Architecture: ${arch}${os.endianness() === 'BE' ? ' (big-endian)' : ''}`)
 
   if (GITHUB_PROXY) {
     console.log(`GitHub Proxy: ${GITHUB_PROXY}`)
@@ -491,10 +618,24 @@ async function main () {
   console.log('  Fetching release information...')
 
   try {
+    const target = getDownloadTarget(plat, arch, {
+      win7,
+      mac10,
+      legacy: linuxLegacy
+    })
+
+    if (target.type === 'unsupported') {
+      throw new Error(target.reason)
+    }
+
+    if (target.legacyUnavailable) {
+      console.log(`  Note: no -legacy build is published for ${arch}, installing the standard build`)
+    }
+
     if (plat === 'win32') {
       if (win7) {
         await runWin7()
-      } else if (arch === 'arm64') {
+      } else if (target.type === 'win-arm64') {
         await runWin('arm64')
       } else {
         await runWin('x64')
@@ -502,26 +643,13 @@ async function main () {
     } else if (plat === 'darwin') {
       if (mac10) {
         await runMac10()
-      } else if (arch === 'arm64') {
+      } else if (target.type === 'mac-arm64') {
         await runMac('arm64')
       } else {
         await runMac('x64')
       }
-    } else if (plat === 'linux') {
-      const suffix = linuxLegacy ? '-legacy' : ''
-      if (arch === 'arm64' || arch === 'aarch64') {
-        await runLinux(`linux-arm64${suffix}`, `linux-arm64${suffix}.tar.gz`)
-      } else if (arch === 'arm') {
-        await runLinux(`linux-armv7l${suffix}`, `linux-armv7l${suffix}.tar.gz`)
-      } else if (arch.includes('loong')) {
-        await runLinux(`linux-loong64${suffix}`, `linux-loong64${suffix}.tar.gz`)
-      } else if (arch === 'riscv64' || arch.includes('riscv')) {
-        await runLinux(`linux-riscv64${suffix}`, `linux-riscv64${suffix}.tar.gz`)
-      } else {
-        await runLinux(`linux-x64${suffix}`, `linux-x64${suffix}.tar.gz`)
-      }
     } else {
-      throw new Error(`Platform "${plat}" is not supported.`)
+      await runLinux(target.type, target.filePattern)
     }
   } catch (err) {
     console.error('')
@@ -546,10 +674,12 @@ module.exports = {
   isWindows7OrEarlier,
   isMacOS10,
   isLinuxLegacy,
+  getDownloadTarget,
   sanitizeVersion,
   sanitizeFilename,
   getElectermExePath,
   isElectermExtracted,
+  LINUX_TARGETS,
   // Expose for test injection
   _packageRoot: packageRoot,
   _extractDir: extractDir

package/package.json

@@ -1,17 +1,21 @@
 {
   "name": "electerm",
-  "version": "5.5.15",
+  "version": "5.5.35",
   "description": "Terminal/ssh/telnet/serialport/sftp client(linux, mac, win)",
-  "main": "app.js",
   "bin": "npm/electerm",
   "scripts": {
     "postinstall": "node npm/install.js",
-    "postpublish": "node build/bin/postpublish.js"
+    "test": "node --test test/npm-install-target.spec.js",
+    "test-network": "node test/npm-install2.spec.js",
+    "lint": "./node_modules/.bin/standard --verbose",
+    "fix": "./node_modules/.bin/standard --fix",
+    "pack-check": "npm pack --dry-run"
   },
   "license": "MIT",
+  "homepage": "https://electerm.org",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/electerm/electerm.git"
+    "url": "git+https://github.com/electerm/electerm-npm.git"
   },
   "author": {
     "name": "ZHAO Xudong",
@@ -19,43 +23,33 @@
     "url": "https://github.com/zxdong262"
   },
   "bugs": {
-    "url": "https://github.com/electerm/electerm/issues"
+    "url": "https://github.com/electerm/electerm-npm/issues"
   },
-  "homepage": "https://electerm.org",
+  "releases": "https://github.com/electerm/electerm/releases",
   "engines": {
     "node": ">=16.0.0"
   },
   "preferGlobal": true,
-  "dependencies": {
-    "tar": "*"
-  },
-  "overrides": {
-    "ip-address": "^10.3.1",
-    "qs": "^6.16.0",
-    "body-parser": "^2.3.0",
-    "form-data": "^4.0.6",
-    "fast-uri": "^3.1.6",
-    "js-yaml": "^4.3.2",
-    "@xmldom/xmldom": "^0.8.15",
-    "browserslist": "^4.28.7",
-    "baseline-browser-mapping": "^2.11.0",
-    "postcss": "^8.5.23",
-    "glob": {
-      "minimatch": {
-        "brace-expansion": "^5.0.7"
-      }
-    }
+  "publishConfig": {
+    "access": "public"
   },
   "files": [
     "npm",
     "README.md",
+    "README_cn.md",
     "LICENSE"
   ],
-  "allowScripts": {
-    "@serialport/bindings-cpp@13.0.0": true,
-    "node-pty@1.2.0-beta.15": true
+  "dependencies": {
+    "shelljs": "^0.8.5",
+    "tar": "^7.5.21"
   },
   "devDependencies": {
-    "shelljs": "^0.10.0"
+    "standard": "^17.1.2"
+  },
+  "standard": {
+    "ignore": [
+      "/electerm",
+      "/node_modules"
+    ]
   }
 }