dsh yapılandırma ayarları ve API anahtarı tanımlama
dsh yapılandırma dosyalarının Linux sistemindeki konumu, DeepSeek API anahtarı ekleme ve Ollama yerel uç noktalarını tanımlama süreçleri hakkında teknik rehber.
dsh yapılandırmasını nerede tutar
dsh (DeepSeek Harness), harness verilerini varsayılan olarak ~/.dsh olan $DSH_HOME altında tutar ve paylaşılan aracı yapılandırmasını varsayılan olarak ~/.agents olan $DSH_AGENTS_HOME adlı ayrı bir kök dizinden okur. Web arayüzünde yaptığınız tüm ayarlar burada düz metin dosyaları olarak yazılır. Yapılandırmanızı başka bir sunucuya taşırken harness ana dizinini ve paylaşılan aracı kök dizinindeki tüm genel talimatları ve yetenekleri kopyalayın.
Dört yol, ana harness ayarlarını, gizli anahtarları ve oturum günlüklerini taşır.
~/.dsh/profiles/<profile>/cordis.patch.yml, sağlayıcı ve model rotalarınız dahil olmak üzere Web arayüzünün o profil için yazdığı ayarları tutar.dsh web,webprofilini çalıştırır, bu nedenle dosya~/.dsh/profiles/web/cordis.patch.ymlkonumundadır.~/.dsh/.credentials.yaml, gizli anahtarları tutar. Ayarlar yalnızca bir kimlik bilgisine referans tutar, bu nedenle anahtarın değeri tek bir dosyada yaşar.~/.dsh/profiles/adlandırılmış profilleri,~/.dsh/sessions/ise kaydedilmiş oturum günlüklerini tutar.~/.dsh/cordis.patch.ymlsizin kendi yama katmanınızdır. Her profil için yerleşik yapılandırmanın üzerine uygulanır ve profil dosyasından daha yüksek önceliğe sahiptir; bu nedenle bu katmanın geçersiz kılacağı bir Web arayüzü düzenlemesi kaydedilmek yerine reddedilir.
Paylaşılan aracı kök dizini, diğer aracı araçları da onu paylaştığı için $DSH_HOME dışında kalır. dsh, kullanıcı genelindeki talimatları ~/.agents/AGENTS.md dosyasından okur ve yetenekler için ~/.agents/skills/ dizinini tarar; bu kök dizini taşımak için DSH_AGENTS_HOME değişkenini ayarlayın.
Daha eski sürümler bu ayarları ~/.dsh/settings.yaml içinde tutuyordu. Mevcut sürümler bu dosyayı bir kez etkin profile içe aktarır ve settings.yaml.imported olarak yeniden adlandırır; bu nedenle size settings.yaml dosyasını düzenlemenizi söyleyen eski bir kılavuz, artık dsh tarafından okunmayan bir dosyayı işaret etmektedir.
DeepSeek, harness'ı MIT lisanslı bir geliştirici önizlemesi olarak yayınlamaktadır ve README dosyası uyumluluğu bozacak değişikliklerin olacağını belirtmektedir. Bu kılavuzdaki alan adları ve yollar, 5 Kasım 2026 tarihinde kontrol edilen güncel depo belgeleriyle eşleşmektedir. Bir yapılandırmayı herhangi bir kılavuzdan (bu kılavuz dahil) kopyalamadan önce, kurduğunuz sürümün belgeleriyle karşılaştırın; çünkü bir önizleme sürümü, sürümler arasında isimleri değiştirebilir.
İlk çalıştırma için gereken asgari işlemler
dsh, Node.js 24.9 veya daha yeni bir sürüm gerektirir. 5 Kasım 2026 itibarıyla package.json dosyası >=24.9.0 sürümünü şart koşmaktadır, bu nedenle 22 serisi desteklenmez. Node 24.0 ile 24.8 arası sürümler de yeterli değildir. Sürümü önceden kontrol edin; sürüm uyuşmazlığı başlatma sırasında başarısızlığa yol açar ve hata mesajı bozuk bir paket izlenimi verebilir.
node -v
npx @deepseek-ai/dsh webnpx komutu paketi npm kayıt defterinden indirir ve Web arayüzünü http://127.0.0.1:3080 adresinde başlatır. Bu komut, loopback adresine bağlanır; yani güvenlik duvarınız izin verse dahi port başka bir makineden erişilebilir değildir. Bir VPS üzerinde, 3080 portunu internete açmak yerine SSH üzerinden yönlendirme yapın. Eğer ekrana yazdırılan URL kafa karıştırıcıysa, dsh neden bu adreste başlar başlıklı bölüm, loopback bağlamasının neyi koruyup neyi korumadığını açıklar.
ssh -N -L 3080:127.0.0.1:3080 you@your-serverDizüstü bilgisayarınızda http://127.0.0.1:3080 adresini açın, ardından Settings ve Models sekmelerine gidin. DeepSeek kartında bir API anahtarı alanı bulunur. platform.deepseek.com adresinden aldığınız anahtarı buraya yapıştırın ve kaydedin. Çalışan sunucu kimlik bilgilerini bellekte tuttuğu ve referansı anlık olarak çözümlediği için, model rotası yeniden başlatmaya gerek kalmadan hemen kullanılabilir hale gelir. Uzak sunucudaki dsh Web arayüzüne erişim bölümü tünel ve reverse proxy durumlarını, DeepSeek Harness'ı bir VPS'e kurmak bölümü ise bu kılavuzun varsaydığı sunucu hazırlıklarını ele alır.
Kaydettikten sonra uygulamanın oluşturduğu dosyalara göz atın.
ls -la ~/.dsh
stat -c '%a %n' ~/.dsh/.credentials.yaml.credentials.yaml ve profiles/ dosyalarını, Web arayüzü ayarlarının bulunduğu profiles/web/cordis.patch.yml dizinini görmelisiniz. Daha eski bir sürümün oluşturduğu bir ana dizin settings.yaml.imported dosyasını da barındırıyor olabilir. Eğer stat komutu 600 dışında bir mod çıktısı verirse, chmod 600 ~/.dsh/.credentials.yaml komutunu çalıştırın. Grup tarafından okunabilir bir kimlik bilgisi dosyası, anahtarınızı o gruptaki diğer hesaplara ifşa eder; herkes tarafından okunabilir bir dosya ise anahtarınızı sunucudaki tüm diğer hesaplara açık hale getirir.
Tarayıcı olmadan ilk çalıştırma için tek bir komut yeterlidir.
npx @deepseek-ai/dsh --profile headless "summarise the files in this directory"Headless profili tek bir oturum çalıştırır ve nihai yanıtı ekrana yazdırır.
Ortam değişkenleri veya yapılandırma dosyası
dsh, bir anahtarı kayıtlı kimlik bilgilerinden veya ortam değişkeni yedeklerinden çözümleyebilir.
Bir katalog sağlayıcısı (DeepSeek, Anthropic, OpenAI ve yerleşik listedeki diğerleri), anahtarı Models sayfası üzerinden kabul eder veya kayıtlı bir kimlik bilgisi sağlanmadığında desteklenen ortam değişkeni yedeğini kullanır. Değer ~/.dsh/.credentials.yaml içine girilir ve ayarlarınız yalnızca buna bir referans tutar. Web arayüzü, anahtarı kaydettikten sonra bir daha asla göstermez.
Özel bir sağlayıcı, apiKeyEnv ile bir kimlik bilgisi referansı adlandırabilir; bu da ortam değişkeni yedeklerini destekler. Dokümantasyon, ~/.dsh/profiles/web/cordis.patch.yml gibi bir profil yamasındaki girdi için bu yapıyı önerir.
- id: llm-pi-ai
config:
providers:
my-gateway:
apiKeyEnv: GATEWAY_API_KEY
api: openai-completions
baseURL: https://gateway.example/v1
models:
- id: legacy-chat
- id: vision-preview
input: [text, image]Önce Web arayüzü üzerinden bir sağlayıcı ekleyin, ardından profilin cordis.patch.yml dosyasını açın ve yazdığı yapıyı kopyalayın. Geliştirici önizlemesi sırasında iç içe geçme yapısı değişmeye en müsait kısımdır ve uygulamanın yeni oluşturduğu dosya her zaman günceldir.
apiKeyEnv, kimlik bilgisi deposu üzerinden çözümleme yapar: kayıtlı dosya önceliklidir, ardından başlatma ortamı, çağrılan dizinin .env dosyası ve son olarak $DSH_HOME/.env gelir. Yalnızca etkileşimli bir oturumda dışa aktarılan bir anahtar, bir systemd birimi tarafından görülmez; bu nedenle başka bir kimlik bilgisi kaynağı yoksa, manuel olarak dsh web yazdığınızda çalışan aynı yapılandırma, servis altında MISSING_CREDENTIAL hatası döndürür. Birime kendi dosyasını verin.
[Service]
EnvironmentFile=/etc/dsh/dsh.envBu dosyayı 600 modunda ve servisin çalıştığı kullanıcıya ait olacak şekilde tutun.
Model seçimi ve yeniden adlandırılamayan kimlik
Yapılandırılmış her sağlayıcı model seçicide görünür. Bir model seçmek, onu yeni oturumlar için varsayılan hale getirir. Hali hazırda istek gönderilmiş oturumlar, kayıtlı modellerini korur; bu nedenle model değiştirmek eski bir konuşmayı yeniden yazmaz.
Sağlayıcı Kimliği (Provider ID) kalıcıdır. İstekler, kaydedilmiş oturumlar, varsayılan modeller ve kimlik bilgisi referanslarının tamamı bu kimliğe işaret eder, bu yüzden bir yeniden adlandırma düğmesi bulunmamaktadır. Kimliği değiştirmek, yeni bir sağlayıcı oluşturup eskisini silmek anlamına gelir. test2 yerine local-ollama gibi, uzun vadede kullanabileceğiniz bir isim seçin.
Devralınmış görüntü yeteneği olmayan özel modeller, aksi belirtilmedikçe yalnızca metin tabanlıdır. Görüntü desteğini tanımlamak için bir model girdisine input: [text, image] ekleyin veya katalogda tanımlanmayan modeller için yedek olarak rota düzeyinde defaultInput ayarını yapın. DeepSeek'in kendi rotasında, tanımlanmış modalitesi olmayan bir model yalnızca metin tabanlı kabul edilir; bu nedenle bir görüntü eklemeden önce görüntü destekleyen bir katalog girdisi (varsayılan olarak deepseek-flash) seçin. Görüntü desteği tanımlanmayan bir modele gönderilen görüntü, herhangi bir işlem yapılmadan reddedilir.
Kodunuzun sunucuda kalması için dsh'ı yerel bir uç noktaya yönlendirin
Ollama, http://127.0.0.1:11434/v1 üzerinde OpenAI uyumlu bir API sunar. dsh, özel bir sağlayıcı aracılığıyla herhangi bir OpenAI uyumlu temel URL ile iletişim kurabildiğinden, ikisi arasında başka bir katman olmadan bağlantı kurulur. Öncelikle model sunucusunu kurun: Ollama ile bir VPS üzerinde LLM self-hosting rehberi, kurulum ve model çekme işlemlerini kapsar.
dsh ile işlem yapmadan önce uç noktanın yanıt verdiğini doğrulayın.
ollama list
curl -s http://127.0.0.1:11434/v1/modelsollama list, çektiğiniz her modelin tam etiketini yazdırır. Bu dizgiyi kopyalayın. curl, aynı modelleri JSON formatında döndürür. Boş bir liste, Ollama'nın çalıştığını ancak hiçbir modelin çekilmediğini gösterir. Connection refused ise Ollama'nın çalışmadığını veya 11434 numaralı portu dinlemediğini belirtir.
Bu makinede çalışabilecek bir model seçin. Oturum açılmış bir Ollama sunucusu, aynı yerel adres üzerinden bulut modellerini de sunabilir; gemma4:cloud gibi bir bulut etiketi Ollama'nın sunucularında çalışır. Bu durumda dsh yalnızca 127.0.0.1 ile iletişim kursa bile istemleriniz sunucudan dışarı çıkar.
Şimdi sağlayıcıyı profil yamasına ekleyin. Bu yapılandırma için boş olmayan bir API anahtarı değeri girin; yerel Ollama sunucusu bunu dikkate almaz.
- id: llm-pi-ai
config:
providers:
local-ollama:
apiKeyEnv: OLLAMA_API_KEY
api: openai-completions
baseURL: http://127.0.0.1:11434/v1
models:
- id: <the exact tag printed by ollama list>Değişkeni, dsh sürecinin görebileceği şekilde dışa aktarın (export).
sudo install -d -m 700 /etc/dsh
printf 'OLLAMA_API_KEY=ollama\n' | sudo tee /etc/dsh/dsh.env
sudo chmod 600 /etc/dsh/dsh.envBu işlemdeki hataların neredeyse tamamı üç nedenden kaynaklanır. MISSING_CREDENTIAL, apiKeyEnv tarafından referans verilen değerin boş olduğunu gösterir; bu nedenle sadece terminalinizi değil, kayıtlı kimlik bilgilerini ve başlatma ortamını da kontrol edin. UNKNOWN_MODEL, id değerinin yapılandırılmış bir modelle eşleşmediği anlamına gelir; bu yüzden etiketi, iki noktadan sonraki kısım dahil olmak üzere ollama list ile karakter karakter karşılaştırın. Kullanılabilir modelleri getirirken alınan 401 hatası, temel URL'nizde GET /models yolunu çağıran model keşfi sürecinden kaynaklanır; bu yolu sunmayan uç noktalar için modellerin elle girilmesi gerekir.
Bir diğer tuzak ise temel URL'dir. /v1 kısmını eklemezseniz istekler Ollama'nın sunmadığı yollara gider, çağrı 404 hatasıyla döner ve model asla çalışmaz. Bu sonek, OpenAI uyumlu arayüzün bir parçasıdır, süsleme değildir.
Ollama farklı bir makinede çalışıyorsa, o makinenin adresi temel URL olur ve istemleriniz ağ üzerinden şifrelenmemiş HTTP ile iletilir. Ollama'yı aynı ana bilgisayarda tutun veya TLS (transport layer security) ve kimlik doğrulama arkasına yerleştirin: açık bir Ollama uç noktasını güvenli hale getirme.
Her modda makineden neler çıkar
DeepSeek anahtarı ve varsayılan uç nokta kullanıldığında, model istekleri DeepSeek API'sine gider. Bu istek; isteminizi, ajanın yanıt vermek için okuduğu dosyaların içeriğini, çalıştırdığı komutların çıktılarını ve dahil etmeyi seçtiği tüm araç sonuçlarını taşır. Ajan bir dosyayı açtığında kaynak kodunuz bu veri yükünün içinde yer alır. Barındırılan bir model bu şekilde çalışır; ajanı hangi dizinde başlattığınızı düşünmenizin nedeni budur.
Güncel sürümler, varsayılan olarak yapılandırılmış ağ geçitleri dahil olmak üzere, yerel DeepSeek adaptörü üzerinden yapılan isteklere oturumun olay günlüğünün kabul edilmemiş bir sonekini ayrı bir dsh_session_log alanı olarak ekler. Model bunu asla görmez ancak isteğin ulaştığı hedef alır. Bunu Ayarlar, Genel ("Resmi model API'si kullanılırken Oturum Günlüğünü Yükle") kısmından kapatın veya session-log-deepseek eklentisinde enabled: false değerini ayarlayın. Aşağıdaki telemetri anahtarları bu yüklemeyi kontrol etmez.
Dağıtılan profiller ayrıca aktif eklenti paketi adlarını ve sürümlerini yerel DeepSeek adaptörü üzerinden ayrı bir dsh_plugin_packages alanında gönderir. Bu katkıyı durdurmak için plugin-package-inventory-deepseek üzerinde enabled: false değerini ayarlayın.
Başka bir katalog sağlayıcısı veya şirket ağ geçidi ile aynı veri yükü bunun yerine ilgili satıcıya gider. Temel URL size tam olarak nereye gittiğini söyler.
Yerel bir uç nokta ile model isteği 127.0.0.1:11434 adresine gider ancak yalnızca loopback adresi verinin makinede kalmasını sağlamaz. Ollama belgeleri, "Bu sunucu üzerinden bulut modellerini kullanmak için Ollama'da oturum açın" ifadesini içerir; bu nedenle aynı yerel sunucu üzerinden seçilen bir bulut modeli, istemlerinizi ve kodunuzu Ollama bulutuna gönderir. Model isteği yalnızca modelin kendisi yerel olarak çalıştığında makinede kalır. Bu durumda bile üç şey ağ üzerinden dışarı çıkar. npx, paketi npm kayıt defterinden indirir. Ajanın çalıştırdığı herhangi bir araç, bağladığınız MCP (model context protocol) sunucuları dahil olmak üzere internete kendi başına erişebilir; bu konu bir VPS üzerinde MCP sunucuları çalıştırma bölümünde ayrıntılı olarak ele alınmıştır. Bir eklenti de aynı kategoriye girer; çünkü bir eklenti yüklemek, başka bir yazarın kodunu ajanınızın izinleriyle çalıştırmak anlamına gelir, bu yüzden bir eklentiyi yüklemeden önce nelere erişebileceğini kontrol etmek önemlidir. Ayrıca, yerel bir modelde tıpkı barındırılan bir modelde olduğu gibi, geri bildirim gönderdiğinizde güncel sürümlerin DeepSeek'e dışa aktarılmasına izin verdiği telemetri verileri de buna dahildir.
Telemetri varsayılan olarak geri bildirimle sınırlıdır. DSH_TELEMETRY_MODE modu seçer ve mevcut dağıtılan temel yapılandırmada ayarlanmamış veya boş bir değer FEEDBACK_ONLY olarak çözümlenir. Bu modda, olağan etkinlik hiçbir telemetri yakalamaya izin vermez. Yazılı geri bildirim gönderdiğinizde, bir derecelendirme oluşturduğunuzda veya düzenlediğinizde, bir notu düzenlediğinizde ya da geri bildirimi geri çektiğinizde dsh, henüz dışa aktarıcıya iletilmemiş oturum günlüğü önekinin, bu geri bildirim olayı aracılığıyla ve devralınan bağlam dahil olmak üzere https://dsh-otel-collector.deepseeksvc.com/v1/logs adresine dışa aktarılmasına izin verir. Tam teslimat garanti edilmez: boyutu aşan bir olay kesilmeden reddedilir ve büyük önekler CLI çıkışında kısmen gönderilmemiş kalabilir. Yetkilendirilmiş yığınlar, başka bir etkileşim veya model çağrısı olmadan gönderilmeye devam edebilir. Telemetri README dosyası bunun "tüm kullanıcılar ve sağlayıcılar için" geçerli olduğunu belirtir, bu nedenle modeli yerel olarak çalıştırmak bunu kapatmaz. DISABLED hiçbir OpenTelemetry (OTel) aktarımı oluşturmaz. FULL artık kabul edilmemektedir: bu ikisi dışındaki herhangi bir değer unsupported mode ile reddedilir. Bir geri bildirim dışa aktarımı mesaj metni, araç bağımsız değişkenleri ve sonuçları ile çalışma alanı yollarını taşıyabilir, bu nedenle geri bildirimi, oturum önekinin DeepSeek'e gönderilmesine izin vermek olarak değerlendirin.
Mod dizesini doğru ayarlamaya bağlı olmayan kesin bir durdurma için DSH_TELEMETRY_DISABLED=1 değerini ayarlayın. Boş olmayan herhangi bir değer, 0 ve false dahil olmak üzere yetkili bir devre dışı bırakma işlemidir ve çalışma başlamadan önce okunur, bu nedenle proje kodu bunu oturum ortasında tekrar açamaz. Varsayılan toplayıcı adresi dsh-otel-collector.deepseeksvc.com'dir; DSH_TELEMETRY_OTLP_URL bunu geçersiz kılar.
Ayara güvenmek yerine doğrulama yapın. Bir görev çalışırken, sürecin tuttuğu giden bağlantıları listeleyin.
sudo ss -tnp | grep -i nodeYerel olarak çalıştırılan bir modelde, model trafiği 11434 numaralı loopback portunu kullanır ancak halka açık bağlantılar, herhangi bir geri bildirim gönderilmeden araçlardan gelmeye devam edebilir. Dağıtılan profiller web araması ve getirme işlemlerini içerir ve varsayılan izin ön ayarı ağ erişimini sınırlamaz. Bir bağlantıyı telemetriye atfetmeden önce her bir genel hedefi tanımlayın; yalnızca zamanlama, bir bağlantının geri bildirim dışa aktarımı olduğunu kanıtlamaz. Bu anlık görüntü, kısa ömürlü bağlantıları da gözden kaçırabilir. Bu kontrol yalnızca dsh sürecini kapsar: bir bulut modelinin trafiği Ollama sunucusundan çıkar, bu nedenle modelin id değerinin bir bulut etiketi olmadığından da emin olun. Başka herhangi bir şey, devam etmeden önce tanımlanmaya değerdir. Bir kodlama ajanı merkeze ne gönderir bölümü, diğer araçlara karşı aynı kontrolü çalıştırır ve sonucun nasıl okunacağını açıklar.
Gizli verilerin bulunmaması gereken yerler
- Shell geçmişi.
export DEEPSEEK_API_KEY=sk-...,~/.bash_historydosyasına düz metin olarak yazılır ve anahtarı rotasyona tabi tutsanız bile orada uzun süre kalır.HISTCONTROL=ignorespaceayarlandığında komutun başına bir boşluk ekleyin veya shell kullanımını atlayıp değeri doğrudan 600 izinli bir dosyaya yazın. - Commit edilmiş dotfile dosyaları. Dotfile dosyalarınızı git üzerinde tutuyorsanız,
~/.bashrcveya~/.zshrciçindeki bir anahtar, tek birgit addile herkese açık bir depoya sızabilir. Push işlemi yapmadan önce depodagit grep -I -n 'sk-'komutunu çalıştırın. - Profil yama dosyaları. Özel sağlayıcılar için
apiKeyEnvkullanın; böylececordis.patch.yml, gizli veri yerine bir değişken adı tutar. Yapılandırma dosyaları hata raporlarına ve destek sohbetlerine yapıştırılır. Kimlik bilgisi dosyaları ise yapıştırılmaz. envçıktısı ve terminal ekran görüntüleri. Tüm ortam değişkenlerini yazdıran her şey, anahtarı da beraberinde yazdırır.- Yedekler.
~/.dshyedeğinin alınması gerekir ancak içindeki.credentials.yamlcanlı bir gizli veridir. Bu dosyayı yedekleme kapsamı dışında tutun veya arşivi şifreleyin.
Bu kurallar yalnızca dsh ile sınırlı değildir; Compose env dosyalarından gizli verileri uzak tutma konusu, aynı sunucunun container tarafındaki benzer sorunu ele almaktadır.
Geliştirici önizleme sürümü ile çalışmak
Test ettiğiniz sürümü sabitleyin; çünkü bir önizleme sürümü, yama güncellemesiyle bir yapılandırma anahtarını değiştirebilir ve sağlayıcınızın yükleme yapamamasına neden olabilir. Sabitlenmiş kurulum buna rağmen başlamayı reddederse veya npx size talep etmediğiniz bir sürümü sunmaya devam ederse, önizleme sürümlerinin ürettiği kurulum ve sürüm hataları bölümü, npx önbelleği ve Node ile gelen npm hakkında bilgi sağlar. Ev dizini olan cordis.patch.yml ve profiles/ altındaki yama dosyalarını, kimlik bilgileri dosyasını hariç tutarak sürüm kontrolünde tutun; böylece bir yükseltme sonrasında nelerin değiştiğini görebilirsiniz.
Bir profil düzgün çalışmadığında iki bayrak yardımcı olur. --dump-default-config, sistemi başlatmadan oluşturulan varsayılan yapılandırmayı yazdırır; --dump-config ise profiliniz için oluşturulan yapılandırmayı aynı şekilde yazdırır. İkisini karşılaştırmak, yama katmanınızın gerçekte neleri değiştirdiğini gösterir; bu yöntem, katmanları manuel olarak okumaktan daha hızlıdır.
dsh --profile web --dump-configBir yükseltmeden sonra bir şeyler bozulduğunda, önce bunu çalıştırın. Sürümler arasında yeri değişen bir anahtar, döküm içinde eksik bir dal olarak görünür ve düzeltme, yeniden kurulum yerine tek satırlık bir düzenlemeden ibarettir.
FAQ
dsh, DeepSeek API anahtarımı nerede saklar?
DSH_HOME değişkenini kendiniz ayarlamadığınız sürece ~/.dsh/.credentials.yaml olan $DSH_HOME/.credentials.yaml dizininde saklar. Modeller sayfası anahtarı buraya yazar ve ayarlarınız yalnızca buna bir referans tutar; dolayısıyla gizli veri tek bir dosyada bulunur. Dosya izinlerini stat -c '%a %n' ~/.dsh/.credentials.yaml ile kontrol edin; izinler 600 değerinden daha gevşekse 600 olarak ayarlayın. Özel bir sağlayıcı kullanıyorsanız, apiKeyEnv ile bir ortam değişkeni tanımlayarak dosya kullanımından tamamen kaçınabilirsiniz.
dsh'nin DeepSeek API yerine yerel bir model kullanmasını nasıl sağlarım?
Temel URL'si yerel OpenAI uyumlu uç noktanız olan özel bir sağlayıcı ekleyin. Ollama için bu adres http://127.0.0.1:11434/v1 olup, api: openai-completions ve ollama list içinden birebir kopyalanmış id model adını kullanır. Bu yapılandırma için boş olmayan bir API anahtarı değeri girin; yerel Ollama sunucusu bu değeri dikkate almaz. Herhangi bir dsh yapılandırmasını düzenlemeden önce uç noktanın yanıt verip vermediğini curl -s http://127.0.0.1:11434/v1/models ile doğrulayın; çünkü çalışmayan bir uç nokta ile hatalı bir yapılandırma benzer hata çıktıları üretir.
dsh varsayılan olarak kodumu herhangi bir yere gönderir mi?
Barındırılan bir model kullanıyorsanız, evet. İsteminiz ve aracın okuduğu dosyaların içeriği, ilgili sağlayıcıya yapılan API isteğinin bir parçasıdır. Yerel DeepSeek adaptörü üzerinden yapılan istekler (yapılandırılmış ağ geçitleri dahil), siz Ayarlar, Genel kısmından bu yüklemeyi kapatana kadar varsayılan olarak bir oturum günlüğü soneki içerir. Ollama ile yerel olarak çalıştırılan bir modelde istek loopback adresine gider ve makinede kalır; ancak gemma4:cloud gibi bulut tabanlı bir model, aynı loopback adresi üzerinden Ollama'nın bulutuna iletilir. Yerleşik web arama, veri çekme, diğer araçlar ve eklentiler, geri bildirimden bağımsız olarak genel hizmetlerle iletişim kurabilir. Telemetri ayrı bir veri akışıdır: mevcut sürümlerde DSH_TELEMETRY_MODE ayarlanmadığında FEEDBACK_ONLY adresine yönlenir. Bu nedenle geri bildirim, yerel modeller dahil her sağlayıcı için devralınan bağlamı da içerecek şekilde oturum günlüğü önekinin bu olay üzerinden dışa aktarılmasına yetki verir. Teslimat garantili değildir ve yetkilendirilmiş yüklemeler geri bildirim etkileşiminden sonra da devam edebilir. Dışa aktarıcıyı devre dışı bırakmak için DISABLED değerini ayarlayın veya çalışma başlamadan önce okunan bir devre dışı bırakma seçeneği için DSH_TELEMETRY_DISABLED=1 değerini kullanın.
Değişkenim ayarlı olmasına rağmen dsh neden MISSING_CREDENTIAL hatası veriyor?
Çünkü apiKeyEnv tarafından belirtilen referansın, dsh'nin kimlik bilgisi kaynaklarında çözümlenmesi gerekir. Kaydedilmiş kimlik bilgileri, başlatma ortamına göre önceliklidir; bunu çağıran dizindeki .env ve $DSH_HOME/.env dosyaları izler. Shell ortamınızda dışa aktarılan bir değişken; bir systemd servisine, farklı bir kullanıcının oturumuna veya siz dışa aktarmadan önce başlatılmış bir sürece ulaşmaz. Değeri birim için 600 izinlerine sahip bir EnvironmentFile dosyasına koyun veya dsh'yi başlatan aynı shell içinde dışa aktarın. Çalışan sürecin gerçekte neyi tuttuğunu sudo tr '\0' '\n' < /proc/$(pgrep -f dsh | head -1)/environ ile doğrulayın.
dsh hangi Node.js sürümüne ihtiyaç duyar?
5 Kasım 2026 itibarıyla deponun package.json dosyasına göre Node.js 24.9 veya daha yeni bir sürüm gereklidir. 22 serisi artık desteklenmemektedir ve Node 24.0 ile 24.8 sürümleri de yeterli değildir. Başka hiçbir işlem yapmadan önce node -v komutunu çalıştırın; çünkü desteklenmeyen bir çalışma zamanından kaynaklanan başlatma hatası, bozuk bir kurulum gibi görünür ve kullanıcıların çalışma zamanı yerine paketi yeniden yüklemesine neden olur.