# easyeda-agent — 离线安装包 (v0.17.0)

面向 EasyEDA(嘉立创EDA专业版)的 AI 原生自动化层。

> 本包为**无法访问 GitHub** 的用户准备:全套文件已在包内,**手动安装无需联网**。
> 包里的 `install.sh` 会联网从 GitHub 拉取,离线环境请按下面的**手动步骤**装。
> 官网/更新: https://easyeda-agent.daboluo.cc

## 包内文件

| 文件 | 用途 |
|---|---|
| `easyeda_darwin_amd64` / `easyeda_darwin_arm64` | macOS CLI/daemon (Intel / Apple Silicon) |
| `easyeda_linux_amd64` / `easyeda_linux_arm64` | Linux CLI/daemon |
| `easyeda_windows_amd64.exe` | Windows CLI/daemon |
| `easyeda-agent-connector.eext` | EasyEDA Pro 连接器插件 |
| `skills.tar.gz` | easyeda-agent skill (Claude Code / Codex) |
| `install.sh` | 一键安装脚本(**需联网**,离线忽略) |

## 手动安装(三步)

### 1. 装 CLI

挑对应平台的二进制,改名 `easyeda` 放进 PATH。

**macOS (Apple Silicon):**
```sh
install -m 0755 easyeda_darwin_arm64 /usr/local/bin/easyeda   # 无权限则: ~/.local/bin
easyeda --version    # 应输出 easyeda-agent v0.17.0
```

**macOS (Intel):** 用 `easyeda_darwin_amd64`
**Linux:** 用 `easyeda_linux_amd64` 或 `easyeda_linux_arm64`

**Windows:** 把 `easyeda_windows_amd64.exe` 改名 `easyeda.exe`,放进某个 PATH 目录。

> macOS 首次运行若被 Gatekeeper 拦: `xattr -d com.apple.quarantine /usr/local/bin/easyeda`

### 2. 装 skill

解压 `skills.tar.gz` 到对应客户端的 skills 目录:

```sh
# Claude Code
mkdir -p ~/.claude/skills && tar -xzf skills.tar.gz -C ~/.claude/skills
# Codex
mkdir -p ~/.codex/skills  && tar -xzf skills.tar.gz -C ~/.codex/skills
```

### 3. 导入连接器插件

EasyEDA Pro →「扩展管理 → 导入扩展」→ 选 `easyeda-agent-connector.eext`。
再到「设置」里开启 **允许外部交互 / Allow external interaction**,否则连接器连不上 daemon。

> 升级注意:EasyEDA 按 UUID 去重,**必须先在「已安装」里卸载旧连接器**再导入本包的 `.eext`,
> 否则导入会静默失败。导入后**完全退出并重启 EasyEDA**,已打开的窗口仍跑旧代码。
> CLI 与连接器版本必须一致(都是 v0.17.0),`easyeda health` 会检查。

## 跑起来

```sh
easyeda daemon start          # 启动本地 daemon
easyeda health                # 确认连接器已连上(EasyEDA 需打开且已开外部交互)
```

之后在 Claude Code / Codex 里直接对话即可,skill 会驱动 `easyeda` 完成选型→放置→布线→DRC→出 PCB 全流程。

## 校验完整性

```sh
shasum -a 256 easyeda-agent-v0.17.0.zip
```

得到的值应与下载页 https://easyeda-agent.daboluo.cc/downloads/ 上标注的 SHA-256 一致。
