Skip to content

QScope 0.1.0

Choose a tag to compare

@github-actions github-actions released this 06 Nov 11:55
· 20 commits to main since this release
v0.1.0
faff28c

QScope 0.1.0 首个正式版本发布。

这是一个面向 Windows x64 QQ (NT 架构) 的原生协议抓包与逆向分析工具。目标是在不修改官方客户端二进制的前提下,从进程冷启动开始抓取未被改写的双向原始协议数据,并提供无 Schema 解码、多包 Diff 和分段切片能力。

核心功能

  • 启动期探针注入:基于 MSF-NG 被动探针,在 QQ 进程启动阶段挂载。从冷启动握手、扫码登录到后续业务收发包全程记录,原始字节 100% 保持原样,不篡改、不伪造。
  • 免安装沙盒隔离:启动时自动下载官方 9.9.37-54395 安装包并校验 SHA256,解包到独立私有目录,注册表与数据目录重定向,不影响本机日常使用的 QQ。
  • 无 Schema 协议解码:
    • Protobuf 支持按 field number、wire type 和原始字节范围展开,无损保留 64 位整数精度。
    • 支持 TLV16-BE 与 JCE/Tars 视图切换,字段树与 Hex 视图支持双向高亮联动定位。
  • 多包 Diff 与切片录制:
    • 支持选取 2~8 个数据包按字段树路径并排对齐 Diff,只展示差异字段。
    • 抓包过程中支持随时打标分段,单独导出为 .qscap 文件。
  • 多端体验与 CLI:Tauri 2 桌面端、纯浏览器 WebUI、独立 qscope-cli(支持注册全局 qs 命令),三者底层共用同一个本地 Rust 后台服务。
  • AI 协同:内置适配 Claude Code、Codex、Cursor 的 Agent Skill,支持让 AI 通过命令行自动化查询、解码与切片抓包。
  • 安全更新通道:在线更新清单基于 Ed25519 签名,安装包经 SHA256 校验。

发布文件说明

文件名 说明
QScope-0.1.0-windows-x64-setup.exe 推荐(安装版):桌面端 + CLI,安装时可勾选注册全局 qs 命令
QScope-0.1.0-windows-x64-portable.zip 便携版:解压即用,双击运行 QScope.exe
QScope-0.1.0-windows-x64-cli-webui.zip 轻量版:单个 qscope-cli.exe,包含命令行与内嵌 WebUI,适合脚本与无头环境
SHA256SUMS.txt 各发布文件的 SHA256 哈希校验清单

系统要求:Windows 10 / 11 x64。首次启动 QQ 时需联网下载约 319 MiB 的官方安装包。

已知限制与注意事项

  • 版本限制:当前仅适配 Windows x64 QQ 9.9.37-54395,偏移硬编码在该版本上。
  • 启动模式:探针只在启动阶段挂载,暂不支持附加到正在运行的 QQ 进程。
  • 退出问题:本版本 qs qq stop 读取启动记录有误可能无法关停进程,界面暂未提供「关闭 QQ」入口,如需退出请直接在任务栏托盘右键退出 QQ。
  • 开源许可与合规:
    • 本项目采用 GNU GPL v3.0 开源许可,遵循严格的 Copyleft 保护。
    • 请务必使用测试账号,接入客户端存在风控风险。
    • 严禁用于任何涉及红包、支付、转账、充值等金融相关场景,内置技能会直接拦截拒绝。
    • 抓包文件中包含真实消息与票据凭据,公开分享 .qscap 前请务必脱敏。

Full Changelog: https://github.com/sj817/QScope/commits/v0.1.0