Isifundo Sokuqala se-Lancer: Ukwakha Indawo Yokusebenza Yedeskithophu Ye-AI Ehambisanayo Elandelekayo

Yini i-Lancer

I-Lancer iyindawo yokusebenza ye-AI yedeskithophu eyakhiwe phezu kwe-pi-gui ne-pi. Ihlanganisa izingxoxo, amagatsha ahambisanayo, izinqubo namafayela alethwayo esibonakalayo esisodwa, ikusiza ukulandelela inqubo ephelele yomsebenzi kusukela ekudalweni, ekuhlukanisweni kuya ekulethweni.

Okubalulekile: I-Lancer isesigabeni se-Alpha okwamanje, futhi i-macOS Apple Silicon iyinkundla eyinhloko yokuqinisekisa. Nakuba i-Linux ne-Windows zinezilungiselelo zokupakisha, lokho akusho ukuthi wonke amakhono omdabu aseqinisekisiwe. Ifayela eligciniwe lekhodi yomthombo aliyona iphakheji yedeskithophu engasebenza ngokuchofozwa kabili.

Imisebenzi eyinhloko

Izikhathi neMisebenzi Ehlukahlukene

Izikhathi ezivamile zingasebenza ngokuzimela. Izikhathi zamamojula zingalungiselelwa izigaba, amamodeli, ama-Skill, izinhloso nezimfuneko zokulethwa, futhi zilungele imisebenzi eyinkimbinkimbi enezinyathelo ezicacile edinga imiphumela eqinisekiswayo.

Amagatsha ahambisanayo nokuqoqwa kwemiphumela

Umsizi oyedwa angaphatha izikhathi eziningi. Umsebenzi ungakhiqiza amagatsha ezingane namagatsha abazukulu, bese imiphumela yamagatsha ngayinye ibuyiselwa esikhathini somzali ukuze iqoqwe. Lesi sakhiwo silungele ucwaningo oluhambisanayo, ukuqhathanisa izixazululo nokukhiqizwa kokuqukethwe kwezigaba eziningi.

Igrafu yemicimbi yemisebenzi ye-GitTree

I-GitTree engakwesokudla kwesibonisi ingabonisa imigqa yezikhathi eminingi, amagatsha, ukuhlanganiswa nezindawo zokulethwa ngesikhathi esisodwa, noma igxile esikhathini samanje. Qaphela ukuthi i-GitTree imele igrafu yemicimbi yemisebenzi, ngakho akuzona zonke izindawo ezimele ama-commit wangempela e-Git.

Impendulo yokuqalisa nemiphumela yokukhanya

Amabhamuza omsebenzi nemigqa yenqubo kubonisa imingcele ehambayo, kanti okuphumayo kwemodeli nezenzo zokulethwa kuthumela imisebe enombala ofanayo ezindaweni ezihambisanayo. Le mpendulo ebonakalayo ibonisa imisebenzi esebenzayo njengamanje kanye nendlela imiphumela egeleza ngayo.

Amamodeli, ama-akhawunti nokulawulwa yi-Doubao

I-Lancer isebenzisa i-pi ukuxhuma ama-akhawunti okubhaliselwe, okhiye be-API nezindawo zokugcina ezenziwe ngokwezifiso, futhi iphathe ngokwehlukana izinhlobo zamamodeli namasango. Ku-macOS, ingaxhumanisa nesikhathi sohlelo lokusebenza lwe-Doubao esivele sivuliwe ukuze yamukele izimpendulo namavidiyo. Ukulawulwa yi-Doubao kudinga imvume yezici zokusiza kule khompyutha, futhi izibuyekezo zesibonisi sohlelo lwedeskithophu lwe-Doubao zingathinta ukuhambisana.

Ukuhamba komsebenzi kokuhlaziya amavidiyo

Ukuhamba komsebenzi kwamavidiyo kungadawuniloda noma kwamukele amavidiyo, kukhiphe amafreyimu abalulekile, bese kukhiqiza amafayela okuhlaziya nawokudlulisela aqukethe ubufakazi. Nokho, ukuphinda kwakhiwe ngokuzenzakalelayo okwamanje akuqinisekisi ukufana okungu-1:1 nethempulethi. Ukulawulwa yi-Doubao, ukuhlaziywa kwemodeli, ukugqwayiza kwekhodi nokuhlela kokugcina kuyizigaba ezahlukene futhi kufanele kuqinisekiswe ngokwehlukana.

Ukulungiselela ngaphambi kokufaka

Ngaphambi kokuqala, qinisekisa ukuthi indawo yokuthuthukisa ihlangabezana nalezi zidingo:

• Node.js >=22.19.0 futhi <26, kunconywa i-Node.js 24.
• pnpm 10.34.9.
• Git.
• I-macOS idinga i-Xcode Command Line Tools.
• I-Linux idinga i-Python 3, i-make, umhlanganisi we-C++, indawo yedeskithophu yezithombe namalabhulali esistimu adingwa yi-Electron.
• Okuncike kukho komdabu kwe-Windows kungadinga i-Python ne-Visual Studio Build Tools enomthwalo we-C++, kodwa inguqulo yamanje ayikaqinisekisi ngokuphelele ukuziphatha komdabu kwe-Windows.

Uma i-macOS ingenawo amathuluzi omugqa womyalo, sebenzisa:

xcode-select --install

I-Debian noma Ubuntu ingafaka okuncike kukho kokwakha kwe-Linux:

sudo apt-get install build-essential python3

Ukufaka nokwethula kusuka kukhodi yomthombo

Vula ifayela lomthombo eligciniwe noma uyiklonele kufolda entsha, ungene empandeni yeriphozithori, bese usebenzisa lokhu ngokulandelana:

npx --yes pnpm@10.34.9 run doctor
npx --yes pnpm@10.34.9 install --frozen-lockfile
npx --yes pnpm@10.34.9 dev

Le miyalo isebenzisa ngokuqinile i-pnpm 10.34.9, ayidingi ukusebenzisa i-corepack enable, futhi ayidingi ukufakwa kwe-pnpm emhlabeni wonke. Uma uhlelo selufake inguqulo efanayo, ungashintsha isiqalo somyalo sibe yi-pnpm.

Ukudawuniloda okuncike kukho kudinga uxhumano lwenethiwekhi. Uma imibhalo yokuncika yeqiwe ngesikhathi sokufaka, amafayela kanambambili e-Electron angase angabi khona. Ngemva kokuqinisekisa ukuthi inethiwekhi iyakwazi ukufinyelela umthombo wokudawuniloda we-Electron, sebenzisa:

npx --yes pnpm@10.34.9 run setup:electron
npx --yes pnpm@10.34.9 dev

Ungazami ukulungisa inkinga yokufaka i-Electron ngokuvumela noma ukuvala yonke imibhalo yokuncika ngaphandle kokuhlukanisa; qala uhlole ilogi yokufaka namaphutha enethiwekhi.

Ukuqeda ukusetha kokuqala

1. Qalisa i-Lancer bese uvula izilungiselelo.
2. Xhuma i-akhawunti yemodeli esekelwayo, umhlinzeki noma indawo yokugcina eyenziwe ngokwezifiso. Ikhodi yomthombo ayizi nemininingwane yomuntu siqu.
3. Engeza noma khetha indawo yokusebenza.
4. Dala isikhathi esivamile, noma ngokwezidingo zomsebenzi udale isikhathi semojula esinezigaba, imodeli, i-Skill, izinhloso nezimfuneko zokulethwa.
5. Ngemva kokuqalisa umsebenzi, bheka umugqa wesikhathi, amagatsha akhiqiziwe, ukuqoqwa nezindawo zokulethwa ku-GitTree.

Ungacacisa ulimi lwesibonisi ngokusebenzisa okuguquguqukayo kwemvelo:

LANCER_LOCALE=zh-CN npx --yes pnpm@10.34.9 dev

Ukuze usebenzise isibonisi sesiNgisi, setha inani libe yi-en.

Ukulayisha izilungiselelo zemvelo ozikhethelayo

Izilungiselelo ozikhethelayo zigcinwe ku-.env.example yeriphozithori, kodwa umbhalo wokuqalisa ideskithophu awulifundi ngokuzenzakalelayo leli fayela. Ku-macOS noma ku-Linux, ungakopisha ithempulethi bese ulilayisha kutheminali yamanje:

cp .env.example .env.local
set -a
. ./.env.local
set +a
npx --yes pnpm@10.34.9 dev

Abasebenzisi be-PowerShell bangasetha okuguquguqukayo kwemvelo ngakunye, isibonelo:

$env:LANCER_LOCALE = "en"

Ama-akhawunti angempela amamodeli kufanele axhunywe kuzilungiselelo zohlelo lokusebenza. Ungathumeli okhiye be-API, amafayela okuqinisekisa, izindawo zokugcina eziyimfihlo, izingxoxo zangempela noma okuqoshiwe kwezikhathi kumariphozithori omphakathi.

Ukulungiselela amathuluzi evidiyo

Amathuluzi emidiya awadingeki uma usebenzisa isibonisi sengxoxo kuphela. Ukuze usebenzise ukuhamba komsebenzi kokudawuniloda amavidiyo, ukukhipha amafreyimu abalulekile nokuhlaziya imidiya, udinga i-FFmpeg, i-FFprobe ne-yt-dlp ezisebenzisekayo.

pnpm run doctor --media

Uma la mathuluzi engekho ku-PATH, ungacacisa izindlela eziphelele ngokusebenzisa okuguquguqukayo kwemvelo FFMPEG, FFPROBE ne-YT_DLP, noma ulungise izindlela ku-video-learn-tools.json kufolda yedatha yomsebenzisi.

Umyalo wokuxilonga usebenzisa imiyalo yezinguqulo yawo wonke amathuluzi, ngakho awutholi kuphela amafayela angekho, kodwa uthola nokufakwa okonakele lapho ifayela elisebenzisekayo likhona kodwa ilabhulali eguqukayo ingekho. Ngaphambi kokuqinisekisa ngokuphelele, ungahlola ngesandla:

ffmpeg -version
ffprobe -version

Ukuhlola, ukwakha nokuhlola ukusebenza

Lapho ulungiselela ukuthumela izinguquko noma uhlola isimo sekhodi yomthombo, ungasebenzisa lokhu kuhlola:

pnpm check
pnpm build
pnpm audit:dependencies
pnpm verify:install-copy
pnpm verify:release-config
pnpm --filter @lancer/desktop run test:e2e:core

Ngesikhathi sokuthuthukisa ungaphinda uqinisekise ukulayishwa kabusha kwedeskithophu:

pnpm --filter @lancer/desktop run test:dev:reload

Ukuhlolwa kwe-Core kusebenzisa isibonisi sangempela se-Electron ngedatha ehlukanisiwe, kodwa ukuphumelela kokuhlolwa kwe-Core akufakazeli ukuthi amamodeli angempela, izimvume zomdabu, amaphakheji okufaka, ukusebenza noma ukuhambisana kwazo zonke izinkundla sekuqinisekisiwe. Ukuhlolwa okuhlobene nemidiya kudinga ukuthi i-FFmpeg ne-FFprobe zisebenze kahle.

Ukusebenzisa kabusha i-Lancer Light UI ngokuzimele

Uma udinga kuphela umphumela wokukhanya oxhumanisa imodeli noma ibhamuza nesihlahla somsebenzi, ungakhipha i-Lancer Light UI. Ayincikile ku-Electron, ku-CLI noma kusevisi yemodeli, futhi inikeza izibonelo zomugqa owodwa, ukuhlanganiswa kwamagatsha kanye nokusebenza kwezikhathi eziningi ngokuhambisana.

pnpm export:light-ui /absolute/new/lancer-light-ui
cd /absolute/new/lancer-light-ui
npm install && npm run dev

Indlela yokukhipha kufanele ishintshwe ibe yindlela ephelele emshinini okuqondiswe kuwo. Ukuze uthole eminye imininingwane, bheka i-Light UI README eriphozithori.

Ukwakha uhlelo lwendawo ku-macOS

Iphakheji yomthombo ayifaki i-.app engachofozwa kabili, futhi ukulanda uhlelo oluzimele akukakhishwa. Ngemva kokufaka okuncike kukho, ungasebenzisa umbhalo wokwakha wendawo:

bash scripts/build-mac-lancer.sh --skip-install --dir

Iphakheji yokufaka yendawo idinga isitifiketi sokusayina esiqhubekayo esilungiselelwe kusengaphambili. Umbhalo awudali ngokuzenzakalelayo isitifiketi, awushintsheli ekusayineni kwesikhashana futhi awenzi notarization. Imiphumela yokwakha igcinwa kumafolda azimele e-apps/desktop/release-local-*/.

Ngemva kokuqinisekisa uhlelo oluyikhandidethi, ungangeza --install ukuze ulufake ku-/Applications:

bash scripts/build-mac-lancer.sh --skip-install --dir --install

Isifaki sidinga ukuthi uhlelo oludala luvalwe kahle, sizohlola isiginesha futhi sigcine inguqulo endala engabuyiselwa, ngaphandle kokusula idatha yezikhathi. Ukusabalalisa esidlangalaleni kusadinga i-Developer ID, notarization nokuqinisekisa emshinini ohlanzekile; isiginesha yendawo ayibhekwa njengokuqinisekiswa kokukhishwa esidlangalaleni.

Ukusetshenziswa okuthuthukile nezincomo zokuphepha

Ukuqonda indawo yedatha yokuqalisa

Idatha yezikhathi nama-akhawunti isebenzisa i-~/.pi/agent ye-pi. Ku-macOS, isimo sesibonisi se-Lancer sitholakala ku-~/Library/Application Support/Lancer. Ukukopisha ikhodi yomthombo kwenye ifolda akuhlukanisi le datha yokuqalisa; uma udinga ukuhlolwa okwenziwa ngesandla okuhlukaniswe ngokuphelele, sebenzisa umsebenzisi ohlukile wesistimu yokusebenza.

Ukuklama amagatsha emisebenzi eyinkimbinkimbi

Ungahlukanisa ucwaningo, ukuhlaziya, ukuqaliswa nokuqinisekiswa kube amagatsha ezingane ahlukene, bese isikhathi somzali siqoqa imiphumela. Lapho usebenzisa i-GitTree, qonda izindawo njengemicimbi yemisebenzi nobudlelwano bokulethwa, hhayi njengama-commit ekhodi ngokuzenzakalelayo.

Ukuqinisekisa izigaba zevidiyo ngokwehlukana

Kumaphrojekthi evidiyo, hlola ngokwehlukana okokufaka okulawulwayo, ukuhlaziywa kwemodeli, ukugqwayiza kwekhodi nokuhlela kokugcina. Ungaphethi ngokuphumelela kokugcina kwephrojekthi ukuthi umsebenzi wokugcina uzofana ngokuzenzakalelayo nethempulethi eyireferensi ngokuphelele.

Ukukhipha iphakheji yekhandidethi yekhodi yomthombo engahlolwa

Lapho ulungiselela ukushicilela ikhodi yomthombo, ungakhipha ifolda entsha yekhandidethi nohlu lwe-SHA-256:

pnpm export:source /absolute/path/to/new/lancer-source

Lo myalo ukhipha .git, imikhiqizo yezikhathi zasendaweni, amafayela okhiye nemiphumela yokwakha, kodwa ugcina indawo yokusebenza yamanje, izithombe-skrini zomlando nokuqoshwa kwesikrini. Ukuphumelela kokukhipha akusho ukuthi kungashicilelwa ngokushesha; kusadingeka ukuhlolwa komuntu mayelana namalayisensi ezinto kanye nokuqukethwe okubucayi.

Imibuzo evame ukubuzwa

• I-Corepack iveza iphutha lezimvume: Sebenzisa umyalo wenguqulo eqondile othi npx --yes pnpm@10.34.9, ngaphandle kokulungisa i-shim yomhlaba wonke.
• I-Electron ayifakwanga kahle: Hlola inethiwekhi namaphutha okufaka, bese usebenzisa run setup:electron.
• I-Linux ibika ukuthi i-make noma umhlanganisi awukho: Faka i-Python 3, i-make namathuluzi okwakha e-C++, bese ufaka kabusha okuncike kukho.
• Ukuhlolwa kwamathuluzi evidiyo kuyahluleka: Sebenzisa pnpm doctor --media, futhi uqinisekise ukuthi amafayela asebenzisekayo namalabhulali awo aguqukayo ayatholakala.
• Imodeli ayitholakali: Xhuma i-akhawunti noma umhlinzeki osekelwayo kuzilungiselelo; ikhodi yomthombo ayinayo imininingwane yokuqinisekisa yomuntu siqu.

Isifinyezo

I-Lancer ihlanganisa izikhathi ze-AI ezisebenza ngokuhambisana, amagatsha aphindaphindayo, impendulo yenqubo namafayela okulethwa endaweni eyodwa yokusebenza yedeskithophu. Ngemva kokuqeda ukuhlolwa kwemvelo, ukuqalisa ikhodi yomthombo, ukuxhuma i-akhawunti nokulungisa amathuluzi emidiya ngokwale tutorial, ungaqala ukwakha ukuhamba komsebenzi okungalandeleka. Njengoba iphrojekthi isesesigabeni se-Alpha, ukusetshenziswa ekukhiqizeni, ukuhambisana kwezinkundla ezahlukene, ukuthathwa yi-Doubao nemiphumela yokuphindaphinda amavidiyo kufanele kuqinisekiswe ngokuzimela.