運作方式.

對照原始碼實查

交給 arkiv 一個資料夾,它會逐支看畫面、聽聲音,寫成可以搜尋的文字。

從匯入到搜尋

匯入時,我的素材會被搬走或改寫嗎?

不會。整個過程在你自己的電腦上跑,匯入只讀原始檔,縮圖、逐字稿、索引另外存在專案資料夾裡的 .arkiv/。資料庫記的是相對路徑,整個專案資料夾搬到別顆碟也不會斷。

唯一會動到原始檔的是你在介面裡按「刪除素材」:檔案會先移到 .arkiv/trash,30 天內可以救回;專案資料夾以外的檔案(例如備份碟上的)只刪紀錄、不刪檔。

素材留在原處,arkiv 的產出全寫在 .arkiv/:資料庫、縮圖、向量索引、proxy。pipeline 文件 §儲存路徑

匯入之後,每一支素材會經過哪些步驟?

  1. 探測用 FFmpeg 與 ExifTool 讀出長度、格率、編碼、機型、鏡頭、GPS、Reel 名,也讀 Sony XAVC 的 sidecar XML。
  2. 轉錄Whisper large-v3-turbo。Apple Silicon 走 MLX,NVIDIA 走 CUDA。中文存檔時轉成台灣繁體。
  3. 抽幀60 秒以下平均抽,60 秒以上用場景偵測抽換景的那幾格。
  4. 看畫面視覺模型(預設 qwen2.5vl:7b,經 Ollama)逐格寫描述、標籤與評分。
  5. 建索引描述、逐字稿、標籤一起轉成向量(bge-m3),存進本機的 ChromaDB。

模型名稱是預設值,可用環境變數換掉。config.py

沒有人講話的空景,要怎麼搜?

靠「看畫面」那一步。視覺模型看的是畫面本身,所以一支只有風聲的空景,也會有「黃昏、海邊、逆光、遠景」這類描述可以搜。逐字稿那一欄會老實寫「無語音」,不會硬掰出字幕。

arkiv 自己跑過的庫:1,506 支裡有 1,161 支是無對白 B-roll。

Whisper 會在沒聲音的地方亂寫字幕,這個怎麼處理?

這是 Whisper 最常見的毛病:靜音段被它「聽」成一句謝謝收看。arkiv 疊了四層擋:先用 VAD 把沒有人聲的段落剪掉,再看模型自己回報的「這段沒有語音」機率,接著濾掉空白與重複句,最後用本機語言模型校正。

四層防護的設計文件

能不能從記憶卡開始就交給它?

可以。DIT 轉存會同時拷到多個目的地,每一個檔都做 hash 比對,拷到一半中斷可以接著跑,結束時每個目的地各留一份 ASC MHL v2 校驗清單。它從不刪除來源卡。

校驗清單為 ASC MHL v2 格式(urn:ASC:MHL:v2.0),可選 xxh3/md5/sha1/sha256/c4。

接進你的工作流程

DaVinci Resolve 外掛能做什麼?

不離開 Resolve,就能搜 arkiv 的素材庫。在外掛視窗裡用口語搜尋,勾選結果一鍵匯入目前專案的 Media Pool:

  • 自動分 bin:依攝影機/來源資料夾在 Master 底下建好 bin,多機拍攝不會混在一起。
  • 評等變顏色:GOOD 綠、REV 黃、N·G 橘,匯入時直接套成 clip color。
  • 場景變標記:視覺模型寫的場景描述,可以加成時間軸上片段的 marker,依時間軸的格率換算位置。
  • 相機資訊:機型、鏡頭、ISO、快門、光圈、GPS、拍攝時間匯出成 CSV,用 Resolve 的「從 CSV 匯入詮釋資料」一次帶進去。

Resolve 裡從「工作區 → 腳本」開啟。macOS 需安裝 python.org 的 Python 3.10(Resolve 不認 Homebrew 裝的 Python)。README:DaVinci Resolve Plugin

匯出到剪輯軟體,時間碼對得上嗎?

對得上,用的是攝影機本身的時間碼。匯入時 arkiv 會讀出每支素材的起始時間碼(攝影機錄下的那個,不一定從 00:00:00:00 開始),匯出 EDL、FCPXML 時,來源時間碼=起始時間碼+你標的 IN 點,剪輯軟體 relink 回原始檔時會落在同一格。

  • 每支用自己的格率算:29.97、59.94 自動用 drop-frame,其他用 non-drop。
  • 混格率會提醒:同一份 EDL 裡素材格率不一致時,檔頭會加註解提醒,因為整條時間軸只能用一個格率。
  • Reel 名稱:優先用相機寫的 ReelName,沒有就用檔名,符合 CMX3600 的 8 字元限制。
  • IN/OUT 貼齊格邊界:在 arkiv 裡標的點本來就是整格,不會落在兩格中間。

匯出格式:EDL(CMX3600,DF/NDF)、FCPXML 1.8、SRT、VTT、TXT。EDL 錄製時間碼從 01:00:00:00 起算。

MCP 是什麼?AI 助手能拿到什麼?

MCP 讓 Claude 這類 AI 助手直接查你的素材庫。例如問它「上週拍的訪談裡,誰講到產品價格」,它會自己去搜、讀逐字稿、找到時間點回答你。

它拿到的是 arkiv 在本機整理出來的 IR 層(把影片轉成文字的中介層):場景描述、逐字稿與時間碼、標籤、檔名、相機資訊。影片和圖檔本身不經過 MCP。所有工具都是唯讀的,不能新增、修改或刪除任何東西。

預設只在本機(stdio);要讓區網裡別台電腦連,另有 HTTP 版本,需要 token。

7 個唯讀工具:search_media・get_media・get_scenes・get_transcript・list_recent・library_stats・list_tags。常見問答:為什麼主打離線還要串 MCP

這頁有沒有回答到你的問題?