企业官网建设流程全解析

KeyStats 是一款同时支持 macOS 和 Windows 的轻量级菜单栏键鼠统计工具，它的多设备同步功能采用端到端加密（E2EE），能把你的 Mac 与 Windows 电脑的每日按键次数、各按键累计次数和鼠标点击统计安全地合并成一份完整数据。本文手把手带新手完成整个流程：创建同步组、配对第二台设备、查看同步状态，直到用恢复码紧急找回数据，全程无需任何编程基础。

一、KeyStats 多设备同步能同步什么？

在开始之前，先明确同步范围，避免误解：

✅ 会同步的数据（按天统计）

• 键盘总按键次数
• 每个按键 / 组合键的累计次数
• 鼠标左键、右键、中键、后退键、前进键的点击次数

❌ 不会同步的数据

• 你输入的文字内容或按键顺序
• 鼠标位置、移动距离、滚动距离
• 分应用统计（应用统计仅保留在本机）

简单说：只有"数量"会跨设备合并，"内容"和"位置"永远留在本机。这样即使数据经过云端中转，隐私风险也降到最低。

💡 只有"数量"会跨设备合并，"内容"和"位置"永远留在本机。

二、E2EE 加密是怎么保护你的数据的？

端到端加密（End-to-End Encryption）的通俗解释：数据在离开你的电脑之前就已经被加密，云端只能存到一堆"天书"密文，谁都读不懂。

KeyStats 的具体做法：

1. 创建同步组时，系统在本机生成 128 位随机密钥，并给出一个28 位恢复码
2. 每天的统计快照在本机用 AES-256-GCM 加密后才上传
3. 服务端只保存密文和随机标识符，无法知道你的日期、键位和统计数值
4. 配对新设备时，通过"六位配对码 + 双端安全码核对"确认对方身份，密钥全程不离开受信任的设备

凭证在 macOS 上保存在应用域内，在 Windows 上用 DPAPI（CurrentUser 范围）加密存储，同样不会出现在任何日志或统计上报中。

三、准备工作：两台设备都装好 KeyStats

1. 分别在 Mac 和 Windows 上安装 KeyStats（支持 Homebrew、Scoop 安装或从 Releases 直接下载）
2. macOS 首次运行需授予辅助功能（Accessibility）权限：按提示打开系统设置，在"隐私与安全性 → 辅助功能"中开启 KeyStats
3. Windows 版本无需任何权限设置，启动即开始统计（首次运行如出现安全提示，点"仍要运行"即可）

确认两台设备的菜单栏（或系统托盘）都能看到 KeyStats 图标后，就可以开始配置同步了。

四、第一步：创建同步组，务必保存恢复码 🔑

入口：

• macOS：点击菜单栏 KeyStats 图标 → 设置 →「设备同步」分区 → 点「管理…」
• Windows：设置页 →「设备同步」卡片 → 点「打开」

操作步骤：

1. 在第一台设备（例如 Mac）上点「创建同步组」；Windows 上对应「创建资料库」
2. 弹窗会显示一个28 位恢复码，点击可一键复制到剪贴板
3. 请立即把恢复码离线保存（密码管理器、笔记本都可以）——如果所有已配对设备全部丢失，这是恢复同步组的唯一方式，KeyStats 和云端都无法替你找回
4. 确认后，第一台设备会把本地历史统计（加密后）首次上传

⚠️ 恢复码是最高敏感信息：拿到恢复码的人就能恢复整个资料库。请离线保存，不要发给任何人，也不要贴到聊天工具里。

五、第二步：配对第二台设备（六位配对码 + 安全码核对）

以"Mac 已建好同步组，新增 Windows"为例：

1. 在 Windows 的「设备同步」窗口点「生成验证码」，得到一个六位配对码
2. 切到 Mac 的设备同步窗口，在「配对码」输入框填入这六个数字，点「确认配对码」
3. 两台设备都会弹出「核对安全码」对话框 —— 请确认两边显示的安全码完全相同，再分别在两端点「安全码一致」
4. 审批通过后，在新设备上完成配对，两台设备随即开始互相同步加密的历史数据

反过来"Windows 已有同步组、新增 Mac"也一样：在 Mac 上点「配对本设备」生成六位码 → 在 Windows 上填入并「批准」→ 双端核对安全码 → 在 Mac 上点「检查授权」完成配对。

核对安全码是防中间人攻击的关键一步：只有两台设备都确认了同一个安全码，旧设备才会释放加密资料，密钥不会被第三方窃取。

六、第三步：确认同步状态（看懂四种颜色）

配对完成后，设备同步窗口的状态栏会用颜色提示当前进度：

同时，设备列表会列出已配对的设备（本机标注"本机"），此时历史记录、累计统计、按键历史和热力图等汇总视图中，就会包含来自多台设备的合并数据了。🎉

七、自动同步机制：多久同步一次？

配对后完全不用手动操心，KeyStats 会按以下节奏自动工作：

• 只有一台设备时不发起任何普通同步（界面会显示"只有一台设备，无需同步"）
• 每个本地日历日首次启动时，如果当天还没成功同步过，会优先尽快同步
• 上次成功同步8 小时后安排下一次自动同步
• 同步失败后按 1 小时、6 小时间隔重试，每天最多重试 3 次
• 手动「立即同步」在上次成功 1 小时后可用；每台设备每天最多 8 次成功同步

如果到期时应用在后台或未运行，会在下次启动或唤醒后尽快补同步。服务故障也永远不会影响本机的统计记录和日常使用。

八、设备管理：移除、退出与紧急恢复

设备同步窗口底部提供了几项管理操作：

• 撤销 / 移除某台设备：该设备无法再同步，但它已同步的历史贡献会保留在汇总中
• 退出同步：仅撤销本机的云端凭证，本机统计不受影响
• 删除全部云端数据：彻底删除所有云端密文（本机统计仍然保留），这是唯一能清除云端数据的操作

紧急恢复场景：换电脑、重装系统、旧设备全部丢失？

1. 在新设备打开设备同步窗口，点「恢复」（Recover）
2. 输入 28 位恢复码即可重新加入同步组，云端历史完整保留
3. 若同步组已有 5 台设备（上限），系统会列出可选的旧设备身份供你接管——其云端历史保留，旧凭证立即失效

📌 同步组最多 5 台活跃设备。凭证只在本机派生，恢复码本身不会发送给服务端。

九、常见问题速查（FAQ）

Q1：状态显示"同步服务尚未配置"？说明当前安装版本没有写入生产同步服务地址，本地统计不受任何影响，后续版本更新后会生效。

Q2：提示"需要重新配对"（红色状态）？本地统计仍然安全。用恢复码恢复本设备，或重新走一遍配对流程即可。

Q3：macOS 重装/升级后停止统计了？应用未签名时，macOS 不会自动延续辅助功能授权。请在"隐私与安全性 → 辅助功能"中删除旧条目，回应用点"获取权限"重新授权。

Q4：配对码报错"已过期"？配对码有时效（约 10 分钟），过期后点重新生成即可。

Q5：恢复码提示无效？确认是完整的 28 位（输入时可带连字符/空格），注意恢复码区分大小写规则以 Crockford Base32 为准，容易混淆的字符（O/0、I/L/1）建议对照原始截图逐位核对。

Q6：开启同步后还能导入旧数据吗？同步组配置期间，传统的遗留导入功能会被禁用，以避免与云端分片混淆；导出仍是纯本地操作，不受影响。

十、延伸阅读：想看实现细节？

对同步协议和加密实现感兴趣的读者，可以看看仓库里的这些资料：

• 同步功能设计文档：docs/superpowers/specs/2026-07-13-e2ee-sync-design.md
• 同步协议 v1 契约说明（macOS、Windows 与服务端共用的"事实标准"）：contracts/sync/v1/README.md
• macOS 设备同步窗口实现：KeyStats/Sync/SyncSettingsWindowController.swift
• macOS 同步协调器（调度、重试、状态机）：KeyStats/Sync/SyncCoordinator.swift
• Windows 设备同步窗口界面：KeyStats.Windows/KeyStats/Views/SyncSettingsWindow.xaml
• Windows 同步协调器：KeyStats.Windows/KeyStats/Services/SyncCoordinator.cs
• 界面文案与状态说明原文（中文）：KeyStats/zh-Hans.lproj/Localizable.strings
• 云端同步服务（Cloudflare Worker）：services/sync-worker/

至此，你的 Mac 与 Windows 键鼠统计就已经在 E2EE 加密保护下合二为一了。日常完全无需干预，只要记住一件事：把那个 28 位恢复码好好藏起来——它是你所有跨设备统计数据的最终保险。🔒