---
title: 使用统计与隐私
description: Teloa 默认参与全球使用统计：会发送什么（含市场资源安装）、不发送什么、发到哪里，以及部署环境如何排除。
lastVerified: 2026-10-01
---

# 7.4 使用统计与隐私

Teloa 默认参与全球使用统计，结果公开在[全球使用情况](https://www.teloa.ai/stats/)页面。**正式安装（npm 安装、容器部署）默认开启、默认上报，应用内没有设置页，也没有关闭开关**。

::: info 适用版本
这一行为已包含在已发布的 `0.2.0-alpha.7` 中；此前的 alpha.6 内部候选不包含。
:::

## 会发送什么

使用统计每个安装每天最多发送一次记录，只包含以下字段（从官方目录添加资源另有记录，见下文「市场资源安装」）：

| 字段 | 说明 |
| --- | --- |
| 协议版本（`schemaVersion`） | 上报格式的版本号，当前固定为 `1`，不含任何安装或使用信息 |
| 安装标识 | 本机随机生成的持久编号，只用于去重，与账号无关 |
| 事件类型 | 首次参与，或当日有使用 |
| 日期 | 当日有使用时的 UTC 日期 |
| 应用版本号 | 例如 `0.2.0-alpha.7` |
| 版本类型 | 当前为 Free |

安装标识是持久编号，能把同一台机器的多次记录关联在一起，所以它是去标识的，而不是完全匿名。服务端只保存它的带密钥散列，不保存原始编号。

## 不发送什么

不发送姓名、邮箱、账号、会话内容、文件、提示词、任务内容、员工内容或模型配置。唯一的例外是从官方目录添加资源时发送的公开资源 ID（技能、行业方案、AI 员工、连接），见「市场资源安装」。统计与模型调用是两条独立的通道，互不传递标识。

## 发送到哪里

记录发送到 Teloa 自己运营的统计服务 `metrics.teloa.ai`（Cloudflare Worker + D1）。服务端按请求来源推断国家和城市，不保存 IP 地址。国家不代表国籍，使用代理或 VPN 时会按代理出口计算，无法识别的记为「未知」。城市少于 5 个安装时不单独公开，只计入国家总数。汇总结果即[全球使用情况](https://www.teloa.ai/stats/)页面展示的数字。市场资源安装记录不保存国家、城市，也不使用上面的安装标识散列：服务端用另一把专用密钥按天派生独立的键。因此资源记录与安装记录没有共同字段，无法直接关联；同一安装不同日期的资源记录之间也无法直接关联，但同一安装同一天添加的多个资源共用同一个键。残余风险：持有统计数据库权限的运营方仍可能按两类记录的写入时间推测关联，早期装机量小时更容易；资源明细表不保留插入顺序，以减少这种推测。

## 什么算「有使用」

- 你在对话里发出的消息被 Teloa 接受。
- 一次任务执行被真正启动，包括自动化按计划启动的执行。

打开页面、查看设置、Teloa 空转都不算。同一个安装每个 UTC 日最多计一次。

## 市场资源安装

从 Teloa 官方目录添加资源成功时（技能、行业方案、AI 员工、连接），包括加载官方方案后按目录中的资源创建的 AI 员工，同一安装会再发送一条资源安装记录，用于官方市场和应用市场的「安装量」与「热门」排序。它与上面的统计使用同一个开关和同一套排除规则，没有单独的开关。

| 字段 | 说明 |
| --- | --- |
| 市场资源 ID | 官方目录里的公开资源标识，例如 `teloa.soc` |
| 资源版本 | 添加时的资源版本，例如 `1.0.0` |
| 类型 | 技能、行业方案、AI 员工或连接 |
| 日期 | 添加发生的 UTC 日期（只到日，不含时间） |
| 安装标识 | 与上表是同一个本机随机编号；服务端只用它按天派生一个一次性的键，不保存原值 |
| 应用版本号与版本类型 | 与上表相同，只用于校验，不保存 |

- 只统计官方目录中存在的资源：服务端用官方市场的签名索引核对资源 ID 和类型，不在目录中的一律拒收。
- 同一安装对同一资源，每个 UTC 日最多计一次；隔天再次添加技能或行业方案会再计一次，AI 员工或连接已存在时不会再计。添加请求因网络中断被自动恢复重放时，记录携带原来的日期，不会重复计数；超过两天的补发会被拒收。Teloa 没有单独的上报重试队列，短暂重试仍失败的记录不再补发，只会少计。
- 不发送：资源内容与文件、账号、本机负责人（owner）标识、文件路径、提示词、密钥与授权令牌。从 GitHub 导入的内容、本地草案和私有内容都不发送；方案内部的技能与连接未在目录中单独列出，不单独计数；模型资源不在当前安装统计范围内；即使完成模型下载或准备，也不发送资源安装记录。
- 安装量是按天去重后的添加次数，不是人数，也不代表资源仍在使用。「热门」是近 7 个 UTC 日的安装量。
- 应用读取安装量榜单时，同样只在开关开启时访问 `metrics.teloa.ai`；读取失败时，市场照常按默认顺序显示。

## 数据保留

每日明细保留 35 天，用于计算近 7 日和近 30 日的数字；更早的只保留按国家汇总的每日数量。市场资源安装明细同样保留 35 天，更早的只保留每个资源的累计安装量。

## 哪些启动方式会发送

Teloa 只有在环境变量 `TELOA_USAGE_STATS=on` 时才发送统计，缺省即不发送。以下两种启动方式会替你设置它：

- npm 安装的 `teloa` 命令启动 Teloa 时默认设置 `on`。
- 容器镜像启动 Teloa 时默认设置 `on`。

从源码仓库启动（例如 `pnpm dev:dsh`）、运行测试、持续集成和验收都不设置它，因此不发送。

## 部署环境的排除

应用内没有关闭方式。以下环境即使设置了 `on` 也不发送统计，面向开发、持续集成、验收和企业离线部署，不是面向个人用户的设置：

- 设置了环境变量 `TELOA_USAGE_STATS=off`（在启动 `teloa` 命令或容器前设置，外部值优先于入口的默认值）。
- 持续集成环境（`CI=true`）、验收测试环境（`TELOA_BROWSER_ACCEPTANCE=1`）和开发预览（`NODE_ENV=development`）。

发送在后台进行，网络不通或服务不可用时不会影响你正在做的工作；安装标识文件损坏时暂停统计，不会重新生成新编号。

## 从早期开发版本升级

更早的开发版本曾在「设置 > 使用统计」提供参与开关。升级后该开关及其记录文件不再读取并会被清理，此前选择「未开启」或「关闭」的安装按默认参与处理；本机安装标识与已发送状态保留，不会被重复计数。