Tumia CDAF Kuwapa Mawakala wa AI Muktadha wa Video wa Haraka na Uliothibitishwa

CDAF Inafanya Nini

CDAF, kifupi cha Cached Descriptive Asset Files, ni umbizo huria la sidecar kwa video. Huhifadhi maelezo ya maandishi wazi yenye mihuri ya muda kando ya video kwa kutumia jina-msingi lilelile. Kwa mfano, sunset-drone.mp4 huambatanishwa na sunset-drone.cdaf.

Lengo ni kueleza video mara moja na kutumia tena maelezo hayo katika kazi za baadaye za AI. Badala ya kutuma video hiyo hiyo kupitia modeli ya uelewaji wa video kwa kila swali, wakala anaweza kuthibitisha na kusoma faili ndogo zaidi ya CDAF.

footage/
sunset-drone.mp4
sunset-drone.cdaf

Video ya awali hubaki bila kubadilishwa na inaweza kuchezwa na programu za kawaida za video. Sidecar ni maandishi ya UTF-8 yenye kichwa kidogo cha metadata kinachofuatwa na maelezo ya Markdown yaliyoboreshwa kwa modeli za lugha.

Kwa Nini Sidecar Ni Salama Kutumika Tena

Kichwa cha CDAF huhifadhi heshi kamili ya SHA-256 na ukubwa wa video kwa baiti. Zana zinazofuata vipimo hutumia thamani hizi kubaini kama maelezo bado ni halali. Video ikibadilika, sidecar huwa ya zamani na haipaswi kutumiwa.

--- CDAF/1.0
video: sunset-drone.mp4
sha256: 4a7d1ed4…
bytes: 48211394
duration: 00:00:31.500
generator: gemini-2.5-flash
created: 2026-08-26T14:03:12Z
---

## Muhtasari
A 31-second aerial drone clip of a coastal highway at golden hour…

## Sehemu
[00:00.0-00:05.2] Wide aerial establishing shot…
[00:05.2-00:12.8] The drone pushes in and descends…

## Manukuu
(no speech)

## Maandishi Kwenye Skrini
(none)

## Lebo
drone, aerial, coastal highway, golden hour, sunset

Sehemu ya mwili inaweza kutoa muhtasari, sehemu zenye mihuri ya muda, manukuu, maandishi yaliyo kwenye skrini na lebo. Tazama maelezo ya CDAF 1.0 ya mradi kwa umbizo rasmi, maana za uhalali wa wakati, kanuni za matoleo na sarufi ya sehemu.

Sifa Muhimu

• Matumizi tena yaliyothibitishwa: Metadata ya SHA-256 na ukubwa kwa baiti huunganisha sidecar na video halisi inayoelezwa.
• Umbizo la maandishi linalosomeka: Mawakala wanaweza kutumia, kutafuta na kutumia tena maelezo bila kusimbua video tena.
• Sehemu zenye mihuri ya muda: Masafa ya sehemu yanaweza kusaidia kuchagua klipu na kuunda orodha ya vipande.
• Msingi usio na utegemezi: Uchanganuzi, usawazishaji, uheshaji, ukaguzi wa uhalali na uchimbaji wa sehemu hutumia maktaba ya kawaida ya Python.
• CLI inayolenga makundi: Zana ya mstari wa amri inaweza kuzalisha sidecar kwa saraka na kuruka zile ambazo bado ni halali.
• Wasifu nyingi za maelezo: Uzalishaji unaunga mkono matokeo ya brief, standard na rich.
• Ujuzi wa wakala: Ujuzi uliowekwa tayari huwafundisha mawakala wa usimbaji kuangalia sidecar zilizothibitishwa kabla ya kuchanganua video.
• Uzalishaji wa ndani kwa hiari: Hifadhi inajumuisha mtoa huduma wa --local wa kuzalisha kwa modeli ya ndani bila ufunguo wa API.
• Uchunguzi wa hiari: CDAF inaweza kutumia ffprobe kupata metadata ya muda, mwonekano na kasi ya fremu, huku ikiendelea kufanya kazi kwa njia salama ffprobe isipopatikana.

Sakinisha Ujuzi wa Wakala

Njia ya haraka zaidi ya kumfundisha wakala wa usimbaji anayeungwa mkono mtiririko wa kazi unaotanguliza sidecar ni:

npx cdaf-skill

Kwa chaguo-msingi, hii husakinisha ujuzi kwenye ~/.claude/skills/cdaf, na kuufanya upatikane katika miradi yote. Njia nyingine zinazoungwa mkono za usakinishaji ni:

npx cdaf-skill --project
npx cdaf-skill --dir <path>
npx cdaf-skill --print

• --project husakinisha kwenye ./.claude/skills/cdaf kwa mradi wa sasa.
• --dir husakinisha kwenye saraka iliyochaguliwa.
• --print huandika ujuzi kwenye matokeo ya kawaida ili uweze kubandikwa kwenye mfumo mwingine wa wakala.

Kuendesha tena kisakinishi ni salama. Ujuzi ambao haujabadilika huachwa ulivyo, huku ujuzi uliobadilishwa ukiwekewa nakala rudufu kama SKILL.md.bak kabla ya kubadilishwa.

Kabla ya kuchanganua faili ya video, tafuta faili ya .cdaf yenye jina-msingi lilelile. Ikiwa thamani za bytes na sha256 kwenye kichwa zinalingana na video, isome badala ya kuchakata video.

Sakinisha CLI ya CDAF

CLI ya Python inahitaji Python 3.10 au mpya zaidi. README ya sasa huisakinisha moja kwa moja kutoka kwenye hifadhi kwa sababu toleo la PyPI bado liko kwenye mpango wa baadaye.

pip install "cdaf[generate] @ git+https://github.com/UditAkhourii/cdaf.git#subdirectory=cli"

Ikiwa unafanya kazi kutoka kwenye hifadhi iliyokloniwa, sakinisha CLI kutoka kwenye saraka ya ndani ya cli:

pip install ./cli[generate]

Utekelezaji wa jenereta hutumia Gemini Files API. Pata ufunguo wa Gemini API kutoka Google AI Studio, kisha uuweke kwenye mazingira yako.

macOS na Linux

export GEMINI_API_KEY=your-key

Windows PowerShell

$env:GEMINI_API_KEY="your-key"

Video zako huchakatwa kupitia ufunguo wako wa API. Amri zinazosoma au kuthibitisha sidecar zilizopo pekee hazihitaji ufunguo wa API wala utegemezi wa jenereta.

Zalisha Sidecar

Weka video moja au zaidi kwenye saraka na uendeshe cdaf generate dhidi ya saraka hiyo:

cdaf generate ./footage

CDAF hueleza video na kuunda sidecar zenye majina-msingi yanayolingana. Ikiendeshwa tena, uzalishaji huruka video ambazo sidecar zake bado ni halali.

Chagua Wasifu wa Maelezo

Tumia --detail kuchagua mojawapo ya wasifu watatu wa uzalishaji waliowekwa kwenye nyaraka:

cdaf generate ./footage --detail brief
cdaf generate ./footage --detail standard
cdaf generate ./footage --detail rich

Chagua profaili kulingana na kiasi cha muktadha wa maelezo kinachohitajika na kazi za baadaye. Unaweza pia kuchagua modeli ya Gemini kwa --model au kuomba utengenezaji upya kwa --force.

cdaf generate ./footage --model <gemini-model>
cdaf generate ./footage --force

Angalia Hali ya Maktaba ya Video

Tumia amri ya hali kuainisha faili za sidecar kama FRESH, STALE, au MISSING:

cdaf status ./footage

• FRESH: Sidecar inalingana na video ya sasa.
• STALE: Sidecar ipo, lakini utambulisho wake uliorekodiwa haulingani tena na video.
• MISSING: Hakuna sidecar ya CDAF inayolingana inayopatikana.

Amri hii haihitaji ufunguo wa API wala vitegemezi vya utengenezaji, hivyo inafaa kwa ukaguzi mwepesi wa maktaba zilizopo za rasilimali.

Soma Maelezo Yaliyothibitishwa

Tumia cdaf read unapotaka mwili wa sidecar kwa ajili ya wakala, hati, au prompt:

cdaf read ./footage/sunset-drone.mp4

Amri hii inathibitisha heshi kabla ya kuchapisha maelezo. Inakataa kuchapisha sidecar iliyopitwa na wakati, hivyo kuweka kanuni ya uhalali wa sasa ndani ya zana badala ya kutegemea maagizo ya wakala pekee.

Thibitisha Sidecar katika Uendeshaji wa Kiotomatiki

Amri ya uthibitishaji hutoka kwa mafanikio tu wakati sidecar inayolingana ina muundo sahihi na bado ni halali:

cdaf validate ./footage/clip.mp4

Kwa kuwa amri hii hutoka ikiwa na hali 0 tu kwa sidecar halali na iliyo sasa, inaweza kutumika katika hati au mtiririko wa kazi wa continuous integration. Uthibitishaji hauhitaji ufunguo wa API wala vitegemezi vya ziada vya jenereta.

Tumia CDAF kutoka Python

API ya msingi ya Python huruhusu programu kutafuta, kupakia, na kuthibitisha sidecar kabla ya kupeleka mwili wake kwa modeli ya lugha.

from cdaf import load, check_freshness, sidecar_path_for

video = "footage/sunset-drone.mp4"
sidecar = load(sidecar_path_for(video))

if check_freshness(video, sidecar) == "fresh":
    context_for_llm = sidecar.body

Mfumo huu ndio ujumuishaji muhimu wa CDAF: bainisha njia inayotarajiwa ya sidecar, changanua faili, thibitisha uhalali wake dhidi ya video, na tumia sidecar.body tu wakati matokeo ni fresh.

Msingi wa kifurushi pia unaunga mkono usimbaji wa data, ukokotoaji wa SHA-256 kwa mafungu, na uchimbaji wa sehemu. Shughuli hizi hutumia maktaba ya kawaida pekee. Msimbo mahususi wa jenereta huingizwa tu wakati utengenezaji unapoombwa.

Jenga Mtiririko wa Wakala Unaotanguliza Sidecar

1. Pokea njia ya video ikiwa sehemu ya kazi ya uhariri, utafutaji, au kujibu maswali.
2. Tafuta faili ya .cdaf yenye jina la msingi linalofanana.
3. Angalia uhalali wa sidecar dhidi ya video ya sasa.
4. Ikiwa ni halali, soma maandishi yake badala ya kuendesha uchanganuzi mwingine wa uelewaji wa video.
5. Ikiwa imepitwa na wakati au haipo, itengeneze upya kabla ya kutegemea yaliyomo.
6. Tumia muhtasari, sehemu, manukuu, maandishi yanayoonekana kwenye skrini, na lebo kama muktadha wa kazi ya baadaye.

Ujuzi wa wakala uliowekwa kwenye kifurushi unapendekeza ukaguzi mwepesi wa ukubwa wakati wa uchunguzi na ukaguzi kamili wa heshi kwa maamuzi yenye madhara makubwa. Programu zinapaswa kutumia kiwango cha uthibitishaji kinachofaa kwa operesheni, huku zikihifadhi kanuni kuu kwamba maelezo yaliyopitwa na wakati hayapaswi kuaminiwa.

Vidokezo vya Kina

Tafuta Mikusanyo ya Video kama Maandishi

Baada ya video kuwa na sidecar, mawakala na zana za mstari wa amri zinaweza kutafuta faili za .cdaf badala ya kufungua kila video. Lebo na maelezo zinaweza kubadilisha maombi kama picha za machweo ya pwani zisizo na watu kuwa urejeshaji wa maandishi katika maktaba ya rasilimali.

Badilisha Sehemu Kuwa Maamuzi ya Uhariri

Mistari yenye mihuri ya muda kama [00:05.2-00:12.8] hutoa vipindi ambavyo vihariri vya kiprogramu vinaweza kubadilisha kuwa klipu au mfuatano. README inataja Remotion, HyperFrames, na zana za kubadilisha prompt kuwa uhariri kama mitiririko ya kazi inayoweza kunufaika na muundo huu.

Tumia Upya Muda wa Manukuu

Hotuba inapokuwepo, sehemu ya Transcript hupatanisha mazungumzo na ratiba ya muda. Mtiririko wa kazi wa uhariri unaweza kutumia tena taarifa hiyo kwa manukuu na ulandanishi wa sauti badala ya kufanya uchanganuzi mwingine wa uelewaji.

Tumia Metadata ya Hiari ya ffprobe

Ikiwa ffprobe inapatikana, kipengele cha probe cha CDAF kinaweza kukusanya metadata ya muda, mwonekano, na fremu kwa sekunde. Injini huendelea vizuri ffprobe isipokuwepo, hivyo ujumuishaji huu wa hiari hauzuii shughuli za msingi za sidecar.

Fikiria Utengenezaji wa Kienyeji

Kifaa hiki kinajumuisha mtoa huduma wa kienyeji anayefikiwa kupitia --local. Kimekusudiwa kwa utengenezaji kwa kutumia modeli ya kienyeji wakati ufunguo wa API haupaswi kutumika. Angalia utekelezaji wa mtoa huduma wa kienyeji katika hazina kwa usanidi wa modeli za kienyeji unaotumika kwa sasa.

Weka Backendi Tofauti na Muundo

CDAF yenyewe haifungamani na modeli. Gemini ndiye backendi ya jenereta ya mbali iliyojumuishwa, huku backendi nyingine za modeli za lugha ya video zikiweza kufanya kazi nyuma ya aina hiyo hiyo ya Sidecar. Backendi za ziada za Claude, GPT, na VLM za kienyeji zimeorodheshwa kwenye ramani ya maendeleo na hazipaswi kudhaniwa kuwa zinapatikana bado.

Rudia Kipimo cha Utendaji

Hazina hii inajumuisha kipimo cha utendaji chenye malengo kinachounda video kutoka kwenye mapishi yaliyoandikwa kwa kutumia ffmpeg. Endesha hatua zake kwa mpangilio:

python benchmarks/bench.py make
python benchmarks/bench.py run
python benchmarks/bench.py report

Hatua ya kwanza inahitaji ffmpeg, ya pili inahitaji GEMINI_API_KEY, na hatua ya mwisho huandika benchmarks/RESULTS.md. Katika jaribio lililoripotiwa la maswali 20, majibu ya sidecar yalipata majibu 20 kati ya 20 kwa usahihi, ikilinganishwa na 19 kati ya 20 kwa video ya moja kwa moja, huku yakitumia wastani wa tokeni 303 badala ya 3,066 za prompt kwa kila swali. Haya ni matokeo ya kipimo kutoka kwenye hifadhi ya msimbo na yanaweza kutofautiana kulingana na video, miundo, prompt na mazingira.

Vikwazo vya Sasa na Ramani ya Maendeleo

README inabainisha vipengele kadhaa kuwa kazi za baadaye badala ya utendaji wa sasa: toleo la PyPI, seva ya MCP, kigeuzi kinachopangishwa, mifumo ya ziada ya jenereta, uhamishaji wa injini kwenda Node au TypeScript, upanuzi wa kipimo cha video halisi, na sidecar zilizotiwa saini. Tumia usakinishaji wa Python unaotegemea Git na CLI iliyopo kama ilivyoandikwa leo, badala ya kudhani vipengele hivyo vya ramani ya maendeleo vinapatikana.

Hitimisho

CDAF hubadilisha uchanganuzi unaorudiwa wa video kuwa mtiririko wa kuthibitisha na kusoma. Tengeneza sidecar mara moja, ihifadhi kando ya video chanzo, ithibitishe kila wakati kipengee kinapotumiwa, kisha uwape mawakala wa chini mwili wake. Hashi za muundo huzuia matumizi ya kiajali baada ya kuhaririwa, huku muhtasari wake, mihuri ya muda, manukuu, maandishi na lebo zikifanya maktaba za video ziwe rahisi kutafutwa na kujiendesha.

CDAF inapatikana chini ya Leseni ya MIT. Msimbo chanzo, vipimo, mifano, maelezo ya vipimo na ujuzi wa wakala vinapatikana katika hifadhi ya CDAF kwenye GitHub.