Sisukord

Veaotsing

Levinud probleemid

11 min lugemist
Levinud probleemid

Lahendused sageli esinevatele probleemidele.

Paigaldamine

"Cannot be opened because Apple cannot check it"

Ritemarki Maci-versioon on allkirjastatud arendaja sertifikaadiga (Developer ID) ja Apple on selle notariseerinud (alates versioonist 1.7.2), nii et ametlikult väljalasete lehelt alla laaditud failiga seda hoiatust ei tohiks tulla. Kui tuleb, on allalaadimine tõenäoliselt pooleli jäänud või pärit mujalt. Kustuta see ja laadi DMG uuesti alla.

Rakendus ei avane üldse (macOS)

  1. Kontrolli, et laadisid alla oma Macile sobiva versiooni: Apple Siliconiga Macile Ritemark-arm64.dmg, Inteli protsessoriga Macile Ritemark-x64.dmg. Apple'i menüü → About This Mac näitab Apple Siliconiga Macis rida Chip ja Inteli Macis rida Processor
  2. Kontrolli macOS-i versiooni. Ritemark vajab macOS 12 Monterey või uuemat versiooni
  3. Proovi DMG uuesti alla laadida
  4. Liiguta Ritemark enne avamist Applications kausta

Windows SmartScreen blokeerib paigaldaja

Windows võib GitHubist alla laaditud Ritemark-Setup.exe käivitamisel näidata "Windows protected your PC" hoiatust. See on normaalne. Kui paigaldad Ritemarki Microsoft Store'ist, seda hoiatust ei tule. Vaata meie Windows SmartScreeni juhendit sammhaaval juhiste jaoks.

Kui Smart App Control või sinu organisatsiooni poliitika paigaldaja blokeerib, jäta Smart App Control sisse ja paigalda Ritemark hoopis Microsoft Store'ist või küsi administraatorilt heakskiidetud paigaldusviisi.

Ritemarki eemaldamine

Macis sulge Ritemark ja lohista Ritemark kaustast Applications prügikasti. Windowsis ava Settings → Apps (eestikeelses Windowsis Sätted → Rakendused), leia Ritemark ja vali Uninstall.

Eemaldamine jätab sinu dokumendid alles, sest need on tavalised failid sinu kaustades. Alles jäävad ka Ritemarki seaded, juhuks kui paigaldad selle uuesti. Kui tahad eemaldada ka seaded ja alla laaditud mudelid, kustuta Macis kaustad ~/Library/Application Support/Ritemark ja ~/.ritemark või Windowsis %APPDATA%\Ritemark ja %USERPROFILE%\.ritemark.

Redaktor

Tühi redaktor / Midagi ei kuvata

Redaktori webview ei laadunud. Proovi:

  1. Reload Window: Cmd+Shift+P -> "Reload Window"
  2. Taaskäivita Ritemark: Sulge ja ava uuesti
  3. Kontrolli failitüüpi: Ainult .md failid avanevad WYSIWYG režiimis

Muudatused ei salvesta

Ritemark salvestab automaatselt 1 sekundi pärast. Kui muudatused ei salvesta:

  1. Kontrolli faili õigusi (kas saad sellesse kausta kirjutada?)
  2. Vaata veateadete olekuriba all
  3. Proovi käsitsi salvestada: Cmd+S

Vormindus näeb vale välja

  1. Laadi aken uuesti: Cmd+Shift+P -> "Reload Window"
  2. Kontrolli, kas fail on kehtiv markdown
  3. Keerukas HTML markdownis ei pruugi korrektselt kuvada

Teksti valimise probleemid

  1. Klõpsa väljapool redaktorit, siis tagasi sisse
  2. Laadi aken uuesti, kui probleem püsib

Markdown avaneb lihttekstina või ilmub Restricted Mode'i riba

Parandatud versioonis 1.8.6. Mõnel värskel paigaldusel küsiti .md failil topeltklõpsu tegemisel, kas usaldad selle kausta failide autoreid, ja fail avanes vormindatud redaktori asemel lihtteksti koodivaates koos Restricted Mode'i ribaga akna ülaservas.

Uuenda versioonile 1.8.6. Topeltklõpsuga avatud markdown-fail avaneb otse Ritemarki redaktoris, ilma usaldusdialoogi ja ribata, ning juba mõjutatud profiil parandab end ise esimesel käivitusel pärast uuendust.

Pildid ei ilmu redaktoris

Parandatud versioonis 1.12.0. Pilt, mille tee oli kirjutatud lihtsa suhtelise teena, näiteks ![diagram](img/diagram.png), või mis asus väljaspool dokumendi enda kausta, näiteks ../images/plan.jpg või projekti ülemisel tasemel ühises kaustas images/, jäi tühjaks või katkiseks. Nüüd näitavad dokumendid kõiki pilte, mis asuvad sinu avatud kausta sees. Kui lisad aknasse kausta ajal, mil mõni dokument on juba avatud, ava see dokument uuesti.

Kui salvestad dokumendi, milles on ../images/… pilt, ei kirjuta Ritemark enam faili pildi tee asemele sisemist vscode-resource aadressi. Algne tee jääb alles, nii et pilt töötab ka teistes rakendustes.

Läbikriipsutus kaob salvestamisel

Parandatud versioonis 1.12.0. Läbikriipsutatud tekst kaotas salvestamisel joone, nii et ~~done~~ tuli tagasi tavalise tekstina done. Nüüd kirjutatakse läbikriipsutus faili. Tavalised tildemärgid, näiteks ~/Downloads või ~5 min, salvestatakse täpselt nii, nagu need kirjutasid.

Aastaarv rea alguses muutub numberloendiks

Parandatud versioonis 1.12.0. Kui kirjutasid lõigu algusesse 2026. , muutus lõik numberloendiks, mis algas numbriga 2026. Numbrid kuni 99 alustavad loendit endiselt, alates 100-st jääb tekst lauseks. Loendi saab siiski alustada mis tahes numbrist tööriistaribalt või kaldkriipsu menüüst.

Shift+End valib kogu ülejäänud dokumendi

Parandatud versioonis 1.12.0. Shift+End valis kõik kursorist faili lõpuni, nii et järgmine klahvivajutus võis märkamatult kustutada allpool olevaid lõike. Nüüd valivad Shift+End ja Shift+Home teksti selle rea lõpuni ja alguseni, kus kursor asub.

AI assistent

"AI Offline" olekuribal

Ritemark ei saa internetiga ühendust, aga AI külgpaneel vajab seda. Kontrolli:

  1. Internetiühendus - Kas oled võrgus?
  2. Check again - Klõpsa seda külgpaneeli võrguühenduse teates, et ühendust uuesti kontrollida

AI-lt vastust pole

  1. Oota kauem - mõned päringud võtavad aega
  2. Kontrolli veateateid AI külgpaneelil
  3. Proovi lihtsamat päringut
  4. Kontrolli, kas agent on sisse logitud: Seaded -> Claude Account või ChatGPT Account peaks näitama ühendust. OpenCode'i puhul kontrolli, et teenusepakkuja võti on seadetes salvestatud

"Invalid API key" viga

  1. Ava Seaded ja leia selle teenusepakkuja võtmeväli (OpenAI, Google AI, Anthropic või OpenRouter)
  2. Kleebi kehtiv võti uuesti
  3. Veendu, et ei kopeerinud lisatühikuid

AI muudab vale teksti

  1. Vali tekst kõigepealt enne päringu tegemist
  2. Kontrolli valiku indikaatorit AI külgpaneelil
  3. Ole konkreetne selle suhtes, mida soovid muuta

Claude Code ei tööta Windowsis

Ritemarki varasemates versioonides esines Windowsis binaartuvastuse probleeme, kus .cmd/.exe shim-e ei lahendatud korrektselt, põhjustades "spawn EINVAL" vigu AI vestluses. See on parandatud versioonis 1.5.0. Uuenda Ritemarki ja kontrolli Seaded -> Claude'i konto, et veenduda Claude Code'i ühendatuses.

Codex ei tööta Windowsis

Sama binaartuvastuse parandus versioonis 1.5.0 kehtib ka Codexi kohta. Uuenda Ritemarki ja kontrolli Seaded -> ChatGPT konto ühenduse olekut.

"spawn EINVAL" viga AI vestluses

See viga esines Windowsis enne versiooni 1.5.0 vale .cmd ja cli.js teisenduse tõttu. Lahenduseks on Ritemarki uuendamine versioonile 1.5.0 või uuemale. Pärast uuendamist peaksid AI agendid ühenduma ilma vigadeta.

"Some agent features are unavailable" hoiatus

Mõned versioonid enne 1.7.0 näitasid hoiatust "Some agent features are unavailable", kuna Codexi ühilduvuskontroll proovis ainult ühte argv-kuju. Uuenda versioonile 1.7.0 või uuemale -- kontroll proovib nüüd mõlemat kuju ja vale hoiatus on kadunud.

Soovid kasutada süsteemi paigaldatud Claude'i või Codexi

Alates versioonist 1.7.0 saad Seaded -> Agent Runtime all seadega Runtime preference valida Bundled (vaikimisi) ja Use system install vahel. Viimane eelistab süsteemi PATH-il olevat Claude'i või Codexit ja kasutab selle puudumisel kaasasolevat koopiat. Jaotises Currently active näitavad seaded, millist koopiat kumbki agent kasutab. Windowsis küsib Ritemark Git for Windowsi või Node.js-i ainult valiku Use system install korral, sest kaasasolevad Claude Code ja Codex ei vaja kumbagi.

Ritemark peatub käivitamisel mõneks sekundiks

Parandatud versioonis 1.12.0. Varem kontrollis Ritemark enne Claude'i ja Codexit ning alles seejärel hakkasid AI külgpaneel ja redaktorid reageerima. Ise paigaldatud Codexi puhul kestis paus umbes kolm sekundit. Nüüd käivad kontrollid taustal.

Offline-riba vilgub sisse ja välja

Parandatud versioonis 1.8.6. Varasemad versioonid lugesid rakenduse võrguühenduseta juba ühe ebaõnnestunud kontrolli järel, nii et üks tõrge korras ühenduse peal pani riba vilkuma. Ühenduse kontroll võistleb nüüd mitme sõltumatu lõpp-punkti vahel, iga vastus loeb võrgus olemiseks ja riba ilmub alles kahe järjestikuse ebaõnnestunud vooru järel. Taastumine on kohene.

Failiviide AI vestluses ei tee midagi

Parandatud versioonis 1.8.6. Kui agent viitab failile su avatud kaustas, on see viide link ja sellel klõpsamine avab faili Ritemarkis. Kujul README.md:12 kirjutatud reaviited töötavad samuti.

Alates versioonist 1.12.0 teeb iga vastuses olev link midagi või ütleb, miks mitte. Väljaspool projekti olevat faili ei avata, vaid näidatakse Finderis (Windowsis File Exploreris). Puuduva faili puhul näidatakse selle teed. Link, mida Ritemark vestlusest ei ava, näiteks mailto:, ütleb seda ja pakub nuppu Copy link. Vaata lingid vestluses.

Agent muutis faile ajal, mil ta pidi plaani tegema

Alates versioonist 1.8.6 see enam võimalik ei ole. Plaanirežiimi jõustab käituskeskkond, mitte mudelile antud juhis, nii et plaani tegeval agendil puudub kirjutamisõigus täielikult. Ülevaatuskaardi rida No files changed yet on faktiväide. Vaata Plaanirežiim.

Kui nägid seda vanemas versioonis, uuenda. Plaani kinnitamine annab töö üle täpselt selle autonoomiaga, mille valisid, Manual või Auto, ilma vaikse laiendamiseta.

Ajastatud agendid hakkasid tööle ilma küsimata

Parandatud versioonis 1.8.6. Kaust, mis määratleb ajastatud AI agente, küsib nüüd enne käivitamist ühe korra ja vastust saab Agentide kogus millal tahes muuta. Kaustad, kus ajastamine oli juba enne uuendust kasutusel, töötavad edasi nagu varem.

Report AI issue ei ava e-kirja

Olekuriba nupp Report AI issue annab teate üle sinu arvuti e-posti rakendusele. Ritemark ise seda ei saada. Teatamisaken ütleb, mis juhtus, ja sinu teade jääb sinna alati alles:

  • Kui aken ütleb Your email app is opening, leia oma e-posti rakendusest uus kiri, vaata see üle ja vajuta seal saatmisnuppu. Teade ei lähe teele enne, kui seda teed.
  • Kui aken ütleb No email app is set up on this computer, klõpsa tekstikasti all Copy report ja saada teade aadressile info@productory.eu e-postiga, mida tavaliselt kasutad. Arvutis, kus e-posti rakendust pole, on see tavaline olukord, mitte viga.
  • Kui aken ütleb This report is too long to open in an email app, klõpsa Copy report ja saada teade ise aadressile info@productory.eu. Nii ei lõigata midagi ära, sest e-posti lingiga saab edasi anda ainult piiratud hulga teksti.

Kui aken ütleb, et e-posti rakendus avaneb, aga midagi ei ilmu, kasuta samamoodi nuppu Copy report. Aadress on tekstikasti all alati näha kujul Write to us: info@productory.eu, nii et võid ka otse kirjutada. Vaata AI väljundist teatamine.

Eksport

PDF eksport ebaõnnestub

  1. Kontrolli, et sul on kirjutamisõigus salvestuskohta
  2. Proovi kõigepealt töölauale salvestada
  3. Veendu, et dokument pole rikutud

Wordi ekspordil on vale vormindus

  1. Keerukad tabelid võivad vajada käsitsi korrigeerimist
  2. Mõned markdowni funktsioonid ei tõlgu ideaalselt
  3. Kaalu PDF-eksporti järjepideva vorminduse saamiseks

Ekspordi nupp pole nähtav

Eksport töötab ainult markdown-failide jaoks. CSV ja Exceli failid kasutavad erinevaid tööriistu.

Google Docsis avaldamine ebaõnnestub

Ritemark ütleb, miks Google Docsi dokumenti ei saa luua või sünkroonida, ja pakub lahendust: ühenda Google'i konto uuesti, taasta dokument Drive'i prügikastist või eemalda avaldamislink ja loo uus dokument. Ebaõnnestunud sünkroonimine ei muuda kunagi sinu Markdown-faili. Vaata Kui midagi läheb valesti.

Failid

CSV fail kuvatakse tekstina

  1. Veendu, et faili laiend on .csv
  2. Sulge ja ava fail uuesti
  3. Kontrolli, kas fail pole rikutud

Exceli fail ei avane

  1. Kontrolli, et laiend on .xlsx või .xls
  2. Fail võib olla rikutud - proovi avada Excelis
  3. Väga suured failid ei pruugi laaduda

Suure faili hoiatus

Failid üle 5MB või 10 000 rea võivad:

  • Võtta kauem laadida
  • Olla kärbitud (CSV näitab esimest 10K rida)
  • Põhjustada jõudlusprobleeme

Väga suurte andmete jaoks kasuta spetsiaalset tabelarvutusrakendust.

Wordi-, PowerPointi- või PDF-faili eelvaade ei avane

Eelvaade ütleb põhjuse ja pakub faili avamiseks muud võimalust. Wordi dokumendi või esitluse eelvaadet ei saa näidata, kui fail on üle 50 MB, parooliga kaitstud, vanas .doc- või .ppt-vormingus uue nime all või rikutud. Vaata Kui faili ei saa eelvaates näidata.

Versioonihaldus

"Source control depends on Git being installed"

Versioonihaldus (Source Control) kasutab Giti, eraldi programmi, mis Ritemarkiga kaasas ei ole. Kui Git pole paigaldatud, ütleb Source Controli vaade:

Source control depends on Git being installed. After installing Git, please reload (or troubleshoot).

Tervituslehel on sama teade: Ritemark needs Git. Install Git to use Source Control. Ritemark ei lingi Giti allalaadimisele, vaid ütleb ainult, et Git puudub.

  1. Paigalda Git ise, näiteks lehelt git-scm.com
  2. Klõpsa Ritemarkis Source Controli teates reload või käivita Reload Window (Cmd+Shift+P, Windowsis Ctrl+Shift+P)
  3. Kui Source Control ütleb endiselt, et Git puudub, klõpsa troubleshoot, et näha Giti logi

Giti on vaja ainult versioonihalduseks. Ritemarkiga kaasas olevad AI agendid ei vaja Giti ega Node.js-i ning alates versioonist 1.12.0 mainib tervitusleht Node.js-i ainult Windowsis, kui Runtime preference on seatud väärtusele Use system install.

Jõudlus

Aeglane tippimine / viivitus

  1. Sulge teised ressursimahukad rakendused
  2. Laadi aken uuesti: Cmd+Shift+P -> "Reload Window"
  3. Väga pikad dokumendid võivad olla aeglasemad

Kõrge mälukasutus

  1. Sulge kasutamata failid
  2. Taaskäivita Ritemark
  3. See on teadaolev probleem, mida parandatakse

Uuendused

Uuenduskeskuse kasutamine

Alates versioonist 1.5.0 sisaldab Ritemark seadetes Uuenduskeskust. Saad kontrollida saadaolevaid uuendusi, paigaldada neid otse peatamise ja jätkamise toega, jätta vahele versioone, mida sa ei soovi, ning näha komponentide valmisoleku kaarte, mis näitavad, mida iga uuendus sisaldab. See on soovitatav viis Ritemarki ajakohasena hoidmiseks.

Finder näitab vale versiooninumbrit

Parandatud versioonis 1.8.6. Finder näitas rakenduse paketti varem kujul "Ritemark.app (1.117.0)", mis on kesta versioon, mitte Ritemarki oma. Pakett kannab nüüd õiget versiooni, nii et Finder, Get Info ja About-paneel näitavad sama numbrit.

Kuidas käsitsi uuendada

Kui eelistad käsitsi uuendamist või Uuenduskeskus pole saadaval (versioonid enne 1.5.0), saad endiselt alla laadida viimase väljalase GitHub väljalasete lehelt. macOS-is ava DMG ja lohista Ritemark Applications kausta, asendades olemasoleva versiooni. Windowsis käivita uus Ritemark-Setup.exe paigaldaja.

Ikka veel hätta jäänud?

Saa abi

Teata probleemist

Kui leidsid vea:

  1. Märgi üles, mida tegid
  2. Märgi üles kõik veateated
  3. Kontrolli, kas see on korratav
  4. Teata GitHub Issues lehel

Kiirparandused

Probleem Kiirparandus
Redaktor tühi Cmd+Shift+P -> Reload Window
AI ei tööta Kontrolli internetiühendust, siis sisselogimist või API-võtmeid seadetes
Rakendus ei avane (macOS) Kustuta allalaaditud fail ja laadi DMG väljalasete lehelt uuesti alla
SmartScreeni hoiatus (Windows) Paigalda Microsoft Store'ist või klõpsa More info -> Run anyway
Pildid on redaktoris tühjad Uuenda versioonile 1.12.0; kui lisasid aknasse kausta, ava dokument uuesti
Source Control ütleb, et Git puudub Paigalda Git ja klõpsa reload
Report AI issue ei ava e-kirja Copy report ja saada teade aadressile info@productory.eu
Fail ei salvesta Kontrolli kausta õigusi
Aeglane jõudlus Taaskäivita Ritemark
AI agendid ei tööta (Windows) Uuenda versioonile 1.5.0, kontrolli Seaded -> Kontosektsioonid
Markdown avaneb lihttekstina / Restricted Mode Uuenda versioonile 1.8.6, käivita üks kord uuesti
Offline-riba vilgub Uuenda versioonile 1.8.6
Ajastatud agendid käivitusid ilma küsimata Uuenda versioonile 1.8.6, halda neid Agentide kogus
Tagasi tugikeskusesse