setup

命令: /ea setup (环境/工具初始化)

功能

初始化 EA-SKILL 开发环境，一次配置长期有效：

1. 更新 Claude 权限配置（允许脚本执行 / 状态文件编辑，禁止危险操作）
2. 探测并注册工具路径（Keil UV4 / OpenOCD / J-Link）
3. 自动下载 OpenOCD（如果未安装）
4. 注册全局 CLAUDE.md 触发器（编译/烧录/串口/RTT/断点/需求分析/文档识别 关键词 → 命令文档指针）

触发

/ea setup

执行流程

步骤 1: 更新权限配置

自动更新 ~/.claude/settings.json，追加脚本执行权限：

"permissions": {
  "allow": [
    "Read", "Glob", "Grep", "Search",
    "Bash(git:status)", "Bash(git:diff)",
    "Bash(ls:*)",
    "Edit(**/.ea/**/*.md)", "Write(**/.ea/**/*.md)",
    "Edit(**/.em/**/*.md)", "Write(**/.em/**/*.md)",
    "Bash(python:*)",
    "Bash(python */EA-SKILL/tools/build-keil/*.py)",
    "Bash(python */EA-SKILL/tools/flash-openocd/*.py)",
    "Bash(python */EA-SKILL/tools/serial-monitor/*.py)",
    "Bash(python */EA-SKILL/tools/jlink-debug/*.py)",
    "Bash(py */EA-SKILL/tools/svd/*.py)",
    "Bash(py */EA-SKILL/tools/instrument/*.py)",
    "Bash(py */EA-SKILL/tools/doc-reader/*.py)",
    "Bash(py */EA-SKILL/tools/resource/*.py)",
    "Bash(py -m pip install *)",
    "Bash(python */EA-SKILL/tools/shared/*.py)"
  ],
  "ask": [
    "Write(**/.ea/discussion/**/*.md)",
    "Edit(**/.ea/discussion/**/*.md)"
  ],
  "deny": [
    "Bash(rm:*)", "Bash(sudo:*)", "Bash(git push:*)"
  ]
}

步骤 2: 探测工具路径

python EA-SKILL/tools/shared/detect_tools.py

找到的工具自动注册到 %APPDATA%/ea_skill/config.json（工作区级 .ea_skill.json 可覆盖）。

步骤 3: 注册工具

工具	config key	必须	说明
OpenOCD	openocd	✅ 必须	烧录工具（未安装则自动下载）
Keil UV4	uv4	✅ 必须	编译工具（用户手动指定）
J-Link	jlink	可选	烧录 + 调试工具（debug 命令需要）
Logic 2	logic2	可选	Saleae 逻辑分析仪软件（la 命令需要，探测到即注册）

未找到的工具：OpenOCD → 自动下载；Keil UV4 → 提示用户手动指定；其余 → 提示手动指定。

仪器工具（/ea la /ea scope，可选）

la（Saleae 逻辑分析仪）与 scope（Rigol 示波器）依赖第三方 pip 包与硬件后端，按需启用：

# 探测依赖与后端（Logic 2 软件 / 端口 / VISA 资源）
py <SKILL>/tools/instrument/scripts/deps_check.py --detect
# 缺 pip 包时安装（重依赖，确认后执行）
py <SKILL>/tools/instrument/scripts/deps_check.py --install