Mafunzo ya VibeClaude: Unganisha Matukio ya Claude Code na Vifaa vya Intiface

VibeClaude Hufanya Nini

VibeClaude ni programu-jalizi ya Claude Code inayotafsiri shughuli za uandishi wa msimbo kuwa mrejesho wa kifaa kupitia Intiface Central na buttplug.io. Matukio ya Claude Code hutumwa kwa daemon ya ndani, ambayo huwasiliana na Intiface Central kupitia WebSocket na kisha kudhibiti kifaa kilichooanishwa chenye uwezo wa kutetemeka.

Claude Code — hooks module — HTTP — daemon — WebSocket — Intiface Central — BLE — device

Programu-jalizi hujibu matokeo ya modeli yanayotiririshwa, miito ya zana, maombi ya ruhusa, todo zilizokamilika, subagents, ukatizaji, na matukio ya mzunguko wa zamu au kipindi. Imekusudiwa kutumiwa katika mazingira ya faragha na yenye starehe, na unapaswa kutumia maunzi yanayoendana kwa kuwajibika.

Mahitaji

• Claude Code yenye usaidizi wa programu-jalizi ya function-hooks. VibeClaude iliundwa kwa kutumia toleo la 2.1.291 la API hii ya ufikiaji wa mapema.
• Node.js 22 au mpya zaidi inayopatikana kama node kwenye PATH yako.
• Intiface Central yenye seva yake ya WebSocket inayoendesha. Anwani chaguomsingi ni ws://127.0.0.1:12345.
• Kidhibiti chenye uwezo wa kutetemeka kilichooanishwa katika Intiface Central.
• Mazingira ya faragha yanayofaa kutumia kifaa kilichounganishwa.

Sakinisha VibeClaude

Clone hazina kwenye saraka yako ya usanidi wa Claude na usakinishe vitegemezi vyake:

git clone https://github.com/transkatgirl/vibeclaude.git ~/.claude/vibeclaude
cd ~/.claude/vibeclaude && npm install

Unaweza kupakia programu-jalizi kwa kipindi kimoja cha Claude Code kwa:

claude --plugin-dir ~/.claude/vibeclaude

Vinginevyo, isakinishe kabisa kutoka ndani ya Claude Code:

/plugin marketplace add ~/.claude/vibeclaude
/plugin install vibeclaude@vibeclaude-local

Anzisha upya Claude Code baada ya usakinishaji. Programu-jalizi hupakiwa kipindi kipya kinapoanza.

Hakikisha Mahali pa Vitegemezi

Daemon huendeshwa kutoka kwenye saraka ambayo Claude Code hutumia kupakia programu-jalizi na inahitaji saraka ya node_modules iwepo hapo. Programu-jalizi zilizosakinishwa kupitia marketplace zinaweza kunakiliwa hadi mahali pasipo na vitegemezi vilivyosakinishwa kwenye clone yako ya awali.

Iwapo Claude Code itaonyesha ujumbe kwamba kifurushi cha npm cha buttplug hakipo, endesha npm install kwenye saraka iliyotajwa kwenye ujumbe huo.

Unganisha Kifaa

1. Anzisha Intiface Central na ubonyeze kitufe chake cha kuanzisha seva.
2. Katika Claude Code, endesha /intiface.
3. Subiri muunganisho na uchanganuzi ukamilike.
4. Chagua kifaa chenye uwezo wa kutetemeka kutoka kwenye matokeo.
5. Anza kutumia Claude Code baada ya kuthibitisha kwamba kifaa kimeunganishwa na kinafaa kwa mazingira yako.

Amri ya /intiface hufungua kidirisha kinachoonyesha hali ya muunganisho na uchanganuzi. Tumia vitufe vya mishale au Tab kusogea kwenye vifaa, bonyeza Enter au bofya ili kuchagua kimoja, na bonyeza Escape kuondoka kwenye kidirisha.

Hakuna kitu kinachotumwa kwenye kifaa hadi uchague kimoja. VibeClaude hudhibiti kifaa kimoja tu kilichochaguliwa kwa wakati mmoja. Kipindi cha baadaye cha Claude Code kinapoanza, programu-jalizi hujaribu kuunganishwa tena na Intiface Central na kurejesha kifaa kilichochaguliwa awali ikiwa kinapatikana.

Amri za Programu-jalizi

• /intiface: Unganisha kwenye Intiface, changanua vifaa, na uchague kifaa.
• /intiface-connect: Unganisha kwenye seva ya Intiface iliyosanidiwa na urejeshe kifaa kilichochaguliwa awali kinapopatikana.
• /intiface-disconnect: Tenganisha na usimamishe matokeo yote ya kifaa.
• /intiface-intensity [0.0-1.0]: Weka kizidishi cha jumla cha nguvu, au ripoti thamani ya sasa wakati hakuna nambari iliyotolewa.

Amri hizi huendeshwa ndani ya programu-jalizi bila kuanzisha zamu ya modeli au kutumia tokeni. Pia haziachi matokeo ya amri kwenye mazungumzo na zinaweza kutumiwa wakati zamu inaendelea.

Elewa Miundo ya Mrejesho

VibeClaude huwakilisha kila tukio kama muundo wa muda uliowekwa wenye nguvu isiyobadilika. Ndani ya mazungumzo moja, tukio la hivi karibuni zaidi hubadilisha lililotangulia. Kizidishi cha jumla cha nguvu hutumika baada ya tukio kuchaguliwa.

• Kufikiri na maandishi yanayotiririshwa: Mpigo wa milisekunde 70 kwa kila kipande, wenye nguvu kutoka 0.35 hadi 0.8 kulingana na kasi ya wastani ya matokeo. Hesabu ya kasi ya jibu hufikia kikomo cha herufi 40 kwa sekunde.
• Majibu kamili: Mpigo wa milisekunde 150 wenye nguvu ya 0.4 wakati jibu linapowasili bila kutiririshwa.
• Miito ya zana: Mpigo wa milisekunde 120 wenye nguvu ya 0.5 wakati modeli inapoanza kuandika mwito wa zana.
• Shughuli za kuhariri: Mshiko thabiti wenye nguvu ya 0.3 wakati shughuli ya Edit, Write, MultiEdit, au NotebookEdit ikiandikwa na kutekelezwa.
• Miito ya zana iliyofaulu: Mpigo wa milisekunde 180 wenye nguvu ya 0.7.
• Miito ya zana iliyoshindwa, kunyimwa, au kukataliwa: Mpigo wa milisekunde 280 wenye nguvu ya 1.0.
• Vipengee vya todo vilivyokamilika: Mpigo wenye nguvu ya 0.8, unaobadilishwa mara moja na muundo wa mafanikio ya zana.
• Maombi ya ruhusa: Mipigo mitatu ya milisekunde 90 yenye nguvu ya 0.85, ikifuatiwa na kusitisha na kurudiwa hadi ombi litatuliwe.
• Kukamilika kwa zamu: Mipigo mitatu ya milisekunde 100 yenye nguvu ya 1.0.
• Zamu zilizokatizwa au kushindwa: Matokeo ya sasa husimama, yakifuatiwa na mipigo mitatu inayotumika kukamilisha zamu.
• Mwisho wa kipindi: Matokeo yote husimama.

Kipindi Nyingi na Subagents

Kila kipindi kilichofunguliwa cha Claude Code hufuatilia zana, maombi, todo, na subagents zake. Miundo kadhaa inapokuwa hai, muundo wenye nguvu zaidi hutumika. Muundo huo unapoisha, kifaa kinaweza kurudi kwenye muundo hai kutoka kipindi kingine.

Subagents huchanganywa na mazungumzo yaliyozianzisha. Matokeo yao yanayotiririshwa, miito ya zana, vidokezo vya ruhusa, todo zao, na matukio ya kukamilika au kushindwa huwakilishwa kwa kujitegemea. Kumaliza kipindi kikuu husimamisha subagents zake zote.

Rekebisha Kiwango

Tumia amri ya intensity kupunguza au kuzima matokeo:

/intiface-intensity 0.5

Kizidishi chaguo-msingi ni 1.0. Thamani ya 0 huzima mrejesho, huku thamani kati ya 0 na 1 zikibadilisha kwa kiwango kila muundo unaotumika. Mabadiliko huanza kutumika mara moja, ikiwemo kwa muundo ambao tayari unachezwa, na hubaki yamehifadhiwa hadi yabadilishwe.

Vikomo Muhimu vya Matukio

Baadhi ya tabia ni za kukadiria kwa sababu ya taarifa ambazo Claude Code hufichua kwa programu-jalizi:

• Kufikiri: Kufikiri huwakilishwa tu pale Claude Code inapofanya maandishi yaonekane. Kwa mfano, kufikiri hakupatikani wakati wa uendeshaji wa claude -p usio na kiolesura.
• Majibu ya ruhusa: Claude Code hairipoti muda kamili ambapo kidokezo cha ruhusa kinajibiwa. Muundo wa kidokezo kwa kawaida huisha zana inayohusiana inapomaliza, inaposhindwa, au inapokataliwa. Vidokezo vingine vya terminal vinavyoendeshwa chinichini vinaweza kuusimamisha mapema.
• Matokeo ya zana: Programu-jalizi haipokei matokeo ya amri yanapotiririshwa, hivyo matokeo ya zana huwakilishwa na jibu la zana badala ya kila mstari unaochapishwa.

Sanidi Programu-jalizi

Claude Code huuliza chaguo za programu-jalizi unapoiwezesha. Unaweza kuzibadilisha baadaye kupitia /plugin na kiolesura cha usimamizi wa programu-jalizi.

• wsAddress: Anwani ya Intiface Central ya WebSocket. Chaguo-msingi yake ni ws://127.0.0.1:12345.

Anwani iliyobadilishwa ya WebSocket huanza kutumika daemon inapoanza tena. Maliza vipindi vyako, au simamisha daemon moja kwa moja kwa:

node daemon/daemon.mjs stop

VibeClaude huhifadhi kifaa kilichochaguliwa, intensity, na daemon.log chini ya ~/.config/vibeclaude. Ikiwa lango la TCP 12350 linatumika tayari, unda ~/.config/vibeclaude/config.json yenye lango tofauti:

{ "port": 12351 }

Tumia Daemon kutoka kwa Shell

Daemon inaweza kudhibitiwa bila kutegemea amri za slash za Claude Code. Amri hizi hutumia saraka chaguo-msingi ya usanidi na anwani ya WebSocket:

• node daemon/daemon.mjs scan: Unganisha, changanua kwa sekunde tatu, na uorodheshe vifaa vinavyoweza kutetemesha.
• node daemon/daemon.mjs select <index>: Chagua kifaa kutoka kwenye matokeo ya uchanganuzi.
• node daemon/daemon.mjs connect na disconnect: Unganisha au tenganisha kutoka kwa Intiface.
• node daemon/daemon.mjs intensity [value]: Weka au onyesha kizidishi cha intensity.
• node daemon/daemon.mjs start: Hakikisha daemon inaendesha na uchapishe lango lake.
• node daemon/daemon.mjs status: Kagua ikiwa daemon inajibu.
• node daemon/daemon.mjs stop: Simamisha matokeo yote na uondoke kwenye daemon.
• node daemon/daemon.mjs: Endesha daemon katika mandhari ya mbele.

Tumia --home <dir> kuchagua saraka nyingine ya usanidi na --ws <address> kubainisha anwani nyingine ya Intiface. Ili kurekodi kila tukio linapowasili, weka kigezo cha mazingira cha utatuzi:

VIBECLAUDE_DEBUG=1 node daemon/daemon.mjs

Jaribu Bila Vifaa

Hazina inajumuisha seva bandia ya Intiface inayochapisha kiwango cha mota ambacho ingepokea. Iwashe kwenye lango la 12345:

node test/mock-intiface.mjs 12345

Kisha endesha mkusanyiko wa majaribio:

npm test

Majaribio hayo hujaribu daemon kutoka mwanzo hadi mwisho dhidi ya seva yake bandia na hujaribu moduli ya hooks, hivyo kukuwezesha kukagua usakinishaji bila kidhibiti halisi.

Jinsi Muundo Unavyofanya Kazi

hooks/register.tsx huendesha ndani ya Claude Code. Huchunguza matukio ya hooks kama hatua za zamu zinazotiririshwa, miito ya zana, ukaguzi wa ruhusa, uundaji wa subagent, na mabadiliko ya mzunguko wa kipindi au zamu. Hupunguza matukio hayo kuwa ujumbe mfupi unaojumuisha ukubwa na vitambulisho badala ya maandishi ya modeli, kisha huvituma kwa mpangilio kwa daemon kwenye anwani ya loopback 127.0.0.1:12350.

Moduli ya hooks pia husajili amri za slash, huonyesha kidirisha cha kuchagua kifaa, na huonyesha arifa za daemon kama toast. Kwa kuwa moduli ya hooks haina ufikiaji wa Node.js, haiwezi kuendesha mteja wa Buttplug au kudumisha muunganisho wa Intiface WebSocket yenyewe.

daemon/daemon.mjs hushughulikia mteja rasmi wa Buttplug, muunganisho wa Intiface, kifaa kilichochaguliwa, injini ya mtetemo, na vishughulikiaji vya matukio. Kwa kuwa kifaa kinaweza kujibu polepole kuliko matokeo ya modeli yanavyowasili, daemon hutuma kiwango cha hivi karibuni kilichoombwa badala ya kujenga mlundikano.

Daemon huanza kipindi cha kwanza kinapohitaji, na hutoka baada ya kipindi cha mwisho kumalizika. Hufuatilia mchakato wa Claude Code unaohusishwa na kila kipindi na inaweza kusafisha vipindi vinavyotoweka bila kutarajiwa. Ikiwa haiwezi kubaini ni mchakato gani uliomalizika, hutoka baada ya dakika 30 bila shughuli.

Faragha na Kuzima Kiotomatiki

Programu-jalizi hutuma amri za kifaa tu kwenye anwani ya Intiface iliyosanidiwa kwenye mashine yako. Daemon husikiliza kwenye loopback na hukubali maombi ya JSON yanayoelekezwa kwa 127.0.0.1 au localhost; haifichui huduma ya mtandao kwa kurasa za kivinjari. VibeClaude haina telemetry.

Matokeo husimama kiotomatiki unapobadilisha vifaa, kumaliza kipindi, kutenganisha, kupoteza muunganisho wa Intiface, au daemon inapotoka. Kifaa kikitenganishwa na Intiface, hakichaguliwi tena; tumia /intiface kuunganisha tena. Kifaa kinachotoweka kwa muda kinaweza kuchaguliwa tena kinaporudi.

Hitimisho

VibeClaude huunganisha hook za Claude Code na Intiface Central kupitia daemon ya ndani ya Node.js, na kubadilisha matukio ya uandishi wa msimbo kuwa mrejesho wa kifaa unaoweza kusanidiwa. Sakinisha programu-jalizi na vitegemezi, anzisha Intiface Central, chagua kifaa ukitumia /intiface, na rekebisha matumizi kwa /intiface-intensity. Kwa utatuzi wa matatizo na uendelezaji, tumia amri za daemon ya shell, kumbukumbu za utatuzi, na seva ya majaribio iliyojumuishwa.

Mradi umepewa leseni chini ya Leseni ya MIT. Buttplug na Intiface ni alama za biashara za Nonpolynomial Labs, LLC.