Qapha Imikhawulo Yomsizi Wokubhala Ikhodi ku-macOS nge-Codenotch

Yini i-Codenotch?

I-Codenotch iwuhlelo lwe-macOS olufaka i-notch emnyama encane kunoma yiluphi uhlangothi lwesikrini. Izindandatho zayo zibonisa ukuthi kungakanani komkhawulo wokusetshenziswa womsizi ngamunye wokubhala ikhodi osekelwayo osekusetshenzisiwe, kanye nokuthi iseshini iyasebenza, iphelile, noma ilinde okokufaka.

I-notch ihlala iyipilisi encane ngesikhathi ingasebenzi futhi iyakhula lapho isikhombisi sifika kuyo. Ukukhomba phezu kwendandatho yomhlinzeki kubonisa izikhathi zemikhawulo yayo nezikhathi zokusetha kabusha. Ku-Claude Code, indandatho eyinhloko imele iwindi elifanayo le-seshi yokusetshenziswa yamanje eliboniswa kuqala umyalo we-Claude Code othi /usage.

I-Codenotch iphinde iqaphe umsebenzi wamasession. I-arc encane ijikeleza ngaphakathi kwendandatho yomhlinzeki ngesikhathi iseshini isebenza. Uma iseshini idinga ukunakwa kwakho, indandatho ishintsha ibe yisimo esiphuzi esikhanya ngokuphindaphindiwe. Ukukhomba kuyo kubonisa amagama amasession abukhoma, lapho asebenza khona, nokuthi adingani.

Abahlinzeki abasekelwayo nemithombo yedatha

I-Codenotch ayigcini uhlelo lwe-akhawunti oluhlukile futhi ayikuceli ukuthi ungene ngemvume. Ifunda iziqinisekiso noma amasession asevele egcinwe amathuluzi asekelwayo ku-Mac yakho.

• Claude Code: Isebenzisa ithokheni ye-OAuth egcinwe ku-keychain yokungena ngemvume futhi ibuza i-endpoint efanayo esetshenziswa umyalo we-Claude Code othi /usage.
• Cursor: Ifunda iseshini umhleli angene ngayo ngemvume ku-state yayo yendawo ye-SQLite.
• Codex: Icela iseva yohlelo lokusebenza ye-Codex esebenzayo imikhawulo yamanje yezinga. Uma i-Codex ingasebenzi, i-Codenotch ibuyela ku-log yayo yama-rollout.
• Antigravity: Iqala izame iseva yolimi yendawo bese izama i-quota endpoint yakwa-Google. Uma kungekho okunye okunikeza idatha ye-quota ye-akhawunti, ibonisa isibalo sezicelo esilula.
• GLM: Ibiza i-endpoint yokuqapha ye-Coding Plan yakwa-Z.ai isebenzisa ukhiye osuvele uphethwe i-Claude Code ku-settings.json, i-ZCode, noma i-OpenCode.

Faka ithuluzi elisekelwayo bese ungena ngemvume kulo ngendlela evamile. Lapho i-Codenotch ithola iseshini noma isiqinisekiso salo sendawo, kuvela indandatho ehambisanayo. Ukukhubaza umhlinzeki kokuthi Settings kumisa i-Codenotch ekufundeni leso siqinisekiso futhi kususe okufundwe okugcinwe, ngaphandle kokukukhipha emathuluzini okuqala.

Izici ezibalulekile

• Izindandatho zokusetshenziswa ze-Claude Code, Cursor, Codex, Antigravity, ne-GLM.
• Imininingwane yamawindi okusetha kabusha etholakala ngokukhomba phezu kwendandatho.
• Izimo ezibukhoma zokusebenza nokulinda zamasession okubhala ikhodi.
• Ukutholwa okuzenzakalelayo kokulungiselelwa okuningi kwe-Claude Code.
• Ukubekwa ohlangothini oluphezulu, olungezansi, lwesobunxele, noma lwesokudla lwesikrini.
• Izakhiwo ezivumelana nendawo esetshenziswayo yesikrini, indawo ye-Dock, kanye ne-notch yehadiwe.
• Isithonjana se-Dock ozikhethela sona, isithonjana sebha yemenyu, noma kungabikho.
• Ukuhlolwa kwansuku zonke kwezibuyekezo zangemuva nge-Sparkle.
• Izimo ezibonakalayo ze-stale, needsAuth, ne-error esikhundleni samaphesenti alinganisiwe.

Yakha futhi usebenzise i-Codenotch

Izidingo zangaphambili

Le phrojekthi iwuhlelo lwe-macOS olwenziwe nge-XcodeGen. Faka i-XcodeGen kanye nge-Homebrew:

brew install xcodegen

Kusuka ekhophi yendawo ye-repository, yenza iphrojekthi, uyakhe, bese uqalisa i-build ye-Debug:

make run

Akudingeki i-signing identity ku-build ye-Debug.

Qalisa izivivinyo

Sebenzisa i-test target yephrojekthi ukuze uqinisekise ama-adapter abahlinzeki nokunye ukuziphatha:

make test

Ukwakheka kwezimpendulo zabahlinzeki kuqinisekiswa yizivivinyo ngoba ama-endpoint angaphakathi, izizindalwazi zendawo, nezixhumanisi ze-RPC kungashintsha ngaphandle kwesaziso.

Sebenzisa idatha yedemo

Uma ufuna ukuhlola isixhumi esibonakalayo ngaphandle kokufunda idatha ebukhoma yabahlinzeki, qalisa uhlelo nge-CODENOTCH_DEMO=1:

CODENOTCH_DEMO=1 make run

Imodi yedemo inikeza idatha yesampula engaguquki futhi ilusizo ekuthuthukiseni isixhumi esibonakalayo, ekuhloleni izakhiwo, nasekuthatheni izithombe-skrini.

make release akuyona ingxenye yokusethwa kwendawo okujwayelekile. Idinga isitifiketi se-Developer ID kanye nephrofayela ye-App Store Connect notary, futhi isetshenziswa umgcini wephrojekthi ukuze agcine, aqinisekise, futhi akhiqize i-feed ebhalwe yesibuyekezo esizenzakalelayo.

Ukusetshenziswa okuyisisekelo

1. Ngena ngemvume ngethuluzi lomhlinzeki uqobo

Vula ithuluzi lokubhala ikhodi ofuna ukuliqapha bese ungena ngemvume kulo. I-Codenotch ayilokothi yenze ukungena ngemvume uqobo. Isibonelo, qinisekisa nge-Claude Code noma i-Cursor ngendlela evamile, bese uqalisa i-Codenotch.

2. Hlola izindandatho zabahlinzeki

Umhlinzeki ngamunye otholakele uvela njengendandatho ku-notch. Sebenzisa indandatho ukuze uqonde ukuthi kungakanani komkhawulo otholakalayo osekusetshenzisiwe. Khomba kuyo ukuze uhlole amawindi emikhawulo atholakalayo nezikhathi zawo zokusetha kabusha.

3. Bheka isimo seseshini

Ngesikhathi iseshini esekelwayo isebenza, bheka i-arc encane ejikelezayo ngaphakathi kwendandatho yayo. Indandatho ephuzi ekhanya ngokuphindaphindiwe isho ukuthi iseshini ivinjiwe futhi ikulindile. Khomba kuyo ukuze ubone igama leseshini, indawo, nesenzo esiceliwe.

4. Lungiselela i-notch

Vula i-Settings nge-orb engaphansi kwe-notch. Ivela njenge-arc lapho iphumule futhi iba igiya lapho ukhomba kuyo. I-Settings ingalawula ukuthi i-notch ivuleke yini lapho ukhomba kuyo, ihlale ibonakala, noma ifihlwe ngokuphelele.

Ungakhetha futhi ukuthi i-Codenotch ibonise isithonjana se-Dock, isithonjana sebha yemenyu, noma kungabikho.

5. Khetha uhlangothi lwesikrini

Beka i-notch kunoma yiluphi uhlangothi kwezine:

• Kwesesobunxele noma kwesokudla: Ukufundwa kwabahlinzeki kuvela kukholamu eqondile.
• Eliphezulu noma elingezansi: Ukufundwa kwabahlinzeki kuvela kuhambisana.

I-Codenotch ilandela uhlangothi olusebenzisekayo lwesikrini. Ukubekwa ngezansi kuhlala ngaphezu kwe-Dock futhi kuyasabela lapho i-Dock ifihla noma inyakaza. Ku-Mac enenotch yehadiwe, ukubekwa phezulu kusebenzisa umumo wayo oqondile ukuze i-notch ephathekayo neyesofthiwe kubonakale kuyinto eyodwa.

Qapha ama-akhawunti amaningi e-Claude Code

ICodenotch ingabonisa amasongo ahlukene ezinkomba zokucushwa ezihlukene ze-Claude Code. Isibonelo, qalisa i-akhawunti yomsebenzi ngale ndlela:

CLAUDE_CONFIG_DIR=~/.claude-work claude

Ngemva kokuba i-Claude Code isisebenzise leyo nkomba, i-Codenotch iyayithola bese ibonisa iringi ethi Claude (work) eduze kwe-akhawunti yomuntu siqu. I-akhawunti yomsebenzi ithola imikhawulo, izikhathi, nomugqa wayo we-Settings.

Lapho iqaliswa, i-Codenotch isesha izinkomba ezihambisana ne-~/.claude-<slug> ezisetshenziswe yi-Claude Code. I-akhawunti ezenzakalelayo engu-~/.claude ihlala ibekwa kuqala, kanti okunye ukucushwa kuhlelwa ngokulandelana kwezinhlamvu ukuze izindawo zamasongo zingashintshi ngokungalindelekile.

Indlela yokuvuselela nemikhawulo yezinga

ICodenotch ilungisa ukuvota ukuze inciphise izicelo ezingadingekile. Uma kungekho seshini egadiwe esebenzayo, ukuvota kwehliselwa ekubeni kanye ngemizuzu emihlanu. Ukuze ucele ukufundwa okusha ngesandla, chofoza kwesokudla ku-notch bese ukhetha Refresh now.

I-endpoint ye-Claude ingabuyisa i-HTTP 429 uma ibuzwa kaningi kakhulu. I-Codenotch isebenzisa ukubambezeleka okwandayo okuqala ngemizuzwana engu-60, kuphindwe kabili ngemva kwezimpendulo ezilandelanayo zomkhawulo wezinga, futhi kugcine emizuzwini engu-15. Umnqamulajuqu uyagcinwa noma uhlelo seluqalisiwe kabusha, okuvimbela ukuqala kabusha ekusebenziseni elinye ithuba ngokushesha.

Izibuyekezo nokuphepha

ICodenotch isebenzisa i-Sparkle ukuhlola izibuyekezo nsuku zonke nokuzifaka ngemuva. Izibuyekezo ezizenzakalelayo zingacishwa ku-Settings. Izibuyekezo ezisemthethweni zisayinwe nge-EdDSA ukuze uhlelo lungafaki i-build engakhiqizwanga futhi ingasayinwanga umnakekeli.

Kubahlinzeki abasebenzisa i-keychain, uhlelo olusemthethweni lusebenzisa ubunikazi obuzinzile be-Developer ID ukuze imvume ye-Always Allow enikezwa kanye ikwazi ukuqhubeka isebenza ngemva kokwakhiwa kabusha. I-Codenotch ihlola usuku lokuguqulwa lwento ye-keychain ngaphambi kokufunda imfihlo futhi, inciphisa izicelo zokufinyelela eziphindaphindwayo ngesikhathi sokuvota okuvamile.

Amanothi okuthuthukisa athuthukile

Isakhiwo sabahlinzeki

Ukuhlanganiswa ngakunye kusebenzisa i-UsageProvider ngaphansi kwe-Sources/Providers/. Umhlinzeki uphinde amemezele inani le-Fidelity elingu-.official, .derived, noma .manual. Lokhu kuvimbela isixhumi esibonakalayo ekwethuleni inani eliqageliwe sengathi lishicilelwe ngokuqondile ngumthengisi.

I-UsageStore, etholakala ngaphansi kwe-Sources/Model/, ivota abahlinzeki ngesibali-sikhathi futhi igcine ukufundwa kokugcina okuphumelele phakathi kokuqaliswa kabusha. Uma umhlinzeki ehluleka, isitolo siveza isimo esibonakalayo esifana ne-stale, needsAuth, noma error esikhundleni sokwenza iphesenti.

Ukuhlelwa emaphethelweni esikrini

Ukuhlelwa kwe-notch kusebenza esikhaleni sesitaki esinobukhulu obubodwa kusetshenziswa izixhumanisi ze-along ne-across. I-NotchPlacement ihlela lawo manani abe izixhumanisi zangempela zesikrini somphetho okhethiwe. I-NotchLayout ihlanganisa izilinganiso ezisetshenziswa ukuqhathanisa ukuqaliswa nohlaka lomklamo.

Hlola izingodo zokuxilonga

Ngenxa yokuthi i-Codenotch ayinalo iwindi lohlelo lokusebenza elivamile, ulwazi lokuxilonga lubhalwa ku-unified log ye-macOS. Sakaza imilayezo yokulungisa amaphutha ngale ndlela:

/usr/bin/log stream --predicate 'subsystem == "com.vinz.codenotch"' --level debug

Leli yithuluzi eliyinhloko lokuxazulula izinkinga lapho umhlinzeki engakwazi ukuqinisekisa ubuwena, ebuyisa idatha endala, noma ehlangabezana nefomethi yempendulo eshintshile.

Qonda imikhawulo

Akekho umthengisi osekelwayo oshicilela i-API elula nezinzile ebika yonke indawo iseshini yokubhala ikhodi njengephesenti elinembile lokusetshenziswa. Ngakho-ke i-Codenotch ifunda imithombo yangaphakathi noma yasendaweni efanayo esetshenziswa izinhlelo eziphethe, okuhlanganisa ama-endpoint, imininingwane egciniwe, amaseva olimi, nezingodo.

Lezo zixhumi zingashintsha ngaphandle kwesaziso. I-Codenotch ibhekana naleyo ngozi ngokuhlolwa kwama-adapter nezimo zokwehluleka ezicacile, kodwa ukuhlanganiswa komhlinzeki kungase kusayeke ukusebenza okwesikhashana ngemva kokuba uhlelo lwayo oluyisisekelo lushintshile.

Isiphetho

ICodenotch iletha ukusetshenziswa kwabasizi bokubhala ikhodi, amawindi okusetha kabusha, nesimo seseshini esebenzayo esibukweni esincane esisemaphethelweni e-macOS. Qala nge-make run, sebenzisa imodi yedemo ukuhlola isixhumi esibonakalayo ngokuphephile, bese uvumela uhlelo luthole ama-akhawunti asevele elungiselelwe kumathuluzi asekelwayo. Ngemininingwane yokuthuthukisa nokunikela, bheka i-CONTRIBUTING.md. Iphrojekthi itholakala ngaphansi kwe-MIT License.