隐私说明

页面访问与停留统计

为了解哪些内容有帮助，本站记录访问的页面、访问时间和有效停留时长。页面可见且最近 30 秒内有滚动、点击、按键、鼠标移动或触摸操作时才累计停留，每次页面访问最多计 10 分钟。操作只用于判断是否活跃，不记录键盘输入内容。

页面首次可见时上报，之后每 30 秒在活跃秒数增加时上报；页面隐藏或离开时尝试发送最后一次上报。服务器按同一次访问合并，并校验已流逝时间，单次最多记录 600 秒。发送失败、限流或写入失败可能造成统计缺失。

浏览器里的随机标识

浏览器会在本地存储 localStorage 的 qy_vid 中长期保存一个随机匿名标识，不包含姓名、邮箱等身份资料。服务器只保存该标识经 HMAC 处理后的值，用于区分访客和跨天去重，不保存标识原文。

你可以在浏览器设置中清除本站的网站数据，也可以在开发者工具的本地存储中删除 qy_vid。下次访问会生成新标识。清除本地标识不会自动删除已有统计记录。浏览器存储不可用时，每次页面访问使用临时内存标识，访客数量可能因此偏高。

统计记录包含什么

页面统计保存事件 ID、上海日历日、页面路径与类型、内容集合和标识、首次接收与最近上报时间、有效停留秒数、经 HMAC-SHA256 处理的访客标识，以及内部访问和机器人的判断标记。来源仅保存域名，不保存完整来源网址或查询参数。

页面统计不存 IP 和 User-Agent 原文，也不生成基于 IP 的访客标识。IP 仅临时用于请求限流和内部流量判断；User-Agent 仅用于机器人判断。本站这项统计不使用第三方统计服务。

开放接口调用统计

本站已实现开放接口调用统计，页面和接口采集由站点的统计开关控制。接口统计保存事件 ID、时间与上海日历日、路由模板、HTTP 方法、响应状态码、处理耗时、内容类型和标识、来源分类、Skill/内部访问标记、是否携带有效密钥，以及可选的客户端版本和处理后的客户端标识。不保存请求查询串、请求正文、IP 或 User-Agent 原文、完整 Referer、密钥原文。

客户端标识仅来自格式有效的 X-Qiyuan-Client-Id，或在没有该标识时来自有效 API Key；两者均用 HMAC-SHA256 处理。两者都没有时留空，不用 IP 或 User-Agent 推算。访客和客户端使用不同用途的派生密钥；站点密钥轮换后，新旧统计标识无法直接对应。

已登录后台的管理员和编辑可被标为内部流量，也可按配置的 IP 范围识别；内部自检客户端另有标记。员工未登录且未命中配置范围时可能被当成普通访问。页面机器人和内部流量默认从访问指标排除，内部接口调用默认从接口指标排除；接口机器人仍单列在来源分类中。识别依赖请求信息，不能保证识别所有机器人。Skill 标识来自客户端自报的请求头，可能缺失或被冒用，因此 Skill 调用数只能作为下限。

保存与删除

当前统计记录存入本站 PostgreSQL 数据库，一期没有自动清理任务，也没有为访客提供按标识删除历史统计的自助接口；本说明不承诺尚未实现的固定保留期限。浏览器本地标识的清除方式见上文，清除它不会自动删除服务器历史记录。统计写入失败计数只保存在进程内，重启后归零。

反向代理访问日志

上述字段范围仅指统计数据库。部署使用的 Caddy 访问日志独立于统计库，可能记录连接 IP、请求地址、请求头等请求元数据，不能据统计库不存 IP 推断访问日志也不存。日志的保存与轮转由部署配置和维护者管理，本说明不虚构统一的保留或删除期限。

联系方式

联系邮箱：alllyx886@gmail.com。