Řešení problémů a získání pomoci v Prism

Prism je kolaborativní pracovní prostor pro LaTeX postavený nativně na AI a na špičkových modelech — navržený tak, aby výzkumníkům pomáhal rychleji přemýšlet, psát a iterovat. Jeho vestavěná inteligence zvyšuje rychlost i hloubku vědecké práce.

Tato příručka popisuje, jak řešit běžné problémy a kde najít další pomoc.

Jak získat přístup k Prism

Prism je dostupný na adrese prism.openai.com všem uživatelům s účtem ChatGPT Free, Go, Plus nebo Pro, kteří nejsou a nebyli členy pracovního prostoru Business nebo Enterprise. Přístup pro Business, Enterprise a Edu rozšíříme v blízké budoucnosti.

1. Používání vestavěné inteligence Prism

Prism obsahuje asistenta přímo v editoru, který využívá špičkové modely OpenAI. Rozumí kontextu vašeho dokumentu a může vám pomoci generovat LaTeX, diagnostikovat chyby a navrhovat opravy, aniž byste museli editor opustit. Dostanete se k němu z panelu ve spodní části pracovního prostoru.

1. Generování úryvků LaTeXu: Požádejte Prism, aby vytvořil běžné prvky LaTeXu, například „Vytvoř tabulku 4×4“ nebo „Přidej obrázek s popiskem“. Prism vrátí připravený LaTeX a nabídne možnosti Keep a Undo, takže jej můžete vložit přímo do projektu.

2. Diagnostika problémů s kompilací: Pokud se váš dokument nepodaří zkompilovat, popište problém v panelu (například „Můj dokument se nekompiluje“). Prism položí upřesňující otázky a provede vás pravděpodobnými příčinami, jako jsou chybějící příkazy nebo nevyřešené reference.

3. Oprava chyb přímo v textu: Chyby a varování se v okraji editoru zobrazují jako červené nebo žluté značky. Můžete Prism požádat o opravu konkrétní chyby a on analyzuje příslušné řádky, vysvětlí, co je špatně, a navrhne cílené úpravy. Návrh můžete použít přímo a znovu zkompilovat, abyste opravu potvrdili.

4. Korektura: Požádejte Prism o korekturu části textu a zvýraznění případných chyb nebo mezer v logice a také o návrhy, jak mohu zlepšit srozumitelnost této části. Můžete využít dovednosti, jako je Paper Review, pro redakční a faktickou zpětnou vazbu.

5. Vyhledávání literatury: Přidej do mé práce bibliografii, včetně návrhů souvisejících prací, které jsem možná přehlédl.

2. Diagnostika chyb kompilace

Pokud se váš dokument LaTeX nekompiluje, zkuste následující kroky:

1. Zkontrolujte indikátor chyby: Červené a žluté značky zvýrazňují místa, kde Prism zjistil problém. Kliknutím na značku zobrazíte podrobnosti a pak použijte vestavěného asistenta k diagnostice chyby.

2. Projděte protokol kompilace: Když kompilace selže, panel náhledu PDF zobrazí protokol kompilace. Zaměřte se na první chybovou zprávu (například chybějící \end{document}), protože pozdější chyby jsou často kaskádové důsledky. Sdílejte tuto zprávu s Prism pro přesnější doporučení.

3. Vraťte poslední změny: Pokud se chyba objevila po nedávné úpravě, vraťte ji zpět nebo ji dočasně zakomentujte a zjistěte, zda kompilace proběhne úspěšně.

4. Zjednodušte dokument na minimální příklad: Pokud problémy přetrvávají, zjednodušte dokument jen na nezbytný obsah. Odstranění nesouvisejících částí pomůže izolovat zdroj chyby.

3. Osvědčené postupy, jak se vyhnout problémům

1. Zůstaňte přihlášeni: Vždy pracujte po přihlášení, aby se vaše změny ukládaly a byly dostupné napříč relacemi.

2. Používejte podporované balíčky: Prism podporuje mnoho běžně používaných balíčků LaTeX. Vzácné, zastaralé nebo neudržované balíčky mohou způsobovat neočekávané chyby kompilace.

3. Upravujte postupně: Provádějte malé změny a kompilujte často. Díky tomu snadněji určíte, která úprava zavedla chybu, a rychle se zotavíte.

Přesun projektů LaTeX do Prism

Tato příručka vysvětluje, jak přesunout existující projekty LaTeX — buď z Overleaf, nebo z vašeho místního počítače — do Prism. Import vašich projektů udrží vše na jednom místě a umožní vám pokračovat v práci bez nutnosti ručně znovu vytvářet soubory.

Import projektů z Overleaf

Chcete-li přesunout projekt z Overleaf do Prism, nejprve si stáhněte soubory projektu z Overleaf a poté je nahrajte do Prism.

Stažení jednoho projektu

1. Otevřete svůj panel projektů Overleaf.

2. Najděte projekt, který chcete přenést.

3. Klikněte na ikonu stažení ve stejném řádku jako název projektu.

4. Overleaf stáhne celý projekt jako soubor .zip do vašeho počítače.

Stažení více projektů

1. Otevřete svůj seznam projektů Overleaf.

2. Vyberte projekty pomocí zaškrtávacího políčka na začátku každého řádku.

   

3. Chcete-li vybrat vše, klikněte na první zaškrtávací políčko v seznamu.

4. Po výběru klikněte na ikonu stažení v pravém horním rohu seznamu projektů.

   

Vybrané projekty se stáhnou jako soubory .zip.

Import projektů do Prism

Prism umí importovat projekty třemi způsoby: nahráním složky, nahráním archivu .zip nebo přetažením souborů do zobrazení All Projects.


Import projektu z nabídky Import:

1. Otevřete Prism a přejděte na Import.

2. Kliknutím na šipku vedle Import zvolte typ importu.

Vyberte jednu z následujících možností:

1. Otevřete Prism a přejděte k možnosti Import.

2. Kliknutím na šipku vedle Import zvolte typ importu.

3. Vyberte jednu z následujících možností:

Import souboru .zip: Vyberte stažený archiv projektu ze svého počítače. Prism projekt automaticky rozbalí a načte.

Import složky: Vyberte složku projektu ze svého počítače. Prism naimportuje vaše soubory .tex, bibliografické soubory, obrázky a další zdroje projektu.

Import přetažením: V zobrazení All Projects přetáhněte do Prism složku projektu nebo soubor .zip. Prism pro vás automaticky vytvoří nový projekt a soubory naimportuje.

Po dokončení nahrávání Prism otevře celý projekt, takže můžete začít upravovat a kompilovat.

Další časté dotazy

Účet, zabezpečení a fakturace

Q: Kde najdu vaše zásady ochrany soukromí?
A: Zásady ochrany soukromí pro Prism najdete zde.

Q: Trénujete na mých datech?
A: Uživatelé mají plnou kontrolu nad tím, zda se jejich data používají ke zlepšování našich modelů, v souladu s našimi zásadami ochrany soukromí.

Q: Používáte „nulové uchovávání dat“ (ZDR)? Jaké probíhá logování/uchovávání?
A: Prism v současnosti nepoužívá možnost API „nulové uchovávání dat“ (ZDR) a po požadavcích po určitou dobu uchovává logy za účelem zlepšování produktu.


Q: Nabízíte režim soukromí, ve kterém se neukládá žádný text ani ho nekontrolují lidé, a/nebo datovou rezidenci pouze v EU?
A: Jde o požadované funkce; jsou v plánu/backlogu, ale zatím pro ně není stanoven závazný termín.

Sdílení a spolupráce

Q: Proč nemůžu sdílet odkaz „kdokoli může upravovat“? (Rozbalovací nabídka umožňuje jen „kdokoli může zobrazit“.)
A: To je v současnosti záměr. Sdílení pomocí odkazu s možností „kdokoli může upravovat“ zatím není podporováno; editory je nutné přidat jako spolupracovníky (s účtem Prism).

Q: Spolupracovníkům nechodí e-maily s pozvánkou — jak mohou získat přístup k projektu?
A: Požádejte je, ať zkontrolují složku spam/nevyžádaná pošta, a ať se přihlásí pomocí pozvané e-mailové adresy; sdílený projekt by se jim měl po prvním přihlášení zobrazit.

Import a export projektu

Q: Nahrávání/import ZIPu se zasekl na „importing your project“. Co mám dělat?
A: Zkuste nahrání zopakovat. Pokud se to bude zasekávat i po opakování, sdílejte soubor ZIP s podporou, aby bylo možné cestu importu odladit.

Q: Jak exportuji/stáhnu svůj projekt jako ZIP?
A: Klikněte na název projektu a pak zvolte Export, čímž stáhnete komprimovanou kopii projektu. Než bude možné exportovat, může trvat několik sekund, než se naváže backendové připojení.

Spolehlivost, výpadky a připojení

Q: Moje projekty po obnovení zmizely. Jsou ztracené?
A: Obnovte stránku znovu a zkontrolujte seznam projektů; vaše data by se měla znovu objevit.

Q: Moje projekty po obnovení stránky zmizely. Jsou ztracené?
A: To se může stát během výpadku na straně poskytovatele. Zkuste to znovu; vaše projekty by se měly znovu objevit. Pokud ne, podpora vám může pomoci je obnovit.

Q: Zdá se, že je web offline / aplikace hlásí, že se nemůže připojit k backendu. Co mám dělat?
A: Zkuste to znovu / obnovte stránku. Pokud problém přetrvává, pošlete podpoře podrobnosti o tom, co vidíte (a pokud možno i odkaz na projekt), aby bylo možné problém prošetřit.

Integrita dat, obnova, zálohy a historie verzí

Q: Můj dokument se zasekl, pak obsah zmizel a kotvy komentářů se posunuly. Můžu ho obnovit?
A: Začněte stažením zálohy .zip. Prism také obsahuje historii verzí, která vám může umožnit obnovit starší verzi. Pozice kotev komentářů nemusí být vždy obnovitelné a komentáře se v současnosti do záloh neexportují. Pokud se změnilo formátování, zkuste ho opravit pomocí formátovače kódu.

Q: Znovu jsem otevřel projekt a soubory/obsah se vrátily ke starší verzi nebo zmizely — co se stalo?
A: Bylo období, kdy ukládání projektů záviselo na externím poskytovateli, který při nárůstu používání nestíhal. Ukládání bylo přesunuto do interního systému, aby se omezily chyby připojení a zabránilo jejich opakování, a byla přidána další ochranná opatření.

Q: Lze obnovit pozice komentářů a jsou komentáře součástí záloh projektu?
A: Pozice komentářů nemusí být zpětně obnovitelné. Pro obnovu při budoucích incidentech nyní existují pravidelné zálohy (např. každých ~10 minut), ale komentáře se v současnosti do záloh ZIP neexportují.

Integrace

Zotero

Q: Proč nemůžu do Prism importovat skupinové knihovny Zotero?
A: Skupinové knihovny Zotero zatím nejsou podporovány; jednotlivé knihovny fungují, ale skupinové knihovny momentálně podporovány nejsou.

Q: Moje integrace se Zotero se zasekla (např. po změně účtů nebo API klíčů). Jak to lze opravit?
A: Podpora bude potřebovat vaše číselné ID Zotero (ne vaše uživatelské jméno), aby odpojila integraci od předchozího/anonymního uživatele; poté ji budete moci znovu propojit se svým účtem. Příklad postupu: https://www.youtube.com/watch?v=7vDiZ8o_eHk

Git

Q: Mohu klonovat projekt Prism přes Git (GitHub/GitLab) nebo ho udržovat synchronizovaný s Git platformou své instituce?
A: Integrace s Git zatím není k dispozici, ale jde o připravovaný vývojový projekt s vysokou prioritou.

Sestavení LaTeXu a řešení problémů

Q: Jak vynutím čisté nové sestavení (vymazání Aux/toc/bbl artefaktů)?
A: Obnovte stránku. Obnovení stránky vynutí nové čisté sestavení.

Q: Obrázky/image se v Prism nenačítají, ale stejný LaTeX jinde funguje.
A: Používejte cesty relativní k souboru .tex, který import provádí. Pokud je soubor .tex v podsložce a obrázek je v kořeni projektu, přidejte před cestu ../.

Q: Kompilace je extrémně pomalá nebo nikdy neskončí. Jak určím příčinu?
A: Zakomentovávejte jednotlivé sekce (a potom menší části uvnitř nich), dokud kompilace neproběhne úspěšně, a pak zúžte problém na přesný řádek, který potíže způsobuje. Projděte také varování a chyby v protokolech, začněte od první.

Q: Ve vygenerovaném .bbl dostávám varování „Underfull/Overfull \hbox“. Je to chyba kompilace?
A: Ne, jde o sazební varování, nikoli fatální chyby kompilace. Pokud výstupní PDF vypadá přijatelně, lze toto varování obvykle ignorovat.

Q: Proč v Beameru prostředí lstlisting/listings uvnitř frame vyvolávají chybu (např. „Extra }, or forgotten \endgroup“)?
A: Při použití prostředí listing označte frame v Beameru jako [fragile]; často to tyto chyby vyřeší.

Q: Moje citace \cite se zobrazují jako „[?]“, i když soubor .bib existuje a příkazy pro bibliografii jsou přítomné. Jaké nastavení funguje?
Jedním z úspěšných řešení je zajistit, aby bibliografie byla správně zahrnuta z hlavního dokumentu; pro workflow ve stylu BibTeX použijte \bibliographystyle{plain} a \bibliography{refs} (kde refs.bib je váš soubor).

Uživatelské rozhraní produktu a požadavky na funkce

Q: Nabízí Prism světlý režim?
A: Ano. Prism podporuje tři nastavení vzhledu: Systém, Světlý a Tmavý. Můžete si vybrat motiv, který vám vyhovuje nejlépe.