ArcSurge/Termius-Pro-zh_CN

• Termius 汉化脚本。
• 大家可以在官方功能请求进行反馈，让官方尽快支持中文。

• 一键汉化 - 自动化界面汉化
• 试用功能激活 - 解锁高级特性
• 多平台支持 - Windows/macOS/Linux
• 安全机制 - 自动备份

• Python
• Node.js (用于安装asar)

npm install -g @electron/asar

# 默认执行汉化操作
python lang.py

# 汉化+试用+样式修改
python lang.py --localize --trial --style

# 仅激活试用功能
python lang.py --trial

# 还原到初始状态
python lang.py --restore

# 搜索特定字符串
python lang.py --find "term1" "term2"

# 提取所有字符串
python lang.py --extract

rules/
├── trial.txt       # 试用功能规则(-t/--trial时加载)
├── localize.txt    # 汉化规则(-l/--localize时加载)
├── skip_login.txt  # 登录跳过规则(-k/--skip-login时加载)
└── style.txt       # 样式修改规则(-s/--style时加载)
extract/
├── app.asar.unpack # 解包出的所有文件
└── allstring.txt   # 所有可能的字符串

如果没有相关环境，可以手动汉化。

1. 前往 Releases 下载对应版本的 app-xxx.asar 文件。
2. 找到 Termius 安装目录，通常位置为:

• Windows: C:\Users\你的用户名\AppData\Local\Programs\Termius。
• Linux: /opt/Termius。
• MacOS: /Applications/Termius.app/Contents。

1. 将下载的 app-xxx.asar 文件重命名为 app.asar 后覆盖 resources 文件夹下的 app.asar 文件。

• 注意，macOS 替换后需要运行 osxfix.sh 重新计算文件 hash 后方可使用。

• 注意，新版 Termius 启用了 asar 完整性校验，Windows/Linux 需先关闭该熔丝方可启动（详见 FAQ Q3）：

  npx @electron/fuses write --app "C:\Users\你的用户名\AppData\Local\Programs\Termius\Termius.exe" EnableEmbeddedAsarIntegrityValidation=off

  Termius Beta 用户请执行此命令

  npx @electron/fuses write --app "C:\Users\你的用户名\AppData\Local\Programs\Termius Beta\Termius Beta.exe" EnableEmbeddedAsarIntegrityValidation=off

1. 如果你不想自动更新，请删除 app-update.yml 文件。
2. 最后，如果没有想要的版本，可在 Fork 本项目后前往仓库的 Settings > Secrets and variables > Actions > Variables 页面定义变量:

• Name: RELEASE_LIST
• Value: l,lk,lt
• 默认l,lk,lt，代表生成三个版本，l为汉化，lt为汉化+试用，lk为汉化+跳过登录。可自行修改，通过逗号分隔。

• 目前只有汉化功能，暂无其他功能。并且部分词条在源码中，暂未汉化。

• 由于手机端和桌面端版本号不同，因此安卓版本不会发布在 Releases 中，而是暂时托管在 Actions。Actions 每天运行一次，请自行查找对应版本进行下载。注意，这个是需要登录才可以下载的。

• 若你计划 Fork 此项目，请在 Fork 后前往仓库的 Settings > Secrets and variables > Actions > Secrets 页面，点击 New repository secret 定义私密变量。

  • Name: APK_SIGN_PROPERTIES
  • Value: 填写 apk.sign.properties.example 文件内容（请根据需要修改文件内容）

• 可选配置（Github Action）：

  • 添加自定义签名文件，可以覆盖安装 apk

  • 首先通过命令生成一个.jks签名文件

    # 然后通过命令编码成一个 Base64 的文件
    base64 -w 0 Termius_zh.jks > Termius_zh_base64.txt

  • 后前往仓库的 Settings > Secrets and variables > Actions > Secrets 页面，点击 New repository secret 定义私密变量。

  • Name: SIGNING_KEY

  • Value: 填写 Termius_zh_base64.txt 文件内容（请根据需要修改文件内容）

• 安卓相关资源均存放在 android 目录下。
• 所需工具：
  • python（运行环境）
  • zipalign（对齐工具 sudo apt install -y zipalign 安装）
  • apksigner（签名工具 sudo apt install -y apksigner 安装）
  • keytool（密钥生成工具，集成在 JDK 中）
• 运行：

  # 进入安卓目录
  cd android
  # 配置签名信息（请自行修改内容）
  mv apk.sign.properties.example apk.sign.properties
  # 安装依赖
  pip install -r requirements.txt
  # 运行脚本
  python apktools.py

Q： Python 缺少 tkinter 图形界面库。

A：

• Windows: tkinter 通常随 Python 一起安装，如缺失请重新安装 Python 并勾选 "tcl/tk and IDLE" 选项。
• macOS: 使用 Homebrew 安装：brew install python-tk
• Linux (Ubuntu/Debian): sudo apt-get install python3-tk
• Linux (Fedora): sudo dnf install python3-tkinter

Q： 没有足够的权限访问或修改 Termius 安装目录。

A：

• Windows: 以管理员身份运行终端（右键 → 以管理员身份运行）
• macOS/Linux: 在命令前添加 sudo，例如：sudo python lang.py -l
• 确保 Termius 已完全关闭，没有后台进程占用文件
• 请检查权限，确保当前用户有 resources 目录的写权限

Q： 新版 Termius 启用了 Electron 的 asar 完整性校验（EnableEmbeddedAsarIntegrityValidation），替换后的 app.asar 因哈希不匹配而被阻止启动。

A：

• 使用脚本汉化：lang.py 会自动关闭该校验，无需额外操作。

• 手动汉化：需先用 @electron/fuses 关闭熔丝（以 Windows 为例，macOS/Linux 路径见上方手动汉化章节）：

  npx @electron/fuses write --app "C:\Users\你的用户名\AppData\Local\Programs\Termius\Termius.exe" EnableEmbeddedAsarIntegrityValidation=off

  Termius Beta 用户请执行此命令

   npx @electron/fuses write --app "C:\Users\你的用户名\AppData\Local\Programs\Termius Beta\Termius Beta.exe" EnableEmbeddedAsarIntegrityValidation=off

• macOS 无需此操作，运行 osxfix.sh 更新预期 hash 即可。

Q： Termius 后台更新时报 did not pass validation，或更新后应用无法启动。

A：

• 这是替换 app.asar 破坏代码签名导致的，内置自动更新无法继续使用，请前往 官网 手动下载安装新版。

Q： 如登录态丢失，且无法重新登陆、软件 logo 错误等

A：

• 这是因为使用了与版本不匹配的 asar 导致的，请确保使用了对应版本的 asar，同时正式版与 Beta 版的 asar 不可混用

• 该项目仅适用于本地学习和测试，不支持在线功能。
• 使用汉化包可能会影响 Termius 软件的正常更新。
• 在执行任何操作之前，请确保备份 Termius 的相关文件。

• 本仓库包括发布页内的所有文件仅供学习和交流，请勿用于任何非法用途，严禁二次出售，请在下载后的24小时内删除！如有侵权请联系删除！
• 用于测试和学习研究，禁止用于商业用途，不能保证其合法性、准确性、完整性和有效性，请根据情况自行判断。
• 本人对任何问题概不负责，包括但不限于由任何脚本错误导致的任何损失或损害，使用即表示知晓风险。
• 保留随时终止项目的权利。