Privacy and Security

🌐 简体中文 · English · 📖 README · 🏠 Wiki 首页

🛡️ 安全与隐私

什么数据会发送给模型

数据	何时发送
玩家的问题与最近几轮对话	每个回合
精简快照：名字、生命、饥饿、模式、维度、位置、朝向、手持物品	每个回合
地点记忆、目标与笔记摘要	每个回合（默认最多 12 个当前世界的地点）
背包、附近生物、配方、服务器资料片段、插件数据	Agent 调用对应工具时
视觉重建图片	Agent 调用 look 且 vision: true 时

所有数据都只发送给服主配置的模型服务商。请在服务器规则或隐私说明中告知玩家。

不会做的事

• ❌ 不读取其他玩家的背包或箱子内容
• ❌ 不保存完整的世界地图
• ❌ 不在历史中保留图片
• ❌ 不执行模型回复中的任何文字命令
• ❌ 不以 OP 或控制台身份执行命令
• ❌ 不解析变量名包含 ip、address、password、token、email、uuid 的 PAPI 变量
• ❌ 不触发区块加载

提示注入防护

• 工具结果、服务器资料、玩家快照在提示词中被明确标注为数据而非指令；
• 改变状态的操作只能通过命令提案，并且需要玩家本人确认；
• 主动回合只能使用只读工具；
• focus_object 只接受最近一次 look 产生的编号，并在服务器端重新核对，不接受模型编造的坐标。

密钥与网络

• 密钥可以只放在环境变量中（PANDAGPT_<服务商>_API_KEY），不写入磁盘；
• Settings.toString() 与所有错误信息都不会包含密钥、请求头或原始响应；
• 接口地址必须是 HTTPS，不能包含 URL 凭据、查询参数或片段；
• HTTP 客户端不跟随跳转；代理账号只会发给配置的代理主机；
• 官方纹理只从 Mojang 官方 HTTPS 主机下载，逐层校验 SHA-1 与大小，绝不加载客户端 JAR 中的类。

日志

• 默认只记录 UUID 与事件，不记录对话内容；
• panda.logging.conversations: true 才会记录原始问题与回答；
• 日志采用 UTF-8 并按大小轮转。

本地文件

路径	内容
memory/<UUID>.json	地点、目标、笔记（原子写入，损坏时不覆盖）
captures/<UUID>/	最近一次视觉采样（save_images: false 可关闭）
logs/	事件日志

这些文件都不会通过 HTTP 公开。

---

⬅️ 🚀 性能  ·  📚 目录  ·  ❓ 常见问题 ➡️