Mafunzo ya Kuanza na Lancer: Kuunda Eneo la Kazi la AI la Kompyuta ya Mezani lenye Ufuatiliaji

Lancer ni nini

Lancer ni eneo la kazi la AI la kompyuta ya mezani lililotengenezwa kwa kutumia pi-gui na pi. Huunganisha mazungumzo, matawi sambamba, michakato ya uendeshaji na faili za kukabidhi katika kiolesura kimoja, hivyo kukusaidia kufuatilia mchakato kamili wa kazi kuanzia kuunda, kugawanya hadi kukabidhi.

Muhimu: Kwa sasa Lancer iko katika hatua ya Alpha, na macOS Apple Silicon ndiyo jukwaa kuu la majaribio. Ingawa Linux na Windows zina usanidi wa kufunga programu, hiyo haimaanishi kuwa uwezo wote wa asili umethibitishwa. Kifurushi cha msimbo wa chanzo si programu ya kompyuta ya mezani inayoweza kuendeshwa kwa kubofya mara mbili.

Vipengele vya msingi

Vipindi na kazi za moduli

Kipindi cha kawaida kinaweza kuendeshwa kivyake. Kipindi cha moduli kinaweza kusanidiwa kwa hatua, modeli, Skill, malengo na mahitaji ya kukabidhi, hivyo kinafaa kwa kazi changamano zenye hatua zilizo wazi na zinazohitaji matokeo yakaguliwe.

Matawi sambamba na muhtasari wa matokeo

Msaidizi mmoja anaweza kudhibiti vipindi vingi. Kazi inaweza kuunda matawi ya watoto na wajukuu; kila tawi linapokamilika, matokeo hurudishwa kwenye kipindi cha mzazi kwa ajili ya muhtasari. Muundo huu unafaa kwa utafiti sambamba, kulinganisha mipango na uzalishaji wa maudhui wa hatua nyingi.

Ramani ya matukio ya kazi ya GitTree

GitTree iliyo upande wa kulia wa kiolesura inaweza kuonyesha kwa wakati mmoja mistari mingi ya vipindi, matawi, miunganiko na nodi za kukabidhi, au kulenga kipindi cha sasa. Kumbuka kuwa GitTree inawakilisha ramani ya matukio ya kazi; si kila nodi ndani yake inawakilisha commit halisi ya Git.

Maoni ya uendeshaji na athari za mwanga

Viputo vinavyotumika na mistari ya mchakato huonyesha mipaka inayotiririka, huku matokeo ya modeli na vitendo vya kukabidhi vikituma mwanga wa rangi inayolingana kwenye nodi husika. Maoni haya ya kuona yanaonyesha kazi inayoendelea na mwelekeo wa mtiririko wa matokeo yake.

Modeli, akaunti na udhibiti wa Doubao

Lancer hutumia pi kuunganisha akaunti za usajili, funguo za API na vituo maalum, huku ikidhibiti chapa za modeli na lango kando. Kwenye macOS, inaweza pia kuhusisha kipindi cha Doubao App ambacho tayari kimefunguliwa, ili kupokea majibu na video. Udhibiti wa Doubao unahitaji ruhusa za Ufikivu kwenye kompyuta hii, na masasisho ya kiolesura cha Doubao ya kompyuta ya mezani yanaweza kuathiri uoanifu.

Mtiririko wa uchanganuzi wa video

Mtiririko wa video unaweza kupakua au kupokea video, kutoa fremu muhimu, na kuunda faili za uchanganuzi na makabidhiano zenye ushahidi. Hata hivyo, uigaji wa kiotomatiki kwa sasa hauwezi kuhakikishiwa kufanana 1:1 na kiolezo. Udhibiti wa Doubao, uchanganuzi wa modeli, uhuishaji wa msimbo na uhariri wa mwisho ni hatua tofauti na zinapaswa kukaguliwa kivyake.

Maandalizi kabla ya usakinishaji

Kabla ya kuanza, thibitisha kuwa mazingira ya uundaji yanakidhi mahitaji yafuatayo:

• Node.js >=22.19.0 na <26, Node.js 24 inapendekezwa.
• pnpm 10.34.9.
• Git.
• macOS inahitaji Xcode Command Line Tools.
• Linux inahitaji Python 3, make, kompaili ya C++, mazingira ya picha ya kompyuta ya mezani pamoja na maktaba za mfumo zinazohitajika na Electron.
• Utegemezi wa asili wa Windows unaweza kuhitaji Python na Visual Studio Build Tools yenye mzigo wa kazi wa C++, lakini toleo la sasa bado halijathibitisha kikamilifu tabia ya asili ya Windows.

Ikiwa macOS haina zana za mstari wa amri, endesha:

xcode-select --install

Kwenye Debian au Ubuntu unaweza kusakinisha utegemezi wa uundaji wa Linux:

sudo apt-get install build-essential python3

Kusakinisha na kuanzisha kutoka kwenye msimbo wa chanzo

Fungua kifurushi cha msimbo wa chanzo au kloni kwenye saraka mpya, ingia kwenye saraka kuu ya hifadhi, kisha endesha amri hizi kwa mpangilio:

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

Amri hizi hutumia pnpm 10.34.9 kwa lazima; huhitaji kuendesha corepack enable wala kusakinisha pnpm kimataifa. Ikiwa mfumo tayari una toleo hilo, unaweza kubadilisha kiambishi cha amri kuwa pnpm.

Upakuaji wa utegemezi unahitaji muunganisho wa mtandao. Ikiwa hati za utegemezi zilirukwa wakati wa usakinishaji, faili za binary za Electron huenda zisiwepo. Baada ya kuthibitisha kuwa mtandao unaweza kufikia chanzo cha upakuaji cha Electron, endesha:

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

Usijaribu kurekebisha tatizo la usakinishaji wa Electron kwa kuruhusu bila kuchagua au kuzima hati zote za utegemezi. Kwanza kagua kumbukumbu za usakinishaji na hitilafu za mtandao.

Kukamilisha usanidi wa kwanza

1. Anzisha Lancer na uingie kwenye mipangilio.
2. Unganisha akaunti ya modeli inayotumika, mtoa huduma au kituo maalum. Msimbo wa chanzo hauna vitambulisho vya kibinafsi.
3. Ongeza au chagua eneo la kazi.
4. Unda kipindi cha kawaida, au kipindi cha moduli chenye hatua, modeli, Skill, malengo na mahitaji ya kukabidhi kulingana na mahitaji ya kazi.
5. Baada ya kuendesha kazi, tazama mistari ya vipindi, matawi yaliyoundwa, muhtasari na nodi za kukabidhi katika GitTree.

Unaweza kubainisha lugha ya kiolesura kupitia kigezo cha mazingira:

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

Kwa kiolesura cha Kiingereza, weka thamani kuwa en.

Kupakia usanidi wa hiari wa mazingira

Usanidi wa hiari umeandikwa katika .env.example ya hifadhi, lakini hati ya kuanzisha ya kompyuta ya mezani haisomi faili hii kiotomatiki. Kwenye macOS au Linux, unaweza kunakili kiolezo na kukipakia katika terminal ya sasa:

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

Watumiaji wa PowerShell wanaweza kuweka vigezo vya mazingira kimoja baada ya kingine, kwa mfano:

$env:LANCER_LOCALE = "en"

Akaunti halisi za modeli zinapaswa kuunganishwa katika mipangilio ya programu. Usikabidhi funguo za API, faili za uthibitishaji, vituo vya faragha, mazungumzo halisi au rekodi za vipindi kwenye hifadhi ya umma.

Kusanidi zana za video

Zana za media hazihitajiki ikiwa unatumia kiolesura cha mazungumzo pekee. Ili kuendesha upakuaji wa video, utoaji wa fremu muhimu na mtiririko wa uchanganuzi wa media, unahitaji FFmpeg, FFprobe na yt-dlp zinazoweza kutekelezwa.

pnpm run doctor --media

Ikiwa zana hizi hazipo katika PATH, unaweza kubainisha njia kamili kupitia vigezo vya mazingira FFMPEG, FFPROBE na YT_DLP, au kusanidi njia hizo katika video-learn-tools.json iliyo kwenye saraka ya data ya mtumiaji.

Amri ya uchunguzi hutekeleza kwa kweli amri za toleo za kila zana, hivyo inaweza kugundua si faili zinazokosekana tu, bali pia usakinishaji ulioharibika ambapo “faili inayoweza kutekelezwa ipo lakini maktaba za nguvu zimekosekana”. Kabla ya uthibitishaji kamili, unaweza kukagua mwenyewe:

ffmpeg -version
ffprobe -version

Ukaguzi wa uendeshaji, uundaji na majaribio

Unapojitayarisha kuwasilisha mabadiliko au kutathmini hali ya msimbo wa chanzo, unaweza kuendesha ukaguzi ufuatao:

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

Wakati wa uundaji, unaweza pia kuthibitisha upakiaji upya wa programu ya kompyuta ya mezani:

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

Majaribio ya Core huendesha kiolesura halisi cha Electron kwa kutumia data iliyotengwa, lakini kufaulu kwa majaribio ya Core hakuthibitishi kuwa modeli halisi, ruhusa za asili, kifurushi cha usakinishaji, utendaji au uoanifu wa majukwaa yote vimehakikiwa. Majaribio yanayohusiana na media pia yanahitaji FFmpeg na FFprobe kufanya kazi ipasavyo.

Kutumia tena Lancer Light UI kivyake

Ikiwa unahitaji tu athari ya mwanga inayounganisha modeli au viputo na mti wa kazi, unaweza kuhamisha Lancer Light UI. Haitegemei Electron, CLI au huduma ya modeli, na hutoa mifano ya mstari mmoja, matawi na miunganiko, pamoja na vipindi vingi vinavyoendeshwa sambamba.

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

Njia ya kuhamishia lazima ibadilishwe kuwa njia kamili kwenye mashine lengwa. Kwa maelezo zaidi, soma Light UI README iliyo kwenye hifadhi.

Kujenga programu ya asili kwenye macOS

Kifurushi cha msimbo wa chanzo hakina .app inayoweza kufunguliwa kwa kubofya mara mbili, na upakuaji wa programu huru bado haujatolewa. Baada ya kusakinisha utegemezi, unaweza kuendesha hati ya ujenzi wa ndani:

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

Kifurushi cha ndani kinahitaji cheti cha kudumu cha kusaini kisanidiwe mapema. Hati haitaunda cheti kiotomatiki, kubadilisha hadi usainishaji wa muda au kutekeleza notarization. Matokeo ya ujenzi huhifadhiwa katika saraka tofauti ya apps/desktop/release-local-*/.

Baada ya kuthibitisha programu mgombea, unaweza kuongeza --install ili kuisakinisha kwenye /Applications:

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

Kisakinishi kinahitaji programu ya zamani ifungwe ipasavyo, hukagua saini na huhifadhi toleo la zamani linaloweza kurejeshwa, bila kufuta data ya vipindi. Usambazaji wa umma bado unahitaji Developer ID, notarization na kukaguliwa kwenye mashine safi; usainishaji wa ndani hauwezi kuchukuliwa kuwa uthibitisho wa kukamilika kwa uidhinishaji wa uchapishaji wa umma.

Matumizi ya juu na mapendekezo ya usalama

Kuelewa mahali data ya uendeshaji ilipo

Data ya vipindi na akaunti hutumia ~/.pi/agent ya pi. Kwenye macOS, hali ya kiolesura cha Lancer iko katika ~/Library/Application Support/Lancer. Kunakili msimbo wa chanzo kwenye saraka nyingine hakutatenga data hii ya uendeshaji; ikiwa unahitaji jaribio la mikono lililotengwa kabisa, tumia mtumiaji tofauti wa mfumo wa uendeshaji.

Kuunda matawi kwa kazi changamano

Unaweza kugawanya utafiti, uchanganuzi, utekelezaji na ukaguzi katika matawi tofauti ya watoto, kisha kipindi cha mzazi kikusanye matokeo. Unapotumia GitTree, elewa nodi kama matukio ya kazi na mahusiano ya kukabidhi, wala si kuchukulia kila nodi kuwa commit ya msimbo kwa chaguo-msingi.

Kukagua mtiririko wa video kwa hatua tofauti

Kwa miradi ya video, kagua kando ingizo la udhibiti, uchanganuzi wa modeli, uhuishaji wa msimbo na uhariri wa mwisho. Usihitimishe kuwa kazi ya mwisho inaweza kuendana kiotomatiki kabisa na kiolezo cha marejeo kwa sababu tu hatua moja imefaulu.

Kuandaa kifurushi cha msimbo wa chanzo kinachoweza kukaguliwa

Unapojitayarisha kuchapisha msimbo wa chanzo, unaweza kuhamisha saraka mpya ya mgombea na orodha ya SHA-256:

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

Amri hii huondoa .git, bidhaa za vipindi vya ndani, faili za funguo na matokeo ya ujenzi, lakini huhifadhi eneo la sasa la kazi, picha za skrini za kihistoria na rekodi za video. Kuhamisha kwa mafanikio hakumaanishi kuwa kifurushi kinaweza kuchapishwa moja kwa moja; bado kunahitajika ukaguzi wa kibinadamu wa ruhusa za nyenzo na maudhui nyeti.

Maswali yanayoulizwa mara kwa mara

• Corepack inaonyesha hitilafu ya ruhusa: Tumia amri ya toleo lililowekwa npx --yes pnpm@10.34.9; huhitaji kurekebisha shim ya kimataifa.
• Electron haikusakinishwa ipasavyo: Kagua mtandao na hitilafu za usakinishaji, kisha endesha run setup:electron.
• Linux inasema make au kompaili haipo: Sakinisha Python 3, make na zana za ujenzi wa C++, kisha sakinisha tena utegemezi.
• Ukaguzi wa zana za video umeshindwa: Endesha pnpm doctor --media, na uthibitishe kuwa faili zinazoweza kutekelezwa pamoja na maktaba zake za nguvu zinapatikana.
• Modeli haipatikani: Unganisha akaunti au mtoa huduma anayetumika katika mipangilio; msimbo wa chanzo hauna maelezo ya uthibitishaji wa kibinafsi.

Muhtasari

Lancer huweka pamoja vikao vya AI vinavyofanyika kwa wakati mmoja, matawi ya kujirudia, mrejesho wa mchakato na upangaji wa faili za uwasilishaji katika nafasi moja ya kazi ya mezani. Baada ya kukamilisha ukaguzi wa mazingira, kuanzisha msimbo wa chanzo, kuunganisha akaunti na kusanidi zana za midia kwa kufuata mafunzo haya, unaweza kuanza kuunda mtiririko wa kazi unaoweza kufuatiliwa. Kwa kuwa mradi bado uko katika hatua ya Alpha, matumizi ya uzalishaji, uoanifu wa mifumo mbalimbali, usimamizi wa Doubao na matokeo ya kunakili video vinapaswa kuthibitishwa kwa kujitegemea.