chore: update README.md and AGENTS.md

2026-04-25 07:00:48 +09:00 · 2026-03-19 13:45:20 +08:00
parent 1680316c7f
commit d3dafce615
3 changed files with 184 additions and 127 deletions
@@ -132,45 +132,55 @@ Memoh 的记忆系统围绕 **Memory Provider（记忆供应商）** 构建 —
  </tr>
 </table>

-## 技术栈
-
-| 层级 | 技术 |
-|------|------|
-| 后端 | Go, Echo, sqlc, Uber FX, pgx/v5, containerd v2 |
-| Agent 网关 | Bun, Elysia |
-| 浏览器网关 | Bun, Elysia, Playwright (Chromium) |
-| 前端 | Vue 3, Vite, Pinia, Tailwind CSS, Reka UI |
-| 存储 | PostgreSQL, Qdrant |
-| 基础设施 | Docker, containerd, CNI |
-| 工具链 | mise, pnpm, swaggo, sqlc |

 ## 架构

+```mermaid
+flowchart TB
+    subgraph Clients [" 客户端 "]
+        direction LR
+        CH["渠道<br/>Telegram · Discord · 飞书 · QQ · Email"]
+        WEB["Web 管理界面 (Vue 3 :8082)"]
+        CLI["CLI"]
+    end
+
+    CH & WEB & CLI --> API
+
+    subgraph Server [" 服务端 · Go :8080 "]
+        API["REST API & 渠道适配器"]
+
+        subgraph Agent [" 进程内 AI Agent "]
+            TWILIGHT["Twilight AI SDK<br/>OpenAI · Anthropic · Google"]
+            CONV["对话流<br/>流式输出 · Sential · 循环检测"]
+        end
+
+        subgraph ToolProviders [" 工具提供者 "]
+            direction LR
+            T_CORE["记忆 · 网络搜索<br/>定时任务 · 联系人 · 收件箱"]
+            T_EXT["容器 · 邮件 · 浏览器<br/>子代理 · 技能 · TTS<br/>MCP 联邦"]
+        end
+
+        API --> Agent --> ToolProviders
+    end
+
+    PG[("PostgreSQL")]
+    QD[("Qdrant")]
+    BROWSER["浏览器网关<br/>(Playwright :8083)"]
+
+    subgraph Workspace [" 工作区容器 · containerd "]
+        direction LR
+        BA["Bot A"] ~~~ BB["Bot B"] ~~~ BC["Bot C"]
+    end
+
+    Server --- PG
+    Server --- QD
+    ToolProviders -.-> BROWSER
+    ToolProviders -- "gRPC Bridge over UDS" --> Workspace
 ```
-┌──────────────────┐  ┌─────────────────┐  ┌──────────────┐
-│     Channels     │  │      Web UI     │  │   CLI        │
-│ (TG/DC/FS/Email) │  │  (Vue 3 :8082)  │  │              │
-└────────┬─────────┘  └────────┬────────┘  └──────┬───────┘
-         │                     │                  │
-         ▼                     ▼                  ▼
-┌──────────────────────────────────────────────────────────┐
-│                   Server (Go :8080)                       │
-│  Auth · Bots · Channels · Memory · Containers · MCP      │
-└──────────────────────┬───────────────────────────────────┘
-                       │
-           ┌───────────┼───────────┬───────────┐
-           ▼           ▼           ▼           ▼
-     ┌──────────┐ ┌─────────┐ ┌──────────────────┐ ┌───────────────────┐
-     │ PostgreSQL│ │ Qdrant  │ │ Agent Gateway     │ │ Browser Gateway    │
-     │          │ │ (向量库) │ │ (Bun/Elysia :8081)│ │ (Playwright :8083) │
-     └──────────┘ └─────────┘ └────────┬──────────┘ └───────────────────┘
-                                       │
-                               ┌───────┼───────┐
-                               ▼       ▼       ▼
-                          ┌─────┐ ┌─────┐ ┌─────┐
-                          │Bot A│ │Bot B│ │Bot C│  ← containerd
-                          └─────┘ └─────┘ └─────┘
-```
+
+## 因本项目而诞生的子项目
+
+- [**Twilight AI**](https://github.com/memohai/twilight-ai) — 轻量、地道的 Go AI SDK —— 灵感源自 [Vercel AI SDK](https://sdk.vercel.ai/)。支持多供应商（OpenAI、Anthropic、Google），提供一流的流式输出、工具调用、MCP 支持与嵌入向量生成。

 ## 路线图