本地运行零上传:humanizer隐私设计与数据流向全解析
本地运行零上传:humanizer隐私设计与数据流向全解析
humanizer 是一个把 AI 草稿改写成"人话"的本地改写工具:一个 12B 参数的大模型(humanizer-12b,由 google/gemma-4-12B 微调而来)直接跑在你自己的 Mac 或 Windows 上,把邮件、报告、论坛帖里的机器味去掉,同时保住数字、日期和人名。因为模型和推理都在本机完成,所以它的隐私设计有一个很干净的卖点——你的草稿全程不出电脑。这篇教程带你从数据流向、本地服务防护、文件落盘位置到仅有的联网时机,把 humanizer 本地运行的隐私边界完整拆开看一遍。
一次改写的完整数据流:全程本机闭环
先回答最核心的问题:贴进草稿后,这段文字去了哪里?
你的草稿
→ 浏览器页面(App 打开的就是本地网页)
→ 127.0.0.1:47615(humanizer 启动器,只监听本机回环地址)
→ 127.0.0.1:临时端口(llama.cpp 引擎,同样只听 127.0.0.1)
→ 改写结果流式返回页面
整条链路没有一步经过公网 IP。两个关键代码位置可以佐证:
- 启动器把 HTTP 服务绑定在回环地址上,见 app/internal/launcher/main.go;
- 内嵌的 llama.cpp 引擎启动时显式加了
--host 127.0.0.1(注释原文就是"只听本机"),见 app/internal/launcher/engine.go。
也就是说,哪怕同一局域网里的其他设备,也无法直接访问你的草稿或改写结果。
模型下载完成之前,App 会从 Hugging Face(国内可切 hf-mirror.com 镜像)下载一次 GGUF 权重;下载完成之后,改写过程完全离线——断网状态下粘贴草稿,照样出结果。
本地服务四道"门卫":humanizer 如何防住浏览器之外的访问者
App 的页面跑在本地 HTTP 服务上,这带来一个天然问题:浏览器之外的恶意网页能否"顺手"调用你的改写接口、偷走草稿?humanizer 在 app/internal/launcher/server.go 里用一套 guard 挡住了三类攻击:
| 防护 | 作用 | 对应风险 |
|---|---|---|
| Host 白名单 | 只接受 127.0.0.1:端口 和 localhost:端口 两个 Host |
DNS rebinding(恶意域名解析到 127.0.0.1 绕过同域限制) |
| Origin 校验 | 跨站页面带 Origin 头调接口直接 403 | CSRF 跨站调用 |
自定义 X-Humanizer 头 |
写操作必须带这个头,而自定义头会触发 CORS 预检——别站发不出来 | 恶意脚本发起流式请求 |
| 严格 CSP | connect-src 'self':页面只允许连接它自己 |
页面向第三方发数据 |
另外页面不种 Cookie、响应头强制 no-referrer(server.go)。还有一个细节:本地 llama-server 的访问密钥是每次启动随机生成的,只有启动器自己的反代知道(app/internal/launcher/app.go),即使有人摸到引擎端口也进不去。
对普通用户来说,这些意味着一句话:草稿的"收件范围"被严格限定在"你自己这台机器上的这个浏览器标签页"。
草稿和历史存在哪:一份本地文件清单
很多写作工具把你的内容悄悄同步到云端,humanizer 没有云账号这一说,所有数据都是本地文件:
| 数据 | 存放位置 | 是否出网 |
|---|---|---|
| 草稿与改写文本 | 只在内存和本地页面里,不落盘 | 只到 127.0.0.1,不出本机 |
| 改写历史(最多 100 条) | 浏览器 localStorage,app/web/js/history.js |
否 |
| 设置(档位、下载源、端口等) | 数据目录 settings.json |
否 |
| 模型文件(GGUF,3.9–23.8 GB) | 数据目录下 models/ |
仅首次下载 |
| 运行日志 | 数据目录 logs/launcher.log |
否 |
数据目录的默认位置(app/internal/launcher/paths.go):
- macOS:
~/Library/Application Support/Humanizer - Windows:
%LOCALAPPDATA%\Humanizer - 其他系统:
$XDG_DATA_HOME/Humanizer
磁盘紧张时,可以在「…」→「更改存储位置」把运行目录和模型目录整个搬到别的盘(比如 D 盘),App 会把模型文件一并搬过去。搬完之后点「在 Finder / 资源管理器中显示」,你能亲眼看到上面清单里的每一个文件——看得见,才谈得上可控。
还有一个可选模式值得一提:如果你在 LM Studio 或别处已经跑着同一个模型,可以让 App 通过"外部模型服务"直接用它(app/internal/launcher/external.go)。此时 API key 单独存成 0600 权限的文件,且只在启动器侧加到请求头上,浏览器永远拿不到密钥。
什么时候会联网:humanizer 仅有的三种网络行为
把联网行为穷举一遍,你能清楚知道"出网时刻"到底是什么:
1️⃣ 首次下载模型(一次性)
下载器(app/internal/launcher/download.go)下完会先检查 GGUF 魔数防止拿到"假文件",再校验 SHA256 通过后才会改名启用。每个文件的校验值都公开列在 AGENTS.md 里,可自行比对——文件完整性不依赖"下载它的那个网站"。
2️⃣ 每天一次的更新检查(可关闭)
App 默认每天查一次 GitHub Releases 和模型仓库有没有新版本。源码里的隐私注释写得很直白(app/internal/launcher/update.go):只请求公开接口,User-Agent 仅 humanizer-app/<版本>,不带账号、邮箱、设备信息、Cookie;网络不通时安静失败。嫌烦可以在设置里关掉,改成手动「检查更新」。
3️⃣ 你主动配置的外部模型服务(可选)
只有你自己在「外部模型服务」里填了地址,App 才会把改写请求发往那个服务——通常也是你自己的机器(如 localhost:1234)。不配置,这一路根本不存在。
除了这三种,没有其他遥测、统计或任何后台同步。日志全部写在本地 logs/ 目录,想查就查,想删就删。
三步自测:亲手验证"零上传"
与其听项目方说,不如自己动手验证。三步都能在你电脑上 5 分钟内完成:
- 看文件:「…」→「更改存储位置」→ 显示运行目录,确认数据目录里只有清单里那些文件,没有任何"同步中"的影子目录。
- 看请求:模型下载完成后,观察网络活动——改写草稿时只有
127.0.0.1的本地流量,没有外发请求。 - 断网实测:关掉 Wi-Fi 或拔网线,打开 App 粘贴一封邮件草稿,照样能完整改写。这是最直观的隐私证明:离线的机器,传不出任何内容。
小结
humanizer 的隐私设计可以浓缩成三句话:草稿只走 127.0.0.1 回环地址;所有落盘文件位置透明、可搬移、可自查;联网只有下载模型和可关闭的更新检查两种默认行为。对"文档敏感、又不想折腾服务器"的新手来说,这套"本地运行 + 零上传"的架构,正是本地大模型工具该有的样子。
最后提醒一句:模型偶尔会把数字写错(如 "37 complaints" 变 "37%" of complaints"),发布前还是通读一遍数字、日期和人名;公司或学校对 AI 辅助写作有规定的,以规定为准。更多运行方式(llama.cpp、MLX、Ollama、LM Studio 等)见 docs/USAGE.zh.md,安装细节见 docs/INSTALL.zh.md。


