https://github.com/jddkcn/kcnlanzoudirectlink
用于解析蓝奏云直链及文件信息的C#原生实现类库。
https://github.com/jddkcn/kcnlanzoudirectlink
direct lanzou net nuget-package web
Last synced: 10 months ago
JSON representation
用于解析蓝奏云直链及文件信息的C#原生实现类库。
- Host: GitHub
- URL: https://github.com/jddkcn/kcnlanzoudirectlink
- Owner: JDDKCN
- License: agpl-3.0
- Created: 2024-11-15T05:33:02.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-03T13:13:22.000Z (about 1 year ago)
- Last Synced: 2025-07-17T17:24:28.441Z (11 months ago)
- Topics: direct, lanzou, net, nuget-package, web
- Language: C#
- Homepage: https://www.nuget.org/packages/KCNLanzouDirectLink/
- Size: 60.5 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# KCNLanzouDirectLink
[](https://www.nuget.org/packages/KCNLanzouDirectLink/)
[](https://www.nuget.org/packages/KCNLanzouDirectLink/)
`KCNLanzouDirectLink` 是一个用于解析蓝奏云分享链接并获取直链的 C# 原生实现类库。它提供了简单的 API 用于获取蓝奏云分享链接的直链，无需登录或第三方工具。
## 项目特点
- 支持解析蓝奏云分享直链 & 加密分享直链。
- 支持解析分享 & 加密分享链接的文件信息。
- 支持批量解析。
- 不使用curl，原生实现所有功能。
- 提供标准错误处理模式。
- 完整的实现 Demo，快速上手。
## 支持
本项目支持以下 .NET 版本：
- `.NET 6`、`.NET 7`、`.NET 8`、以及更高版本的 .NET。
## 安装
你可以通过 NuGet 包管理器安装 `KCNLanzouDirectLink` 库：
```bash
Install-Package KCNLanzouDirectLink
```
或者通过 .NET CLI：
```bash
dotnet add package KCNLanzouDirectLink
```
## 使用示例
获取普通链接的直链
```csharp
using KCNLanzouDirectLink;
class Program
{
static async Task Main(string[] args)
{
string shareUrl = "https://syxz.lanzoue.com/qwertyuiopas";
var (state, link) = await KCNLanzouLinkHelper.GetDirectLinkAsync(shareUrl);
if (state == DownloadState.Success)
{
Console.WriteLine($"直链地址: {link}");
}
else
{
Console.WriteLine($"获取直链失败，状态: {state}");
}
}
}
```
获取加密链接的直链
```csharp
using KCNLanzouDirectLink;
class Program
{
static async Task Main(string[] args)
{
string shareUrl = "https://syxz.lanzoue.com/qwertyuiopas";
string key = "your_encryption_key";
// 10 代表错误后重试次数。加密链接获取直链不稳定，推荐设置为10次。
var (state, linkEncryption) = await KCNLanzouLinkHelper.GetDirectLinkAsync(shareUrl, key, 10);
if (state == DownloadState.Success)
{
Console.WriteLine($"直链地址: {linkEncryption}");
}
else
{
Console.WriteLine($"获取直链失败，状态: {state}");
}
}
}
```
批量获取分享链接直链(支持普通/加密链接混合获取)
```csharp
using KCNLanzouDirectLink;
class Program
{
static async Task Main(string[] args)
{
var urls = new List>
{
Tuple.Create("https://syxz.lanzoue.com/qwertyuiopas", string.Empty),
Tuple.Create("https://syxz.lanzouw.com/abcdefghijkl", "your_encryption_key")
};
// 该方法泛型传参允许实现 string 及 Tuple。
var results = await KCNLanzouLinkHelper.GetDirectLinksAsync(urls);
foreach (var (url, state, link) in results)
{
if (state == DownloadState.Success)
{
Console.WriteLine($"{url} 解析直链地址: {link}");
}
else
{
Console.WriteLine($"{url} 获取直链失败，状态: {state}");
}
}
}
}
```
获取链接的文件信息
```csharp
using KCNLanzouDirectLink;
class Program
{
static async Task Main(string[] args)
{
string shareUrl = "https://syxz.lanzoue.com/qwertyuiopas";
string key = "your_encryption_key";
// true表示强制指定分享链接为加密链接类型。具体信息请查看方法重载。
var (state, fileInfo) = await KCNLanzouLinkHelper.GetFileInfoAsync(true, shareUrl, key);
if (state == DownloadState.Success)
{
string message = $"文件信息解析成功：\n" +
$"File info retrieved successfully:\n" +
$"文件名称\\File Name: {fileInfo.FileName}\n" +
$"文件大小\\File Size: {fileInfo.Size}\n" +
$"上传时间\\Upload Time: {fileInfo.UploadTime}\n" +
$"上传者\\Uploader: {fileInfo.Uploader}\n" +
$"运行平台\\Platform: {fileInfo.Platform}\n" +
$"文件描述\\Description: {fileInfo.Description}";
Console.WriteLine($"直链地址: {message}");
}
else
{
Console.WriteLine($"获取文件信息失败，状态: {state}");
}
}
}
```
枚举 `DownloadState` 说明
```csharp
public enum DownloadState
{
///
/// 操作成功完成。
///
Success,
///
/// 未提供有效的分享链接。
///
UrlNotProvided,
///
/// 无法获取网页内容。分享链接无效？
///
HtmlContentNotFound,
///
/// 无法解析加密信息。分享链接无效或密钥错误？
///
PostsignNotFound,
///
/// 无法解析中间链接。
///
IntermediateUrlNotFound,
///
/// 无法获取最终的直链地址。
///
FinalUrlNotFound,
///
/// 未知错误，操作未成功完成。
///
Error
}
```
文件信息获取结构类 `LanzouFileInfo` 说明
```csharp
public class LanzouFileInfo
{
///
/// 文件名称
///
public string? FileName { get; set; }
///
/// 上传时间
///
public string? UploadTime { get; set; }
///
/// 文件大小
///
public string? Size { get; set; }
///
/// 上传者
///
public string? Uploader { get; set; }
///
/// 运行平台
///
public string? Platform { get; set; }
///
/// 文件描述
///
public string? Description { get; set; }
}
```
## Demo
请前往Github存储库查看类库Demo：[https://github.com/JDDKCN/KCNLanzouDirectLink](https://github.com/JDDKCN/KCNLanzouDirectLink)
## 许可协议
该项目使用 [A-GPLv3](https://opensource.org/licenses/AGPL-3.0) 许可协议。
## 贡献
欢迎提出问题、改进建议或直接提交 Pull Request！
## 联系方式
- [前往我的Github](https://github.com/JDDKCN)
- [前往我的B站首页](https://space.bilibili.com/475547854/)
- [前往我的Twitter账号](https://twitter.com/2233KCN03)