openhongguo 是红果短剧（Hongguo）的非官方 SDK，提供 Go、Node.js、Android、iOS、React Native 和 Flutter 版本。SDK 可以浏览短剧目录、搜索短剧、读取短剧和分集的详情，并取得分集的播放地址和内容密钥。

SDK 用匿名设备发送所有请求，不需要登录。Go 以外的 SDK 都由 Go SDK 编译而成，所以各语言的行为相同。

免责声明

请以学习为目的使用本仓库。

本仓库的所有内容仅供学习和参考之用，禁止用于商业用途。任何人或组织不得将本仓库的内容用于非法用途或侵犯他人合法权益。

本仓库所涉及的接口分析与调用技术仅用于学习和研究，不得用于对其他平台进行大规模数据采集或其他非法行为。

对于因使用本仓库内容而引起的任何法律责任，本仓库不承担任何责任。使用本仓库的内容即表示您同意本免责声明的所有条款和条件。

详细的免责声明见文末。

package main

import (
	"context"
	"fmt"
	"log"

	"github.com/beilunyang/openhongguo/adapters"
	"github.com/beilunyang/openhongguo/sdk"
)

func main() {
	ctx := context.Background()
	client, err := adapters.NewClient("anonymous.json", sdk.Options{})
	if err != nil {
		log.Fatal(err)
	}

	page, err := client.Search(ctx, "全球死考", sdk.SearchOptions{})
	if err != nil {
		log.Fatal(err)
	}
	episodes, err := client.ListEpisodes(ctx, page.Items[0].ID, sdk.EpisodeOptions{})
	if err != nil {
		log.Fatal(err)
	}
	pb, err := client.ResolvePlayback(ctx, episodes.Items[0].ID, sdk.PlaybackOptions{})
	if pb == nil {
		log.Fatal(err)
	}
	for _, s := range pb.Streams {
		fmt.Println(s.Definition, s.URL)
	}
}

第一次请求时，SDK 注册一台匿名设备，并把设备档案保存到 anonymous.json。以后的请求都使用这台匿名设备。

adapters.NewClient 用默认的实现创建客户端。sdk.Options 的字段都是可选的。

client, err := adapters.NewClient("anonymous.json", sdk.Options{
	RetryAttempts: 5,
	Logger:        log.Default(),
})

如果不用 adapters，直接调用 sdk.NewClient。这时 Transport 和 ProfileStore 是必填的。

带游标的列表返回 sdk.Page：Items 是本页的条目，Cursor 是下一页的游标，HasMore 表示是否还有下一页。

如果要遍历所有页，使用 DiscoverPager 或 SearchPager。服务端会在不同的页中返回同一部短剧，Pager 删除重复的短剧。

pager := client.SearchPager("末世", sdk.SearchOptions{})
for {
	items, more, err := pager.Next(ctx)
	if err != nil {
		log.Fatal(err)
	}
	for _, s := range items {
		fmt.Println(s.ID, s.Title)
	}
	if !more {
		break
	}
}

所有错误都可以用 errors.Is 与 sdk 包的哨兵错误比较。

_, err := client.GetSeries(ctx, seriesID)
switch {
case errors.Is(err, sdk.ErrContentUnavailable):
	fmt.Println("这部短剧已下架")
case errors.Is(err, sdk.ErrRateLimited):
	time.Sleep(sdk.RetryAfter(err, 10*time.Second))
case err != nil:
	log.Fatal(err)
}

其他语言的异常有同样的错误码（code）、是否可重试（retryable）和建议的等待时间（retryAfterMs）。

ctx, cancel := context.WithTimeout(ctx, 20*time.Second)
defer cancel()
page, err := client.Search(ctx, "全球死考", sdk.SearchOptions{})

如果分集是加密的，ResolvePlayback 返回播放模型和 ErrDRMProtected。把播放模型传给 sdk.ContentKey，取得内容密钥。

pb, err := client.ResolvePlayback(ctx, episodeID, sdk.PlaybackOptions{})
if errors.Is(err, sdk.ErrDRMProtected) {
	key, err := sdk.ContentKey(pb) // 把 key.Hex 传给 ffmpeg 的 -decryption_key
	...
}

SDK 第一次请求时注册匿名设备，然后把设备档案交给 ProfileStore 保存。

如果服务端拒绝匿名设备，请求返回 ErrDeviceRejected。这时调用 ResetDevice，然后重试。

实现 sdk.Transport，可以使用代理、记录请求或在测试中模拟服务端。

type Transport interface {
	Do(ctx context.Context, req *sdk.Request) (*sdk.Response, error)
}

注意：

• 只在没有收到响应时返回错误。HTTP 错误状态码要作为 Response 正常返回，SDK 自己判断。
• Response.Body 必须是原始字节，不要解压。SDK 根据 Content-Encoding 自己解压。
• 请求 URL 的查询参数包含设备 ID。记录日志前先脱敏。

httptransport.New() 是默认实现。SetLogger 把每个请求的方法、脱敏后的 URL 和状态码写入日志。

各语言的方法一一对应，参数的顺序相同。Go 的方法名以大写字母开头，其他语言以小写字母开头。返回值的字段见类型参考。

ohg 是用 SDK 写的命令行工具，演示了 SDK 的典型用法。

go build -o bin/ohg ./cmd/ohg
bin/ohg search 全球死考
bin/ohg play 全球死考第一季

播放需要 mpv、ffplay 或 vlc，下载需要 ffmpeg。完整用法见 docs/cli.md。

SDK 还没有发布 1.0 版本。在 1.0 之前，次版本号可能包含不兼容的变更。

服务端的接口没有公开文档，随时可能改版。每日的接口契约检查用于尽早发现改版。

根目录的 Makefile 是构建和测试的入口。

注意：README 中的方法表和错误表由 make gen 生成。不要手工修改，修改 sdk 的 Go 注释。

本项目（以下简称“本项目”）是作为一个技术研究与学习工具而创建的，旨在探索和学习移动应用接口协议的分析与调用技术。

本项目专注于短剧平台公开内容接口的技术研究，旨在提供给学习者和研究者作为技术交流之用。

本项目开发者（以下简称“开发者”）郑重提醒用户在下载、安装和使用本项目时，严格遵守中华人民共和国相关法律法规，包括但不限于《中华人民共和国网络安全法》、《中华人民共和国反间谍法》等所有适用的国家法律和政策。

用户应自行承担一切因使用本项目而可能引起的法律责任。

本项目严禁用于任何非法目的或非学习、非研究的商业行为。

本项目不得用于任何形式的非法侵入他人计算机系统，不得用于任何侵犯他人知识产权或其他合法权益的行为。

用户应保证其使用本项目的目的纯属个人学习和技术研究，不得用于任何形式的非法活动。

开发者已尽最大努力确保本项目的正当性及安全性，但不对用户使用本项目可能引起的任何形式的直接或间接损失承担责任，包括但不限于由于使用本项目而导致的任何数据丢失、设备损坏、法律诉讼等。

通过本项目访问的短剧、图片、文字等内容，其著作权及其他权利归原权利人所有。

用户不得复制、传播、公开展示或以其他方式使用这些内容，侵犯权利人的合法权益。

本项目提供的下载和解密功能仅用于个人学习和技术研究。用户应在研究完成后及时删除相关内容。

本项目的知识产权归开发者所有。本项目受到著作权法和国际著作权条约以及其他知识产权法律和条约的保护。

用户在遵守本声明及相关法律法规的前提下，可以下载和使用本项目。

关于本项目的最终解释权归开发者所有。开发者保留随时更改或更新本免责声明的权利，恕不另行通知。

感谢 LINUXDO 社区提供的帮助与支持。

本项目使用 Apache License 2.0 许可证。全文见 LICENSE。Copyright 2026 beilunyang。