vikix.GvidiloInstaliFonto

13 Aldonaĵoj, unu post la alia

Aldonaĵoj estas etaj aldonaĵoj, kiujn vi elektas: kelkaj vortoj en la menuo, klavo, Super+m-enira komando, foje programo, kiu funkcias en la fono. Ili venas de sia propra deponejo, vikix-plugins, en versio, kiun Vikix kontrolis, kaj nenio estas aldonata ĝis vi petas tion. Ĉi tiu paĝo estas gvidilo por ĉiu el ili: kion ĝi faras, kiel aldonigi ĝin, kiel uzi ĝin, kie ĝi konservas aĵojn, kaj kion fari kiam ĝi ne funkcias.


13.1 Aldonado, forigo, malŝaltado

vikix plugin list                 # every plugin, yours marked
vikix plugin add NAME             # says what it runs, needs and changes, asks, then adds it
vikix plugin remove NAME          # runs its remove; your settings for it stay
vikix plugin off NAME             # stop loading it (vikix plugin on NAME brings it back)
vikix plugin safe                 # the next login loads none

La ŝlosiloj kaj la menuo de aldonaĵo funkcias tuj. Se la ŝlosilo de aldonaĵo estas la sama kiel tiu de Vikix aŭ de iu el viaj retaj programoj, la aldonaĵo venkas; aperas mesaĝo, kiu mencias ambaŭ, kaj vikix doctor listigas ĝin ĝis unu el ili estas forigita; forigante la aldonaĵon, la ŝlosilo estas redonita. La testoj de Vikix kontrolas la aldonaĵojn je la versio, kiu estas uzata, por eviti tiajn konfliktojn antaŭ publikigo. La agordoj de ĉiu aldonaĵo estas viaj, en ~/.config/vikix/plugins/NOMO/, ili estas kopiaj unufoje kaj neniam anstataŭataj. Aldonaĵo, kiu konservas registron de tio, kion ĝi trovis (serĉo pri flugo, partopreno en kunveno), metas ĝin en la datenbanko, vikix records (LEGŲ), kie vi povas serĉi ĝin.

La komandoj de aldonaĵo (inbox, repos, flights...) estas en via PATH dum ĝi estas aktivigita, ĉiu kun helpa paĝo, kiu estas kreita el tio, kion ĝi eldonas per -h: man inbox. man vikix listigas ilin post la propraj de Vikix, kaj forigante la aldonaĵon, ĝi forigas ties helpajn paĝojn.

La kodo de aldonaĵo funkcias ene de la labortablo kun ĉiuj ĝiaj kapabloj, kiel via user.lisp: aldonaĵu tiujn, kiujn vi fidas. Se unu el ili iam haltigas la lanĉon de la labortablo, ensalutu en teksta konzolo (Ctrl+Alt+F2), ruligu vikix plugin safe, ensalutu denove, kaj malŝaltu la kaŭzon.


13.1.1 Aldonaĵo de alia deponejo

Aldonaĵo ne devas veni de la deponejo de aldonaĵoj: projekto, kiun vi mem kreis (aŭ de iu, kiun vi fidas), kiu konservas dosierujon de aldonaĵoj en la formato de aldonaĵoj, povas esti aldonita de sia deponejo, je la versio, kiun vi elektas.

vikix plugin add budanth --from https://github.com/you/budanth          # at its newest commit
vikix plugin add budanth --from ~/src/budanth --at v0.3                 # a folder on this machine, at a tag
vikix plugin pin budanth                                                # move it to the newest commit
vikix plugin pin budanth 7903146abc...                                  # or to one you name
vikix plugin status                                                     # each one's repository and commit

La kromprogramo estas la dosierujo nomita laŭ ĝi en tiu deponejo (budanth/ en la deponejo budanth), aŭ la deponejo mem se ĝia manifest-dosiero estas ĉe la supro. Vikix alprenas la deponejon je tiu versio al ~/.local/share/vikix/plugins-from/NOMO kaj skribas linion budanth from REPO at COMMIT en vian plugins.list; vikix update konservas la alprenitan version, kaj nenio alian ŝanĝas ĝin krom vikix plugin pin. Ĉio alia estas kiel ĉe ajn kromprogramo: add montras kion ĝi faras kaj ŝanĝas, kaj petas, ĝiaj programoj ricevas helppagojn, ĝiaj agordoj estas viaj, off, on kaj remove funkcias simile (remove forigas la alprenitan version; viaj agordoj restas). La diferenco estas la fidemo: Vikix kontrolis la kromprogramojn je sia propra versio, ne ĉi tiuj, kaj add diras tion. Nomon, kiun la deponejo de la kromprogramoj havas, ne povas esti prenita de aliloko.

La ŝlosiloj en mallonga resumo. La ŝlosiloj de kromprogramo estas ĉiuj sur Super+Alt, kun Shift por dua sur la sama litero: tie troviĝas ĉio preter la ses ĉefaj programoj (la regulo por ŝlosiloj).

Super+Alt+w

Kromprogramo: agent-waiting
Kion ĝi faras: Iru al la agento, kiu atendas vin, aŭ elektu inter pluraj

Super+Alt+u

Kromprogramo: ai-usage
Kion ĝi faras: Kiom el via Claude-plano estas uzata

Super+Alt+j

Kromprogramo: next-meeting
Kion ĝi faras: Partoprenu la aktualan kunvenon, aŭ la venontan

Super+Alt+c

Kromprogramo: next-meeting
Kion ĝi faras: La kunvenoj de la venonta semajno

Super+Alt+f

Kromprogramo: flights
Kion ĝi faras: Serĉu flugojn

Super+Alt+g

Kromprogramo: repos
Kion ĝi faras: Kiuj projektoj bezonas aperigi, alpreni aŭ registri ŝanĝojn

Super+Alt+i

Kromprogramo: inbox
Kion ĝi faras: Notu en vian enkorbon

Super+Alt+Shift+i

Kromprogramo: inbox
Kion ĝi faras: Notu, citante tion, kion vi elektis

Super+Alt+Shift+s

Kromprogramo: inbox
Kion ĝi faras: Ordenu la enkorbon


13.2 agent-waiting: agento atendas vin

Vi komencas Claude Code aŭ Codex pri tasko en unu fenestro kaj faras ion alian en alia. Kiam ĝi bezonas vin, aŭ finis, la baro diras, kiu sesio, kie ĝi estas kaj ĉu ĝi petas ion de vi; notifo diras kion; kaj unu ŝlosilo viiras tien.

Aldonu ĝin: vikix plugin add agent-waiting. Ĝi aldonas kvin hokojn al la agordoj de Claude Code, ~/.claude/settings.json (unue oni konservas kopion de la dosiero). Claude Code-sesio, kiu jam funkcias, alprenas ilin, kiam vi tajpas /hooks en ĝi (ĝi petas, ke vi rigardu ilin), aŭ kiam ĝi komencas denove. Post ĝisdatigo, kiu alportas novajn hokojn, aldonu ĝin denove: ĝi montras, kion ĝi ŝanĝas, petas, kaj aldonas nur tion, kio ne estas tie. Kiam Codex estas agordita (~/.codex), ĝi ankaŭ metas la agordon notify de Codex en ~/.codex/config.toml (unue oni konservas kopion), kiu aktivigas la kromprogramon kiam turno finiĝas; via propra notify restas kiel estas, kaj ĝi estas menciita.

Uzu ĝin:

Kie troviĝas la aferoj: malgranda dosiero por ĉiu fenestro en ~/.local/state/vikix/agents/: la stato kaj la tempo, la dosierujo, kaj la linio de tio, kio estis dirita.

Kiam ĝi ne funkcias:

Forigu ĝin: vikix plugin remove agent-waiting forigas la hakilojn el ~/.claude/settings.json kaj la agordon notify el ~/.codex/config.toml denove, kaj lasas viajn aliajn agordojn tiel, kiel ili estis.


13.3 ai-usage: kiom da via Claude-plano restas

Kun Claude Pro aŭ Max-plano, Claude Code scias, kiom da la plano vi uzis: la 5-hora fenestro kaj la semajno. Tio metiĝas en la breton, do vi vidas limon alproksimiĝantan.

Aldonu ĝin: vikix plugin add ai-usage. Claude Code sendas tiujn nombrojn nur al sia statuslinio (la linio sub ĝia prompto), do la kromprogramo fariĝas la statuslinio. Se vi jam havis propran statuslinion, ĝi daŭre funkcios, tra la kromprogramo, kaj revenos kiel ĝi estis, kiam vi forigas ĝin.

Uzu ĝin:

Kie troviĝas la aferoj: la nombroj en ~/.local/state/vikix/ai-usage. Ĉiun 15 minutojn maksimume, rekordo en la rekorda stoko: vikix records list ai-usage estas via uzo dum la tagoj kaj semajnoj.

Kiam ĝi ne funkcias:

Forigu ĝin: vikix plugin remove ai-usage remetias la statuslinion, kiun vi havis antaŭe (aŭ neniun).


13.4 next-meeting: via venonta kunveno, kaj aliĝi al ĝi

Via venonta kunveno en la breto, kun kiom da tempo restas ĝis ĝia komenco; notifo kvin minutojn antaŭe; kaj ununura ŝlosilo por aliĝi al ĝi, kunveno en la Teams-retejo.

Aldonu ĝin: vikix plugin add next-meeting. Ĝi instaldas du malgrandajn Python-bibliotekojn por legi kalendarojn (ĝi unue demandos). Poste donu al ĝi viajn kalendarojn: la privata ligo de ĉiu, adreso, kiu permesas al la kromprogramo legi tiun kalendaron.

next-meeting add work      # asks for the link; what you paste isn't shown
next-meeting add home
next-meeting calendars     # your calendars, by label (never the secret part)
next-meeting forget home

Kie troviĝas la privata ligilo de ĉiu kalendaro:

Privata ligilo estas la ŝlosilo al tiu kalendaro: ĉiu, kiu havas ĝin, povas legi ĝin. La kromprogramo konservas ilin en dosiero, kiun nur vi povas legi kaj neniam elmontras ilin. Se unu el ili hazarde eliras, redifinu ĝin tie, kie vi ricevis ĝin.

Uzu ĝin:

Kie troviĝas la aferoj: la ligiloj en ~/.config/vikix/plugins/next-meeting/calendars (600); la kalendaroj kiel lastfoje legitaj en ~/.cache/vikix/next-meeting/; kion la breto montras en ~/.local/state/vikix/next-meeting. Ĉiu kunveno, al kiu vi aliĝas, estas registro: vikix records list next-meeting.

Kiam ĝi ne funkcias:

Forigu ĝin: vikix plugin remove next-meeting. Viaj kalendaroligoj restas en la dosierujo de agordoj ĝis vi forigas ĝin.


13.5 flights: serĉado de flugoj el linio

Tipe linion kiel DXB LHR 12 Nov, back 20th kaj vidu la flugojn, komence la plej malmultekostaj, kun la plej rapidaj markitaj. Eniru malfermas tiun serĉon en Google Flights, kie vi rezervas (tie aŭ en la retejo de la flugkompanio): la kromprogramo mem neniam rezervas ion. Ĝi ankaŭ povas observi itineron kaj sciigi al vi, kiam ĝi fariĝas pli malmultekosta.

Aldonu ĝin: vikix plugin add flights. Ĝi kreas Python-programon kun fast-flights, la biblioteko, kiu legas Google Flights (unu minuto, unuvoje). Poste agordu vian valuton kaj hejman flughavenon en ~/.config/vikix/plugins/flights/settings:

currency = AED
home = DXB

Kun hejma flughaveno, LHR 12 Nov sufiĉas.

Uzu ĝin:

flights "LHR JFK 3 Dec business"    # the list, in the terminal
flights watch "DXB LHR 12 Nov"      # watch a route
flights watching                    # what's watched, and the cheapest seen
flights unwatch 2                   # stop watching the second

Kie troviĝas la datumoj: la kontrolataj itineroj en ~/.config/vikix/plugins/flights/watched; la viditaj prezoj en ~/.local/state/vikix/flights/. Ĉiu serĉo kun ĝiaj rezultoj, kaj la prezo de ĉiu kontrolata itinero ĉe ĉiu kontrolo, estas registritaj: vikix records search singapore, vikix records list flights --kind price.

Kiam ĝi ne funkcias:

Forigi ĝin: vikix plugin remove flights forigas ankaŭ ĝian Python-kodon. Viaj kontrolataj itineroj restas en la dosierujo de la agordoj.


13.6 repos: kion viaj projektoj bezonas

Kiaj el viaj git-projektoj havas ne-almetitajn ŝanĝojn, ne-povitajn almetojn, almetojn en GitHub, kiuj ne estis alprenitaj, ne-povitajn etikedojn, aŭ restajn ŝarĝojn. La baro kalkas; unu klavo malfermas terminalon kun la detaloj kaj la komandoj, kiuj devas esti ekzekutitaj.

Aldoni ĝin: vikix plugin add repos. Ĝi kontrolas ĉiun projekton en ~/src, kaj ankaŭ en ~/.emacs.d kaj ~/.dotfiles. Por ŝanĝi kiujn, vidu la agordojn sube.

Uzi ĝin:

Ĝi neniam puŝas, alprenas aŭ kunigas, krom se vi petas, kaj peti al GitHub neniam bezonas vian pasvorton de SSH: ĝi iras per HTTPS, per la eniro de gh, se vi havas unu.

Agordoj (~/.config/vikix/plugins/repos/settings):

roots = ~/src                       # folders whose projects it looks at
extra = ~/.emacs.d ~/.dotfiles      # single projects elsewhere
skip =                              # projects to leave out, by folder name
push = gpush {path}                 # the commands it suggests, if not git's own
pins = esploro:~/src/vikix/bin/vikix-esploro vikix-plugins:~/src/vikix/bin/vikix-plugin
                                    # PROJECT:FILE, the file holding NAME_COMMIT=<sha>

Kiam ĝi ne funkcias:

Forigu ĝin: vikix plugin remove repos.


13.7 inbox: notoj de ĉie

Premante klavon super ĉio, kion vi faras, malfermiĝas eta fenestro; tio, kion vi skribas aŭ diras, finiĝas en via Org-inbox en Dropbox, kiun viaj telefonoj ankaŭ vidas. Poste, per unu klavo, la inbox ordiĝas en viajn notdosierojn. Ĝi havas sian propran gvidilon: Viaj notoj.

Aldonu ĝin: vikix plugin add inbox. Ĝi bezonas Emacs (vikix add emacs) por la fenestro; sen Emacs, la fenestro estas ununura linia "rofi"-peto.

Uzu ĝin:

Kie la aferoj estas: la notoj en ~/Dropbox/notes/; la inbox estas inbox.org (alia dosiero: file = ~/notes/inbox.org en ~/.config/vikix/plugins/inbox/settings); la kopioj, kiujn ĉiu ordigado konservas, estas en ~/.local/state/vikix/inbox/sorts/.

Kiam ĝi ne funkcias:

Forigu ĝin: vikix plugin remove inbox. Viaj notoj restas tie, kie ili estas.