从这里开始

安装

Ferret 是一款适用于 macOS、Windows 和 Linux 的桌面应用。macOS 版使用 Developer ID 签名，并经过 Apple 公证。Windows 版和 Linux 版尚未进行代码签名，因此这些系统会在首次启动时要求你确认。

#下载

从下载页面获取适合你的操作系统和 CPU 的文件。文件由 Cloudflare R2 提供，而不是 GitHub Releases，并且只保留最近的 10 个版本。

操作系统	文件
macOS (Apple silicon / Intel)	`Ferret-<version>-mac-arm64.dmg`, `Ferret-<version>-mac-x64.dmg`
Windows (x64 / arm64)	`Ferret-<version>-win-x64.exe`, `Ferret-<version>-win-arm64.exe` （NSIS 安装程序）
Linux (x64)	`Ferret-<version>-linux-x86_64.AppImage`, `Ferret-<version>-linux-amd64.deb`

0.1.x 及更早的版本以旧名称 MOVIE-ADE-<version>-… 发布。从 0.2.0 开始使用 Ferret-… 名称。

Ferret 支持 macOS、Windows 和 Linux。Windows 版和 Linux 版尚未进行代码签名，因此首次启动时需要你确认（参见下面的步骤）。

#验证下载（已签名的 SHA256SUMS）

每个版本都附有 SHA256SUMS 文件及其签名 SHA256SUMS.sig。签名使用 Ferret 发布密钥生成，该密钥与下载服务器分开保管，因此即使下载服务器上的安装程序被篡改，也无法附带有效的签名。公钥不从下载服务器获取：请从代码仓库获取（build/release-signing/allowed_signers （在新标签页中打开）），或从这里复制：

[email protected] ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIEpXERU8ST0MEOIMbzoL4zShkjIrMB4++NL3xBohKAS9

其指纹为 SHA256:c7dvwwJQyY9qSstkmrO8JoVZ90DCaFZBAzjqV04N8zQ。GitHub 上的每个版本也附有相同的文件。先用 ssh-keygen（macOS、Windows 10 及更高版本和 Linux 均自带）验证签名，再将下载文件的哈希值与已签名的列表进行比对：

# the download server (currently the R2 public URL; it may move to a custom domain)
BASE=https://pub-588d93b3e875464f98d6cf98dc711a0c.r2.dev
VERSION=$(curl -s $BASE/latest.json | jq -r .version)
curl -sO $BASE/releases/$VERSION/SHA256SUMS
curl -sO $BASE/releases/$VERSION/SHA256SUMS.sig

# save the public key above as allowed_signers, then:
ssh-keygen -Y verify -f allowed_signers -I [email protected] -n ferret-release -s SHA256SUMS.sig < SHA256SUMS
# → Good "ferret-release" signature for [email protected] …

# macOS
shasum -a 256 -c SHA256SUMS --ignore-missing
# Linux
sha256sum -c SHA256SUMS --ignore-missing

# Windows (PowerShell): compare with the line for your file in SHA256SUMS
Get-FileHash .\Ferret-<version>-win-x64.exe -Algorithm SHA256

如果 ssh-keygen 没有输出 Good "ferret-release" signature，或者哈希值不在列表中，请停止使用该文件。Ferret 的检查更新会使用内置于应用中的密钥执行同样的检查，不会提供签名不匹配的版本。在 macOS 上，你还可以用 spctl -a -vv /Applications/Ferret.app 检查 Developer ID 签名和公证。Windows 和 Linux 的安装程序尚未获得 Microsoft 或 Linux 发行版的代码签名。0.3.0 及更早的版本发布于开始签名之前，只有 releases/<version>/manifest.json 中未签名的哈希值。

#macOS

打开 .dmg，将 Ferret.app 拖到 /Applications。
启动应用。该应用使用 Developer ID 签名并经过 Apple 公证（已附加公证票据），因此打开时不会出现警告。

自行检查签名：

spctl -a -vv /Applications/Ferret.app
# accepted
# source=Notarized Developer ID

仅旧版本（0.2.0 build 2 及更早）未经签名。对于这些版本，macOS 会提示无法验证开发者：关闭对话框，打开系统设置 → 隐私与安全性，点击 Ferret 提示旁边的仍要打开，然后点击打开确认。如果提示应用“已损坏”，请移除隔离属性：

xattr -dr com.apple.quarantine /Applications/Ferret.app

#Windows

运行 Ferret-<version>-win-<arch>.exe。
当 SmartScreen 显示“Windows 已保护你的电脑”时，点击更多信息，然后点击仍要运行。
选择安装文件夹。安装程序会创建桌面快捷方式。

#Linux

AppImage:

chmod +x Ferret-<version>-linux-x86_64.AppImage
./Ferret-<version>-linux-x86_64.AppImage

Debian / Ubuntu:

sudo apt install ./Ferret-<version>-linux-amd64.deb

deb 会安装 ferret 软件包和命令。

在 Ubuntu 23.10 及更高版本上，AppImage 可能在启动时因沙盒错误而停止，这是因为 AppArmor 限制了 Electron 沙盒所使用的用户命名空间。请改为安装 .deb，它会配置好沙盒辅助程序。

#从源码构建

需要 Node.js 20+（CI 和本地开发使用 22）、pnpm 和 git。

git clone https://github.com/JapanMarketing-Dev/ferret.git
cd ferret
pnpm install          # postinstall prepares node-pty for Electron
pnpm dev              # run in development mode

打包安装程序（输出到 dist/release/，配置在 electron-builder.config.cjs 中）。Linux 版只能在 Linux 上构建。

pnpm dist:mac     # dmg (arm64, x64)
pnpm dist:win     # NSIS installers (x64, arm64)
pnpm dist:linux   # AppImage + deb (x64)

build:<os>:dev 脚本只生成未打包的应用（--dir），用于本地测试时更快。

在 Windows 上，pnpm install 会使用 node-pty 自带的预编译二进制文件，而不是重新构建（重新构建需要 Visual Studio C++ 生成工具）。设置 ADE_FORCE_NATIVE_REBUILD=1 可强制重新构建。

如果终端提示无法加载 node-pty，请运行 pnpm rebuild:native。

#更新

Ferret 不会自动更新。在底部状态栏中打开更新，然后点击检查更新。它会从下载服务器（R2）获取 latest.json，比较版本，并提供下载页面的链接。从 0.4.0 开始，它还会使用内置于应用中的发布密钥验证该版本 SHA256SUMS 的签名，不会提供无法验证签名的版本。在你点击之前不会进行任何检查，也不会自动安装任何内容。

在 GitHub 上帮助翻译此页（在新标签页中打开）