@huaqiu/dsh-kicad 0.4.6 → 0.4.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@huaqiu/dsh-kicad",
-  "version": "0.4.6",
+  "version": "0.4.7",
   "type": "module",
   "main": "./lib/index.mjs",
   "types": "./lib/index.d.mts",
@@ -22,7 +22,7 @@
     "@deepseek-ai/dsh-tools": "^0.1.0-rc.0"
   },
   "dependencies": {
-    "@huaqiu/dsh-plugin-log": "0.4.6"
+    "@huaqiu/dsh-plugin-log": "0.4.7"
   },
   "files": [
     "lib",

package/skills/kicad-ipc/scripts/add_footprint_from_board_template.py

@@ -23,25 +23,25 @@ def get_unique_footprint(board, reference: str):
         if footprint.reference_field.text.value == reference
     ]
     if len(matches) != 1:
-        raise RuntimeError(f"source reference {reference!r} 匹配到 {len(matches)} 个封装。")
+        raise RuntimeError(f"source reference {reference!r} matched {len(matches)} footprints.")
     return matches[0]
 
 
 def main() -> None:
     parser = argparse.ArgumentParser(description=__doc__)
-    parser.add_argument("--source-reference", required=True, help="作为完整定义模板的现有 reference")
-    parser.add_argument("--new-reference", required=True, help="新封装的唯一 reference")
-    parser.add_argument("--dx-mm", type=float, required=True, help="相对模板的 X 位移，单位 mm")
-    parser.add_argument("--dy-mm", type=float, required=True, help="相对模板的 Y 位移，单位 mm")
-    parser.add_argument("--save", action="store_true", help="验证成功后通过 IPC 保存 PCB")
+    parser.add_argument("--source-reference", required=True, help="existing reference to use as the full-definition template")
+    parser.add_argument("--new-reference", required=True, help="unique reference for the new footprint")
+    parser.add_argument("--dx-mm", type=float, required=True, help="X offset relative to the template, in mm")
+    parser.add_argument("--dy-mm", type=float, required=True, help="Y offset relative to the template, in mm")
+    parser.add_argument("--save", action="store_true", help="save the PCB over IPC after successful validation")
     args = parser.parse_args()
     if args.source_reference == args.new_reference:
-        parser.error("--new-reference 必须不同于 --source-reference")
+        parser.error("--new-reference must differ from --source-reference")
 
     kicad, board = connect_board()
     try:
         if any(fp.reference_field.text.value == args.new_reference for fp in board.get_footprints()):
-            raise RuntimeError(f"reference {args.new_reference!r} 已存在；未创建封装。")
+            raise RuntimeError(f"reference {args.new_reference!r} already exists; no footprint created.")
 
         source = get_unique_footprint(board, args.source_reference)
         new_footprint = source.clone()
@@ -50,9 +50,9 @@ def main() -> None:
 
         def validate(created):
             if len(created) != 1:
-                raise RuntimeError("KiCad 未创建恰好一个封装。")
+                raise RuntimeError("KiCad did not create exactly one footprint.")
             if created[0].reference_field.text.value != args.new_reference:
-                raise RuntimeError("KiCad 返回的封装 reference 与请求不一致。")
+                raise RuntimeError("KiCad returned a footprint reference that does not match the request.")
 
         created, = commit_or_drop(
             board,
@@ -60,10 +60,10 @@ def main() -> None:
             lambda: board.create_items(new_footprint),
             validate,
         )
-        print(f"已创建 {created.reference_field.text.value}: {created.id}")
+        print(f"Created {created.reference_field.text.value}: {created.id}")
         if args.save:
             board.save()
-            print("已通过 IPC 保存 PCB。")
+            print("Saved PCB over IPC.")
     finally:
         close_kicad(kicad)
 

package/skills/kicad-ipc/scripts/create_copper_zone.py

@@ -30,10 +30,10 @@ def polygon(value: str) -> PolygonWithHoles:
             x_mm, y_mm = (float(part.strip()) for part in token.split(",", 1))
             points.append((x_mm, y_mm))
     except ValueError as exc:
-        raise argparse.ArgumentTypeError("--points 格式应为 x,y;x,y;x,y，单位 mm") from exc
+        raise argparse.ArgumentTypeError("--points format should be x,y;x,y;x,y, in mm") from exc
 
     if len(points) < 3:
-        raise argparse.ArgumentTypeError("铺铜外形至少需要三个不同顶点")
+        raise argparse.ArgumentTypeError("copper zone outline needs at least three distinct vertices")
     if points[0] != points[-1]:
         points.append(points[0])
 
@@ -47,10 +47,10 @@ def polygon(value: str) -> PolygonWithHoles:
 
 def main() -> None:
     parser = argparse.ArgumentParser(description=__doc__)
-    parser.add_argument("--net", required=True, help="已存在的 PCB 网络名")
-    parser.add_argument("--layer", default="F.Cu", help="目标铜层，默认 F.Cu")
-    parser.add_argument("--points", type=polygon, required=True, help="外形顶点 x,y;x,y;...，单位 mm")
-    parser.add_argument("--save", action="store_true", help="验证成功后通过 IPC 保存 PCB")
+    parser.add_argument("--net", required=True, help="name of an existing PCB net")
+    parser.add_argument("--layer", default="F.Cu", help="target copper layer, default F.Cu")
+    parser.add_argument("--points", type=polygon, required=True, help="outline vertices x,y;x,y;..., in mm")
+    parser.add_argument("--save", action="store_true", help="save the PCB over IPC after successful validation")
     args = parser.parse_args()
 
     kicad, board = connect_board()
@@ -62,9 +62,9 @@ def main() -> None:
 
         def validate(created):
             if len(created) != 1:
-                raise RuntimeError("KiCad 未创建恰好一个区域。")
+                raise RuntimeError("KiCad did not create exactly one zone.")
             if created[0].net is None or created[0].net.name != args.net:
-                raise RuntimeError("KiCad 返回的区域网络与请求不一致。")
+                raise RuntimeError("KiCad returned a zone net that does not match the request.")
 
         created_zone, = commit_or_drop(
             board,
@@ -72,11 +72,11 @@ def main() -> None:
             lambda: board.create_items(zone),
             validate,
         )
-        print(f"已创建未填充的铺铜区域: {created_zone.id}")
-        print("审阅外形后，再运行 refill_zones.py 填充区域。")
+        print(f"Created an unfilled copper zone: {created_zone.id}")
+        print("After reviewing the outline, run refill_zones.py to fill the zone.")
         if args.save:
             board.save()
-            print("已通过 IPC 保存 PCB。")
+            print("Saved PCB over IPC.")
     finally:
         close_kicad(kicad)
 

package/skills/kicad-ipc/scripts/create_track.py

@@ -22,22 +22,22 @@ def point(value: str) -> Vector2:
     try:
         x_mm, y_mm = (float(part.strip()) for part in value.split(",", 1))
     except ValueError as exc:
-        raise argparse.ArgumentTypeError("坐标必须是 x,y（单位 mm），例如 10,20") from exc
+        raise argparse.ArgumentTypeError("coordinates must be x,y (in mm), e.g. 10,20") from exc
     return Vector2.from_xy(from_mm(x_mm), from_mm(y_mm))
 
 
 def main() -> None:
     parser = argparse.ArgumentParser(description=__doc__)
-    parser.add_argument("--net", required=True, help="已存在的 PCB 网络名")
-    parser.add_argument("--start", type=point, required=True, help="起点 x,y，单位 mm")
-    parser.add_argument("--end", type=point, required=True, help="终点 x,y，单位 mm")
-    parser.add_argument("--width-mm", type=float, required=True, help="线宽，单位 mm")
-    parser.add_argument("--layer", default="F.Cu", help="目标铜层，默认 F.Cu")
-    parser.add_argument("--save", action="store_true", help="验证成功后通过 IPC 保存 PCB")
+    parser.add_argument("--net", required=True, help="name of an existing PCB net")
+    parser.add_argument("--start", type=point, required=True, help="start point x,y, in mm")
+    parser.add_argument("--end", type=point, required=True, help="end point x,y, in mm")
+    parser.add_argument("--width-mm", type=float, required=True, help="track width, in mm")
+    parser.add_argument("--layer", default="F.Cu", help="target copper layer, default F.Cu")
+    parser.add_argument("--save", action="store_true", help="save the PCB over IPC after successful validation")
     args = parser.parse_args()
 
     if args.width_mm <= 0:
-        parser.error("--width-mm 必须大于 0")
+        parser.error("--width-mm must be greater than 0")
 
     kicad, board = connect_board()
     try:
@@ -50,9 +50,9 @@ def main() -> None:
 
         def validate(created):
             if len(created) != 1:
-                raise RuntimeError("KiCad 未创建恰好一条走线。")
+                raise RuntimeError("KiCad did not create exactly one track.")
             if created[0].width != track.width or created[0].net.name != args.net:
-                raise RuntimeError("KiCad 返回的创建结果与请求不一致。")
+                raise RuntimeError("KiCad returned a result that does not match the request.")
 
         created_track, = commit_or_drop(
             board,
@@ -61,10 +61,10 @@ def main() -> None:
             validate,
         )
 
-        print(f"已创建 track: {created_track.id}")
+        print(f"Created track: {created_track.id}")
         if args.save:
             board.save()
-            print("已通过 IPC 保存 PCB。")
+            print("Saved PCB over IPC.")
     finally:
         close_kicad(kicad)
 

package/skills/kicad-ipc/scripts/create_via.py

@@ -14,16 +14,16 @@ from kipy_common import close_kicad, commit_or_drop, connect_board, get_required
 
 def main() -> None:
     parser = argparse.ArgumentParser(description=__doc__)
-    parser.add_argument("--net", required=True, help="已存在的 PCB 网络名")
-    parser.add_argument("--x-mm", type=float, required=True, help="X 坐标，单位 mm")
-    parser.add_argument("--y-mm", type=float, required=True, help="Y 坐标，单位 mm")
-    parser.add_argument("--diameter-mm", type=float, required=True, help="外径，单位 mm")
-    parser.add_argument("--drill-mm", type=float, required=True, help="钻孔直径，单位 mm")
-    parser.add_argument("--save", action="store_true", help="验证成功后通过 IPC 保存 PCB")
+    parser.add_argument("--net", required=True, help="name of an existing PCB net")
+    parser.add_argument("--x-mm", type=float, required=True, help="X coordinate, in mm")
+    parser.add_argument("--y-mm", type=float, required=True, help="Y coordinate, in mm")
+    parser.add_argument("--diameter-mm", type=float, required=True, help="outer diameter, in mm")
+    parser.add_argument("--drill-mm", type=float, required=True, help="drill diameter, in mm")
+    parser.add_argument("--save", action="store_true", help="save the PCB over IPC after successful validation")
     args = parser.parse_args()
 
     if args.drill_mm <= 0 or args.diameter_mm <= args.drill_mm:
-        parser.error("必须满足 0 < --drill-mm < --diameter-mm")
+        parser.error("must satisfy 0 < --drill-mm < --diameter-mm")
 
     kicad, board = connect_board()
     try:
@@ -35,9 +35,9 @@ def main() -> None:
 
         def validate(created):
             if len(created) != 1:
-                raise RuntimeError("KiCad 未创建恰好一个过孔。")
+                raise RuntimeError("KiCad did not create exactly one via.")
             if created[0].net.name != args.net:
-                raise RuntimeError("KiCad 返回的创建结果与请求不一致。")
+                raise RuntimeError("KiCad returned a result that does not match the request.")
 
         created_via, = commit_or_drop(
             board,
@@ -46,10 +46,10 @@ def main() -> None:
             validate,
         )
 
-        print(f"已创建 via: {created_via.id}")
+        print(f"Created via: {created_via.id}")
         if args.save:
             board.save()
-            print("已通过 IPC 保存 PCB。")
+            print("Saved PCB over IPC.")
     finally:
         close_kicad(kicad)
 

package/skills/kicad-ipc/scripts/diagnose_ipc_connection.py

@@ -13,30 +13,30 @@ def main() -> int:
     try:
         from kipy import KiCad
     except ModuleNotFoundError:
-        print("未找到 kicad-python/kipy。请使用 KiCad IPC 插件环境或安装匹配的官方包。")
+        print("kicad-python/kipy not found. Use the KiCad IPC plugin environment or install the matching official package.")
         return 2
 
     kicad = None
     try:
         kicad = KiCad(timeout_ms=5000)
         if not kicad.check_version():
-            print("已连接，但 kicad-python 与 KiCad API 版本不匹配。")
+            print("Connected, but kicad-python and the KiCad API version do not match.")
             return 3
 
         board = kicad.get_board()
         if board is None:
-            print("已连接 KiCad API，但 PCB Editor 中没有打开 .kicad_pcb。")
+            print("Connected to KiCad API, but no .kicad_pcb is open in PCB Editor.")
             return 4
 
-        print(f"已连接 KiCad {kicad.get_version()}。")
-        print(f"当前 PCB: {board.name}")
+        print(f"Connected to KiCad {kicad.get_version()}.")
+        print(f"Current PCB: {board.name}")
         return 0
     except Exception as exc:
-        print(f"无法连接 KiCad IPC API: {exc}")
-        print("请确认：")
-        print("  1. 已打开 PCB Editor（仅打开项目管理器还不够）。")
-        print("  2. 在 KiCad 的 偏好设置 → 插件 中启用了 API 服务，并已重启 PCB Editor。")
-        print("  3. 若在 DSH 中执行，当前任务拥有 Full Access；非 Full Access 无法访问 KiCad 命名管道。")
+        print(f"Could not connect to KiCad IPC API: {exc}")
+        print("Please confirm:")
+        print("  1. PCB Editor is open (opening the project manager alone is not enough).")
+        print("  2. The API service is enabled in KiCad Preferences -> Plugins, and PCB Editor has been restarted.")
+        print("  3. If running in DSH, the current task has Full Access; without Full Access the KiCad named pipe cannot be accessed.")
         return 1
     finally:
         if kicad is not None:

package/skills/kicad-ipc/scripts/kipy_common.py

@@ -16,12 +16,12 @@ def connect_board(timeout_ms: int = 5000):
 
     if not kicad.check_version():
         raise RuntimeError(
-            "kicad-python 与已连接 KiCad 的 API 版本不匹配；请使用匹配的官方包。"
+            "kicad-python does not match the connected KiCad's API version; use the matching official package."
         )
 
     board = kicad.get_board()
     if board is None:
-        raise RuntimeError("没有打开的 PCB；请先在 PCB Editor 中打开 .kicad_pcb。")
+        raise RuntimeError("No PCB is open; please open a .kicad_pcb in PCB Editor first.")
 
     return kicad, board
 
@@ -38,7 +38,7 @@ def get_required_net(board, name: str):
     for net in board.get_nets():
         if net.name == name:
             return net
-    raise ValueError(f"PCB 中不存在网络 {name!r}；请先从原理图同步网络。")
+    raise ValueError(f"Net {name!r} does not exist in the PCB; please sync nets from the schematic first.")
 
 
 def resolve_copper_layer(board, name: str):
@@ -48,7 +48,7 @@ def resolve_copper_layer(board, name: str):
         if layer != BoardLayer.BL_UNDEFINED:
             if layer in board.get_enabled_layers():
                 return layer
-            raise ValueError(f"层 {name!r} 未在当前 PCB 中启用。")
+            raise ValueError(f"Layer {name!r} is not enabled in the current PCB.")
 
     standard_layers = {
         "F.Cu": BoardLayer.BL_F_Cu,
@@ -58,11 +58,11 @@ def resolve_copper_layer(board, name: str):
         layer = standard_layers[name]
     except KeyError as exc:
         raise ValueError(
-            f"无法在此 KiCad 版本解析层 {name!r}；请使用 F.Cu/B.Cu 或升级。"
+            f"Cannot resolve layer {name!r} in this KiCad version; use F.Cu/B.Cu or upgrade."
         ) from exc
 
     if hasattr(board, "get_enabled_layers") and layer not in board.get_enabled_layers():
-        raise ValueError(f"层 {name!r} 未在当前 PCB 中启用。")
+        raise ValueError(f"Layer {name!r} is not enabled in the current PCB.")
     return layer
 
 

package/skills/kicad-ipc/scripts/move_rotate_footprint.py

@@ -17,20 +17,20 @@ def get_footprint(board, reference: str):
         if footprint.reference_field.text.value == reference
     ]
     if len(matches) != 1:
-        raise RuntimeError(f"reference {reference!r} 匹配到 {len(matches)} 个封装；未做修改。")
+        raise RuntimeError(f"reference {reference!r} matched {len(matches)} footprints; no changes made.")
     return matches[0]
 
 
 def main() -> None:
     parser = argparse.ArgumentParser(description=__doc__)
-    parser.add_argument("--reference", required=True, help="目标封装 reference，例如 R1")
-    parser.add_argument("--dx-mm", type=float, default=0.0, help="X 位移，单位 mm")
-    parser.add_argument("--dy-mm", type=float, default=0.0, help="Y 位移，单位 mm")
-    parser.add_argument("--rotation-deg", type=float, default=0.0, help="增量旋转角度，单位度")
-    parser.add_argument("--save", action="store_true", help="验证成功后通过 IPC 保存 PCB")
+    parser.add_argument("--reference", required=True, help="target footprint reference, e.g. R1")
+    parser.add_argument("--dx-mm", type=float, default=0.0, help="X offset, in mm")
+    parser.add_argument("--dy-mm", type=float, default=0.0, help="Y offset, in mm")
+    parser.add_argument("--rotation-deg", type=float, default=0.0, help="incremental rotation angle, in degrees")
+    parser.add_argument("--save", action="store_true", help="save the PCB over IPC after successful validation")
     args = parser.parse_args()
     if args.dx_mm == 0 and args.dy_mm == 0 and args.rotation_deg == 0:
-        parser.error("至少指定一个位移或旋转参数")
+        parser.error("specify at least one offset or rotation parameter")
 
     kicad, board = connect_board()
     try:
@@ -42,9 +42,9 @@ def main() -> None:
 
         def validate(updated):
             if len(updated) != 1:
-                raise RuntimeError("KiCad 未更新恰好一个封装。")
+                raise RuntimeError("KiCad did not update exactly one footprint.")
             if updated[0].position == old_position and updated[0].orientation == old_orientation:
-                raise RuntimeError("KiCad 没有应用封装变换。")
+                raise RuntimeError("KiCad did not apply the footprint transform.")
 
         updated, = commit_or_drop(
             board,
@@ -52,10 +52,10 @@ def main() -> None:
             lambda: board.update_items(footprint),
             validate,
         )
-        print(f"已更新 {args.reference}: position={updated.position}, orientation={updated.orientation}")
+        print(f"Updated {args.reference}: position={updated.position}, orientation={updated.orientation}")
         if args.save:
             board.save()
-            print("已通过 IPC 保存 PCB。")
+            print("Saved PCB over IPC.")
     finally:
         close_kicad(kicad)
 

package/skills/kicad-ipc/scripts/refill_zones.py

@@ -10,21 +10,21 @@ from kipy_common import close_kicad, connect_board
 
 def main() -> None:
     parser = argparse.ArgumentParser(description=__doc__)
-    parser.add_argument("--save", action="store_true", help="填充完成后通过 IPC 保存 PCB")
+    parser.add_argument("--save", action="store_true", help="save the PCB over IPC after filling")
     args = parser.parse_args()
 
     kicad, board = connect_board(timeout_ms=30000)
     try:
         zones = list(board.get_zones())
         if not zones:
-            print("当前 PCB 没有区域，无需填充。")
+            print("The current PCB has no zones; nothing to fill.")
             return
 
         board.refill_zones(block=True, max_poll_seconds=120.0)
-        print(f"已请求并等待 {len(zones)} 个区域填充完成。")
+        print(f"Requested and waited for {len(zones)} zones to finish filling.")
         if args.save:
             board.save()
-            print("已通过 IPC 保存 PCB。")
+            print("Saved PCB over IPC.")
     finally:
         close_kicad(kicad)
 

package/skills/kicad-ipc/scripts/remove_selected_items.py

@@ -10,28 +10,28 @@ from kipy_common import close_kicad, commit_or_drop, connect_board
 
 def main() -> None:
     parser = argparse.ArgumentParser(description=__doc__)
-    parser.add_argument("--yes", action="store_true", help="确认删除当前选择中的所有对象")
-    parser.add_argument("--save", action="store_true", help="删除后通过 IPC 保存 PCB")
+    parser.add_argument("--yes", action="store_true", help="confirm deletion of all objects in the current selection")
+    parser.add_argument("--save", action="store_true", help="save the PCB over IPC after deletion")
     args = parser.parse_args()
     if not args.yes:
-        parser.error("删除需要显式传入 --yes")
+        parser.error("deletion requires passing --yes explicitly")
 
     kicad, board = connect_board()
     try:
         targets = list(board.get_selection())
         if not targets:
-            raise RuntimeError("KiCad 当前没有选择对象；未做任何修改。")
+            raise RuntimeError("KiCad currently has no selection; no changes made.")
 
-        print(f"即将删除当前选择中的 {len(targets)} 个对象。")
+        print(f"About to delete {len(targets)} objects in the current selection.")
         commit_or_drop(
             board,
             f"Delete {len(targets)} selected items",
             lambda: board.remove_items(targets),
         )
-        print("已删除当前选择中的对象。")
+        print("Deleted objects in the current selection.")
         if args.save:
             board.save()
-            print("已通过 IPC 保存 PCB。")
+            print("Saved PCB over IPC.")
     finally:
         close_kicad(kicad)
 

package/skills/kicad-ipc/scripts/update_selected_track_width.py

@@ -13,17 +13,17 @@ from kipy_common import close_kicad, commit_or_drop, connect_board
 
 def main() -> None:
     parser = argparse.ArgumentParser(description=__doc__)
-    parser.add_argument("--width-mm", type=float, required=True, help="目标线宽，单位 mm")
-    parser.add_argument("--save", action="store_true", help="验证成功后通过 IPC 保存 PCB")
+    parser.add_argument("--width-mm", type=float, required=True, help="target track width, in mm")
+    parser.add_argument("--save", action="store_true", help="save the PCB over IPC after successful validation")
     args = parser.parse_args()
     if args.width_mm <= 0:
-        parser.error("--width-mm 必须大于 0")
+        parser.error("--width-mm must be greater than 0")
 
     kicad, board = connect_board()
     try:
         targets = [item for item in board.get_selection() if isinstance(item, (Track, ArcTrack))]
         if not targets:
-            raise RuntimeError("当前 KiCad 选择中没有直线或圆弧走线；未做任何修改。")
+            raise RuntimeError("The current KiCad selection has no straight or arc tracks; no changes made.")
 
         requested_width = from_mm(args.width_mm)
         for target in targets:
@@ -31,9 +31,9 @@ def main() -> None:
 
         def validate(updated):
             if len(updated) != len(targets):
-                raise RuntimeError("KiCad 未更新全部目标走线。")
+                raise RuntimeError("KiCad did not update all target tracks.")
             if any(item.width != requested_width for item in updated):
-                raise RuntimeError("KiCad 未接受全部目标线宽。")
+                raise RuntimeError("KiCad did not accept all target widths.")
 
         updated = commit_or_drop(
             board,
@@ -42,10 +42,10 @@ def main() -> None:
             validate,
         )
 
-        print(f"已更新 {len(updated)} 条选中走线。")
+        print(f"Updated {len(updated)} selected tracks.")
         if args.save:
             board.save()
-            print("已通过 IPC 保存 PCB。")
+            print("Saved PCB over IPC.")
     finally:
         close_kicad(kicad)
 

package/skills/kicad-ipc/scripts/verify_live_ipc.py

@@ -23,7 +23,7 @@ def main() -> None:
     try:
         nets = {net.name: net for net in board.get_nets()}
         if "GND" not in nets:
-            raise RuntimeError("烟测要求当前板已有 GND 网络。")
+            raise RuntimeError("The smoke test requires the current board to already have a GND net.")
         source = board.get_footprints()[0]
         before = (len(board.get_tracks()), len(board.get_vias()), len(board.get_zones()), len(board.get_footprints()))
 
@@ -79,7 +79,7 @@ def main() -> None:
 
         after = (len(board.get_tracks()), len(board.get_vias()), len(board.get_zones()), len(board.get_footprints()))
         if after != before:
-            raise RuntimeError(f"drop_commit 后对象数量不匹配：before={before}, after={after}")
+            raise RuntimeError(f"object count mismatch after drop_commit: before={before}, after={after}")
         print("IPC live smoke test passed; all temporary changes were dropped and not saved.")
     finally:
         if commit is not None: