İçeriğe geç

Ekran kaydı, konsol ve ağ loglarıyla GitHub Issues bug raporları

Güncelleme

GitHub Issues, pek çok ürün ekibinin ve açık kaynak projenin bug'ları kodun hemen yanında takip ettiği yer. Ama "çalışmıyor" diyen bir issue, kod ne kadar yakında olursa olsun, geliştiriciye nereden başlayacağını söylemez. Midge, ekipteki herkesin bir bug'ı konsol logları, ağ istekleri ve cihaz bilgileriyle birlikte kaydetmesini, ardından Send to GitHub'a tıklayarak yapay zekânın yazdığı özeti, yeniden üretme adımlarını, olası nedeni ve kayda bağlantıyı içeren bir issue açmasını sağlar.

Nasıl çalışır

  1. Uygulamayı bir kez kur. Bir çalışma alanı yöneticisi Midge'de Settings › Workspace › Integrations'ı açar ve GitHub'da Connect'e tıklar. GitHub ondan Midge Bug Reports uygulamasını kurmasını ve issue açabileceği repoları seçmesini ister. Midge, kurulumu saklamadan önce yöneticinin GitHub girişiyle kurulumun gerçekten ona ait olduğunu kontrol eder; ardından yönetici bug'ların gideceği repoyu seçer.
  2. Bug'ı kaydet. Chrome eklentisi, Mac için Midge ya da iPhone için Midge ile ekranını kaydet veya bir ekran görüntüsü al. Rapor konsolu, ağ isteklerini, tıklamalarını ve cihaz bilgilerini alır; bunlar için ayrıca bir şey yapman gerekmez.
  3. GitHub'a gönder. Raporda Send to GitHub'a tıkla. Issue'yu uygulama açar, rapor da oluşturduğu issue'yu gösterir; böylece raporu sonradan açan herkes bug'ın zaten kaydedildiğini görür ve aynı issue iki kez açılmaz.

GitHub issue'su neleri içerir

GitHub Markdown'ı işler; bu yüzden issue, başka hiçbir şey açmadan, doğrudan repodaki issue listesinden okunabilir:

  • video, konsol ve ağ panelleriyle Midge raporuna bağlantı,
  • yapay zekâ özeti,
  • kayıtta yaptıklarından çıkarılmış, numaralı yeniden üretme adımları,
  • olası neden,
  • sayfa URL'si ile konsol hatalarının ve başarısız isteklerin sayısı.

Sondaki bir not, özetin maskelenmiş loglardan yapay zekâ tarafından yazıldığını söyler; böylece issue'yu üstlenen kişi onu körü körüne kabul etmez, kayda göre kontrol eder.

Önce senin sözlerin

Raporu gönderen kişinin yazdığı her şey, örneğin beklenen sonuç ya da hangi hesabı kullandığı, issue'da bağlantının hemen altına, yapay zekâ özetinden önce girer. İlk sözü bug'ı kendi gözüyle gören kişi söyler; özet de onun yazmaya vakit bulamadıklarını tamamlar.

En az erişim

Midge Bug Reports uygulaması, seçtiğin repolarda issues: write ve metadata: read ister, başka hiçbir şey istemez. Kodunu, pull request'lerini ya da Actions'ını okuyamaz, seçmediğin repolara da dokunamaz; bir repoyu kaldırabilir ya da uygulamayı GitHub ayarlarından istediğin zaman kaldırabilirsin.

Gizli bilgiler reponun dışında kalır

Herkese açık repolarda issue metni de herkese açıktır ve bir kez yayınlandıktan sonra kimlerin okuduğunu bilemezsin. Midge şifreleri, token'ları, çerezleri, authorization header'larını ve kart numaralarını loglar tarayıcıdan ya da telefondan çıkmadan önce siler; e-postaları ve telefon numaralarını da maskeler. Issue'nun metni de bu maskelenmiş loglardan yazılır. Kaydın kendisi ise kendi paylaşım ayarıyla Midge'de kalır: "Workspace members" (Çalışma alanı üyeleri) ya da "Only me" (Yalnızca ben), issue herkese açık olsa bile kaydı gizli tutar. Maskeleme sayfasına bak.

Issue'dan düzeltmeye

Bir geliştirici issue'yu açar, bağlantıdan kayda geçer ve bug'ın olduğu anda başarısız olan isteği ve stack trace'i görür. Sorunu kendi makinesinde yeniden üretmeye uğraşmadan nereye bakacağını bilir. Bir kodlama ajanıyla çalışıyorsa aynı bağlantı Claude Code'a ya da Cursor'a gider; ajan da konsolu, ağ isteklerini ve adımları Midge'in MCP sunucusu üzerinden okur.

Kimler kullanıyor

  • Her şeyi zaten GitHub'da takip eden ve bug'lar için ayrı bir araç daha öğrenmek istemeyen küçük ürün ekipleri.
  • Bug'ları mühendislerin zaten takip ettiği repoya kaydeden QA ve destek ekipleri.
  • Yalnızca "çalışmıyor" diyen issue'lar yerine logları eklenmiş, üzerinde hemen çalışılabilecek raporlar isteyen maintainer'lar.

Entegrasyon olmadan

Her raporun, oluşturduğunda kopyalanan bir bağlantısı da var. Onu herhangi bir issue'ya, pull request'e ya da tartışmaya elle yapıştır; aynı raporu açar. Entegrasyon ise seni bu kopyalama adımından kurtarır ve özeti senin yerine yazar.

İlgili sayfalar

Midge, GitHub entegrasyonu dahil ücretsiz: sınırsız kayıt, 15 dakikaya kadar video ve filigran yok.

Sık sorulan sorular

Midge GitHub App'inin hangi erişimleri var?
Kurarken seçtiğin repolarda issues: write ve metadata: read. Kodunu okuyamaz ya da değiştiremez.
Issue'nun yazarı olarak kim görünüyor?
Midge Bug Reports uygulaması. Issue, kaydı kimin yaptığını gösteren Midge raporuna bağlantı verir.
Gizli repolarla çalışıyor mu?
Evet, uygulamanın kurulu olduğu her repoda. Issue'nun rapora bağlantı verdiğini unutma; raporun paylaşım ayarını doğru kişilerin açabileceği şekilde yap.
GitHub Enterprise Server ya da GitLab destekleniyor mu?
Hayır, yalnızca GitHub.com. İmzalı bir webhook, kendi küçük servisin üzerinden başka yerlerde issue açabilir.