From da7f2c74d6610561ed67adb8aea14f4a2cde0f7c Mon Sep 17 00:00:00 2001 From: KoheiYamashita Date: Tue, 24 Feb 2026 19:00:30 +0900 Subject: [PATCH] docs: replace ASCII architecture diagram with Mermaid Co-Authored-By: Claude Opus 4.6 --- README.ja.md | 48 +++++++++++++++++++++--------------------------- README.md | 47 +++++++++++++++++++++-------------------------- 2 files changed, 42 insertions(+), 53 deletions(-) diff --git a/README.ja.md b/README.ja.md index 5369f4d5c..987960088 100644 --- a/README.ja.md +++ b/README.ja.md @@ -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、ハートビート diff --git a/README.md b/README.md index 9b48ec3f1..649e493b0 100644 --- a/README.md +++ b/README.md @@ -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