Cordis-konfiguráció

A beépített motor két dokumentumot és környezeti változókat használ. A dokumentumok alapból a backend mellett vannak; a LIBRE_CORDIS_CONFIG és LIBRE_CORDIS_SETTINGS helyezi át őket.

Dokumentum	Tulajdonos	Forma	Cél
cordis.patch.yml	Cordis Loader	Felső szintű YAML-tömb	A motort betöltő pluginsorok
cordis.config.yml	Libre WebUI-gazda	YAML-map	Szolgáltató, hitelesítőadat-forrás, kapcsolók

Két fájl kell, mert a Cordis Include maga olvassa a kompozíciót, és csak felső szintű tömböt fogad el. A gazdabeállítás nem lehet ugyanott.

Engedélyezés

Az adminisztrátor a Settings → User Management → Access & policies → Cordis Engine alatt engedélyezi. Azonnal hat: bekapcsoláskor a következő kérés indít, kikapcsoláskor felszabadul a motor. Újraindítás nem kell.

Két telepítési forrás rögzítheti az értéket. Mindkettő zárolja a kapcsolót, nem íródik felül csendben:

Forrás	Hatás
LIBRE_CORDIS_ENABLED környezeti változó	true/false rögzíti a telepítés funkcióját
features.enabled a cordis.config.yml	Kifejezett érték rögzít; kulcs nélkül az adminisztrátor dönt

Kompozíció is kell. Kezdje a mellékelt mintákkal:

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

A gazda beolvassa a cordis.patch.yml fájlt, a hídsorhoz egyesíti alapértékeit, és megírja a <DATA_DIR>/cordis-runtime/cordis.composed.yml fájlt. Ez újragenerálható, nem szerkesztendő; az operátor cordis.patch.yml fájlja a mérvadó.

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

Felső szintű kulcsok

Kulcs	Típus	Alapérték	Jelentés
trace	logikai	false	Minden Cordis-aktiválás naplózása
model	map	–	Modelladapter-választás; lásd alább
features	map	–	Képességkapcsolók; lásd alább

features

Kulcs	Típus	Alapérték	Jelentés
enabled	logikai	false	Motor betöltése; kikapcsolva minden útvonal 503.
streaming	logikai	true	Streamelt modellfordulók fogadása
tools	logikai	true	Eszközök engedélyezése és regiszterük megjelenítése
persistence	logikai	true	JSONL engedélyezése és megkövetelése; munkamenet túléli a restartot

A features.enabled az egyetlen bekapcsoláshoz szükséges kapcsoló. Felső szintű enabled nem olvasódik; minden kapcsoló a features alatt van, egy ellenőrizhető helyen.

model

Kulcs	Típus	Alapérték	Jelentés
provider	sztring	libre-webui	libre-webui, deepseek, pi-ai vagy none
apiKeyEnv	sztring	OPENAI_API_KEY	A kulcsot tároló környezeti változó neve
route	sztring	libre-webui	A motor által kért szolgáltatói útvonal
model	sztring	''	Kért modell-ID. Kézi útvonalhoz állítsa be
baseUrl	sztring	''	Endpoint-felülírás; üresen adapteralapérték
providers	map	{}	Kézzel deklarált szolgáltatói útvonalak név szerint

Honnan jönnek a motor modelljei

A motornak nincs önálló szolgáltatókonfigurációja. Az LWUI meglévő szolgáltatóit a libre-webui-llm-adapter sor által regisztrált libre-webui útvonalon hívja. Ami az UI-ban chattelhető, azt a motor is használhatja: letöltés után a modell meglévő kulcsaival és endpointjával látható.

A model.provider: libre-webui a mellékelt alapérték. A hitelesítő adatok és endpointok a normál LWUI-beállításokban maradnak.

A model a kért modell neve. Üresen alkalmazásalapérték, ennek hiányában az első jelentett chatmodell választódik, elérhető helyi modellek előnyével. Embeddingmodellek kizártak. A belső útvonal szolgáltatót és modellt is őriz: lwui:ollama:<encoded-model> vagy lwui:plugin:<encoded-provider>:<encoded-model>. Így egyező név vagy Ollama-kiesés nem irányít helyi kérést távoli szolgáltatóra. Konkrét, nem elérhető szolgáltató hiba lesz, nem rejtett csere.

Üres model csak libre-webui esetén biztonságos. Szolgáltatócsomag útvonala konkrét modellt kér: a dsh-llm-pi-ai katalóguskérdésekhez feloldja a listát, de nem választja tartaléknak az első elemet. Kézi útvonal model nélkül fordulót sem fogad, és ezt adja:

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

A model a models lista egyik ID-je legyen. A példa route: ollama és model: llama3.2 értéke a deklarált llama3.2 bejegyzésnek felel meg.

A provider választja a betöltött adaptercsomagot:

• A libre-webui a telepítés saját szolgáltatórétegét használja; támogatott alapértelmezés.
• A none modell nélkül indul. Munkamenetek és eszközlista működnek, a forduló nem válaszolható meg; kompozícióteszthez hasznos.
• A deepseek és pi-ai közvetlen csomagot tölt. Ezek nem backendfüggőségek: minden SDK behozása 59 közvetett csomagot hozott, elavultakat is, nem használt képességekhez. Telepítse a kívánt csomagot és sorát; a gazda megnevezi a hiányzó csomagot.

Szolgáltatói útvonal mezői:

Mező	Jelentés
displayName	Olvasható név
api	Átviteli protokoll, pl. openai-completions
baseURL	Endpoint-alapcím
apiKeyEnv	A kulcsot tároló változó
models	Modelllista; mezői id, name, contextWindow, maxTokens

Hitelesítő adatok egyik dokumentumba sem íródnak. Az apiKeyEnv környezeti változót nevez meg, amelyet az adapter kérésenként olvas. Kulcsrotációhoz nincs restart.

cordis.patch.yml

Felső szintű Cordis Loader-tömb. A kilencsoros mellékelt minta az ajánlott kiindulás.

- 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'

Bejegyzésmezők

Mező	Kötelező	Jelentés
id	nem	Stabil sor-ID; elhagyásakor name alapján
name	igen	Importált modulhivatkozás; sztringliterál legyen
config	nem	Pluginbeállítás; !!js megengedett
disabled	nem	Sor kihagyása törlés nélkül; !!js megengedett
inject	nem	További függőségek vagy intercept-beállítás

A Loader a name mezőt közvetlenül importálja, sosem értékeli ki; nem lehet !!js. A config enged !!js kifejezéseket, később a sor fiberében, Loader-kontextussal kiértékelve. A process.env és ctx.get(...) működik, az import.meta nem.

Relatív hivatkozás a kompozíciós fájl könyvtárához viszonyul. Puszta csomagnév a backendcsomagon át oldódik, így az @deepseek-ai/dsh-tools a backend/node_modules példányát találja.

A sorrend nem vezérli a betöltést. Cordis a függőségek meglétekor aktivál; a csoportosítás az olvasónak szól.

Kötelező sorok

Chatre válaszoló motorhoz mind kell:

Sor	Biztosítja	Igényli
dsh-llm	llm	ágensciklus
dsh-session	sessions	ágensciklus, híd
dsh-session-projection	sessionProjections	ágensciklus
dsh-system-prompt	systemPrompt	eszközök, ágensciklus
dsh-tools	tools	ágensciklus, híd
dsh-agent	agents	híd
dsh-agent-loop	ágensmeghajtó	fordulók megválaszolása
a hídsor	libreDshEngine	minden útvonal

A GET /api/cordis/tools eredményéhez eszközplugin, például @deepseek-ai/dsh-fs-sandbox és @deepseek-ai/dsh-tool-fs is kell. Plugin nélküli regiszter jogosan üres.

Környezeti változók

Minden beállítás környezetből felülírható. A változó megelőzi a dokumentumot, a dokumentum a beépített alapértéket.

Változó	Felülírja	Alapérték
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	Kompozíciós dokumentum útja	<cwd>/cordis.patch.yml
LIBRE_CORDIS_SETTINGS	Beállítási dokumentum útja	a kompozíciós dokumentum mellett
LIBRE_CORDIS_WORKSPACE	Motor alapmunkatere	<DATA_DIR>/cordis-workspace
LIBRE_CORDIS_SESSION_STORE	Mentett munkamenetek könyvtára	<DATA_DIR>/cordis-sessions

A logikai változók 1/true/yes/on és 0/false/no/off értékeket fogadnak. Érthetetlen értéknél a dokumentum dönt, nem találgatás.

A mellékelt !!js kifejezések a LIBRE_CORDIS_SESSION_STORE és LIBRE_CORDIS_WORKSPACE változót is olvassák, ezért a gazda a fa betöltése előtt exportálja őket.

Kidolgozott példák

Helyi Ollama, teljesen offline

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 figyelmen kívül hagyja a kulcsot, de az OpenAI-kliens kér egyet. Az OLLAMA_API_KEY=ollama kielégíti ezt titok kitalálása nélkül. Semmi nem hagyja el a gépet.

OpenAI-kompatibilis átjáró

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

Hivatalos DeepSeek

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

Állítsa be a DEEPSEEK_API_KEY változót a backend környezetében.

Szolgáltató nélkül, csak eszközökkel

features:
  enabled: true
model:
  provider: none

A motor indul, munkamenet készülhet, a GET /api/cordis/tools a pluginokat listázza. Üzenetküldés adapter hiányában hibázik.

Migrációs tudnivalók

A híd kiegészítés. Kikapcsolva, ahogyan alapból van, nem változtat meglévő viselkedést.

Meglévő telepítés frissítése. Nincs teendő. A cordis.patch.example.yml és cordis.config.example.yml másolás és engedélyezés előtt nem olvasódik. Nincs migráció, új tábla vagy meglévő adatkönyvtár-módosítás.

Első bekapcsolás. Másolja a mintákat, állítson features.enabled: true értéket; a motorcsomagok már backendfüggőségek. Az első kérés készíti a <DATA_DIR>/cordis-workspace, <DATA_DIR>/cordis-sessions és <DATA_DIR>/cordis-runtime mappát. Az adatkönyvtár alatti új mappákat annak mentése/visszaállítása is lefedi.

Motorfrissítés. A pontos verziót a package-lock.json, alpha-kompatibilis tartományt a backend/package.json rögzíti. Tudatos frissítés után, npm install futtatását követően ellenőrizze a modell- és munkamenetszerződést. Új peerfüggőséget npm telepítéskor jelez, nem betöltéskor. A formátumok DSH-tulajdonúak; változásuk DSH-kiadási tudnivaló, nem LWUI-migráció.

Visszavonás. features.enabled: false és restart, vagy a híd eltávolítása cordis.patch.yml fájlból visszavonja a libreDshEngine szolgáltatást, figyelőt és ágenseket. A munkamenetfájlok adatok; helynyeréshez törölje a sessionStorePath könyvtárat. Csomageltávolítás opcionális, más LWUI-funkciót nem érint.

Meglévő Chat és Work. A Chat adminisztrátori DSH-választást kap átmeneti munkamenetekkel és saját meglévő előzménnyel. A Work külön DSH-motort kap izolált meghajtóval és meglévő sandbox/jóváhagyással. A korábbi modellek viselkedése marad.

A libre-webui mellett a Chat Agents konkrét DSH-szolgáltató/modell opciókat és alapprofilt kínál. A konkrét választás a minősített azonosságot, az alap a futó kompozíció alapmodelljét használja. Címek és összefoglalók közvetlenül a szolgáltatót hívják eszközök nélkül. Egyedi adapter csak alapbejegyzést ad, és külön Ollama- vagy plugin-feladatmodellt kér e funkciókhoz.

A DSH betartja az adminisztrátor Ollama-kapcsolóját. Kikapcsolva modellek nem listázódnak és nem kérdeződnek le; konkrét Ollama-választás szolgáltatóváltás nélkül hibázik. Operátor által rögzített, nem minősített neveknél is kell Ollama-katalógus a biztonságos feloldáshoz. Plugin-only telepítéshez használjon lwui:plugin:<plugin>:<model> választást.

Működési határok

• A gazda Engine és Chat adminisztrátori, solo funkció. Az Engine közös konzol helyi JSONL-lel; team módban nem tölthető. Work a meglévő SQL-repozitóriumot használja.
• A modellhívás a hitelesített hívót használja. Interaktív fordulónál annak kulcsai és modellpreferenciája érvényes. Megbízható nem interaktív kompozíció kifejezetten aktív adminisztrátorra állíthatja a LIBRE_CORDIS_USER értéket. Nincs legrégebbi adminisztrátori alapfallback.
• A gazdafájlok a munkatérre korlátozottak. Olvasás/írás kanonikus célt ellenőriz; munkakönyvtár nem lehet a gyökéren kívül. DSH-módosítási korlátok maradnak. További operátorplugin megbízható szerverkód.
• Gazdaeszközök DSH-szabályokat használnak. Engine ad read-only/workspace-write módokat és egyszeri jóváhagyásokat a határ megkerülése nélkül. Headless Chat elutasít nem megjeleníthető kérdést. Work saját jóváhagyás és konténer útján fut, gazdafájl-eszköz nélkül.
• A streamek élő szöveget és elérhető gondolkodást adnak. Tartós üzenet a végső előzményt őrzi, második szövegpéldány nélkül.
• Restart és törlés mentett munkamenetekkel működik. Üres és kész munkamenet is megmarad. JSONL-törlés leállítja az írót és eltávolítja a fájlt; más tárolóhoz megfelelő törlőadapter kell.
• Régi hibás naplóhoz kifejezett javítás kell. Korábbi ID nélküli üzeneteket a szigorú olvasó elutasít, nem dob el. Lásd Hibaelhárítás.
• Címek helyben keletkeznek. Az első emberi üzenetből rövid cím lesz; üres munkamenetnek nincs származtatott címe.

Futó DSH-példány modelljeinek csatlakoztatása

Az opcionális dsh-native-provider egy másik beállított DSH modelljeit és szolgáltatóit teszi elérhetővé, például a 3080-as helyi webappét. A meglévő profiljába telepítse. Csak ctx.llm hívódik: kulcsok DSH-ban maradnak; nem készít munkamenetet, nem indít ágenst, nem olvas natív csatolmányt és nem futtat natív eszközt.

Azonos Unix-gazda és OS-fiók kell a két folyamathoz. A kifejezetten beállított Unix-socket fizikai, az account tulajdonú 0700 mappát és 0600 socketet használ. Nem ad TCP-listenert, nem használja újra vagy gyengíti a DSH böngészőhitelesítését. Windows és távoli DSH-gazda nem támogatott.

Az OS-fiók a helyi határ: más folyamatai is használhatják a socketet. Nincs külön natív hitelesítő adat vagy azonos fiók alkalmazásai közti izoláció.

Az önálló plugin telepítése

A DSH → Plugins → Add plugin alatt illessze be a nyilvános URL-t a Package name or address mezőbe, majd Install:

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

Kérésre engedélyezze a komponenst. A 0.1.1 Apache-2.0 csomag előreépített runtime-ot és bundle-patchet tartalmaz. Nem kell helyi build, installscript vagy npm-runtimefüggőség. A @libre-webui/dsh-native-provider név nincs npm-en publikálva; a GitHub URL-t használja.

A bundle a <DSH home>/lwui-provider/llm.sock, általában $HOME/.dsh/lwui-provider/llm.sock utat választja; a DSH_HOME elsőbbséget élvez. A privát mappa szükség esetén létrejön. DSH-home-onként egy aktív hidat használjon, vagy további profilok felhasználói cordis.patch.yml fájljában írja felül a socketet. A teljes út legfeljebb 100 UTF-8 bájt, symlinkösszetevő nélkül. A külön konfigurációs útmutató ismerteti a felülírást.

Opcionális CLI-megfelelő:

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

A web helyén a futó profilt adja meg. CLI-telepítés után indítsa újra; élő UI-telepítés azonnal engedélyezhet. Kövesse a DSH restartjelzéseit. Natív forrásmódosítás és kulcsmásolás nem szükséges.

Bundle készítése Libre WebUI-ból

Az LWUI előkészítő scriptet is ad. Forráscheckoutból építse a backendet és hozzon létre új kimeneti könyvtárat:

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

Az npm-terjesztésben kész backend és script van; telepítési könyvtárából a két utolsó parancsot futtassa build nélkül. Utána indítsa újra a profilt. Mindkét előkészítés elutasít meglévő könyvtárat és ad metaadatot, licencet, telepítési leírást.

Libre WebUI csatlakoztatása

A cordis.config.yml ugyanarra az abszolút socketútra mutasson. A nyilvános alapértékhez az /absolute/home helyére saját home kerül:

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

Alternatíva a LIBRE_DSH_PROVIDER_SOCKET. Üres környezeti érték dokumentumbeli út mellett is letilt. Engedélyezze a Cordis Engine funkciót. Aktív adminisztrátor natív modellt választhat Work DeepSeek Harness motorjában, Engine oldalon és Chat Agents csoportban, amihez Agent CLI models is kell. Work a nyers modellt és provider-ID-t providerType: dsh formával őrzi; régi LWUI-s DSH-feladat eredeti szolgáltatóját és motorjelölőjét tartja.

A katalógus élőben olvasódik. Szolgáltató- vagy kulcsváltozás érvényteleníti a generációt és megszakít aktív kéréseket. Nem elérhető socket, modell vagy szolgáltató leállítja a kérést, másikra váltás nélkül. Cím és összefoglaló közvetlen LLM-hívás eszköz nélkül. Ez az első kapcsolat szöveget, gondolkodást és eszközüzenetet fogad; natív kép-/fájlhivatkozást elutasít.

A kulcsok a DSH-operátoré, ezért csak adminisztrátori a kapcsolat szélesebb Work-hozzáférésnél is. A szolgáltató beállítása szerint a kérés elhagyhatja a gazdát; a Work jelzi a távoli használatot. Teamben minden végrehajtó workernek el kell érnie a helyi kapcsolatot; hiány esetén futás tiltott. Cordis vagy socketbeállítás eltávolítása visszavonja az elérést, megtartja a feladatokat. Ha DSH-crash socketet hagy, állítsa le a tulajdonos példányt és csak az elavult socketet törölje újraindítás előtt; a plugin meglévő fájlrendszerbejegyzést nem helyettesít.

Frissítés vagy eltávolítás

Előbb fejezze be vagy szakítsa meg az aktív natív kéréseket. Régi helyi 0.0.0/0.1.0 bundle helyett válasszon Uninstall, majd Add plugin műveletet a GitHub URL-lel. Egyedi socketutat támogatott felhasználói profilfelülírással őrizzen meg. Natív munkamenetek és hitelesítő adatok megmaradnak.

GitHub-telepítés CLI-ből is frissíthető:

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

Utána restart és verzióellenőrzés kell. Letiltott plugin letiltott marad; teszt előtt ellenőrizze. Rögzítéshez vagy visszaállításhoz használja a github:libre-webui/dsh-native-provider#<commit> forrást. Egyedi helyi bundle-höz új könyvtárat építsen és azt adja hozzá; helyi dependency frissítése nem tölt GitHubról.

Eltávolítás előtt törölje LWUI-ból a nativeProvider.socketPath értéket vagy ürítse a LIBRE_DSH_PROVIDER_SOCKET változót, majd:

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

Indítsa újra a DSH-profilt. A mentett feladatok maradnak, de natív kéréseik ugyanazon explicit kapcsolat visszaállításáig hibáznak. A plugin törlése nem töröl szolgáltatói konfigurációt vagy kulcsot. Régi generált bundle-mappát csak akkor töröljön, ha már nincs telepítve.

Natív szolgáltatói használat

A Provider Usage oldalon DeepSeek Harness · provider alatt, nyers modellnévvel látszik. Minden valódi modellkérés egyszer számít, eszközkörök, címek és összefoglalók is. Az oldal sikert, hibát, megszakítást, késleltetést és jelentett tokeneket mutat. Cache-bemenet egyszer kerül a bemeneti összegbe; hiányzó használat méretlen, nem becsült. A dsh-native:<percent-encoded-native-provider-id> ID a meglévő tarifa- és költségszabályokat használja. Ismeretlen tarifa árazatlan marad.

LWUI-szolgáltatós DSH a szolgáltató meglévő rekordját őrzi. Katalógusolvasás és inferencia előtti elutasítás nem készít további hívást. A mérés e kapcsolatverzió telepítésekor kezdődik, nem talál ki előzményt. Azonosító, állapot, idő és számláló tárolódik, prompt, válasz, kulcs, endpoint és szolgáltatói hibaszöveg nélkül.

Konfiguráció ellenőrzése

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" }
  ]
}

A 503 és code: CORDIS_UNAVAILABLE betöltetlen kompozíciót jelent. Az error mutatja az okot, a LIBRE_CORDIS_TRACE=true aktiválási naplót ad. Gyakori okok: Hibaelhárítás.