Skip to content

README.md

Latest commit

 

History

History
120 lines (84 loc) · 5.94 KB

README.md

File metadata and controls

120 lines (84 loc) · 5.94 KB

🩺 WinDiagDoctor (WDD)

Build Docker Image

智能 Windows 系统诊断专家 / Intelligent Windows Diagnostic Agent

⚠️ 注意：本项目当前仍处于早期开发阶段。

  • 架构稳定性：API 接口、通信协议（WebSocket/HTTP）以及数据模型可能会发生破坏性变更。
  • 功能完整性：目前主要实现了核心的日志诊断闭环，更多系统监控和修复功能正在开发中。
  • 生产环境：强烈不建议在生产环境或关键业务机器上部署，仅供学习、研究和测试使用。

在传统的 Windows 运维和故障排查中，用户可能面临以下问题：

  1. 门槛高：需要熟练掌握 PowerShell 命令或能够看懂晦涩的 Event Viewer（事件查看器）结果。
  2. 效率低：需要在海量的日志中手动筛选关键错误，耗时耗力。
  3. 远程难：当亲友或客户电脑出问题时，往往需要使用远程桌面工具，不仅带宽要求高，还依赖人工操作。

WinDiagDoctor 旨在打造一个基于大语言模型（LLM）的智能体。用户只需用自然语言描述问题（如“电脑刚才死机了”），由智能体自动调度远程探针，精准采集数据，并给出专业的诊断建议以及解决方案。

使用示例

✨ 功能特性

🧠 智能大脑 (Server)

  • Spring AI Alibaba 驱动：集成通义千问（Qwen）等高性能大模型，具备强大的意图理解和逻辑推理能力。
  • ReAct 智能体：内置 wdd-agent，采用 ReAct (Reasoning + Acting) 模式，能够自我思考、规划任务、调用工具并反思结果。
  • 可视化交互：集成 Spring AI Alibaba Studio，提供现代化的聊天界面，支持流式对话和思维链展示。
  • 多探针管理：支持多用户、多设备接入，通过 Dashboard 实时监控探针在线状态。
  • 数据优化：采用 TOON 格式传输日志，相比 JSON 节省大量的 Token 消耗，大幅提升 AI 分析窗口的容量。

📡 远程探针 (Probe)

  • 轻量级架构：基于 Spring Context 构建，资源占用低，静默运行。
  • 零配置部署：通过服务端动态生成的 ZIP 包分发，内含专属 ID 和密钥，下载即用，无需手动配置 IP。
  • 双向通信：
    • WebSocket：用于接收服务端的实时控制指令（心跳保活、任务下发）。
    • HTTP/REST：用于上传大体积的日志数据。

🛡️ 安全与隐私

  • Probe 认证：基于 Probe ID + Secret 的双重认证机制。
  • 按需采集：探针仅在收到 AI 指令时执行特定操作，不会在后台随意上传用户数据。
  • 数据脱敏（待开发）：探针在向服务器发送数据前，会先将数据中的敏感数据进行模糊处理。

⚡ 快速开始

前置要求

  • Docker, Docker Compose
  • 阿里云 DashScope API Key (推荐)

WDD 使用 OpenAI 兼容模式进行模型实例构建，所以你也可以选择其他兼容 OpenAI 格式的模型提供商，比如 ollama 等。

值得注意的是，如果需要修改模型提供商，你需要同时在配置中修改 AI_BASE_URL 以及 AI_MODEL 的值。

1. 启动服务端 (Server)

  1. 配置环境：

    # 1. 获取源码
git clone https://github.com/chrisis58/win-diag-doctor.git
cd win-diag-doctor

# 2. 复制模板并修改配置: 请按照指引修改 .env
cp .env.example .env

# 3. 启动 (首次运行需要构建)
docker compose up -d

    你也可以在项目 构建历史 中直接下载预构建的镜像。

  2. 访问 Dashboard：打开浏览器访问 http://localhost:8093/dashboard.html

2. 部署探针 (Probe)

  1. 在 Dashboard 页面中，点击右上角的 “下载探针” 按钮。
    • 推荐选择“完整版 (Full)”以包含必要的运行环境。
  2. 将下载的 ZIP 包解压到目标 Windows 机器上。
  3. 双击运行 WddProbe.exe。
  4. 回到 Dashboard 并刷新状态，页面中的探针状态应变为 ONLINE。

如果遇到了无法找到日志的情况，可以先尝试使用随可执行文件下载的脚本 setup-permissions.bat 为当前用户赋予系统日志的读权限。

3. 开始诊断

  1. 在 Dashboard 列表中，点击目标探针卡片上的 “进入诊断”。
  2. 系统会自动跳转到聊天界面。
  3. 输入问题：
    • “帮我看看昨天下午为什么电脑突然重启了？”
    • “最近 Chrome 浏览器总是闪退，查一下原因。”
  4. 查看结果：AI 将自动调用探针抓取日志，分析后给出诊断报告。

📋 架构概览

graph LR
    User[用户] -- Browser --> WebUI[Dashboard / Chat UI]
    WebUI -- HTTP --> Server[(WDD Server)]
    Server -- WebSocket (Command) --> Probe[(WDD Probe)]
    Probe -- HTTP POST (Data) --> Server
    Probe -- PowerShell --> Windows[Windows OS / Event Logs]
    Server -- API --> LLM[(LLM)]
Loading

⚖️ 声明

  1. 本项目涉及对 Windows 系统日志的读取。虽然代码开源且透明，但在使用过程中产生的数据泄露或隐私风险由使用者自行承担。
  2. 本工具提供的诊断建议由 AI 生成，可能存在幻觉或错误。在执行任何修复操作（如修改注册表、删除文件）前，请务必进行人工确认。
  3. 本项目不提供任何形式的明示或暗示担保。作者不对因使用本软件造成的任何系统损坏或数据丢失负责。
💬任何使用中遇到的问题、希望添加的功能，都欢迎提交 issue 交流！
⭐ 如果这个项目对你有帮助，请给它一个星标！