NoteSmith
Gerektiğinde öne çıkan yorumlar: renkli TODO, FIXME ve benzerleri, hepsi tüm çözüm için tek bir pencerede, uzun bir dosyanın bölümleri arasında atlamak için çapalar.
Ücretsiz · Visual Studio 2022 ve 2026 · 14 arayüz dili · telemetri yok
Neden NoteSmith
Bir bakışta görünür
Etiketi yumuşak bir rozet üzerinde turuncu bir TODO, kırmızı bir FIXME, kalın bir önemli not — bir dosyanın açık soruları artık sıradan yorumların arasında saklanmaz.
Çözümdeki her TODO
Yorumlar penceresi yalnızca açık dosyaları değil, tüm kaynak dosyalarını arka planda okur ve siz kaydettikçe güncel kalır. Çift tıklama satırı açar.
Kendi etiketleriniz
REVIEW, PERF veya ekibinizin kullandığı herhangi bir sözcüğü ekleyin — en fazla 30 etiket, her biri hem koyu hem açık temada iyi okunan bir renkle.
Ücretsiz, koşulsuz
Abonelik yok, “pro” sürüm yok, veri toplama yok, Çıktı penceresinde ya da başlangıçta mesaj yok. Sizden isteyeceğimiz tek şey — bir süre kullandıktan sonra — Marketplace'te bir değerlendirme. Visual Studio 2022 ve 2026'da, x64 ve ARM64 üzerinde çalışır.
Özellikler
- Renkli etiketler: bir yorumun başındaki
TODO,FIXME,BUG,HACK,NOTE,INFOveANCHORtüm yorumu renklendirir; etiket sözcüğü yumuşak bir arka plan üzerinde kalındır. - Better Comments kısayolları:
// !önemli bir yorumu,// ?bir soruyu,////üstü çizili kodu işaretler. - Yazarlar, issue'lar ve son tarihler:
TODO(anna),#142vedue 2026-11-01tanınır; geçmiş bir tarih kırmızı olur. - Yorumlar penceresi: çözümdeki tüm etiketli yorumlar; etikete, projeye ve dosyaya göre gruplanmış, her etiket için bir filtre düğmesi, gecikmiş filtresi ve arama kutusuyla.
- Üzerine gelince kart: anlamını, yazarını, kaç gün kaldığını ve bu türdeki tüm yorumlara giden yolu görmek için işaretçiyi bir etiket sözcüğünün üzerinde bekletin.
- Çapalar:
// ANCHOR: nameuzun bir dosyanın bir bölümünü işaretler; Ctrl+K, Ctrl+, çapaları listeler ve onlara atlar. - Etiket renginde kaydırma çubuğu işaretleri: uzun bir dosyada açık soruların nerede olduğu hemen görülür.
- Yorumu olan her dil: C#, Visual Basic, F#, C++, TypeScript ve JavaScript, XAML ve XML, HTML, CSS, SQL, Python, PowerShell, Razor ve dahası; koyu ve açık temalar.
Etiketler
Etiket yorumun başında sayılır ve yazıldığı gibi eşleştirilir: TODO bir etikettir, todo ve TODOS sıradan sözcüklerdir; böylece normal cümleler asla renklenmez.
| Etiket | Anlamı |
|---|---|
TODO | Hâlâ yapılacak iş. |
FIXME, BUG | Düzeltilmesi gereken, bozuk olduğu bilinen kod. |
HACK | Düzgün bir çözümle değiştirilmesi gereken geçici bir çözüm. |
NOTE, INFO | Kodu değiştirmeden önce okumaya değer bir açıklama. |
ANCHOR | Dosyada atlanabilecek adlandırılmış bir yer. |
// ! | Kalın yazılmış önemli bir yorum. |
// ? | Açık bir soru. |
//// | Yorum satırına alınmış, üstü çizili kod. |
Yazarlar, issue'lar ve son tarihler
Etiketli bir yorumda TODO(anna) içindeki ad gri gösterilir, #142 bir bağlantı gibi vurgulanır ve due 2026-11-01, tarih geçince kırmızıya dönen bir rozet olur.
Kendi etiketleriniz
Seçenekler sayfasındaki etiket tablosu yerleşik etiketleri ve sizinkileri, en fazla 30 tane, içerir: virgülle ayrılmış sözcükler (PERF, SLOW), iki tema için hazırlanmış 12 çiftten bir renk, bir stil (etiket arka planı, kalın, düz, üstü çizili) ve Yorumlar penceresinin onu toplayıp toplamayacağı. Yerleşik etiketler kapatılabilir ve yeniden renklendirilebilir.
Çapalar
// ANCHOR: name uzun bir dosyanın bir bölümünü işaretler. Düzen → Git → NoteSmith Anchors (Ctrl+K, Ctrl+,) imlecin bulunduğu dosyanın çapalarını listeler, içinde bulunduğunuz bölüm önceden seçilidir: filtrelemek için yazın, atlamak için Enter'a basın. Çapaların da kaydırma çubuğunda işaretleri ve Yorumlar penceresinde kendi grupları vardır.
Ayarlar
Araçlar → Seçenekler → SmithWorks → NoteSmith. Her seçeneğin bir açıklaması vardır ve üstteki önizleme, seçilen etiketler ve stillerle örnek yorumları anında gösterir.
| Seçenek | Varsayılan |
|---|---|
| Yorum etiketlerini renklendir | açık |
| Better Comments kısayolları | açık |
| Etiketin arkasında arka plan | açık |
| Kaydırma çubuğunda işaretler | açık |
| Üzerine gelince kart | açık |
| Etiketler | 7 yerleşik etiket ve 3 kısayol |
| Yazarlar, issue başvuruları, son tarihler | tümü açık |
| Tüm çözümün yorumlarını topla | açık |
| Marketplace'te değerlendirme iste | açık |
Ayarlar %LocalAppData%\NoteSmith klasöründe saklanır.
SSS
Hangi diller renklendirilir?
Düzenleyicide, Visual Studio'nun yorumları renklendirdiği her dil: NoteSmith yorumları düzenleyicinin kendi renklendirmesinden alır; bu yüzden C#, Visual Basic, F#, C++, TypeScript, JavaScript, XAML, XML, HTML, CSS, SQL, Python, PowerShell, Razor ve diğerlerinde aynı şekilde çalışır. Yorumlar penceresi, kaydırma çubuğu işaretleri ve çapalar dosyaları uzantılarına göre okur: .cs, .vb, .fs, C ve C++ dosyaları, .js, .ts, .xaml, .xml, .html, .css, .scss, .sql, .py, .ps1, .cshtml, .razor, .yml ve dahası.
Küçük harfle yazılan todo neden renklendirilmiyor?
Etiketler yazıldığı gibi eşleştirilir; böylece sıradan bir cümledeki sözcük asla renklenmez. Ekibiniz böyle yazıyorsa etiket tablosuna Todo veya todo ekleyin.
Görev Listesi'nden farkı nedir?
Visual Studio'nun Görev Listesi varsayılan olarak yalnızca TODO, HACK ve UNDONE'ı düz metin olarak gösterir. Yorumlar penceresi tablodaki her etiketi kendi rengiyle gösterir, gruplar, etikete, tarihe ve metne göre filtreler ve diskteki değişiklikleri izler.
Yorumlar penceresi hangi dosyaları okur?
Çözüm klasörünün (veya açık klasörün) altındaki tüm kaynak dosyalarını; bin, obj, node_modules, .git, .vs, packages, *.Designer.cs ve *.g.cs gibi oluşturulan dosyalar, küçültülmüş betikler ve 1 MB'tan büyük dosyalar hariç. Yalnızca yoruma benzeyen dizeler ("http://…") atlanır.
Çapa listesinin kısayolunu değiştirebilir miyim?
Evet: Araçlar → Seçenekler → Ortam → Klavye, Edit.NoteSmithAnchors komutu.
NoteSmith herhangi bir veri gönderiyor mu?
Hayır. Telemetri ve ağ erişimi yoktur; kodunuz bilgisayarınızda kalır.
Bir sorunu nereye bildirebilir veya özellik önerebilirim?
GitHub'daki Feedback deposunda bir issue açın; hatalar ve fikirler için formlar vardır (özel adları değiştirin). Marketplace'teki Q&A sekmesini de kullanabilirsiniz.
Değişiklik günlüğü
1.0.1
- Uzantı işinize yaradıktan sonra Marketplace'te bir kez değerlendirme isteği — Daha sonra ve Bir daha sorma seçenekleriyle; bir ayarla kapatılabilir.
1.0.0
- İlk genel sürüm.
Yorumlar penceresi
Görünüm → Diğer Pencereler → NoteSmith Comments. Açık çözümün veya klasörün tüm etiketli yorumları; önce etikete, sonra projeye ve dosyaya göre gruplanmış. Filtre düğmeleri bir etiketi gösterir veya gizler, gecikmiş yalnızca geç kalanları bırakır, arama kutusu metne ve dosyaya göre filtreler. Dosyalar arka planda okunur —
bin,obj,node_modulesve oluşturulan dosyalar atlanır — ve diskte değiştiklerinde yeniden okunur. Çift tıklama veya Enter satırı açar.Üzerine gelince kart
İşaretçiyi bir etiket sözcüğünün veya son tarihin üzerinde bekletin: kart etiketin anlamını söyler; yazarı, kalan ya da geciken günlerle son tarihi, issue'yu ve çözümde bu türden kaç yorum olduğunu gösterir. Tüm TODO yorumları Yorumlar penceresini yalnızca o etiketle açar, Etiket ayarları… seçenekler sayfasını açar.