# anqiushi767-cell/kvckiller architecture

> Architecture diagram of the GitHub repository anqiushi767-cell/kvckiller, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anqiushi767-cell/kvckiller
- Repository: https://github.com/anqiushi767-cell/kvckiller

## Overview

KvcKiller is a Windows process-management application with GUI and headless CLI modes. Its main workflow discovers configured or running targets, then kills them through a kernel driver or blocks future launches with IFEO; restore removes the block and relaunches targets. Configuration and action history persist in the user registry. The README documents several driver and restoration details not present in the sampled source, so those relationships are cited to it; unsampled implementation details are not inferred.

Main entry points: [`src/ProcessKiller.cpp`](https://github.com/anqiushi767-cell/kvckiller/blob/main/src/ProcessKiller.cpp) (Discovery and restore), [`src/DriverController.cpp`](https://github.com/anqiushi767-cell/kvckiller/blob/main/src/DriverController.cpp) (Driver lifecycle), [`src/ProcessOperations.cpp`](https://github.com/anqiushi767-cell/kvckiller/blob/main/src/ProcessOperations.cpp) (Action orchestration), [`src/ConfigReader.cpp`](https://github.com/anqiushi767-cell/kvckiller/blob/main/src/ConfigReader.cpp) (Configuration store)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application entry"]
  node_main["App entry<br/>[main.cpp]"]
  node_cli["CLI dispatcher<br/>[CLIHandler.cpp]"]
end

subgraph group_ui["GUI experience"]
  node_window["Window handling<br/>[main.cpp]"]
  node_list["Process list"]
  node_uihelpers["UI helpers<br/>[UIHelpers.cpp]"]
end

subgraph group_operations["Process operations"]
  node_operations["Action orchestration"]
  node_killer["Discovery and restore<br/>[ProcessKiller.cpp]"]
  node_ifeo["IFEO paralyze"]
  node_config["Configuration store<br/>[ConfigReader.cpp]"]
end

subgraph group_system["Windows integration"]
  node_driver["Driver lifecycle"]
  node_extract["Driver extraction"]
  node_registry[("Windows registry")]
  node_scm["Service manager"]
  node_kernel["Kernel driver"]
end

node_user(("Operator"))
node_processes["Target processes"]

node_user -->|"starts"| node_main
node_main -->|"dispatches CLI"| node_cli
node_main -->|"opens GUI"| node_window
node_window -->|"refreshes"| node_list
node_window -->|"uses"| node_uihelpers
node_window -->|"starts actions"| node_operations
node_cli -->|"runs process commands"| node_killer
node_cli -->|"uses driver"| node_driver
node_cli -->|"reads configuration"| node_config
node_operations -->|"discovers and restores"| node_killer
node_operations -->|"applies launch block"| node_ifeo
node_operations -->|"initializes"| node_driver
node_operations -->|"reads targets"| node_config
node_list -->|"reads targets"| node_config
node_list -->|"checks running state"| node_killer
node_killer -->|"enumerates and restores"| node_processes
node_killer -->|"sends kill request"| node_driver
node_driver -->|"extracts payload"| node_extract
node_driver -->|"registers service"| node_scm
node_driver -->|"loads and sends IOCTL"| node_kernel
node_ifeo -->|"edits offline hive"| node_registry
node_config -->|"reads and writes"| node_registry
node_killer -->|"uses path cache"| node_config
node_ifeo -->|"blocks future launches"| node_processes
node_killer -->|"terminates by PID"| node_processes

click node_main "https://github.com/anqiushi767-cell/kvckiller/blob/main/src/main.cpp"
click node_cli "https://github.com/anqiushi767-cell/kvckiller/blob/main/src/CLIHandler.cpp"
click node_window "https://github.com/anqiushi767-cell/kvckiller/blob/main/src/main.cpp"
click node_list "https://github.com/anqiushi767-cell/kvckiller/blob/main/src/ListViewManager.cpp"
click node_uihelpers "https://github.com/anqiushi767-cell/kvckiller/blob/main/src/UIHelpers.cpp"
click node_operations "https://github.com/anqiushi767-cell/kvckiller/blob/main/src/ProcessOperations.cpp"
click node_killer "https://github.com/anqiushi767-cell/kvckiller/blob/main/src/ProcessKiller.cpp"
click node_ifeo "https://github.com/anqiushi767-cell/kvckiller/blob/main/src/ProcessOperations.cpp"
click node_config "https://github.com/anqiushi767-cell/kvckiller/blob/main/src/ConfigReader.cpp"
click node_driver "https://github.com/anqiushi767-cell/kvckiller/blob/main/src/DriverController.cpp"
click node_extract "https://github.com/anqiushi767-cell/kvckiller/blob/main/src/DriverController.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_cli toneBlue
class node_window,node_list,node_uihelpers toneAmber
class node_operations,node_killer,node_ifeo,node_config toneMint
class node_driver,node_extract,node_registry,node_scm,node_kernel toneRose
class node_user,node_processes toneIndigo
```

## Components

### Application entry

- [App entry](https://github.com/anqiushi767-cell/kvckiller/blob/main/src/main.cpp): `src/main.cpp`
- [CLI dispatcher](https://github.com/anqiushi767-cell/kvckiller/blob/main/src/CLIHandler.cpp): `src/CLIHandler.cpp`

### GUI experience

- [Window handling](https://github.com/anqiushi767-cell/kvckiller/blob/main/src/main.cpp): `src/main.cpp`
- [Process list](https://github.com/anqiushi767-cell/kvckiller/blob/main/src/ListViewManager.cpp): `src/ListViewManager.cpp`
- [UI helpers](https://github.com/anqiushi767-cell/kvckiller/blob/main/src/UIHelpers.cpp): `src/UIHelpers.cpp`

### Process operations

- [Action orchestration](https://github.com/anqiushi767-cell/kvckiller/blob/main/src/ProcessOperations.cpp): `src/ProcessOperations.cpp`
- [Discovery and restore](https://github.com/anqiushi767-cell/kvckiller/blob/main/src/ProcessKiller.cpp): `src/ProcessKiller.cpp`
- [IFEO paralyze](https://github.com/anqiushi767-cell/kvckiller/blob/main/src/ProcessOperations.cpp): `src/ProcessOperations.cpp`
- [Configuration store](https://github.com/anqiushi767-cell/kvckiller/blob/main/src/ConfigReader.cpp): `src/ConfigReader.cpp`

### Windows integration

- [Driver lifecycle](https://github.com/anqiushi767-cell/kvckiller/blob/main/src/DriverController.cpp): `src/DriverController.cpp`
- [Driver extraction](https://github.com/anqiushi767-cell/kvckiller/blob/main/src/DriverController.cpp): `src/DriverController.cpp`
- **Windows registry**
- **Service manager**
- **Kernel driver**

### Other components

- **Operator**
- **Target processes**

## Connections

- Operator → App entry: starts (evidence: `README.md`)
- App entry → CLI dispatcher: dispatches CLI (evidence: `README.md`)
- App entry → Window handling: opens GUI (evidence: `README.md`)
- Window handling → Process list: refreshes (evidence: `src/main.cpp`)
- Window handling → UI helpers: uses (evidence: `README.md`)
- Window handling → Action orchestration: starts actions (evidence: `README.md`)
- CLI dispatcher → Discovery and restore: runs process commands (evidence: `README.md`)
- CLI dispatcher → Driver lifecycle: uses driver (evidence: `README.md`)
- CLI dispatcher → Configuration store: reads configuration (evidence: `README.md`)
- Action orchestration → Discovery and restore: discovers and restores (evidence: `README.md`)
- Action orchestration → IFEO paralyze: applies launch block (evidence: `README.md`)
- Action orchestration → Driver lifecycle: initializes (evidence: `README.md`)
- Action orchestration → Configuration store: reads targets (evidence: `README.md`)
- Process list → Configuration store: reads targets (evidence: `src/ListViewManager.cpp`)
- Process list → Discovery and restore: checks running state (evidence: `src/ListViewManager.cpp`)
- Discovery and restore → Target processes: enumerates and restores
- Discovery and restore → Driver lifecycle: sends kill request (evidence: `README.md`)
- Driver lifecycle → Driver extraction: extracts payload (evidence: `README.md`)
- Driver lifecycle → Service manager: registers service (evidence: `README.md`)
- Driver lifecycle → Kernel driver: loads and sends IOCTL (evidence: `README.md`)
- IFEO paralyze → Windows registry: edits offline hive (evidence: `README.md`)
- Configuration store → Windows registry: reads and writes
- Discovery and restore → Configuration store: uses path cache
- IFEO paralyze → Target processes: blocks future launches (evidence: `README.md`)
- Discovery and restore → Target processes: terminates by PID
