WordCraft 的 Mac 版只有一个文件，同时支持 Apple 芯片和 Intel 芯片的 Mac。下载上面的磁盘映像（.dmg），把 WordCraft 拖进“应用程序”文件夹，打开即可。
系统要求
- macOS 11 Big Sur 或更新版本：0.7.0 版的程序声明的最低系统版本是 macOS 11。
- Apple 芯片和 Intel 芯片的 Mac 都可以：这是一个通用（Universal）程序，同时包含两种处理器的原生代码。
GitHub 下载慢怎么办
GitHub 在部分地区下载较慢，安装包又比较大（大小见上方），可以换个时间再试，或者用支持断点续传的下载工具。不要从网盘或来源不明的“镜像站”下载。下载完成后，按本页最后的方法核对 SHA-256 校验值。
安装步骤
- 从上面下载
.dmg文件。 - 打开它，在弹出的窗口里把 WordCraft 图标拖到 Applications（应用程序）文件夹上。
- 在访达侧边栏里推出名为 WordCraft 的磁盘。之后可以删掉 .dmg 文件。
- 从“应用程序”或启动台打开 WordCraft。第一次打开时，macOS 会提示这是从互联网下载的 App，问你是否确定要打开，点 打开。
确认是官方版本
这个 App 用 Learning Machines LLC 的 Apple 开发者 ID 签名（团队 ID DJ6XS33FX8），并经过 Apple 公证，所以 macOS 不会拦截它。我们用 Apple 的 codesign 和 spctl 工具核对过 0.7.0 版的磁盘映像和其中的 App。想核对自己的这一份，在“终端”里运行：
spctl -a -vv /Applications/WordCraft.app
结果里应当有 accepted、source=Notarized Developer ID 和 origin=Developer ID Application: Learning Machines LLC (DJ6XS33FX8)。
如果 macOS 提示“已损坏”，或者“无法验证是否包含恶意软件”，不要想办法绕过这个提示：说明你手上的不是经过公证的官方版本，或者文件下载不完整。删掉它，到官方发布页重新下载。更多核对方法见 WordCraft 安全吗？
用 WordCraft 打开 .docx
WordCraft 会把自己登记为 Word 文档和模板（.docx、.dotx、.doc）、OpenDocument 文本（.odt）、RTF、Markdown、HTML 和纯文本的备选程序，所以在访达的 打开方式 里能找到它，但它不会把自己设为默认程序。
想让所有 .docx 文件默认用 WordCraft 打开：在访达里选中一个 .docx 文件，选 文件 → 显示简介，在 打开方式 里选 WordCraft，再点 全部更改。
命令行工具
另一个文件是命令行工具，里面是 wordcraft-cli，可以在“终端”里转换和查看文档，同样经过签名和公证。只有写脚本或接入 AI 助手时才需要它。试用方法：
unzip wordcraft-cli-0.7.0-macos-universal.zip
cd wordcraft-cli-0.7.0-macos-universal
./wordcraft-cli convert report.docx report.pdf
它可以在 .docx、PDF、.odt、.rtf、HTML、Markdown、LaTeX、纯文本和 PNG 页面图片之间转换。
设置和日志存在哪里
| 内容 | 位置 |
|---|---|
| 设置 | ~/Library/Application Support/WordCraft |
| 日志文件 | ~/Library/Application Support/WordCraft/logs/wordcraft.log |
在访达里选 前往 → 前往文件夹，粘贴上面的路径即可打开。反馈问题时附上日志文件，日志里不会记录文档的文字内容。
卸载
把 WordCraft 从“应用程序”拖到废纸篓。如果不想保留设置和日志，再删除 ~/Library/Application Support/WordCraft。
更新
下载新的 .dmg，再把 WordCraft 拖进“应用程序”一次，访达询问时选 替换。设置会保留。
遇到问题
WordCraft 官方 README 没有列出 Mac 上特有的启动问题。如果遇到崩溃或异常，可以到 GitHub Issues 反馈，并附上日志文件。
使用前须知
WordCraft 还处于 Alpha 阶段。开发团队估计，它在实际工作中替代 Word 的程度约为 60%；用户遇到的崩溃和卡死，在他们自己列出的不足里排得很靠前。重要文档请留好副本，发给别人之前最好在 Word 或其他软件里检查一遍。
界面可以显示简体中文和繁体中文，默认跟随系统语言，也支持中文输入法；但拼写和语法检查只支持英语，以及系统里装有词典时的波兰语、葡萄牙语、意大利语和克罗地亚语，不检查中文。更多尚未支持的功能，见功能介绍。