| 模块 | 说明 |
|---|---|
| 🖥️ 首页 | 系统关键信息概览（版本、CPU、内存、启动时间）、最近崩溃记录，双击查看详情 |
| 📄 转储分析 | 解析 .dmp 文件（MDMP 小转储 / PAGE 内核转储），提取崩溃代码、参数、异常信息、时间、系统版本，生成分析报告 |
| 🔍 系统扫描 | 检查关键事件日志（BugCheck、WHEA、磁盘错误、内存诊断）、SMART 健康状态、磁盘空间、崩溃转储文件、待重启状态 |
| 🤖 AI 诊断 | 对接任意 OpenAI 兼容 API（OpenAI / DeepSeek / 智谱 / Moonshot / 通义 / SiliconFlow / Ollama 等），流式输出问题定位与解决方案 |
| ⚙️ 设置 | 配置 API 地址、密钥、模型、温度与系统提示词（存储于 %LOCALAPPDATA%\BlueScreenHelper\settings.json） |
- MDMP（Minidump）：
MDMP签名的用户态小转储，含异常信息、模块列表、线程栈 - 内核转储（PAGE 格式）：Windows 蓝屏生成的
PAGE/DU64头部转储，支持全部类型（1/5 完整内存、2/6 内核内存、3 仅头部、4 Triage、7 自动） - 解析
DUMP_HEADER64头部：BugCheckCode、4 个参数、机器类型、系统版本（内部版本号）、DumpType、SystemTime、Comment - 内置 BugCheck 知识库（数百个错误代码），错误码 → 名称 / 类别 / 原因 / 解决方案
- 崩溃参数按错误码逐位注解（WinDbg
!analyze -v风格） - 字节级解析验证与 WinDbg 头部数据同源，无需安装 WinDbg / dbgeng.dll
| 类别 | 技术 |
|---|---|
| UI 框架 | WinUI 3（Windows App SDK 2.4.0） |
| 语言 | C#（LangVersion latest，Nullable + ImplicitUsings） |
| 运行时 | .NET 10（net10.0-windows10.0.19041.0，最小平台 10.0.17763.0） |
| 打包方式 | 未打包桌面应用（WindowsPackageType=None），自包含部署 |
| 平台支持 | x86 / x64 / ARM64（默认 x64，csproj 内处理 AnyCPU → x64 映射） |
| 系统 API | System.Diagnostics.EventLog、System.Management（WMI / SMART） |
| 转储解析 | 自研二进制解析（MDMP + PAGE/DU64），零第三方依赖 |
| AI 集成 | OpenAI 兼容 Chat Completions API（SSE 流式输出） |
| 安装程序 | Inno Setup 6（installer/installer.iss） |
| CI/CD | GitHub Actions（.github/workflows/build.yml） |
<PackageReference Include="Microsoft.WindowsAppSDK" Version="2.4.0" />
<PackageReference Include="System.Diagnostics.EventLog" Version="10.0.11" />
<PackageReference Include="System.Management" Version="10.0.11" />BlueScreenHelper/
├── .github/workflows/build.yml # CI：构建 + 打标签时自动打包并上传 Release
├── BlueScreenHelper.slnx # 解决方案（构建请用 csproj，勿对 slnx）
├── installer/
│ ├── installer.iss # Inno Setup 安装脚本
│ └── Languages/ # 中文语言文件（离线可用）
└── BlueScreenHelper/
├── App.xaml(.cs) # 应用入口，MainWindow 静态属性、导航注册
├── MainWindow.xaml(.cs) # 主窗口 + 侧边导航 + 窗口图标
├── Assets/app.ico # 应用图标（多尺寸）
├── app.manifest # 权限声明
├── BlueScreenHelper.csproj # 项目文件（AnyCPU→x64 映射）
│
├── Models/ # 数据模型
│ ├── AppSettings.cs # 应用设置（API Key 等）
│ ├── BugCheckInfo.cs # BugCheck 条目（错误码/名称/类别/原因/方案）
│ ├── DumpAnalysisResult.cs# 转储解析结果
│ └── ScanIssue.cs # 扫描问题项 + 崩溃记录
│
├── Services/ # 业务逻辑（静态服务）
│ ├── DumpParser.cs # .dmp 解析（MDMP + PAGE 内核/Triage 转储）
│ ├── BugCheckDatabase.cs # 蓝屏错误码知识库
│ ├── SystemScanner.cs # 系统扫描
│ └── AIService.cs # AI 诊断（OpenAI 兼容 API，流式）
│
└── Views/ # 页面（XAML + code-behind）
├── DashboardPage # 首页：系统概览 + 崩溃记录
├── DumpPage # 转储分析
├── ScannerPage # 系统扫描
├── AIPage # AI 智能诊断对话
└── SettingsPage # 设置：API 配置
架构为轻量 MVVM 变体：Views 页面 + Services 无状态静态服务 + Models 数据类，页面通过 App.MainWindow.NavigateTo 切换，崩溃上下文经 AppState.PendingAI 传递至 AI 页。
从 Releases 下载 BlueScreenHelper_Setup_<版本>_win-x64.exe：
- 自包含发布，无需安装 .NET 运行时
- 适用于 x64 Windows 10 1809+ / Windows 11
- 支持静默安装：
BlueScreenHelper_Setup_1.0.1_win-x64.exe /VERYSILENT - 首次运行若出现 SmartScreen 提示，选择「仍要运行」即可
- 打开「转储分析」页，选择
C:\Windows\Minidump\*.dmp（小转储）或C:\Windows\MEMORY.DMP（内核转储）→ 自动解析显示崩溃代码、参数注解、时间、系统版本与转储类型 - 「系统扫描」页点击「开始扫描」，逐项检查事件日志、磁盘健康（SMART）、磁盘空间与转储文件
- 「设置」页填写 AI API 地址（如
https://api.deepseek.com/v1）、密钥与模型，然后在「AI 诊断」页提交崩溃报告获取解决方案（支持本地 Ollama：http://localhost:11434/v1）
要求：.NET SDK 10+（或 VS 2022 17.14+）。
# 构建（注意：直接构建项目文件，不要对解决方案构建）
dotnet build BlueScreenHelper/BlueScreenHelper.csproj
# 构建前若提示文件被占用（MSB3021），先关闭正在运行的应用：
Stop-Process -Name BlueScreenHelperWinUI 3 未打包应用要求明确平台，csproj 已内置
AnyCPU → x64映射，因此必须直接构建 csproj，对BlueScreenHelper.slnx执行dotnet build会失败。
dotnet publish BlueScreenHelper/BlueScreenHelper.csproj -c Release -r win-x64 --self-contained true产物位于 publish/win-x64/，可拷贝到任意 x64 Windows 10 1809+ 机器直接运行。
# 1. 发布（同上）
# 2. 安装 Inno Setup 6 后用 ISCC 编译
& "$env:LOCALAPPDATA\Programs\Inno Setup 6\ISCC.exe" installer\installer.iss产物位于 dist/BlueScreenHelper_Setup_<版本>_win-x64.exe。
推送 v* 标签（如 git tag v1.0.1 && git push --tags）后，CI 会自动完成构建 → 发布 → Inno Setup 打包 → 上传至 Release 页面。
- 转储解析为自研二进制解析，不依赖 WinDbg / dbgeng.dll
- 内核转储（Triage 类型）不包含模块列表，此时故障驱动模块字段为空，属正常现象
- 扫描仅读取系统信息与事件日志，不做任何修改
- AI 密钥仅保存在本机
%LOCALAPPDATA%\BlueScreenHelper\settings.json，不上传；请勿将 settings.json 提交到版本库
Made with ❤️ by Memories-white