EasyDea AI Chat Box

A polished AI assistant for EasyEDA Professional Edition. EasyDea AI Chat Box converts natural-language requests into editor commands, supports multiple LLM providers, and keeps all AI interactions sandboxed inside a secure iframe.

---

Table of Contents

• What it does
• Highlights
• Requirements
• Repository structure
• Installation
• Configuration
• Usage
• Troubleshooting
• Contributing
• License

---

What it does

EasyDea AI Chat Box brings AI-powered assistance directly into the EasyEDA Professional workflow:

• Natural-language editor automation
• Real-time script execution through EasyEDA APIs
• Multi-provider model routing for resilience
• Session history, exportable logs, and diagnostics
• Fully sandboxed UI for safe extension behavior

---

Highlights

Feature	Benefit
AI-driven editor automation	Converts text prompts into EasyEDA command scripts
Multi-provider support	Works with cloud and local LLM backends for redundancy
Sandboxed iframe UI	Keeps AI interface isolated and secure
Session and transcript export	Save conversations as Markdown or copy results instantly
Diagnostic logging	See request latency, provider status, and execution results

---

Supported providers

The extension is designed to work with both cloud and local LLM backends. Supported provider categories include:

• Cloud providers: OpenRouter, Mistral, Cerebras, Cloudflare Worker AI, SambaNova, Google Gemini, Nvidia NIM, BlueMinds, FreeModel.
• Local provider: Ollama for offline or self-hosted inference.

Provider selection is managed through the settings panel.

---

Requirements

• EasyEDA Professional Edition
• EasyEDA extension developer mode enabled
• A schematic or PCB open in EasyEDA
• Optional: local Ollama server for offline LLM usage

---

Repository structure

• extension.json — Extension manifest and menu definitions
• main.js — Extension loader and parent-side execution handler
• iframe/index.html — AI chat interface
• iframe/settings.html — Provider and mode configuration
• iframe/scripts/chat.js — Chat orchestration and request handling
• iframe/scripts/settings.js — Settings persistence and provider state
• zip_helper.ps1 — Builds a compliant extension archive

---

Installation

1. Package the extension

Build the extension archive using the helper script. This ensures the archive uses forward-slash paths required by EasyEDA.

.\zip_helper.ps1

The helper produces easydea-ai-io.zip in the repository root.

2. Load into EasyEDA Pro

1. Open EasyEDA Pro.
2. Go to Advanced → Extension Manager.
3. Enable Developer Mode.
4. Click Load Extension and choose easydea-ai-io.zip.

3. Open the chat box

1. Open a schematic or PCB document.
2. In the top menu, select AI Chat Box.
3. Choose Open AI Chat Box or Settings.

---

Configuration

Provider setup

1. Open Settings from the chat UI.
2. Add provider credentials in the API Keys area.
3. Enable or disable providers as needed.
4. Select Provider Mode for a fixed backend or Auto Mode for fallback routing.

Local Ollama setup

• Host URL example: http://localhost:11434
• No API key required for Ollama
• Enable CORS in Ollama before use:

$env:OLLAMA_ORIGINS = "*"
ollama serve

Recommended workflow

• Start with Auto Mode for reliable provider fallback
• Use a local Ollama instance for secure offline inference
• Keep API keys private and only enable providers you trust

---

Usage

Quick start

• Open the AI chat box
• Enter a request describing the action you want
• Review the generated script output
• Execute the action inside EasyEDA

Example prompts

• "Place the MCU module and connect its power pins"
• "Route the 3.3V net with 45-degree traces and keep the width at 0.5mm"
• "Generate a BOM from the current schematic and export it as Markdown"
• "Rename the top layer to Signal1 and add a silkscreen label"

Best practices

• Use concise, specific instructions
• Validate generated scripts before execution
• Switch providers if one returns incomplete responses

---

Troubleshooting

• No chat panel: Verify the extension loaded successfully in the EasyEDA Extension Manager.
• Blank iframe: Rebuild with zip_helper.ps1 and reload the extension.
• Script execution failed: Confirm provider credentials, network access, and developer mode.
• Provider errors: Check your AI backend status or switch to a different enabled provider.

---

Release Notes

v1.0.0

• Initial EasyDea AI Chat Box release
• Core AI chat interface and provider configuration
• Script execution bridge for EasyEDA command automation
• Session history, Markdown export, and diagnostics

---

Contributing

This repository is open-source and contributions are welcome.

• Open issues for bugs or enhancement ideas
• Submit pull requests for fixes and improvements
• Keep code clean, documented, and aligned with EasyEDA extension conventions

---

License

Distributed under the MIT License.