---
name: eda
description: 电路原理讲解报告（schemdraw 原理图）；电路与原理图任务使用。
---

# visual-report · eda — 电路 / EDA 场景

公共规范（铁律 / 嵌入路径 / 暗色 / 渲染器兼容 / 缺装降级总则 / 自检模板）一律见 `${SKILL_DIR}/../core/SKILL.md`，本文件只写场景增量，不复制通用规则。工具链现状与全量链接验证见 `${SKILL_DIR}/../README.md`。

## 1. 触发条件

- **原理图讲解**：放大器 / 滤波器 / 电源 / 接口电路等拓扑与工作原理说明，需配真实渲染的原理图。
- **电路分析类报告**：增益 / 带宽 / 噪声 / 静态工作点等由拓扑推导的定量分析，需原理图佐证推导链条。
- **版图 / 截面展示类报告**：PCB 叠层、芯片剖面、封装结构。schemdraw 不做版图——此类图用 EDA 工具（KiCad / 版图工具）原生导出后按 core §2 嵌入；无原生导出时降级为文字分层描述，不手画。

## 2. 报告骨架模板

四节顺序固定；首屏结论先行、≤3 图预算、目录阈值等通用体例按插件 skill 与 core §1：

```markdown
# <电路名称>——<一句话功能结论>

## 电路功能
（输入是什么物理量/信号、输出是什么、关键指标量级；第一段就给结论）

## 原理图
（schemdraw 渲染图 1 张 + 全部位号；图注给信号路径一句话）

## 逐级工作原理
（按信号流向逐级：输入级 → 中间级 → 输出级 → 反馈网络；每级一段，公式只用 $...$ 行内式）

## 关键参数表
| 参数 | 符号/位号 | 数值或表达式 | 来源口径 |
|---|---|---|---|
```

图预算：原理图 1 张为必画项；逐级分析配图（局部重画 / 波形 / 频响）合计 ≤2 张，超限降级表格并按 core §1.3 加「图预算超限」声明。

## 3. 工具链与自检

schemdraw 是本场景主渲染器（电路原理图的唯一合规生成方式）。**2026-10-04 在 viz-venv 实测**：`pip show` 未装 → `pip install schemdraw` 装得 **0.23**（纯 Python，依赖 matplotlib，viz-venv 已满足）。检测命令与链接记录引用 README（当日验证、当日引用；超 30 天引用前须复测）：

| 工具 | 用途 | 本机检测命令（实测） | 官方链接 | 链接验证记录 | 缺装降级策略 |
|---|---|---|---|---|---|
| schemdraw | 电路原理图（真实渲染 PNG/SVG） | `C:\Users\Kai\.nebflow\tools\viz-venv\Scripts\python.exe -m pip show schemdraw` → schemdraw 0.23 | https://schemdraw.readthedocs.io/en/latest/ · https://pypi.org/project/schemdraw/ | README 全工具链接验证表：200 · 200（2026-10-04） | 纯文字网表 / 引脚表 / 参数表格描述；不得手画 SVG，不得空转 |

配套（本机已有，状态与 Mac 差异见 README 表）：matplotlib 3.11.2（波特图 / 频响 / 噪声谱）；graphviz 16.1.0（系统框图 / 信号链拓扑，`tools\graphviz\bin\dot.exe` 全路径调用）。Python 包只装进 viz-venv（core §5）；MSYS 传 Windows 路径参数加 `MSYS2_ARG_CONV_EXCL='*'`。

## 4. 质量红线

1. **元件参数与拓扑不得含歧义臆造值**：原理图必须有位号；元件值（阻容感 / 型号）只能来自用户给的图纸 / 网表 / BOM / 文献。推演或示例值必须显式标注「示例值 / 典型值」并给量级依据；拿不准就只标位号不标值。级间耦合方式（阻容 / 直接 / 变压器）按源材料，不得脑补。
2. **禁止手画 SVG**（core 铁律 1 场景化）：禁止线段 / 矩形拼运放三角形与晶体管符号，禁止 ASCII 电路；一切原理图必须 schemdraw（或 EDA 工具原生导出）真实渲染。
3. **先落盘后嵌入**：图必须 schemdraw 渲染成功写出 PNG/SVG 文件后再按 core §2 路径嵌入；渲染报错走第 3 节降级（文字网表 / 参数表），禁止占位图 / 失败截图充数。
4. **数值逐字**（core 铁律 2）：增益 / 带宽 / 时间常数等计算结果与公式、数据源口径逐字一致；手册或仿真数值标注来源口径。

## 5. 示例

- demo 文档：`${SKILL_DIR}/../core/references/demos/eda.md` —— 电荷灵敏前置放大器（JFET 输入 + 反馈电容 Cf 并联泄放电阻 Rf + 射极跟随输出级），亮 / 暗双主题 PNG，逐元件图注。
- 复现脚本：`${SKILL_DIR}/../core/references/demos/eda_cspa_schematic.py`（viz-venv 直跑，schemdraw 0.23）。