witty-diagnosis-agent 0.5.0-beta → 0.6.0-beta

package/README.md

@@ -37,15 +37,15 @@ Witty 智能诊断 Agent 采用“Agent-Skill-工具-知识”四层解耦架构
 - **Skill 层**：将专家排查流程封装为可复用的诊断技能（如 OOM、死锁排查）。
 - **知识底座**：内置 openEuler 专属故障模式与因果规则，持续自我进化。
 
-#### 3. 核心诊断场景
+#### 3. 核心诊断能力
 
 深度结合 openEuler 操作系统特性，目前已支持：
 
-- **内核级诊断**：自动化采集解析 VMCore，精准回溯系统崩溃（Crash/Panic）调用栈。
-- **系统级诊断**：针对磁盘 I/O、网络丢包、内存碎片等资源瓶颈提供多维关联分析。
-- **进程级诊断**：深度诊断进程死锁、僵尸进程及服务超时等逻辑异常。
+- **用户态诊断**：诊断进程 coredump、文件描述符泄漏、系统调用异常、IPC/资源耗尽、Unix Socket/Pipe、容器（Docker）、时间同步与安全认证等进程/服务层逻辑异常。
+- **内核级诊断**：自动解析VMCore，精准回溯内核崩溃（Crash/Panic）调用栈；覆盖 OOM、CPU 调度、文件系统（EXT4/XFS/OverlayFS）、Swap 抖动，以及块设备 IO 与网络协议栈等内核子系统故障。
+- **硬件级诊断**：基于 iBMC 带外日志与 OS 信息采集，定位 CPU/内存/磁盘/GPU/NPU/网卡/电源等部件的物理故障（ECC/MCE、坏道、掉卡、链路不稳、供电异常等），并提供磁盘健康预测与 GRUB 启动链故障诊断。
 
-> 💡 **更多基于 OS 全栈（硬件层 -> 内核层 -> 系统服务层）的诊断能力持续演进中...**
+> 💡 诊断能力详情，请参见[功能列表](docs/reference/features.md)。
 
 ---
 
@@ -53,8 +53,7 @@ Witty 智能诊断 Agent 采用“Agent-Skill-工具-知识”四层解耦架构
 
 #### 环境要求
 
-- 运行环境：Node.js (>=20.0.0)
-- 依赖工具：已安装[OpenCode](https://opencode.ai/)
+- 依赖框架：已安装[OpenCode](https://opencode.ai/)(运行环境：Node.js >= 20.0.0) 或 [xiaoO](https://gitcode.com/openeuler/xiaoO/)(运行环境：Rust 工具链和 Cargo)
 - 依赖工具：已安装 [Ansible](https://docs.ansible.com/ansible/latest/installation_guide/)（`ansible` 命令须在系统 PATH 中可用，可通过 `ansible --version` 提前验证）
 
 > ⚠️ **注意**：执行 `witty-diagnosis-agent install` 前，请确保本地已完成 Ansible 的安装与环境配置，否则安装程序将直接终止。
@@ -80,9 +79,19 @@ cd witty-diagnosis-agent
 bash install.sh
 ```
 
+##### 方式三：离线包一键安装（适用于离线情况）
+
+如果您已经下载了源代码安装包，可以使用一键安装脚本自动完成环境检查、依赖安装、项目构建及插件配置，以 witty-diagnosis-agent-v0.6.0-beta.tar.gz 压缩包为例：
+```shell
+tar -xzvf witty-diagnosis-agent-v0.6.0-beta.tar.gz
+cd witty-diagnosis-agent-v0.6.0-beta
+bash install.sh
+```
+
 ---
 
 ### 如何使用
+#### 基于opencode框架启动
 
 1. 启动 \*\*OpenCode \*\*。
 
@@ -104,7 +113,29 @@ bash install.sh
    
    <img src="docs/assets/guide_auto_diag_report.png" alt="诊断报告" width="800" />
 
-如需了解更多操作细节，可查阅[用户手册](docs/guide/MANUAL.md)；支持的诊断能力与功能说明详见[功能列表](docs/reference/features.md)。
+如需了解更多操作细节，可查阅[用户手册](docs/guide/MANUAL.md)。
+
+#### 基于xiaoO框架启动
+1. 启动 \*\*xiaoO \*\*。
+
+2. 使用`tab`键，切换`Xuanyuan`Agent。
+   
+   ![选择Xuanyuan Agent](docs/assets/xiaoO_select_xuanyuan.png)
+
+3. 输入故障问题描述，示例：
+   
+   ```shell
+   请诊断2026-03-05 14:31前最近一次硬盘故障，日志路径：/tmp/logs
+   ```
+   
+   <img src="docs/assets/xiaoO_guide_auto_diag_start.png" alt="wittywork命令" width="800" />
+
+4. 系统将自动执行**智能诊断**流程。
+
+5. 诊断完成后，系统将生成[HTML](docs/reference/reports/hard_disk_fault_diagnosis_report.html)和[Markdown](docs/reference/reports/hard_disk_fault_diagnosis_report.md)两种格式的诊断分析报告，同时在界面上展示完整报告内容：
+   
+   <img src="docs/assets/xiaoO_guide_auto_diag_report.png" alt="诊断报告" width="800" />
+
 
 ---
 
@@ -143,7 +174,7 @@ cat /proc/sys/kernel/core_pattern
 
 #### 2. 开发会产生 Core Dump 的示例 C 代码
 
-创建 `crash_demo.c` 文件：
+1）创建 `crash_demo.c` 文件：
 
 ```c
 #include <stdio.h>
@@ -161,32 +192,32 @@ int main() {
 }
 ```
 
-**安装编译工具和 GDB**：
+2）安装编译工具和 GDB：
 
 ```bash
 sudo apt update && sudo apt install -y gcc gdb
 ```
 
-**编译（禁用优化，开启调试符号）**：
+3）编译（禁用优化，开启调试符号）：
 
 ```bash
 gcc -g -O0 -o crash_demo crash_demo.c
 ```
 
-**运行**：
+4）运行：
 
 ```bash
 ./crash_demo
 ```
 
-执行后将触发段错误并产生 core dump 文件：
+5）执行后将触发段错误并产生 core dump 文件：
 
 ```
 Starting crash demo...
 Segmentation fault (core dumped)
 ```
 
-**查看生成的 core 文件**：
+6）查看生成的 core 文件：
 
 ```bash
 ls -la ./core.*
@@ -194,15 +225,15 @@ ls -la ./core.*
 
 #### 3. 在 WSL 中启动 OpenCode 并使用智能诊断 Agent 分析
 
-**启动 OpenCode**：
+1）启动 OpenCode：
 
 ```bash
 opencode
 ```
 
-**加载 Xuanyuan Agent**：执行 `/agents` 命令，选择 `Xuanyuan` Agent。
+2）加载 Xuanyuan Agent：执行 `/agents` 命令，选择 `Xuanyuan` Agent。
 
-**输入问题描述**：
+3）输入问题描述：
 
 ```
 分析/tmp/test目录下的core文件根因。
@@ -210,10 +241,36 @@ opencode
 
 > **提示**：将 `/tmp/test` 替换为示例 C 代码所在的实际目录路径。
 
-系统将自动执行智能诊断流程，分析进程崩溃原因并输出诊断报告。
+4）系统将自动执行智能诊断流程，分析进程崩溃原因并输出诊断报告。
 
 ---
 
+### 硬盘故障诊断示例
+
+#### 1. 环境准备
+
+1. 下载测试用例日志logs.zip（链接: https://pan.baidu.com/s/1-VlfKy5sx7LR-_tXkJ1G1A?pwd=bykf 提取码: bykf）；
+2. 将logs.zip拷贝到/tmp目录下并解压；
+
+#### 2. 使用智能诊断 Agent 分析
+
+1）启动 OpenCode：
+
+```bash
+opencode
+```
+
+2）加载 Xuanyuan Agent：执行 `/agents` 命令，选择 `Xuanyuan` Agent。
+
+3）输入问题描述：
+
+```
+请诊断2026-03-05 14:31前最近一次硬盘故障，日志路径：/tmp/logs
+```
+
+4）系统将自动执行智能诊断流程，分析硬盘故障原因并输出诊断报告。
+
+---
 
 ### 如何贡献
 

package/dist/{auto-update-checker-FE7T2BSB.js → auto-update-checker-K5BE2AWY.js}

@@ -7,8 +7,8 @@ import {
   isDistTag,
   isPrereleaseOrDistTag,
   isPrereleaseVersion
-} from "./chunk-4QO2HAQQ.js";
-import "./chunk-YVNTYBPS.js";
+} from "./chunk-35QAD47N.js";
+import "./chunk-NEHRAXKV.js";
 export {
   checkForUpdate,
   createAutoUpdateCheckerHook,