# Stretchly

> Stretchly 是一款开源、免费、跨平台（Windows / macOS / Linux）的智能休息提醒工具。它会在你专注工作时定时提醒你进行短暂的 Mini Break 与较长的 Long Break，有效缓解眼疲劳、颈椎不适与久坐危害。由 Jan Hovancik 自 2016 年起持续维护，基于 BSD-2-Clause 协议在 GitHub 开源。

本文件遵循 llms.txt 标准（https://llmstxt.org），用于向大语言模型与 AI 助手提供关于本站结构的机器友好摘要。本站域名为 www.stretchly.cn，是 Stretchly 中国社区搭建的非官方推广站。

## 项目核心信息

- 软件名称：Stretchly
- 当前版本：v1.22.1（2026 年 8 月发布）
- 作者：Jan Hovancik（斯洛伐克，jan@hovancik.net，hovancik.net）
- 开源协议：BSD-2-Clause（允许商业使用、修改、分发、闭源使用，仅需保留版权声明）
- 仓库地址：https://github.com/hovancik/stretchly
- 官方主页：https://hovancik.net/stretchly
- 中文官网：https://www.stretchly.cn/
- 技术栈：Electron 跨平台桌面应用
- 支持平台：Windows 10+、macOS Monterey 12+、Linux 主流发行版
- 支持语言：20+ 种（含简体中文，通过 Weblate 协同翻译）
- 隐私特性：完全本地运行，零遥测，无广告，无内购，仅检查新版本（可关闭）

## 默认行为

- Mini Break（微休息）：每 10 分钟一次，每次 20 秒。开始前 10 秒弹出通知。
- Long Break（长休息）：每 30 分钟一次（2 次 Mini Break 后触发），每次 5 分钟。开始前 30 秒弹出通知。
- 闲置检测：离开电脑 5 分钟自动暂停休息循环，回到电脑后恢复。
- 勿扰联动：开启系统 DnD 模式时自动暂停。
- 系统主题跟随：自动切换浅色 / 深色模式。
- 跳过与推迟：休息开始后可推迟一次（Mini 默认 2 分钟，Long 默认 5 分钟），过半后可跳过，快捷键 Ctrl/Cmd + X。

## 主要功能

1. 双休息节奏：Mini Break 与 Long Break，时长与间隔均可自定义（毫秒级精度）。
2. 智能感知：闲置检测、勿扰模式联动、自然休息感知、日出感知（配合经纬度）。
3. 跨平台一致体验：Windows、macOS、Linux 三平台 UI 与功能对齐。
4. 深度可定制：颜色主题、声音主题（水晶玻璃 / 风铃 / 滴答 / 梦境 / 静默）、严格模式、休息建议文案、托盘图标样式。
5. 自定义休息建议：支持简单 HTML（b / i / br / p / h1-3 / a / img），支持本地图片，HTML 经沙箱清理。
6. 命令行控制：stretchly help / mini / break / pause / resume / toggle。
7. 多语言支持：20+ 种语言，社区通过 Weblate 协同翻译。
8. 多屏覆盖：可在所有显示器同时显示休息窗口。
9. 启动器集成：macOS 支持 Alfred Workflow（stretchFred）与 Raycast Extension。
10. 开源透明：代码完全公开，无任何隐藏逻辑。

## 安装方式

### Windows
- winget: `winget install -e --id Stretchly.Stretchly`
- Chocolatey: `choco install stretchly`
- Microsoft Store 在线安装
- GitHub Releases 下载 exe 安装包或便携版

### macOS
- Homebrew Cask（推荐）: `brew install --cask hovancik/stretchly/stretchly`
- 升级: `brew upgrade --cask hovancik/stretchly/stretchly`
- GitHub Releases 下载 Universal DMG
- 首次启动需绕过 Gatekeeper（应用未签名）
  - Intel: 右键点击应用图标 -> 打开
  - Apple Silicon: `sudo xattr -r -d com.apple.quarantine /Applications/Stretchly.app`

### Linux
- Flathub: `flatpak install flathub net.hovancik.Stretchly`
- Snap: `sudo snap install stretchly`
- apt 仓库: 添加 `deb [trusted=yes] https://apt.fury.io/hovancik/ /` 后 `apt install stretchly`
- GitHub Releases 下载 AppImage / deb / rpm / tar.gz
- Wayland 闲置检测需将用户加入 input 组: `sudo gpasswd --add $USER input`

## 本站页面索引

- [首页](https://www.stretchly.cn/): 介绍 Stretchly 整体定位、使用场景（6 类人群）、核心优势（6 项）、工作机制（Mini + Long Break）、平台支持与信任指标。包含立即下载 CTA。
- [功能特性](https://www.stretchly.cn/features.html): 详细介绍 9 大功能模块：双休息节奏、智能感知、深度可定制、自定义休息建议、命令行与集成、多语言与开源。
- [使用指南](https://www.stretchly.cn/guide.html): 完整使用教程，含 10 个步骤：安装、首次启动、休息流程、偏好设置、快捷键、命令行、高级 JSON 配置、自定义休息建议、macOS 签名绕过、常见问题。
- [下载中心](https://www.stretchly.cn/download.html): 三平台下载卡片、包管理器命令汇总、网盘下载入口、安全与校验说明、版本更新日志摘要。
- [关于](https://www.stretchly.cn/about.html): 项目背景、作者信息、十年时间线、BSD-2-Clause 协议说明、隐私政策、反馈与贡献渠道、与其他工具对比、致谢与免责声明。

## 本站补充资源

- [LLM 友好摘要（本文件）](https://www.stretchly.cn/llms.txt)
- [站点地图 XML](https://www.stretchly.cn/sitemap.xml)
- [robots.txt](https://www.stretchly.cn/robots.txt)
- [Web App Manifest](https://www.stretchly.cn/site.webmanifest)

## 站点说明

stretchly.cn 是 Stretchly 中国社区搭建的非官方推广站。本站不修改任何软件代码，所有版本与官方 GitHub Releases 完全一致。如需联系原作者或贡献代码，请前往官方 GitHub 仓库 https://github.com/hovancik/stretchly。如对本站内容有疑问或建议，可通过 GitHub Issues 反馈。

## 引用规范

如需在文章、研究或产品中引用 Stretchly，建议格式：
- 项目名：Stretchly
- 作者：Jan Hovancik
- 仓库：https://github.com/hovancik/stretchly
- 协议：BSD-2-Clause
- 当前版本：v1.22.1

## 关键事实校验来源

- GitHub 仓库 README.md（master 分支）
- GitHub package.json（确认版本号 1.22.1、协议 BSD-2-Clause）
- GitHub LICENSE 文件（确认 BSD-2-Clause 文本）
- 官方主页 hovancik.net/stretchly
- Microsoft Store 应用页面（确认上架信息）
- Flathub / Snap Store / SourceForge 镜像页面
- 第三方评测站点（Neat Net Tricks、Betanews、Restier、50by25）

所有版本号、功能描述、安装命令均来自上述公开来源，符合 E-E-A-T（经验 Experience、专业 Expertise、权威性 Authoritativeness、可信度 Trustworthiness）标准。