v0.3.1

0.3.0 已撤回：修复 Windows 升级安装路径与重复桌面快捷方式

新增

• 报告页改成刊物归档：日、周、月报按日期排成一列，点开就能逐页读
  同一期的日报、周报、月报都收在归档里，历史报告不再散落在不同的视图。
• 报告版式改为杂志跨页，标题、图表与旁批各归其位
  日报新增「一天的起伏」「时间去向」等分区，数据被写成能顺着读下去的正文。
• 升级到新版本后会自动弹出这一版的更新日志，后台准备好新版本时也会提示
  弹窗只在你真正装上这一版后出现，不会提前打断你正在做的事。
• 设置 → 关于新增 QQ 群入口
  遇到问题或想聊聊用法，可以直接扫码进群。

改进

• 日报的旁批改为跨整行排版，长句不再挤在窄栏里

修复

• 分类页等图标密集页面不再被应用图标拖慢
  图标缓存落盘前会先缩到实际展示所需的尺寸，解码和内存占用都降下来了。
• macOS 上辅助功能授权按钮无响应的问题修复，并按系统版本跳到对应的设置页
• Windows 11 窗口恢复系统原生圆角
• 输入页 2D 键盘不再右偏，横向滚动条也不再常驻
• 3D 键盘键帽顶面印字边缘的白缝修复
• 报告灯箱在 macOS 缩小时排版错乱，已适配触控板原生手势
  缩放与滚动走系统原生行为，触控板和鼠标都跟手。
• Windows 升级安装会回到原来的安装目录，不再在 C 盘另装一份
  0.3.0 更换发行商名称后，安装器找不到旧版记录的安装位置，会退回默认的 C:\Program Files。新版本会先读取旧版留下的安装目录，继续装在原处。
• 桌面不再因为跨目录安装而多出一个 Snoop 快捷方式
  升级沿用原来的安装位置，旧快捷方式继续指向同一个程序，不会新旧各留一个。

其他

• 品牌信息从 Feedra 迁移到 Duskbit，关于页与版权信息同步更新

---

安装说明

• macOS：产物未签名，首次打开需在「系统设置 → 隐私与安全性」里放行。
• Windows：未签名，首次运行会弹 SmartScreen 提示。

注意：雨云 OSS 上的安装包、latest.json 和 changelog.json 需要人工同步。
创建本 Release 不代表客户端自动更新已上线，客户端只读取雨云上的 latest.json。

Snoop v0.2.3

Snoop v0.2.3

键盘立起来了，报告写成了正文。

新增

• 3D 键盘视图回归

  • 这次采用真正的三维模型，同时支持切换回 2D 热力图。
  • 外壳、键帽与布光均按照实体键盘重新设计，包括 CNC 一体铝壳、Cherry 原厂高度的键帽剖面与 PBT 哑光质感。
  • 进入页面时新增从高空俯冲落下的镜头动画。

• 3D 键盘热度柱

  • 敲击次数通过键帽上方的热度柱呈现，柱体高度对应按键使用频率。
  • 相比直接在键帽上显示数字，可以更直观地观察整块键盘的使用分布。
  • 鼠标悬停可查看具体敲击次数。

• 全新 Editorial 风格报告

  • 日报、周报、月报统一采用「正文 + 图表」的 Editorial 排版。
  • 重新组织报告抬头、关键指标、作息曲线、分类占比与应用排行。
  • 从并列的数据面板转向更易阅读的分析简报。

• 自定义键盘配列识别

  • 现在可以根据键帽印字自动推断对应键位。
  • 导入自定义配列后，热力图也能正确映射按键数据。
  • 无法识别的按键仍按 0 次显示，避免错误统计。

• 更新日志弹窗

  • 设置页版本号旁新增更新日志入口。
  • 日志内容支持云端更新，离线时自动使用本地缓存或随包内置内容。
  • 有新版本时，入口会显示提示红点。

改进

• 摘要展开视图重构

  • 新增分类色条、图例，以及不同统计周期对应的专属观察项。

• 应用图标优化

  • 新图标采用 Apple 风格的连续曲率圆角，使其与系统图标更加协调。

• 完善默认忽略名单

  • Windows 和 macOS 均新增锁屏相关系统进程的默认忽略规则。
  • Windows：LogonUI.exe
  • macOS：loginwindow
  • 锁屏相关进程不再计入应用使用时长。
  • 已有用户配置会在启动时自动补全默认忽略项。

修复

• 修复 Windows 10 窗口拖动卡顿

  • 原有磨砂玻璃效果在 Windows 10 上会频繁重新采样桌面，导致窗口拖动明显卡顿。
  • 调整为轻量级模糊实现，在基本保留视觉效果的同时恢复流畅拖动。

• 修复忽略名单下拉浮层位置异常

  • 下拉浮层现在固定显示在输入框下方，并能够跟随页面滚动。
  • 不再遮挡顶部导航栏。

• 修复部分平台图标透明问题

  • 修正部分工具导出 PNG 图标时出现整组透明的问题。
  • 已重新生成全平台应用图标。

其他

• 补充开源许可证、英文版 README 与 llms.txt。
• 新增键帽建模规格文档，为后续 Cherry Profile 形制调整提供依据。

---

发布状态：Pre-release（测试版本）

macOS v0.2.3 暂未完成打包发布，相关改进将在后续构建中提供。

Snoop v0.2.2

Snoop v0.2.2

新功能

分类柜

分类页新增「分类柜」作为默认视图，支持拖拽应用到分类（基于 dnd-kit），右键菜单自动翻转避免出屏，搜索框就地过滤，拖入新建分类框的操作纳入撤销历史。

报告快照

报告现在在生成时固化分类信息快照，此后对分类改名、换色不再回写历史报告，历史数据保持原样。

键盘页布局切换

输入页支持配列切换，新增基于 CSS perspective 的 DOM 3D 框架视图（无 WebGL 依赖）。

节奏板块视图统一

概览页节奏板块的日视图、周视图改为与月视图一致的方格样式，三种粒度视觉风格统一。

修复

• 按键采集改为按下沿计数，消除长按触发自动重复导致的虚假计数
• 重写按键身份体系，统一使用 W3C code 值，未映射按键有兜底处理，并对历史数据做迁移兼容
• 修复顶栏 leading 工具槽 filter 引发的无尽重渲染
• 分类页页头并入顶栏，取色器改为自建实现，控件高度统一
• 修复分类柜拖拽定位偏移、浮层锚定及图标标签显示问题
• 暂时禁用渲染模式切换开关，3D 视图 bug 修复后重新开放

Snoop v0.2.1

Snoop v0.2.1

修复 0.2.0 发布后发现的一批显示问题。

修复

• 概览页 — 修复大数值被截断的问题(月视图下总按键数会丢失末位数字);
  单位不再被挤成竖排;时长写法在整页内统一
• 规律页 — 修复月视图「本月前台时长趋势」的渲染:柱子宽度随容器自适应,
  底部刻度不再挤压图表区域,「无数据」与「零活跃」的日子可区分
• 时间线 — 突变气泡不再溢出窗口边缘,靠近右侧时自动向左弹出,
  文字不再被挤成竖排
• 输入页 — 修复键盘热力图 hover 高亮圈上缘被裁切;
  「本周按得最多」列表补全缺失的键名;修正键鼠比的类型判定

调整

• 侧栏猫的语气与报告统一。以前侧栏是温和陪伴、报告是毒舌吐槽,
  现在是同一只猫——侧栏依然更短更克制,但不再说场面话

---

Snoop 仍处于测试阶段,遇到问题欢迎提 Issue。

Snoop v0.2.0 · 会说话的记录

Snoop v0.2.0 · 会说话的记录

这一版给 Snoop 加上了 AI 能力：自动给应用分类、生成日报周报月报、把报告导出成图分享，
以及侧栏那只猫终于会根据你当下的状态说话了。

所有 AI 功能默认关闭。 不开启的话，Snoop 和以前一样，一个字节都不会离开你的电脑。

Snoop 仍处于测试阶段。 功能和数据格式都可能在后续版本中调整，
遇到任何问题、崩溃或者不合理的地方，欢迎提 Issue 告诉我。

---

主要更新

报告（新增页面）

日报、周报、月报三种尺度回看自己，跟随顶栏的日 / 周 / 月切换。

• 日报 — 这一天的形状：活跃时长、应用排行、分类占比、24 小时节奏、和近 7 天比
• 周报 — 这一周和平时比：七日分布、作息漂移、工作日与周末的差异、新出现和消失的应用
• 月报 — 这个月的趋势：按周走势、上下半月的分类占比变化、weekday × 小时热力
• 导出成图 — 一键生成 1000px 宽的竖版海报，可直接分享
• 报告在每天 / 每周一 / 每月 1 日首次打开应用时后台生成，也可以随时手动生成任意周期

AI 功能（默认关闭）

在「设置 → AI 功能」开启后，侧栏会出现独立的「AI」页。

• 服务 — 兼容 OpenAI v1 的任意服务商，自己填 baseURL / API Key / 模型
• 应用分类 — 11 个类别自动归类，内置常见应用规则表（不用调 AI），
  未命中的攒够一批再问一次，结果可手动修改且永久生效
• 报告叙事 — 报告里那段吐槽由 AI 生成，数字全部由本机算好，模型只负责措辞
• 猫的实时吐槽 — 侧栏那句话改由 AI 生成，每 30 分钟批量生成一批本地取用
• 留意 — 检测使用模式的异常（深夜活跃、强度突增、超长连续），只描述不说教

隐私控制

• 数据层级 — T0 不调用 / T1 只出数字（应用用代号）/ T2 出真实应用名，
  窗口标题是独立开关且默认关闭
• 发送记录 — 每次 AI 调用的完整请求原文都记在本地，可查看、可导出、可清空，
  保留 30 天。包括"因层级不足未发送"的记录
• 单一出口 — 所有 AI 调用经过同一层裁剪，功能声明自己需要什么层级，超出的字段在这一层被剥掉
• API Key 存系统原生加密存储（Windows DPAPI / macOS Keychain），不落明文

概览页重做

• 分类占比 — 换成品牌紫的深浅阶（放弃每类一个色相），零值类别不再占位，
  极小占比合并显示，hover 出详情
• 日 / 周 / 月节奏图 — 统一视觉语言，只用颜色深浅一个通道，
  明确区分「无数据」「零活跃」「未到来」三种状态

---

⚠️ 升级须知：时长口径变了

这一版把两个一直混用的概念分开了：

	含义
前台时长	应用窗口在前台的墙钟时间，与有没有操作无关
活跃时长	有键鼠输入的时间

macOS 首次运行需要在「系统设置 → 隐私与安全性 → 辅助功能」中授权，否则无法记录键鼠输入。

---

已知问题

• 周报的「和前 4 周比」需要足够的历史数据，记录不足时会显示「记录时间还不够」而不是百分比
• 应用图标在少数应用上可能取到运行时而非程序本身（如 Java 应用显示为 OpenJDK）

---

Snoop 还在长身体，用得不顺手就来 提个 Issue 喵。