From 23dabfa7814bdfcc8fe80640433295414f39729a Mon Sep 17 00:00:00 2001 From: gitee-bot Date: Wed, 20 Aug 2025 01:36:28 +0000 Subject: [PATCH] Update README.md --- README.md | 38 ++++++++++++++++++++++++++++++++++++-- 1 file changed, 36 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 3dd3179..75f6caf 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,39 @@ + + # ShenNiusCPUTooHigh -#### 介绍 -基于dotnet开发的控制台程序,用来排查windows程序CPU过高的原因。基于进程id来排查具体线程,最后到堆栈,直至具体的方法。生成友好的html页面,方便快速的定位出问题所在。 +## 介绍 +这是一个基于 .NET 开发的控制台程序,用于排查 Windows 系统中 CPU 使用率过高的问题。通过指定进程 ID,该工具能够深入分析具体线程及其堆栈信息,最终定位到导致高 CPU 使用率的方法,并生成直观的 HTML 报告以便快速定位问题。 + +## 功能特性 +- **基于进程 ID 进行分析**:通过指定进程 ID,程序可以针对性地分析该进程的线程和性能数据。 +- **线程和堆栈信息**:程序会获取每个线程的详细信息,包括调用堆栈和 CPU 使用时间。 +- **性能计数器支持**:集成性能计数器功能,用于监控线程的 CPU 占用情况。 +- **HTML 报告生成**:将分析结果以 HTML 页面的形式展示,使问题定位更加直观。 + +## 使用方法 +1. **启动程序**:运行程序时传入进程 ID 和是否启用性能计数器标志。 + ```bash + CpuIsHigh.exe + ``` + - ``:目标进程 ID。 + - ``:是否启用性能计数器(`true` 或 `false`)。 + +2. **分析结果**:程序运行后,会生成一个 HTML 报告,展示线程的调用堆栈和 CPU 使用情况。 + +## 开发与调试 +- **依赖工具**:需要 .NET Framework 支持。 +- **调试支持**:程序使用了 `MDbgEngine` 和 `MDbgProcess` 类来进行调试,确保能够正确附加到目标进程并获取调用堆栈信息。 + +## 注意事项 +- 该工具仅适用于 Windows 平台。 +- 为确保性能计数器正常工作,请确认目标进程已被正确配置并允许性能监控。 + +## 开源许可 +本项目遵循开源协议,具体信息请参阅 [LICENSE](LICENSE) 文件。 + +## 贡献者 +欢迎贡献代码或改进建议。请参阅项目 [Gitee 页面](https://gitee.com/shenniu_code_group/shen-nius-cputoo-high) 提交 issue 或 PR。 +## 致谢 +感谢所有为本项目提供帮助和贡献的开发者。 \ No newline at end of file -- Gitee