kmpkg 遥测与隐私

kmpkg 会收集遥测数据，用于了解使用过程中出现的问题（如包构建失败）并指导工具改进。 所收集的数据均为匿名信息。有关微软如何保护你的隐私，请参阅 微软隐私声明。

适用范围

我们明确仅收集工具本身调用过程中产生的信息，不会在生成的库中添加任何跟踪信息。使用任何 kmpkg 命令时都会触发遥测数据收集。

如何退出（Opt-out）

kmpkg 遥测功能默认启用。若要退出数据收集，可在重新运行引导脚本时添加以下参数（Windows 和 Linux/OSX 分别对应）：

PS> .\bootstrap-kmpkg.bat -disableMetrics

~/$ ./bootstrap-kmpkg.sh -disableMetrics

你也可以设置 KMPKG_DISABLE_METRICS 环境变量来退出。

告知声明

构建 kmpkg 时，工具会显示类似以下的文本，这是微软向你告知数据收集事宜的方式：

遥测（Telemetry）
---------
kmpkg 会收集使用数据，以帮助我们改善你的使用体验。
微软收集的数据均为匿名信息。
你可以通过以下方式退出遥测：
1. 重新运行引导脚本并添加 -disableMetrics 参数；
2. 在 kmpkg 命令行中添加 --disable-metrics 参数；
3. 设置 `KMPKG_DISABLE_METRICS` 环境变量。

有关 kmpkg 遥测的更多信息，请参阅文档 docs/about/privacy.md

收集的数据内容

遥测功能不会收集个人数据（如用户名或电子邮件地址），不会扫描你的代码，也不会提取项目级数据（如项目名称、代码仓库地址或作者信息）。数据会通过安全方式发送至微软服务器，并受到访问限制。

保护你的隐私对我们至关重要。如果怀疑遥测功能收集了敏感数据，或数据未得到安全、适当的处理，请在 kumose/kmpkg 代码仓库中提交 issue，或发送电子邮件至 kumo.pub@outlook.com 以便我们调查。

我们收集的遥测事件包括：使用的命令行、调用时间、执行时长等。部分命令还会添加额外的计算信息（如待安装的完整库集合）。工具首次使用时会生成一个完全随机的 UUID（通用唯一标识符），并关联到每个事件中。

在任何 kmpkg 命令后添加 --printmetrics 参数，即可查看该命令对应的遥测事件详情。

在源代码中（GitHub 仓库 k/kmpkg-tool 中包含），你可以搜索 track_property()、track_feature()、track_metric() 和 track_buildtime() 函数的调用，查看我们收集的每一项具体数据。

避免无意中泄露信息

kmpkg 贡献者及任何自行构建 kmpkg 版本的用户，需注意源代码的存储路径。若使用 kmpkg 时发生崩溃，构建机器上的文件路径会作为堆栈跟踪的一部分被收集，且不会进行哈希处理。 因此，kmpkg 的构建目录路径不应包含个人信息或敏感信息。