企业官网建设流程全解析

Cherri（樱桃）是一門能把代码直接编译成 Apple「快捷指令」（Shortcuts）的编程语言，而 Cherri Playground 是它官方的在线编辑器——打开浏览器即可编写.cherri源码、实时预览编译结果，并一键导出签名好的.shortcut快捷指令文件。全程免安装、跨平台，Windows、Linux、Mac 用户都能 3 分钟内上手，把代码变成手机上真正可运行的快捷指令。

🛝 为什么需要 Cherri Playground

Cherri 的核心理念是把快捷指令当成"工程项目"来做：用接近 Go / Ruby 的语法写逻辑，再由编译器逐条翻译成快捷指令动作，生成可长期维护的大型快捷指令项目。

对新手来说，最大的门槛其实是环境：本地 CLI 需要安装 Cherri 编译器（支持 Homebrew 或 Nix 安装），签名又依赖 macOS 或远程服务。而 Playground 把这两步全部搬到了云端：

💡 提示：Playground 与本地编译器是同一套编译逻辑，代码完全互通——线上验证通过后，把.cherri源码存下来即可用 CLI 继续开发。

🚀 一键上手：从打开页面到导出签名快捷指令

整个过程只需四步，下面按操作顺序拆解。

第 1 步：打开 Playground 在线编辑器

在任意浏览器中打开 Cherri 官方 Playground（playground.cherrilang.org，ReadMe.md 的 Resources 一节有直达入口）。页面左侧是代码编辑区，右侧展示编译后的快捷指令动作预览。

第 2 步：写入第一段 Cherri 代码

仓库自带的 Hello World 示例只有几行，非常适合第一个程序。你可以参考 tests/hello-world.cherri 中的源码：

/* Hello, World! */ #define color yellow #define glyph smileyFace #define name Hello, Cherri! @message = "Hello, Cherri!" @title = "Alert" alert(@message, "{@title}")

逐行理解一下：

• #define：声明快捷指令的名称、颜色、图标等元信息；
• @message：定义变量，编译后会变成"设置变量"动作；
• alert(@message, "{@title}")：调用"显示文本"动作，{@title}是字符串插值语法。

Cherri 坚持"1 对 1 翻译成快捷指令动作"，所以右侧预览里你能看到每条语句对应的动作块，调试时心智负担很小。更多语法（条件、循环、函数、#include文件包含）可对照 CLAUDE.md 中的"Language Syntax Basics"一节，或参考 tests/ 目录下 40 多个按主题组织的示例文件。

第 3 步：实时预览编译结果

保存或停顿片刻后，Playground 会自动触发编译，右侧以快捷指令动作列表的形式呈现结果——相当于先"看一遍成品"再决定导出。若代码有语法或类型错误，编辑器会直接标出报错位置，无需在 macOS 终端里反复试错。

第 4 步：导出签名 .shortcut 文件

预览无误后，点击导出按钮即可获得签名后的.shortcut文件：

1. 文件下载到本地；
2. 通过 AirDrop、iCloud 或数据线传到 iPhone / Mac；
3. 点击文件，在弹出的确认页选择"添加快捷指令"。

签名环节你不用操心：编译器的签名逻辑（见 signing.go）在 macOS 上会优先调用系统shortcuts sign，在非 macOS 环境则自动回退到 HubSign 等远程签名服务，并校验返回内容确实以AEA1魔数开头才是有效签名文件。这也正是"免安装"能成立的关键——签名的服务器成本被 Playground 替你付掉了。

⚙️ 进阶小贴士：签名范围与源码管理

控制签名分享范围。编译时可通过--share参数选择签名模式：

# 仅限你的联系人安装（默认，隐私优先） cherri file.cherri --share=contacts # 任何人拿到 .shortcut 都可安装 cherri file.cherri --share=anyone

对应源码在 args.go 与 signing.go 中：people-who-know-me与anyone是 macOS 签名命令的两种模式，默认取更保守的contacts。

导出后再回本地开发。当你想继续迭代时，把.cherri源码保存下来，在本地执行：

cherri file.cherri --debug

--debug会额外输出.plist中间文件和调试信息，方便对照快捷指令的真实数据结构排查问题（参数说明见 args.go）。

用文档和搜索命令辅助写代码。不知道某个动作怎么写？Cherri 内置了文档与检索能力：cherri --docs可按分类生成全部动作说明（入口在 docs.go），cherri --action=动作名直接查询单个动作的签名。这些命令在 Playground 对应的语言文档中同样可查。

善用标准库。标准库动作以 Cherri 语言自身编写，存放在 actions/ 目录（24 个分类文件，覆盖网络、日历、加密、Apple Intelligence 等），用#include 'actions/network'这样的语句按需引入，语法详见 tests/includes.cherri。

📦 项目资源速览

✅ 小结

Cherri Playground 让"用代码写快捷指令"这件事第一次真正做到了零门槛：浏览器里写完.cherri源码，云端编译预览，直接导出签名.shortcut拖进手机即可运行。如果你长期维护快捷指令，建议先用 Playground 尝鲜验证想法，再把源码迁移到本地 CLI 工程化管理——语法完全一致，无缝衔接。现在就去 Playground 写下你的第一段 Cherri 代码吧！🍒