本篇文章为面向普通用户和健身粉丝的跟练及打卡指南。 如果你是内容创作者，想制作自己的动作脚本，请前往 [Launcher (康护) 编辑器篇]。如果你需要了解底层的语法逻辑，请查阅 [LeaScript 语法规范]。
一、 kDesktop 是什么？
kDesktop 是 LeaScript 生态中的跟练执行引擎。它可以将 Launcher 生成的 .cfg 脚本文件转化为沉浸式的跟练体验，把创作者设定的标准姿态和阈值，精准施加到你的每一次训练中。
一句话概括：kDesktop 是你的“手机姿态私教，长期打卡见证工具，一键生成Vlog”。
二、 下载与设备摆放
下载方式：
- iOS (iPhone/iPad)：在 App Store 中搜索 kDesktop 直接下载安装。
- Android：下载官方提供的 APK 安装包。
设备摆放（核心要求）：
为了保证姿态识别的准确性，跟练时需严格遵守以下物理条件：
- 横屏放置：手机保持横屏状态。
- 垂直地面（核心）：手机屏幕需与地面垂直（像一面墙），不能平躺。
智能实时引导：kDesktop 通过手机内置的加速度计，实时监测手机与地面的俯仰角（Pitch）。屏幕左上角的实时数值（Vlog模式下为一个圆点）会清晰提示你当前的倾斜程度：
绿色：角度 ≥ 87°，处于最安全的垂直状态。
蓝色：角度 < 87°，提示你需要稍微调整（警告）。
红色：角度 < 85°，说明手机太倾斜，识别将不准确（错误）。 - 后置摄像头朝上：手机顶部（靠近后置摄像头一侧）朝上，镜头正对着你的身体。
三、 核心玩法与跟练体验
kDesktop 提供了两种界面模式，分别对应不同的使用场景：
1. 分析模式（默认）
通过屏幕实时显示姿态判断数据和骨架，帮助你理解动作的准确性。画面中会展示姿态点、底部姿态判断面板等元素。
2. Vlog 模式（一键切换）
长按视频区域即可进入 Vlog 模式，这是一种极致纯净的跟练界面，非常适合录制分享视频。在该模式下，你可以：
- 启动手机录屏：长按进入后，自行下拉控制中心启动屏幕录制。
- 自定义叠加元素：在 kDesktop 的“Vlog 设置”中，自由选择显示或隐藏姿态点、计时、进度、历史数据等元素。
- 遮脸保护：如果你不想露出面部，可以勾选“遮脸”选项。
四、 数据看板：见证你的长期坚持
kDesktop 会将你的每次跟练记录保存在本地，形成独立的 healthYYYYMMDD.dat 文件。这些数据构成了你的个人训练档案。
1. 30 天趋势报告
在数据看板中，系统会自动生成近 30 天的趋势长图，直观展示你的训练节奏。你可以查看到：
- 累计打卡天数：坚持了多少天。
- 总做操时长：累计训练时间。
- 做操频次：每天的训练次数。
2. 历史累计
如果你使用某个动作脚本（如俯卧撑）进行长期打卡，kDesktop 会自动累计你的历史数据。例如，累计打卡 7 天，做操 7 次，总共 49 个。系统会从本地 dat 文件中提取最近一次训练数据并累计生成。
3. 毫秒级单帧诊断
向下滑动详细复盘页面，你可以看到每天的详细数据。点击任意柱子，可跳转到当天的第一组动作。针对不满足原因，系统支持毫秒级的火柴人动画回放，精准定位到是“塌腰”还是“撅臀”。
五、 隐私保护：安全底线
kDesktop 的开发遵循最高标准的隐私保护原则：
- 断网可用，本地处理：所有姿态识别与数据分析均在本地设备离线完成，画面绝不传向云端。
- 零云端传输：App Store 信息显示，开发者不会收集任何用户数据。你的身体数据只属于你自己。
- 跨平台数据通用：kDesktop 生成的 dat 文件在各个平台（手机、电脑）是通用的，你可以将文件放到任意设备上查看完整的 30 天记录。
六、 与 Launcher 的关系
如果你不只是想跟练，而是想创建属于自己的动作脚本，你需要使用 Launcher。
- kDesktop 没有创建脚本的功能。
- Launcher 负责制作 .cfg 脚本；kDesktop 负责加载并执行该脚本。