朱雀 AI 检测（zhuque-detect）
把一段中文文本喂给腾讯朱雀（matrix.tencent.com/ai-detect），拿到 AI 生成检测结果，并导出与产品「下载报告」一致的官方检测报告单 PDF（含环形图、AI 分布图、片段解析表、逐段 AIGC 值与原文）。
何时使用
- 用户想知道某段文本「像不像 AI 写的」/ AI 率 / AIGC 占比
- 用户要朱雀的检测报告 PDF
- 批量自检自己产出的文案是否会被判为 AI
前置依赖
- Node 18+，在
scripts/下装一次依赖：npm install（只装playwright-core，不下载浏览器）。 - 本机真实 Chrome，且用调试端口启动（关键——见下方「为什么必须连真机」）：
bash # macOS open -a "Google Chrome" --args --remote-debugging-port=9222 # Linux google-chrome --remote-debugging-port=9222 # Windows chrome.exe --remote-debugging-port=9222
⚠️ Windows：若 Chrome 已在运行（普通模式），该参数不生效——必须先完全退出 Chrome 再启动。
本机一键启动脚本：E:\Workbuddy\zhuque-detect\1-启动Chrome调试端口.bat该 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>后用 CDPPage.printToPDF渲染成等价 PDF —— 全程不弹原生框。
详见 reference/anti-bot-notes.md。
约束 / 注意
- 文本须 ≥350 字，否则朱雀报「检测文本长度需大于350字」。
- 有每日检测次数额度（页面「今日剩余 N 次」），用完次日重置。
- 滑块验证码：冷启动 / 陌生会话（如全新 profile）偶发腾讯滑块验证。脚本会识别并提示——在弹出的 Chrome 窗口手动拖动完成后重跑即可。用你日常常用、已建立信任的 Chrome 一般不触发。
- 仅供个人学习与自检使用，遵守朱雀服务条款，勿规模化滥用。
本机部署记录（Windows 实测，2026-09-06）
- 安装位置：
C:\Users\Administrator\.workbuddy\skills\zhuque-detect（依赖已装好） - 本机 Chrome：
C:\Program Files\Google\Chrome\Application\chrome.exe（Chrome 152） - 一键脚本：
E:\Workbuddy\zhuque-detect\1-启动Chrome调试端口.bat→2-检测并导出报告.bat
（也可把 txt 直接拖到2-检测并导出报告.bat上；报告输出到E:\Workbuddy\zhuque-reports\）
相对上游版本已修的 3 个实测问题
browser.close()会把你的整个 Chrome 关掉（含所有窗口）。上游注释称"仅断开"，
实测跑完一次 Chrome 全退。已改为只关自建标签页、仅断开 WebSocket。- 默认 CDP 改
127.0.0.1：Windows 下localhost可能解析到::1，Chrome 只监听 IPv4 →ECONNREFUSED。 - 输入方式改为文件上传：朱雀新版页面已无
textarea（实测textareas: []），
只剩input[type=file]（accept.txt/.docx）→ 非 txt/docx 的输入自动转存临时 txt 再上传。 - 就绪判断重写：页面底部宣传百分比（98%/92%/85.71%）会误判，改用「检测中消失 + 结果信号」。
- 验证码不中断：实测是九宫格图片点选（非滑块），脚本识别后提示人工完成并继续等待，
不再直接退出。
当前已知阻塞（未验证到出报告）
- 实测页面提交按钮文案为「今日次数已用完」且
disabled→ 当日额度耗尽时必然失败，需次日或换已登录账号。 - 若页面 DOM 再次改版，
run.mjs的定位器仍需同步调整。
