Riešenie problémov a získanie pomoci v Prism

Prism je kolaboratívny pracovný priestor LaTeX postavený na AI a frontier modeloch — navrhnutý tak, aby výskumníkom pomáhal myslieť, písať a iterovať rýchlejšie. Jeho vstavaná inteligencia zvyšuje rýchlosť aj hĺbku vedeckej práce.

Táto príručka vysvetľuje, ako riešiť bežné problémy a kde nájsť ďalšiu pomoc.

Ako získať prístup k Prism

Prism je dostupný na adrese prism.openai.com pre všetkých používateľov účtov Free, Go, Plus alebo Pro ChatGPT, ktorí nie sú a ani neboli členmi pracovného priestoru Business alebo Enterprise. V blízkej budúcnosti rozšírime prístup na Business, Enterprise a Edu.

1. Používanie vstavanej inteligencie Prism

Prism obsahuje asistenta priamo v editore, ktorého poháňajú frontier modely OpenAI. Rozumie kontextu vášho dokumentu a môže vám pomôcť generovať LaTeX, diagnostikovať chyby a navrhovať opravy bez toho, aby ste museli opustiť editor. Dostanete sa k nemu z panela v spodnej časti pracovného priestoru.

1. Generovanie úryvkov LaTeX: Požiadajte Prism, aby vytvoril bežné prvky LaTeX, napríklad „Vytvor tabuľku 4×4“ alebo „Pridaj obrázok s popisom“. Prism vráti LaTeX pripravený na použitie a ponúkne možnosti Keep a Undo, aby ste ho mohli vložiť priamo do projektu.

2. Diagnostika problémov s kompiláciou: Ak sa váš dokument nedá skompilovať, opíšte problém v paneli (napríklad „Môj dokument sa nekompiluje“). Prism položí doplňujúce otázky a prevedie vás pravdepodobnými príčinami, ako sú chýbajúce príkazy alebo nevyriešené referencie.

3. Oprava chýb priamo v texte: Chyby a varovania sa zobrazujú ako červené alebo žlté značky na okraji editora. Môžete požiadať Prism, aby opravil konkrétnu chybu, a on analyzuje príslušné riadky, vysvetlí, čo je zle, a navrhne cielené úpravy. Návrh môžete použiť priamo a znova skompilovať, aby ste potvrdili opravu.

4. Korektúra: Požiadajte Prism, aby skontroloval časť textu a zvýraznil prípadné chyby alebo medzery v logike, a tiež navrhol, ako môžem zlepšiť jej zrozumiteľnosť. Môžete využiť Skills, napríklad Paper Review, na redakčnú a faktickú spätnú väzbu.

5. Vyhľadávanie literatúry: Pridaj do môjho článku bibliografiu vrátane návrhu súvisiacej literatúry, ktorú som možno prehliadol.

2. Diagnostika chýb kompilácie

Ak sa váš dokument LaTeX nedá skompilovať, skúste nasledujúce kroky:

1. Skontrolujte označenie chyby: Červené a žlté značky zvýrazňujú miesta, kde Prism zistil problém. Kliknutím na značku zobrazíte podrobnosti a potom použite vstavaného asistenta na diagnostiku chyby.

2. Skontrolujte protokol kompilácie: Keď kompilácia zlyhá, panel náhľadu PDF zobrazí protokol kompilácie. Zamerajte sa na prvé chybové hlásenie (napríklad chýbajúce \end{document}), pretože neskoršie chyby sú často reťazové následky. Zdieľajte túto správu s Prism, aby ste získali presnejšie usmernenie.

3. Vráťte späť nedávne zmeny: Ak sa chyba objavila po nedávnej úprave, vráťte túto zmenu späť alebo ju dočasne zakomentujte a zistite, či kompilácia prebehne úspešne.

4. Zredukujte dokument na minimálny príklad: Ak problémy pretrvávajú, zjednodušte dokument len na nevyhnutný obsah. Odstránenie nesúvisiacich častí pomáha izolovať zdroj chyby.

3. Osvedčené postupy na predchádzanie problémom

1. Zostaňte prihlásení: Pracujte vždy prihlásení, aby sa zmeny ukladali a boli dostupné vo všetkých reláciách.

2. Používajte podporované balíčky: Prism podporuje mnohé bežne používané balíčky LaTeX. Zriedkavé, zastarané alebo neudržiavané balíčky môžu spôsobovať neočakávané chyby kompilácie.

3. Upravujte postupne: Robte malé zmeny a kompilujte často. Takto ľahšie zistíte, ktorá úprava spôsobila chybu, a rýchlo sa zotavíte.

Presun projektov LaTeX do Prism

Táto príručka vysvetľuje, ako presunúť existujúce projekty LaTeX — buď z Overleaf, alebo z vášho lokálneho počítača — do prism. Import projektov vám umožní mať všetko na jednom mieste a pokračovať v práci bez nutnosti ručne znovu vytvárať súbory.

Import projektov z Overleaf

Ak chcete presunúť projekt z Overleaf do prism, najprv si z Overleaf stiahnite súbory projektu a potom ich nahrajte do prism.

Stiahnutie jedného projektu

1. Otvorte svoj ovládací panel projektov Overleaf.

2. Nájdite projekt, ktorý chcete preniesť.

3. Kliknite na ikonu sťahovania v rovnakom riadku ako názov projektu.

4. Overleaf stiahne celý projekt do vášho počítača ako súbor .zip.

Stiahnutie viacerých projektov

1. Otvorte svoj zoznam projektov Overleaf.

2. Vyberte projekty pomocou zaškrtávacieho políčka na začiatku každého riadku.

   

3. Ak chcete vybrať všetko, kliknite na prvé zaškrtávacie políčko v zozname.

4. Po výbere kliknite na ikonu sťahovania v pravom hornom rohu zoznamu projektov.

   

Vybrané projekty sa stiahnu ako súbory .zip.

Import projektov do Prism

Prism dokáže importovať projekty tromi spôsobmi: nahraním priečinka, nahraním archívu .zip alebo presunutím myšou súborov do zobrazenia All Projects.


Import projektu z ponuky Import:

1. Otvorte Prism a prejdite na Import.

2. Kliknutím na šípku vedľa Import vyberte typ importu.

Vyberte jednu z nasledujúcich možností:

1. Otvorte prism a prejdite na možnosť Import.

2. Kliknutím na šípku vedľa Import vyberte typ importu.

3. Vyberte jednu z nasledujúcich možností:

Import súboru .zip: Vyberte stiahnutý archív projektu zo svojho počítača. Prism projekt automaticky rozbalí a načíta.

Import priečinka: Vyberte priečinok projektu zo svojho počítača. Prism importuje vaše súbory .tex, súbory bibliografie, obrázky a ďalšie zdroje projektu.

Import pomocou presunutia myšou: V zobrazení All Projects presuňte priečinok projektu alebo súbor .zip do Prism. Prism automaticky vytvorí nový projekt a importuje za vás súbory.

Po dokončení nahrávania Prism otvorí celý projekt, aby ste mohli začať upravovať a kompilovať.

Ďalšie časté otázky

Účet, zabezpečenie a fakturácia

Otázka: Kde nájdem vaše zásady ochrany osobných údajov?
Odpoveď: Zásady ochrany osobných údajov Prism nájdete tu.

Otázka: Trénujete na mojich údajoch?
Odpoveď: Používatelia majú plnú kontrolu nad tým, či sa ich údaje používajú na zlepšovanie našich modelov, v súlade s našimi zásadami ochrany osobných údajov.

Otázka: Používate „nulové uchovávanie údajov“ (ZDR)? Aké zaznamenávanie/uchovávanie prebieha?
Odpoveď: Prism v súčasnosti nepoužíva možnosť API „nulové uchovávanie údajov“ (ZDR) a po požiadavkách určitý čas uchováva logy na zlepšovanie produktu.


Otázka: Ponúkate režim ochrany súkromia, v ktorom sa neukladá žiadny text ani ho nekontrolujú ľudia, a/alebo rezidenciu údajov iba v EÚ?
Odpoveď: Ide o požadované funkcie; sú v pláne/backlogu, ale zatiaľ pre ne nie je stanovený záväzný termín.

Zdieľanie a spolupráca

Q: Prečo nemôžem zdieľať odkaz typu „ktokoľvek môže upravovať“? (Rozbaľovacia ponuka povoľuje len „ktokoľvek môže zobraziť“.)
A: Takto je to momentálne navrhnuté. Zdieľanie cez odkaz s možnosťou „upravovať môže ktokoľvek“ zatiaľ nie je podporované; editori musia byť pridaní ako spolupracovníci (s účtom Prism).

Q: Spolupracovníkom nechodia pozvánkové e-maily — ako sa dostanú k projektu?
A: Požiadajte ich, aby si skontrolovali priečinok spam/nevyžiadaná pošta a aby sa prihlásili pomocou pozvanej e-mailovej adresy; zdieľaný projekt by sa im mal zobraziť po prvom prihlásení.

Import a export projektov

Q: Nahrávanie/import ZIP sa zasekol na hlásení „importing your project“. Čo mám robiť?
A: Skúste nahrávanie zopakovať. Ak bude po opakovaní stále zaseknuté, zdieľajte súbor ZIP s podporou, aby bolo možné odladenie cesty importu.

Q: Ako exportujem/stiahnem svoj projekt ako ZIP?
A: Kliknite na názov projektu a potom vyberte možnosť Export, čím stiahnete komprimovanú kópiu projektu. Kým sa vytvorí backendové pripojenie a export bude možný, môže to trvať niekoľko sekúnd.

Spoľahlivosť, výpadky a pripojenie

Q: Moje projekty po obnovení zmizli. Sú stratené?
A: Obnovte stránku ešte raz a znova skontrolujte zoznam projektov, vaše údaje by sa mali znova zobraziť.

Q: Moje projekty po obnovení stránky zmizli. Sú stratené?
A: Môže sa to stať počas výpadku poskytovateľa. Skúste to znova; vaše projekty by sa mali znovu zobraziť. Ak nie, podpora vám môže pomôcť s ich obnovou.

Q: Zdá sa, že stránka je offline / aplikácia hlási, že sa nedokáže pripojiť k backendu. Čo mám robiť?
A: Skúste to znova/obnovte stránku. Ak problém pretrváva, pošlite podpore podrobnosti o tom, čo vidíte (a ak je to možné, aj odkaz na projekt), aby sa to dalo prešetriť.

Integrita údajov, obnova, zálohy a história verzií

Q: Môj dokument zamrzol, potom obsah zmizol a kotvy komentárov sa presunuli. Môžem ho obnoviť?
A: Začnite stiahnutím .zip zálohy. Prism obsahuje aj históriu verzií, ktorá vám môže umožniť obnoviť staršiu verziu. Polohy kotiev komentárov nemusia byť vždy obnoviteľné a komentáre sa momentálne neexportujú do záloh. Ak sa zmenilo formátovanie, skúste ho opraviť pomocou formátovača kódu.

Q: Znova som otvoril(a) projekt a súbory/obsah sa vrátili na staršiu verziu alebo zmizli — čo sa stalo?
A: Istý čas sa ukladanie projektov spoliehalo na externého poskytovateľa, ktorý počas nárastu používania nestíhal. Ukladanie bolo presunuté do interného systému, aby sa znížili chyby pripojenia a zabránilo sa opakovaniu, a boli pridané ďalšie ochranné mechanizmy.

Q: Dajú sa obnoviť pozície komentárov a sú komentáre zahrnuté v zálohách projektov?
A: Pozície komentárov po udalosti nemusia byť obnoviteľné. Teraz už existujú pravidelné zálohy (napr. približne každých 10 minút) na obnovu pri budúcich incidentoch, ale komentáre sa momentálne neexportujú do ZIP záloh.

Integrácie

Zotero

Otázka: Prečo nemôžem do Prism importovať skupinové knižnice Zotero?
Odpoveď: Skupinové knižnice Zotero zatiaľ nie sú podporované; individuálne knižnice fungujú, ale skupinové knižnice momentálne podporované nie sú.

Otázka: Moja integrácia Zotero sa zasekla (napr. po zmene účtov alebo kľúčov API). Ako sa dá opraviť?
Odpoveď: Podpora bude potrebovať vaše číselné ID Zotero (nie vaše používateľské meno), aby mohla odpojiť integráciu od predchádzajúceho/anonymného používateľa; potom ju môžete znova prepojiť so svojím účtom. Príklad, ako to urobiť: https://www.youtube.com/watch?v=7vDiZ8o_eHk

Git

Q: Môžem klonovať projekt Prism cez Git (GitHub/GitLab) alebo ho udržiavať synchronizovaný s Git platformou mojej inštitúcie?
A: Integrácia Git zatiaľ nie je dostupná, ale ide o pripravovaný vývojový projekt s vysokou prioritou.

Zostavenie LaTeX a riešenie problémov

Q: Ako vynútim čisté zostavenie (vymazanie artefaktov Aux/toc/bbl)?
A: Obnovte stránku. Obnovenie stránky vynúti nové, čisté zostavenie.

Q: Obrázky/figúry sa v Prism nenačítajú, ale ten istý LaTeX funguje inde.
A: Používajte cesty relatívne k súboru .tex, ktorý vykonáva import. Ak je súbor .tex v podpriečinku a obrázok je v koreňovom adresári projektu, pridajte pred cestu ../.

Q: Kompilácia je extrémne pomalá alebo sa nikdy nedokončí. Ako zistím príčinu?
A: Zakomentujte jednotlivé časti (a potom menšie úseky v týchto častiach), až kým kompilácia neprebehne úspešne, a potom zúžte problém na presný riadok, ktorý ho spôsobuje. Skontrolujte aj varovania a chyby v protokoloch, začnite od prvého.

Q: Dostávam varovania „Underfull/Overfull \hbox“ vo vygenerovanom .bbl. Je to chyba kompilácie?
A: Nie, ide o sadzobné varovania, nie o fatálne chyby kompilácie. Ak výstupné PDF vyzerá prijateľne, toto varovanie možno zvyčajne ignorovať.

Q: Prečo v Beamer prostredia lstlisting/listings hlásia chybu vo frame (napr. „Extra }, or forgotten \endgroup“)?
A: Pri používaní prostredí listing označte frame v Beamer ako [fragile]; často to tieto chyby vyrieši.

Q: Citácie \cite sa zobrazujú ako „[?]“, hoci môj súbor .bib existuje a príkazy bibliografie sú prítomné. Aká konfigurácia funguje?
Jedným z úspešných riešení je zabezpečiť, aby bola bibliografia správne zahrnutá z hlavného dokumentu; pri pracovných postupoch v štýle BibTeX zahrňte \bibliographystyle{plain} a \bibliography{refs} (kde refs.bib je váš súbor).

Používateľské rozhranie produktu a požiadavky na funkcie

Q: Ponúka Prism svetlý režim?
A: Áno. Prism podporuje tri nastavenia vzhľadu: Systém, Svetlý a Tmavý. Môžete si vybrať motív, ktorý vám najviac vyhovuje.