KIDEX 0.1KiCad için komponent kütüphanesi yöneticisi

MPN’i yaz.
Kullanılabilir parça gelsin.

Tek, bakımlı bir KiCad kütüphanesi ve arkasında bir SQLite kataloğu. Her parça MPN’i, distribütör numaraları, JLCPCB dizgi sınıfı, besleyici yuvası ve muadilleriyle gelir — ve sen görmeden hiçbir şey yazılmaz.

GPL-3.0Python 3.11+KiCad 9 IPC API200+ test, ağsız
zsh — kidexedinme merdiveni
$ kidex add AP63205WU-7
identity   DigiKey    Diodes Incorporated · AP63205WU-7
cross-ref  LCSC       C-code · JLCPCB extended
rung 1     catalog    yeniden kullanılacak yok
rung 2     official   TSOT-23-6 — referans, kopya değil
rung 3     EasyEDA    sembol ✓  3D model ✓  alanlar temiz
──────────────────────────────────────────
? Write to the catalog?  [y/N] 
01EDİNME MERDİVENİBÖLGE B

Güvenebileceğin CAD’i bulana kadar tırmanır.

DigiKey parçayı kimin ürettiğini ve gerçek adını çözer. LCSC ve JLCPCB C-kodunu eşleştirir. Sonra KiDex dört basamağı sırayla dener, işe yarayan ilkinde durur.

  1. BASAMAK 1

    Yeniden kullan

    Katalogda eşleşen bir footprint zaten var mı? Parmak izi karşılaştırması onu bulur; yeni parça kopya eklemek yerine onu kullanır.

  2. BASAMAK 2

    Referans ver

    KiCad footprint’i ya da genel sembolü zaten içeriyor mu? KiDex resmi kütüphaneyi işaret eder, asla kopyalamaz.

  3. BASAMAK 3

    Çek

    LCSC kodu var mı? Sembol, footprint ve 3D model EasyEDA’dan gelir, standart alan setine göre temizlenir.

  4. BASAMAK 4

    Beklet & izle

    Hiçbir yerde CAD yok mu? Parça Pending’de bekler; KiDex İndirilenler klasörünü Samacsys, UltraLibrarian ya da SnapEDA zip’i için izler.

Aynı add’i tekrar çalıştırmak her zaman güvenli: ingest idempotent, üretici zip’leri güvenilmeyen girdi sayılır — zip-slip korumalı, içinden hiçbir şey çalıştırılmaz.

02TEK KÜTÜPHANE, TEK KATALOGBÖLGE C

Her parça aynı sekiz alanı taşır.

KiDex.kicad_sym, KiDex.pretty ve ortak bir 3D klasörü — artı KiCad’in veritabanı kütüphanesi olarak gezdiği bir SQLite kataloğu. Üreticinin gereksiz alanları önce kaydedilir, sonra silinir. 3D yolları hep ${KIDEX_3D} üzerinden gider, mutlak yol asla.

Boşluklar distribütörlerden enrich --missing ile doldurulur; senin girdiğin değerin üzerine asla yazmaz.

  • DigiKey · kimlik
  • LCSC · C-kodu, stok
  • JLCPCB · basic / extended
  • Mouser · fiyat
  • EasyEDA · CAD

Her API anahtarı isteğe bağlı. Eksik anahtar sadece o kaynağı kapatır.

Sembol alanları — U3KiDex:RP2040
Value
RP2040
Footprint
KiDex:QFN-56-1EP_7x7mm_P0.4mm
Datasheet
datasheets.raspberrypi.com/rp2040/…
MPN
RP2040
Manufacturer
Raspberry Pi
DigiKey_PN
— enrich --missing doldurur
LCSC_PN
C2040
Description
Çift çekirdek Cortex-M0+ MCU, 264 kB SRAM, QFN-56
JLCPCBextended
besleyiciyuva 14
muadillergrup MCU-RP
03AJAN MODUBÖLGE D–E

Bir ajana ver.
Yine de sana sormak zorunda.

Her komut kidex --json olarak da çalışır. kidex install-skill Claude Code’a protokolü öğretir; onay kapısı, ajanın sana geri getirmek zorunda olduğu bir soruya dönüşür.

tek zarf

Her komut stdout’a tek bir JSON nesnesi yazar: durum, veri, mesajlar ve varsa soru.

exit 3 = bir soru

Yazma işlemi hiçbir şeye dokunmadan önce durur. stdin’e yes basmak işe yaramaz; sadece açık bir --answer geçer.

bayat onay yok

Tekrar çalıştırmadan önce footprint eşleşmesi ya da stok değişirse soru kimliği de değişir; eski “evet” artık geçmez.

claude~/hw/sensor-psu
kidex skill
Tekrar oynatılan örnek oturum. Komutlar, JSON protokolü ve yazmadan önce durma kapısı KiDex’in gerçek davranışı; parça verileri kısaltıldı.
04KADEMELİ MUADİLLERBÖLGE F

Stok bitti mi? Değişimin gerçek bedelini bilirsin.

equiv find gerçek JLCPCB, DigiKey ve Mouser adaylarını önce kurallarla eler. LLM sadece belirsiz kalanlara bakar — hiç LLM anahtarı olmadan da çalışır.

  • [drop-in]

    Aynı footprint’e ve devreye olduğu gibi oturur.

  • [caveat]

    Oturur; farklar changes altında tek tek yazılır.

  • [redesign]

    Aynı işi görür ama footprint ya da devre değişikliği ister. Her seferinde açıkça söylenir.

  • [unverified]

    Doğrulanamadı. Asla yedek olarak önerilmez.

05ÜRETİMEBÖLGE F–G

Üç dosya, yüklemeden önce kontrol edilmiş.

fab make JLCPCB sipariş paketini hazırlar ve ön kontrol yapar: DRC, eksik C-kodları, canlı stok ve extended parça ücretleri.

Dizgi makinesi dönüş açısını fab rot ile bir kez öğret; sonraki her CPL onu uygular.

$ kidex fab make sensor-psu --boards 20
✓ gerbers.zip (9 dosya)
✓ bom_jlcpcb.csv (5 satır)
✓ cpl_jlcpcb.csv (7 yerleşim, dönüşler öğrenilmiş)

Ön kontrol:
  DRC: temiz
  ⚠ 2 extended parça — kurulum ücreti var

Paket: fab/sensor-psu/ — bu üç dosyayı yükle
06ARAYÜZBÖLGE G–H

Tıklamayı mı seversin? PCB editöründen aç.

kidex install-plugin KiCad’e bir Open KiDex düğmesi ekler. Pencere ince bir kabuk: her düğme CLI ile aynı çekirdek fonksiyonu çağırır.

1N4001 için muadilleri kademeye göre listeleyen KiDex Equiv sekmesi
ŞEKİL 1Equiv — 1N4001 için 39 aday, kademeye göre sıralı. Her satır neyin değişeceğini söyler: kaçak akım, yeni footprint, delikli gövdeden SMA’ya.
KiDex Catalog sekmesi
ŞEKİL 2Catalog — 64 parça, her alan aranabilir.
Denetim bulgularıyla KiDex Board sekmesi
ŞEKİL 3Board — açık PCB’yi IPC API üzerinden denetler: besleyicisi atanmamış parçalar, MPN’siz footprint’ler.
Tüm kontrolleri sağlıklı KiDex Doctor sekmesi
ŞEKİL 4Doctor — resmi referanslar, ODBC sürücüsü, yedekler, API anahtarları.
07KOMUT LİSTESİBÖLGE H
REFKOMUTİŞLEV
C1add <MPN|C-code>Onay kapılı tam edinme merdiveni
C2search --online <term>Katalogda ya da distribütörlerde MPN / C-kodu / serbest metin arama
C3bom <project> --pricesProje BOM’u katalogla karşılaştırılır: besleyiciler, JLCPCB sınıfı, muadiller, üretimden kalkma uyarıları, yan yana fiyatlar
C4fab make <project>JLCPCB paketi: gerber, BOM, öğrenilmiş dönüşlü CPL, ön kontrol
C5enrich --stale 90dYakın zamanda doğrulanmamış parçalarda yaşam döngüsü, stok ve fiyatı yeniden kontrol; üretimden kalkma alarmı
C6equiv find <MPN>Kanıtı ve neyin değiştiğiyle kademeli muadiller — salt okunur
C7pnp scan / setŞemalarından toplanan dizgi makinesi besleyici yuvaları
C8ingest / resume / watchBekleyen parçalar için üretici zip hattı
C9dedup / normalizeKopya footprint’leri birleştir (pin dizilimine duyarlı), alan politikasını yeniden uygula — önce deneme
C10migrate scan / applyEski kütüphanenin tek yönlü taşınması, önce deneme
C11doctorSağlık kontrolü: resmi referanslar, dosya ↔ veritabanı tutarlılığı, ODBC, dbl
C12db rebuildGit’te tutulan catalog.csv / catalog.json’dan felaket kurtarma
08NOTLAR

Aksi belirtilmedikçe.

  1. pcbnew asla import edilmez. Kütüphane dosyaları doğrudan düzenlenir; çalışan KiCad’e yalnızca IPC API ile ulaşılır. Her şey KiCad kapalıyken çalışır.
  2. Anahtar MPN’dir. Boş değer “henüz bilinmiyor” demektir, asla boş metin değil.
  3. Öner, kendiliğinden uygulama. Her API ya da LLM çıkarımı insan onayından geçer.
  4. Hiçbir şey kaybolmaz. Her yazma atomik ve yedekli; catalog.csv / .json veritabanını bayt bayt aynı yeniden kurar.
  5. Üretici zip’lerine güvenilmez. Dosya adları veridir, açma zip-slip korumalı, içinden hiçbir şey çalışmaz.
09KURULUM

İlk parçana beş dakika.

Python 3.11+, uv ve KiCad 9 gerekli. kidex dbl KiCad’e kayıt adımlarını birebir yazar; SQLite ODBC sürücüsü eksikse nasıl kurulacağını söyler.

# kidex kaynak klasöründe
$ uv sync --extra gui
$ uv tool install --editable ".[gui]"
$ source kidex-env.sh      # API anahtarların
$ kidex dbl                # KiCad’e kaydet
$ kidex install-plugin     # Open KiDex düğmesi
$ kidex install-skill      # isteğe bağlı: Claude Code
KiDex

Koray Toksöz · koray@toksoz.net

BAŞLIKKiDex — KiCad için komponent kütüphanesi yöneticisi
REV0.1.0
LİSANSGPL-3.0-or-later
SAYFA1 / 1
TARİH2026-09-25
ÇİZENKoray Toksöz
İLETİŞİMkoray@toksoz.net