Isifundo Sokuzisingathiela se-SkyDot: Yakha Indawo Yokusebenzela ye-Multi Dot AI Kusukela Ekuqaleni

Yini i-SkyDot

I-SkyDot iyindawo yokusebenza ye-Agent evulekile, ezisingathwa nguwe, yabasebenzisi abaningi, esekelwe ku-Pi Agent Runtime. Ungakha ama-Dot amaningi aqanjwe amagama futhi alungisekayo, uwabele imisebenzi ehlukene; futhi ungafaka ama-Dot amaningi engxoxweni yeqembu, usebenzise imisebenzi ehleliwe, ama-Skills, i-MCP, ama-Plugins ne-Memory ukuze wandise amandla omsebenzi wesikhathi eside.

Akuyona nje ikhasi lengxoxo. I-Workspace ihlukanisa amafayela, amaseshini, inkumbulo nemingcele yokwenza; i-Backend iphatha ukuqinisekiswa, izimvume, ulayini, ukuhlela, ama-Provider neziteshi zemiyalezo; i-Host noma i-Docker Runner yona yenza i-Agent ngempela. Izicelo zemvume yamathuluzi ezidinga ukuqinisekiswa komsebenzisi, izicelo zamadivayisi nenqubekelaphambili yemisebenzi nakho kubuyiselwa kule ndawo yokusebenza efanayo.

Isakhiwo esiyinhloko nemingcele yokwenza

I-SkyDot ihlukanisa isixhumi esibonakalayo, indawo yokulawula nendawo yokwenza, ngakho ifanele ukusetshenziswa komuntu siqu kanye nokusingathwa yiqembu.

• Backend: Isekelwe ku-Node.js, TypeScript, Hono, SQLite ne-WebSocket; iphatha ukuqinisekiswa, ukugcinwa kwedatha, ulayini, ukuhlela, ama-Provider, iziteshi nezimvume.
• Runner: Isebenzisa i-Pi Agent Runtime ukwenza imisebenzi yangempela ye-Agent, ngokukhetha imodi ye-Host yasendaweni noma isitsha se-Docker esingeyona i-root.
• Workspace: Inquma amafayela, ama-Session, i-Memory, ukubophezwa kweziteshi nemingcele yokusebenza.
• Web, PWA ne-Electron: Kwabelwana nge-React frontend yebhizinisi; i-Electron Renderer iphethe kuphela isixhumi esibonakalayo, ayifinyeleli ngqo kusizindalwazi, ohlelweni lwamafayela, ezimpawini zokungena, ku-Docker noma ezimvumeni ze-shell/process.

Izimvume azidluli ngokuzenzakalelayo eminye imingcele ngenxa yokuthi ungqimba olulodwa luvumile. Ngaphambi kokusebenzisa indawo yeqembu, funda ithebula lezimvume kanye nenqubomgomo yezokuphepha.

Imisebenzi eyinhloko

I-Dot yomuntu siqu namaseshini

I-Dot ngayinye ingalungiselelwa ngokuzimela igama, i-avatar, i-Prompt, imodeli, izinga lokucabanga, ama-Skills, i-MCP nenqubomgomo yokwenza. Ingxoxo isekela okukhiphayo okugeleza ngesikhathi sangempela, i-Markdown, amabhulokhi ekhodi, okunamathiselwe kwamafayela, ukumisa, imilayezo elandelayo nokubuyiselwa kweseshini.

Ama-Workspace ahlukene ahlukanisiwe. Amafayela, amaseshini, inkumbulo, ukubophezwa kweziteshi nezimvume zokwenza akuhlanganiswa ngenxa nje yokuthi kuvulwe isixhumi esibonakalayo esifanayo. Ngesikhathi sokwenza ungakhetha imodi ye-Host noma imodi ye-Container.

Ingxoxo yeqembu nokubambisana kwama-Dot amaningi

Uma ingxoxo yeqembu yomdabu ivuliwe, ungabuka imilayezo yama-Dot amaningi, amarisidi emisebenzi, inqubekelaphambili nemiphumela emugqeni wesikhathi owodwa. Ukubalula okucacile nokudluliselwa okulawulwayo kusetshenziselwa ukulawula ububanzi bokubambisana; ukuxhuma kabusha noma ukuvula ikhasi futhi kufunda isimo kuphela, akuthumeli ngokuzenzakalelayo umsebenzi omusha.

Ingxoxo yeqembu ivaliwe ngokuzenzakalelayo. Ukuvula ingxoxo yeqembu yomdabu kudinga ukusetha SKYDOT_BOT_GROUPS=true; uma ufuna nokuvumela ama-Bot ukuthi abambisane, kufanele futhi usethe SKYDOT_BOT_HANDOFFS=true, bese umlawuli elungisa izimvume zokusebenza nesabelomali sokubiza.

Imisebenzi ehleliwe, ama-Skills ne-Memory

I-Scheduler isekela i-Cron, izikhawu ezimisiwe nemisebenzi yesikhathi esisodwa, futhi inikeza ukusebenza ngokushesha, ukumisa okwesikhashana, ukukhansela, umlando wokusebenza nokuthunyelwa kwemiphumela. Ama-Skills, i-MCP nama-Plugins kungaphathwa endaweni eyodwa, bese kuvulwa ububanzi bokusetshenziswa ngokokucushwa kwe-Dot.

I-Memory igcina amaqiniso, izintandokazi, izinqumo, okuhlangenwe nakho nezinto ezizolandelwa ngokwe-Workspace; isekela ukusesha, ukudala, ukuhlela, ukukhohlwa nomlando wezinguqulo. I-Session igcina umongo wengxoxo ethile, kanti i-Workspace Memory igcina ulwazi olungasetshenziswa kabusha kuwo wonke ama-Session; kokubili kuzimele.

Okumele kulungiswe ngaphambi kokufaka

• Node.js: Inguqulo engu-22.19 noma ngaphezulu, kunconywa i-Node.js 24 LTS. Ukugcinwa kwe-Pi Durable kudinga i-SQLite eyakhelwe ku-Node.js.
• npm: Ifakwa kanye ne-Node.js, futhi isetshenziselwa ukufaka okuncike kuwo wonke amaphrojekthi angaphansi.
• Docker: Idingeka kuphela kwimodi yokwenza ye-Container.
• Model Provider: Ingxoxo yangempela ye-AI idinga i-Model Provider esebenzayo; ngaphandle kwe-API Key usengaqala isixhumi esibonakalayo.
• GNU Make: Ongakukhetha, isetshenziselwa ukuhlola izinhlobo, ukwenza izipele nemiyalo yokuphatha.

Faka i-SkyDot kusukela ekuqaleni

1. Klona indawo yokugcina bese ufaka okuncikile

Qalisa le miyalo elandelayo kutheminali ukuze ufake okuncike kuphrojekthi enkulu, ku-Web frontend naku-Agent Runner ngokwehlukana:

git clone https://github.com/2SinceJuly/SkyDot.git
cd SkyDot

npm install
npm --prefix web install
npm --prefix container/agent-runner install

2. Yakha bese uqala isevisi

Ngemva kokufaka okuncikile, yakha zonke izingxenye bese uqala i-Backend:

npm run build:all
npm start

Vula http://127.0.0.1:3000, bese ulandela ikhasi ukuqedela ukusethwa komlawuli. Ama-Provider neziteshi zemiyalezo kungalungiswa kamuva, kodwa ngaphandle kokucushwa kwemodeli ingxoxo yangempela ye-AI ngeke isebenze.

3. Qala indawo yokuthuthukisa

Ngesikhathi sokuthuthukisa ungaqala i-Backend ne-Vite Web Client ngesikhathi esisodwa:

npm run dev:all

Ikheli elizenzakalelayo lekhasi lokuthuthukisa ngu-http://127.0.0.1:5173. Uma ufuna ukubuka isixhumi esibonakalayo ngokushesha emshinini wendawo kuphela, ungasebenzisa i-Demo yekheli le-loopback ngaphandle kokungena:

SKYDOT_DEMO_OPEN=true PROVIDER_SETUP_SKIPPED=true npm start

Ungayivuli imodi ye-Demo ku-inthanethi yomphakathi noma kunethiwekhi ongayethembi. Ukuze ubone imingcele ephelele yale modi, bheka DEMO.md endaweni yokugcina.

Lungisa i-Model Provider

I-SkyDot ikuvumela ukuthi uqedele ukusethwa kwesixhumi esibonakalayo kuqala, bese ugcwalisa i-Provider kuzilungiselelo. Ukuze uxhume imodeli yangempela, lungisa i-API Key, i-Session Cookie noma ezinye izimpawu zokungena ezidingekayo, futhi ugweme ukufaka izimpawu zokungena ezithombeni-skrini, emlandweni womugqa womyalo noma endaweni yokugcina ye-Git.

Uma usebenzisa isixhumi esibonakalayo se-OpenAI Completions esivela komunye umhlinzeki, ungasetha lokhu kokuguquguqukayo kwemvelo okwenziwe ngokwezifiso kwe-Provider:

SKYDOT_MODEL_API=openai-completions

Iphrothokholi ezenzakalelayo ngu-anthropic-messages; lesi silungiselelo sisetshenziswa futhi yi-Host ne-Container Runner ezingxoxweni ezijwayelekile ze-Dot.

Khetha imodi yokwenza ye-Agent

Imodi ye-Host

Imodi ye-Host isebenzisa i-Runner yasemshinini wendawo ngqo, ayidingi i-Docker, futhi ifanele ukuthuthukisa kwasendaweni nokuqinisekisa okusheshayo. Izimvume zokwenza zisalokhu zikhawulelwe yi-Workspace, umsebenzisi nenqubomgomo yokusebenza.

Imodi ye-Container

Imodi ye-Container idinga ukuthi i-Docker itholakale, futhi idinga isithombe se-Agent Runner. Isithombe esizenzakalelayo ngu-2sincejuly/skydot-agent:latest, futhi ungakha esakho kusukela kukhodi yomthombo yamanje:

docker build --pull -t 2sincejuly/skydot-agent:latest container

Uma udinga ukusebenzisa esinye isithombe, setha SKYDOT_CONTAINER_IMAGE; into ehambisanayo yokucushwa ngu-CONTAINER_IMAGE. Isevisi nokwakhiwa kwesithombe kufanele kuxhumeke ku-Docker daemon efanayo. I-make start noma i-make dev izosebenzisa kuqala isithombe sendawo, futhi izame ukusidonsa uma singekho.

Qalisa i-Electron yedeskithophu

Uma i-Backend ne-Vite seziqalile, ungasebenzisa i-Electron kwenye itheminali:

SKYDOT_RENDERER_URL=http://127.0.0.1:5173 npm run desktop:dev

Uma i-Backend isivele inekhasi elakhiwe, ungasebenzisa ngqo:

npm run desktop:dev

I-Electron ingaxhuma futhi ku-Backend ekude:

SKYDOT_SERVER_URL=https://your-skydot.example.com npm run desktop:dev

Ukupakisha kwasendaweni ungasebenzisa le miyalo:

npm run desktop:package:dir
npm run desktop:package

Iphrojekthi inikeza ngokuzenzakalelayo ukucushwa kokupakisha kwe-macOS arm64, futhi igcina nezinhloso ze-Windows ne-Linux. Ngaphambi kokukhishwa okusemthethweni, kufanele ulungiselele ukusayina nokuqinisekiswa kwenkundla ngayinye ehlosiwe.

Okuguquguqukayo kwemvelo okubalulekile

• WEB_PORT: Imbobo elalelwa yi-Backend, inani elizenzakalelayo ngu-3000.
• SKYDOT_SERVER_URL: Ikheli le-Backend i-Electron exhuma kulo, inani elizenzakalelayo ngu-http://127.0.0.1:3000.
• SKYDOT_RENDERER_URL: Ikheli le-Renderer elilayishwa yi-Electron.
• SKYDOT_CONTAINER_IMAGE: Isithombe sesitsha se-Agent Runner.
• PROVIDER_SETUP_SKIPPED: Yeqa ukuqondiswa kwe-Provider uma lingekho ifayela lezilungiselelo zesistimu.
• SKYDOT_BOT_GROUPS: Vula ingxoxo yeqembu yomdabu yama-Dot amaningi.
• SKYDOT_BOT_HANDOFFS: Vula ukubambisana okwenziwa ama-Bot engxoxweni yeqembu.
• SKYDOT_PERSONAL_GOALS: Vula amakhono okuhlola ama-Goal omuntu siqu.

Ama-Goal omuntu siqu ne-Durable Runtime kuvaliwe ngokuzenzakalelayo. Imisebenzi ejwayelekile ehleliwe ayincikile kulezi zinguquko; ukuze ubone izimfuneko ezithile zokusebenza, bheka imibhalo ethi Goals and Tasks.

Inqubo eyisisekelo yokusebenzisa

1. Ngena ku-SkyDot bese uqedela ukusethwa komlawuli.
2. Lungisa i-Model Provider etholakalayo kuzilungiselelo.
3. Dala i-Dot, uyinike igama, i-Prompt, imodeli nenqubomgomo yokwenza.
4. Khetha i-Workspace ye-Dot, uqinisekise ukuthi imingcele yamafayela nenkumbulo ilindelekile.
5. Thumela umsebenzi engxoxweni, ubuke okukhiphayo okugeleza ngesikhathi sangempela, ukugunyazwa kwamathuluzi nemiphumela yokwenza.
6. Uma kudingeka ukusebenza kwesikhathi eside, dala umsebenzi we-Cron, wesikhawu esimisiwe noma wesikhathi esisodwa.
7. Uma kudingeka ukubambisana kwezindima eziningi, vula umsebenzi wengxoxo yeqembu bese ulungisa ngokucacile izimvume zokubambisana kwama-Bot.

Isibonelo, ungakha i-Dot ephethe ukuhlaziya ikhodi kanye nenye i-Dot ephethe ukuhlela izinto, bese uzifaka engxoxweni yeqembu efanayo. Ngokubalula ngokusobala noma ngokudlulisela imisebenzi okulawulwayo, abasebenzisi bangabuka inqubekelaphambili nemiphumela kumugqa wesikhathi owabiwe, kuyilapho begcina imingcele yezimvume yama-Workspace abo.

Izincomo Zokusebenza Nokuphepha

Idatha yesikhathi sokusebenza igcinwa ngokuzenzakalela ku-directory ethi data/ ye-repository, ehlanganisa i-SQLite, ama-Workspace, ama-Session, i-Memory kanye nokucushwa kokusebenza. Le directory ayifakwa ku-Git, kodwa izipele zingase ziqukathe ukucushwa okubucayi kanye ne-database, ngakho kufanele zivikelwe ngezinga elifanayo nedatha yokuqala.

• Sebenzisa make status ukuze ubuke isimo se-Backend, amalogi kanye ne-Docker.
• Sebenzisa make stop ukuze umise isevisi ye-SkyDot esebenzisa i-port yamanje.
• Sebenzisa make backup ukuze udale isipele sedatha yesikhathi sokusebenza.
• Sebenzisa make restore FILE=... ukuze ubuyisele isipele esishiwo.
• Sebenzisa make typecheck ukuze wenze ukuhlolwa kwe-Backend, Web, Agent Runner kanye nemibhalo.
• Sebenzisa npm test -- --run ukuze usebenzise izivivinyo ze-Vitest.

Lapho uyifaka kuseva ekude, kufanele usebenzise i-HTTPS ne-WSS, futhi ulungise kahle i-reverse proxy, ama-Cookie kanye nokulawulwa kokufinyelela. Ungayivezi ngokuqondile i-Renderer, i-database noma i-Docker daemon kubasebenzisi abangathembekile, futhi ungavuli i-Demo yomphakathi ukuze nje kube lula.

Ukwandisa Ngokuqhubekayo

Umtapo wamakhono we-SkyDot usekela imithombo efana ne-built-in, host machine, project, user, Workspace ne-Plugin. Ngaphambi kokusebenza kwe-Agent, kwakhiwa uhlu lwamakhono olusebenzayo, bese i-Prompt, izinsiza kanye nomongo kufakwa ngokwezinqubomgomo. Iphrojekthi iphinde isekele ama-snapshot ezinguqulo zama-Plugin, ama-Subagents, kanye nemingcele yamakhono ehambisanayo phakathi kwe-Host ne-Container.

Ngasohlangothini lokungena kwemiyalezo, i-Web, i-PWA ne-Electron zisebenzisa i-frontend efanayo yebhizinisi, futhi zingaxhunywa eziteshini ezifana ne-Feishu, Telegram, QQ, DingTalk, WeChat, Discord ne-WhatsApp. Isiteshi singaboshelwa ku-Workspace noma ku-Session ethile.

Isifinyezo

I-SkyDot ihlanganisa izingxoxo zama-Dot amaningi, ukuhlukaniswa kwama-Workspace, ukusebenza kwama-Agent, imisebenzi ehleliwe, amakhono anwebekayo kanye nezimvume zeqembu ibe yi-workbench eyodwa ezisingathwa nguwe. Ngemva kokuqedela ukulungiselela imvelo ye-Node.js, ukufaka okuncikile, ukwakha nokuqalisa, kanye nokucushwa kwe-Provider ngokwale ndatshana, ungaqala usebenzise i-Dot yomuntu siqu, bese uvula kancane kancane amakhono afana ne-Docker, Electron, izingxoxo zamaqembu, i-Scheduler, ama-Skills, i-MCP ne-Memory.

Ngenxa yokuthi iphrojekthi isathuthukiswa ngokuqhubekayo, amamodeli angempela, i-Docker, iziteshi zangaphandle kanye nokufakwa okukude konke kuncike kuma-credential azo kanye nemvelo yazo yokusebenza. Amakhono okuhlola afana ne-Goal, Durable noma i-Cloud Runtime akufanele athathwe njengemisebenzi evulwe ngokuzenzakalela.