---
title: "面向 DeepSeek Harness 的转录"
description: "用 transcript.im 插件为 DeepSeek Harness 加上公开视频转录、YouTube 发现和批量导出工具。"
canonical: "https://transcript.im/zh-hans/deepseek-harness"
markdown: "https://transcript.im/zh-hans/deepseek-harness.md"
---

# 面向 DeepSeek Harness 的转录

用 transcript.im 插件为 DeepSeek Harness 加上公开视频转录、YouTube 发现和批量导出工具。

## 链接

- [标准 HTML 页面](https://transcript.im/zh-hans/deepseek-harness)
- [Markdown](https://transcript.im/zh-hans/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-hans/api)
- [Transcript MCP 服务器](/zh-hans/mcp)
- [Transcript Skills](/zh-hans/skills)
- [YouTube 字幕提取](/zh-hans/youtube-transcript)
- [YouTube 视频总结](/zh-hans/youtube-video-summarizer)
- [YouTube 字幕生成器](/zh-hans/youtube-subtitle-generator)
- [YouTube 字幕下载](/zh-hans/youtube-subtitle-downloader)
- [YouTube 频道转录](/zh-hans/youtube-channel-transcript)
- [YouTube 播放列表转录](/zh-hans/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)