SunnyNet WPF

SunnyNet WPF 是基于 SunnyNet Go 核心的 Windows 抓包分析工具。项目使用 C# + WPF 重绘桌面界面，核心抓包、代理、脚本、证书与协议处理仍由 Go 后端提供，并以 c-shared DLL 方式供 WPF 直接调用。

仓库地址：https://github.com/hmlyn/SunnyNet-wpf

作者：hmlyn

仓库描述：

SunnyNet WPF 是基于 SunnyNet Go 核心的 Windows 抓包分析工具，使用 C# + WPF 重绘界面，支持 HTTP/HTTPS、WebSocket、TCP/UDP、断点拦截、重放、请求规则、请求构造器、MCP 与常用调试工具。

功能概览

• Windows x64 桌面应用，界面层使用 WPF，运行产物为 SunnyNet.exe。
• Go 后端编译为 backend/SunnyNetBridge.dll，WPF 通过 P/Invoke 直接调用 SunnyNet 核心能力。
• 仓库已随项目分发 SunnyNet 核心兼容源码，后端通过本地 replace 引用，不再依赖额外手动准备核心源码。
• 支持 HTTP/HTTPS、WebSocket、TCP、UDP 会话捕获、筛选、查看和分析。
• 支持进程筛选、域名筛选、会话收藏、备注、标记颜色、列宽记忆和窗口布局记忆。
• 支持会话比较视图，可拖入两条会话对比请求/响应差异，并显示哈希摘要。
• 支持请求/响应 XML 视图，内容匹配 XML 时自动显示，避免无关视图占用空间。
• 支持 TLS 指纹视图，可查看 JA3、JA3N、JA4、JA4-R、Akamai 等指纹信息。
• 支持断点拦截、普通重发、运行到结束、断开连接，以及请求/响应内容修改。
• 支持请求规则中心，包括请求断点、HTTP/WebSocket/TCP/UDP 屏蔽、请求重写、请求映射。
• 支持请求构造器，可自行构造 GET/POST 等请求，支持协议头/Body 多视图编辑、从会话列表回填重放和历史记录缓存。
• 支持会话右键复制请求代码，包含 C#、Java、Go、Python、JavaScript、易语言、火山等模板。
• 支持全局查找、查找替换、请求/响应文本高亮，查找窗口命中后可联动右侧详情视图。
• 支持 WebSocket 消息流、主动发送、消息重放、HEX/原文/JSON/Protobuf 视图。
• 支持 TCP/UDP 专用数据视图，避免复用 HTTP/WebSocket 视图造成信息冗余。
• 支持脚本扩展，可在脚本中处理、解密或转换数据，并写入显示层明文，不破坏原始请求/响应数据。
• 内置文本工具、JSON 结构编辑器、加密/解密工具、开源协议与赞赏页面。
• 文本工具支持 Base64/Base64URL、URL、UCS2、常用压缩解压、文本差异、文本去重、大小写转换、时间戳转换等。
• 加密/解密工具支持 AES/DES/RSA、常用哈希、HMAC，并支持文本/Base64/HEX/Base64URL 输入输出。
• 支持 GitHub Release 检查更新，可自动检测新版本并打开发布页。
• 支持 SunnyNet MCP，可让 AI 会话读取、搜索、标记、收藏、备注、查看 TLS 指纹和分析抓包会话。

最新版本

当前发布版本：v0.1.7

发布包命名：

SunnyNet-wpf-v0.1.7-win-x64.zip
SunnyNet-wpf-v0.1.7-win-x64-self-contained.zip

Release 包含 Windows x64 可运行程序、WPF 主程序、Go 后端 DLL、随程序运行所需资源，以及可选 MCP 桥接程序。普通包需要本机安装 .NET Desktop Runtime；自包含包内置运行时，不依赖用户机器上的 .NET 版本。

本次核心更新

• 请求重写新增响应 JSON 键值改写，支持按路径设置或删除嵌套字段，例如 Data.User.IsInsider=true、Data.Membership.Role=7。
• JSON 响应重写采用路径级替换，尽量保留原始响应结构，并自动修正响应长度、压缩等相关协议头。
• 规则中心新增/编辑规则窗口改为普通窗口模式，编辑规则时可继续点击主窗口或其它工具窗口查看上下文。
• 请求规则继续保留请求断点、HTTP/WebSocket/TCP/UDP 屏蔽、请求重写、请求映射等能力。

目录结构

• backend/：Go 后端桥接层，编译为 backend/SunnyNetBridge.dll。
• third_party/SunnyNet/：随仓库分发的 SunnyNet Go 核心兼容源码。
• src/SunnyNet.Wpf/：WPF 桌面程序源码。
• docs/：项目文档，例如 MCP 工具清单。
• sunnymcptool/：可选的上游 MCP 工具源码目录，默认不随仓库提交，需自行克隆。
• _toolchain/：可选本地工具链目录，例如 Zig。
• build-debug.bat：Debug 构建脚本，输出到 artifacts/Debug/。
• build-release.bat：Release 构建脚本，输出到 artifacts/Release/，并移除 pdb。

编译环境

必须环境：

• Windows 10/11 x64
• .NET SDK 8.0+
• Go 1.24.x
• Zig 0.15.2 或兼容版本，用于让 Go 生成 Windows 可加载的 c-shared DLL
• Git

推荐环境：

• Visual Studio 2022，用于打开、调试 WPF 项目。
• PowerShell 7 或 Windows PowerShell，用于运行构建脚本和 MCP 构建脚本。

可选环境：

• sunnymcptool，用于打包 MCP 桥接程序。

运行环境：

• 普通发布包 SunnyNet-wpf-v*-win-x64.zip 需要安装 .NET Desktop Runtime 8.0 或更高主版本。程序已启用 RollForward=LatestMajor，如果本机没有 .NET 8 Desktop Runtime，但存在兼容的更高主版本 Desktop Runtime，也允许继续启动。
• 自包含发布包 SunnyNet-wpf-v*-win-x64-self-contained.zip 已内置 .NET Desktop Runtime，用户无需单独安装 .NET，适合直接分发给普通用户。

SunnyNet 核心分发说明

项目已随仓库分发 SunnyNet Go 核心兼容源码：

third_party/SunnyNet

当前 backend/go.mod 使用本地 replace：

replace github.com/qtgolang/SunnyNet => ../third_party/SunnyNet

这样首次拉取仓库后即可直接编译后端，也方便项目维护必要的核心层补丁。后续如果 SunnyNet 核心需要增强或修复，建议在 third_party/SunnyNet 内维护兼容补丁，并同步验证 WPF 调用链。

获取源码

git clone https://github.com/hmlyn/SunnyNet-wpf.git
cd SunnyNet-wpf

仓库当前不依赖 Git submodule，third_party/SunnyNet 已在仓库内分发。

Zig 准备

两种方式任选一种。

方式一：安装 zig 并加入 PATH：

zig version

方式二：将 Zig 解压到项目本地路径：

_toolchain/zig-x86_64-windows-0.15.2/zig.exe

项目会优先使用本地 _toolchain，如果不存在则使用 PATH 中的 zig。

MCP 准备

MCP 是可选项。若需要把 MCP 桥接程序一起打包，请在项目根目录旁准备上游 sunnymcptool：

git clone https://github.com/a121400/sunnymcptool.git
cd sunnymcptool
.\scripts\build.ps1 -Target mcp

编译后应存在：

sunnymcptool/build/bin/sunnynet-mcp.exe

WPF 构建时会自动复制到运行目录：

mcp/sunnynet-mcp.exe

如果没有该文件，主程序仍可编译运行，只是 MCP 功能不可用。

编译方式

Debug：

build-debug.bat

Release：

build-release.bat

也可以直接使用：

dotnet build .\SunnyNet.sln -c Debug
dotnet build .\SunnyNet.sln -c Release

建议发布包使用 build-release.bat，因为该脚本会输出到固定目录，并删除 pdb 文件。

输出位置

使用脚本构建后：

artifacts/Debug/SunnyNet.exe
artifacts/Release/SunnyNet.exe

使用 dotnet build 默认构建后：

src/SunnyNet.Wpf/bin/Debug/net8.0-windows/SunnyNet.exe
src/SunnyNet.Wpf/bin/Release/net8.0-windows/SunnyNet.exe

运行时主程序会加载同目录下的 Go 后端 DLL：

backend/SunnyNetBridge.dll

如果启用了 MCP，还会加载：

mcp/sunnynet-mcp.exe

发布打包

推荐流程：

build-release.bat

脚本会生成两个输出目录：

artifacts/Release/
artifacts/Release-self-contained/

并自动生成两个 zip：

SunnyNet-wpf-v0.1.7-win-x64.zip
SunnyNet-wpf-v0.1.7-win-x64-self-contained.zip

普通包体积小，但依赖本机 .NET Desktop Runtime；自包含包体积更大，但不受用户机器已安装 .NET 版本影响。

常见问题

如果提示找不到 Zig：

• 确认 zig version 可以在 PowerShell 中正常执行。
• 或确认本地路径 _toolchain/zig-x86_64-windows-0.15.2/zig.exe 存在。

如果 Go 后端 DLL 没有生成：

• 确认已经安装 Go 1.24.x。
• 确认 Zig 可用。
• 确认 third_party/SunnyNet 目录存在。
• 重新运行 build-debug.bat 或 build-release.bat。

如果 MCP 文件没有出现在编译产物里：

• 先编译 sunnymcptool 的 MCP 目标。
• 确认 sunnymcptool/build/bin/sunnynet-mcp.exe 存在。
• 重新运行 build-debug.bat 或 build-release.bat。

文档

• docs/MCP工具清单.md：当前 WPF 版支持的 MCP 工具、参数与返回字段说明。

开源协议

SunnyNet WPF 版采用 MIT 协议开源。你可以自由使用、复制、修改、合并、发布、分发或二次开发本项目，但需要保留原始版权声明和协议声明。

本项目仅用于合法的网络调试、接口分析、测试与技术研究场景。请勿将本工具用于未授权抓包、绕过访问控制、攻击或其它违法用途。