# clouderhem/zhiliao architecture

> Architecture diagram of the GitHub repository clouderhem/zhiliao, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/clouderhem/zhiliao
- Repository: https://github.com/clouderhem/zhiliao

## Overview

##### Project type and purpose
- This is an Android Xposed-based module (APK) called “知了” that hooks into the Zhihu app at runtime to remove ads, filter content, and tweak UI/UX.
- The README confirms it is an Xposed hook module listing dozens of ad-blocking and UI-tweaking features.

##### File structure
- app/src/main/java/...: all Java/Kotlin hook classes under com.shatyuka.zhiliao/hooks implementing IHook.
- Helper.java, Hooks.java, MainHook.java: core hook registration and logic.
- app/src/main/cpp: contains CMakeLists.txt plus “external/Dobby” folder and a zhiliao.cpp; this implements low-level native hooking.
- app/src/main/assets/xposed_init: declares the module’s entry point to Xposed.
- gradle scripts/AndroidManifest: standard Android module setup.
- test jars: different versions of the target Zhihu APK used during development.

##### README for additional insights
- No external dependencies besides Xposed framework and Dobby (bundled C++ lib).

##### Elements
– Clear labels for each component (e.g., “Xposed Framework”, “MainHook”, “Dobby Engine”, “AnswerAd Hook”).
- Xposed → Module Init
- Module → Register Hooks
- Hook Classes → Dobby Native Hooks
- Hooks → Target App UI/Network Calls
- ConfigFetcher ↔ Remote Server
- Rectangles for modules (APK components)
- Clouds for Xposed/Android OS layers

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Layers
    AndroidOS["Android OS"]:::cloud
    Xposed["Xposed Framework"]:::cloud

    %% Remote Config
    RemoteConfig["Remote Config Server"]:::external

    %% Target App
    ZhihuApp["Zhihu App Process"]:::app

    %% Module APK Group
    subgraph "知了 Module APK" 
        direction TB

        %% Assets and Entry
        XposedInit["xposed_init (Assets)"]:::asset
        click XposedInit "https://github.com/clouderhem/zhiliao/tree/master/app/src/main/assets/xposed_init"

        %% Configuration Files
        subgraph "Module Configuration"
            AndroidManifest["AndroidManifest.xml"]:::config
            click AndroidManifest "https://github.com/clouderhem/zhiliao/blob/master/app/src/main/AndroidManifest.xml"
            BuildGradle["build.gradle"]:::config
            click BuildGradle "https://github.com/clouderhem/zhiliao/blob/master/app/build.gradle"
            Proguard["proguard-rules.pro"]:::config
            click Proguard "https://github.com/clouderhem/zhiliao/blob/master/app/proguard-rules.pro"
        end

        %% Java Hook Manager
        subgraph "Hook Manager (Java/Kotlin)"
            MainHook["MainHook"]:::java
            click MainHook "https://github.com/clouderhem/zhiliao/blob/master/app/src/main/java/com/shatyuka/zhiliao/MainHook.java"
            HooksMgr["Hooks"]:::java
            click HooksMgr "https://github.com/clouderhem/zhiliao/blob/master/app/src/main/java/com/shatyuka/zhiliao/Hooks.java"
            Helper["Helper"]:::java
            click Helper "https://github.com/clouderhem/zhiliao/blob/master/app/src/main/java/com/shatyuka/zhiliao/Helper.java"
        end

        %% Hook Definitions
        subgraph "Hook Definitions"
            IHook["IHook"]:::java
            click IHook "https://github.com/clouderhem/zhiliao/blob/master/app/src/main/java/com/shatyuka/zhiliao/hooks/IHook.java"
            BaseHook["BaseHook"]:::java
            click BaseHook "https://github.com/clouderhem/zhiliao/blob/master/app/src/main/java/com/shatyuka/zhiliao/hooks/BaseHook.kt"
            AnswerAd["AnswerAd Hook"]:::java
            click AnswerAd "https://github.com/clouderhem/zhiliao/blob/master/app/src/main/java/com/shatyuka/zhiliao/hooks/AnswerAd.java"
            FeedAd["FeedAd Hook"]:::java
            click FeedAd "https://github.com/clouderhem/zhiliao/blob/master/app/src/main/java/com/shatyuka/zhiliao/hooks/FeedAd.java"
            Cleaner["Cleaner Hook"]:::java
            click Cleaner "https://github.com/clouderhem/zhiliao/blob/master/app/src/main/java/com/shatyuka/zhiliao/hooks/Cleaner.java"
            ConfigFetcher["ConfigFetcher"]:::java
            click ConfigFetcher "https://github.com/clouderhem/zhiliao/blob/master/app/src/main/java/com/shatyuka/zhiliao/hooks/ConfigFetcher.kt"
            HooksOthers["Other Hook Classes"]:::java
            click HooksOthers "https://github.com/clouderhem/zhiliao/tree/master/app/src/main/java/com/shatyuka/zhiliao/hooks/"
        end

        %% Native Hook Engine
        subgraph "Native Hook Engine (C++)"
            ZhiNative["zhiliao.cpp"]:::native
            click ZhiNative "https://github.com/clouderhem/zhiliao/blob/master/app/src/main/cpp/zhiliao.cpp"
            CMake["CMakeLists.txt"]:::native
            click CMake "https://github.com/clouderhem/zhiliao/blob/master/app/src/main/cpp/CMakeLists.txt"
            Dobby["Dobby Lib"]:::native
            click Dobby "https://github.com/clouderhem/zhiliao/tree/master/app/src/main/cpp/external/Dobby"
        end
    end

    %% Test JARs
    TestJars["Test JARs"]:::external
    click TestJars "https://github.com/clouderhem/zhiliao/tree/master/app/test/"

    %% Data Flows
    AndroidOS --> Xposed
    Xposed --> XposedInit
    XposedInit --> MainHook
    MainHook --> HooksMgr
    HooksMgr --> IHook
    IHook --> BaseHook
    BaseHook --> AnswerAd
    BaseHook --> FeedAd
    BaseHook --> Cleaner
    BaseHook --> ConfigFetcher
    BaseHook --> HooksOthers
    AnswerAd --> ZhihuApp
    FeedAd --> ZhihuApp
    Cleaner --> ZhihuApp
    ConfigFetcher --> RemoteConfig
    RemoteConfig --> ConfigFetcher
    BaseHook --> ZhiNative
    ZhiNative --> ZhihuApp
    TestJars --> ZhihuApp

    %% Styles
    classDef cloud fill:#E0F7FA,stroke:#006064,stroke-width:2px;
    classDef external fill:#FFF3E0,stroke:#E65100,stroke-width:2px;
    classDef app fill:#E8F5E9,stroke:#2E7D32,stroke-width:2px;
    classDef module fill:#EDE7F6,stroke:#4527A0,stroke-width:2px;
    classDef asset fill:#F3E5F5,stroke:#6A1B9A,stroke-width:2px;
    classDef config fill:#FFEBEE,stroke:#C62828,stroke-width:2px;
    classDef java fill:#E3F2FD,stroke:#1565C0,stroke-width:2px;
    classDef native fill:#FFFDE7,stroke:#F9A825,stroke-width:2px;
```
