kaoyan-electronics-diagram

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。
• 位图生成工具只可做风格参考或封面插图，不可作为需要拓扑准确的最终学习图。

固定流程

1. 确认落点：确定目标笔记、附件目录、章节归属。若来自手写图，先识别图片标题、关键文字和电路类型，不能按当前文件名硬归类。
2. 写网表卡：列出输入、输出、电源、地、关键节点、器件、端口方向、待分析模式。看不清的参数标“待确认”。
3. 先做通路规则：明确直流/交流时每个源和储能元件怎么处理。
4. 画源图：生成 SVG；输入在左、输出在右、电源在上、地在下；黑色主线、红色直流提醒、蓝色交流提醒、灰色表示被开路隔离的外部支路。
5. 导出 PNG：用 scripts/render-svg-to-png.sh 从 SVG 导出 PNG，笔记中嵌入 PNG，保留 SVG 作为可编辑源。
6. 写图注：图下方必须写“图的作用 + 关键标注/区域 + 做题结论”。
7. 回读验收：检查文件存在、图片链接、线是否断、节点是否悬空、文字是否被裁切。

网表卡模板

电路类型：
目标图：原图 / 直流通路 / 交流通路 / 微变等效 / 多格对照
输入端：
输出端：
电源与地：
关键节点：
器件与参数：
直流处理：
交流处理：
待确认：

准确性检查

• 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 观察端。
• 为多格对照图固定版式：原图/直流/交流/微变，或直接耦合/阻容耦合 × 直流/交流。