安装指南

不用懂命令行也能装好:整篇只需要复制粘贴几条命令,每条旁边都有「复制」按钮。

先看这里:目前版本只支持苹果芯片(Apple M1 / M2 / M3 / M4)的 Mac,Intel 处理器的 Mac 暂不支持。 不确定自己是什么芯片?看下面的第一步。

1第一步:确认芯片型号

点屏幕左上角的苹果菜单()→ 选择「关于本机」→ 找到「芯片」这一行:

「芯片」一行显示什么结论
Apple M1 / M2 / M3 / M4✅ 可以安装,继续下一步
Intel Core i5 / i7 / i9 等❌ 本版本暂不支持,请等待 Intel 版本

2第二步:安装 Homebrew(已有可跳过)

Homebrew 是 Mac 上常用的软件安装工具。装过一次,以后升级软件都方便。

先检查是否已经装过

打开「终端」:按 Command + 空格,输入 终端(或 Terminal),回车。在弹出的窗口里粘贴下面这行(Command + V),按回车:

brew --version

安装 Homebrew

这一步要从官网下载,需要能正常访问 GitHub。如果长时间卡住,请开启代理后重试。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

接下来按提示做:

  1. 提示 Press RETURN to continue → 按一下回车键
  2. 提示 Password: → 输入你的 Mac 开机密码再回车。输入时屏幕不会显示任何字符(连圆点都没有),这是正常的,照常输完直接回车
  3. 等待 3~10 分钟,出现 Installation successful! 就是装好了

装完让它生效

关掉终端窗口,重新打开一个,再执行一次 brew --version。

如果仍然提示 command not found,把下面两行依次粘贴执行(每行回车一次),然后再检查:

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

3第三步:安装大柿编剧故事板

在终端里粘贴下面这一行,按回车。它会自动下载安装包(约 106 MB)并装到「应用程序」文件夹,不需要输入密码:

brew install --cask koopan233-cyber/homebrew-tap/wzstoryboard

看到这一行就是成功了:

🍺  wzstoryboard was successfully installed!

4第四步:打开软件

打开启动台(触控板四指捏合,或点 Dock 上的火箭图标),找到「大柿编剧故事板」点开即可。

装好后它就在「访达 → 应用程序」里,跟从 App Store 装的软件一样,重启电脑也不会消失。

通过 Homebrew 安装时,已经自动处理好了 macOS 的「无法验证开发者」拦截,正常双击就能直接打开。

万一系统仍弹出「无法验证开发者」:打开 系统设置 → 隐私与安全性,在下方找到关于本软件的提示,点「仍要打开」。之后就不会再拦了。

5升级与卸载

升级到新版本

我们发布新版本后,粘贴这一条即可升级,你的项目数据不会丢:

brew update && brew upgrade --cask wzstoryboard

卸载

brew uninstall --cask wzstoryboard

卸载只删软件本身,项目数据仍保留在系统里。

6常见问题

Q1 终端提示 brew: command not found
Homebrew 没装好或环境没生效。回到第二步重做一遍,特别是「装完让它生效」那一段。

Q2 下载卡住不动,或报 curl: (35) / Failed to connect
网络访问 GitHub 受限。请连接代理后重新执行命令。这是下载通道的问题,与软件本身无关。

Q3 提示 Error: Cask 'wzstoryboard' is unavailable
命令打错了。请务必用完整写法(带来源地址那一串):brew install --cask koopan233-cyber/homebrew-tap/wzstoryboard

Q4 提示「此应用与此 Mac 不兼容」或架构错误
你的 Mac 是 Intel 处理器版本。本版本只支持苹果芯(Apple M 系列),Intel 版尚未发布。

Q5 装完在启动台找不到图标
在启动台搜索框输入「大柿」即可,或打开「访达 → 应用程序」查看。

Q6 打开时提示「无法验证开发者」
见第四步:到「系统设置 → 隐私与安全性」里点「仍要打开」。

Q7 不想用命令行
可以到 GitHub 发布页下载 .dmg 安装包,双击安装。注意:直接下载的安装包第一次打开时,macOS 大概率会拦一次,需要按 Q6 的方法放行;Homebrew 方式则没有这一步。