Agent环境检测工具

一个面向 Windows 用户的 Agent 工具安装环境检测程序，用于在安装或运行 Codex、Claude Code、OpenCode、OpenClaw 等开发者 Agent 工具前，快速检查本机基础环境是否就绪。

它适合交付、售前支持、培训现场、企业内网部署前置检查等场景，帮助用户先确认系统组件、安装链路和常用开发依赖是否正常。

功能特性

• 一键检测 Windows 版本、管理员权限、HTTPS 网络、系统服务、Microsoft Store、App Installer / winget 等基础环境
• 检测 Git 是否安装
• 检测 Node.js 是否安装
• 支持通过 winget 一键安装 Git 和 Node.js
• 检测 WebView2 Runtime、VC++ Runtime、临时目录写入权限、磁盘空间等常见问题
• 支持自动修复部分系统组件和运行环境
• 支持导出检测报告，便于远程排障或交付留档
• 现代化 Windows 桌面界面
• 内置专属应用图标

适用场景

• 安装 Agent / CLI 工具前的环境预检
• 判断一台 Windows 电脑是否具备基础开发工具运行条件
• 企业现场交付前批量排查环境问题
• 给非技术用户提供可视化的一键检测入口
• 远程支持时快速收集检测报告

检测项目

当前版本包含以下检测项：

• 管理员权限
• Windows 版本
• .NET Framework 运行环境
• 基础 HTTPS 网络
• AppXSvc、ClipSVC、InstallService、BITS、wuauserv 等系统服务
• App Installer / winget
• winget 源
• Git
• Node.js
• Microsoft Store 包
• Shell.Application COM 环境
• Microsoft Edge WebView2 Runtime
• VC++ 2015-2022 x64 Runtime
• 临时目录写入权限
• 系统盘可用空间

使用方式

1. 下载并运行 Agent环境检测工具.exe
2. 点击「一键检测」
3. 根据检测结果查看异常项
4. 如果存在可修复项目，点击「自动修复」
5. 如需留档或远程协助，点击「导出报告」

建议使用管理员权限运行本工具，这样自动修复系统组件时成功率更高。

自动安装说明

当检测到 Git 或 Node.js 未安装，且本机 winget 可用时，工具会提供自动安装能力：

winget install --id Git.Git --exact --accept-package-agreements --accept-source-agreements
winget install --id OpenJS.NodeJS.LTS --exact --accept-package-agreements --accept-source-agreements

如果 winget 不可用，请先修复或安装 Microsoft App Installer。

构建方式

本项目为 .NET Framework WinForms 程序，可以使用 Windows 自带的 .NET Framework 编译器构建：

C:\Windows\Microsoft.NET\Framework\v4.0.30319\csc.exe `
  /target:winexe `
  /platform:x86 `
  /optimize+ `
  /out:Agent环境检测工具.exe `
  /win32manifest:CodexInstallEnvChecker.manifest `
  /win32icon:AgentEnvChecker.ico `
  /reference:System.Windows.Forms.dll `
  /reference:System.Drawing.dll `
  /reference:System.Management.dll `
  /reference:System.ServiceProcess.dll `
  CodexInstallEnvChecker.cs

项目结构

.
├── CodexInstallEnvChecker.cs          # 主程序源码
├── CodexInstallEnvChecker.manifest    # 管理员权限 manifest
├── AgentEnvChecker.ico                # 应用图标
└── README.md

技术栈

• C#
• .NET Framework
• Windows Forms
• WMI / Registry / ServiceController
• winget

注意事项

• 本工具仅面向 Windows 10 / Windows 11。
• 自动修复操作可能会调用系统命令、PowerShell、winget 或 Microsoft 官方安装入口。
• 某些修复动作需要管理员权限。
• 企业内网、防火墙、代理或组策略可能影响 winget、Microsoft Store、WebView2 等组件的检测和修复。
• 本工具不会上传任何检测数据，导出的报告保存在用户本地。

免责声明

本工具用于辅助诊断和修复常见 Windows Agent 工具安装环境问题。使用自动修复功能前，请确认你理解相关系统操作可能带来的影响。作者不对因系统配置、网络策略、第三方组件安装失败等原因造成的问题承担责任。

作者

开发者：Dontdrunk

GitHub: https://github.com/Dontdrunk