Token Forest 隐私声明
版本 1.0-beta(发布前草案) · 最后更新 2026-07-08 · 首个公开版本发布时生效
发布者:Poietic Studio
本页为英文版《隐私声明》的中文翻译,便于阅读。如中英文之间存在任何歧义,以英文版为准。
Token Forest 是一款把 Claude Code / OpenAI Codex 用量变成像素树成长的桌面应用。本声明说明应用会读取什么、保存什么,以及——仅在你主动开启后——上传什么。同一文本以 PRIVACY.md 发布于公开产品仓库,其 git 历史即本声明的公开变更记录。
摘要
- ✦核心功能完全在你的设备上运行:无需账号、无需 API key、无需网络。
- ✦应用没有遥测、广告、崩溃上报,也没有自动更新的后台请求。
- ✦它读取的是 AI 编程工具已经写在你本机的使用日志——从不读取你的源代码文件。
- ✦不保存、不上传 prompt 或对话内容。
- ✦全球排行榜为可选功能,默认关闭。开启前会弹出同意确认,列出将同步的全部字段;关闭时会请求删除你的记录。
- ✦我们不出售个人数据——默认模式下我们根本收不到任何数据。
应用在本地读取什么
Token Forest 读取受支持工具在本机生成的使用日志:
Claude Code: ~/.claude/projects/**/*.jsonl OpenAI Codex: ~/.codex/sessions/**/rollout-*.jsonl
从日志中使用:四类 token 数量(input / output / cache 读 / cache 写)、时间戳、来源(Claude/Codex)、模型标识、会话标识、项目目录名、Git 分支名、AI 生成的会话标题,以及消息类型结构(仅用于区分真实提问与工具结果)。
解析日志行时,其完整内容(可能包含 prompt 文本)会经过内存。Token Forest 不需要理解 prompt 含义,不会把 prompt/对话正文写入自己的数据文件,更不会上传;也从不打开你的源代码文件。
应用在本地保存什么
当前 Beta 将数据文件保存在应用目录旁;后续版本会迁移到标准每用户目录(Windows:%LOCALAPPDATA%\TokenForest\,macOS:~/Library/Application Support/TokenForest/)并自动迁移数据。
| 文件 | 内容 |
|---|---|
| garden.json | 每棵树的 token、阶段、果实、装饰、首次使用时间 |
| config.json | 窗口位置、语言、气泡模式、排行榜状态、昵称、地区 |
| growth_ledger.json | 按日期 × 树种 × token 类型的成长流水 |
| usage_ledger.json | 聚合会话元数据:日志路径、项目名、分支、AI 标题、时间、模型、按日 token 汇总 |
| account.json | 仅在开启过排行榜后存在:匿名用户 ID 与 Supabase 会话令牌 |
这些文件只存在于你的机器上,不会上传。usage_ledger.json 含文件路径等本地元数据,同一台电脑的其他用户若能读你的文件即可看到,请把应用数据目录视为私人目录。account.json 当前以普通 JSON 保存会话令牌,改用操作系统凭据存储已在计划中。删除这些文件(或卸载并删除目录)即清除全部本地数据。
默认网络行为
排行榜关闭(默认)时,Token Forest 不发出任何网络请求:成长、气泡、商店、胶囊模式、数据面板全部离线可用,成本估算使用内置价格表,不做任何在线查询。
菜单中打开网页的入口(如排行榜网站)只是调用系统默认浏览器,桌面应用本身不在后台发送任何内容。
可选排行榜
默认关闭。选择「开启」会先弹出同意确认,列出将同步的全部字段;确认前不会发送任何内容。
开启后,应用会向 Supabase(数据库服务商)注册匿名账户,并大约每 30 分钟以及启动、换树、退出等时点同步:
| 字段 | 是否公开展示 |
|---|---|
| 随机匿名 ID(Supabase 生成,仅用于归属你的记录) | 否 |
| 展示昵称(留空则生成「匿名用户#编号」) | 是 |
| 收集的树 Token 总数 | 是 |
| 每棵树的 Token 数与成长阶段 | 是(树详情) |
| 地区——仅在你主动选择后 | 是(国旗) |
| 当前树种 | 是 |
| 服务端生成的创建/更新时间 | 可能显示 |
小字说明:昵称留空时生成的匿名名按你的界面语言渲染,因此榜单会间接体现你的 UI 语言。
任何模式下都不会上传:原始日志、prompt/对话正文、源代码、会话标题、文件路径、项目名、Git 分支、按模型/按会话用量、成本估算。
与任何在线服务一样,Supabase 的基础设施会为运行与安全处理标准连接数据(如 IP 地址、请求时间),适用其自身政策。
开启 · 暂停 · 关闭
- ✦开启——定期同步。
- ✦暂停——停止更新,最后一次记录保留在榜上。
- ✦关闭——停止同步,并发送删除请求撤下你的记录。
Beta 限制,如实说明:删除请求失败时(例如离线),当前 Beta 尚不会重试或确认;联网后再切一次「关闭」会重新发送。可靠的删除确认机制会在正式版前补齐。你也可以联系我们协助删除(见「联系我们」),提供 App 内显示的匿名名/编号即可——请勿把 account.json 里的令牌发给任何人。
网站
本网站不使用分析工具、广告跟踪或营销 Cookie。托管商会为提供与保护服务处理标准服务器日志(IP、浏览器标识、请求页面、时间)。排行榜页面读取上述公开榜单数据,浏览无需登录。将来若引入 analytics 等服务,会先更新本声明。
服务提供商
仅为明确功能使用少量服务商:Supabase(匿名认证 + 排行榜数据库)、网站托管商、GitHub(产品仓库、Issues 与 Release 下载)。服务商区域与政策链接将在首个正式版前在本节补全。
如何验证这些承诺
我们很清楚“相信我们”这句话本身不够分量。断网状态下应用照常运行——你可以亲自试试。每个 Release 都会发布 SHA-256 校验值与签名状态,Release notes 会单独列出任何隐私/网络变化。源代码目前是私有的,但我们在考虑开放核心的用量读取组件,让“只读日志、默认零上传”可以被独立审计。
你的控制权
- ✦完全离线使用——不开启排行榜即可;
- ✦随时在树的菜单中暂停或关闭同步;
- ✦修改或清空昵称与地区;
- ✦删除应用数据文件/卸载即删除本地数据;
- ✦联系我们确认远程记录已删除。
变更
未来版本若新增任何数据处理(遥测、崩溃上报、更新检查、新排行榜字段),会在该版本发布之前更新本声明与 App 内同意文案,并在 Release notes 的「Privacy or network changes」一节中明确列出。
联系我们
发布者: Poietic Studio 隐私: contact@tokenforest.com.au(过渡期;privacy@tokenforest.com.au 将在首个公开版本前启用) 安全: 见 Security 页 网站: https://www.tokenforest.com.au