Cordis Yapılandırması

Gömülü Cordis/DSH motoru iki belge ve ortam değişkenleriyle yapılandırılır. Belgeler varsayılan olarak backend yanında bulunur; LIBRE_CORDIS_CONFIG ve LIBRE_CORDIS_SETTINGS konumlarını değiştirir.

Belge	Sahibi	Biçim	Amaç
cordis.patch.yml	Cordis Loader	Üst düzey YAML dizisi	Motoru bağlayan eklenti satırları
cordis.config.yml	Libre WebUI hostu	YAML eşlemesi	Sağlayıcı, kimlik bilgisi kaynağı ve özellik kontrolleri

İki belge gerekir çünkü Cordis Include ağaç taşıyıcısı bileşimi doğrudan okur ve üst düzeyi dizi olmayan dosyaları reddeder. Host ayarları aynı dosyayı paylaşamaz.

Etkinleştirme

Yönetici motoru Ayarlar → Kullanıcı Yönetimi → Erişim ve ilkeler → Cordis Motoru üzerinden açar. Değişiklik hemen uygulanır: motor sonraki istekte başlar, kapatıldığında temizlenir. Yeniden başlatma gerekmez.

İki dağıtım düzeyi kaynak değeri sabitleyebilir. İkisi de sessizce geçersiz kılınmak yerine arayüzdeki anahtarı kilitler:

Kaynak	Etki
LIBRE_CORDIS_ENABLED ortam değişkeni	true/false dağıtımın durumunu sabitler
cordis.config.yml içindeki features.enabled	Açık değer durumu sabitler; anahtar yoksa yönetici seçer

Motorun ayrıca bileşime ihtiyacı vardır. Hazır örneklerle başlayın:

cd backend
cp cordis.patch.example.yml cordis.patch.yml
cp cordis.config.example.yml cordis.config.yml

Host, cordis.patch.yml dosyasını okuyup kendi varsayılanlarını köprü satırına birleştirir ve <DATA_DIR>/cordis-runtime/cordis.composed.yml dosyasına yazar. Bu üretilen dosya yeniden oluşturulabilir ve düzenlenmemelidir. Yetkili belge operatörün cordis.patch.yml dosyasıdır.

cordis.config.yml

trace: false

model:
  provider: libre-webui
  # Empty selects the authenticated caller's configured default/fallback route.
  model: ''

features:
  # Omit enabled to let the administrator use the Settings toggle.
  streaming: true
  tools: true
  persistence: true

# Optional absolute paths; defaults live under Libre WebUI's data directory.
# workspacePath: /absolute/path/to/workspace
# sessionStorePath: /absolute/path/to/sessions

Üst düzey anahtarlar

Anahtar	Tür	Varsayılan	Anlam
trace	mantıksal	false	Her Cordis etkinleşme geçişini kaydet
model	eşleme	–	Model adaptörü seçimi; aşağıya bakın
features	eşleme	–	Yetenek anahtarları; aşağıya bakın

features

Anahtar	Tür	Varsayılan	Anlam
enabled	mantıksal	false	Motoru bağla; false iken tüm rotalar 503 döndürür
streaming	mantıksal	true	Model çıktısını akışla veren turları kabul et
tools	mantıksal	true	Motor araçlarına izin ver ve kayıtlarını göster
persistence	mantıksal	true	JSONL kalıcılığını ve gerekli servisini etkinleştir; oturumlar yeniden başlatmadan sonra kalır

Köprüyü açmak için gereken tek anahtar features.enabled değeridir. Üst düzey enabled okunmaz. Bütün yetenek kontrollerinin features içinde olması, neyin açık olduğunun tek yerden görülmesini sağlar.

model

Anahtar	Tür	Varsayılan	Anlam
provider	dize	libre-webui	libre-webui, deepseek, pi-ai veya none
apiKeyEnv	dize	OPENAI_API_KEY	Anahtarı tutan ortam değişkeninin adı
route	dize	libre-webui	Motorun isteklerinde kullandığı sağlayıcı rotası
model	dize	''	İstenen model kimliği; elle tanımlanan rota için ayarlayın
baseUrl	dize	''	Endpoint geçersiz kılması; boşsa adaptörün varsayılanı
providers	eşleme	{}	Rota adına göre elle tanımlanan sağlayıcı rotaları

Motor modellerinin kaynağı

Motorun kendine ait sağlayıcı ayarları yoktur. Bileşimdeki libre-webui-llm-adapter satırının kaydettiği libre-webui rotasıyla Libre WebUI’nin mevcut sağlayıcılarını çağırır. Arayüzde sohbet edebildiğiniz modeli motor da kullanabilir. UI’den model indirdiğinizde motor, önceden ayarlanan kimlik bilgileri ve endpoint ile onu görür.

Bunun için model.provider: libre-webui ayarlayın. Hazır varsayılan budur; kimlik bilgileri ve endpoint’ler Libre WebUI’nin mevcut ayarlarında kalır.

model, motorun istediği modeli belirtir. Boş değer uygulamanın varsayılanını kullanır. Dağıtımda varsayılan yoksa motor, kullanılabilir yerel modelleri tercih ederek sağlayıcı katmanının bildirdiği ilk sohbet modelini seçer. Embedding modelleri hariçtir. Dahili rotalar model ve sağlayıcıyı birlikte tutar: lwui:ollama:<encoded-model> veya lwui:plugin:<encoded-provider>:<encoded-model>. Aynı adlar veya Ollama kesintisi yerel isteği uzak sağlayıcıya yönlendiremez. Açıkça seçilen sağlayıcı yoksa hata oluşur; başka sağlayıcıya sessiz geçiş yapılmaz.

Boş model yalnızca libre-webui rotasında güvenlidir. Sağlayıcı paketiyle sunulan rota açık model ister. dsh-llm-pi-ai katalog sorgularını yanıtlamak için listeyi çözer, ancak ilk girdiye otomatik dönmez. Modelsiz elle tanımlanmış rota hiçbir turu yanıtlayamaz ve şu hatayla biter:

provider "<route>" resolves no models; the installed catalog does not describe
this route, so its models must be listed in configuration

model değerini o rotanın models listesindeki bir kimliğe ayarlayın. Hazır örnekte route: ollama, bildirilen llama3.2 girdisine karşılık gelen model: llama3.2 ile eşleşir.

provider, bağlanacak adaptör paketini seçer:

• libre-webui, motoru dağıtımın kendi sağlayıcı katmanından besler. Desteklenen varsayılan moddur.
• none, model erişimi olmadan başlatır. Araç listesi ve oturumlar çalışır ama turlar yanıtlanamaz; bileşimi sınamak için uygundur.
• deepseek ve pi-ai, sağlayıcı paketini doğrudan bağlar. Bu paketler backend bağımlılıkları değildir. Tüm SDK’ları taşımak, motorun kullanmadığı yeteneklere ait eski paketler dahil 59 geçişli bağımlılık getiriyordu. İstediğiniz paketi kurup satırını bileşime ekleyin; eksikse host adını bildirir.

Sağlayıcı rotası şu alanlarla tanımlanır:

Alan	Anlam
displayName	İnsanların okuyabileceği ad
api	İletişim protokolü; örneğin openai-completions
baseURL	Endpoint tabanı
apiKeyEnv	Anahtarı tutan ortam değişkeni
models	Model listesi; her girdi id, name, contextWindow, maxTokens alır

Kimlik bilgileri iki belgeye de yazılmaz. apiKeyEnv bir ortam değişkenini adlandırır ve adaptör bunu her istekte çözer. Anahtar yenileme yeniden başlatma gerektirmez.

cordis.patch.yml

Cordis Loader girdilerinden oluşan üst düzey dizidir. Hazır örnek dokuz satır bağlar ve önerilen başlangıç noktasıdır.

- id: llm
  name: '@deepseek-ai/dsh-llm'

- id: session
  name: '@deepseek-ai/dsh-session'

- id: session-projection
  name: '@deepseek-ai/dsh-session-projection'

- id: session-persistence
  name: '@deepseek-ai/dsh-session-persistence-jsonl'
  config:
    # The host supplies the resolved sessionStorePath.

- id: system-prompt
  name: '@deepseek-ai/dsh-system-prompt'
  config:
    personaPrefix: ''

- id: tools
  name: '@deepseek-ai/dsh-tools'

- id: agent
  name: '@deepseek-ai/dsh-agent'

- id: agent-loop
  name: '@deepseek-ai/dsh-agent-loop'
  config:
    agents: []

- id: libre-webui-bridge
  name: './dist/cordis/dsh/engine-plugin.js'

Girdi alanları

Alan	Zorunlu	Anlam
id	hayır	Satırı hedeflemek için sabit kimlik; yoksa name üzerinden türetilir
name	evet	Loader’ın içe aktardığı modül belirticisi; dize sabiti olmalı
config	hayır	Eklenti ayarları; !!js ifadeleri kullanılabilir
disabled	hayır	Silmeden satırı atla; !!js kullanılabilir
inject	hayır	Satır için ek zorunlu servisler veya araya girme ayarları

name Loader tarafından doğrudan içe aktarılır ve değerlendirilmez; !!js ifadesi olamaz. config değerleri !!js kullanabilir. İfadeler daha sonra satırın fiber’ında Loader bağlamıyla değerlendirilir: process.env ve ctx.get(...) çalışır, import.meta çalışmaz.

Göreli belirticiler bileşim dosyasının kendi dizinine göre çözülür. Yalın paket belirticileri backend paketi üzerinden çözülür; @deepseek-ai/dsh-tools, backend/node_modules içindeki kopyayı bulur.

Satır sırası yükleme sırası değildir. Cordis, bildirilen servisler hazır olduğunda satırı etkinleştirir; yukarıdaki gruplama yalnızca okunabilirlik içindir.

Zorunlu satırlar

Sohbet yanıtlayabilen motor aşağıdakilerin hepsine ihtiyaç duyar:

Satır	Sağladığı	Gereken bileşen
dsh-llm	llm	ajan döngüsü
dsh-session	sessions	ajan döngüsü, köprü
dsh-session-projection	sessionProjections	ajan döngüsü
dsh-system-prompt	systemPrompt	araçlar, ajan döngüsü
dsh-tools	tools	ajan döngüsü, köprü
dsh-agent	agents	köprü
dsh-agent-loop	ajan sürücüsü	turları yanıtlama
köprü satırı	libreDshEngine	bütün rotalar

GET /api/cordis/tools sonucunun dolu olması için @deepseek-ai/dsh-fs-sandbox ve @deepseek-ai/dsh-tool-fs gibi araç eklentileri de bağlanmalıdır. Araç eklentisi olmayan kayıt listesinin boş olması normaldir.

Ortam değişkenleri

Her ayarın ortam değişkeni geçersiz kılması vardır. Öncelik ortam değişkeni, belge ve yerleşik varsayılan sırasındadır.

Değişken	Geçersiz kıldığı	Varsayılan
LIBRE_CORDIS_ENABLED	features.enabled	false
LIBRE_CORDIS_STREAMING	features.streaming	true
LIBRE_CORDIS_TOOLS	features.tools	true
LIBRE_CORDIS_PERSISTENCE	features.persistence	true
LIBRE_CORDIS_TRACE	trace	false
LIBRE_CORDIS_MODEL_PROVIDER	model.provider	libre-webui
LIBRE_CORDIS_MODEL_ROUTE	model.route	libre-webui
LIBRE_CORDIS_MODEL	model.model	''
LIBRE_CORDIS_API_KEY_ENV	model.apiKeyEnv	OPENAI_API_KEY
LIBRE_CORDIS_BASE_URL	model.baseUrl	''
LIBRE_CORDIS_CONFIG	Bileşim belgesi yolu	<cwd>/cordis.patch.yml
LIBRE_CORDIS_SETTINGS	Ayar belgesi yolu	bileşim belgesinin yanında
LIBRE_CORDIS_WORKSPACE	Motorun varsayılan çalışma alanı	<DATA_DIR>/cordis-workspace
LIBRE_CORDIS_SESSION_STORE	Kalıcı oturum dizini	<DATA_DIR>/cordis-sessions

Mantıksal değişkenler 1/true/yes/on ve 0/false/no/off kabul eder. Tanınmayan değer tahmin edilmez; belgedeki ayara dönülür.

Hazır bileşimdeki !!js ifadeleri de LIBRE_CORDIS_SESSION_STORE ile LIBRE_CORDIS_WORKSPACE okur. Bu yüzden host bunları ağaç bağlanmadan önce dışa aktarır.

Uygulamalı örnekler

Tamamen çevrimdışı yerel Ollama

features:
  enabled: true
model:
  provider: pi-ai
  route: ollama
  model: llama3.2
  apiKeyEnv: OLLAMA_API_KEY
  providers:
    ollama:
      api: openai-completions
      baseURL: http://127.0.0.1:11434/v1
      apiKeyEnv: OLLAMA_API_KEY
      models:
        - id: llama3.2
          contextWindow: 131072
          maxTokens: 4096

Ollama anahtarı yok sayar, ancak OpenAI istemcisi bir değer ister. Bir sır oluşturmadan koşulu karşılamak için OLLAMA_API_KEY=ollama dışa aktarın. Hiçbir şey makineden çıkmaz.

OpenAI uyumlu ağ geçidi

features:
  enabled: true
model:
  provider: pi-ai
  route: gateway
  model: acme-large
  apiKeyEnv: ACME_GATEWAY_API_KEY
  providers:
    gateway:
      displayName: Acme Gateway
      api: openai-completions
      baseURL: https://gateway.acme.example/v1
      apiKeyEnv: ACME_GATEWAY_API_KEY
      models:
        - id: acme-large
          contextWindow: 65536
          maxTokens: 4096

Resmî DeepSeek

features:
  enabled: true
model:
  provider: deepseek
  route: deepseek
  apiKeyEnv: DEEPSEEK_API_KEY

Backend ortamında DEEPSEEK_API_KEY ayarlayın.

Sağlayıcı yok, yalnızca araçlar

features:
  enabled: true
model:
  provider: none

Motor başlar, oturum oluşturulabilir ve GET /api/cordis/tools ayarlanmış araçları listeler. İsteği karşılayacak adaptör bulunmadığından mesaj gönderme başarısız olur.

Geçiş notları

Cordis köprüsü ek bir özelliktir. Varsayılan olarak kapalıdır ve kapalıyken mevcut davranışları değiştirmez.

Mevcut dağıtımı yükseltme. İşlem gerekmez. Örnekler cordis.patch.example.yml ve cordis.config.example.yml olarak gelir; kopyalayıp özelliği açmadıkça okunmaz. Geçiş çalışmaz, tablo oluşturulmaz ve mevcut veri dizini değiştirilmez.

İlk etkinleştirme. İki örneği kopyalayıp features.enabled: true ayarlayın. Motor paketleri zaten backend bağımlılığıdır, ek kurulum gerekmez. İlk istekte <DATA_DIR>/cordis-workspace, <DATA_DIR>/cordis-sessions ve <DATA_DIR>/cordis-runtime oluşur. Bunlar mevcut veri dizininin altındadır; o dizini kapsayan yedek ve geri yükleme onları da kapsar.

Motoru yükseltme. Çözümlenen sürümler package-lock.json içinde, alpha uyumlu aralıklar backend/package.json içinde yer alır. Bilinçli yükseltin; npm install sonrasında sağlayıcı ve oturum sözleşmelerini doğrulayın. Yeni peer bağımlılığını npm bağlama anında değil kurulumda bildirir. Model ve oturum biçimleri DSH’ye aittir; biçim değişikliği Libre WebUI veri geçişi değil, DSH sürüm notudur.

Geri alma. features.enabled: false ayarlayıp yeniden başlatın veya cordis.patch.yml içinden köprü satırını kaldırın. libreDshEngine ve dinleyicisi kaldırılır, oluşturduğu ajanlar temizlenir. Oturum dosyaları veri olarak kalır; alanı geri almak için sessionStorePath dizinini silin. Paketleri kaldırmak isteğe bağlıdır ve diğer Libre WebUI özelliklerini etkilemez.

Mevcut Chat ve Work dağıtımları. Chat, geçici motor oturumları ve mevcut dökümle çalışan yöneticiye özel DeepSeek Harness seçeneği kazanır. Work, yalıtılmış DSH sürücüsü ve mevcut sandbox/onay akışını kullanan ayrı motor seçimi kazanır. Eski model seçimleri normal davranışlarını korur.

Standart libre-webui adaptöründe Chat Ajanlar listesi temel profil yanında açık DSH sağlayıcı-model seçimlerini içerir. Açık seçim sağlayıcı kimliğini korur; temel profil çalışan bileşimin varsayılanını kullanır. Başlık ve düşünme özetleri araçsız doğrudan sağlayıcıyı çağırır. Özel adaptör rotası yalnızca temel Chat girdisini tutar; yardımcı metinler için ayrı Ollama veya eklenti görev modeli gerekir.

DSH, yöneticinin Ollama açma/kapatma ayarına uyar. Kapalıyken Ollama modelleri listelenmez veya yoklanmaz; açık Ollama seçimi sağlayıcı değiştirmeden hata verir. Operatörün sabitlediği niteliksiz model adlarının güvenli çözümü de Ollama kataloğunu gerektirir. Yalnızca eklenti kullanan dağıtımda lwui:plugin:<plugin>:<model> seçin.

İşletim sınırları

• Host motoru ve Chat yalnızca yöneticilere ve solo moduna açıktır. Motor sayfası yerel JSONL depolu ortak yönetici konsoludur; team moduna bağlanamaz. Sandbox Work mevcut SQL depolarını kullanır.
• Model çağrıları kimliği doğrulanmış çağıranı kullanır. Etkileşimli turlar o yöneticinin bilgilerini ve model tercihini kullanır. Güvenilir arayüzsüz bileşim, LIBRE_CORDIS_USER değerini açık bir etkin yönetici kimliğine ayarlayabilir. En eski yönetici örtük olarak seçilmez.
• Host dosya araçları çalışma alanıyla sınırlıdır. Okuma ve yazma kanonik hedefi denetler; oturum kök dışı dizin seçemez. DSH değişiklik kısıtları sürer. Ek operatör eklentileri güvenilir sunucu kodudur.
• Host araçları DSH politikalarını kullanır. Motor sayfası oturum bazında salt okuma/yazma ve tek seferlik onaylar sunar; alan sınırını aşmaz. Arayüzsüz Chat gösteremediği onayları reddeder. Work sürücüsü host dosya araçları olmadan Work onaylarını ve konteyner yalıtımını kullanır.
• Akışlar canlı metin ve açık akıl yürütme içerir. Kalıcı mesajlar bitmiş dökümü korur; istemciye canlı metnin ikinci kopyası gönderilmez.
• Yeniden başlatma ve silme kayıtlı oturumları kullanır. Boş ve bitmiş oturumlar korunur. Köprünün oluşturduğu JSONL oturumunu silmek yazıcısını durdurup dosyayı kaldırır. Diğer kalıcılık türleri uygun silme adaptörü sağlamalıdır.
• Eski bozuk günlükler açık onarım gerektirir. Önceki sürümler zorunlu kimlikler olmadan kullanıcı mesajı kaydetti. Sıkı okuyucu bunları atmak yerine reddeder. Kurtarma için Sorun giderme bölümüne bakın.
• Başlıklar yerelde türetilir. Oturum özeti ilk insan mesajını kısa başlık yapar; boş oturumun türetilmiş başlığı yoktur.

Çalışan DSH örneğindeki modelleri bağlama

İsteğe bağlı dsh-native-provider, örneğin 3080 portundaki web uygulaması gibi başka DSH örneğinde yapılandırılmış model ve sağlayıcı bağlantılarını sunar. O örneğin mevcut profiline kurun. Yalnızca ctx.llm çağırır: anahtarlar DSH’de kalır; bağlantı oturum oluşturamaz, ajan çalıştıramaz, yerel ek dosyaları okuyamaz veya yerel araçları yürütemez.

İki süreç aynı Unix hostunda aynı OS hesabıyla çalışmalıdır. Açıkça ayarlanmış Unix soketi kullanılır; fiziksel dizin o hesaba ait 0700, soket 0600 izinlerinde olmalıdır. TCP dinleyicisi eklenmez, DSH tarayıcı doğrulaması yeniden kullanılmaz veya zayıflatılmaz. Windows ve uzak DSH hostları desteklenmez.

Yerel erişim sınırı OS hesabıdır; aynı hesabın diğer süreçleri de soketi kullanabilir. Bağlantı, hesabı paylaşan uygulamalar için ayrı sağlayıcı kimlik bilgileri veya uygulama yalıtımı sunmaz.

Bağımsız eklentiyi kurma

DSH → Plugins → Add plugin içinde Package name or address alanına bu açık depo URL’sini yapıştırıp Install seçin:

https://github.com/libre-webui/dsh-native-provider

DSH istediğinde bileşeni etkinleştirin. Açık paket 0.1.1 sürümündedir, Apache-2.0 lisanslıdır ve önceden derlenmiş çalışma zamanı ile bundle yamasını içerir. Yerel derleme, kurulum betiği veya npm runtime bağımlılığı gerekmez. @libre-webui/dsh-native-provider adı npm’de yayımlanmamıştır; iletişim kutusunda GitHub URL’sini kullanın.

Bundle <DSH home>/lwui-provider/llm.sock seçer; normalde $HOME/.dsh/lwui-provider/llm.sock olur. Ayarlanmış DSH_HOME önceliklidir. Özel soket dizini yoksa oluşturulur. DSH evi başına bir etkin köprü kullanın veya ek profiller için kullanıcı cordis.patch.yml dosyasında yolu değiştirin. Tam yol 100 UTF-8 baytı aşmamalı ve sembolik bağlantı içermemelidir. Ayrıntılar bağımsız yapılandırma rehberindedir.

İsteğe bağlı CLI karşılığı:

dsh plugin --profile web add https://github.com/libre-webui/dsh-native-provider

Gerçekte kullanılan profil farklıysa web yerine onun adını yazın. CLI kurulumundan sonra profili yeniden başlatın. Canlı UI kurulumu eklentiyi hemen açabilir; DSH yeniden başlatma bildirimi verirse izleyin. Yerel DSH kaynak değişikliği veya sağlayıcı anahtarı kopyalama gerekmez.

Libre WebUI’den bundle hazırlama

Libre WebUI bir hazırlama betiği de sunar. Kaynak checkout’unda backend’i derleyip yeni bir çıktı dizini hazırlayın:

npm run build:backend
node scripts/prepare-dsh-provider.mjs /absolute/dsh-provider-bundle /absolute/private-directory/provider.sock
dsh plugin --profile web add /absolute/dsh-provider-bundle

npm dağıtımı derlenmiş backend ve betiği zaten içerir. Kurulum dizininden derleme olmadan son iki komutu çalıştırıp seçilen profili yeniden başlatın. Her iki yöntem mevcut çıktı dizinini reddeder; paket bilgisi, lisans ve kurulum notları ekler.

Libre WebUI’yi bağlama

Libre WebUI cordis.config.yml dosyasına aynı mutlak soket yolunu yazın. Açık bundle varsayılanı için /absolute/home yerine kendi ev dizininizi kullanın:

nativeProvider:
  socketPath: /absolute/home/.dsh/lwui-provider/llm.sock

Alternatif olarak LIBRE_DSH_PROVIDER_SOCKET aynı mutlak yola ayarlanabilir. Boş ortam değeri, belgede yol olsa bile bağlantıyı kapatır. LWUI’de Cordis Motoru açılınca etkin yöneticiler Work’ün DeepSeek Harness motorundan, motor sayfasından ve Chat Ajanlar grubundan yerel modelleri seçebilir. Chat için CLI ajan modelleri de gerekir. Work ham model ve sağlayıcı kimliğini providerType: dsh ile saklar; mevcut LWUI tabanlı DSH görevleri önceki kimlik ve motor işaretini tutar.

Yerel model listesi canlı okunur. Sağlayıcı veya kimlik ayarı değişince bağlantı nesli geçersiz olur ve süren çağrılar iptal edilir. Soket, model ya da sağlayıcı yoksa istek durur; Ollama veya başka sağlayıcıya dönülmez. Başlık ve özetler seçilen LLM’yi araçsız doğrudan çağırır. İlk bağlantı sürümü metin, akıl yürütme ve araç mesajı kabul eder; yerel görüntü/dosya referansını reddeder.

Kimlik bilgileri DSH operatörüne aittir; normal Work daha çok kullanıcıya açık olsa bile bu bağlantı yöneticiye özeldir. DSH sağlayıcısına göre istek host dışına çıkabilir; Work uzak sağlayıcı açıklamasını gösterir. Team modunda ilgili her worker yerel bağlantıya erişebilmelidir; yoksa işlem güvenli biçimde engellenir. Cordis’i kapatmak veya yolu kaldırmak kayıtlı görevleri koruyup erişimi geri çeker. DSH çöker ve soket bırakırsa sahibi örneği durdurup yalnızca o eski soketi kaldırın, sonra yeniden başlatın. Eklenti mevcut dosya sistemi girdisini değiştirmez.

Eklentiyi yükseltme veya kaldırma

Değişimden önce süren yerel istekleri bitirin veya iptal edin. Eski yerel 0.0.0/0.1.0 bundle için DSH UI’de Uninstall, ardından Add plugin kullanıp yukarıdaki GitHub URL’sini kurun. Özel soket yolunu desteklenen kullanıcı profili geçersiz kılmasıyla koruyun. Yerel oturumlar ve kimlik bilgileri korunur.

GitHub’dan kurulmuş paket CLI ile güncellenebilir:

dsh plugin --profile web update @libre-webui/dsh-native-provider

CLI güncellemesinden sonra yeniden başlatıp sürümü kontrol edin. Önceden kapalı eklenti kapalı kalır; bağlantıyı sınamadan önce durumunu denetleyin. Sabitleme veya geri dönüş için github:libre-webui/dsh-native-provider#<commit> kullanın. Özel yerel bundle’ları yeni çıktı dizininde derleyip dizini yeniden ekleyin; yerel bağımlılık güncellemek GitHub’dan çekmez.

Bağlantıyı kaldırmak için önce LWUI’de nativeProvider.socketPath ayarını kaldırın veya LIBRE_DSH_PROVIDER_SOCKET değerini boş bırakın, ardından çalıştırın:

dsh plugin --profile web remove @libre-webui/dsh-native-provider

Kaldırdıktan sonra profili yeniden başlatın. Kayıtlı görevler kalır ama aynı açık bağlantı geri gelene kadar yerel model istekleri başarısız olur. Eklentiyi kaldırmak DSH sağlayıcılarını veya kimlik bilgilerini silmez. Eski bundle dizinlerini yalnızca artık kurulu değillerse silin.

Yerel sağlayıcı kullanımı

Yerel istekler Sağlayıcı Kullanımı içinde DeepSeek Harness · sağlayıcı altında, seçilen ham modelle görünür. Araç turları, başlıklar ve özetler dahil her gerçek model isteği bir kez sayılır. Başarı, hata, iptal, gecikme ve DSH’nin bildirdiği tokenlar gösterilir. Önbellek girdisi toplam girdiye bir kez eklenir; eksik kullanım tahmin edilmeden ölçülmemiş kalır. Sağlayıcı kimlikleri mevcut tarife ve maliyet kuralları için dsh-native:<percent-encoded-native-provider-id> biçimindedir. Bilinmeyen tarifeye fiyat atanmaz.

LWUI sağlayıcılarından geçen DSH istekleri o sağlayıcının mevcut kayıtlarını korur. Katalog okuma ve çıkarıma ulaşmadan reddedilen istekler ek model olayı oluşturmaz. Ölçüm bu bağlantı sürümü kurulduğunda başlar, geçmiş kullanım uydurulmaz. Kaydedilenler kimlik, durum, zaman ve sayaçlardır; istem, yanıt, anahtar, endpoint ve sağlayıcı hata metni kaydedilmez.

Yapılandırmayı doğrulama

curl -s http://127.0.0.1:3001/api/cordis/health | jq

{
  "success": true,
  "enabled": true,
  "ready": true,
  "services": [
    { "name": "llm", "state": "ready" },
    { "name": "systemPrompt", "state": "ready" },
    { "name": "sessions", "state": "ready" },
    { "name": "tools", "state": "ready" },
    { "name": "agents", "state": "ready" }
  ]
}

code: CORDIS_UNAVAILABLE ile 503, bileşimin bağlanmadığını gösterir. error nedeni verir, LIBRE_CORDIS_TRACE=true Cordis etkinleşme günlüğünü ekler. Yaygın nedenler için Sorun giderme bölümüne bakın.