HansaChat

Documentation

Kanalai ir nariai

Kurkite kanalus, prisijunkite prie jų, archyvuokite ir tvarkykite narystes idempotentiškomis komandomis.

Kanalų komandos pirmiausia skaito dabartinę būseną ir pasiekia tai, ko prašote: komandos, kuri jau įsigaliojo, pakartojimas sėkmingai baigiasi su changed: false, vietoj to kad nepavyktų arba dubliuotų.

hansa chat channels list                       # your channels
hansa chat channels browse                     # public channels you have not joined
hansa chat channels get --channel general      # one channel by slug or ID

Kanalų kūrimas ir keitimas

# Return "Marketing" and create it only if it does not exist yet
hansa chat channels ensure --name Marketing --type public

# Rename or change the type; a no-op when nothing changes
hansa chat channels set --channel marketing --name Marketing EU --type private

# Archive a channel (idempotent)
hansa chat channels archive --channel marketing

Nuorodos naudoja posistemės slug arba ID, niekada rodomo vardo atitikimą. Atkreipkite dėmesį, kad kanalo pervadinimas pakeičia jo slug — scenarijuose nurodykite kanalą pagal ID arba po pervadinimo iš naujo išriškite jo identifikatorių.

Narystė

hansa chat channels join --channel general     # no-op when already a member
hansa chat channels leave --channel general    # no-op when not a member
hansa chat channels members --channel general  # list channel members
hansa chat channels invite --channel general --member 42

Tiesioginės žinutės

hansa chat channels dm --member 42

Grąžina esamą tiesioginį kanalą su tuo vartotoju arba sukuria jį; posistemė šį veiksmą laiko idempotentišku.

Skaitymo būsena

Kanalų ir žinučių skaitymas niekada nekeičia to, kas laikoma skaityta. Vienintelė komanda, kuri tai daro:

hansa chat channels mark-read --channel general

Darbo erdvės nariai

hansa chat members list --query igor   # search members by text
hansa chat members get --member 42     # one member by user ID