DeepSeek Harness 專用原生工具
DeepSeek Harness 逐字稿
把影片背後的原始文字交給你的 DeepSeek Harness 代理程式。transcript.im 外掛把逐字稿取得、YouTube 探索和批次工具直接加入你的 Harness 設定檔，讓代理程式在寫作、比較或回答之前先蒐集證據。
- 11 個工具直接註冊到 DeepSeek Harness
- 公開影片逐字稿，可選時間戳記
- YouTube 搜尋、頻道、播放清單與字幕探索
- 為代理程式工作流程提供結構化結果
代理程式隨時可用的影片來源
DeepSeek Harness 逐字稿透過原生外掛把代理程式連接到 transcript.im API。它提供代理程式可呼叫的工具，而不是讓你在瀏覽器和對話之間來回複製文字。
從連結到可用的來源
把來源蒐集和下一步研究放在同一個 DeepSeek Harness 工作階段裡。
1. 選擇來源
給代理程式一個公開影片連結，或讓它依特定主題搜尋 YouTube。處理頻道和播放清單時，先讓它列出相關影片，再決定要處理哪些來源。YouTube 探索工具涵蓋搜尋、頻道、播放清單和字幕中繼資料。
2. 取得逐字稿
先用 get_transcript_info 檢視可用語言，再用 get_transcript 取得來源。下一步需要引用時，要求帶上時間戳記和中繼資料。請求可以指定語言優先順序，並透過 API 要求語音辨識。
3. 從結果繼續工作
讓代理程式從回傳的文字中擷取引用、比較論點或整理筆記。把來源連結和時間戳記與結果放在一起。面對一個集合時，建立批次、查看狀態，然後匯出已完成的結果。
你可以打造什麼
同一個外掛既能處理單一來源，也能支撐可重複的集合工作流程。
來源可追溯的研究
圍繞一個具體問題蒐集逐字稿，讓代理程式把直接引用和詮釋分開。把來源連結和時間戳記放在每條論述旁邊，這樣在依賴結果之前可以先核對原始錄音。
比較一個頻道或播放清單
列出 YouTube 頻道或播放清單裡的影片，選出一組相關的，然後提交批次。處理完成後，比較結果之間反覆出現的主題或前後變化的說法，而不是把單一片段當成全部故事。
用錄音準備內容
把逐字稿交給代理程式，作為筆記、大綱或初稿的素材。對照錄音核對人名、引用和脈絡。寫作由代理程式完成，transcript.im 提供它據以工作的文字。
自動化逐字稿蒐集
在更大的工作流程裡使用正規的 JSON 結果。匯出前查看批次狀態，繼續蒐集來源時保留分頁權杖，用同一套工具查看用量，而不是另外維護一個探索用戶端。
十一個工具，一個外掛
原生外掛提供的能力與 transcript.im 開發者工作流程使用的 REST 能力一致。逐字稿取得支援 YouTube、TikTok、Instagram、LinkedIn 和 Twitter/X 的公開影片連結；探索功能僅限 YouTube。
| 工作 | 工具 | 結果 |
|---|---|---|
| 讀取一部影片 | get_transcript, get_transcript_info | 逐字稿文字或分段、中繼資料，以及可用語言資訊。 |
| 處理一個集合 | create_batch, get_batch, export_batch | 可追蹤的批次，以及可匯出的已完成結果。 |
| 尋找 YouTube 來源 | search_video, get_channel | 用來挑選來源的搜尋結果和頻道資訊。 |
| 探索 YouTube 集合 | list_channel_video, list_playlist_item, list_caption | 影片清單、播放清單項目、字幕中繼資料，以及可用時的分頁權杖。list_caption 讀取 YouTube 公開的字幕軌和 transcript.im 能提供的字幕文字，不會啟動語音辨識。 |
| 查看用量 | get_usage | 與你的憑證相關的 API 用量資訊。 |
連接你的 Harness 設定檔
外掛把 transcript.im 的工具註冊到 DeepSeek Harness 設定檔裡，並用你 transcript.im 帳戶的開發者 API 金鑰呼叫 REST API。
dsh plugin --profile research add ./transcript-im-dsh-plugin-0.1.0.tgzexport TRANSCRIPT_API_KEY="YOUR_TRANSCRIPT_API_KEY"
dsh --profile research選擇合適的連接方式
選擇適合你代理程式現有執行環境的連接方式。原生 Harness 外掛不需要 transcript.im MCP 伺服器作為中間步驟。
| 連接方式 | 何時選擇 | 如何配合 |
|---|---|---|
| DeepSeek Harness 外掛 | 你在 DeepSeek Harness 裡執行代理程式。 | 在 Harness 設定檔裡註冊原生工具，並呼叫 REST API。 |
| Transcript MCP 伺服器 | 你的用戶端透過 MCP 連接工具。 | 透過 MCP 協定提供逐字稿和探索操作。 |
| Transcript Skills | 你的執行環境從技能包載入指示。 | 為代理程式提供工作指引和工作流程。 |
| Transcript API | 你自己控制應用程式或指令碼。 | 讓你的程式碼直接呼叫 REST 端點。 |
保留原始結果
模型脈絡和儲存的來源資料用途不同。每一步都要用對輸出。
- 顯示給模型的長逐字稿文字由 maxTranscriptChars 限制，預設 20,000 個字元。截斷標記會告訴代理程式它只拿到節錄；正規的 JSON 結果保持完整。
- 文字批次匯出可以內嵌呈現。ZIP 匯出是二進位，所以面向模型的回應只描述它，而不會把壓縮檔塞進對話。
- YouTube 探索回應在 API 提供 nextPageToken 時會保留它。把該權杖傳進下一次請求以繼續蒐集，而不是重複第一頁。
- 外掛預設把請求送到 https://api.transcript.im。baseUrl、timeoutMs 和 maxTranscriptChars 都可以設定；預設請求逾時為 30,000 毫秒。
- 來源可用性和逐字稿品質取決於影片。讓代理程式明確回報取得錯誤和缺少的內容，並對照原始錄音核對引用。
相關
DeepSeek Harness 常見問題
什麼是 DeepSeek Harness 逐字稿？
DeepSeek Harness 逐字稿是 transcript.im 外掛，提供原生的影片逐字稿和 YouTube 探索工具。它在 Harness 設定檔裡註冊 11 個工具，並呼叫 transcript.im REST API。
如何把 transcript.im 外掛連接到 DeepSeek Harness？
把外掛套件安裝到你的代理程式使用的 Harness 設定檔裡，在 transcript.im 帳戶裡建立開發者 API 金鑰，再透過 TRANSCRIPT_API_KEY 或外掛設定把它交給 Harness 行程。連接一節展示了這兩個步驟。
Harness 外掛能讀取哪些影片平台？
逐字稿取得工具接受 YouTube、TikTok、Instagram、LinkedIn 和 Twitter/X 的公開影片連結。搜尋、頻道、播放清單和字幕中繼資料工具以 YouTube 為對象。
DeepSeek Harness 外掛需要 MCP 伺服器嗎？
DeepSeek Harness 外掛直接呼叫 REST API，所以這種連接不需要 transcript.im MCP 伺服器。當你的用戶端比較習慣 MCP 工具時，再使用 MCP 伺服器。
API 金鑰如何傳給外掛？
除非外掛設定裡設定了明確的 apiKey，否則外掛會從行程環境讀取 TRANSCRIPT_API_KEY。設定值優先；憑證應放在該環境或設定裡，而不是提示裡。
Harness 外掛能回傳時間戳記和語言資訊嗎？
用 get_transcript_info 檢視可用的逐字稿語言，並在取得逐字稿時設定 includeTimestamp。language 參數接受一個優先順序清單，其中可以包含 API 支援的語音辨識偏好。
DeepSeek Harness 能把播放清單當作批次處理嗎？
外掛提供播放清單探索，以及 create_batch、get_batch 和 export_batch。讓代理程式先確定來源集合、建立批次、查看狀態，再匯出已完成的結果，而不是把提交當成完成。
外掛會自己摘要或翻譯影片嗎？
外掛提供取得、探索、批次和用量工具。你的代理程式可以用回傳的逐字稿做摘要或翻譯，但外掛不會註冊個別的 AI 摘要或翻譯工具。
為什麼長逐字稿會出現截斷標記？
外掛用 maxTranscriptChars 限制放進模型脈絡的逐字稿文字。標記表示只是節錄，正規的 JSON 結果保持完整；代理程式不應聲稱自己讀過被省略的內容。
Harness 裡出現 missing_api_key 怎麼辦？
檢查執行所選設定檔的行程是否有 TRANSCRIPT_API_KEY 或已設定的 apiKey。如果存在設定值，只改環境變數並不會取代它。
可以把外掛指向別的 API 來源嗎？
當你的部署需要不同於 transcript.im 的 API 來源時，在外掛設定裡設定 baseUrl。預設是 https://api.transcript.im；請讓憑證與你設定的目標相符。
它和 Transcript Skills 有什麼不同？
Transcript Skills 描述相容代理程式可以遵循的工作和工作流程。DeepSeek Harness 外掛在執行環境裡註冊可呼叫的工具；當你的代理程式需要原生 Harness 連接時選它。