# lllucccian/deekseep architecture

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

- Interactive diagram: https://gitdiagram.com/lllucccian/deekseep
- Repository: https://github.com/lllucccian/deekseep

## Overview

Deekseep is an LSPosed/Xposed module that runs inside the official DeepSeek Android app, adding compatibility hooks and optional user-facing features. The main lifecycle is module activation, host-process injection, hook installation, then feature behavior in the DeepSeek app; the Compose launcher provides a separate settings surface. The README establishes the integration model and supported host versions, while sampled code confirms selected hook, UI, and service behavior. Many feature modules are unsampled, so their internal wiring is not inferred.

Main entry points: [`module/src/com/dsmod/probe/Main.java`](https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/Main.java) (Module runtime), [`module/src/com/dsmod/probe/DeekseepTools.java`](https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/DeekseepTools.java) (Agent tools), [`module/src/com/dsmod/probe/SettingsActivity.java`](https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/SettingsActivity.java) (Module settings), [`module/src/com/dsmod/probe/PassiveInjectionEntry.java`](https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/PassiveInjectionEntry.java) (Injection entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_activation["Activation & host"]
  node_entry["Injection entry"]
  node_main["Module runtime<br/>[Main.java]"]
  node_compat["Host compatibility<br/>[HostCompat.java]"]
end

subgraph group_chat["Chat extensions"]
  node_chat_hooks["Chat hooks"]
  node_attachment_hooks["Attachment hooks"]
  node_chat_ui["Chat features<br/>[ChatSearchUi.java]"]
  node_appearance["Appearance controls"]
  node_glass["Glass rendering"]
end

subgraph group_agents["Agent tools"]
  node_agent_hooks["Agent hooks"]
  node_agent_tools["Agent tools<br/>[DeekseepTools.java]"]
  node_agent_runs[("Agent run history<br/>[AgentRunStore.java]")]
  node_agent_ui["Agent interface<br/>[AgentRunUi.java]"]
end

subgraph group_user["Settings &amp; accounts"]
  node_settings["Module settings"]
  node_launcher["Compose launcher"]
  node_config["Settings bridge"]
  node_accounts["Account management"]
end

subgraph group_runtime["Runtime services"]
  node_backup[("Chat backups")]
  node_local_audio["Local audio service"]
  node_qq_music["QQ Music service"]
end

node_xposed(("LSPosed/Xposed"))
node_deepseek["DeepSeek app"]

node_xposed -->|"loads module"| node_entry
node_entry -->|"enters runtime"| node_main
node_main -->|"runs in process"| node_deepseek
node_main -->|"checks host"| node_compat
node_chat_hooks -->|"hooks chat"| node_deepseek
node_attachment_hooks -->|"hooks attachments"| node_deepseek
node_agent_hooks -->|"hooks agent flow"| node_deepseek
node_chat_ui -->|"adds chat UI"| node_deepseek
node_appearance -->|"configures rendering"| node_glass
node_agent_ui -->|"reads run history"| node_agent_runs
node_settings -->|"exchanges settings"| node_config
node_launcher -->|"requests settings"| node_config
node_settings -->|"manages accounts"| node_accounts
node_agent_tools -.->|"controls playback"| node_local_audio
node_agent_tools -.->|"requests music"| node_qq_music
node_deepseek -.->|"backs up chats"| node_backup

click node_entry "https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/PassiveInjectionEntry.java"
click node_main "https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/Main.java"
click node_compat "https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/HostCompat.java"
click node_chat_hooks "https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/HookChatPipeline.java"
click node_attachment_hooks "https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/HookAttachmentPipeline.java"
click node_chat_ui "https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/ChatSearchUi.java"
click node_appearance "https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/ChatAppearance.java"
click node_glass "https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/LiquidGlassEngine.java"
click node_agent_hooks "https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/HookAgentPipeline.java"
click node_agent_tools "https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/DeekseepTools.java"
click node_agent_runs "https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/AgentRunStore.java"
click node_agent_ui "https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/AgentRunUi.java"
click node_settings "https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/SettingsActivity.java"
click node_launcher "https://github.com/lllucccian/deekseep/blob/main/compose-launcher/app/src/main/java/com/dsmod/probe/SettingsActivity.kt"
click node_config "https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/ModuleConfigBridge.java"
click node_accounts "https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/AccountManager.java"
click node_backup "https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/ChatBackupStore.java"
click node_local_audio "https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/LocalAudioPlaybackService.java"
click node_qq_music "https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/QqMusicPlaybackService.java"

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_entry,node_main,node_compat toneBlue
class node_chat_hooks,node_attachment_hooks,node_chat_ui,node_appearance,node_glass toneAmber
class node_agent_hooks,node_agent_tools,node_agent_runs,node_agent_ui toneMint
class node_settings,node_launcher,node_config,node_accounts toneRose
class node_backup,node_local_audio,node_qq_music,node_xposed,node_deepseek toneIndigo
```

## Components

### Activation & host

- [Injection entry](https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/PassiveInjectionEntry.java): `module/src/com/dsmod/probe/PassiveInjectionEntry.java`
- [Module runtime](https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/Main.java): `module/src/com/dsmod/probe/Main.java`
- [Host compatibility](https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/HostCompat.java): `module/src/com/dsmod/probe/HostCompat.java`

### Chat extensions

- [Chat hooks](https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/HookChatPipeline.java): `module/src/com/dsmod/probe/HookChatPipeline.java`
- [Attachment hooks](https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/HookAttachmentPipeline.java): `module/src/com/dsmod/probe/HookAttachmentPipeline.java`
- [Chat features](https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/ChatSearchUi.java): `module/src/com/dsmod/probe/ChatSearchUi.java`
- [Appearance controls](https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/ChatAppearance.java): `module/src/com/dsmod/probe/ChatAppearance.java`
- [Glass rendering](https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/LiquidGlassEngine.java): `module/src/com/dsmod/probe/LiquidGlassEngine.java`

### Agent tools

- [Agent hooks](https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/HookAgentPipeline.java): `module/src/com/dsmod/probe/HookAgentPipeline.java`
- [Agent tools](https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/DeekseepTools.java): `module/src/com/dsmod/probe/DeekseepTools.java`
- [Agent run history](https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/AgentRunStore.java): `module/src/com/dsmod/probe/AgentRunStore.java`
- [Agent interface](https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/AgentRunUi.java): `module/src/com/dsmod/probe/AgentRunUi.java`

### Settings & accounts

- [Module settings](https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/SettingsActivity.java): `module/src/com/dsmod/probe/SettingsActivity.java`
- [Compose launcher](https://github.com/lllucccian/deekseep/blob/main/compose-launcher/app/src/main/java/com/dsmod/probe/SettingsActivity.kt): `compose-launcher/app/src/main/java/com/dsmod/probe/SettingsActivity.kt`
- [Settings bridge](https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/ModuleConfigBridge.java): `module/src/com/dsmod/probe/ModuleConfigBridge.java`
- [Account management](https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/AccountManager.java): `module/src/com/dsmod/probe/AccountManager.java`

### Runtime services

- [Chat backups](https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/ChatBackupStore.java): `module/src/com/dsmod/probe/ChatBackupStore.java`
- [Local audio service](https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/LocalAudioPlaybackService.java): `module/src/com/dsmod/probe/LocalAudioPlaybackService.java`
- [QQ Music service](https://github.com/lllucccian/deekseep/blob/main/module/src/com/dsmod/probe/QqMusicPlaybackService.java): `module/src/com/dsmod/probe/QqMusicPlaybackService.java`

### Other components

- **LSPosed/Xposed**
- **DeepSeek app**

## Connections

- LSPosed/Xposed → Injection entry: loads module
- Injection entry → Module runtime: enters runtime
- Module runtime → DeepSeek app: runs in process
- Module runtime → Host compatibility: checks host
- Chat hooks → DeepSeek app: hooks chat
- Attachment hooks → DeepSeek app: hooks attachments
- Agent hooks → DeepSeek app: hooks agent flow
- Chat features → DeepSeek app: adds chat UI
- Appearance controls → Glass rendering: configures rendering
- Agent interface → Agent run history: reads run history
- Module settings → Settings bridge: exchanges settings
- Compose launcher → Settings bridge: requests settings
- Module settings → Account management: manages accounts
- Agent tools → Local audio service: controls playback
- Agent tools → QQ Music service: requests music
- DeepSeek app → Chat backups: backs up chats