本地运行零上传:humanizer隐私设计与数据流向全解析

原创2026-11-05 22:37:522,126 阅读

本地运行零上传: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。两个关键代码位置可以佐证:

也就是说,哪怕同一局域网里的其他设备,也无法直接访问你的草稿或改写结果。

humanizer 本地运行界面:左边草稿、右边改写,新写的部分用荧光笔标出

模型下载完成之前,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 否

humanizer App 中文界面真机截图:左侧草稿区与右侧改写区

数据目录的默认位置(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 权限的文件,且只在启动器侧加到请求头上,浏览器永远拿不到密钥。

中文工作邮件改写前后对比:左边是 AI 草稿,右边是改写结果,荧光笔标出新写的部分

什么时候会联网: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 分钟内完成:

  1. 看文件:「…」→「更改存储位置」→ 显示运行目录,确认数据目录里只有清单里那些文件,没有任何"同步中"的影子目录。
  2. 看请求:模型下载完成后,观察网络活动——改写草稿时只有 127.0.0.1 的本地流量,没有外发请求。
  3. 断网实测:关掉 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。

登录后查看全文
humanizer-local-model