Stretchly 是免费的吗？

完全免费。Stretchly 基于 BSD-2-Clause 开源协议，无内购、无广告、无遥测，任何人都可以自由使用与修改。

macOS 提示"未识别开发者"怎么办？

由于 Stretchly 未进行 Apple 代码签名，首次启动会被 Gatekeeper 拦截。Intel 芯片：右键点击应用图标选择"打开"。Apple Silicon：在终端执行 sudo xattr -r -d com.apple.quarantine /Applications/Stretchly.app

如何让 Stretchly 开机自启？

在偏好设置中可启用"开机自启动"选项。Windows 用户也可将快捷方式放入启动文件夹；macOS 用户可在系统设置的用户与群组中添加登录项。

严格模式是什么？

严格模式开启后，休息窗口无法跳过也无法推迟，强制你完成完整休息。适合自控力较弱或健康问题较严重的用户，可在偏好设置中分别对 Mini Break 与 Long Break 启用。

使用指南 - Stretchly 安装 / 配置 / 快捷键 / 命令行 / 高级技巧

步骤 1

安装 Stretchly

选择最适合你系统的安装方式。三种平台都支持包管理器一键安装，也提供原生安装包与便携版。

Windows

推荐使用 winget 一键安装：

winget install -e --id Stretchly.Stretchly

其他方式：

Chocolatey: choco install stretchly
Microsoft Store 在线安装
官网下载 exe 安装包
便携版（免安装）

macOS

推荐使用 Homebrew Cask 安装：

brew install --cask hovancik/stretchly/stretchly

升级与卸载：

升级: brew upgrade --cask hovancik/stretchly/stretchly
卸载: brew uninstall --cask hovancik/stretchly/stretchly
或从 GitHub Releases 下载 DMG

Linux

推荐使用包管理器：

# Flathub
flatpak install flathub net.hovancik.Stretchly

# Snap
sudo snap install stretchly

# apt 仓库
echo "deb [trusted=yes] https://apt.fury.io/hovancik/ /" | sudo tee /etc/apt/sources.list.d/hovancik.list
sudo apt update && sudo apt install stretchly

Linux 用户注意：若 Stretchly 无法启动，可能需要执行 sudo sysctl kernel.unprivileged_userns_clone=1 与 sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0。Wayland 用户如需闲置检测，需将当前用户加入 input 组：sudo gpasswd --add $USER input。

步骤 2

首次启动 Welcome 向导

第一次运行 Stretchly 时会弹出 Welcome 窗口，引导你完成基础配置。整个过程不到 1 分钟。

1

选择语言

从 20+ 种语言中选择，包含简体中文。语言切换即时生效，无需重启。

2

查看偏好设置

可在此快速调整休息节奏，或保持默认（推荐新用户保持默认配置体验一段时间）。

3

查看在线教程

提供 30 秒的快速引导动画，演示休息窗口、跳过与推迟操作。

4

开始使用

点击 Continue 后，Stretchly 会最小化到系统托盘静默运行。下一次 Mini Break 将在 10 分钟后开始。

系统托盘运行

配置完成后，Stretchly 不会显示主窗口，而是常驻系统托盘：

左键点击：查看当前休息状态与剩余时间
右键点击：菜单包含跳过、暂停、偏好设置等
Windows：双击托盘图标直接打开偏好设置
托盘图标样式可切换：默认 / 距下次休息 / 进度

步骤 3

理解一次完整的休息流程

从通知到结束，一次 Mini Break 通常持续 30 秒（10 秒通知 + 20 秒休息），不打断你的工作节奏。

1

提前通知（10 / 30 秒前）

Mini Break 开始前 10 秒、Long Break 开始前 30 秒会弹出系统通知，给你时间保存思路、暂停视频、交接对话。通知可关闭。

2

休息窗口弹出

到点后，Stretchly 会全屏（或多屏）覆盖展示休息窗口，包含一条休息建议（如"远眺 20 秒"）和倒计时进度条。窗口可设置为透明或全屏模式。

3

推迟或跳过

休息开始后可推迟一次（Mini Break 默认 2 分钟，Long Break 默认 5 分钟）。休息进度过半后可跳过。两者都可通过窗口底部链接或 Ctrl/Cmd + X 快捷键操作。

4

自动恢复工作

休息结束后，休息窗口自动消失，你回到之前的工作界面。下一次 Mini Break 计时重新开始（10 分钟后）。

步骤 4

偏好设置详解

点击系统托盘 Stretchly 图标，选择 Preferences 打开偏好设置。Windows 下也可双击托盘图标直接打开。

节奏与时长

调整 Mini Break 与 Long Break 的持续时间、触发间隔。Mini Break 间隔以毫秒为单位（默认 600000 = 10 分钟），Long Break 间隔以 Mini Break 次数为单位（默认 2 次）。

外观与主题

分别为 Mini Break 与 Long Break 设置独立的颜色主题。可开启透明模式，让休息窗口半透明，便于瞥见底层内容。自动跟随系统深色模式。

声音

为 Mini Break 与 Long Break 分别设置开始提示音。可选水晶玻璃、风铃、滴答、梦境、静默 5 种主题。可全局静音。

严格模式

分别对 Mini Break 与 Long Break 启用严格模式。开启后休息窗口无法跳过也无法推迟，强制完成完整休息。适合自控力较弱或健康问题较严重的用户。

自然休息与闲置

开启闲置检测后，离开电脑 5 分钟（可配置）自动暂停休息循环。自然休息模式下，主动起身活动达到一定时长会计入循环并重置计时。

勿扰与多屏

联动系统勿扰模式自动暂停。可选择在所有显示器上同时显示休息窗口（多屏覆盖），或仅在主屏显示。可启用开机自启动。

步骤 5

快捷键速查表

熟练使用快捷键，让 Stretchly 完全不打断你的工作节奏。

快捷键	功能	可用场景
`Ctrl/Cmd + X`	跳过 / 推迟当前休息	休息窗口显示时
`Ctrl/Cmd + D`	显示调试信息与偏好文件路径	偏好设置 -> About 页
托盘双击	打开偏好设置	Windows 系统
托盘左键	查看状态与剩余时间	所有平台
托盘右键	打开菜单（跳过/暂停/偏好等）	所有平台

步骤 6

命令行控制

当 Stretchly 实例运行时，可在终端通过 stretchly 命令与之交互。Windows 安装版会自动加入 PATH。

常用命令终端

# 查看所有命令与示例
stretchly help

# 立即触发一次 Mini Break
stretchly mini

# 立即触发一次 Long Break
stretchly break

# 暂停休息循环（保持当前状态）
stretchly pause

# 恢复休息循环
stretchly resume

# 切换休息循环开关
stretchly toggle

提示：命令行控制非常适合集成到自动化脚本、tmux 状态栏、Alfred / Raycast 工作流中，让 Stretchly 与你的开发环境深度融合。

步骤 7

高级 JSON 配置

应用内偏好设置覆盖了大部分需求。一些更精细的选项需直接编辑 JSON 偏好文件。打开方式：偏好设置 -> About -> 按 Ctrl/Cmd + D 显示调试信息。

高级配置示例preferences.json

{
  // 自然休息：闲置多久后暂停
  "naturalBreaksInactivityResetTime": 300000,

  // 自然休息检测间隔（毫秒）
  // 数值越大 CPU 占用越低
  "naturalBreaksCheckInterval": 2000,

  // 暂停至日出（需配置经纬度）
  "morningHour": "sunrise",
  "posLatitude": 31.23,
  "posLongitude": 121.47,

  // 推迟次数与时长
  "microbreakPostpone": true,
  "microbreakPostponeTime": 120000,
  "microbreakPostponesLimit": 1,

  // 休息开始提示音
  "miniBreakStartSound": "crystal-glass",
  "longBreakStartSound": "reverie",

  // 关闭新版本通知
  "notifyNewVersion": false
}

编辑注意事项

编辑前请先完全退出 Stretchly，避免文件被覆盖
使用 JSON 格式校验工具（如 jsonformatter）确保格式正确
修改后某些 UI 显示值可能与实际不符（界面预期特定值）
标记为"Contributor Preferences"的选项面向贡献者，普通用户慎用
标记为"Not Reliable"的选项可能不稳定，需自行承担风险
"Restore defaults"按钮可恢复默认配置

历史名称：1.0 之前 Mini Break 叫 Microbreak，Long Break 叫 Break。为平滑升级，偏好文件中仍保留旧名 microbreak 与 break。

步骤 8

自定义休息建议

默认休息建议覆盖眼部、颈椎、呼吸、喝水等通用场景。你也可以完全自定义，让每一条文案都贴近自己的真实需求。

操作步骤

1

开启自定义模式

在偏好文件中将 useIdeasFromSettings 改为 true。

2

编辑休息建议数组

修改 breakIdeas（长休息）与 microbreakIdeas（微休息）数组。每个条目包含 data（字符串数组）与 enabled 字段。

3

使用 HTML 增强

支持 <b>、<i>、<br>、<p>、<h1-3>、<a>、<img> 标签，HTML 会被沙箱清理。

4

使用本地图片

将图片放入用户数据目录的 images/ 文件夹，通过 <img src="filename.png"> 引用。支持 PNG、JPEG、WebP、GIF。

自定义休息建议完整示例preferences.json

"useIdeasFromSettings": true,
"breakIdeas": [
  {
    "data": [
      "<b>站起来走动</b>",
      "在办公室或家中走 2 分钟，让血液循环重新启动。"
    ],
    "enabled": true
  },
  {
    "data": [
      "<b>颈椎舒展</b>",
      "缓慢将头倾向左侧 10 秒，再换右侧。",
      "<img src=\"neck-stretch.png\" width=\"200\">"
    ],
    "enabled": true
  }
],
"microbreakIdeas": [
  {
    "data": [
      "<b>20-20-20</b>",
      "望向 20 英尺(6 米)外的物体 20 秒。"
    ],
    "enabled": true
  }
]

步骤 9

macOS 签名绕过指南

由于 Apple 代码签名费用较高且作者没有支持的 Apple 设备，Stretchly 未进行签名。首次启动需手动绕过 Gatekeeper。

Intel 芯片 Mac

使用 Finder 进入"应用程序"文件夹，按住 Control 键点击 Stretchly 图标（或右键），从弹出的快捷菜单中选择"打开"。在弹出的对话框中再次点击"打开"即可。

参考 Apple 官方指南：打开未识别开发者的 Mac 应用

Apple Silicon Mac

Apple Silicon 芯片的 Mac 需通过终端移除隔离属性。打开终端（Terminal），执行以下命令：

sudo xattr -r -d com.apple.quarantine /Applications/Stretchly.app

执行后会提示输入登录密码（输入时不显示字符，正常输入后回车即可）。

不确定芯片类型？点击左上角苹果菜单 -> "关于本机"，在"芯片"一栏查看。或参考 Apple 官方说明。

步骤 10

常见问题

使用过程中遇到的最常见问题与解决方案。

完全免费，永远免费。Stretchly 基于 BSD-2-Clause 开源协议，无内购、无广告、无遥测、无付费墙。任何人都可以自由使用、修改、分发。如果你希望支持作者，可通过 GitHub Sponsors 或 Patreon 进行赞助，但赞助完全自愿，不影响功能使用。

在偏好设置中可启用"开机自启动"选项。Windows 用户也可将快捷方式放入启动文件夹（按 Win+R 输入 shell:startup 打开）；macOS 用户可在系统设置 -> 用户与群组 -> 登录项中添加 Stretchly。

严格模式开启后，休息窗口无法跳过也无法推迟，强制完成完整休息。适合自控力较弱、或健康问题较严重（已有颈椎病、严重视疲劳等）的用户。普通用户建议先关闭严格模式体验一段时间，根据需要再开启。Mini Break 与 Long Break 可分别设置严格模式。

Stretchly 不会主动暂停其他应用。但休息窗口默认全屏覆盖，会遮挡视频画面。如果使用全屏模式看视频，可在偏好设置中关闭"全屏覆盖"，改为透明模式或仅主屏显示，这样休息窗口不会完全遮挡内容。

Linux 上闲置检测依赖 X11 的 Screen Saver 扩展。Wayland 用户需要将当前用户加入 input 组：sudo gpasswd --add $USER input，注销重新登录后生效。部分发行版还需要安装 libxss-dev 包。如果 Stretchly 完全无法启动，可能需要执行 sudo sysctl kernel.unprivileged_userns_clone=1 与 sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0。

Stretchly 默认会检查新版本并通知你。升级方式取决于安装方式：包管理器安装的（winget / brew / choco / flatpak / snap）使用对应命令升级；官网下载的安装包需先退出 Stretchly，再下载新版本覆盖安装。偏好设置会被保留。

从安装到精通，10 分钟掌握 Stretchly

本页目录

安装 Stretchly

Windows

macOS

Linux

首次启动 Welcome 向导

选择语言

查看偏好设置

查看在线教程

开始使用

系统托盘运行

理解一次完整的休息流程

提前通知（10 / 30 秒前）

休息窗口弹出

推迟或跳过

自动恢复工作

偏好设置详解

节奏与时长

外观与主题

声音

严格模式

自然休息与闲置

勿扰与多屏

快捷键速查表

命令行控制

高级 JSON 配置

编辑注意事项

自定义休息建议

操作步骤

开启自定义模式

编辑休息建议数组

使用 HTML 增强

使用本地图片

macOS 签名绕过指南

Intel 芯片 Mac

Apple Silicon Mac

常见问题

准备好开始你的健康工作节奏了吗？