Isifundo se-EasyRead: Humusha, funda ngokuqhathanisa futhi wenze amanothi emaphepheni esayensi e-PDF esiNgisi endaweni yangakini

Iyini i-EasyRead

I-EasyRead iyithuluzi lendawo lokufunda amaphepha esayensi abhalwe ngesiNgisi. Ingangenisa ama-PDF, ikhiqize ukuhumusha kwesiShayina ikhasi nekhasi ngemuva, futhi izame ukugcina amafomula, amathebula, izinkomba kanye nesakhiwo sephepha lokuqala. Amakhasi asehumushiwe angafundwa ngokushesha, kanti amanye amakhasi abonisa okwangempela okwesikhashana, ngakho akudingeki ulinde kuqedwe ukucutshungulwa kwephepha lonke.

Ngokungafani nokunikeza ithuluzi elijwayelekile lokuhumusha yonke i-PDF ngesikhathi esisodwa, i-EasyRead ifana nendawo yokusebenza ephelele yokufunda amaphepha: umbhalo oyinhloko ubonisa ukuhumusha okuthembekile, kanti izincazelo nezimpendulo ze-AI zibekwa eceleni kwekhasi ukuze kube lula ukuhlukanisa incazelo yoqobo yephepha kokuqukethwe okwengezwe imodeli. Isevisi ilalela kuphela kule khompyutha, futhi amaphepha, ukuhumusha, amanothi namarekhodi ezingxoxo kugcinwa kukhompyutha yakho.

Imisebenzi esemqoka

Ukuhlelwa kwesiShayina okulungele ukufunda isikhathi eside

I-EasyRead isebenzisa ukuhlelwa kombhalo oyinhloko wesiShayina, iphinde ihlele amafomula nge-KaTeX, icubungule amathebula abe amathebula anemigqa emithathu, futhi igcine umbhalo wokuqala wezinkomba. Isixhumi esibonakalayo sisekela imodi emnyama, elungele ukufunda izinto ezinde zemfundo ngokulandelana.

Qinisekisa umbhalo wokuqala wesiNgisi noma nini

Ngesikhathi ufunda ungashintshela kwimodi yokuqhathanisa, ukuze isiShayina ngasinye silandelwe isiNgisi ngaphansi kwaso. Ungavula nekhasi lokuqala le-PDF ngakwesokudla; ikhasi lizoshintsha lihambisane nendawo oyifundayo, futhi ligqamise indawo yesigaba samanje ekhasini lokuqala, okwenza kube lula ukuhlola amafomula, amagama obuchwepheshe nomongo.

Imibuzo nezimpendulo ze-AI kanye nezingcaphuno eziningi

Iphaneli ethi “Buza i-AI” ngakwesokudla isekela izingxoxo ezisakazwa ngesikhathi sangempela. Ungadonsa ingxenye eyodwa noma eziningi zombhalo uzifake ebhokisini lokufaka bese ubuza, noma ucele imodeli ihlaziye okuqukethwe ngokusekelwe emigqeni edwetshwe ngombala othile. I-EasyRead ivumela ukudala izingxoxo eziningi, futhi ikuvumela ukhethe ngokwehlukana imodeli ye-Claude, GPT, DeepSeek, Tongyi noma i-Ollama yasendaweni engxoxweni ngayinye. Izimpendulo ezifanele ukugcinwa zingabekwa eduze kwesigaba esihlobene ngokuchofoza kanye.

Ukugqamisa, amanothi nokulungisa ukuhumusha

• Ngemva kokukhetha umbhalo, sebenzisa umaka we-fluorescent onemibala emine noma udwebele ngaphansi.
• Engeza inothi noma ubuze umbuzo ngokuqukethwe okukhethiwe.
• Vumela i-AI iphendule imibuzo noma ibeke amazwana enothini oselubhaliwe.
• Qoqa amanothi ngokulandelana kombhalo wokuqala, bese ukhetha okuqukethwe okuthile ukuze ukuthumele njenge-Markdown.
• Chofoza kabili isigaba ukuze ulungise ukuhumusha ngokuqondile.
• Lungisa ukuhunyushwa kwamatemu kusichazamazwi samatemu bese ukufaka esikhundleni kuwo wonke umbhalo.

Ukuze kugwenywe ukulahleka kwedatha, ukulungiswa ngakunye kugcinwa kuqala esipheqululini, futhi amarekhodi esikhashana asuswa kuphela ngemva kokuba isevisi yasendaweni iqinisekise ukuthi kubhalwe efayelini. Uma imiphumela yokuhumusha elandelayo iphikisana nokulungiswa okwenziwe ngesandla, i-EasyRead izokwazisa ngoshintsho esikhundleni sokubhala ngokuqondile phezu kokuqukethwe kwakho.

Umtapo wezincwadi nenqubekelaphambili yokufunda

Umtapo wezincwadi usekela ukuhlukanisa ngezigaba, ukuphina phezulu, ukusesha, ukumaka ngenkanyezi, kanye nezimo zokungafundiwe, okufundwayo nokufundiwe. Amaphepha angadonselwa ezigabeni ozakhele zona, kanti ngemva kokusulwa aqala aye emgqonyeni kadoti. Ungakopisha futhi izingcaphuno ze-GB/T 7714, APA noma i-BibTeX, bese ubheka inqubekelaphambili yokufunda yephepha ngalinye.

Khetha imodeli yokuhumusha

Ngesikhathi usebenzisa okokuqala, vula kuqala “Izilungiselelo” phezulu kwesokudla bese ukhetha injini yokuhumusha. I-EasyRead isekela lezi zinketho ezilandelayo:

• Claude Code: Inketho enconywe yi-README. Kufanele uqale ufake bese ungena ku-Claude Code; akudingeki ufake i-API Key eyengeziwe, ungasebenzisa isabelo sokubhalisa, futhi ungabuka isithombe sekhasi lokuqala ukuze uhlole amafomula.
• Codex CLI: Ngemva kokufaka nokungena ku-Codex, ungawusebenzisa nge-akhawunti ye-ChatGPT ngaphandle kokufaka i-API Key eyengeziwe.
• API yasekhaya: Isekela i-DeepSeek, Zhipu, Alibaba Cloud Bailian, Kimi, SiliconFlow ne-Magic Mirror; kudingeka i-API Key yesikhulumi esihambisanayo.
• API yaphesheya: Isekela i-OpenAI, Anthropic, Gemini, OpenRouter, Groq ne-Cerebras; kudingeka i-API Key, futhi izimo zenethiwekhi zincike kumhlinzeki wesevisi.
• Imodeli yasendaweni: Ingaxhuma ku-Ollama noma ku-LM Studio ukuze isebenze ngokuphelele ngaphandle kwe-inthanethi. I-README incoma ukusebenzisa qwen3.5:9b; uma imemori yevidiyo incane, ungazama inguqulo engu-4b.
• Isixhumi esibonakalayo esenziwe ngokwezifiso: Ungafaka noma yiliphi ikheli elihambisana ne-OpenAI kanye ne-Key, futhi isekela amafomethi e-Chat Completions ne-Responses.

Ngemva kokulungiselela, chofoza “Humusha umusho wokuhlola” ukuze uhlole ukuthi imodeli iyasebenza yini. Ikhasi lezilungiselelo lizophinde lihlole ngokuzenzakalelayo amathuluzi ahlobene asevele efakiwe kule khompyutha. Uma ungafuni ukuhumusha ngokushesha ngemva kokungenisa, vala “Qala ukuhumusha ngokuzenzakalelayo ngemva kokungenisa”; kamuva ungacubungula ngesandla noma uvumele i-agent engxoxweni yenze ukuhumusha.

Faka i-EasyRead

Indlela yokuqala: Sebenzisa iphakheji yokufaka yedeskithophu

Le yindlela elula kakhulu futhi ayidingi ukufaka i-Python. Vakashela EasyRead Releases ukuze ulande ifayela elifanele isistimu yakho.

• Windows: Landa EasyRead-Setup-x.x.x.exe bese uchofoza kabili ukuze uyifake. Uma kuvela “I-Windows ivikele ikhompuyutha yakho”, khetha “Olunye ulwazi”, bese uchofoza “Qalisa noma kunjalo”.
• macOS: Kumadivayisi ane-Apple chip, landa EasyRead-x.x.x-arm64.dmg, bese uhudulela uhlelo ku-“Applications”. Uma ekuvuleni kokuqala kuvela isaziso sokuthi umthuthukisi akaqinisekiswanga, iya ku-“System Settings → Privacy & Security” bese ukhetha “Open Anyway”.
• Linux: Landa EasyRead-x.x.x.AppImage, unikeze imvume yokusebenza, bese uyayiqalisa.

chmod +x EasyRead-x.x.x.AppImage
./EasyRead-x.x.x.AppImage

Idatha yenguqulo efakiwe itholakala kufolda ye-EasyRead kuhla lwemibhalo lomsebenzisi wesistimu. Ukukhipha noma ukufaka kabusha uhlelo ngeke kususe ngokuzenzakalelayo la maphepha nezilungiselelo.

Indlela yesibili: Qalisa usuka kukhodi yomthombo

Indlela yekhodi yomthombo idinga i-Python 3.10 noma inguqulo ephezulu. Ungalanda ingobo yomlando yekhodi yomthombo yakamuva uyivule, noma u-clone i-repository.

git clone https://github.com/Edwardxlai/easyread.git
cd easyread

Abasebenzisi be-Windows bangachofoza kabili start.cmd. Ekuqaliseni kokuqala imvelo izofakwa ngokuzenzakalelayo, bese ngokuchofoza kabili futhi uhlelo luvuleka. Abasebenzisi be-macOS noma be-Linux baqhuba lokhu kufolda yephrojekthi:

./start.sh

Uma uqalisa ngeskripthi, ngemva kokuvala wonke amakhasi e-EasyRead esipheqululini, isevisi yangemuva ngokuvamile iyaphuma ngemva kwemizuzwana eyishumi nambili. Uma kusenomsebenzi wokuhumusha oqhubekayo, isevisi izolinda kuze kuqedwe umsebenzi.

Indlela yesithathu: Sebenzisa i-pip

Ungafaka ngokuqondile iphakheji ye-Python ku-GitHub:

pip install git+https://github.com/Edwardxlai/easyread
easyread

Ngemva kokuqalisa, isiphequluli sizovula http://127.0.0.1:8765. Isevisi ilalela kuphela ekhelini lendawo, futhi idatha yenguqulo efakwe nge-pip igcinwa ngokuzenzakalelayo ku-~/EasyRead.

Ukungenisa nokuhumusha iphepha okokuqala

1. Vula “Izilungiselelo” phezulu kwesokudla, bese ukhetha futhi ulungiselele injini yokuhumusha.
2. Sebenzisa “Humusha umusho wokuhlola” ukuze uqinisekise ukuthi i-akhawunti, i-API Key noma uxhumano lwemodeli yasendaweni lusebenza kahle.
3. Hudulela i-PDF efasiteleni, noma unamathisele inombolo ye-arXiv, isihloko sephepha, i-DOI, isixhumanisi esiqondile se-PDF noma isixhumanisi sekhasi lephepha esisekelwayo.
4. Kumaphepha amade, ungakhetha “Humusha umbhalo oyinhloko kuphela”, noma usebenzise “Cacisa amakhasi” ukuze ukhawulele ububanzi bokuhumusha.
5. Linda ukucutshungulwa kwekhasi nekhasi ngemuva. Okuqediwe kuzovela ngokushesha ngesiShayina, kanti amakhasi angakahunyushwa azoqhubeka nokubonisa i-PDF yokuqala.

Ngaphandle kwe-arXiv, i-EasyRead ingazama ukuthola ama-PDF omphakathi kwa-OpenReview, ACL, NeurIPS, bioRxiv, PMC nasemakhasini amajenali, iphinde igcwalise ababhali, unyaka nomthombo. Ikhasi lomtapo wezincwadi lisekela nokunamathisela izinombolo noma izixhumanisi ngokuqondile nge-Ctrl+V.

Inqubo eyisisekelo yokufunda nokubhala amanothi

1. Vula iphepha elingenisiwe, uqale ukufunda emakhasini aqediwe ukuhumusha.
2. Uma udinga ukuhlola incazelo yokuqala, shintshela kwimodi yokuqhathanisa, noma uvule ikhasi le-PDF yokuqala ngakwesokudla.
3. Chofoza isigaba ukuze ubonise ibha yezenzo; ngemva kokukhetha umbhalo, engeza ukugqamisa, ukudwebela noma inothi.
4. Hudulela izigaba ezibalulekile ebhokisini lokufaka elithi “Buza i-AI”, bese ucela imodeli ichaze umqondo, iqhathanise izindlela noma ihlele ubudlelwano phakathi kwamafomula.
5. Gcina izimpendulo eziwusizo eduze kwesigaba esihambisanayo.
6. Kwisifinyezo samanothi, khetha okuqukethwe okudingekayo, ukuthumele njenge-Markdown, bese ukufaka ku-Obsidian noma ku-Notion.

Cindezela ? ukuze ubuke zonke izinqamuleli; izinqamuleli zingenziwa ngokwezifiso. Uma uthola ukuthi ukuhumusha akulungile, chofoza kabili isigaba ukuze usilungise; uma kuyitemu eliphindaphindwayo, lungisa kuqala kusichazamazwi samatemu ukuze kulungiswe yonke indawo.

Ukusingatha ukwehluleka kokuhumusha

Amanye amakhasi angahluleka ngenxa yokulinganiselwa kwezicelo, inethiwekhi noma isabelo. I-EasyRead izozama futhi ngokuzenzakalelayo; uma kusahluleka, izokweqa lelo khasi iqhubeke nokuhumusha amakhasi alandelayo. Ngemva kokuqedwa kokucubungula, ungabuka isizathu sokwehluleka nenombolo yekhasi endaweni ethi “Ukuhumusha” ngakwesokudla kwephepha, bese uchofoza “Zama futhi amakhasi ahlulekile”.

“Amarekhodi okuhumusha” abonisa imininingwane yeqoqo lomsebenzi ngamunye, kanti “Amarekhodi okuqalisa” ngaphansi kwezilungiselelo asetshenziselwa ukuhlola isevisi yasendaweni. Uma isabelo se-Claude Code sesiphelile, linda size sivuselelwe bese uzama futhi, noma ushintshele okwesikhashana ku-API noma ku-Ollama; amakhasi asehumushiwe ngeke aphinde ahunyushwe ngenxa yalokho.

Ukusebenzisa umugqa wemiyalo nama-agent e-AI

I-EasyRead iza nesixhumi somugqa wemiyalo. Ama-agent afana ne-Claude Code ne-Codex angafunda imibuzo namanothi emtatsheni wamaphepha, abhale izimpendulo eceleni kwezigaba ezihlobene, futhi ahumushe noma ahumushe kabusha amakhasi athile. Incazelo yamakhono itholakala ku-skill/paper-reading/SKILL.md ku-repository; ungafaka lolo hlu lwemibhalo ku-~/.claude/skills/ noma ku-~/.codex/skills/.

easyread list
easyread import 论文.pdf
easyread status ID
easyread discuss ID --from 回答.json
easyread export ID

• easyread list: Bhala uhlu lomtapo wamaphepha wasendaweni.
• easyread import: Ngenisa i-PDF, inombolo ye-arXiv noma isixhumanisi sephepha.
• easyread status ID: Buka inqubekelaphambili, ukuhumusha okulungiswe ngesandla, amanothi nemibuzo elindele izimpendulo.
• easyread discuss ID --from 回答.json: Bhala imiphumela yengxoxo eceleni kwekhasi lephepha.
• easyread export ID: Thumela i-HTML engaxhunyiwe ku-inthanethi eyifayela elilodwa.

Ukuze ubone eminye imiyalo, sebenzisa easyread --help.

Amaqhinga athuthukile

Thumela iphepha elingaxhunyiwe ku-inthanethi elabelwanayo

Emtatsheni wamaphepha, chofoza kwesokudla iphepha bese ukhetha “Thumela i-HTML engaxhunyiwe ku-inthanethi” ukuze uthole ikhasi eliyifayela elilodwa elingavulwa ngokuqondile esipheqululini. Ukuhumusha, amafomula, izithombe zamakhasi okuqala, imigqa egqanyisiwe namanothi kuzofakwa efayeleni, futhi omunye umuntu akadingi ukufaka i-EasyRead.

Imigqa egqanyisiwe namanothi amasha angezwe ekhasini elingaxhunyiwe ku-inthanethi agcinwa kuphela esipheqululini esivule lelo khasi. Ukuwahlanganisa abuyele emtatsheni omkhulu wamaphepha, thumela i-JSON yezinguquko engxenyeni ethi “Incazelo” yekhasi elingaxhunyiwe ku-inthanethi, bese usebenzisa:

easyread merge ID --from 导出.json

Uma ufuna ukushicilela iphepha kumawebhusayithi afana ne-GitHub Pages, ungakhiqiza uhla lwemibhalo lokubonisa oluhlukanise izithombe futhi luzilayishe lapho kudingeka:

easyread demo ID --out 目录

Yenza ikhophi eyisipele futhi uvumelanise idatha

Uma uhlelo lusebenza ngendlela yekhodi yomthombo, idatha iku-library/ kufolda yephrojekthi; ngemva kokufakwa nge-pip, iku-~/EasyRead/library/. Iphepha ngalinye linefolda yalo ezimele, equkethe i-PDF yokuqala, izithombe zamakhasi okuqala, ukuhumusha, amanothi, izingxoxo ze-AI namafayela e-JSON amarekhodi ezingxoxo. Izilungiselelo nezintandokazi zesixhumi esibonakalayo zigcinwa ngokwehlukana ku-config.json naku-prefs.json; la mafayela angagcinwa njengesipele noma avumelaniswe ngokuqondile.

Lawula izindleko futhi ushintshe amamodeli

EasyRead izorekhoda ama-token asetshenziswa ekuhumusheni ngakunye nakuyo yonke impendulo ye-AI. Uma usebenzisa okubhaliselwe kwe-Claude, ungabuka nokusetshenziswa kwemikhawulo yamahora angu-5 nezinsuku ezingu-7 kanye nesikhathi sokusethwa kabusha. Ekusetshenzisweni kwangempela, ungasebenzisa imodeli yekhwalithi ephezulu emaphepheni abalulekile, bese usebenzisa i-API ebiza kancane noma i-Ollama yasendaweni ezintweni ezijwayelekile.

Ukushintsha imodeli ngeke kuphinde kucutshungulwe amakhasi asevele ehunyushwe ngempumelelo. Ungagcina imiphumela ekhona kuqala, bese uphinda uzame kuphela amakhasi ahlulekile noma uhumushe kabusha mathupha izingxenye ezidinga ukuthuthukiswa.

Ukwakha Inguqulo Yedeskithophu Yabathuthukisi

Inguqulo yedeskithophu ye-Electron iphinde isebenzise isevisi efanayo yendawo ye-Python nesixhumi esibonakalayo seWebhu. Indawo yokuthuthukisa idinga i-Node.js 22 noma ngaphezulu, i-Python 3.10 noma ngaphezulu, kanye ne-PyInstaller.

npm install
python -m pip install pyinstaller
npm run dev

Ukuze ukhiqize iphakheji yokufaka engasatshalaliswa, sebenzisa:

npm run dist

Imiphumela yokwakha itholakala ku-dist/electron/; i-Windows ikhiqiza isifaki se-NSIS, i-macOS ikhiqiza i-DMG, kanti i-Linux ikhiqiza i-AppImage.

Isifinyezo

EasyRead ihlanganisa ukuhumusha amaphepha, ukuqinisekisa umbhalo wokuqala, imibuzo nezimpendulo ze-AI, ukuphawula nokuphathwa kwezincwadi zesayensi ekuhambeni komsebenzi okukodwa kwasendaweni. Indlela elula yokuqala ukulanda nokufaka iphakheji, ulungise imodeli esebenzayo, bese uhudulela i-PDF ukuze uqale ukufunda. Ngokusebenzisa uhlu lwamagama, umugqa womyalo, ukuthunyelwa ngaphandle kokuxhumeka ku-inthanethi kanye namamodeli asendaweni, ungakha iqoqo lakho lamaphepha elilinganisa ubumfihlo, izindleko nokusebenza kahle kokufunda.

Le phrojekthi isebenzisa ilayisensi ye-MIT. Vakashela indawo yokugcina ye-GitHub ukuze ubuke ikhodi yomthombo, noma uvule kuqala idemo eku-inthanethi ukuze uhlole indlela yokufunda.