| name | kaoyan-electronics-diagram |
| description | Use when generating, redrawing, correcting, exporting, or embedding 822 electronic circuit diagrams, including textbook-style SVG/PNG diagrams, DC/AC paths, small-signal equivalents, coupling diagrams, and handwritten-note circuit redraws. |
822 电路图生成
核心原则
电路图先保证拓扑正确，再追求教材风。用于学习笔记的精确电路图不把 AI 生成图当最终依据；默认使用可编辑 SVG 作为源图，再导出 PNG 嵌入 Obsidian。
REQUIRED SUB-SKILL: Use kaoyan-electronics-circuit for circuit recognition and topology analysis.
REQUIRED SUB-SKILL: Use obsidian-markdown when writing or updating Obsidian notes.
使用边界
- 用户要求“画电路图、重绘电路图、教材风电路图、微变等效图、直流/交流通路图、把手写电路图整理进笔记”时使用。
- 只回答概念或题解、不生成图时，由
kaoyan-electronics-circuit 或 kaoyan-electronics-sop 处理。
- 写给笔记复习的电路图优先 SVG + PNG；需要用户继续拖拽修改时，可改用 Excalidraw。
- 位图生成工具只可做风格参考或封面插图，不可作为需要拓扑准确的最终学习图。
固定流程
- 确认落点：确定目标笔记、附件目录、章节归属。若来自手写图，先识别图片标题、关键文字和电路类型，不能按当前文件名硬归类。
- 写网表卡：列出输入、输出、电源、地、关键节点、器件、端口方向、待分析模式。看不清的参数标“待确认”。
- 先做通路规则：明确直流/交流时每个源和储能元件怎么处理。
- 画源图：生成 SVG；输入在左、输出在右、电源在上、地在下；黑色主线、红色直流提醒、蓝色交流提醒、灰色表示被开路隔离的外部支路。
- 导出 PNG：用
scripts/render-svg-to-png.sh 从 SVG 导出 PNG，笔记中嵌入 PNG，保留 SVG 作为可编辑源。
- 写图注：图下方必须写“图的作用 + 关键标注/区域 + 做题结论”。
- 回读验收：检查文件存在、图片链接、线是否断、节点是否悬空、文字是否被裁切。
网表卡模板
电路类型：
目标图：原图 / 直流通路 / 交流通路 / 微变等效 / 多格对照
输入端：
输出端：
电源与地：
关键节点：
器件与参数：
直流处理：
交流处理：
待确认：
准确性检查
- BJT：NPN 集电极在上、发射极在下、箭头向外；PNP 方向反向检查。
- 电源：直流分析保留偏置源；交流分析中直流电压源置零为交流地，直流电流源置零为开路。
- 电容：直流稳态开路；中频交流只有在
|X_C| 远小于相关电阻时才近似短路。
- 信号源：置零的是理想源本身；实际内阻
R_s 不要删除。
- 受控源：直流和交流分析中都保留。
- 节点：每个元件两端都要有去向；输出负载是否与
R_C 并联，必须按交流节点判断。
- 图面：不要让导线穿过文字；不要用“看起来相邻”代替真实连接。
Obsidian 写入规范
- 附件命名：
图-<知识点>-<用途>.svg 与同名 .png。
- SVG 存在附件目录作为源图；Markdown 正文嵌入 PNG：
![[.../图名.png]]。
- 图注使用普通 callout：
> [!note] 图的作用
> 说明这张图解决什么、看哪些标注、考试时得出什么结论。
- 原手写图只作折叠溯源，不能替代正文清晰图。
- 如果本次修改的 Markdown 含表格，完成后使用
fix-table-pipe 做表格检查。
导出脚本
用法：
scripts/render-svg-to-png.sh <input.svg> <output.png> [width] [height]
默认宽高为 1600 1120。不要依赖 qlmanage 作为最终导出方式；它可能把宽图裁成方图预览。
最终验收
运行并确认：
xmllint --noout <input.svg>
scripts/render-svg-to-png.sh <input.svg> <output.png> 1600 1120
file <output.png>
然后肉眼检查 PNG：四角不裁切、标题完整、导线不断、节点不悬空、颜色提示不误导。
可继续补充
- 给常见题型增加 SVG 模板：固定偏置共射、分压偏置共射、共集、共基、差分、运放反馈、数电门电路、触发器。
- 为微变等效图增加专门模板：
r_be、受控源、R_i、R_o 观察端。
- 为多格对照图固定版式：原图/直流/交流/微变，或直接耦合/阻容耦合 × 直流/交流。
