在 WidgetCraft 里创建你的第一个组件：模版、社区、空白画布

简短回答

WidgetCraft 给你三条做出组件的路：从 200 多个预设模版里挑一个起步、从社区导入一个、或从空白画布自己搭。选哪条都是同一个编辑器——容器、文字、图片、形状、图表、数据绑定和效果，拖到位就能实时预览。组件共六种尺寸：主屏幕小、中、大，以及锁屏圆形、矩形、行内。做组件不用注册账号，核心编辑和预览也能离线完成。

有两件事值得先知道。第一，WidgetCraft 免费，但有边界：每种尺寸只能放一个组件，标着 VIP 的设计锁着，Pro 解开这两处限制。第二，第一个组件要真正出现在主屏幕上，中间有一段会吓到所有人的 iOS 绕路——先在 App 里把设计存下来，再通过系统的小组件画廊加上来。如果你只想让它出现在屏幕上，WidgetCraft 已经在 App Store 上架，完整产品页在 agentsmesh.app/products/widgetcraft。

为什么第一个组件最难

没人是因为「做组件很难」才来搜这个的。它之所以难，难在它周围的那一圈东西。

任何「什么都能表达」的设计工具，对只想在屏幕上放个时钟的人来说都让人发怵。第一次打开它，就是它证明自己能不能被学会的时刻。WidgetCraft 的引导流程就是答案——首运行先给你一个能玩的 2048 组件，因为能点的组件比只能看的组件好懂。

第二道墙才是真正会撞上的那道。在 iOS 上，组件设计不是你拖到屏幕上的壁纸，而是 App 保存的设计文档，只有在主屏幕编辑模式里添加小组件时才会显示出来。所以顺序永远是：设计、保存，然后长按主屏幕，点左上角的 +，搜索 WidgetCraft，选尺寸。少做后半段你就会以为组件丢了——它没丢，只是存着，还没加上去。

选一个起点

模版是最快的路，也是大部分第一个组件该走的路。预设库有 200 多个设计，按场景分类——天气、日历、照片、倒计时、健康、效率、装饰——每个都能直接用，也能打开进编辑器。内置预设覆盖一百多个组件：时钟、天气、日历和日程样式、倒计时、照片墙、步数和健身追踪、电池与系统信息，还有 40 个锁屏设计。模版每一层都能改，挑中的模版最终可以变成任何东西。

社区导入适合「已经有一个差不多是你想要的」情况。组件通过二维码或 .widgetdoc 文件分享，WidgetCraft 扫一下或导入就直接进了「我的组件」，变成可以照常编辑的普通组件。想要别人那份付费设计又不想重画，导入也是办法。

空白画布给你最多的控制权，也给你最多的活。图层系统在这里是一个真正的设计工具：容器图层（堆叠和网格）、内容图层（文字、弧形文字、图片、GIF、日期、图表、点击动作、占位）和形状图层。每一层都能配自己的背景——静态、跟随系统、渐变或图片——外加不透明度、圆角和边框样式；效果页签有模糊、缩放、阴影、旋转和 3D 旋转、亮度、对比度、饱和度、灰度、色相旋转、反相、正片叠底、混合模式和逐层动画。文字图层可调字体、字号、字重、颜色（静态、自适应或渐变）、对齐方式、行数、下划线和删除线。主题模式逐组件设置：跟随系统、强制浅色或深色。

AI 辅助生成是第四个选项，不是第三个起点。你描述或生成一个设计，再改结果。这是整个 App 里唯一需要联网的部分；其他一切——模版、编辑器、社区、预览——都离线可用。

编辑器真正能改什么

让人栽跟头的不是样式，是数据层。文字或数值图层不必写死内容，可以绑定到一个数据源，绑定后就自己更新。数据源可以是系统时间、数据提供方、自己的 HTTP API、在多个取值间挑选的条件提供方、脚本，或者纯文本。这些提供方包括：

• 天气，通过网络获取并缓存一小时
• Apple Health，只读：活动圆环、步数、距离、活动能量和睡眠。每个读它的组件，在 iOS 弹权限前都会标注「Data from Apple Health」
• 日历日程、倒计时、设备信息、正在播放的音乐、图库查询，以及你自己的 HTTP API

权限跟着数据走：健康、日历、照片图库、相机、蓝牙和位置，都只在第一次添加需要它们的组件时各问一次。没有任何数据会写回健康 App。天气组件依然要联网，因为数据来自天气服务而不是设备本身。可点击的图层也属于同一套模型：一个点击动作可以打开另一个 App、播放一个声音，或者打开一个网址。

免费在哪里，限制到底在哪

免费版是每种尺寸一个组件——主屏幕小、主屏幕中，依此类推——而模版、编辑器、预览、社区导入和数据绑定都能用。标着 VIP 的设计锁着，Pro 会同时解开位置限制和 VIP 设计。发布时价格是每月 $4.99、每年 $19.99，或一次性 $49.99 买断，其他地区按当地价格调整。

这是第一个组件诚实的限制，而且有点怪：编辑器里可以设计任意多个组件，免费版却只给你留每种尺寸的那一个。把第一个组件规划成你真正会留下的那个。

从模版到主屏幕

完整流程，从头到尾：

1. 挑一个模版、扫一个社区二维码，或按想要的尺寸开一个空白组件。
2. 在编辑器里改背景、改文字、改数据源，预览会跟着你走。
3. 点「Save to My Widgets」。设计存下来了，但它还不在任何屏幕上。
4. 长按主屏幕，点左上角的 +，搜索 WidgetCraft，选小、中或大，再选中你的设计。
5. 回到主屏幕，如果组件显示的还是上次编辑前的版本，那是 iOS 的组件缓存，不是 bug。等几秒刷新，或者删掉再加一次。

两个容易漏掉的细节：不升 Pro 就没法把同一个设计的小、中尺寸同时留在屏幕上；已保存的组件必须先从「我的组件」移除，才能在编辑器里删除。

WidgetCraft 有什么不一样

WidgetCraft 不是一个能设成壁纸的图片画廊——它是一个带设计编辑器的组件运行时。由此带出三件事，而那些显而易见的替代方案一件都不成立：

• 可玩的组件。 内置预设里有二十多个是游戏——2048、数独、国际象棋、五子棋、黑白棋——直接响应组件上的点击。苹果自己的小组件画廊和捷径都没有对应的东西。
• 真正的图层系统。 逐图层的不透明度、混合模式、3D 旋转和动画，组件的数据源绑在图层上，而不是固定在模版里。捷径能把实时数据放到主屏幕上，但没法在数据周围画一套自己的布局。
• 按 iOS 节奏刷新的实时数据。 绑定到时间、天气或健康数据的组件会自己更新；默认刷新预算是 15 分钟，绑定数据源各自按自己的节奏缓存——天气一小时，正在播放的音乐一分钟。

它更受限的地方，诚实地说：

• 需要 iOS 18.0 或更高版本，iPhone 或 iPad 均可。
• 除了走网络的数据，组件完全在本地运行，组件本身从不要求连接；但天气、你自己的 HTTP API 和 AI 生成需要。
• Apple Health 的访问是只读的，所以健康类组件显示的是系统已经知道的事。
• 自定义组件是你自己的设计，所以 iOS 那套「一眼可读」的规则不适用。一个在预览里读得清楚的设计，放在花哨的壁纸上可能就难读了。预览是最好的检查手段，但不是保证。

你现在可以做的决定

如果你想今天就在屏幕上放一个好看又能用的组件：挑一个模版，改一个颜色和一个数据源，保存——这是从打开 App 到真的用一个组件之间最短的路。如果你要的是实时内容而不是静态内容，那就在设计之前先看清会用哪些数据源、每个要什么权限，因为这部分之后改不了。如果你只要实时数据、完全不要设计，捷径依然更轻。

如果你想要全部——所有预设、每种尺寸不限数量、以及社区里的设计——Pro 才是它不再只是「做一个组件试试」的那一层。 在 App Store 下载 WidgetCraft，或先读读模版库和编辑器是怎么配合的。