Keydance 敲一敲
Mac App Store 下载App Store

KEYDANCE HELP

第一次记录，
三分钟就够。

从授权 Input Monitoring 到看到“今天”的汇总；如果途中卡住，这里也给出可以照着做的排查步骤。

Start recording in three minutes—from Input Monitoring to your Today summary. If anything gets in the way, follow the troubleshooting steps on this page.

3 分钟上手 统计没有变化

01 · QUICK START

3 分钟上手

第一次只做四件事。开机自动记录是可选项，默认不会替你开启。

Your first run has four steps. Starting at login is optional and is never enabled for you automatically.

  1. 01

    打开 / OPEN

    从“应用程序”打开敲一敲

    敲一敲会在屏幕右上角的菜单栏运行。以后再次打开 App，如果它已经在运行，会提示你点击菜单栏图标。

    Open Keydance from Applications. It runs in the menu bar at the top right. If it is already running, reopening the app points you back to that menu-bar icon.

  2. 02

    授权 / ALLOW

    点击“打开输入监控”

    在 macOS 的“隐私与安全性 → 输入监控”中打开“敲一敲”。这项权限用于在本机形成键盘、点击和光标活动汇总；不需要“辅助功能”权限。

    Choose Open Input Monitoring, then enable Keydance under macOS Privacy & Security → Input Monitoring. This permits local keyboard, click, and pointer aggregates. Accessibility permission is not required.

  3. 03

    返回 / RETURN

    回到敲一敲，记录会自动开始

    在非敏感页面做几次普通按键、点击和光标移动，再打开“概览”，确认底部显示“今天”。历史日期不会跟随当前操作变化。

    Return to Keydance; recording starts automatically. Try a few ordinary actions on a non-sensitive page, then open Overview and make sure Today is selected. Past dates do not update with current activity.

  4. 04

    可选 / OPTIONAL

    决定是否开启“开机自动记录”

    在“设置”中自行打开开关。若 macOS 还需要确认，按 App 提示打开“登录项”并允许敲一敲；不打开也不影响你手动启动后记录。

    Turn on Record at Login in Settings only if you want it. If macOS asks for another confirmation, open Login Items from the app and allow Keydance. Leaving it off does not affect recording after a manual launch.

02 · INPUT MONITORING

为什么需要 Input Monitoring？

macOS 把系统范围的输入活动放在这项隐私权限之后。没有它，敲一敲不会记录键盘、点击或光标活动。

macOS protects system-wide input activity behind this privacy permission. Without it, Keydance does not record keyboard, click, or pointer activity.

只监听，不控制其他 App

敲一敲使用 listen-only CGEventTap，只让必要字段短暂进入有界内存，立即变成汇总。生产版本不使用跨 App Accessibility API，也不需要“辅助功能”权限。

Keydance uses a listen-only CGEventTap. Only the fields needed for aggregation briefly enter bounded memory, then become totals. The production app does not use cross-app Accessibility APIs and does not require Accessibility permission.

INPUT MONITORING

用于形成系统范围汇总

键盘逻辑动作、点击与光标活动都需要这项权限。

Required for system-wide logical key actions, clicks, and pointer activity.

ACCESSIBILITY

敲一敲不需要

不要为了使用敲一敲额外打开“辅助功能”。

Do not grant Accessibility just to use Keydance.

SECURE INPUT

安全场景出现时，三类汇总都会暂停

密码框或系统安全场景可能开启 Secure Input。敲一敲检测到它时会暂停键盘、点击和光标聚合；离开该场景后再恢复，不会把缺失时间补成 0。

Password fields and other protected contexts can enable Secure Input. While it is present, Keydance pauses keyboard, click, and pointer aggregates. It resumes after the protected context ends and does not backfill the missing interval as zero.

Secure Input 排查

03 · DATA BOUNDARY

记录什么，绝不记录什么

核心记录、历史、统计和你主动连接的 Agent 汇总，默认只保存在这台 Mac。

Core records, history, statistics, and aggregates from Agents you choose to connect stay on this Mac by default.

本机保存 / KEPT LOCALLY

只保留可回看的汇总

  • 按日与累计的键盘动作、点击和光标投影估算
  • 15 分钟节奏、APM、coverage、键盘与屏幕聚合分布
  • 你主动连接的 Agent 成功编辑与字符更新汇总
  • 语言、主题、显示、权益与其他有界设置

Keydance keeps daily and all-time keyboard, click, and projected-pointer aggregates; 15-minute rhythm, APM, coverage, and aggregate heat distributions; aggregate Agent edit facts from sources you connect; and bounded app preferences.

绝不保存 / NEVER KEPT

不保存内容或逐次轨迹

  • 输入正文、剪贴板、截图
  • 应用、窗口、URL、文件路径
  • raw keyCode 顺序、逐事件时间或顺序、原始坐标轨迹
  • Agent 正文、提示词、回复、工具输入输出、会话、账号或密钥

Keydance never keeps typed text, clipboard contents, screenshots, apps, windows, URLs, file paths, raw keyCode sequences, per-event timing or order, original coordinate trails, Agent text, prompts, replies, tool input or output, conversations, accounts, or keys.

04 · PRO & LEADERBOARD

Pro 与排行榜怎么使用

两者都不会改变核心记录的安全边界。Pro 是权益；排行榜是你主动选择的联网功能。

Neither changes the safety boundary of core recording. Pro is an entitlement; the leaderboard is a network feature you explicitly choose to join.

PRO

先完整体验，再决定是否购买

  1. 首次启动自动开始一次本机 7 天完整体验。不要求先购买，也不会自动扣费。
  2. 打开“设置 → Keydance Pro”。这里显示当前权益、Apple 返回的本地价格，以及年付和一次买断选项。
  3. 两种购买解锁相同的 Pro 功能。年付是自动续期订阅；一次买断不会续期。
  4. 体验结束后，本机记录继续。今日摘要、历史总数据和核心记录仍保留；历史日期、活动趋势与深入统计、更多主题和多 Agent 等由 Pro 解锁。

A one-time, seven-day full-feature trial starts locally on first launch, with no purchase and no automatic charge. Open Settings → Keydance Pro to see your status, Apple-localized prices, the annual plan, and the one-time purchase. Both purchases unlock the same Pro features. After the trial, local recording, Today summary, and all-time totals remain; Pro unlocks historical dates, activity trends and deeper statistics, more themes, and multi-Agent use.

恢复购买
RANKING

一次同意，随时暂停或退出

  1. 打开“设置 → 排行榜”。加入前会显示自动生成的公开显示名、系统地区和上传说明。
  2. 点击“同意并参加”。这才会创建无需账号的匿名参与身份并开始同步合格的日级汇总；不参加就不上传排名数据。
  3. 在排行榜页管理。你可以修改公开显示名与地区、暂停或继续参加，也可以“退出并删除”。
  4. 权益决定参与周期。未获服务端 Pro 的参与者只参加当地今日，但可查看全部榜单；经服务端验证的 Apple Production Pro 可参加今日、本周与总历史。Sandbox／TestFlight 交易不会获得公开榜的本周或总历史范围。

Open Settings → Leaderboard. Before joining, Keydance shows the generated public name, system region, and upload disclosure. Only Agree and Join creates an anonymous, account-free participant and begins eligible daily uploads. You can edit the public name and region, pause or resume, or choose Leave and Delete. Participants without server-confirmed Pro join only their local Today period but can view every board; Apple Production Pro verified by the server can participate in Today, This Week, and All Time. Sandbox and TestFlight transactions do not receive public This Week or All Time scope.

查看上传的 13 个字段

schema 版本、event ID、revision、当地日期、时区、键盘动作、点击、可空的光标屏幕宽度当量、键盘／点击／光标三类 coverage、App 版本和 build。公开 profile 另含可修改的显示名与地区。

Schema version, event ID, revision, local day, time zone, keyboard actions, clicks, nullable pointer-distance screen-width equivalent, three separate coverage values, app version, and app build. The separate public profile contains an editable display name and region.

05 · TROUBLESHOOTING

常见问题，按顺序排查

不要把“清除全部数据”当作排障步骤。本机记录没有 Keydance 云端备份，清除后无法恢复。

Do not use Clear All Data as a troubleshooting step. Keydance has no cloud backup of local records, so cleared data cannot be restored.

01统计没有变化
  1. 在“概览”确认底部是“今天”，不是历史日期。
  2. 打开“设置”，查看顶部记录状态；如果出现“重新开始记录”，点击一次。
  3. 进入“设置 → 输入监控”，确认 macOS 中的敲一敲已开启。
  4. 确认当前没有密码框或其他 Secure Input 场景。
  5. 在非敏感页面做几次普通操作，再返回“今天”查看。

Make sure Overview is showing Today, check the recording status at the top of Settings, and use Restart Recording if offered. Confirm Keydance in Input Monitoring, leave any password or Secure Input context, then try a few ordinary actions on a non-sensitive page and check Today again.

02权限显示失效或刚刚改过
  1. 从“设置 → 输入监控”打开 macOS 对应页面。
  2. 确认当前敲一敲项目已开启，然后回到 App。
  3. 若记录状态仍未恢复，使用“重新开始记录”。
  4. 如果系统列表出现多个同名项目且当前开关仍不生效，不要随意修改其他 App 权限；记录 macOS 与 Keydance 版本后联系支持。

Open the macOS pane from Settings → Input Monitoring, enable the current Keydance entry, then return to the app. Use Restart Recording if the status has not recovered. If macOS shows multiple same-name entries and the current toggle still has no effect, do not change unrelated app permissions; send support your macOS and Keydance versions.

03Secure Input 一直显示暂停
  1. 离开刚才使用的密码框、登录窗口或其他安全输入界面。
  2. 回到敲一敲“设置”查看记录状态。
  3. 如果保护场景已经结束但仍未恢复，点击“重新开始记录”。
  4. 仍反复出现时，记下发生前使用的 App 类型与复现步骤；不要发送密码或当时输入的内容。

Leave the password field, login window, or other protected input context, then check recording status in Keydance Settings. If the protected context is gone but recording has not resumed, choose Restart Recording. If it keeps returning, describe the type of app and the steps—not the password or anything you typed.

04重启 Mac 后没有自动记录
  1. 先从“应用程序”手动打开敲一敲，确认它能在菜单栏运行。
  2. 打开“设置”，确认“开机自动记录”已由你开启。
  3. 如果 App 提示“请允许”，按“打开登录项”进入 macOS 并允许敲一敲。
  4. 回到 App 再次核对开关状态。开机启动与 Input Monitoring 是两项独立设置，两者都要分别成立。

Launch Keydance manually from Applications and confirm it runs in the menu bar. In Settings, make sure you chose Record at Login. If the app says approval is needed, open Login Items from the prompt and allow Keydance in macOS, then return and check the setting again. Starting at login and Input Monitoring are separate controls.

05已购买，但 Pro 没有恢复
  1. 确认 Mac 已联网，并在 App Store 使用购买时的 Apple 账户。
  2. 打开“设置 → Keydance Pro”，点击“恢复购买”。
  3. 按 Apple 窗口完成确认；价格与购买状态都以 Apple 返回为准。
  4. 若显示离线、待确认或恢复未完成，可联网后重新确认或再次恢复。本机记录不会因此删除。
  5. 仍未恢复时，发送 macOS 与 Keydance 版本、页面显示的状态和不含个人信息的截图；不要发送 Apple ID、密码、完整收据或交易材料。

Connect the Mac to the internet and use the Apple account that made the purchase in the App Store. Open Settings → Keydance Pro and choose Restore Purchases, then complete any Apple confirmation. If the status is offline, pending, or incomplete, reconnect and check or restore again; local records are not deleted. If access still does not return, send the displayed status, macOS and Keydance versions, and a redacted screenshot—never your Apple ID, password, full receipt, or transaction material.

06 · CONTACT SUPPORT

仍未解决？
把现象发过来。

点击下方邮箱即可打开邮件 App，收件人会自动填写为 Keydance 支持邮箱。

Use the address below to open your mail app with Keydance Support prefilled.

support@keydance.app

建议包含 / INCLUDE

  1. macOS 版本与 Keydance 版本
  2. 问题属于：启动／权限／记录／Pro／排行榜／Agent／其他
  3. 复现步骤、期望结果与实际结果
  4. 已经尝试过本页哪些步骤
  5. 可选：不含敏感信息的截图，或经你检查后的诊断文件

Include your macOS and Keydance versions, the issue category, steps to reproduce, expected and actual results, checks already tried, and—only if useful—a non-sensitive screenshot or diagnostics file you have reviewed.

不要发送：输入正文、文件路径、提示词、回复、Agent 会话、Apple ID、密码、完整收据或密钥。

使用邮件模板