zhuque-detect

name	zhuque-detect
description	用腾讯朱雀检测一段中文文本是否 AI 生成，并导出官方「AI 生成检测报告单」PDF。当用户想检测文章/作文/论文的 AI 率、查 AIGC 占比、或要朱雀检测报告时使用。需本机真实 Chrome（带登录态）。

朱雀 AI 检测（zhuque-detect）

把一段中文文本喂给腾讯朱雀（matrix.tencent.com/ai-detect），拿到 AI 生成检测结果，并导出与产品「下载报告」一致的官方检测报告单 PDF（含环形图、AI 分布图、片段解析表、逐段 AIGC 值与原文）。

何时使用

• 用户想知道某段文本「像不像 AI 写的」/ AI 率 / AIGC 占比
• 用户要朱雀的检测报告 PDF
• 批量自检自己产出的文案是否会被判为 AI

前置依赖

1. Node 18+，在 scripts/ 下装一次依赖：npm install（只装 playwright-core，不下载浏览器）。
2. 本机真实 Chrome，且用调试端口启动（关键——见下方「为什么必须连真机」）：

   # macOS
   open -a "Google Chrome" --args --remote-debugging-port=9222
   # Linux
   google-chrome --remote-debugging-port=9222
   # Windows
   chrome.exe --remote-debugging-port=9222
   

   该 Chrome 需能正常打开 matrix.tencent.com/ai-detect 并手动跑通检测（朱雀匿名即可用，有每日免费额度）。

用法

cd scripts
npm install                      # 一次
node run.mjs                     # 默认 sample.txt → reports/朱雀报告单-<时间>.pdf
node run.mjs ./my.txt ./out.pdf  # 自定义输入文本 / 输出路径

调试端口非 9222 时用 ZHUQUE_CDP=http://127.0.0.1:PORT node run.mjs。

工作原理（要点）

• 检测走 WebSocket，签名由页面运行时按真实浏览器环境实时生成 fp/ARGUS_XSS_V3 令牌。空白自动化 chromium 无有效令牌 → Invalid request。连你已登录的真机即天然带齐令牌，故脚本用 connectOverCDP 接管真机、新开标签页跑。
• 「下载报告」是隐藏 iframe 调 contentWindow.print()（原生打印框，脚本点不动、还冻结页面）。脚本劫持该 iframe 的 print，截获其报告单 HTML，注入 <base> 后用 CDP Page.printToPDF 渲染成等价 PDF —— 全程不弹原生框。

详见 reference/anti-bot-notes.md。

约束 / 注意

• 文本须 ≥350 字，否则朱雀报「检测文本长度需大于350字」。
• 有每日检测次数额度（页面「今日剩余 N 次」），用完次日重置。
• 滑块验证码：冷启动 / 陌生会话（如全新 profile）偶发腾讯滑块验证。脚本会识别并提示——在弹出的 Chrome 窗口手动拖动完成后重跑即可。用你日常常用、已建立信任的 Chrome 一般不触发。
• 仅供个人学习与自检使用，遵守朱雀服务条款，勿规模化滥用。