文本盲水印插件（Textwatermarking）使用说明

版本：1.0.0 ｜ 作者：kuakeba.cn ｜ 适用宿主：Zsens Admin（社区版）

在帖子正文中嵌入不可见盲水印，支持 IP、用户 ID、时间戳、站点标识等信息，用于版权追溯。正常浏览完全无感知，一旦帖子被复制、转载，盲水印会随文本一起带走，后台可一键解码追溯来源。

一、工作原理

• 编码载体：零宽字符（U+200B / U+200C / U+200D / U+2060）。它们不占视觉宽度、不可见，但属于合法 Unicode，复制与爬取都会保留。
• 嵌入信息：把 IP + 用户ID + 时间戳（可按需增加站点标识、随机串）拼成明文 payload，再追加 HMAC-SHA256 签名（使用「水印密钥」），整体编码为零宽字符序列。
• 注入方式：通过前台正文渲染钩子（HookService::filterHtml）在展示时动态注入，不写入数据库，不污染原始内容；可选择注入正文开头 / 结尾 / 两端。
• 解码追溯：后台「文本盲水印 → 水印解码」粘贴可疑文本，一键提取字段并校验签名，判断水印是否有效、密钥是否一致。

二、安装

1. 把 plugins/text_watermarking 目录整体上传到项目 plugins/ 下。
2. 后台「应用中心 → 文本盲水印 → 安装」。
3. 安装后自动注册后台菜单「文本盲水印」（水印解码页），无需改主题模板。

卸载仅注销菜单，不删除任何数据表、不修改帖子内容。

三、配置项（应用中心 → 文本盲水印 → 配置）

四、水印解码

后台「应用中心 → 文本盲水印」进入解码页：

1. 从涉嫌盗版 / 转载的页面「全选复制」正文，粘贴到文本框；
2. 点击「提取并解码」；
3. 若水印有效，展示：

  - 客户端 IP：发帖浏览者 IP；

  - 用户 ID：本站用户编号；

  - 时间戳：自动转换为可读时间；

  - 站点标识 / 随机串：如配置了则一并显示；

  - 签名校验：提示水印有效 / 密钥不一致 / 内容被篡改。

解码必须使用与注入时相同的水印密钥。若密钥被修改，历史水印会提示「签名校验失败」。

五、版权追溯示例

六、常见问题

1. 水印对 SEO 有影响吗？

不影响。零宽字符不属于可见文本，且默认对搜索引擎蜘蛛不注入。

2. 会污染数据库吗？

不会。盲水印在渲染时动态注入，数据库中的帖子原文保持不变。

3. 为什么解码提示「签名校验失败」？

水印密钥被修改，或内容被增删导致 payload 变化。若仅密钥被改，用原密钥可正常解码。

4. 复制到微信 / 手机 App 后还能解码吗？

只要文本被完整保留（包含首尾零宽字符）即可解码；部分平台可能清洗特殊字符，导致水印丢失。

版本历史