gdsfactory 硅光：三种拿到端口的方式 + 拖动重连

手绘端口的约定很简单：一个三角形（3 个点的多边形）就是一个端口——三角形的尖端指向就是端口朝向，三角形的底边长度就是端口宽度。所以底边要和波导等宽（这里 0.8 µm），不能随手乱画。你画的两个三角形底边都正好压在 0.8 µm 波导口上、尖端朝外，标准。下面是转换之前的样子（黄色就是你手绘的三角形）：

然后一次调用把三角形转成标准 klink Port——它读每个三角形的几何，推出朝向、宽度、位置，标成正式 Port，再把原始三角形删掉：

好问题——正因为底边=宽度、尖端=朝向，随手乱画就会翻车。这里在一条 0.8 µm 波导上画一个底边 2.5 µm（比波导宽三倍多）的三角形，转换结果就全错了：宽度被读成 1.95 µm（和波导对不上）、朝向被"长边启发式"带偏成 270°（指向下，而不是朝外的 0°）、而且因为底边压不到波导边，端口是悬空的（attached=False）。

结论：手绘端口时，三角形底边一定要和波导等宽、尖端明确朝外。klink 不会替你猜你想要的宽度——它如实地把你画的几何变成端口。画得准，端口就准。

标准 gdsfactory 器件自带端口定义，就不用手绘了。放置组件时，klink 直接从 gdsfactory 的 Port 对象把端口自动标成 klink Port，位置、朝向、宽度都跟着组件走。一个 mmi1x2 有 3 个口：输入 o1 朝左、两个输出 o2/o3 朝右。

foundry PDK 的黑箱器件不给你 gdsfactory Port 对象，但通常遵守一个约定：在波导层的 cell 边界上放一个个小 stub 方块（一种常见约定是 0.5×0.5 µm 的方块），每个 stub 就是一个光学口。klink 的做法是：你把约定告诉它（波导层是哪层、stub 多大），它就从活的实例几何里 harvest 出端口——端口是派生数据，器件在 GUI 里挪了，重新 harvest 一下就刷新。下面用一个合成的"代工厂风格"黑箱演示（不透明体在 60/0，两个 0.5×0.5 stub 在波导层 1/0）：

你点 SEND 之后，这次选中的两个端口就进了我的会话记忆，拿到一个持久 id——之后你说"我刚发的这两个口"，我就能准确对应到它们，不用你再报坐标。这两个口都在 net link0 上（左边是自定义器件的 P0，右边是 MMI 的输入 o1）。

两个口都在 link0、正好相对，直接布一条波导连上。用 gdsfactory 的 bundle 路由后端，写回 12/0 布线层。这一步之前它们中间是空的（见下图左），布完就接上了（见下图右的深色波导）。

器件挪了，但刚才那条布线还钉在旧坐标——现在它一端悬空了，和挪走的器件对不上。这就是"刚拖完、还没重新布线"那一刻：布线过期了。（这里用一次有记录的 exec.python 复现"拖动"这个 GUI 动作——只改器件位置，不动布线、不动 net。）

用同一个布线调用重跑一次——它从活的端口位置重新读（P0 这时已经在新坐标上了），把旧布线换成一条跟到新位置的波导。器件挪了，线跟上了，一条平滑的 S 弯接上，其它什么都没动。