FranxAgent工作流

FranxAgent 🤖

English | 中文

Let AI work for you like a partner – simple, secure, low cost. Now you can control the AI on your computer directly from your phone – no public IP, no port forwarding, one‑click secure remote access.

FranxAgent is a lightweight AI agent framework that enables AI to read files, execute commands, search the web, understand multimodal content, and truly interact with the world through the MCP protocol. v5.0.0 introduces a revolutionary Code Review Panel that transforms how you collaborate with AI on code changes – no more blind approvals, every edit is visible and editable before it touches your files.

---

🛠️ Tool Descriptions

MCP tool integration Add any MCP server (stdio mode) in config.json:

{
    "mcp_servers": [
        {
            "name": "windows-mcp",
            "command": "uvx",
            "args": ["windows-mcp"]
        }
    ]
}

Remote hardware (e.g., Raspberry Pi) To control remote hardware via SSH, add a configuration like:

{
  "mcp_servers": [
    {
      "name": "raspberry-gpio",
      "command": "ssh",
      "args": ["-T", "pi@raspberry-ip", "python", "/home/pi/raspberry_mcp.py"]
    }
  ]
}

Notes: - All tools (built‑in + MCP) are called via the single tools tool, saving tokens. - Built‑in tool names are fixed (e.g., read, write). MCP tools use server/tool format (e.g., windows-mcp/snapshot). - command has built‑in safety; deleting requires moving. - similarity helps with deduplication and checking. - Scheduled tasks run in background, daily repetition, no persistent user online required. - ett only supports Zhipu GLM models; ensure correct tools.ett configuration.

---

🎉 What's New in v5.0.0

• 🔍 Code Review Panel: When the AI proposes file changes, a full‑featured code editor slides in from the right, showing syntax‑highlighted code with red (deletion) and green (addition) diff markers. You can switch between view mode and edit mode, modify the code directly, and only apply changes when you approve. No more "blind trust" – every line is reviewed before it reaches your disk.
• 📊 Mermaid diagram rendering: Chat messages now render Mermaid diagrams as live SVGs – flowcharts, sequence diagrams, and more, directly in the conversation.
• 📜 Smart scrolling: The chat intelligently auto‑scrolls only when you're at the bottom; scroll up to review history without interruption.
• ✍️ Write tool reborn: The write tool no longer modifies files directly. It sends AI proposals to the frontend, where you review, edit, and approve changes – putting you firmly in control.

---

✨ Core Features

• 📱 Zero‑configuration remote access: integrated Cloudflare Tunnel – one‑click public URL, no public IP or router settings needed. Access FranxAgent on your computer directly from your phone/tablet.
• 🔐 Military‑grade security authentication: RSA asymmetric encryption + JWT short‑lived tokens, supports "refresh‑to‑re‑login" (token stored only in memory, cleared on page refresh), completely prevents long‑term control after token leakage.
• 🧠 Intelligent memory & hybrid search: conversation history automatically stored in vector database, combined with FTS5 keyword search for precise cross‑session recall.
• 🛠️ Rich built‑in tools: read, write, command, search, add_skill, etc., extensible.
• 🌐 MCP protocol support: integrate any stdio MCP server with a simple configuration – AI automatically learns to use all its tools.
• ⏰ Scheduled tasks: runs in background thread, supports daily recurring tasks – AI executes commands at specified times.
• 📚 Skill system: Markdown files in knowledge/ are automatically merged into the system prompt, giving AI extra knowledge, rules, or workflows.
• 🔒 Security first: command tool prohibits direct file deletion, suggests moving instead; high‑risk operations can require approval.
• 🕸️ Free web search: DuckDuckGo integration, no API key needed.
• 🖼️ Multimodal understanding: analyse images, videos, documents (Word, Excel, PDF, etc.).
• ⚙️ Minimal configuration: one config.json handles all settings.
• 📦 Lightweight dependencies: Minimalist dependency.
• 💻 Cross‑platform: Windows / Linux / macOS.

---