DeepWorkPlan Vim

DeepWorkPlan Vim, Deep Work Plan için terminal düzenleyicisidir: terminalde çalışan insanlar ve kodlama ajanları için bir Neovim yapılandırması. Planlarınız, belgeleriniz ve tüm komutların dizini tek bir tuş uzağınızda.

Ayrı bir üründür ve Deep Work Plan v7’nin (v7.0.0) isteğe bağlı vim eklentisi olarak sunulur. Deep Work Plan herhangi bir düzenleyiciyle ya da hiçbiriyle çalışır; düzenleyici de Deep Work Plan gerektirmez: bir makineye tek başına eklersiniz ve plan olsun ya da olmasın düzenleyici olarak çalışır. Bu sayfa v0.5.0 sürümünü anlatır.

Deep Work Plan için neden terminal düzenleyicisi

Deep Work Plan, .dwp/plans/ altında bir Markdown klasörüdür: bir hedef, atomik görevler, doğrulama kapıları ve sürekli bir günlük. İnsanlar gözden geçirir, ajanlar yürütür ve ikisi de çoğu zaman bunu terminalde yapar. Bu iş için yapılmış bir düzenleyici üç şeyi yakın tutar: planın kendisini, çevresindeki belgeleri ve sizi ikisi arasında gezdiren tuşları.

DeepWorkPlan Vim işte bu düzenleyicidir. Dil sunucuları, tamamlama, lint, biçimlendirme, bulanık arama, bir dosya ağacı ve seçilmiş renk temalarını tembel yükleme ile sunan özenle hazırlanmış bir Neovim yapılandırması; üstüne onu Deep Work Plan düzenleyicisi yapan birkaç yüzey eklenir.

Tur: eskimeyen bir komut dizini

SPC h h tuşlarına (Boşluk, leader tuşudur) basın ya da :DwpCommands komutunu çalıştırın; düzenleyici sahip olduğu her eşlemeyi tek satırlık bir açıklamayla listeler. Liste canlı tuş eşlemelerinden üretilir; bu yüzden herhangi bir yerde tanımlanan bir eşleme kayıt gerekmeden dizinde görünür ve dizin eskiyemez.

Turun tamamı bu: nvim başlatın, ardından Boşluk, h, h tuşlarına basın.

Neler elde edersiniz

Beş özellik, her biri tek bir tuş uzağınızda.

Düzenleyiciden çıkmadan planlar

SPC P, :DwpPlans ya da durum satırı bölümüne bir tıklama plan kenar çubuğunu açar. Geçerli dizindeki ve Neovim yapılandırma dizinindeki her .dwp/plans/ klasörünü kapsar ve planları en çok dikkat isteyenden başlayarak gruplar. Düzenleyicide etiketler Working, Needs attention, Ready, Not started ve Done biçimindedir. Her plan bir ilerleme çubuğu gösterir.

Okuyucuyu açmak için bir plan üzerinde Enter’a basın: tek cümlelik hedef, durum ve ilerleme, geçerli görevin işaretlendiği görev listesi ve planın kendi dosyalarına sade bir dille atlamalar. Durum satırı canlı etkin planı gösterir, başlangıç ekranı ise ilk üçü listeler. Bu yüzeyler planları açıklar; .dwp/ altına asla yazmaz.

Bir planın Markdown dosyalarını yerinde okumak için SPC m p geçerli arabelleği tarayıcıda önizler, SPC m r ise arabellek içinde işler. İkisi de yalnızca Markdown arabelleklerinde çalışır.

Kurulum

Kurulum üç komuttan oluşur: betiği indirin, bu sitenin sunduğu dosyanın SHA-256 değeriyle karşılaştırın, ardından çalıştırın. Kurulum programı kendi sürümüne sabitlenmiştir; bu nedenle tam olarak bu sayfanın anlattığı sürüm olan v0.5.0 sürümünü kurar. İsterseniz başka bir sürüm seçin.

curl -fsSL -o install.sh https://deepworkplan.com/vim/install.sh && \
echo "4890c140528d6b8d19b6bbc4102051e0b9dce2e26f43a693bdeab2e1cd8e196b  install.sh" | shasum -a 256 -c && \
bash install.sh

Kurulum programı sırayla şunları yapar:

1. İşletim sisteminizi ve paket yöneticinizi denetler; git, curl ve bir Lua yorumlayıcısı eksikse kurar (--skip-packages ile hiçbirini kurmaz).
2. Sürümü çözümler: kendi sürümünü ya da --version ile istenen sürümü.
3. --nvim X.Y.Z ile o Neovim sürümünü ~/.local/opt içine kurar ve Neovim’in yayımladığı SHA-256 değeriyle doğrular.
4. Mevcut bir Neovim yapılandırmasına dokunmadan önce sorar. Terminal yoksa durur ve hiçbir şeyi değiştirmez; ancak --yes o yapılandırmayı kenara taşımasını söylerse taşır.
5. Depoyu ~/.config/nvim içine klonlar ya da zaten oradaysa günceller.
6. Deponun kendi lua install.lua komutunu çalıştırır.
7. Eklentileri başsız modda kurar ve denetler; kapatıp yeniden açma adımı yoktur. --strict ile başarısız ya da eksik bir eklenti kurulumu hata sayılır.

Burada sunulan betik, v0.5.0 etiketindeki install.sh dosyasının bayt bayt aynı bir kopyasıdır. Sağlama toplamı hemen yanında, https://deepworkplan.com/vim/install.sh.sha256 adresinde sunulur; böylece indirmeyi shasum -a 256 -c install.sh.sha256 ile (Linux’ta sha256sum -c install.sh.sha256 ile) doğrulayabilirsiniz. İkinci bir kaynaktan denetim için onu GitHub sürümündeki SHA256SUMS dosyasının install.sh satırıyla karşılaştırın. Tüm seçenekleri listelemek için bash install.sh --help çalıştırın.

Sürüm seçimi

Kurulum programı varsayılan olarak kendi sürümünü, yani v0.5.0 sürümünü kurar. Başka bir sürüm seçmek için DWP_VIM_VERSION değerini ayarlayın ya da --version geçirin: ikisi de aynı işi yapar, bu yüzden hangisi daha okunaklıysa onu kullanın; bayrak, ortam değişkenine üstün gelir. Her ikisi de şunları kabul eder:

Yukarıdaki indirme ve sağlama toplamı denetiminden sonra:

# exact version
DWP_VIM_VERSION=0.5.0 bash install.sh
bash install.sh --version 0.5.0

# minimum floor: the newest stable release at or above 0.4.2
DWP_VIM_VERSION='>=0.4.2' bash install.sh

# latest stable release
bash install.sh --version latest

Kabuğun > işaretini yönlendirme olarak okumaması için alt sınırı tırnak içine alın. Sürümler yalnızca kararlı sürüm etiketlerine çözümlenir. Bir dal ya da commit için bunun yerine DWP_VIM_REF değerini ayarlayın (DWP_VIM_REF=main, main dalını izler); birbiriyle çelişen bir sürüm ve bir ref hatadır.

Kapsayıcılar ve CI

Terminalin olmadığı ve çoğu zaman root yetkisinin de bulunmadığı bir imajda ya da CI işinde betiği indirip doğrulayın, ardından sonucu yeniden üretilebilir kılan bayraklarla tek adımda çalıştırın:

curl -fsSL -o install.sh https://deepworkplan.com/vim/install.sh && \
curl -fsSL -o install.sh.sha256 https://deepworkplan.com/vim/install.sh.sha256 && \
sha256sum -c install.sh.sha256 && \
bash install.sh --version 0.5.0 --nvim 0.12.5 --skip-packages --strict

• --version 0.5.0 düzenleyici sürümünü sabitler.
• --nvim 0.12.5 o Neovim sürümünü ~/.local/opt/nvim-v0.12.5 içine kurar, ~/.local/bin/nvim olarak bağlar ve Neovim’in yayımladığı SHA-256 değeriyle doğrular (Linux ve macOS).
• --skip-packages hiçbir sistem paketi kurmaz: imaj git, curl ve Lua’yı zaten sağlamalıdır.
• --strict, başsız eklenti kurulumu başarısız olduğunda ya da eksik eklenti bıraktığında sıfırdan farklı bir kodla çıkar.

Her bayrağın bir ortam değişkeni karşılığı vardır (DWP_VIM_VERSION, DWP_VIM_NVIM, DWP_VIM_SKIP_PACKAGES=1, DWP_VIM_STRICT=1). --yes bayrağını yalnızca imaj, kenara taşınması gereken bir Neovim yapılandırması içerebiliyorsa ekleyin.

Gereksinimler ve platformlar

• Neovim 0.12 veya daha yenisi. Kendiniz kurun ya da kurulum programının --nvim X.Y.Z ile doğrulanmış bir sürüm eklemesine izin verin (Linux ve macOS).
• Lua: lua, lua5.4 veya luajit. Eksikse kurulum programı bir tane ekler.
• macOS, Linux ve WSL kurulum programını çalıştırır. Windows için deponun README dosyasında belgelenmiş elle kurulum yolu vardır: Neovim’i winget ile kurun, v0.5.0 etiketini %LOCALAPPDATA%\nvim içine klonlayın ve Git Bash’ten lua install.lua çalıştırın.
• GPL-3.0 lisanslıdır: kullanması, incelemesi ve değiştirmesi serbesttir.

Güncelleme, sürüm sabitleme ve kaldırma

Güncellemek için daha yeni bir sürümün kurulum programını ya da bash install.sh --version latest komutunu çalıştırın. Yeniden çalıştırmak, mevcut bir DeepWorkPlan Vim klonunu seçilen sürüme taşır, dallarınızı korur ve yerel değişiklikleri asla sıfırlamaz: yerel değişiklikler ya da commit’ler kaybolacaksa durur ve hiçbir şeyi değiştirmez.

Bir sürümü sabitlemek için --version kullanın (bkz. Sürüm seçimi); bir dal ya da commit için DWP_VIM_REF değerini ayarlayın. Sürüm tercih edin: v0.4.0 öncesindeki sürümler hareketleri, plan tarayıcısını, Markdown görüntüleyiciyi ya da bu kurulum programını içermez.

# pin a specific release, here the previous one
curl -fsSL -o install.sh https://deepworkplan.com/vim/install.sh && \
curl -fsSL -o install.sh.sha256 https://deepworkplan.com/vim/install.sh.sha256 && \
shasum -a 256 -c install.sh.sha256 && \
bash install.sh --version 0.4.2

Kaldırmak için yapılandırma dizininde lua delete.lua çalıştırın. Yapılandırmayı, eklentileri, Mason verilerini, önbelleği ve durumu ve kurulum programının yaptığı yazı tipi kopyasını kaldırır; Neovim ikili dosyasına ve sistem paketlerinize dokunmaz.

cd ~/.config/nvim && lua delete.lua

Sorular

Neovim yapılandırmamın üzerine yazar mı?

Hayır, onayınız olmadan yazmaz. DeepWorkPlan Vim olmayan bir yapılandırma bulduğunda, etkileşimli çalıştırma onu ~/.config/previous-deepworkplan-vim konumuna taşımadan önce sorar. Terminal yoksa durur ve hiçbir şeyi değiştirmez; ancak onu gözetimsiz olarak kenara taşımak için --yes geçirirseniz taşır. Bu yedek yolu zaten varsa her zaman durur ve hiçbir şeyi değiştirmez.

Windows’ta çalışır mı?

Kurulum programı Windows’ta çalışmaz. Deponun README dosyasındaki elle kurulum yolunu kullanın ya da kurulum programını WSL içinde çalıştırın.

Kullanmak için Deep Work Plan gerekir mi?

Hayır. Önce bir düzenleyicidir. Deep Work Plan becerisini kurmaz ve gerektirmez; plan tarayıcısının, bir .dwp/plans/ klasörü olana kadar listeleyecek bir şeyi olmaz.

v7 vim eklentisi bunu nasıl kullanır?

Deep Work Plan v7, onboarding sırasında düzenleyiciyi isteğe bağlı vim eklentisi olarak sunar. Eklenti, mevcut bir kurulumu düzenleyicinin addon/surface.json dosyası üzerinden salt okunur biçimde algılar ve sabitlenmiş, sağlama toplamı doğrulanmış kurulumu yalnızca onayınızla önerir. Açık onay olmadan mevcut bir Neovim yapılandırmasının üzerine asla yazmaz ve hiçbir zaman zorunlu değildir.

Kodlama ajanları bunu nasıl kullanır?

Terminalde yaşayan insanlar ve kodlama ajanları için yapılmıştır. Tuş atamaları sözleşme testleriyle sabitlenmiştir; böylece kas hafızası ve bir ajanın beklentileri güncellemelerden sağ çıkar.

Hangi sürümü alırım?

Başka bir sürümü --version ya da DWP_VIM_VERSION ile seçmedikçe kurulum programı ait olduğu sürümü (bugün için v0.5.0) kurar: tam bir sürüm, bir >= alt sınırı ya da latest. DWP_VIM_REF bir dal ya da commit alır; DWP_VIM_REF=main ise main dalını izler. Bu sayfa, burada listelenen tüm özellikleri içeren v0.5.0 sürümünü anlatır.

Hangi lisansla sunuluyor ve nereden geliyor?

GPL-3.0. Andrés M Prieto’nun mu-vim projesinden türetilmiştir ve atıf depoda kalır.

Kaynak kod ve lisans

Kaynak kod DeepWorkPlan Vim deposunda bulunur. Herkese açıktır ve GPL-3.0 lisanslıdır; mu-vim projesinden türetilmiştir.

İlgili kit girdileri

• Devcontainer — yeniden üretilebilir geliştirme ortamı (birinci eklenti)
• Dailybot — ekibe görünür plan yaşam döngüsü raporları (ikinci eklenti)
• AI Diff Reviewer — plan Final Review’ları sırasında yerel inceleme (beşinci eklenti)
• Herdr — bir görevi Herdr bölmesindeki eş bir ajana devretme (v7)
• Agentkit — her terminal kodlama ajanı için tek komut ve başsız (headless) devretme (v7)