使用文档

安装、更新、卸载与排查。

按平台照做即可。文件名、路径和按钮文字均对照当前 v3.4.0 安装包。插件未做代码签名,macOS 首次打开需在系统设置里放行一次。

macOS 安装

  1. 完全退出 Illustrator。
  2. 双击下载的 HopeFlow-Toolbox-3.4.0-macOS-secure.dmg 打开。
  3. 双击里面的「HopeFlow 安装器」。首次打开若提示无法验证开发者或已损坏,按下方「打不开安装器」对应的情况处理。
  4. 安装器标题为「正在为您的 Illustrator 安装 HopeFlow」,会自动检测已安装的版本并显示进度。较慢的一步会显示「正在准备 AI 环境...」,完成后点「完成」。
  5. 重新启动 Illustrator。

也可使用 ZIP 版 HopeFlow-Toolbox-3.4.0-macOS-secure.zip:解压后打开「HopeFlow 安装器.app」,装出来的内容与 DMG 一致。

macOS · 打不开安装器

按提示文字对号入座

HopeFlow 安装器没有做 Apple 代码签名和公证,macOS 第一次打开时会拦一下。这是系统对所有未公证软件的默认行为,放行一次后就不会再提示。先用下载页的 SHA-256 核对文件无误,再按下面对应的情况处理。

情况 A

「无法打开 “HopeFlow 安装器”,因为无法验证开发者」
或「Apple 无法检查其是否包含恶意软件」

  1. 在弹窗里点「完成」或「取消」,先关掉它。
  2. 打开「系统设置 → 隐私与安全性」,滚到最下面的「安全性」一栏。
  3. 找到「已阻止使用 “HopeFlow 安装器”」,点右侧的「仍要打开」,输入开机密码确认。
  4. 再次双击安装器,在弹窗里点「打开」。

macOS 14 及更早版本也可以直接在安装器上右键(或按住 Control 点按)→「打开」→「打开」。macOS 15 起右键打开不再有效,只能走上面的系统设置。

情况 B

「“HopeFlow 安装器” 已损坏,无法打开。你应该将它移到废纸篓」

文件本身没坏,是下载时被系统打上了隔离标记。去掉标记即可:

  1. 把「HopeFlow 安装器」从 DMG 窗口拖到桌面(ZIP 版解压后同样拖到桌面)。DMG 是只读的,不能在里面直接处理。
  2. 打开「终端」(启动台搜索“终端”或 Terminal),粘贴下面这行并回车:
    xattr -cr ~/Desktop/HopeFlow\ 安装器.app
  3. 回到桌面双击「HopeFlow 安装器」。如果又出现情况 A 的提示,按情况 A 放行一次。

命令没有任何输出就是成功了。若提示 No such file,说明安装器不在桌面:先输入 xattr -cr 加一个空格,再把安装器图标拖进终端窗口,回车。

情况 C

DMG 双击没反应,或提示「无法打开映像」

  1. 多半是下载没完成。重新下载一次,用 shasum -a 256 文件名 与下载页的 SHA-256 比对。
  2. 仍不行就改用 ZIP 版:解压后打开「HopeFlow 安装器.app」,装出来的内容与 DMG 一致。

以上都试过还是打不开,请在公众号留言,附上 macOS 版本号和弹窗截图。不建议用 sudo spctl --master-disable 关闭整台电脑的安全检查。

Windows 安装

  1. 完全退出 Illustrator。
  2. 双击 HopeFlow-Toolbox-3.4.0-Windows-secure-Installer.exe。若出现「Windows 已保护你的电脑」,点「更多信息 → 仍要运行」。
  3. 安装器窗口标题为「HopeFlow 安装器」,会自动检测已安装的 Illustrator 并显示进度。较慢的一步会显示「正在准备 AI 环境...」,完成后点「完成」。
  4. 重新启动 Illustrator。

如果安装器被杀毒软件直接删除或拦下,请改用下载页的 ZIP 版 HopeFlow-Toolbox-3.4.0-Windows-secure.zip:解压后双击 HopeFlow-Installer.bat,装出来的内容与 .exe 完全一致。

在 Illustrator 中打开

进入「窗口 → 扩展功能 → HopeFlow 工具箱」。面板支持跟随 Illustrator 主题,并可配置主色。

更新与重装

从旧版本升到 v3.4.0,或同一版本重装,都用同一套安装器。不必先卸载。

能不能直接覆盖安装

可以。再运行一次新版安装器即可覆盖旧文件。安装器会先写到临时目录,成功后再替换现有面板;这一步失败时会把旧目录换回来,避免留下半残安装。

更新前要关闭 Illustrator

必须完全退出 Illustrator(不是只关文档或关掉面板)。Windows 安装器会先结束后台引擎;若仍提示文件被占用,请在任务管理器里确认 Illustrator 已退出后再装。

更新后要重启 Illustrator

安装器完成页会提示:重启 Illustrator,从「窗口 → 扩展功能」打开 HopeFlow 工具箱。不重启时,面板可能仍是旧版本,或原生组件未加载。

设置、授权和 AI 环境会保留

会保留。覆盖安装只替换插件目录和 HopeFlow.aip,不会删除用户主目录下的 .hopeflow。这里存放本机设置、授权信息和独立 Python 环境,重装后不必重新激活或重新准备 AI 环境。

更新失败后怎么恢复

  1. 完全退出 Illustrator,再运行一次同一份安装器。
  2. 若 Windows 提示无法删除旧版本目录,先结束后台 Illustrator 进程,再重试。
  3. 若进度停在「正在准备 AI 环境...」或显示「AI 环境未装成(不影响面板使用)」,面板和增效工具已经装好。稍后按 Python 环境 一节修复即可,不必整包重来。
  4. 仍失败时,用 ZIP 版做一次标准卸载(见下一节),再重新安装。只要没有删除 .hopeflow,设置和授权都在。
  5. 把安装器里的「复制日志」发给我们。macOS 日志还在 ~/Library/Logs/HopeFlow-Installer.log。

卸载 HopeFlow

卸载前请完全退出 Illustrator。卸载面板时还要删除随插件安装的 HopeFlow.aip,否则 Illustrator 中仍可能残留 HopeFlow 的原生功能。

Windows

脚本卸载

推荐使用下载页的 ZIP 版 HopeFlow-Toolbox-3.4.0-Windows-secure.zip:解压后在该文件夹的地址栏输入 powershell 并回车,然后运行:

.\HopeFlow-Installer.bat -Uninstall

它会删除 CEP 面板目录和已安装的 HopeFlow.aip,不会删除 .hopeflow。

手动卸载

按 Win + R,依次打开并删除以下内容:

  • %APPDATA%\Adobe\CEP\extensions\com.hopeflow.toolbox
  • 在 %APPDATA%\Adobe\Adobe Illustrator * Settings\<语言>\x64\ 下的 Plug-ins 或 增效工具 文件夹中,删除 HopeFlow.aip。

macOS

脚本卸载

图形安装器没有卸载按钮。用 DMG 或 ZIP 里的「HopeFlow 安装器.app」:右键 → 显示包内容,进入 Contents/Resources/payload/,在终端运行:

./install.sh --uninstall

同样只删除面板和 HopeFlow.aip,保留 .hopeflow。

手动卸载

在访达中选择「前往 → 前往文件夹」,依次打开并删除以下内容:

  • ~/Library/Application Support/Adobe/CEP/extensions/com.hopeflow.toolbox
  • 在每个已安装的 /Applications/Adobe Illustrator 20xx/ 目录中,检查 Plug-ins、Plug-ins.localized 或 增效工具 文件夹并删除 HopeFlow.aip。系统要求密码时按提示授权。

标准卸载与彻底清理

以上标准卸载会保留 HopeFlow 的设置、授权信息和 AI 运行环境,方便以后重装。若要连同个人数据一起清除,再删除用户主目录下的 .hopeflow 文件夹:

  • Windows:%USERPROFILE%\.hopeflow
  • macOS:~/.hopeflow

此操作会清除本机设置、授权缓存、更新缓存和已下载的 AI 运行环境。完成后重新启动 Illustrator,确认「窗口 → 扩展功能」中已没有 HopeFlow 工具箱。

Python 环境

安装器会自动准备一套 HopeFlow 独立 Python 环境。进度条上对应的文字是「正在准备 AI 环境...」。它装在你的用户目录里,不需要管理员权限,也不会修改系统 Python(不论官方安装、Homebrew、conda 还是 Microsoft Store 占位程序)。

谁需要它

CEP 面板和大多数工具不依赖 Python。需要本地引擎的功能包括:AI 绘图、大尺寸导出、透视矫正,以及数据合并导出 PDF、专色 TIFF / PDF。这些计算都在本机完成(AI 绘图会访问你自己配置的在线接口)。

装在哪里

  • Windows:C:\Users\<你的用户名>\.hopeflow\python\
  • macOS:/Users/<你的用户名>/.hopeflow/python/

当前 v3.4.0 准备的是 Python 3.12,具体目录名为 3.12.13。不写入系统 PATH,不改注册表,不开机自启。

下载失败

这一步需要联网:先下载独立运行时,再安装依赖。安装器可能依次显示「正在下载 Python 运行时...」「正在校验文件完整性...」「正在安装 AI 依赖(较慢,请耐心等待)...」。

  • 换一个网络重试,手机热点常常比公司网络更通。
  • 若提示校验失败,安装会直接中止,不会写入半残文件。换网络后再跑一次。
  • Python 没装成时,安装器会显示「AI 环境未装成(不影响面板使用)」。面板和增效工具已经可用,只是上述依赖 Python 的功能暂时不能用。

依赖失败

脚本会依次尝试清华、阿里云和官方 PyPI。全部失败时,把日志发给我们即可。重跑是安全的,已下载的部分不会白费。

  • macOS:~/.hopeflow/python-setup.log
  • Windows:C:\Users\<用户名>\.hopeflow\python-setup.log

重新安装自带环境

  1. 打开面板,进入设置里的「Python 环境」(说明文字为「统一使用自带运行时」)。
  2. 确认当前状态后,点「安装 / 修复自带环境」。装好后应显示「运行环境已就绪」。
  3. 也可点「重新检查」只查看状态,不重新下载。

也可以手动跑安装目录里的脚本(与安装器、面板用的是同一份):

  • macOS:~/Library/Application Support/Adobe/CEP/extensions/com.hopeflow.toolbox/tools/python-setup/setup-python.sh
  • Windows:在 %APPDATA%\Adobe\CEP\extensions\com.hopeflow.toolbox\tools\python-setup\ 中运行 setup-python.ps1。若禁止运行脚本,使用 powershell -ExecutionPolicy Bypass -File .\setup-python.ps1。

已经装坏时加上 --force(Windows 为 -Force)强制重装。装好后请完全退出并重新打开 Illustrator。

备用:使用本机已有的 Python

当前 v3.4.0 面板只使用 HopeFlow 自带运行时,不再扫描 Homebrew、conda、py 启动器或系统 PATH,以免再次选中系统保护的解释器。若必须改用本机已有的 Python 3.9–3.12,请先确认自带环境无法修复,再通过公众号把解释器路径发给我们协助排查。安装器可用 --no-python(Windows 为 -NoPython)跳过自动准备,但 AI 相关功能仍要等独立环境就绪后才能用。

兼容性

「支持 Illustrator 2019–2026」指的是 CEP 面板,不是每一个原生功能。HopeFlow AIP 用 2021 SDK 编译,只安装到 Illustrator 2021–2026;2019 和 2020 可以打开面板、使用 JSX 功能,但不会加载原生组件。

项目支持范围说明
CEP 面板Illustrator CC 2019–2026基础面板与 JSX 功能。Illustrator 23.0(CC 2019)即可打开「HopeFlow 工具箱」。
HopeFlow AIPIllustrator 2021–2026原生加速与智能编组等功能。2019 / 2020 不会安装 AIP,面板与 JSX 功能仍可使用。
macOSApple Silicon / Intel当前安装包为 Apple / Intel 通用。插件未做代码签名,首次打开需在系统设置里允许。
Windows64 位系统提供 EXE 安装器与 ZIP 两种方式,装出来的内容一致。
Python 功能独立运行环境AI 绘图、大尺寸导出、透视矫正等使用 HopeFlow 自带 Python,不修改系统 Python。

常见问题

在线体验能代替插件吗?

不能。在线体验是独立 SVG 网页模拟;专业功能标为简化演示,不提供生产输出。快捷菜单与浮动工具条(Beta)已包含在 v3.4.0 安装包里。

支持哪些 Illustrator 版本?

CEP 面板支持 Illustrator CC 2019(23.0)到 2026,基础面板与 JSX 功能都可以用。HopeFlow AIP 原生组件只支持 Illustrator 2021–2026;2019 和 2020 不会安装 AIP,也不要按「每个原生功能都支持 2019」来理解。

更新时要先卸载旧版吗?

不需要。直接再运行一次新版安装器即可覆盖安装。更新前请完全退出 Illustrator,装完后重新打开。设置、授权和 AI 运行环境会保留。

macOS 提示「无法打开,来自身份不明的开发者」怎么办?

安装器未做 Apple 代码签名与公证,系统会拦截第一次打开。打开「系统设置 → 隐私与安全性」,在最下方点「仍要打开」并输入开机密码,再双击安装器点「打开」。macOS 14 及更早也可以对安装器右键选择「打开」;macOS 15 起只能走系统设置。

macOS 提示「HopeFlow 安装器已损坏,无法打开」怎么办?

文件没有损坏,是下载时被系统加了隔离标记。把安装器从 DMG(或解压出的文件夹)拖到桌面,打开「终端」执行 xattr -cr ~/Desktop/HopeFlow\ 安装器.app,再双击桌面上的安装器。若仍提示无法验证开发者,按上一条在系统设置里放行一次。

Windows 下载或安装时被杀毒软件拦截怎么办?

插件未做代码签名,安装器又是自解压程序,容易被 SmartScreen 或杀毒软件误判。可以先用下载页的 SHA-256 核对文件无误,再点「更多信息 → 仍要运行」;若安装器被直接删除,请改用下载页的 ZIP 版,解压后双击 HopeFlow-Installer.bat,装出来的内容与 .exe 完全一致。

AI 绘图、大尺寸导出这些功能提示找不到 Python 怎么办?

这些功能使用 HopeFlow 独立 Python 环境,不依赖、也不会修改系统 Python。安装器会自动准备,进度里显示「正在准备 AI 环境...」。若没装成,打开面板后到设置的「Python 环境」点「安装 / 修复自带环境」;也可手动运行安装目录里的 setup-python 脚本。

怎么校验下载的安装包完整?

下载页给出了每个安装包的 SHA-256。macOS 执行 shasum -a 256 文件名,Windows 执行 certutil -hashfile 文件名 SHA256,与页面上的值逐字比对。

可以直接复制插件文件夹吗?

不建议。请使用对应平台的安装器,直接复制会遗漏 CEP 调试设置与原生组件,导致面板打不开或部分功能不可用。

专业功能怎么解锁?

支付宝扫码订阅后,授权绑定当前电脑。未订阅时每个专业功能可免费试用 3 次,试用次数记录在服务器上。

遇到问题怎么反馈?

关注微信公众号(二维码在「关于」页)留言即可。安装问题请附上系统版本和报错截图。