Fuatilia Vikomo vya Msaidizi wa Usimbaji kwenye macOS ukitumia Codenotch

Codenotch ni nini?

Codenotch ni programu ya macOS inayobandika tundu dogo jeusi kwenye ukingo wowote wa skrini. Pete zake huonyesha kiasi cha kikomo cha matumizi cha kila msaidizi wa usimbaji unaotumika ambacho kimetumiwa, pamoja na ikiwa kipindi kinaendelea, kimekamilika, au kinasubiri ingizo.

Tundu hubaki kama kidonge kidogo wakati halitumiki na hupanuka kishale kinapolifikia. Kuelekeza kishale juu ya pete ya mtoa huduma huonyesha vipindi vyake vya kikomo na nyakati za kuweka upya. Kwa Claude Code, pete kuu inawakilisha dirisha lilelile la kipindi cha sasa linaloonyeshwa kwanza na amri ya Claude Code ya /usage.

Codenotch pia hufuatilia shughuli za vipindi. Mstari mwembamba wa duara huzunguka ndani ya pete ya mtoa huduma wakati kipindi kinaendelea. Kipindi kinapohitaji umakini wako, pete hubadilika kuwa hali ya manjano-kahawia inayopiga. Kuelekeza kishale juu yake huonyesha majina ya vipindi moja kwa moja, vinapoendeshwa, na vinachohitaji.

Watoa huduma wanaotumika na vyanzo vya data

Codenotch haiendeshi mfumo tofauti wa akaunti wala kukuomba uingie. Husoma vitambulisho au vipindi ambavyo tayari vimehifadhiwa na zana zinazotumika kwenye Mac yako.

• Claude Code: Hutumia tokeni ya OAuth iliyohifadhiwa kwenye keychain ya kuingia na kuuliza endpoint ileile inayotumiwa na amri ya Claude Code ya /usage.
• Cursor: Husoma kipindi cha kuingia cha kihariri kutoka kwenye hali yake ya ndani ya SQLite.
• Codex: Huuliza seva ya programu ya Codex inayoendesha kuhusu viwango vya sasa vya kikomo. Codex isipokuwa inaendesha, Codenotch hutumia kumbukumbu yake ya rollout.
• Antigravity: Kwanza hujaribu seva ya ndani ya lugha, kisha endpoint ya mgao ya Google. Wakati hakuna kati ya hizo inayotoa data ya mgao kwa akaunti, huonyesha idadi ya maombi pekee.
• GLM: Huita endpoint ya ufuatiliaji wa Mpango wa Usimbaji wa Z.ai kwa kutumia ufunguo ambao tayari unashikiliwa na settings.json ya Claude Code, ZCode, au OpenCode.

Sakinisha na uingie kwenye zana inayotumika kama kawaida. Codenotch inapogundua kipindi au kitambulisho chake cha ndani, pete inayohusika huonekana. Kumzima mtoa huduma kwenye Mipangilio huizuia Codenotch kusoma kitambulisho hicho na huondoa usomaji uliohifadhiwa bila kukuondoa kwenye zana asili.

Vipengele muhimu

• Pete za matumizi za Claude Code, Cursor, Codex, Antigravity, na GLM.
• Maelezo ya vipindi vya kuweka upya yanapatikana kwa kuelekeza kishale juu ya pete.
• Hali za moja kwa moja za vipindi vinavyofanya kazi na vinavyosubiri.
• Ugunduzi wa kiotomatiki wa usanidi wengi wa Claude Code.
• Kuwekwa kwenye ukingo wa juu, chini, kushoto, au kulia wa skrini.
• Mipangilio inayobadilika kulingana na eneo linaloweza kutumika la skrini, nafasi ya Dock, na tundu la kifaa.
• Aikoni ya Dock, aikoni ya upau wa menyu, au hakuna kati ya hizo kwa hiari.
• Ukaguzi wa kila siku wa masasisho ya chinichini kupitia Sparkle.
• Hali zinazoonekana za stale, needsAuth, na error badala ya asilimia zilizokadiriwa.

Jenga na uendeshe Codenotch

Mahitaji ya awali

Mradi ni programu ya macOS iliyozalishwa kwa XcodeGen. Sakinisha XcodeGen mara moja kwa kutumia Homebrew:

brew install xcodegen

Kutoka kwenye nakala ya ndani ya hazina, zalisha mradi, ujenge, na uanzishe muundo wa Debug:

make run

Utambulisho wa kusaini hauhitajiki kwa muundo wa Debug.

Endesha majaribio

Tumia lengo la majaribio la mradi kuthibitisha adapta za watoa huduma na tabia nyingine:

make test

Miundo ya majibu ya watoa huduma inalindwa na majaribio kwa sababu endpoint za ndani, hifadhidata za ndani, na violesura vya RPC vinaweza kubadilika bila taarifa.

Tumia data ya onyesho

Ikiwa ungependa kukagua kiolesura bila kusoma data ya moja kwa moja ya watoa huduma, anzisha programu kwa CODENOTCH_DEMO=1:

CODENOTCH_DEMO=1 make run

Hali ya onyesho hutoa data thabiti ya mfano na ni muhimu kwa uundaji wa kiolesura, ukaguzi wa mpangilio, na picha za skrini.

make release si sehemu ya usanidi wa kawaida wa ndani. Inahitaji cheti cha Developer ID na wasifu wa uthibitishaji wa App Store Connect, na hutumiwa na msimamizi kuhifadhi, kuthibitisha, na kuzalisha mlisho uliotiwa saini wa masasisho ya kiotomatiki.

Matumizi ya msingi

1. Ingia kupitia zana yenyewe ya mtoa huduma

Fungua zana ya usimbaji unayotaka kufuatilia na uingie humo. Codenotch haifanyi mchakato wa kuingia yenyewe. Kwa mfano, thibitisha kupitia Claude Code au Cursor kama kawaida, kisha uanzishe Codenotch.

2. Kagua pete za watoa huduma

Kila mtoa huduma aliyegunduliwa huonekana kama pete kwenye tundu. Tumia pete kuelewa kiasi cha kikomo kinachopatikana ambacho kimetumiwa. Elekeza kishale juu yake ili kukagua vipindi vya kikomo vinavyopatikana na nyakati zake za kuweka upya.

3. Fuatilia hali ya kipindi

Kipindi kinachotumika kinapofanya kazi, tafuta mstari mwembamba unaozunguka ndani ya pete yake. Pete ya manjano-kahawia inayopiga inamaanisha kuwa kipindi kimekwama na kinakusubiri. Elekeza kishale juu yake ili kuona jina la kipindi, eneo, na hatua iliyoombwa.

4. Sanidi tundu

Fungua Mipangilio kupitia duara lililo chini ya tundu. Huonekana kama mstari wa duara wakati wa utulivu na hubadilika kuwa gia kishale kinapoelekezwa juu yake. Mipangilio inaweza kudhibiti ikiwa tundu litajifungua unapolielekezea kishale, litaendelea kuonekana, au litafichwa kabisa.

Pia unaweza kuchagua ikiwa Codenotch itaonyesha aikoni ya Dock, aikoni ya upau wa menyu, au hakuna kati ya hizo.

5. Chagua ukingo wa skrini

Weka tundu kwenye ukingo wowote kati ya minne:

• Kushoto au kulia: Usomaji wa watoa huduma huonekana kwenye safu wima.
• Juu au chini: Usomaji wa watoa huduma huonekana kwa upande mmoja.

Codenotch hufuata ukingo unaoweza kutumika wa skrini. Ikiwekwa chini, hukaa juu ya Dock na huitikia Dock inapojificha au kusogezwa. Kwenye Mac yenye tundu la kifaa, uwekaji wa juu hutumia umbo lake kamili ili tundu halisi na tundu la programu yaonekane kama kipengele kimoja.

Fuatilia akaunti nyingi za Claude Code

Codenotch inaweza kuonyesha pete tofauti kwa saraka tofauti za usanidi wa Claude Code. Kwa mfano, anzisha akaunti ya kazi kwa:

CLAUDE_CONFIG_DIR=~/.claude-work claude

Baada ya Claude Code kutumia saraka hiyo, Codenotch huitambua na kuonyesha pete ya Claude (work) karibu na akaunti ya kibinafsi. Akaunti ya kazi hupokea vikomo, vipindi, na safu yake ya Mipangilio.

Wakati wa kuanzishwa, Codenotch hutafuta saraka zinazolingana na ~/.claude-<slug> ambazo Claude Code imetumia. Akaunti chaguomsingi ya ~/.claude huwekwa ya kwanza kila wakati, na usanidi wa ziada hupangwa kwa alfabeti ili nafasi za pete zisibadilike bila kutarajiwa.

Tabia ya kuonyesha upya na vikomo vya maombi

Codenotch hurekebisha upigaji kura ili kupunguza maombi yasiyo ya lazima. Wakati hakuna kipindi kinachofuatiliwa kinachoendelea, upigaji kura hupungua hadi mara moja kila dakika tano. Ili kuomba usomaji mpya mwenyewe, bofya kulia kwenye notch kisha uchague Refresh now.

Kipengele cha Claude kinaweza kurudisha HTTP 429 kinapoulizwa mara kwa mara sana. Codenotch hutumia ucheleweshaji unaoongezeka unaoanza kwa sekunde 60, huongezeka mara mbili baada ya majibu mfululizo ya kikomo cha maombi, na hufikia upeo wa dakika 15. Mwisho wa muda huhifadhiwa kati ya uanzishaji, hivyo kuwasha upya hakutumi jaribio lingine mara moja.

Masasisho na usalama

Codenotch hutumia Sparkle kuangalia masasisho kila siku na kuyaweka kwa nyuma. Masasisho ya kiotomatiki yanaweza kuzimwa katika Mipangilio. Masasisho rasmi yametiwa saini kwa EdDSA ili programu isisakinishe toleo ambalo halikutengenezwa na kutiwa saini na msimamizi.

Kwa watoa huduma wanaotegemea keychain, programu rasmi hutumia utambulisho thabiti wa Developer ID ili idhini ya mara moja ya Always Allow iweze kudumu baada ya kujengwa upya. Codenotch hukagua tarehe ya marekebisho ya kipengee cha keychain kabla ya kusoma siri tena, hivyo kupunguza maombi ya ufikiaji yanayojirudia wakati wa upigaji kura wa kawaida.

Maelezo ya kina ya uundaji

Muundo wa watoa huduma

Kila muunganisho hutekeleza UsageProvider chini ya Sources/Providers/. Mtoa huduma pia hutangaza thamani ya Fidelity ya .official, .derived, au .manual. Hii huzuia kiolesura kuwasilisha thamani iliyokadiriwa kana kwamba ilichapishwa moja kwa moja na muuzaji.

UsageStore, iliyo chini ya Sources/Model/, huwapigia kura watoa huduma kwa kipima muda na huhifadhi usomaji wa mwisho uliofanikiwa kati ya uanzishaji. Mtoa huduma anaposhindwa, hifadhi huonyesha hali inayoonekana kama stale, needsAuth, au error badala ya kutengeneza asilimia.

Mpangilio wa ukingo wa skrini

Mpangilio wa notch hufanya kazi katika nafasi ya mrundiko wa mwelekeo mmoja kwa kutumia viwianishi vya along na across. NotchPlacement hupanga thamani hizo kuwa viwianishi halisi vya skrini kwa ukingo uliochaguliwa. NotchLayout huweka pamoja vipimo vinavyotumika kulinganisha utekelezaji na fremu ya muundo.

Kagua kumbukumbu za uchunguzi

Kwa kuwa Codenotch haina dirisha la kawaida la programu, taarifa za uchunguzi huandikwa kwenye kumbukumbu iliyounganishwa ya macOS. Tiririsha ujumbe wa utatuzi kwa:

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

Hiki ndicho chombo kikuu cha utatuzi mtoa huduma anaposhindwa kuthibitisha, anaporudisha data iliyopitwa na wakati, au anapokumbana na muundo wa jibu uliobadilika.

Elewa vikwazo

Hakuna muuzaji anayeungwa mkono anayechapisha API rahisi na thabiti ambayo kwa jumla huripoti kipindi cha uandishi wa msimbo kama asilimia sahihi iliyotumika. Kwa hiyo Codenotch husoma vyanzo vilevile vya ndani au vya kwenye kifaa vinavyotumiwa na programu husika, ikiwemo vipengele, hifadhidata, seva za lugha, na kumbukumbu.

Miunganisho hiyo inaweza kubadilika bila taarifa. Codenotch hushughulikia hatari hiyo kwa majaribio ya adapta na hali za wazi za hitilafu, lakini muunganisho wa mtoa huduma bado unaweza kusimama kwa muda baada ya programu yake ya chanzo kubadilika.

Hitimisho

Codenotch huleta matumizi ya wasaidizi wa uandishi wa msimbo, vipindi vya kuweka upya, na hali ya vipindi vinavyoendelea kwenye onyesho dogo la ukingo wa skrini ya macOS. Anza kwa make run, tumia hali ya onyesho kuchunguza kiolesura kwa usalama, kisha iruhusu programu itambue akaunti ambazo tayari zimesanidiwa katika zana zinazoungwa mkono. Kwa maelezo ya uundaji na uchangiaji, soma CONTRIBUTING.md. Mradi unapatikana chini ya Leseni ya MIT.