---
title: "DeepSeek Harness 逐字稿"
description: "用 transcript.im 外掛為 DeepSeek Harness 加上公開影片逐字稿、YouTube 探索和批次匯出工具。"
canonical: "https://transcript.im/zh-hant/deepseek-harness"
markdown: "https://transcript.im/zh-hant/deepseek-harness.md"
---

# DeepSeek Harness 逐字稿

用 transcript.im 外掛為 DeepSeek Harness 加上公開影片逐字稿、YouTube 探索和批次匯出工具。

## 鏈接

- [標準 HTML 頁面](https://transcript.im/zh-hant/deepseek-harness)
- [Markdown](https://transcript.im/zh-hant/deepseek-harness.md)


把影片背後的原始文字交給你的 DeepSeek Harness 代理程式。transcript.im 外掛把逐字稿取得、YouTube 探索和批次工具直接加入你的 Harness 設定檔，讓代理程式在寫作、比較或回答之前先蒐集證據。

- 11 個工具直接註冊到 DeepSeek Harness
- 公開影片逐字稿，可選時間戳記
- YouTube 搜尋、頻道、播放清單與字幕探索
- 為代理程式工作流程提供結構化結果

## 代理程式隨時可用的影片來源

DeepSeek Harness 逐字稿透過原生外掛把代理程式連接到 transcript.im API。它提供代理程式可呼叫的工具，而不是讓你在瀏覽器和對話之間來回複製文字。

從一個公開影片連結開始，或在 YouTube 上探索來源。外掛可以檢視逐字稿中繼資料、取得文字，並回傳代理程式下一步能用的結構化資料。時間戳記選項能把一句引用或一個觀察對應回原始位置。影片說明不能取代逐字稿：取得真正說出口的內容，代理程式才有能引用的材料。

外掛提供的是取得和探索工具。結果怎麼用由你的代理程式決定，無論是整理研究筆記、比較多場演講，還是列出新文章的大綱。摘要和翻譯提示在你的代理程式工作流程裡執行，並不是這個外掛提供的獨立 AI 工具。

## 從連結到可用的來源

把來源蒐集和下一步研究放在同一個 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。

- [建立開發者 API 金鑰](/app/account/api-keys)
- [閱讀 API 文件](/docs)

把外掛安裝到你的代理程式使用的設定檔裡。範例從你機器上的檔案加入外掛套件，不會從 transcript.im 下載任何內容；把設定檔名稱和路徑換成你自己的值。

### 把外掛安裝到 Harness 設定檔

```
dsh plugin --profile research add ./transcript-im-dsh-plugin-0.1.0.tgz
```

在你的帳戶裡建立 transcript.im 開發者 API 金鑰，並讓啟動 Harness 的行程能取得它。用環境變數可以避免把憑證寫進對話。外掛設定裡明確的 apiKey 優先於環境變數，所以如果你打算用環境變數，先刪掉過時的設定值。

### 設定憑證並啟動你的設定檔

```
export TRANSCRIPT_API_KEY="YOUR_TRANSCRIPT_API_KEY"
dsh --profile research
```

先拿一部公開影片，讓代理程式檢視它的逐字稿資訊。這樣能在打造更長的工作流程之前檢查憑證和來源。如果外掛回報 missing_api_key，請檢查實際執行 Harness 的行程環境，而不只是另一個終端機視窗。

## 選擇合適的連接方式

選擇適合你代理程式現有執行環境的連接方式。原生 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 毫秒。
- 來源可用性和逐字稿品質取決於影片。讓代理程式明確回報取得錯誤和缺少的內容，並對照原始錄音核對引用。

## 相關

- [API 文件](/docs)
- [Transcript REST API](/zh-hant/api)
- [Transcript MCP 伺服器](/zh-hant/mcp)
- [Transcript Skills](/zh-hant/skills)
- [YouTube 逐字稿](/zh-hant/youtube-transcript)
- [YouTube 影片摘要](/zh-hant/youtube-video-summarizer)
- [YouTube 字幕產生器](/zh-hant/youtube-subtitle-generator)
- [YouTube 字幕下載](/zh-hant/youtube-subtitle-downloader)
- [YouTube 頻道轉錄](/zh-hant/youtube-channel-transcript)
- [YouTube 播放列表轉錄](/zh-hant/youtube-playlist-transcript)
## 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 連接時選它。

## 把來源交給你的 Harness 代理程式

建立開發者 API 金鑰，把影片逐字稿帶進你的下一個研究工作流程。

- [建立 API 金鑰](/app/account/api-keys)
- [閱讀 API 文件](/docs)