Repository navigation
Releases: aiyougit/trace
Release list
迹 · Trace v0.3.0 · macOS 开源预览版
迹 · Trace v0.3.0
首个开源预览版本：原生 macOS 数字足迹工具，支持 macOS 13+，兼容 Apple Silicon 与 Intel。
功能
- 220 × 44 点桌面悬浮条：当天鼠标距离与键盘输入次数，拖动、右键操作、轻微透明磨砂。
- 统计面板：今天 / 累计、小时活动、键盘热力图、按键排行。
- 可选中英文词语画像，默认关闭；应用排除、暂停、JSON 导出和数据清理。
- 奶油黄木色「浅色 · 淡木」与「深色 · 夜色」，悬浮条同步适配。
- 主面板不置顶；最小化、关闭或切换应用自动收起为悬浮条；支持 Dock 和菜单栏。
- 无第三方运行依赖，统计只保存在本机，不发起网络请求。
下载与安装
- 推荐：
Trace-0.3.0-universal.pkg，退出旧版后安装到/Applications/Trace.app。 - 免安装器：
Trace-0.3.0-universal.app.zip，解压后将 Trace.app 拖到「应用程序」。 SHA256SUMS.txt：使用shasum -a 256 -c SHA256SUMS.txt校验同目录的两个下载文件。- GitHub 自动附带的 Source code 为源码，不是可直接运行的安装包。
授权与已知限制
基础统计需要「输入监控」，词语画像另外需要「辅助功能」。请授权固定路径 /Applications/Trace.app，然后重启应用。
当前应用为 ad-hoc 临时签名，PKG 未进行 Developer ID 签名和 Apple 公证。 macOS 可能阻止打开，请核对来源与校验和，并按系统提供的官方入口决定是否允许，也可自行编译。无需关闭 Gatekeeper 或系统完整性保护。
重新编译后，macOS 可能不再认可旧权限开关；移除旧条目、重新添加应用并开启后重启即可，不需要删除统计。
鼠标距离为屏幕光标路径估算；词语画像依赖受支持应用的辅助功能文本，无法保证完整、精确归因。数据仅按天汇总保存，不记录原始段落或按键时间线。
完整中文介绍、演示截图、使用指南和构建步骤见仓库 README。
迹 · Trace for Windows 0.1.2 · 最小化 / 关闭到托盘
迹 · Trace for Windows 0.1.2
最小化 / 关闭改为隐藏到托盘
- 点击统计面板右上角的「—」或「×」（包括 Alt+F4）：面板和悬浮条一起隐藏到右下角系统托盘，任务栏按钮消失，后台统计继续。
- 左键双击托盘图标恢复统计面板；右键可展开面板、显示悬浮条、暂停 / 继续统计。
- 应用内的 「退出 Trace」统一放在托盘右键菜单，悬浮条菜单不再提供退出选项。
- 切换其他应用时仍按原有逻辑收起为悬浮条；手动切换悬浮模式也保留。
- 防止已经排队的失焦回调在隐藏到托盘后重新弹出悬浮条，恢复后重新显示正常任务栏入口。
Windows 可能将图标放在右下角「显示隐藏的图标」（向上箭头）区域；找不到时先展开该区域。
下载与更新
- Intel / AMD 电脑、Windows Server 2019：
Trace-0.1.2-windows-x64-setup.exe。 - ARM64 电脑：
Trace-0.1.2-windows-arm64-setup.exe。 - 也提供对应架构的便携 ZIP 和 SHA-256 清单。
更新前可先从旧版托盘右键菜单退出 Trace，再运行新安装包覆盖安装。安装器自带 .NET 运行时，更新不主动删除本地统计。
保留 Windows 10 1809（17763）及以上 / Windows 11 / Windows Server 2019 及以上桌面体验版的兼容目标。Server 2019 使用 x64；不支持 Server Core / Nano 或跨用户会话统计。程序及安装器未进行商业代码签名。
验证范围
云端检查覆盖系统版本基线、17 项核心逻辑、两套主题渲染、原生接口、重复最小化 / 关闭到托盘、窗口恢复、悬浮条隐藏、退出菜单位置以及 x64 安装 / 卸载。检查使用独立临时数据，不读取真实用户统计。Server 2019 和 ARM64 的实际运行仍需对应设备验证。
迹 · Trace for Windows 0.1.1 · Server 2019 兼容性修复
迹 · Trace for Windows 0.1.1
修复 Windows Server 2019 / Windows 10 1809 的系统版本兼容性检查。
修复内容
0.1.0 安装器将最低内部版本限制为 19045，应用 SDK 目标为 19041，因此会拒绝 Server 2019 的 17763 系统。0.1.1 将应用 SDK 目标和安装器基线统一到 10.0.17763（1809），不只修改安装器的放行条件。
最低系统版本与应用版本集中在 windows/Compatibility.props，增加针对 17763.3532 的配置回归检查，防止两者再次不一致。
下载
- Windows Server 2019 / Intel / AMD 电脑：
Trace-0.1.1-windows-x64-setup.exe。 - ARM64 电脑：
Trace-0.1.1-windows-arm64-setup.exe。 - 也提供对应架构的
portable.zip和SHA256SUMS-windows-<架构>.txt。
下载新版运行即可；如果旧版在安装前已经报错，不需要卸载。安装器与便携版自带 .NET 运行时，更新不主动删除本地统计。
支持具有桌面体验的 Windows Server 2019 及以上（x64）、Windows 10 1809 及以上、Windows 11。不支持无桌面的 Server Core / Nano Server，也不采样其他登录用户的会话。
验证范围
云端执行系统版本基线回归、核心逻辑、两套主题渲染、程序启动 / 原生接口 / 窗口切换检查及 x64 安装 / 卸载检查。尚未在内部版本 17763 的 Server 2019 真机上完成运行验证；ARM64 也仍需对应真机验证。
保留原有功能：半透明悬浮条、鼠标距离、键盘次数与热力图、可选本地中英文词语画像、双主题、应用排除及 JSON 导出。
当前程序和安装器未进行商业代码签名。校验下载文件可使用 Get-FileHash <文件名> -Algorithm SHA256，与同架构的 SHA256SUMS 清单对比。请按 Windows 正常流程决定是否运行，无需关闭系统安全保护。
迹 · Trace for Windows 0.1.0 · 首个预览版
Windows Server 2019 / 1809 用户请下载 Windows 0.1.1 修复版。0.1.0 的最低系统版本配置过高，会阻止 17763 系统安装；新版已统一修正应用和安装器的兼容目标。
迹 · Trace for Windows 0.1.0
首个 Windows 预览版本，原生 .NET 10 / WPF 实现，沿用 macOS 版的淡木 / 夜色设计。
下载哪个文件？
| 电脑类型 | 推荐安装包 | 便携版 |
|---|---|---|
| Intel / AMD 64 位电脑 | Trace-0.1.0-windows-x64-setup.exe |
Trace-0.1.0-windows-x64-portable.zip |
| ARM64 / Snapdragon 电脑 | Trace-0.1.0-windows-arm64-setup.exe |
Trace-0.1.0-windows-arm64-portable.zip |
支持 Windows 10 22H2（19045）/ Windows 11，不支持 32 位 Windows。下载并运行 setup.exe，或解压便携 ZIP 后运行 Trace.exe。两者均自带 .NET 运行时，无需另装 .NET。
安装器按当前用户安装到 %LOCALAPPDATA%\Programs\Trace，创建开始菜单入口和卸载项，桌面快捷方式可选。不安装服务、不设置开机启动；更新及卸载不主动删除 %LOCALAPPDATA%\Trace 里的统计。
主要功能
- 220 × 44 DIP 半透明悬浮条，只显示今日鼠标距离和键盘输入次数；拖动移动、双击展开、右键菜单。
- 正常层级的统计面板，只有悬浮条置顶；切换其他应用、最小化或关闭后自动收起，任务栏和托盘均可恢复。
- 今天 / 累计、每小时活动、按键热力图与排行。
- 可选中英文词语画像，默认关闭；UI Automation 观察受支持的编辑输入框，使用程序附带的本地中文词典分词，不依赖 Windows 中文语言包。
- 淡木 / 夜色两套主题，悬浮条同步切换，保留选择。
- 按进程排除、全局暂停、JSON 导出、数据清理及损坏文件保护。
- 本机保存，不联网、不遥测，不保存原始段落、按键顺序、剪贴板或输入时间线。
校验下载
Release 提供两个架构各自的 SHA256SUMS-windows-<架构>.txt。在 PowerShell 计算对应文件的 SHA-256，与清单逐项核对：
Get-FileHash .\Trace-0.1.0-windows-x64-setup.exe -Algorithm SHA256已知限制
- 当前程序及安装器没有商业代码签名，可能显示 SmartScreen / 未知发布者提示。请核对仓库来源和校验和，并按 Windows 正常流程决定是否运行；无需关闭系统安全保护。
- 鼠标距离是屏幕光标路径估算，依赖显示驱动的物理尺寸；不是实体鼠标在桌面上的行程。
- 密码标记与应用兼容性依赖 UI Automation。自定义输入框、浏览器、管理员程序、中文输入法、粘贴及快速编辑可能造成漏记或误归因；敏感内容请暂停或排除应用。
- 本地中文词典按 MIT 许可随程序再分发。未知词可能拆分或被过滤；词频画像不等于完整文本记录。
- Windows CI 已验证核心逻辑、WPF 渲染、原生监听接口初始化与清理、本地分词、应用启动 / 任务栏 / 悬浮模式切换、自带运行时打包，以及 x64 安装 / 卸载。真实鼠标键盘、中文输入法和不同应用的采样表现仍需真机体验；ARM64 已交叉构建，尚未完成 ARM64 真机运行验证。