Ghostscript Install

Ghostscript 一键安装

PDF 压缩依赖外部程序 Ghostscript（gs）。zipax 在检测到 Ghostscript 缺失时，会在结果列表顶部显示全局安装横幅（v0.25.4 引入，v0.25.5 改为内联卡片，v0.25.6 依据设计规范改为全局横幅）。

为什么需要 Ghostscript

• 核心库 image crate 无法直接压缩 PDF，zipax 通过调用系统 Ghostscript 完成 PDF 重压缩
• 因此 PDF 压缩功能需要系统级安装 Ghostscript

各平台安装方式

平台	方式	说明
macOS	Homebrew brew install ghostscript	一键安装命令自动执行
Windows	下载官方安装包并静默安装	exe /S 无界面安装
Linux	包管理器自动依赖	deb 依赖 ghostscript，apt 自动处理

注：Linux deb/rpm 包已在 tauri.conf.json 的 bundle.linux 中声明 ghostscript 依赖，apt install 时会自动装上。

前端交互（v0.25.6 起）

• 压缩 PDF 失败且错误为 Ghostscript 缺失时，结果列表顶部显示单一全局横幅（多个 PDF 失败也只出现一条）：
  • 状态机：idle → installing → installed → failed
  • 「一键安装」按钮 → 调用 installGhostscript() Tauri 命令
  • 安装中显示 Spinner 与状态文本
  • 安装成功后 800ms 自动重试所有受影响项
  • 失败时完整显示错误信息（含手动安装命令）+ 重试按钮
• 横幅文案全部走 i18n（home.gs* keys）
• 视觉规范对齐软件更新提示（.update-prompt 范式）

设计规范：docs/design-spec-pdf-ghostscript-ux.md

相关代码

位置	文件
Rust 后端	zipax-cross/src-tauri/src/gs_install.rs
命令注册	zipax-cross/src-tauri/src/lib.rs
前端绑定	zipax-cross/src/lib/tauri.ts
UI 全局横幅	zipax-cross/src/components/ManualCompressionParts.tsx
PRD	docs/prd-ghostscript-install.md

回到 Home · English: Ghostscript Install