# kgcase

**Repository Path**: ontoweb/kgcase

## Basic Information

- **Project Name**: kgcase
- **Description**: 《知识图谱技术与应用》教学案例
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-06-12
- **Last Updated**: 2026-11-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ONTOWEB 知识图谱案例与教学仓库（kgcase）

本仓库包含两个**相互独立**的知识图谱项目，共用同一套方法学（**本体构建 → 多路线知识抽取 → 知识图谱 → 知识增强应用**）：

| 子项目 | 目录 | 定位 | 领域数据 | 主要受众 |
|---|---|---|---|---|
| **电力合规风险知识图谱案例** | [`power/`](power/) | 完整行业落地案例（本体 → rule/BERT/LLM/ensemble 四方案抽取 → 知识图谱 → 风险分析 → RAG 问答） | DL/T 2977—2025 标准 + 约 300 份电力合规判决文书（本地放置，不入库） | 工程实践、行业交付参考 |
| **网络工程《知识图谱技术与应用》实践作业脚手架** | [`network/`](network/) | 本科教学脚手架（8 个选题 × 三阶段流水线，含规则/模型/LLM 三方法、金标准评测、Intellect Agent 集成） | 真实公开网络工程数据（RFC 全文、CVE/ATT&CK、Loghub、BGP 归档、等保标准等） | 本科教学、课程实验 |

> 两个子项目各自带 README，请从子目录进入后阅读；本文件只做仓库级导航。

```text
kgcase/
├── power/      # 电力合规风险知识图谱案例（原仓库根目录内容，于 2026-10 迁入；含 CI 配置）
├── network/    # 网络工程教学脚手架（kgcourse-starter，于 2026-10 并入）
├── LICENSE     # 仓库许可：GPL-2.0（两个子项目均沿用；子目录内如另附 LICENSE 以其为准）
├── .gitignore  # 仓库级忽略规则（分 power / network 两段）
└── README.md   # 本文件
```

---

## 一、power/ — 电力合规风险知识图谱案例

基于 **DL/T 2977—2025《电力企业合规管理体系有效性评价指南》** 与约 300 份电力合规判决案例，实现"本体构建 → 实体关系抽取 → 合规风险知识图谱 → RAG 问答"的完整链路。

**亮点**：① 本体构建（标准七大评价维度 + 法律法规映射）；② 三方案抽取（规则 / BERT / 智谱 GLM-4 + Ensemble 融合）；③ 企业—风险—法律—维度关联网络；④ 七大维度风险热力图；⑤ 检索增强合规问答。

```bash
cd power
bash scripts/setup_env.sh full          # 国内镜像安装依赖（Windows 见 docs/platform_scripts.md）
source .venv/bin/activate
python scripts/build_ontology.py
python scripts/extract_from_cases.py --scheme rule --case-limit 10 --export-rdf
```

**文档**：`power/README.md` 为项目总入口，另有 `power/docs/` 下的本体设计、抽取算法、Phase 1/2/3 技术报告、图数据库导入指南、CI/CD 与发布指南等。

> ⚠ 迁移说明：原仓库根目录的全部内容（源码、`data/`、`docs/`、`case/`、`scripts/`、`.github/`、`.workflow/` 等）已整体迁入 `power/`。这意味着 **CI/CD 配置现在位于 `power/.github/` 与 `power/.workflow/`**。
>
> 实测影响（2026-10-14）：`power/scripts/*.py` 均以 `Path(__file__).parents[1]` 定位项目根，迁移后仍正确指向 `power/`，**脚本本身不受影响**；但 **GitHub Actions 只读取仓库根目录的 `.github/workflows/`**，因此 `power/.github/workflows/{ci,release}.yml` 目前**不会被触发**（例如 `release.yml` 里的 `python scripts/build_release.py` 是相对仓库根解析的）。如需恢复 CI，二选一：
> 1. 把 `.github/` 移回仓库根，并在 workflow 顶部加 `defaults: { run: { working-directory: power } }`（或把所有 `scripts/...` 改为 `power/scripts/...`）；
> 2. 或改用"每子项目独立仓库 + 子模块"的形态。
> Gitee Go 的 `.workflow/` 同理——若所用平台要求配置文件位于仓库根，请按上述方式处理。

---

## 二、network/ — 网络工程《知识图谱技术与应用》实践作业脚手架

面向网络工程专业本科，提供 **8 个选题**，每个选题都要完成**三个递进阶段**：

1. **阶段一 · 本体构建**：产出 `ontology.ttl`（OWL/RDFS）+ `ontology.json`，含本体自检；
2. **阶段二 · 三种方法构建知识图谱**：① 规则/词典/模板 ② 机器学习模型 ③ LLM（本体约束 + 证据回填），再做融合、消歧与**金标准评测**（实体级/三元组级 P/R/F1、越界率、证据覆盖率、票数分档）；
3. **阶段三 · 基于 KG 的 Agent 应用**：把图谱接入 [Intellect Agent](https://gitee.com/ontoweb/intellect-agent) 的 agent loop（Skill 路线 / MCP 路线），实现**可溯源、可验证**的问答，并统计幻觉率。

| 选题 | 领域 | 选题 | 领域 |
|---|---|---|---|
| T1 设备/接口/链路资产图谱 | 网络运维 | T5 TCP/IP 协议与 RFC 规范图谱 | 协议原理 |
| T2 威胁情报图谱（CVE×CWE×CPE×ATT&CK） | 网络安全 | T6 AI 数据中心高性能网络图谱 | 架构前沿 |
| T3 日志驱动的故障根因图谱 | AIOps | T7 网络安全等级保护合规图谱 | 合规管理 |
| T4 BGP 路由事件与 AS 关系图谱 | 路由安全 | T8 网络配置图谱与配置校验（进阶） | 网络自动化 |

```bash
cd network
python3.11 -m venv .venv && .venv/bin/pip install -r requirements.txt
.venv/bin/python scripts/fetch_corpus.py --topic t5-protocol-rfc     # 真实 RFC 语料
bash scripts/run_all.sh t5-protocol-rfc                              # 一键跑通三阶段
.venv/bin/python tests/test_pipeline.py                              # 5/5 自检
```

**实测基线**（t5-protocol-rfc，5 篇真实 RFC，金标准 23 实体 / 18 三元组）：三元组 F1 = 规则 **0.182** / 模型 **0.044** / LLM **0.653** / 融合 召回 **0.944**；阶段三题库 8 题可回答率 **0.75**。详见 `network/README.md`。

**教学文档**（`network/docs/`）：

- **面向学生**：[`学生作业说明.md`](network/docs/学生作业说明.md)（一页纸）· [`选题介绍.html`](network/docs/选题介绍.html)（**图文版 8 选题详解**，内联 SVG，离线可看）· 打印版 PDF：[学生作业说明](network/docs/学生作业说明.pdf)（A4 单页）/ [选题介绍](network/docs/选题介绍.pdf)（A4 15 页）
- **面向教师**：[`作业方案.md`](network/docs/作业方案.md)（v1.0 定稿，含 4 周 16 学时进度与范围调整）· [`数据分发与合规.md`](network/docs/数据分发与合规.md) · [`评审报告-2026-10-14.md`](network/docs/评审报告-2026-10-14.md)（方案评审） · [`评审报告-学生材料-2026-10-17.md`](network/docs/评审报告-学生材料-2026-10-17.md)（学生材料评审）

---

## 许可

仓库整体沿用 **GPL-2.0**（见根目录 `LICENSE`，来自原 kgcase）。各子项目目录内如存在独立 `LICENSE`，以其为准。教学用数据集的许可**不等于**仓库许可——`network/` 涉及的第三方数据（ATT&CK、Loghub、security-kg 等）请逐项确认上游条款，尤其是商用限制。

## 相关项目

- [Intellect Agent](https://gitee.com/ontoweb/intellect-agent) — 本仓库 `network/` 阶段三依赖的多智能体调度引擎（agent loop 后端）
- 本机 LLM WIKI：`~/workspace/wiki`（知识图谱/网络安全领域的调研知识库，`network/` 多篇选题的资料出处）