# ujhhgtg/wekit architecture

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

- Interactive diagram: https://gitdiagram.com/ujhhgtg/wekit
- Repository: https://github.com/ujhhgtg/wekit

## Overview

WeKit is an Android enhancement module for WeChat, loaded through Xposed or Zygisk. Users configure features in the module and use the resulting hooks and APIs inside WeChat; the repository also contains a substantial conversational agent. The agent service coordinates turns, model access, tool execution and persisted conversation state. The tree identifies broad feature, extension and host-integration areas, but their internal wiring was not sampled; arrows below are limited to relationships visible in excerpts or the SOURCE INDEX.

Main entry points: [`app/src/main/java/dev/ujhhgtg/wekit/features/api/agent/WeAgentService.kt`](https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/features/api/agent/WeAgentService.kt) (Agent service), [`app/src/main/java/dev/ujhhgtg/wekit/agent/engine/AgentSessionEngine.kt`](https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/agent/engine/AgentSessionEngine.kt) (Agent loop), [`app/src/main/java/dev/ujhhgtg/wekit/features/items/scripting_java/JavaEngine.kt`](https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/features/items/scripting_java/JavaEngine.kt) (Java scripting), [`app/src/main/java/dev/ujhhgtg/wekit/activity/MainActivity.kt`](https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/activity/MainActivity.kt) (Android module)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Module entry"]
  node_module["Android module<br/>[MainActivity.kt]"]
end

subgraph group_agent["Agent runtime"]
  node_service["Agent service<br/>[WeAgentService.kt]"]
  node_engine["Agent loop"]
  node_approval["Tool approval<br/>[ApprovalGateway.kt]"]
  node_toolregistry["Tool registry<br/>[ToolRegistry.kt]"]
  node_modelmanager["Model providers"]
  node_modelclients["Model clients<br/>[LlmClient.kt]"]
  node_toolbindings["Agent tool bindings"]
  node_triggers["Agent triggers<br/>[TriggerManager.kt]"]
  node_environment["Linux environments"]
  node_terminal["Terminal runtime<br/>[TerminalManager.kt]"]
  node_bridge["Tool bridge"]
end

subgraph group_host["WeChat integration"]
  node_weapi["WeChat APIs<br/>[WeApi.kt]"]
  node_messageapi["Message API<br/>[WeMessageApi.kt]"]
end

subgraph group_features["Enhancement features"]
  node_featureloader["Feature loader<br/>[FeaturesLoader.kt]"]
  node_featureitems["Feature implementations"]
  node_javaengine["Java scripting<br/>[JavaEngine.kt]"]
  node_voicefeature["Voice saving"]
  node_extensions["Extension packs"]
end

subgraph group_data["Persistence"]
  node_agentrepo["Agent repository"]
  node_database[("WeKit database<br/>[WeKitDatabase.kt]")]
end

node_user(("Module user"))
node_wechat["WeChat host"]

node_user -.->|"configures"| node_module
node_wechat -.->|"hosts"| node_service
node_service -->|"runs turns"| node_engine
node_service -->|"uses"| node_agentrepo
node_service -->|"uses"| node_database
node_service -->|"uses"| node_modelmanager
node_service -->|"manages"| node_environment
node_service -->|"uses"| node_terminal
node_service -->|"starts"| node_bridge
node_service -.->|"coordinates"| node_triggers
node_engine -->|"streams model"| node_modelclients
node_engine -->|"requests approval"| node_approval
node_engine -->|"discovers tools"| node_toolregistry
node_toolbindings -.->|"accesses host"| node_wechat
node_module -.->|"configures"| node_featureloader
node_featureitems -.->|"enhances"| node_wechat
node_javaengine -->|"exposes APIs"| node_weapi
node_javaengine -->|"exposes API"| node_messageapi
node_voicefeature -->|"reads messages"| node_messageapi
node_extensions -.->|"extends features"| node_featureitems

click node_module "https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/activity/MainActivity.kt"
click node_service "https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/features/api/agent/WeAgentService.kt"
click node_engine "https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/agent/engine/AgentSessionEngine.kt"
click node_approval "https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/agent/engine/ApprovalGateway.kt"
click node_toolregistry "https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/agent/tool/ToolRegistry.kt"
click node_modelmanager "https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/agent/model/ModelProviderManager.kt"
click node_modelclients "https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/agent/model/LlmClient.kt"
click node_toolbindings "https://github.com/ujhhgtg/wekit/tree/master/app/src/main/java/dev/ujhhgtg/wekit/features/api/agent"
click node_triggers "https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/agent/trigger/TriggerManager.kt"
click node_environment "https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/agent/environment/LinuxEnvironmentManager.kt"
click node_terminal "https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/agent/terminal/TerminalManager.kt"
click node_bridge "https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/agent/bridge/ToolBridgeServer.kt"
click node_agentrepo "https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/agent/data/WeAgentRepository.kt"
click node_database "https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/data/WeKitDatabase.kt"
click node_weapi "https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/features/api/core/WeApi.kt"
click node_messageapi "https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/features/api/core/WeMessageApi.kt"
click node_featureloader "https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/features/core/FeaturesLoader.kt"
click node_featureitems "https://github.com/ujhhgtg/wekit/tree/master/app/src/main/java/dev/ujhhgtg/wekit/features/items"
click node_javaengine "https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/features/items/scripting_java/JavaEngine.kt"
click node_voicefeature "https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/features/items/chat/SaveVoicesToLocalStorage.kt"
click node_extensions "https://github.com/ujhhgtg/wekit/tree/master/app/src/main/java/dev/ujhhgtg/wekit/extensions"

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_module,node_user toneBlue
class node_service,node_engine,node_approval,node_toolregistry,node_modelmanager,node_modelclients,node_toolbindings,node_triggers,node_environment,node_terminal,node_bridge toneAmber
class node_weapi,node_messageapi toneMint
class node_featureloader,node_featureitems,node_javaengine,node_voicefeature,node_extensions toneRose
class node_agentrepo,node_database,node_wechat toneIndigo
```

## Components

### Module entry

- [Android module](https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/activity/MainActivity.kt): `app/src/main/java/dev/ujhhgtg/wekit/activity/MainActivity.kt`

### Agent runtime

- [Agent service](https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/features/api/agent/WeAgentService.kt): `app/src/main/java/dev/ujhhgtg/wekit/features/api/agent/WeAgentService.kt`
- [Agent loop](https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/agent/engine/AgentSessionEngine.kt): `app/src/main/java/dev/ujhhgtg/wekit/agent/engine/AgentSessionEngine.kt`
- [Tool approval](https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/agent/engine/ApprovalGateway.kt): `app/src/main/java/dev/ujhhgtg/wekit/agent/engine/ApprovalGateway.kt`
- [Tool registry](https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/agent/tool/ToolRegistry.kt): `app/src/main/java/dev/ujhhgtg/wekit/agent/tool/ToolRegistry.kt`
- [Model providers](https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/agent/model/ModelProviderManager.kt): `app/src/main/java/dev/ujhhgtg/wekit/agent/model/ModelProviderManager.kt`
- [Model clients](https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/agent/model/LlmClient.kt): `app/src/main/java/dev/ujhhgtg/wekit/agent/model/LlmClient.kt`
- [Agent tool bindings](https://github.com/ujhhgtg/wekit/tree/master/app/src/main/java/dev/ujhhgtg/wekit/features/api/agent): `app/src/main/java/dev/ujhhgtg/wekit/features/api/agent`
- [Agent triggers](https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/agent/trigger/TriggerManager.kt): `app/src/main/java/dev/ujhhgtg/wekit/agent/trigger/TriggerManager.kt`
- [Linux environments](https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/agent/environment/LinuxEnvironmentManager.kt): `app/src/main/java/dev/ujhhgtg/wekit/agent/environment/LinuxEnvironmentManager.kt`
- [Terminal runtime](https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/agent/terminal/TerminalManager.kt): `app/src/main/java/dev/ujhhgtg/wekit/agent/terminal/TerminalManager.kt`
- [Tool bridge](https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/agent/bridge/ToolBridgeServer.kt): `app/src/main/java/dev/ujhhgtg/wekit/agent/bridge/ToolBridgeServer.kt`

### WeChat integration

- [WeChat APIs](https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/features/api/core/WeApi.kt): `app/src/main/java/dev/ujhhgtg/wekit/features/api/core/WeApi.kt`
- [Message API](https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/features/api/core/WeMessageApi.kt): `app/src/main/java/dev/ujhhgtg/wekit/features/api/core/WeMessageApi.kt`

### Enhancement features

- [Feature loader](https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/features/core/FeaturesLoader.kt): `app/src/main/java/dev/ujhhgtg/wekit/features/core/FeaturesLoader.kt`
- [Feature implementations](https://github.com/ujhhgtg/wekit/tree/master/app/src/main/java/dev/ujhhgtg/wekit/features/items): `app/src/main/java/dev/ujhhgtg/wekit/features/items`
- [Java scripting](https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/features/items/scripting_java/JavaEngine.kt): `app/src/main/java/dev/ujhhgtg/wekit/features/items/scripting_java/JavaEngine.kt`
- [Voice saving](https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/features/items/chat/SaveVoicesToLocalStorage.kt): `app/src/main/java/dev/ujhhgtg/wekit/features/items/chat/SaveVoicesToLocalStorage.kt`
- [Extension packs](https://github.com/ujhhgtg/wekit/tree/master/app/src/main/java/dev/ujhhgtg/wekit/extensions): `app/src/main/java/dev/ujhhgtg/wekit/extensions`

### Persistence

- [Agent repository](https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/agent/data/WeAgentRepository.kt): `app/src/main/java/dev/ujhhgtg/wekit/agent/data/WeAgentRepository.kt`
- [WeKit database](https://github.com/ujhhgtg/wekit/blob/master/app/src/main/java/dev/ujhhgtg/wekit/data/WeKitDatabase.kt): `app/src/main/java/dev/ujhhgtg/wekit/data/WeKitDatabase.kt`

### Other components

- **Module user**
- **WeChat host**

## Connections

- Module user → Android module: configures
- WeChat host → Agent service: hosts
- Agent service → Agent loop: runs turns (evidence: `app/src/main/java/dev/ujhhgtg/wekit/features/api/agent/WeAgentService.kt`)
- Agent service → Agent repository: uses (evidence: `app/src/main/java/dev/ujhhgtg/wekit/features/api/agent/WeAgentService.kt`)
- Agent service → WeKit database: uses (evidence: `app/src/main/java/dev/ujhhgtg/wekit/features/api/agent/WeAgentService.kt`)
- Agent service → Model providers: uses (evidence: `app/src/main/java/dev/ujhhgtg/wekit/features/api/agent/WeAgentService.kt`)
- Agent service → Linux environments: manages (evidence: `app/src/main/java/dev/ujhhgtg/wekit/features/api/agent/WeAgentService.kt`)
- Agent service → Terminal runtime: uses (evidence: `app/src/main/java/dev/ujhhgtg/wekit/features/api/agent/WeAgentService.kt`)
- Agent service → Tool bridge: starts (evidence: `app/src/main/java/dev/ujhhgtg/wekit/features/api/agent/WeAgentService.kt`)
- Agent service → Agent triggers: coordinates (evidence: `app/src/main/java/dev/ujhhgtg/wekit/features/api/agent/WeAgentService.kt`)
- Agent loop → Model clients: streams model (evidence: `app/src/main/java/dev/ujhhgtg/wekit/agent/engine/AgentSessionEngine.kt`)
- Agent loop → Tool approval: requests approval (evidence: `app/src/main/java/dev/ujhhgtg/wekit/agent/engine/AgentSessionEngine.kt`)
- Agent loop → Tool registry: discovers tools (evidence: `app/src/main/java/dev/ujhhgtg/wekit/agent/engine/AgentSessionEngine.kt`)
- Agent tool bindings → WeChat host: accesses host
- Android module → Feature loader: configures
- Feature implementations → WeChat host: enhances
- Java scripting → WeChat APIs: exposes APIs (evidence: `app/src/main/java/dev/ujhhgtg/wekit/features/items/scripting_java/JavaEngine.kt`)
- Java scripting → Message API: exposes API (evidence: `app/src/main/java/dev/ujhhgtg/wekit/features/items/scripting_java/JavaEngine.kt`)
- Voice saving → Message API: reads messages (evidence: `app/src/main/java/dev/ujhhgtg/wekit/features/items/chat/SaveVoicesToLocalStorage.kt`)
- Extension packs → Feature implementations: extends features (evidence: `app/src/main/java/dev/ujhhgtg/wekit/features/items/scripting_java/JavaEngine.kt`)
