前言¶
在 DeepSeek Harness（DSH）裏做視頻相關任務時，常見做法是整段餵給模型，或按固定間隔抽幀。做廣告、產品動畫或分鏡參考時，下游往往要的是「第 2 秒這一幀、第 6 秒這一幀，按順序寫進 brief」，而不是一堆未篩選的截圖。自己對着播放器記時間碼、截圖、拼表，步驟分散且容易錯。
dsh-take-sheet 是社區插件 dingchenhui0618-arch/dsh-take-sheet，在 DSH 對話視圖裏增加「參考幀」頁籤：本地解碼、按鏡頭切分、人工勾選後導出帶時間碼的清單和一張聯繫表。視頻與導出物只在本機處理，依賴 ffmpeg，不上傳網絡。
這是什麼¶
維護者 dingchenhui0618-arch，在 SkillHub 目錄中歸類爲工作流。插件版本 0.1.0（見倉庫 package.json），要求 DSH >=0.2.1-rc.2 且 <0.3.0，許可證 MIT。
一句話：把一段參考視頻按鏡頭切開，每鏡抽一幀縮略圖，人在環勾選後，導出 frames.csv、shots.json、逐幀 JPEG 和帶時間碼標籤的聯繫表，供人做參考板與交付，重心不在給模型補上下文。
核心功能¶
下面介紹 README 中已說明、且與實現一致的能力。
按鏡頭切，而不是固定間隔¶
使用 ffmpeg 的 scdet 做鏡頭檢測（作者在說明裏對比過：深色、低對比產品渲染片上 scene 分數難定閾值，scdet 在同素材上更易區分硬切與普通幀）。切點靈敏度可選「敏感 / 標準 / 穩健」；單次掃描可設最多鏡頭數（默認 60，上限 200）。切點過多時會按時間均勻保留，並在面板上說明丟棄數量。
人工勾選與時間碼¶
每個鏡頭一張 16:9 縮略圖，卡片或複選框切換保留與否；支持全選 / 全不選，未選中卡片變暗。縮略圖上的時間碼（如 00:00:02.000）與導出文件名、CSV 中字段一致，表示該幀自身的時間點，而非近似的鏡頭起點。
聯繫表與導出物¶
聯繫表按接近 3:2 的網格排版，黑底，格左上角標 #01 00:00:00.200 等形式。字體優先 Consolas / Segoe UI / Arial / DejaVu / Liberation；都找不到時退化爲無標籤版本，不導致導出失敗。
每次導出寫入 $DSH_HOME/take-sheet/jobs/<job-id>/export/，結構如下：
export/
frames.csv
shots.json
contact-sheet.jpg
frames/
01_00-00-00.200.jpg
02_00-00-02.000.jpg
...
frames.csv 爲 UTF-8 BOM、CRLF，便於 Excel 打開；文件名裏時間碼用 - 代替 : 以兼容 Windows，CSV 與畫面標籤仍爲 HH:MM:SS.mmm。shots.json 另含源視頻 probe 信息、掃描參數、鏡頭起止與聯繫表尺寸，便於腳本消費。
本機與邊界¶
只處理本地文件的絕對路徑，不支持 URL 與流媒體。無音頻分析、無轉寫；鏡頭切分只看畫面。不發起網絡請求；配置不讀 ~/.dsh 以外路徑（README 表述）。同一 job 再次導出會先清空 export/ 再寫入。
安裝與啓用¶
需要 ffmpeg 5.1+（含 ffprobe）。插件不代爲安裝，但會在下列位置自動查找：環境變量 DSH_FFMPEG_PATH / FFMPEG_PATH；Windows 的 WinGet Links（如 winget install Gyan.FFmpeg 後）、C:\ffmpeg\bin、Chocolatey、PATH；macOS Homebrew；Linux /usr/bin。運行中才裝好 ffmpeg 時，面板會提示缺失，裝好後點「重新檢測」即可，無需重啓 DSH。
安裝到某個 DSH profile 時，使用資料中的示例命令（路徑改爲你本機插件目錄）：
dsh plugin --profile desktop add D:\Projects\dsh-take-sheet
倉庫已提交 lib/，檢出後無需構建。裝好後刷新 Web GUI，在任意會話頁籤中打開「參考幀」。
插件以當前 DSH 進程權限運行；安裝前應自行查看 GitHub 源碼 與 MIT 許可證，確認符合你的環境與合規要求。
典型用法¶
- 在「參考幀」頁籤粘貼視頻的絕對路徑（例如
D:\refs\clip.mp4）。 - 選擇靈敏度與最多鏡頭數，點擊「掃描」。
- 掃描完成後逐鏡查看縮略圖，點擊卡片或複選框保留 / 去掉不需要的鏡。
- 點擊「導出參考幀清單」；面板下方出現聯繫表預覽，以及 CSV、JSON、聯繫圖等下載鏈接，並顯示本機輸出目錄。
「敏感」更容易把輕微轉場算作新鏡頭；「穩健」偏硬切。默認「標準」。
適用場景與注意¶
適合：需要把參考片整理成可交付的時間碼幀清單、聯繫表，交給美術、動畫或外包 brief 的流程；與「整段給模型」或「固定間隔抽幀給 agent」的插件定位不同——本插件強調鏡頭切分 + 人在環 + 可交付文件。
限制（來自 README）：極長視頻受單次鏡頭上限約束，可能需要分段掃描；聯繫表字體缺失時僅影響標籤，不阻斷導出。
DSH 生態理念是「一切皆插件」；SkillHub 目錄頁 爲社區站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-take-sheet 把「找切點、記時間碼、抽幀、拼表」收成一條本地 ffmpeg 流程，輸出 CSV、JSON 與帶標籤聯繫表，適合把參考視頻變成人類可讀的 shot list。進一步瞭解可訪問目錄頁與倉庫：
