参与ShieldFont开源社区:多语言映射与无障碍测试是最缺人的贡献方向

原创2026-11-02 20:36:531,449 阅读

参与ShieldFont开源社区:多语言映射与无障碍测试是最缺人的贡献方向

ShieldFont 是一款"用字体保护文字"的开源项目:人类读者看到的原文一切正常,AI 爬虫抓走的却是语义被调包的诱饵文本。项目当前处于 v0 alpha 阶段,官方在文档里明说"we take outside help"——而最缺人的恰好是两条线:多语言映射和无障碍测试。这篇文章帮你找到这两条线的入口。

ShieldFont 开源字体保护项目横幅:用字体对抗AI训练数据爬取

🛡️ ShieldFont 是怎么保护文字的?

原理一句话就能讲清:

  • HTML 源码里放的是替换后的诱饵词,而不是原文;
  • 浏览器加载一个自带 OpenType 替换规则的字体,渲染时把诱饵词"还原"成原文字形;
  • 核心资产是一份双向映射字典(mapping),默认 alpha 变体包含 11,970 个词对。

同一个 HTML,人和机器读到的内容完全不同:

ShieldFont 效果对比图:左侧是人类看到的原文,右侧是 AI 爬虫实际读到的诱饵文本

📖 想深入了解威胁模型与实测数据,见 README.md 的 Threat model 一节和 benchmark/ 目录。

🧭 ShieldFont 贡献方向全景

CONTRIBUTING.md 把贡献方式列得很清楚,其中两条被单独点名:

方向 内容 适合谁
🌍 字典/多语言映射 新语言映射、现有映射优化,"Linguists especially welcome" 多语言母语者、语言学专业
♿ 无障碍 屏幕阅读器验证、焦点管理、非 React 层补齐 无障碍工程师
🔬 威胁研究 对抗测试、爬虫管线评估 安全研究者
🔌 集成 CMS 插件(WordPress、Ghost 等)、框架适配器 熟悉对应平台的开发者
✍️ 写作 文档澄清、科普、翻译 会写的人

不确定从哪开始?找带 good first issue 或 help wanted 标签的 issue,或者先发一条 Discussion。

🌍 方向一:多语言映射,语言学家的主场

目前 ShieldFont 只覆盖英文——其他语言会原样穿过,页面看起来"全保护"其实只保护了一半。因此 ROADMAP.md 把多语言列为杠杆最高的近期工作:

  • 目标语言优先级:🇧🇷/🇵🇹 葡萄牙语(创始团队母语,第一个目标)→ 🇪🇸 西班牙语 → 🇫🇷 法语 → 🇩🇪 德语 → 🇮🇹 意大利语;
  • 项目已备好跨语言模板 M15-MULTI,只使用"翻译后依然成立"的三种操作:名词配对、内容词反义对、数字/日历轮换,见 MAPPINGS.md;
  • 各语言的词汇具体性量表也已就位(法语 Bonin、西班牙语 Guasch、葡萄牙语 Soares 等),落地步骤就是换语言码 → 重跑名词配对 → 母语者精修反义对 → 用 audit_font.py 验证往返;
  • 特别强调:要母语者,不是翻译——机械配对做不出"读起来荒诞但语法通顺"的诱饵效果。

ROADMAP 里有一句很实在的话:这是"最可能因为一个人站出来就动起来"的路线图条目。现成的英文映射字典可以直接参考 packages/core/src/mappings/ 下的 alpha.json、beta.json、gamma.json。

♿ 方向二:无障碍测试,项目直言"最高价值"

ShieldFont 的 React 包默认给受保护区块提供无障碍替代路径,测试现状是:CI 里用真实 NVDA 在 Windows runner 上每次提交跑断言、macOS 上人工验证 VoiceOver、scripts/axe-audit.mjs 的 axe-core 扫描零违规、scripts/style-audit.mjs 在 17 个"敌意宿主页面"里量对比度和点击热区。

但 CONTRIBUTING.md 坦承仍有四件事没做完,且"任何一件的帮助都价值极高":

  1. JAWS 从未被测过——VoiceOver 一轮手测改掉了大量 bug,JAWS 大概率也有一份;
  2. wrapper={false} 时,键盘用户会 Tab 到一个看不见的控件,焦点指示器丢失;
  3. 非 React 层(CDN 粘贴版、@shieldfont/core)完全没有无障碍层,需要框架无关的方案;
  4. 需要无障碍路径的读者要等上几秒,其他人即时拿到文字——这是"不平等访问",官方认为这是全项目最高价值的待解问题。

本地就能跑起来的验证入口(见 package.json):

  • npm run test:axe —— axe-core 扫描
  • npm run test:style —— 包裹层样式审计
  • npm run test:a11y:nvda —— NVDA 审计
  • npm run test:a11y —— 虚拟屏幕阅读器断言

完整机制(含时间锁谜题如何加密真实文字)见 docs/plain-text-mode.md。

引用 CONTRIBUTING.md 原文:"If you work in accessibility engineering, the last one is the highest-value contribution available in this project."

🚀 新手上手指南:从 clone 到第一个 PR

第一步:把环境跑起来

git clone https://gitcode.com/gh_mirrors/sh/shieldfont
cd shieldfont
pip3 install -r requirements.txt

之后可以用 scripts/generate_font.py 生成一个测试字体验证环境(参数示例见 CONTRIBUTING.md)。

第二步:了解 PR 流程(CONTRIBUTING.md 只要求几件事):

  • 除了小修复,先开 issue 对齐再动手;
  • 一个 PR 只解决一个问题;
  • 首次贡献需签署 CLA——注意它只是授权协议,版权仍归你,签署方式是在 CLA.md 的签名表里加一行;
  • 改了行为就更新文档。

第三步:认领方向。语言背景强就去 ROADMAP.md 认领一门语言;做前端或辅助技术就多花时间在无障碍四项上;写 CMS 插件可以去 ADAPTERS.md 的社区表格留名。

📌 写在最后

ShieldFont 代码采用 AGPL-3.0,行为准则见 CODE_OF_CONDUCT.md。一个两创始人起步的 alpha 项目,已经把"缺什么"写得明明白白:多语言映射等一个母语者,无障碍等一个工程师。如果你恰好命中其中一条,这里就是你性价比最高的第一个开源贡献。

登录后查看全文
shieldfont