# @electerm/electerm-react 中文文档

规范地址：https://npmcn.com/package/%40electerm/electerm-react/

版本：5\.10\.2
npm 元数据更新时间：2026-11-11T10:42:00.913Z
中文译文更新时间：2026-11-13T11:27:04.385Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40electerm/electerm-react
原文对照：https://npmcn.com/package/%40electerm/electerm-react/?lang=original
项目主页：https://electerm.org/
源码仓库：https://github.com/electerm/electerm

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.4 MB，653 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.0\.0
- 运行依赖：0 个
- 首次发布：2023-10-27T00:20:58.730Z
- 最新版本发布：2026-11-11T10:42:00.507Z
- 近 30 天下载量：4644（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：302（近 12 个月 152 个）

## 中文简介

electerm 反应组件弧

## 安装

```sh
npm install @electerm/electerm-react
```

也可以使用：`pnpm add @electerm/electerm-react`、`yarn add @electerm/electerm-react`、`bun add @electerm/electerm-react`

## README

# [![](https://github.com/electerm/electerm-resource/raw/master/static/images/electerm.png)](https://electerm.org/)

[![GitHub version](https://badgers.space/github/release/electerm/electerm?corner_radius=m)](https://github.com/electerm/electerm/releases) [![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)

[联合国](https://npmcn.com/package/%40electerm/electerm-react/README.md) | [页:1](https://npmcn.com/package/%40electerm/electerm-react/src/docs/README_cn.md) | [日本語](https://npmcn.com/package/%40electerm/electerm-react/src/docs/README_jp.md)

这是选举子项目的反应组件包

开源终端/ssh/sftp/telnet/serialport/RDP/VNC/Spice/ftp客户端(Linux,Mac,Windows,Android,HarmonyOS,iOS).

除了主流Windows/macOS/Linux/Android,electerm还支持了HarmonyOS,iOS,和更古老的系统——Ubuntu 18,Windows 7,macOS 10+,以及UOS,Kylin,和LoongArch(既有旧世界也有新世界)等特殊的中文Linux发行,以及RISC-V(riscv64)和PowerPC 64-bit little-endian(ppc64le) Linux.

[主页/ 下载](https://electerm.org/) • 妇女 [主题](https://theme.electerm.org/) • 妇女 [夹克](https://github.com/electerm/electerm-web-docker) • 妇女 [在线演示](https://demo.electerm.org/) • 妇女 [机器人](https://github.com/electerm/electerm-android) • 妇女 [和谐号](https://github.com/electerm/electerm-harmony) • 妇女 [苹果应用存储](https://apps.apple.com/us/app/electerm/id6792971552) • 妇女 [花威电脑](https://appgallery.huawei.com/app/detail?id=org.electerm.electerm) • 妇女 [微软存储](https://www.microsoft.com/store/apps/9NCN7272GTFF) • 妇女 [同步存储](https://snapcraft.io/electerm) • 妇女 [deb repo 读取](https://repos.electerm.org/deb) • 妇女 [rpm 重播](https://repos.electerm.org/rpm)

🌐 **[在线选举器](https://cloud.electerm.org/)** ——公共免费在线选举程序

🤖 **[选手AI](https://ai.electerm.org/)** ——选举人用户免费AI

💻 **[选手-网络](https://github.com/electerm/electerm-web)** ——Web App版本在浏览器(包括移动设备)中运行

## 发起人

[![Atlas Cloud](https://github.com/electerm/electerm-resource/blob/master/static/images/atlas-cloud.png?raw=true)](https://www.atlascloud.ai/?ref=PCAEL2&utm_source=github&utm_medium=link&utm_campaign=electerm)

[地图集云](https://www.atlascloud.ai/?ref=PCAEL2&utm_source=github&utm_medium=link&utm_campaign=electerm) 提供与OpenAI兼容的AI APIs和用于Electerm中AI动力工作流程的模型访问.

* * *

[![PackyCode](https://github.com/electerm/electerm-resource/blob/master/static/images/packy-api.png?raw=true)](https://www.packyapi.ai/register?aff=DOZI)

[包码](https://www.packyapi.ai/register?aff=DOZI) ——通过PackyCode访问领先的AI模型,其中有一个API端点和一个API密钥. 享受快速,可靠的接入,拥有自动失效和Codex和Claude Code专用高速线路. 以1元免费入息开始,首次补收时可打折,符合条件的线路可节省高达80%. 以人民币支付,不增加货币兑换加价或补收费用.

* * *

  
  
[![ApiMart](https://github.com/electerm/electerm-resource/blob/master/static/images/apimart.jpg?raw=true)](https://go.apimart.ai/gh-electerm)  
  

感谢APIMart赞助选举人! APIMart是AI图像和视频生成的低成本API平台——GPT-Image-2从0.006美元图像,160+图像每美元. 一个Aync API同时覆盖图像和视频:提交任务,获得身份证明,通过投票或回电获取结果. 批量数以万计的图像而不超时,切换模型而不更改代码. 现收现付,不每月收费 [在这儿报名开始](https://go.apimart.ai/gh-electerm)。 。 。 .

* * *

[![Infistar](https://github.com/electerm/electerm-resource/blob/master/static/images/infistar-wordmark.png?raw=true)](https://www.infistar.cc/register?aff=4R4JT29X&ref_source=link)   [![DigitalOcean Referral Badge](https://web-platforms.sfo2.cdn.digitaloceanspaces.com/WWW/Badge%202.svg)](https://www.digitalocean.com/?refcode=c10bcb28b846&utm_campaign=Referral_Invite&utm_medium=Referral_Program&utm_source=badge)

![](https://github.com/electerm/electerm-resource/raw/master/static/images/electerm-banner-1.jpg)

## 特征

-   作为终端/文件管理器工作,ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice客户端
-   支持窗口7+(X64/ARM64),和谐OS,Android,iOS,Mac OS 10.15+(x64/arm64),Linux(x64/arm64/riscv64/ppc64le/Loong64新世界和旧世界),甚至有Glibc 2.17+像UOS/Kylin/Ubuntu 18.04等旧Linux
-   切换窗口可见度的全局热键( 类似于guake, 默认为) `ctrl + 2`(中文(简体) )
-   唵(引一)🇷🇺(引一)🇪🇸(二合引一)多语支(引一)[选民-地方](https://github.com/electerm/electerm-locales),欢迎贡献/补充)
-   双击直接编辑(小)远程文件.
-   所有类型的认证方法:公用钥匙,密码,ssh代理,证书,otp,netbird等.
-   支持 Zmodem( rz, sz) , 和 [特兹兹](https://github.com/trzsz/trzsz)(trz/t.
-   支持 ssh 相關功能:地道,接通跳跃.
-   自定义 UI:主题,背景图像,透明窗口(Mac, win).
-   环球/会话代理.
-   快速命令/触发以完成预定义的任务和自动操作
-   同步数据,包括书签到 github/ gitee 秘密 gist/webdav/custom server/electerm 云
-   快速输入/模拟输入到一个或所有终端.
-   AI 助手集成(支持多个 LLM API 格式—— OpenAI Chat 补全, OpenAI 响应, 和 Anthropic Messages) , 帮助命令建议, 脚本编写, 并解释选定的终端内容, 创建书签/ 主题, 代理模式来直接执行终端操作
-   MCP( 模式上下文协议) AI 助手和外部工具集成部件 - 见 [MCP 部件使用指南](https://github.com/electerm/electerm/wiki/MCP-Widget-Usage-Guide)
-   深链接支持: 打开像 URL 这样的连接 `telnet://192.168.2.31:34554` 或者说 `ssh://user@host:22` - 看见没 [深链接支持wiki](https://github.com/electerm/electerm/wiki/Deep-link-support)
-   命令行用量: 检查 [维基百科](https://github.com/electerm/electerm/wiki/Command-line-usage)

## 安装

-   对于 Mac 用户 : `brew install --cask electerm`
-   与快讯: `sudo snap install electerm --classic`
-   对于一些Linux发行版,可以从OS默认的App商店(Ubuntu,Deepin,Mint...)中找到.
-   对于一些linux OS `rpm`, (中文(简体) ), `deb`,或 `snap` 释放可能不起作用,你可以尝试 `tar.gz` 或者说 `.appImage` 释放.
-   对于 Windows 用户,您可以从 [窗口存储](https://www.microsoft.com/store/apps/9NCN7272GTFF),命令行安装器 [旋转](https://github.com/microsoft/winget-cli) 财务报告和审定财务报表 [专辑](https://github.com/lukesampson/scoop) 还建议:

```powershell
# winget https://github.com/microsoft/winget-cli
winget install electerm.electerm

# scoop https://github.com/lukesampson/scoop
scoop bucket add dorado https://github.com/chawyehsu/dorado
scoop install dorado/electerm
```

-   从Debian寄存器(用于Debian/Ubuntu系统)安装 `apt` 命令

检查 [https://repos.electerm.org/deb (英语)](https://repos.electerm.org/deb)

-   从 npm 安装

```bash
npm i -g electerm

```

## 升级

-   自动升级:当新版本发布后,您将在再次开始选举后获得升级通知. 然后可以点击升级按钮进行升级.
-   下载:只需下载最新版,再安装.
-   无 : 如果你从npm安装,只是运行 `npm i -g electerm` 再来一次.
-   如果使用Snap或其他一些分布系统,这些系统可能提供升级.

## 已知问题

[https://github.com/electerm/electerm/wiki/ 知识问题](https://github.com/electerm/electerm/wiki/Know-issues)

## 麻烦解决

[https://github.com/electerm/electerm/wiki/Troubleshoots 互联网档案馆的存檔,存档日期2013-12-22](https://github.com/electerm/electerm/wiki/Troubleshoot)

## 讨论情况

[![Discord](https://img.shields.io/badge/Discord-Join-blue?logo=discord)](https://discord.gg/855W7g8EVd)

[讨论会](https://github.com/electerm/electerm/discussions)

![electerm WeChat group QR code](https://electerm.org/electerm-wechat-group-qr.jpg) ![electerm Telegram group QR code](https://electerm.org/telegram-qr.png)

## 支助

我很想听到你的消息 请告诉我你的想法, [提交问题](https://github.com/electerm/electerm/issues), (中文(简体) ), [开始新的讨论](https://github.com/electerm/electerm/discussions/new), (中文(简体) ), [创建/固定语言文件](https://github.com/electerm/electerm-locales) 或者创建拉动请求,欢迎.

## 赞助这个项目

github 赞助商

[https://github.com/赞助商/选举人](https://github.com/sponsors/electerm)

科菲语name

[https://ko-fi.com/zhaoxudong (英语)](https://ko-fi.com/zhaoxudong)

微博捐赠

[![wechat donate](https://electerm.org/electerm-wechat-donate.png)](https://github.com/electerm)

TRON TRN20号卫星

\[![TRN20 donate](https://github.com/electerm/electerm-resource/blob/master/static/images/trn20.png?raw=true)\[ . \]

地址:TXk3p克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克

## 德维

```bash
# May only works in Linux
# needs nodejs/npm, suggest using nvm to install nodejs/npm
# with nodejs 24.x

git clone git@github.com:electerm/electerm.git
cd electerm
npm config set legacy-peer-deps true
npm i

# start vite dev server, requires port 5570
npm start

# in a separate terminal session run app
npm run app

# code format check
npm run lint

# code format fix
npm run fix
```

## 测试

```bash
npm run b
npm run prepare-test
cp ./src/build/.sample.env ./.env

# edit .env, fill your test host/username/password, may only works in mac OS
npm run test
```

## 测试构建

```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
```

## 视频指南

-   [https://electerm.org/videos (英语)](https://electerm.org/videos)

## 更改日志

访问 [释放](https://github.com/electerm/electerm/releases)。 。 。 .

## 联系人

[兹克东@gmail.com](mailto:zxdong@gmail.com)

## 许可证

麻省理工学院

## 恒星历史

[![Star History Rank](https://api.star-history.com/badge?repo=electerm/electerm)](https://www.star-history.com/electerm/electerm)

[![Star History Chart](https://api.star-history.com/chart?repos=electerm/electerm&type=date&legend=top-left&sealed_token=DvPlttPaLtq6RPIWRANYX08-8ZJyrJalhombrkDcg1IwWOMPMIplgi85q0FiwrbhE3lRIi_yxvOWdell731CGQvzlfJMt2Sa6VfCvQ80BwEtQ6RpPchEiw)](https://www.star-history.com/?repos=electerm%2Felecterm&type=date&legend=top-left)

## 常见问题

### @electerm/electerm-react 是什么？

electerm 反应组件弧

### 如何安装 @electerm/electerm-react？

在项目目录运行 npm install @electerm/electerm-react，或使用 pnpm add / yarn add / bun add。

### @electerm/electerm-react 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/electerm\_\_electerm-react 是否存在。

### @electerm/electerm-react 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @electerm/electerm-react 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @electerm/electerm-react 可以商用吗？

@electerm/electerm-react 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @electerm/electerm-react 的下载量有多少？

根据 npm 官方下载统计，@electerm/electerm-react 在 2026/10/14 – 2026/11/12 这 30 天内被下载 4,644 次，日均约 155 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @electerm/electerm-react 还在维护吗？

最新版本 5\.10\.2 发布于 2026/11/11（2 天前）；至今共发布 302 个版本，其中过去 12 个月发布了 152 个；首次发布于 2023/10/27。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。