docs: replace ASCII architecture diagram with Mermaid

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
KoheiYamashita 2026-02-24 19:00:30 +09:00
parent 17478e051c
commit da7f2c74d6
2 changed files with 42 additions and 53 deletions

View file

@ -6,33 +6,27 @@ Android 向け超軽量パーソナル AI アシスタント。Go バックエ
## アーキテクチャ
```
┌──────────────────────────────────┐
│ Android アプリ (Kotlin) │
│ ┌───────────┐ ┌───────────────┐ │
│ │ チャット │ │ アシスタント │ │
│ │ UI │ │ オーバーレイ │ │
│ │ (Compose) │ │ │ │
│ └─────┬─────┘ └───────┬──────┘ │
│ │ WebSocket │ │
│ └───────┬────────┘ │
└────────────────┼─────────────────┘
│ ws://127.0.0.1:18793
┌────────────────┼─────────────────┐
│ Go バックエンド (Termux) │
│ ┌────────┐ ┌─────────────────┐ │
│ │エージェント│ │ ツールループ │ │
│ │ ループ │ │ (16以上) │ │
│ └───┬────┘ └────────┬────────┘ │
│ │ ┌──────────┤ │
│ ┌───┴──┐ │ ┌────────┴─────────┐ │
│ │ LLM │ │ │ MCP / Cron / │ │
│ └──────┘ │ │ Skills / Memory │ │
│ ┌────────┴─┴──────────────────┐ │
│ │ チャンネル (Telegram, │ │
│ │ Discord, Slack, LINE 等) │ │
│ └─────────────────────────────┘ │
└──────────────────────────────────┘
```mermaid
graph TB
subgraph android["Android アプリ (Kotlin)"]
ChatUI["チャット UI\n(Compose)"]
Overlay["アシスタント\nオーバーレイ"]
end
subgraph backend["Go バックエンド (Termux)"]
Agent["エージェントループ"]
Tools["ツールループ\n(16以上)"]
LLM["LLM"]
Services["MCP / Cron /\nSkills / Memory"]
Channels["チャンネル\n(Telegram, Discord, Slack, LINE 等)"]
end
ChatUI -- "WebSocket\nws://127.0.0.1:18793" --> Agent
Overlay -- "WebSocket\nws://127.0.0.1:18793" --> Agent
Agent --> LLM
Agent --> Tools
Tools --> Services
Agent --> Channels
```
- **Go バックエンド** (`cmd/clawdroid/`): シングルバイナリ。エージェントループ、ツール実行、LLM 呼び出し、メッセージングチャンネル、Cron、ハートビート

View file

@ -8,32 +8,27 @@ Forked from [PicoClaw](https://github.com/sipeed/picoclaw).
## Architecture
```
┌─────────────────────────────────┐
│ Android App (Kotlin) │
│ ┌───────────┐ ┌──────────────┐ │
│ │ Chat UI │ │ Assistant │ │
│ │ (Compose) │ │ Overlay │ │
│ └─────┬─────┘ └──────┬──────┘ │
│ │ WebSocket │ │
│ └───────┬───────┘ │
└────────────────┼────────────────┘
│ ws://127.0.0.1:18793
┌────────────────┼────────────────┐
│ Go Backend (Termux) │
│ ┌────────┐ ┌────────────────┐ │
│ │ Agent │ │ Tool Loop │ │
│ │ Loop │ │ (16+ tools) │ │
│ └───┬────┘ └───────┬────────┘ │
│ │ ┌─────────┤ │
│ ┌───┴──┐ │ ┌───────┴────────┐ │
│ │ LLM │ │ │ MCP / Cron / │ │
│ └──────┘ │ │ Skills / Memory │ │
│ ┌────────┴─┴────────────────┐ │
│ │ Channels (Telegram, │ │
│ │ Discord, Slack, LINE etc.)│ │
│ └───────────────────────────┘ │
└─────────────────────────────────┘
```mermaid
graph TB
subgraph android["Android App (Kotlin)"]
ChatUI["Chat UI\n(Compose)"]
Overlay["Assistant\nOverlay"]
end
subgraph backend["Go Backend (Termux)"]
Agent["Agent Loop"]
Tools["Tool Loop\n(16+ tools)"]
LLM["LLM"]
Services["MCP / Cron /\nSkills / Memory"]
Channels["Channels\n(Telegram, Discord, Slack, LINE etc.)"]
end
ChatUI -- "WebSocket\nws://127.0.0.1:18793" --> Agent
Overlay -- "WebSocket\nws://127.0.0.1:18793" --> Agent
Agent --> LLM
Agent --> Tools
Tools --> Services
Agent --> Channels
```
- **Go backend** (`cmd/clawdroid/`): Single binary. Agent loop, tool execution, LLM calls, messaging channels, cron, heartbeat