页知译 · 隐私与数据说明
文档更新日期: · 依据源码版本 1.0.3 核对
本说明适用于“页知译(Yezhi Translate)”Chrome 扩展,说明网页翻译与 PDF 阅读翻译如何处理数据。可用功能以您安装的版本为准;上方日期是本文档的修订日期,正式生效日期见待确认事项。
一、网页文字如何处理
- 只有在您主动操作(整页翻译、选中文字翻译、Shift 单段翻译、悬停翻译)或开启“自动翻译”后,符合采集规则的文字才会发送。发送内容为:待翻译文字、源语言、目标语言,以及所选服务需要的参数。
- 新安装默认关闭自动翻译,旧用户已保存的偏好不会被强制覆盖。开启自动翻译或主动开始当前页翻译后,滚动、弹框与动态更新可能触发补翻,从而继续发送新出现的文字。
- 单段翻译默认要求鼠标停在段落上并按 Shift。若在设置中改为“直接触发”,鼠标停留本身就可能触发文字发送;也可完全关闭悬停翻译。
- 自动与整页采集会跳过:输入框的值、密码框、
textarea、select、可编辑区域、代码区、不可见内容,以及网页明确标记禁译的区域。主动 Shift 翻译可以覆盖网页的translate="no"等禁译标记,但仍然跳过输入值、编辑区与代码。 - 开放式 Shadow DOM 与 Chrome 允许访问的 iframe 使用同一套采集规则,由主页面统一开始或取消。扩展不读取封闭式 Shadow DOM 内部内容。
- 翻译请求中不包含当前网页地址、浏览历史或整页 HTML。但正文本身可能含有网址、姓名、账号或其他私人信息,这些内容会随文字一起发送。请按需选择翻译范围,避免发送不希望交给服务方的内容。
- 为合并请求与减少重复调用,原文与译文会短暂驻留在扩展后台内存和当前页面内存中,详见第四节。
二、PDF 文件、OCR 与导出
- 本地 PDF 在扩展内读取,不上传文件本身。在线 PDF 从您输入或打开的地址直接获取,并先按该来源申请访问权限;单文件上限 50 MiB。
- 在线 PDF 请求不携带 Cookie、不发送 Referer(来源页)请求头、不跟随重定向。来源服务器仍会收到文件地址中的路径与查询参数,以及 IP 地址等通常的网络连接信息。需要登录或跳转的文件请先下载,再从本地打开。
- 加密 PDF 的密码在阅读器弹框中输入,仅用于本机解锁文档,不保存、不发送。
- 主动开始翻译后,扩展提取可用文字,并对扫描页或图文混排区域在本机运行 OCR。完整 PDF、页面图像与 OCR 位图不发送给翻译服务;只有需要翻译的提取文字与语言参数会发送。
- 原位译文显示、独立译文编辑、人工修订与 PDF 导出均在本机完成。拖画文字框修订只提取本页文字与坐标,不主动发起翻译请求;切换阅读模式、缩放与旋转复用已有结果,不重新发送文字。显式补译或重新翻译会发送相应文字。
- 导出不修改源文件字节,不触发新的翻译或 OCR。导出的 PDF 是您设备上的独立文件,由您自行保管或删除。
- 英语与简体中文 OCR 模型随扩展提供。其他已支持语言模型(繁体中文、日语、韩语、法语、西班牙语、德语、俄语、阿拉伯语)与中日韩导出字体按需下载,详见第三节。
三、哪些服务会接收数据
翻译服务
扩展没有自建翻译中转服务器。文字由扩展后台直接发往您选择的服务;服务方的数据保留、模型训练、计费与其他处理规则由其自行决定,请查阅所用服务的隐私政策。任何网络请求都会向接收方暴露 IP 地址等通常的连接信息。
| 服务 | 请求方式 | 发送内容 | 凭据处理 |
|---|---|---|---|
| Google 翻译 | HTTPS GET,文字位于地址查询参数 | 待翻译文字、源语言、目标语言 | 无需账号或密钥 |
| MyMemory | HTTPS GET,文字位于地址查询参数 | 待翻译文字、明确的语言对 | 无需账号或密钥 |
| 百度翻译 | HTTPS POST 表单 | 文字、源/目标语言、AppID、随机盐值、签名 | 密钥本身不发送,只发送由 AppID、文字、盐值与密钥计算的 MD5 签名 |
| AI 服务(OpenAI、DeepSeek、通义千问、智谱、Kimi、火山方舟、MiniMax、阶跃星辰、硅基流动、百度千帆、魔搭、LongCat 及自定义接口) | HTTPS POST JSON,OpenAI 兼容 /chat/completions |
模型名称、翻译指令(系统提示)、待翻译文字 | 以 Authorization: Bearer 发送您填写的 API Key |
本机 AI 服务(自定义接口指向 localhost、127.0.0.1) |
HTTP POST JSON,发往您配置的地址 | 模型名称、翻译指令、待翻译文字 | 不附加密钥;回环地址的请求只在您的电脑上来回 |
Google 与 MyMemory 以 GET 方式发送,文字会出现在请求地址中,可能被服务方的访问日志记录。远程自定义接口强制 HTTPS,HTTP 仅允许 localhost 与 127.0.0.1;接口地址不得包含账号密码、查询参数或片段。自定义接口域名需要您主动授权后才会请求。
使用 AI 服务时,翻译指令中会说明源语言与目标语言;若文字中含有受保护的术语或代码片段,指令会要求服务原样保留形如 ⟦YZY数字:数字⟧ 的内部标记。这些标记在本地生成与还原,整张术语表不会发送给服务。
AI 提示词模板、收藏、默认选择和最近 5 份历史版本保存在本机,不使用 Chrome 同步。调用 AI 翻译时,当前任务所选的参数和附加指令会随翻译请求发送给您选择的 AI 服务,不会上传整个模板库。设置页的本地预览不联网;主动点击“翻译测试与对比”会发送测试原文与所选指令,可能产生 API 费用。测试文字和结果仅保留在当前设置页面内存,不写入模板或导出文件。提示词与术语表的 JSON 导入、导出及示例模板下载在本机处理,不经过翻译服务;导出文件可能包含您自行填写的指令与术语,请自行妥善保管。
模型与字体下载
- OCR 模型来自
tesseract-ocr/tessdata_fast仓库的固定 commit;导出字体来自notofonts/noto-cjk仓库的固定 commit(SIL Open Font License 1.1)。两者均通过 GitHub 原始资源地址(raw.githubusercontent.com)下载。 - 下载前按对应来源申请访问权限;下载后校验 SHA-256 摘要与字节数,再保存到本机数据库。摘要不匹配的内容不会被使用。
- 下载请求不携带 Cookie、不发送 Referer、不跟随重定向,也不附带 PDF 正文、页面图像或任何个人配置。下载服务仍会接收通常的网络连接信息。
- 远程资源是模型与字体数据文件,不是可执行代码。扩展不加载远程脚本;PDF 与 OCR 引擎随扩展包提供,在本地运行。
连接测试
主动点击“测试连接”时,扩展向对应接口发送固定样例文字 Hello world(英语 → 简体中文)及必要认证信息,用于验证连通性与凭据有效性。测试不会发送您的网页或 PDF 内容。百度只有在当前这份 AppID 与密钥测试通过后才可被选择;凭据变化后旧测试结果立即失效。
Chrome 同步与本页面托管
- 普通偏好可能经您的 Chrome 账号同步到同一账号的其他设备,详见第四节。API 密钥、术语表与请求策略不写入同步区。
- 通过 GitHub Pages 访问本隐私网页时,会连接 GitHub 的托管服务,其日志规则由 GitHub 决定。本页面不加载统计脚本、远程字体或外部运行代码。
四、本机保存与 Chrome 同步
- 仅保存在本机的配置(
chrome.storage.local) - 各 AI 厂商的接口地址、密钥与模型;百度 AppID、密钥与连接验证记录;每服务的请求频率与并发策略;自定义术语表。术语表可主动导出为 JSON 文件。本机存储不等同于加密保险箱,详见第九节。
- 可能通过 Chrome 同步的偏好(
chrome.storage.sync) - 所选服务与 AI 厂商、源/目标语言、显示模式、译文样式(字体、字号、颜色、字重、行高、间距)、自动翻译开关、悬停翻译方式、悬浮球面板开关、快捷键启用状态,以及悬浮球位置、界面语言、配色与外观模式。这些字段不含密钥与文档内容,但可能同步到您使用同一 Chrome 账号的设备。
- 旧版凭据迁移
- 旧版本曾把凭据保存在同步区。首次读取时会迁移到本机,本机已有配置优先(包括您主动清空的密钥);写入成功后删除同步区的旧字段。扩展无法直接控制 Chrome 同步服务此前已保留的历史副本。
- PDF 人工修订与本机资源(IndexedDB)
- 以下内容保存在扩展自己的本机数据库中,不通过 Chrome 同步,按文档与翻译配置隔离:
| 数据库 | 保存内容 | 写入时机 |
|---|---|---|
yezhiyi-pdf-inplace | 原位修订文字、对应原文与机器译文、区域坐标、文字样式、文档识别信息 | 您主动保存修订时;不含完整 PDF 或页面位图 |
yezhiyi-pdf-editor | 独立译文编辑稿,可能包含从原页面裁取或由您插入的图片 | 编辑器保存时 |
bt-pdf-ocr-models | 按需下载的 OCR 模型字节与安装记录 | 你确认下载并校验通过后 |
bt-pdf-fonts | 按需下载的导出字体字节与安装记录 | 导出需要且校验通过后 |
yezhiyi-pdf-edits | 旧版段落修订数据,只读兼容 | 不再写入,仅供旧数据查看 |
- 阅读页界面偏好(
localStorage) - PDF 阅读页在扩展自己的页面来源下保存两项界面偏好:缩略图侧栏展开状态(
bt-pdf-thumbnails-open)与左右阅读区分栏比例(bt-pdf-reader-share)。不含文档内容,不随 Chrome 账号同步。 - 临时文字与结果(内存)
- 为合并请求、限流与减少重复调用,原文、译文及配置索引暂存于后台内存:共享缓存最多 256 条,成功结果有效期 10 分钟,失败信息冷却 30 秒,后台线程退出后清空。网页的原文快照与译文保留在当前页面内存;PDF 文件字节、OCR 结果与阅读、导出缓存保留在当前阅读页内存,关闭页面后释放。显式保存的人工修订与编辑稿按上表持久化。
五、浏览器权限用途
| 权限 | 用途 | 边界 |
|---|---|---|
| 网站访问(内容脚本注入所有框架) | 在 Chrome 允许的网站采集文字、插入译文界面与控制面板 | 受 Chrome 网站访问设置限制;不读取封闭式 Shadow DOM |
| 固定接口来源(17 条) | 调用 Google、MyMemory、百度与预设 AI 接口,以及本机回环地址(供自行运行的 AI 服务) | 仅用于翻译请求与连接测试 |
可选来源 https://*/*、http://*/* | 按您的操作逐次申请:自定义 AI 接口域名、在线 PDF 来源、OCR 模型与导出字体下载来源 | 在点击调用链中申请,拒绝授权则不发起请求;可在 Chrome 扩展管理页随时收回 |
storage | 保存本机配置与可同步偏好 | 分流见第四节 |
contextMenus | 提供“翻译此页面”“翻译选中文字”两个右键菜单 | 仅在您点击菜单时触发 |
tabs | 定位当前标签页发送控制消息、打开或复用扩展页面、在 PDF 阅读器标签页禁用工具栏弹窗 | 为此会读取标签页地址以判断是否为阅读器页;地址不保存、不上传,也不用于翻译请求 |
webNavigation | 核验活动文档身份、浏览器前进/后退恢复、iframe 中 Shift 命中的框架定位 | 文档身份仅维护于后台内存;不保存或上传浏览历史,不持续向后台上报鼠标移动 |
内容安全策略 wasm-unsafe-eval | 允许随包 PDF.js 与 Tesseract 的本地 WebAssembly 运行 | 脚本来源限定为扩展自身,不加载远程可执行代码 |
扩展未申请 history、cookies、webRequest、declarativeNetRequest、downloads、identity、scripting 等权限,代码中也未调用这些接口。
六、日志与诊断
- 开发源码带有可配置的主动日志(级别
off / error / warn / info / debug),输出到浏览器控制台,供本机排查使用。日志约定禁止包含原文、译文、密钥、完整请求对象与含敏感参数的地址。 - 正式打包会在临时副本中强制关闭主动日志(
production+off),并校验安装包;因此商店安装包默认不输出这些日志。开发源码的日志配置不会被打包流程修改。 - 翻译耗时诊断只包含阶段名、任务与分片编号、服务标识、字符数与字节数、配置的限额、耗时毫秒数与 HTTP 状态码,不含文字内容、凭据、缓存键或账号信息。诊断只回传给发起请求的扩展页面,不发送到任何服务器。
- 错误提示使用固定的分类说明,按界面语言显示,不直接透传第三方返回的原始正文。
- 扩展不写入自建日志文件,也不上传日志。浏览器自身或网页产生的控制台输出不属于扩展的主动日志。
七、我们不做的处理
- 不含广告、使用行为统计、分析或遥测代码,也没有自建数据采集服务器。
- 不收集账号身份、姓名、邮箱、设备标识符或位置信息;扩展没有注册或登录流程。
- 不读取或上传浏览历史、Cookie、书签、下载记录。
- 不上传完整 PDF 文件、页面图像、OCR 位图或整页 HTML。
- 不加载远程可执行代码;第三方引擎随扩展包提供,按需下载的是模型与字体数据文件。
- 不主动把网页地址加入翻译请求,不把术语表整表发送给服务。
需要说明的例外:您选择的服务方会按其自身政策处理收到的文字与连接信息;Chrome 同步会按您的账号设置传输普通偏好;GitHub Pages 会按其托管规则记录本页面访问。这些不在扩展的控制范围内。
八、如何控制与清理
减少发送
- 关闭“自动翻译”可停止新页面自动启动;当前页一旦开始仍会补翻,需点击取消停止。关闭悬停翻译或改回“需按 Shift”可避免鼠标停留触发发送。
- 离开标签页或最小化窗口会暂停网页新发送,在途请求可能完成;返回后按页面状态继续。用户取消后不会自动恢复整页翻译。
- 取消会清理本页排队任务,并尝试中止仅由本页使用的请求;其他页面仍依赖的共享请求会保留。已被服务方接收的数据无法通过取消撤回,仍可能被处理或计费。
- 在 Chrome 扩展管理页可调整网站访问权限,或收回已授权的自定义接口、PDF 来源与资源下载来源。
删除本机数据
- 设置页可清空或修改 AI 密钥、接口地址与模型,清空百度 AppID 与密钥(凭据变化会使旧验证记录失效),编辑或删除术语规则,恢复默认译文样式与行为偏好。
- PDF 阅读器可删除已下载的 OCR 模型与导出字体;可恢复对应段落的机器译文或删除区域补译。“取消翻译”清除本页原位译文与修订,“重新翻译”清除本页旧结果后重新处理,两者都不删除独立编辑稿。
- 关闭阅读器会释放临时文件字节与缓存;已保存的原位修订、独立编辑稿、模型与字体仍保留在本机数据库中,需要按上一条主动删除。
- 卸载扩展会清除其
storage.local、storage.sync中的扩展数据、IndexedDB 数据库与阅读页localStorage。Chrome 同步服务此前已同步到其他设备或账号侧的副本,需由您在相应设备或账号设置中处理。 - 主动导出的术语 JSON 与译文 PDF 是独立文件,需自行管理或删除;第三方服务已保存的数据需按各自政策申请删除。
九、保留期限与安全边界
- 内存缓存有明确期限:成功译文最多 10 分钟、最多 256 条,失败冷却 30 秒,后台线程退出即清空;页面与阅读页内存在关闭后释放。
- 本机持久化数据(密钥、术语表、AI 提示词模板与历史、请求策略、原位修订、独立编辑稿、下载的模型与字体、界面偏好)没有自动过期时间,会一直保留到您主动删除或卸载扩展。
- 本机存储由浏览器与操作系统保护,但扩展未对密钥或修订内容做额外加密;同一设备上的其他程序或具备相应权限的人可能访问。请勿在共享设备上保存敏感凭据。
- 远程接口强制 HTTPS,本机回环地址允许 HTTP。密钥在 AI 请求中以认证头发送,这是调用该服务的必要条件;百度密钥本身不发送。
- 扩展不能控制服务方的保留期限、是否用于模型训练或是否计费。涉及敏感、机密或个人信息的内容,请自行评估后再选择服务与翻译范围。
十、需开发者确认的政策事项
- 正式生效日期与政策版本号:当前只标注文档更新日期,未确定生效日期。
- 开发者联系渠道:目前仅提供项目 GitHub Issues,未设置专用隐私联系邮箱或表单。
- 是否在扩展内提供本页入口:设置页“关于”当前只有内联隐私摘要,没有指向本页面或线上地址的链接。
- 第三方服务政策链接:本页按名称列出服务,未逐一附上其隐私政策地址,避免给出未经核实的链接。
- 未成年人使用与敏感个人信息立场:扩展不做年龄识别,也未就是否面向未成年人、是否建议处理敏感个人信息作出政策声明。
- 数据保留与删除承诺:本机数据无自动过期,是否需要提供“一键清除全部本机数据”入口或明确的保留期限承诺待确认。
- Chrome 同步副本的处理说明:扩展无法删除同步服务已保留的历史副本,是否需要向用户提供账号侧清理指引待确认。
- 适用法律与争议处理:未确定适用司法辖区、合规基线(如 GDPR、个人信息保护法)与投诉处理流程。
- 项目许可证:仓库根目录暂无
LICENSE,随包第三方资源的许可证见pdf/vendor/。
十一、联系与说明更新
如对本说明或扩展的数据处理有疑问,可通过 公开反馈仓库 Issues 联系项目维护者。公开反馈时请勿附上密钥、私人文档或未脱敏的请求信息。
当前商店资料配置采用的公开地址为中文隐私说明与英文隐私说明。实际部署内容与商店后台填写值仍需在发布时核对,旧地址的保留或迁移另行处理。
功能或数据处理方式变化时,会同步更新本页与顶部日期。此网页与英文版共同维护隐私说明,保留既有访问路径 docs/privacy.html。