Skip to content

Repository files navigation

🤖 MyAI — Offline Personal AI Agent System

«運行於個人裝置上的離線私人 AI Agent 系統。»

MyAI 不是單純的聊天機器人。

它是一個以 Offline-First(離線優先) 為核心設計的私人 AI Agent 系統。

MyAI 將:

  • 🧠 Local AI
  • 🤖 Agent Core
  • 🛠️ Tool Framework
  • 💾 Memory
  • 🧩 Context
  • 🌐 Browser Automation
  • 🌍 Network Tools
  • 🛡️ Security
  • 🔧 Self-Repair
  • 🧬 Self-Extension
  • 🚀 Self-Upgrade
  • ⚙️ Runtime

整合成一個可以在個人裝置上運作的 AI 工作環境。

核心理念:

«不要只給 AI 一顆大腦。

給它記憶、工具,以及一個可以工作的環境。 🤖»


🎯 1. Product Identity — 產品定位

MyAI 的定位:

«Offline Personal AI Agent System»

它可以作為:

  • 🤖 個人 AI 助手
  • 🧠 本地 AI Agent
  • 💻 本地 AI 工作環境
  • 🛠️ AI Tool Execution Platform
  • 🌐 Browser Automation Agent
  • 💾 Memory / Knowledge System
  • 🔧 可擴充 Agent Framework

MyAI 的核心不是「聊天」。

而是:

«理解 → 思考 → 使用工具 → 觀察結果 → 修正 → 完成任務»


🧠 2. Overall Architecture — 整體架構

                     👤 User
                       │
                       ▼
              ┌─────────────────┐
              │ 🤖 MyAI Agent   │
              │      Core       │
              └────────┬────────┘
                       │
   ┌───────────────────┼───────────────────┐
   │                   │                   │
   ▼                   ▼                   ▼

🧠 Local AI 💾 Memory 🛠️ Tools │ │ │ │ │ ┌──────────┼──────────┐ │ │ ▼ ▼ ▼ │ │ Shell File Browser │ │ │ │ │ ▼ │ │ 🌐 Chromium │ │ │ │ │ ▼ │ │ CDP │ │ └───────────────────┼──────────────────────────────┘ │ ▼ 🧩 Context System │ ▼ 🛡️ Security Layer │ ▼ ⚙️ Runtime Layer │ ┌────────────┴────────────┐ ▼ ▼ 📱 Termux Runtime 🐧 Linux RootFS │ ▼ 🌐 Chromium


📴 3. Offline-First — 離線優先

MyAI 的核心設計理念是:

«Offline First,而不是 Cloud First。»

在沒有網路的情況下,MyAI 的核心能力仍然可以在本地運作。

包括:

  • 🧠 Local AI
  • 💾 Memory
  • 🧩 Context
  • 🛠️ Local Tools
  • 💻 Shell
  • 📁 File Operations
  • 🔍 Project Analysis
  • 🤖 Agent Reasoning
  • 🔧 Self-Repair / Recovery

網路不是 MyAI 的核心依賴。


🌐 4. Network Tools — 有網路時擴充能力

MyAI 並不是「永遠不能上網」。

當裝置有網路時,Agent 可以選擇使用 Network Tools。

例如:

  • 🔎 Web Search
  • 🌐 Browser
  • 📡 Network-based Tools
  • 📚 Online Information

核心邏輯:

             👤 User
                │
                ▼
             🤖 MyAI
                │
                ▼
         Can answer locally?
          ┌─────┴─────┐
         YES           NO / Online Needed
          │                    │
          ▼                    ▼
     🧠 Local AI          🌐 Network Tools
          │                    │
          └─────────┬──────────┘
                    ▼
                 Result

因此:

«離線時使用本地能力。

有網路時,可以主動使用網路工具。»

網路是能力擴充,而不是核心依賴。


🤖 5. Agent Core — AI 的大腦

Agent Core 負責整個任務執行流程。

主要能力:

  • 🔍 Task Analysis
  • 🧠 Planning
  • 🧭 Task Routing
  • 🛠️ Tool Selection
  • ⚡ Tool Execution
  • 👀 Observation
  • 🤔 Reflection
  • 🎯 Goal Verification
  • 🔧 Recovery
  • 🧬 Self-Correction

基本流程:

👤 User Request ↓ 🔍 Task Analysis ↓ 🧠 Planning ↓ 🛠️ Tool Selection ↓ 🛡️ Permission / Risk Check ↓ ⚡ Execute ↓ 👀 Observe ↓ 🤔 Reflection ↓ 🎯 Goal Verification ↓ ┌───┴───┐ │ │ 成功 失敗 │ │ ▼ ▼ STOP Recovery │ ▼ Retry


🧠 6. Local AI Engine — 本地 AI

MyAI 將 AI 模型視為可替換的推理引擎。

MyAI 本身不綁定特定模型。

使用者可以自行準備:

  • "llama.cpp"
  • 相容的 GGUF 模型

概念:

          🤖 MyAI
             │
             ▼
      🧠 Local AI Engine
             │
             ▼
         llama.cpp
             │
             ▼
         GGUF Model

模型可以依照使用者裝置自行選擇。

例如根據:

  • RAM
  • CPU
  • GPU / NPU
  • Storage
  • Model Size
  • Quantization
  • Language
  • Performance

選擇適合自己的模型。


🛠️ 7. Tool Framework — AI 的手腳

如果:

«🧠 Model = 大腦»

那麼:

«🛠️ Tools = 手腳»

MyAI 的 Tool Framework 負責管理 Agent 能使用的能力。

包含:

  • Tool Registry
  • Tool Manager
  • Tool Parser
  • Capability System
  • Permission Handling

💻 Shell / Command Tool

讓 Agent 能夠操作 Runtime。

可以用於:

  • 執行 Shell 指令
  • 系統檢查
  • Runtime 操作
  • Script 執行
  • Debug
  • 開發環境操作
  • 問題診斷

因此 Agent 不只是「告訴你 command」。

它可以在權限允許的情況下:

«真正執行 command,然後讀取結果。»


📁 File Tool

讓 Agent 能夠操作檔案。

包括:

  • 🔍 搜尋
  • 📖 讀取
  • ✏️ 修改
  • 📄 建立
  • 🗂️ 管理
  • 🧠 分析

這讓 Agent 能夠直接理解自己的工作環境與專案。


🌐 Browser Tool

提供 Browser Automation 能力。

包括:

  • Browser Agent
  • Browser Planner
  • DOM Analysis
  • Element Detection
  • Element Scoring
  • Page State
  • Tab Management
  • Failure Detection
  • Recovery

📚 Knowledge Tool

管理:

  • 專案知識
  • 文件
  • 技術資料
  • 使用者資料
  • Knowledge Base

🔍 Project Scanner

讓 Agent 可以檢查專案:

📁 Project ↓ 🔍 Scan ↓ 🗂️ Structure ↓ 📄 Source ↓ 🧠 Analysis ↓ 🤖 Agent Understanding

可用於:

  • 專案分析
  • 架構理解
  • Debug
  • Source Inspection
  • 開發輔助

🌐 8. Browser Agent — AI 的瀏覽器能力

Browser Agent 是 MyAI 的重要子系統。

架構:

🤖 MyAI ↓ 🌐 Browser Agent ↓ 🧠 Browser Planner ↓ 🌐 Browser Runtime ↓ 🔌 CDP ↓ 🌐 Chromium

Browser Agent 可以根據:

  • DOM
  • Elements
  • Page State
  • Browser State
  • Tool Results

決定下一步行動。

因此 Browser 不只是:

«「幫我開網站。」»

而是:

«讓 Agent 能理解網頁狀態並操作網頁。»


🌐 9. Chromium Runtime

MyAI 可以搭配獨立 Chromium "headless-shell" Runtime。

Repository 中包含 Chromium Runtime 所需要的相關元件。

這使 Browser Agent 可以使用受控的 Chromium 執行環境,而不需要完全依賴系統瀏覽器。


🐧 10. Linux RootFS — Chromium Runtime Environment

MyAI 包含 Linux RootFS。

它不是完整 Linux 作業系統。

主要用途是提供:

«Chromium 與相關元件所需的 Linux 相容執行環境。»

概念:

📱 Android │ ▼ 📦 Termux │ ▼ 🐧 Linux RootFS │ ▼ 🌐 Chromium


📱 11. Termux Runtime

Android 部署可以使用 Termux 作為基礎 Runtime。

Runtime 可以提供:

  • 🐍 Python
  • 💻 Shell
  • 🔧 GCC
  • 🔀 Git
  • 📦 Package Environment
  • 🛠️ Development Tools
  • 🧠 Local AI Runtime

MyAI Core 不需要把整個 Agent 架構寫死在 Termux 裡。

Termux 更像是:

«Android 上的執行環境。»


💾 12. Memory System — AI 的記憶

MyAI 將 Memory 與目前 Task Context 分開。

可以包含:

  • ⚡ Short-Term Memory

目前任務的暫時資訊。

  • 🕐 Recent Memory

近期任務與工作狀態。

  • 🧠 Long-Term Memory

需要長期保存的資訊。

  • 📚 Knowledge Memory

專案與技術知識。

概念:

         💾 Memory
             │
  ┌──────────┼──────────┐
  ▼          ▼          ▼

Short Recent Long-Term │ │ │ └──────────┼──────────┘ ▼ Knowledge


🧩 13. Context System — 當前狀態

Context 負責保存 Agent 當前正在做什麼。

例如:

  • Current Task
  • Current Goal
  • Tool Result
  • Observation
  • Task State
  • Temporary Information

Context 是短期狀態。

Memory 則負責更長期的資訊保存。


💬 14. Conversation System — 對話與自我對話

MyAI 不只可以與使用者對話。

由於 Agent 可以自行產生下一個任務步驟,因此系統可以形成:

«Self-Iteration / Self-Dialogue»

例如:

🤖 MyAI ↓ 「我需要檢查 Browser。」 ↓ 🤖 MyAI ↓ 「檢查結果顯示……」 ↓ 🤖 MyAI ↓ 「我發現另一個問題。」 ↓ 🤖 MyAI ↓ 「我需要進一步測試。」 ↓ ↻

這可以用於:

  • 任務分解
  • Reflection
  • 自動驗證
  • Debug
  • Self-Repair
  • 長任務執行

因此 Agent 不一定需要使用者每一步都輸入指令。

不過 Self-Iteration 必須受到:

  • 最大迭代次數
  • Timeout
  • Token / Resource Budget
  • Goal Verification
  • 重複偵測

等機制控制。

否則:

«AI 可能不是把問題解決,而是跟自己聊天聊到手機沒電。 🤡»


🛡️ 15. Security Layer — AI 不能想幹嘛就幹嘛

MyAI 擁有:

  • 🛡️ Command Guard
  • 🔐 Permission System
  • ⚠️ Risk Analyzer
  • 👤 Human Confirmation
  • 🧩 Capability Control

概念:

🤖 Agent Action ↓ 🔍 Capability Check ↓ ⚠️ Risk Analysis ↓ ┌─────┼─────┐ ▼ ▼ ▼ 低風險 高風險 禁止 │ │ │ ▼ ▼ ▼ 執行 👤確認 ❌拒絕

尤其當 Agent 擁有 Shell、File、Browser 與 Runtime 能力時:

«能力越強,安全控制越重要。»


🔧 16. Self-Repair — 自我檢查與修復

MyAI 的 Tool + Source Inspection + Execution 能力,使它可以朝 Self-Repair 發展。

理想流程:

👀 Inspect ↓ 🔍 Diagnose ↓ 🧠 Reason ↓ 📝 Generate Fix ↓ 💻 Modify ↓ 🧪 Test ↓ 🎯 Verify ↓ ┌──────┴──────┐ ▼ ▼ 成功 失敗 │ │ ▼ ▼ 完成 Recovery

也就是:

«看到問題 → 找原因 → 嘗試修復 → 測試 → 驗證。»


🧬 17. Self-Extension — 自我建立工具

Tool Framework 的可擴充設計,使 MyAI 理論上可以進一步支援:

«Agent-generated Tools»

例如:

🤖 發現能力缺口 ↓ 🧠 設計新 Tool ↓ 💻 生成 Tool Code ↓ 🧪 Test ↓ 🔍 Validate ↓ 🛡️ Permission ↓ 📦 Register ↓ 🛠️ 使用新能力

因此未來 MyAI 不一定只能:

«「使用開發者預先寫好的工具。」»

也可以朝:

«「發現自己缺少什麼,再建立新的能力。」»

發展。


🚀 18. Self-Upgrade — 自我升級

MyAI 的長期方向不一定是:

V1 ↓ V2 ↓ V3 ↓ V4

而可以是:

🔍 Self Inspection ↓ 🧠 Find Weakness ↓ 📝 Propose Improvement ↓ 💻 Modify ↓ 🧪 Test ↓ 📊 Benchmark ↓ 🛡️ Validate ↓ 🚀 Apply ↓ 💾 Checkpoint ↓ ↩️ Rollback if Failed

也就是:

«讓 Agent 協助自己改善,而不是只依賴開發者手動增加功能。»

Self-Upgrade 不代表無限制修改自己。

安全的 Self-Upgrade 應該包含:

  • Sandbox
  • Tests
  • Validation
  • Permission
  • Checkpoint
  • Rollback
  • Resource Limits

🧠 19. Replaceable Brain — 可替換的大腦

MyAI 不把模型當作整個產品。

模型只是:

«Local AI Engine 的一部分。»

因此可以形成:

             🤖 MyAI
                │
                ▼
         Local AI Interface
                │
      ┌─────────┼─────────┐
      ▼         ▼         ▼
   Model A   Model B   Model C

未來可以依照裝置與需求更換不同模型。


20. 🌍 Platform Independence — 不綁死平台

MyAI 的核心架構與底層 Runtime 分離。

設計目標不是只服務 Android。

理論上,只要平台能提供 MyAI 所需要的 Runtime 與相容依賴,就可以建立對應平台版本。

目前可規劃支援:

  • 🤖 Android
  • 🪟 Windows
  • 🍎 macOS
  • 🐧 Linux

不同平台可以替換平台相關元件:

  • Runtime
  • Native Binary
  • Chromium
  • System Dependencies
  • AI Runtime
  • Platform-specific Tools

而 MyAI 的核心 Agent、Memory、Context、Tool Framework 與 Security 架構可以維持相對獨立。

因此 MyAI 的概念不是:

«「一個只能在 Android 上跑的 AI。」»

而是:

«「一個可以被移植到不同平台的 Local AI Agent System。」»

例如:

Android └── Termux Runtime

Linux └── Native Linux Runtime

Windows └── Windows Runtime

macOS └── macOS Runtime

平台不同,不代表 MyAI 必須重新設計。

只需要讓底層 Runtime 與平台相關元件適配即可。

«同一個 Agent Core,不同的平台 Runtime。 🌍»

         🤖 MyAI Core
              │
   ┌──────────┼──────────┐
   ▼          ▼          ▼
🛠️ Tools   💾 Memory   🛡️ Security
              │
              ▼
         ⚙️ Runtime
              │
   ┌──────────┼──────────┐
   ▼          ▼          ▼
Android     Linux     Windows / macOS

💾 21. Backup & Migration

MyAI 可以將核心與 Runtime 拆分。

🤖 MyAI │ ├── Core ├── Tools ├── Memory ├── Knowledge └── Config

⚙️ Runtime │ ├── Termux Runtime ├── Linux RootFS └── Chromium Runtime

這使環境可以進行:

  • 💾 Backup
  • ♻️ Restore
  • 🚚 Migration
  • 🏷️ Version Management

🗂️ 22. Repository Structure

MyAI-Offline-Personal-AI-Agent-System- │ ├── 🤖 MyAI/ │ ├── core/ │ ├── data/ │ ├── knowledge/ │ ├── memory/ │ ├── runtime/ │ ├── tests/ │ ├── tools/ │ ├── agent.py │ ├── command_guard.py │ ├── context_manager.py │ ├── file_manager.py │ ├── memory_manager.py │ ├── project_scanner.py │ └── VERSION.md │ ├── 🌐 headless-shell/ │ ├── 🐧 linux-root/ │ └── 📱 termux_usr/


🏗️ 23. System Stack

                👤 USER
                   │
                   ▼
            🤖 MYAI AGENT
                   │
      ┌────────────┼────────────┐
      ▼            ▼            ▼
   🧠 AI        💾 Memory     🛠️ Tools
   Engine       Context       Framework
      │                         │
      │              ┌──────────┼──────────┐
      │              ▼          ▼          ▼
      │           💻 Shell    📁 File    🌐 Browser
      │                                      │
      ▼                                      ▼
 llama.cpp                                  CDP
      │                                      │
      ▼                                      ▼
  GGUF Model                             Chromium
                                             │
                                             ▼
                                      🐧 Linux RootFS
                                             │
                                             ▼
                                       📱 Host Runtime

🔥 24. What Makes MyAI Different?

MyAI 並不是把:

«LLM + Chat UI»

簡單組合在一起。

它更接近:

«Local AI + Agent + Tools + Memory + Runtime + Environment»

讓 AI 從:

「回答問題」

走向:

「理解問題」 ↓ 「制定計畫」 ↓ 「使用工具」 ↓ 「觀察結果」 ↓ 「修正錯誤」 ↓ 「完成任務」

更進一步:

使用能力 ↓ 檢查自己 ↓ 修復自己 ↓ 建立新能力 ↓ 改善自己


🚀 25. Future Direction

MyAI 沒有必要被限制成:

«「每一次進步都必須是一個新版本。」»

更有趣的方向是:

🧠 Think ↓ 🛠️ Act ↓ 👀 Observe ↓ 🤔 Reflect ↓ 🔧 Repair ↓ 🧬 Extend ↓ 🧪 Test ↓ 📊 Evaluate ↓ 🚀 Improve ↓ ↻

理想狀態:

«讓 MyAI 成為一個可以持續擴充、維護與改善自身能力的 Agent System。»


⚠️ 26. Important Notes

MyAI 的 Self-Repair、Self-Extension、Self-Upgrade 等方向,代表的是:

«軟體層面的 Agent 自我維護與能力擴充。»

這不代表:

  • ❌ AI 產生自我意識
  • ❌ AI 自動獲得不可控制的自主權
  • ❌ AI 能無限制修改系統
  • ❌ AI 一定能自行提升智慧

任何涉及自我修改或高風險操作的能力,都應該受到:

  • 🛡️ Permission
  • 🧪 Testing
  • 🔍 Validation
  • 💾 Backup
  • ↩️ Rollback
  • ⏱️ Resource Limits

控制。


📦 27. Requirements

MyAI 是一個模組化系統。

使用者需要依照自己的平台準備相應 Runtime。

Local AI 部分需要:

llama.cpp + Compatible GGUF Model

不同平台可以使用不同的:

  • Runtime
  • Binary
  • Browser
  • Dependencies

MyAI Core 的設計目標是不將自身永久綁定於單一平台或單一模型。


📊 28. Project Status

MyAI 是一個持續演進中的開源專案。

目前架構已包含:

  • 🤖 Agent Core
  • 🧠 Local AI Engine
  • 🛠️ Tool Framework
  • 💻 Shell / Command
  • 📁 File Operations
  • 🌐 Browser Agent
  • 🔌 CDP
  • 🌐 Chromium Runtime
  • 🐧 Linux RootFS
  • 📱 Termux Runtime
  • 💾 Memory
  • 🧩 Context
  • 🛡️ Security
  • 🔧 Recovery / Self-Correction
  • 🔍 Project Scanner
  • 🌍 Network Tools
  • 💾 Backup / Migration

部分能力仍處於實驗、開發或持續演進階段。


🎯 29. Philosophy

«AI 不應該只能聊天。

給它一顆大腦。 🧠

給它記憶。 💾

給它工具。 🛠️

給它一個環境。 ⚙️

讓它能觀察、行動、修正與成長。 🤖

然後看看它能做到什麼。 🚀»

(PS.上述功能 基本都已實作完成)


📬 聯繫創作者

  • Instagram:a370373/XRH
  • 本人17歲🤔 做的不好請見諒
  • 獨立開發 & AI協作
  • 緩慢更新 & 除錯
  • 純手機Termux 開發👀
  • 持續開發中…👀

👀作品 & 產品 集


🤖 AI 協作

MyAI 由 a370373/XRH 發起、設計與開發。

開發過程中使用 OpenAI ChatGPT 作為 AI 協作夥伴,協助進行 技術分析、程式碼檢查、除錯 & 文件整理。

產品方向、設計理念 & 最終決策由專案創作者負責。

About

🤖 以離線優先為核心的私人 AI Agent 系統,具備本地 AI、工具、記憶、瀏覽器自動化與自我修復能力/🤖 A personal AI Agent that runs in your own environment — local AI, memory, tools, browser automation, and self-repair.

Topics

Resources

Code of conduct

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages