witty-diagnosis-agent 0.1.0-beta → 0.3.1-beta

package/LICENSE

@@ -1,21 +1,68 @@
-MIT License
-
-Copyright (c) 2026 Huawei
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+License
+Portions of this software are licensed as follows:
+
+All third party components incorporated into the software are licensed under the original license
+provided by the owner of the applicable component.
+Content outside of the above mentioned files or restrictions is available under the "Sustainable Use
+License" as defined below.
+
+Sustainable Use License
+Version 1.0
+
+Acceptance
+By using the software, you agree to all of the terms and conditions below.
+
+Copyright License
+The licensor grants you a non-exclusive, royalty-free, worldwide, non-sublicensable, non-transferable license
+to use, copy, distribute, make available, and prepare derivative works of the software, in each case subject
+to the limitations below.
+
+Limitations
+You may use or modify the software only for your own internal business purposes or for non-commercial or
+personal use. You may distribute the software or provide it to others only if you do so free of charge for
+non-commercial purposes. You may not alter, remove, or obscure any licensing, copyright, or other notices of
+the licensor in the software. Any use of the licensor's trademarks is subject to applicable law.
+
+Patents
+The licensor grants you a license, under any patent claims the licensor can license, or becomes able to
+license, to make, have made, use, sell, offer for sale, import and have imported the software, in each case
+subject to the limitations and conditions in this license. This license does not cover any patent claims that
+you cause to be infringed by modifications or additions to the software. If you or your company make any
+written claim that the software infringes or contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If your company makes such a claim, your patent
+license ends immediately for work on behalf of your company.
+
+Notices
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these
+terms. If you modify the software, you must include in any modified copies of the software a prominent notice
+stating that you have modified the software.
+
+No Other Rights
+These terms do not imply any licenses other than those expressly granted in these terms.
+
+Termination
+If you use the software in violation of these terms, such use is not licensed, and your license will
+automatically terminate. If the licensor provides you with a notice of your violation, and you cease all
+violation of this license no later than 30 days after you receive that notice, your license will be reinstated
+retroactively. However, if you violate these terms after such reinstatement, any additional violation of these
+terms will cause your license to terminate automatically and permanently.
+
+No Liability
+As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will
+not be liable to you for any damages arising out of these terms or the use or nature of the software, under
+any kind of legal claim.
+
+Definitions
+The "licensor" is the entity offering these terms.
+The "software" is the software the licensor makes available under these terms, including any portion of it.
+"You" refers to the individual or entity agreeing to these terms.
+"Your company" is any legal entity, sole proprietorship, or other kind of organization that you work for, plus
+all organizations that have control over, are under the control of, or are under common control with that
+organization. Control means ownership of substantially all the assets of an entity, or the power to direct its
+management and policies by vote, contract, or otherwise. Control can be direct or indirect.
+"Your license" is the license granted to you for the software under these terms.
+"Use" means anything you do with the software requiring your license.
+"Trademark" means trademarks, service marks, and similar rights.
+
+---
+NOTICE: This project contains modified code from oh-my-openagent (code-yeongyu), which is licensed under the Sustainable Use License Version 1.0 above. Modifications were made to adapt it for the witty-diagnosis-agent project.

package/README.md

@@ -1,148 +1,116 @@
-# 项目介绍
+<div align="center">
+  <img src="docs/assets/witty-diagnosis-agent_logo.png" alt="Witty Diagnosis Agent Logo" width="600" />
+</div>
 
-Witty智能诊断Agent基于「假设-推断」分析范式与多Agent协同架构，实现多路径并行分析，全面覆盖**应用→系统→内核→硬件**全栈故障场景，显著提升故障诊断的效率、全面性与精准度。依托拓扑动态感知、多模态遥测融合与多维关联分析技术，结合内置故障模式库与运维知识库，可在分钟级完成根因定位（无需人工介入），并支持代码行级精准定界。同时，Agent能自动生成结构化根因报告，清晰呈现溯源路径、关键证据与优化建议，高效支撑各类复杂故障的精准诊断。
+Witty 智能诊断 Agent 基于「假设-验证」（Hypothetico-Deductive）故障排查范式与 Multi-Agent 协同架构，提供分钟级、代码行级的全自动故障诊断能力。
 
-# 架构与功能介绍
+- **全栈并发诊断**：支持跨系统、内核与硬件的多路径并行排查，彻底打破传统线性排查的效率瓶颈。
+- **专家经验封装**：内置多场景诊断技能与丰富故障模式库，固化专家级排查思路，实现根因精准穿透。
+- **端到端闭环自愈**：涵盖“现象分析、根因定界、生成报告、执行修复”全链路，提供一站式自动化运维。
+- **严格的安全管控**：诊断排查阶段严格只读，仅修复阶段按需赋予操作权限，且变更必经用户审批确认。
 
-## 软件架构
+### 架构与核心能力
 
-Witty智能诊断Agent采用分层解耦架构，分为Agent层、Skill层、工具层、知识层四大核心模块，各模块通过标准化接口通信，兼具灵活性与可扩展性，确保系统高效迭代与维护。
+Witty 智能诊断 Agent 采用“Agent-Skill-工具-知识”四层解耦架构，兼具高灵活性与可扩展性。
 
-### 1. Agent层：智能协同的推理引擎与决策中枢
+<div align="center">
+  <img src="docs/assets/architecture.png" alt="Diagnosis Agent架构图" width="640" />
+</div>
 
-采用多智能体协同机制，实现故障根因的全流程自动化诊断：诊断规划Agent（**伏羲 (Fuxi)**）明确故障信息并生成根因假设；编排调度Agent（**大禹 (Dayu)**）匹配诊断Skill，并行分发诊断任务；各验证分析Agent（**夸父 (Kuafu)**）执行具体推理分析；根因融合Agent（**白泽 (Baize)**）汇总多路分析结果，输出包含根因、证据链与修复建议的结构化报告；故障修复Agent依据根因与运维知识，安全可控地执行修复指令，快速恢复业务。
+#### 1. 多智能体协同 (Agent 层)
 
-### 2. Skill层：专家经验的标准化沉淀与场景化赋能
+采用流水线式机制实现诊断自动化：
 
-将专家诊断思路、排查流程与最佳实践，封装为可复用的标准化技能，覆盖崩溃、死锁、内存泄漏等高频故障场景。为Agent提供标准化执行策略，实现专家经验的规模化复用，提升诊断结果的一致性与准确性。
+- **Xuan Agent(总控)**：调度其它Agent协同完成故障诊断。
+- **Fuxi Agent (规划)**：基于现象生成结构化排查计划。
+- **Dayu Agent (调度)**：解析计划并并发调度给执行节点。
+- **Kuafu Agent (执行)**：加载专属 Skill 深入节点拉取指标与推理。
+- **Baize Agent (融合)**：汇总证据链，输出最终根因报告。
+- **Nuwa Agent (自愈)**：基于安全规则，自动生成并执行修复。
 
-### 3. 工具层：高效可靠的多源数据处理底座
+#### 2. 专家经验沉淀 (Skill & 知识层)
 
-深度集成openEuler原生观测与调试工具，以低底噪方式采集指标、日志、内核状态等多维度数据。通过清洗、去重、结构化处理，为上层诊断流程提供高质量数据输入，保障诊断过程的稳定性与高效性。
+- **Skill 层**：将专家排查流程封装为可复用的诊断技能（如 OOM、死锁排查）。
+- **知识底座**：内置 openEuler 专属故障模式与因果规则，持续自我进化。
 
-### 4. 知识层：持续进化与自我完善的知识底座
+#### 3. 核心诊断场景
 
-存储openEuler专属故障模式、诊断案例与因果规则，是精准诊断的核心基础。系统可自动沉淀诊断数据与结果，形成可复用案例并反哺Skill层优化，实现诊断能力的自进化迭代，让诊断精度随使用场景持续提升。
+深度结合 openEuler 操作系统特性，目前已支持：
 
-![Diagnosis Agent架构图](docs/assets/architecture.png)
+- **内核级诊断**：自动化采集解析 VMCore，精准回溯系统崩溃（Crash/Panic）调用栈。
+- **系统级诊断**：针对磁盘 I/O、网络丢包、内存碎片等资源瓶颈提供多维关联分析。
+- **进程级诊断**：深度诊断进程死锁、僵尸进程及服务超时等逻辑异常。
 
-## 关键能力
+> 💡 **更多基于 OS 全栈（硬件层 -> 内核层 -> 系统服务层）的诊断能力持续演进中...**
 
-- **智能日志解析**：基于模板挖掘、向量降维等算法，将海量非结构化日志转化为结构化特征，实现关键日志秒级精准识别，为根因分析提供高质量数据支撑。
+### 快速开始
 
-- **VMCore自动分析**：针对系统宕机等严重故障，自动完成VMCore数据的采集、融合分析与根因定位，将运维人员从复杂的手动调试工作中解放出来，提升故障处置效率。
-
-- **超节点拓扑动态感知**：基于eBPF技术实现灵衢超节点拓扑动态感知，将多模遥测数据与拓扑节点协同关联，辅助超节点故障的高效定界与定位。
-
-# 快速开始
-
-## 环境要求
-
-- 运行环境：Bun（推荐）或 Node.js
+#### 环境要求
 
+- 运行环境：Node.js (>=18.0.0)
 - 依赖工具：已安装[OpenCode](https://opencode.ai/)
+- 依赖工具：已安装 [Ansible](https://docs.ansible.com/ansible/latest/installation_guide/)（`ansible` 命令须在系统 PATH 中可用，可通过 `ansible --version` 提前验证）
 
-## 安装
-
-```shell
-git clone https://gitcode.com/sparklezfl/witty-diagnosis-agent.git
-cd witty-diagnosis-agent
-bun install
-```
-
-## 构建
-
-```shell
-bun run build
-```
-
-构建完成后，将在项目根目录生成 `dist/index.js` 等相关文件。
-
-## 注册插件
+> ⚠️ **注意**：执行 `witty-diagnosis-agent install` 前，请确保本地已完成 Ansible 的安装与环境配置，否则安装程序将直接终止。
 
-配置文件支持两种路径（二选一），优先选择用户级配置：
+#### 安装与配置
 
-- 用户级（推荐）：`~/.config/opencode/opencode.json` 或 `opencode.jsonc`
+Witty 智能诊断 Agent 支持**在线安装**与**源码安装**两种方式，请根据您的网络环境选择合适的安装方式。
 
-- 项目级：项目根目录下的 `.opencode/opencode.json` 或 `.opencode/opencode.jsonc`
+##### 方式一：在线安装（推荐）
 
-在配置文件中新增或修改 `plugin` 数组，指向本仓库的构建入口（请替换为实际项目路径）：
-
-```json
-{
-    "$schema": "https://opencode.ai/config.json",
-    "plugin": [
-        "file:///{witty-diagnosis-agent项目绝对路径}/dist/index.js"
-    ]
-}
-```
-
-示例（假设项目绝对路径为 `/opt/witty-diagnosis-agent`）：
-
-```json
-{
-    "$schema": "https://opencode.ai/config.json",
-    "plugin": [
-        "file:///opt/witty-diagnosis-agent/dist/index.js"
-    ]
-}
+```bash
+npm install -g witty-diagnosis-agent@latest
+witty-diagnosis-agent install
 ```
 
-## 配置模型
+##### 方式二：源码一键安装（适用于源码）
 
-修改项目根目录下的 `.opencode/oh-my-opencode.jsonc` 文件，配置如下：
+如果您已经克隆了仓库，可以使用一键安装脚本自动完成环境检查、依赖安装、项目构建及插件配置：
 
-```json
-{
-    "agents": {
-        "fuxi": { "model": "deepseek/deepseek-chat" },
-        "dayu": { "model": "deepseek/deepseek-chat" },
-        "kuafu": { "model": "deepseek/deepseek-chat" },
-        "baize": { "model": "deepseek/deepseek-chat" }
-    }
-}
+```shell
+git clone https://atomgit.com/openeuler/witty-diagnosis-agent.git
+cd witty-diagnosis-agent
+bash install.sh
 ```
 
-# 如何使用
+### 如何使用
 
-1. 启动 **OpenCode **。
+1. 启动 \*\*OpenCode \*\*。
 
-2. 在终端执行命令：
+2. 执行`/agents`命令，选择`Xuanyuan`Agent。
    
-   ```shell
-   auto-diag 故障问题描述
-   ```
-   
-   **说明**：当前支持离线分析，需在故障描述中指定**遥测数据 / 日志存储路径**。
-   
-   示例：
+   ![选择Xuanyuan Agent](docs/assets/select_xuanyuan.png)
+
+3. 输入故障问题描述，示例：
    
    ```shell
-   auto-diag "请诊断2026-03-05 14:31前最近一次硬盘故障，日志路径：/tmp/diskfault/logs"
+   请诊断2026-03-05 14:31前最近一次硬盘故障，日志路径：/tmp/logs
    ```
    
-   ![wittywork命令](docs/assets/wittywork.png)
+   <img src="docs/assets/guide_auto_diag_start.png" alt="wittywork命令" width="800" />
 
-3. 系统将自动执行**智能诊断**流程。
+4. 系统将自动执行**智能诊断**流程。
 
-4. 诊断完成后，根据终端输出的报告路径，查看完整的诊断分析报告。
+5. 诊断完成后，系统将生成[HTML](docs/reference/reports/hard_disk_fault_diagnosis_report.html)和[Markdown](docs/reference/reports/hard_disk_fault_diagnosis_report.md)两种格式的诊断分析报告，同时在界面上展示完整报告内容：
    
-   ![诊断报告](docs/assets/diagnosis_report.png)
+   <img src="docs/assets/guide_auto_diag_report.png" alt="诊断报告" width="800" />
+
+如需了解更多操作细节，可查阅[用户手册](docs/guide/MANUAL.html)；支持的诊断能力与功能说明详见[功能列表](docs/reference/features.html)。
 
-# 如何贡献
+### 如何贡献
 
-## 社区贡献
+#### 社区贡献
 
 我们诚挚欢迎新贡献者加入项目，也会为新加入者提供全面的指导与帮助。请注意：贡献代码前，请先签署 [CLA](https://clasign.osinfra.cn/sign/6983225bdcbb19710248ccf0)，再参考 [代码贡献指引](https://www.openeuler.org/zh/community/contribution/detail#_4-2-代码类贡献) 提交代码。
 
-## 问题讨论
+#### 问题讨论
 
 若您有任何疑问、建议或讨论需求，可通过以下方式联系我们：
 
 - 提交 [issue](https://atomgit.com/openeuler/witty-diagnosis-agent/issues)
+- 发送邮件至 <intelligence@openeuler.org>
 
-- 发送邮件至 [intelligence@openeuler.org](mailto:intelligence@openeuler.org)
-
-# License
+### License
 
-本项目采用 **MIT** 开源协议，详情请参阅项目根目录下的 LICENSE 文件。
+本项目中部分代码基于 `oh-my-openagent` 修改，这部分代码遵循 **Sustainable Use License Version 1.0**。其他原创及贡献部分代码协议以最终发布版本为准。详情请参阅项目根目录下的 [LICENSE](./LICENSE) 文件。

package/dist/{auto-update-checker-6YCUJMDH.js → auto-update-checker-SCZAPT6L.js}

@@ -7,8 +7,8 @@ import {
   isDistTag,
   isPrereleaseOrDistTag,
   isPrereleaseVersion
-} from "./chunk-ML545FPN.js";
-import "./chunk-7T4NFQTD.js";
+} from "./chunk-VGS3BNP5.js";
+import "./chunk-YVNTYBPS.js";
 export {
   checkForUpdate,
   createAutoUpdateCheckerHook,