QScope 0.2.0

QScope 0.2.0 版本发布。

本版本带来两大核心升级：正式支持 macOS (Apple Silicon) 与 探针动态特征寻址。

核心亮点

1. 正式支持 macOS (Apple Silicon)：
   • 新增 macOS 原生 MSF 探针与沙盒环境隔离，支持免安装自动拉取并准备官方 QQ 副本。
   • 提供原生 .app、DMG 安装包与独立 CLI，支持 Ed25519 签名的在线安全更新。
   • 现已支持 Windows 与 macOS 双端完整双向 MSF 协议抓包、切片录制与本地 WebUI 调试。
2. 探针动态特征寻址（脱离固定偏移硬编码）：
   • Windows 与 macOS 两端探针全面引入动态符号与特征扫描（Windows PE 异常表/代码引用定位，macOS Mach-O 切片扫描），不再按版本硬编码 RVA 偏移。
   • 版本兼容性：理论上可直接兼容其他相近版本的 QQNT。目前已完成严格双向收发验证与自动化准备的版本为：
     • Windows x64：QQNT 9.9.37-54395
     • macOS Apple Silicon：QQ 7.0.3-54395

工程与规范改进

• 开源协议明确：全仓正式确立采用 GNU General Public License v3.0 (GPL-3.0)，严格保障开源 Copyleft 与反闭源套壳。
• 跨平台 CI 流水线：GitHub Actions 全面接入 Windows + macOS 跨平台自动化测试、构建与更新签名发布流程。
• 文档与规范重构：优化 README 与 Agent 规范，明确 Git 提交规范与代码注释标准；修复 Windows 中文路径下的解包兼容性。

Full Changelog: v0.1.1...v0.2.0

QScope 0.1.1

QScope 0.1.1 版本发布。

这个版本主要修复 0.1.0 发出后发现的几个硬伤，重点解决研究 QQ 退出与更新流程冲突的问题，并完善了 CLI 和内置 Skill。

变更内容

• 研究 QQ 退出与生命周期管理：
  • 「设置 → QQ 抓包」新增「关闭 QQ」按钮，退出时向抓包流写入规范的结束标记。
  • 修复 qs qq stop 读取启动记录文件错误导致无法正常结束 QQ 的问题。
  • 关闭桌面端时，会自动退出由界面启动的研究 QQ（命令行 qs qq start 或 AI 独立启动的后台实例继续保留）。
• 更新流程平滑化：
  • 优化更新逻辑：先完成新版下载与签名校验，确认无误后再自动保存录制并退出运行中的研究 QQ，避免因进程占用导致更新中断。
  • qs update 在交互模式下会列出将被退出的后台任务；配合 --yes 无人值守执行时需显式传入 --close-tasks。
  • 安装器覆盖安装前增加确认提示，避免静默冲突。
• 界面与工具链改进：
  • 安装器目录选择弹窗改用 Windows 原生资源管理器文件夹选择器。
  • AI 技能设置页记住上次选择的配置项（作用域、项目路径等），隐藏冗余路径信息。
  • 补齐了 qs 命令行全部子命令与参数的帮助文档（--help），更新并完善内置 Agent Skill 契约。
• 开源协议明确：
  • 明确项目遵循 GNU GPL v3.0 开源协议（前端视觉组件衍生自 GPLv3 模块，严格遵循 Copyleft 传染性要求）。

从 0.1.0 升级说明

由于「自动退出后台任务并更新」是 0.1.1 引入的新逻辑，若你当前运行在 0.1.0，升级前旧版本仍会进行进程检查。
建议：在 0.1.0 界面点击更新前，先手动在系统托盘右键退出研究 QQ 并停止录制，再执行更新。升级至 0.1.1 之后，后续更新将自动处理后台进程。

Full Changelog: v0.1.0...v0.1.1

QScope 0.1.0

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