docs(sl): translate stable install pages (requirements, iso, controlplane)
Slovenian batch 2 (install/, stable subset): requirements.md, iso.md, controlplane-install.md. Deliberately skips first-boot.md and install.md — both carry in-repo "will be rewritten after live ISO validation" notes, so translating them now would be wasted effort. Commands/URLs/env-vars kept in English; prose + frontmatter + tables translated. prettier-clean, no IPs. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
parent
ba19a5e2ca
commit
331456b11c
3 changed files with 137 additions and 0 deletions
24
docs/guide/sl/install/controlplane-install.md
Normal file
24
docs/guide/sl/install/controlplane-install.md
Normal file
|
|
@ -0,0 +1,24 @@
|
|||
---
|
||||
title: 'Namestitev krmilne ravnine'
|
||||
description: Namestite krmilno ravnino Clawdie s standardnim orkestratorjem.
|
||||
---
|
||||
|
||||
Krmilno ravnino namesti standardni orkestrator:
|
||||
|
||||
```bash
|
||||
just install
|
||||
```
|
||||
|
||||
Korenska namestitev poganja krmilno ravnino kot storitev Clawdie, ki jo upravlja
|
||||
gostitelj. Orkestrator skupaj nastavi PF, delovne ječe, PostgreSQL, hostd,
|
||||
namestitev storitve, kontrolne točke in stanje za nadaljevanje.
|
||||
|
||||
Če namestitev ne uspe, nadaljujte od neuspelega koraka:
|
||||
|
||||
```bash
|
||||
just install-from-db
|
||||
just install-from hosts
|
||||
just install -- --dry-run
|
||||
```
|
||||
|
||||
Kanonično ime mostu Bastille/Warden je `warden0`.
|
||||
45
docs/guide/sl/install/iso.md
Normal file
45
docs/guide/sl/install/iso.md
Normal file
|
|
@ -0,0 +1,45 @@
|
|||
---
|
||||
title: Namestitev z ISO
|
||||
description: Zagonske slike USB za fizično strojno opremo in namestitve brez povezave.
|
||||
---
|
||||
|
||||
**Repozitorij:** `https://codeberg.org/Clawdie/Clawdie-ISO`
|
||||
**Oznake:** `https://codeberg.org/Clawdie/Clawdie-ISO/tags`
|
||||
|
||||
Ta stran pokriva izbiro slike in zapis na USB. Za nastavitev ob prvem zagonu
|
||||
(`setup.txt`, zahtevane vrstice in kaj pričakovati) glejte
|
||||
[Prvi zagon](../first-boot/).
|
||||
|
||||
## Prenos
|
||||
|
||||
Izberite sliko, ki ustreza vašemu cilju:
|
||||
|
||||
- **Fizična strojna oprema:** namizje + paketi brez povezave za krajevne
|
||||
namestitve
|
||||
- **Oblak:** slika brez zaslona za postavitve v slogu VPS
|
||||
|
||||
## Zapis na USB
|
||||
|
||||
`/dev/daX` zamenjajte s pravo napravo. Pred zapisom cilj potrdite z
|
||||
`camcontrol devlist` na FreeBSD ali `lsblk` na Linuxu.
|
||||
|
||||
```bash
|
||||
sudo dd if=clawdie-iso-baremetal-DD.mmm.YYYY.img of=/dev/daX bs=1M status=progress
|
||||
```
|
||||
|
||||
Po zapisu lahko bodisi:
|
||||
|
||||
- neposredno uredite nastavitev ob prvem zagonu (`setup.txt`) ali
|
||||
- najprej zaženete neobvezni korak pregleda, da v `system.txt`, `system.env`,
|
||||
`inspect-facts.env` in `suggested-setup.txt` zberete podatke o disku/omrežju
|
||||
- neobvezno pustite, da pregled prazne vrednosti namestitve/shrambe vpiše nazaj
|
||||
v `setup.txt`
|
||||
- neobvezno pustite, da pregled prazna polja strojne opreme vpiše nazaj v
|
||||
`system.env`
|
||||
|
||||
Nato zaženite. Za ostalo glejte [Prvi zagon](../first-boot/).
|
||||
|
||||
## Prilagoditev ali ponovna izgradnja
|
||||
|
||||
Če potrebujete prilagojen nabor paketov ali želite vgraditi določeno različico
|
||||
Clawdie, sledite navodilom za izgradnjo v repozitoriju Clawdie-ISO.
|
||||
68
docs/guide/sl/install/requirements.md
Normal file
68
docs/guide/sl/install/requirements.md
Normal file
|
|
@ -0,0 +1,68 @@
|
|||
---
|
||||
title: 'Zahteve'
|
||||
description: Zahteve glede gostitelja, izvajalnega okolja in orodjarne za Clawdie.
|
||||
---
|
||||
|
||||
Kaj potrebujete na gostitelju pred namestitvijo Clawdie. Namestitveni program z
|
||||
ISO večino tega samodejno pripravi; namestitve na obstoječem gostitelju naj te
|
||||
zahteve preverijo pred zagonom `just install`.
|
||||
|
||||
## Gostitelj
|
||||
|
||||
- **OS:** FreeBSD 15.x (ječe so edino podprto izvajalno okolje).
|
||||
- **Pravice:** root ali uporabnik s `sudo` in dostopom do ZFS.
|
||||
- **ZFS:** zahtevan za ječe Bastille. Posnetki se zajamejo ob mejnikih
|
||||
namestitve, če obstaja `zroot/bastille`; sicer se tiho preskočijo.
|
||||
- **Omrežje:** odhodni HTTPS za namestitev paketov, ponudnika LLM in Telegram.
|
||||
Odhodni NAT prek PF nastavi namestitveni program.
|
||||
|
||||
## Orodjarna
|
||||
|
||||
- **Rust** prek rustup, nameščen pod `/opt/clawdie/rustup`. Potreben za domorodne
|
||||
odvisnosti (SWC, tree-sitter). ISO ga namesti; namestitve na obstoječem
|
||||
gostitelju ga zaženejo iz
|
||||
[`Namestitvenega orkestratorja`](./install/).
|
||||
- **Node.js + tsx** za namestitvene skripte in izvajalno okolje.
|
||||
- **Bastille** za upravljanje ječ.
|
||||
|
||||
## Filozofija izvajalnega okolja
|
||||
|
||||
Clawdie je en sam proces Node.js, ki orkestrira agente v ječah. Oblikovne
|
||||
zaveze, ki določajo, kaj potrebujete:
|
||||
|
||||
- **Varnost prek izolacije na ravni OS.** Agenti tečejo znotraj ječ FreeBSD.
|
||||
Dostop do lupine je varen, ker se izvaja znotraj ječe, ne na gostitelju.
|
||||
Dostop do datotečnega sistema je omejen na izrecno priklopljene poti.
|
||||
- **Dovolj majhno, da se prebere.** Brez mikrostoritev, brez čakalnih vrst
|
||||
sporočil, brez abstrakcijskih plasti. En proces, peščica izvornih datotek.
|
||||
- **Delovanje, prirojeno UI.** Koda predpostavlja, da imate sodelavca UI.
|
||||
Operaterska orodja (nadzorna plošča, spremljanje) so tanka; pomočnik dopolni
|
||||
vrzel s tem, da neposredno odgovarja na vprašanja o dnevnikih, stanju in
|
||||
nastavitvah.
|
||||
- **Prilagajanje = spremembe kode.** Sprožilna beseda in nekaj osnovnih
|
||||
nastavitev živijo v `.env`. Vse drugo: uredite kodo. Koda je dovolj majhna,
|
||||
da je to varno.
|
||||
|
||||
## Stične površine za povezovanje
|
||||
|
||||
- **Telegram** prek Bot API (`grammy`). Glavni vhodno-izhodni kanal.
|
||||
- **PostgreSQL** za baze za delovanje, pomnilnik in vgrajeno znanje. Privzeto je
|
||||
izvajanje na gostitelju (`DB_RUNTIME=host`); nastavite `DB_RUNTIME=jail`, da se
|
||||
namesto tega pripravi namenska ječa db.
|
||||
- **Ponudnik LLM** po vaši izbiri. OpenRouter je priporočena zagonska pot; po
|
||||
namestitvi preklopite na neposredne ključe ponudnikov (zAI, Anthropic, OpenAI,
|
||||
Gemini) ali na lokalni Ollama, tako da uredite `.env`. Glejte
|
||||
[Preklop ponudnika ob napaki](../operate/provider-fallback/) za vedenje glede
|
||||
zaznave omejitev in preklopa.
|
||||
|
||||
## Model razširitev z veščinami
|
||||
|
||||
Veščine so način, kako operaterji dodajajo zmožnosti brez razvejanja jedra.
|
||||
Pogoste oblike veščin:
|
||||
|
||||
- **Komunikacijski kanali** (`/add-slack`, `/add-discord` itd.) za razširitev
|
||||
onkraj Telegrama.
|
||||
- **Avtomatizacija brskalnika** prek `agent-browser`, ki teče znotraj ječe.
|
||||
- **Načrtovana opravila**, registrirana glede na kontekst posamezne skupine.
|
||||
|
||||
Veščine se namestijo v `data/skills/` in se naložijo ob zagonu.
|
||||
Loading…
Add table
Reference in a new issue