v0.0.5.1 - 修复 macOS 安装脚本换行符

instantTrans v0.0.5.1

修复 macOS 安装脚本在部分环境下因 Windows 换行符（CRLF） 导致的启动失败。

问题

运行 ./install-mac.sh 时可能出现：

bad interpreter: /bin/bash^M: no such file or directory

修复

• 新增 .gitattributes，强制 shell 脚本使用 LF 换行
• Windows 发布打包时自动规范化 .sh 文件换行符

下载

文件	说明
instantTrans-macos-0.0.5.1.zip	macOS 完整包（推荐）
instantTrans-macos-0.0.5.1.popclipextz	PopClip 扩展

若暂时无法重新下载

在已解压目录执行：

sed -i '' 's/\r$//' install-mac.sh popclip/instantTrans.popclipext/translate.sh
chmod +x install-mac.sh
./install-mac.sh

安装

chmod +x install-mac.sh
./install-mac.sh

功能与 v0.0.5 相同，仅修复换行符问题。

v0.0.5 - macOS PopClip 支持

instantTrans v0.0.5

首个 macOS 正式支持版本：在保留 Windows 完整体验的同时，新增基于 PopClip 的划词翻译扩展。

下载

文件	平台	说明
instantTrans-macos-0.0.5.zip	macOS	推荐：解压后运行 ./install-mac.sh 一键安装
instantTrans-macos-0.0.5.popclipextz	macOS	仅 PopClip 扩展（需已配置 ~/.config/instanttrans/config）

Windows 用户请继续使用 v0.0.4 的 instantTrans-v0.0.4-win.zip。

新特性

• macOS PopClip 扩展：选中文字 → 点击 instantTrans → 自动替换为译文
• install-mac.sh 一键安装：自动安装 Python 依赖、写入配置、部署 PopClip 扩展
• CLI 增强：translate.py 新增 --text / --stdin / --stdout，便于脚本与 PopClip 调用
• 文档更新：README 与 popclip/README.md 补充 macOS 安装与使用说明
• 发布脚本：scripts/build-macos-release.sh / .ps1 用于打包 macOS 发布物

macOS 快速开始

前置条件：PopClip、Python 3.13+

# 解压 instantTrans-macos-0.0.5.zip 后
chmod +x install-mac.sh
./install-mac.sh

可选：

./install-mac.sh --with-local      # 同时安装本地模型依赖
./install-mac.sh --api-key-setup   # 交互式配置 API 密钥

使用：选中文字 → PopClip 弹出菜单 → 点击 instantTrans

在 PopClip 扩展设置中可切换翻译服务：自动降级 / DeepSeek / 硅基流动 / Google / 本地模型。

命令行示例

python3 translate.py --text "Hello" --stdout
python3 translate.py --text "你好" --deepseek --stdout

API 密钥（可选）

服务	环境变量
DeepSeek	DEEPSEEK_API_KEY
硅基流动	SILICONFLOW_API_KEY

macOS 可通过 ./install-mac.sh --api-key-setup 写入 ~/.config/instanttrans/config，或 export 到 shell 配置。

不配置密钥也可使用「自动」模式（Google / 本地模型兜底）。

完整变更

• 9d5e24f Add macOS PopClip support with one-click install script

instantTrans v0.0.4

instantTrans v0.0.4

Windows 快捷翻译工具：选中文字后按 Ctrl+Shift+] 即可中英互译并替换原文。

下载方式

文件	说明
instantTrans-v0.0.4-win.zip	推荐：解压后运行 install.bat 安装依赖，再双击 instantTrans_v2.exe
instantTrans_v2.exe	仅可执行文件（需与脚本等同目录，建议下载 zip）

新特性

• 本地离线翻译：HY-MT1.5-ONNX 模型
• 智能降级：DeepSeek → 硅基流动 → Google → 本地模型
• 托盘菜单切换默认翻译服务
• 硅基流动 / DeepSeek API Key 支持 Windows 用户环境变量（无需重启 AHK）
• 精简项目结构，修复 install.bat 开机启动项创建

快速开始

1. 解压 zip 到任意目录
2. 以管理员身份运行 install.bat（安装 Python 依赖，可选下载本地模型）
3. 运行 instantTrans_v2.exe
4. 选中文字，按 Ctrl+Shift+]

在线 API（可选）：设置 DEEPSEEK_API_KEY 或 SILICONFLOW_API_KEY 环境变量。不配置也可使用 Google / 本地模型。

instantTrans0.0.3

• 支持使用SnipDo来激活翻译

instantTrans0.0.2

• 添加 Azure Openai 服务支持
• 修改快捷键 ctrl+shift+]