FancyHelper 数据处理说明

本说明列出插件运行时涉及的数据收集和网络通信。

出站网络通信

插件在运行过程中会与以下外部服务通信。

1. AI 对话服务（核心功能，无法关闭）

插件的主要功能依赖 AI 服务。启用后，用户的对话消息和对话历史会被发送给 AI 提供商。

发送内容： 系统提示词、用户消息、AI 回复历史、模型名称、参数设置（max_tokens 等）

默认使用： Cloudflare Workers AI
备选： 可在配置中切换为 OpenAI 兼容服务（如 DeepSeek、通义千问、Kimi 等）

如果你配置了 cloudflare.proxy_url（默认已配置），所有 AI 请求会先经过代理服务器转发。

2. 网络搜索 API（可选，默认开启）

为 AI 提供实时搜索能力，用于查找插件文档或网络信息。

Tavily 搜索： 发送搜索查询到 api.tavily.com（或配置的代理地址 tavilyproxy.baicaizhale.top）
Metaso 搜索： 发送搜索查询到 metaso.cn

可分别通过 tavily.enabled 和 metaso.enabled 关闭。

3. 错误自动上报（可选，默认开启）

插件崩溃或出现异常时，自动将诊断信息发送给开发者，用于排查问题。

发送内容：

错误堆栈信息
服务器最近约 200 条控制台日志（会自动屏蔽 API Key 和 IP 地址后半段）
最近的 AI 对话记录（按当前在线使用人数收集）
插件的 config.yml（API Key 会被自动屏蔽）
插件版本、Java 版本

接收地址： report-fancy.baicaizhale.top

控制台日志中可能包含玩家聊天内容或玩家名称，上报前会尝试脱敏处理。
建议在敏感环境关闭此功能：settings.auto_report: false

4. 版本更新检查（可选，默认开启）

插件启动时会检查是否有新版本。

发送内容： 当前插件版本号
请求地址： api.github.com/repos/baicaizhale/FancyHelper/releases/latest，失败时回退到 fancy-version.baicaizhale.top

可通过 settings.check_update: false 关闭。

5. 自动更新（可选，默认开启）

检测到新版本后，自动从以下地址下载 JAR 文件：

fancy.baicaizhale.top/latest（CDN）
github.com/baicaizhale/FancyHelper/releases（GitHub 发布页）
ghproxy.vip（GitHub 国内镜像）

仅下载文件，不上传任何数据。可通过 settings.auto_upgrade: false 关闭。

6. 远程公告（可选，默认开启）

定期拉取插件公告并显示给服务器管理员。

发送内容： 纯粹的 GET 请求，不包含任何标识信息
请求地址： fcnotice.baicaizhale.top
轮询间隔： 默认每 5 分钟

可通过 notice.show_on_join: false 关闭。

7. 技能系统更新（始终启用）

启动时从远程同步技能包（插件文档预设）。

请求地址： fancy-skill.baicaizhale.top（同步 manifest 和技能文件），失败时回退到 raw.githubusercontent.com/baicaizhale/FancySkillMarket

仅下载文件，不上传任何数据。技能系统在没有网络时仍可使用本地技能。

8. bStats 统计（始终启用）

向 bStats 发送匿名的插件使用统计，这是 Bukkit 插件生态的通用做法。

发送内容： 服务器 Minecraft 版本、插件版本、自定义统计项（对话数量、Token 用量等）
插件 ID： 29036
接收地址： bstats.org

bStats 是 Bukkit 社区标准，大多数插件都使用。如需全局禁用，请在 plugins/bStats/config.yml 中设置 enabled: false。

9. MCP 客户端连接（可选，默认关闭）

如果配置了 MCP 服务，插件会连接到你指定的外部 MCP 服务器。具体发送的数据取决于你配置的 MCP 服务器定义。

默认关闭，需要手动配置 mcp.client.enabled: true 并填写服务器地址。

本地数据存储

以下数据存储在 plugins/FancyHelper/ 目录下，不会自动发送到外部：

路径	内容
`config.yml`	配置文件，包含 API Key 等凭据
`playerdata.yml`	玩家偏好设置（流式开关、工具权限等）
`logs/`	AI 对话日志（系统提示、请求和回复内容）
`skills/`	技能包文件
`temp/`	临时文件，用完自动清理

本地数据由服务器管理员自行管理，可直接查看或删除。

第三方服务

使用 OpenAI 兼容模式时，你的数据会直接发送给相应服务商，由他们的隐私政策管辖。

服务商	相关文档
Cloudflare Workers AI	https://www.cloudflare.com/privacypolicy/
Tavily	https://tavily.com/privacy
bStats	https://bstats.org/privacy-policy
DeepSeek / 通义千问 / Kimi 等	各平台官网

你可以做的

关闭非必要功能： 在 config.yml 中修改对应开关
清除本地记录： 删除 plugins/FancyHelper/logs/ 目录
停止使用： 卸载插件即可