📱 小组件
在 iOS 或 Android 主屏幕快速查看 ulives 数据，无需打开 App。
使用场景
一键启动专注 — 放置多个专注时长小组件，分别指向「阅读」「工作」「运动」等不同任务，一键进入专注状态。
清单快速切换 — 任务列表小组件直达「日常任务」或「项目任务」，不用在 App 里层层跳转。
重要日期一目了然 — 倒数日和倒数日清单小组件让考试、纪念日、截止日期始终可见，不再遗忘。
每日惊喜灵感 — 随机类小组件（随机已解锁成就、随机待办任务、随机感想、随机背包）每天给你一个新发现——一段被遗忘的文字、一件搁置的任务，或一份意外收获。
连续打卡激励 — 任务连续打卡小组件展示打卡天数，帮你守住不中断的成就感。
数据总览不动手 — 统计概览和热力图小组件让你瞥一眼就知道今天的活跃度或近 7 天的成果趋势。
小组件分类
ulives 提供多种小组件，按功能分为以下几类：
| 分类 | 小组件 | 能看到什么 |
|---|---|---|
| 任务 | 任务列表、任务状态、任务连续打卡、随机待办任务 | 任务清单、完成状态、连续打卡天数、随机待办 |
| 专注 | 快捷入口、专注时长 | 一键启动专注、按周期查看专注统计 |
| 商城与背包 | 商城概览、物品数量、最近物品 | 商城浏览、背包数量、近期获得的物品 |
| 成就 | 成就概览、清单进度、倒数日、倒数日清单、单个成就、即将成就、随机已解锁 | 成就进度、倒计时、多个倒计时一览、随机回顾 |
| 统计 | 统计概览、热力图 | 今日或 7 天统计摘要、活动热力图 |
| 属性 | 属性列表、单个属性、随机属性、属性雷达 | 属性等级、随机快照、雷达图对比 |
| 感想 | 感想提示、随机感想 | 日记灵感提示、随机回顾过去的感想 |
| 其他 | 随机背包 | 随机一件背包物品 |
大部分小组件支持小尺寸，精选类型同时支持中尺寸和大尺寸。
Android 说明：部分在 iOS 上共用同一配置页的小组件，在 Android 上会拆成独立入口（例如「今日统计」与「7 日统计」、商城列表模式、成就计数等）。Android 还提供货币列表和专注摘要小组件。
🖥️ 系统要求
| 功能 | 最低版本 |
|---|---|
| 主屏幕小组件 | iOS 16.0+ |
| 直接在小组件上完成任务 | iOS 17.0+ |
| 专注实时活动（锁屏 / 灵动岛） | iOS 16.1+ |
| 任务实时活动（锁屏） | iOS 17.0+ |
| 控制中心小组件 | iOS 18.0+ |
| 功能 | 要求 |
|---|---|
| 主屏幕小组件 | Android 7.0+（API 24） |
| 在小组件上完成 / 调整任务 | 支持（无额外系统版本要求） |
| 专注实时活动 | 不支持 — Android 上专注使用 App 内浮层 / 通知 |
iOS 小组件扩展面向 iOS 17+ 的配置与交互能力；更旧的 iOS 版本可能受设备限制。
如何添加小组件
iOS
- 在主屏幕长按空白区域，直到图标开始抖动
- 点按「+」按钮（左上角或右上角），搜索 ulives
- 浏览可用的小组件，滑动选择尺寸，点按「添加小组件」并拖到目标位置
- （可选）长按已放置的小组件，点按「编辑小组件」选择要展示的具体数据
也可在 ulives 内打开设置 → 小组件查看引导与预览。
Android
- 从桌面：长按主屏幕 → 小组件 → 找到 ulives → 选择类型与尺寸 → 放置。可配置的类型可能会先打开设置页。
- 从 App 内：打开设置 → 小组件，按分类浏览并点添加（若系统启动器支持，可直接固定到桌面）。
- 后续修改：长按小组件 → 重新配置，或在设置 → 小组件中编辑已添加的实例。
🎬 操作演示 GIF 即将上线
交互与小技巧
大部分小组件是只读的——它们展示数据但不支持编辑。点击小组件会跳转到 App 内的对应页面：
| 小组件 | 点击行为 |
|---|---|
| 任务列表 | 打开 App 中对应的任务清单——可当作清单切换器使用 |
| 专注时长 | 打开专注页面并预选好对应的专注任务，随时开始 |
| 倒数日 / 成就类 | 打开对应的成就详情页 |
| 商城 / 物品数量 | 打开商城或物品详情页 |
| 统计 / 热力图 | 打开统计页面 |
| 属性类 / 雷达 | 打开状态页面 |
任务列表、任务状态和任务连续打卡支持在小组件上直接操作任务：
- iOS 17+：可直接在小组件上完成任务。为避免误操作，撤销完成需进入 App。点击卡片本身可打开任务详情。
- Android：支持在小组件上完成、调整计数和撤销（在对应操作可用时）。
实时活动（仅 iOS）
以下不是主屏幕小组件，而是显示在锁屏（专注还可显示在灵动岛）：
- 专注实时活动 — 专注进行中的实时计时（iOS 16.1+）
- 任务实时活动 — 将任务周期固定到锁屏，可在锁屏完成或调整计数（iOS 17+）
Android 不提供实时活动；专注在 Android 上使用 App 内浮层和通知。
成就倒数日小组件
提供两种倒数日小组件：
- 成就倒数日 — 展示单个成就的剩余天数
- 倒数日清单 — 同时展示一个清单下多个成就的倒计时
- 在 ulives 中进入成就标签页
- 创建一个成就清单，将其显示模式设为「倒数日」
- 向清单添加成就——每个成就的目标日期即为倒数日
添加方式： 按如何添加小组件中对应平台的步骤，搜索想要的倒数日小组件，配置清单和成就即可。
⚠️ 倒数日清单样式需要高级会员，详见下方会员说明。
物品数量小组件
物品数量小组件除了展示库存数量，还支持自定义点击行为：
- 购买模式 — 点击后打开商城页面，可直接购买该物品
- 使用模式 — 点击后打开物品弹窗，可直接使用该物品
编辑小组件时，在配置中选择「点击动作」即可切换模式。适合将常用消耗品（如咖啡、能量药水）固定在主屏幕快速使用。
高级会员
使用小组件需要会员吗？不需要。所有小组件均为免费功能，无需高级会员即可添加和使用。
但部分小组件所涉及的 App 内功能，可能受会员限制。例如：
- 倒数日清单样式需要高级会员才能设置。如果你不是高级会员，可以在 App 中升级后再配置该样式的小组件。
小组件本身始终可添加，限制仅影响 App 内相关功能的创建和编辑。
数据与刷新
在 App 中修改数据后，iOS 和 Android 小组件都会自动更新。随机类小组件也会按各自平台的机制定期刷新，大约每 30–60 分钟展示不同内容。
| iOS | Android | |
|---|---|---|
| App 内操作后 | 通过 WidgetKit 立即刷新时间线 | 通过 Glance 立即更新小组件 |
| 系统后台刷新 | 通常每种小组件 15–60 分钟 | 任务类小组件 OS 定时刷新最低 30 分钟；其余依赖 App 事件与跨日刷新 |
| 日期变更 | 时间线刷新 + App 事件 | 本地午夜前后 scheduled 全量刷新 |
若长时间未打开 App，小组件更新属于尽力而为，不要期望秒级同步。
反馈
有新的小组件想法或遇到问题？欢迎告诉我们：
- 📋 反馈表单
- 📧 邮件： fb@ulives.io