@candriajs/git-neko-kit 0.5.2

package/dist/index.d.cts

@@ -0,0 +1,3055 @@
+/** 反向代理地址 */
+type ReverseProxyCommonUrlType = string;
+/** Git类型 */
+type ApiType = 'github' | 'gitee' | 'gitcode';
+/**
+ * 通用代理配置
+ */
+interface CommonProxyType {
+    type: 'common';
+    /** 代理基础地址 */
+    address: string;
+}
+/**
+ * HTTP 代理配置
+ */
+interface HttpProxyType {
+    type: 'http';
+    address: string;
+}
+/**
+ * HTTPS 代理配置
+ */
+interface HttpsProxyType {
+    type: 'https';
+    address: string;
+}
+/**
+ * SOCKS5 代理配置
+ */
+interface SocksProxyType {
+    type: 'socks';
+    address: string;
+}
+/** 代理配置参数类型 */
+type ProxyParamsType = HttpProxyType | HttpsProxyType | SocksProxyType | CommonProxyType;
+
+interface PkgInfoType {
+    /** 包名 */
+    name: string;
+    /** 版本号 */
+    version: string;
+}
+
+/** 请求令牌的类型 */
+type RequestTokenType = 'Bearer' | 'Basic';
+/** 请求配置类型 */
+interface RequestConfigType {
+    /** 请求地址 */
+    url?: string;
+    /** 请求令牌 */
+    token?: string | null;
+    /** 令牌类型，默认为 Bearer，即使用 Bearer 令牌 */
+    tokenType?: RequestTokenType;
+}
+
+/** 是否响应成功类型 */
+type ResponseSuccessType = boolean;
+/** 状态码响应类型 */
+type ResponseStatusCodeType = number;
+/** 消息响应类型 */
+type ResponseMsgType = string;
+/** 响应类型 */
+interface ResponseType<D = any> {
+    success: ResponseSuccessType;
+    statusCode: ResponseStatusCodeType;
+    msg: ResponseMsgType;
+    data: D;
+}
+/** API响应类型 */
+interface ApiResponseType<D = any> extends Omit<ResponseType<D>, 'success'> {
+    status: 'ok' | 'error';
+}
+
+/**
+ * 单日贡献数据
+ */
+interface ContributionData {
+    /** 日期字符串，格式为YYYY-MM-DD */
+    date: string;
+    /** 当日的贡献次数 */
+    count: number;
+}
+/**
+ * 贡献统计结果
+ */
+interface ContributionResult {
+    /** 总贡献次数 */
+    total: number;
+    /**
+     * 二维数组结构的贡献数据
+     * 第一维通常表示周数，第二维表示每周的贡献数据
+     */
+    contributions: ContributionData[][];
+}
+
+interface AccessTokenType {
+    /** 访问令牌 */
+    access_token: string;
+}
+interface AccessCodeType {
+    /** 授权码 */
+    code: string;
+}
+interface RefreshTokenType {
+    /** 刷新令牌 */
+    refresh_token: string;
+}
+interface UserNameParamType {
+    /** 用户名 */
+    username: string;
+}
+interface OrganizationNameParamType {
+    /** 组织登录名 */
+    org: string;
+}
+interface UserIdParamType {
+    /** 用户id */
+    user_id: number;
+}
+interface RepoOwnerParamType {
+    /** 仓库的拥有者 */
+    owner: string;
+}
+interface RepoNameParamType {
+    /** 仓库的名称 */
+    repo: string;
+}
+interface RepoUrlParamType {
+    /** 仓库地址 */
+    url: string;
+}
+interface ShaParamType {
+    /** 仓库的SHA值 */
+    sha: string;
+}
+interface formatParamType {
+    /** 是否格式化 */
+    format: boolean;
+}
+/** guthub基础入口类型 */
+interface GitHubAuthType {
+    /** 私钥内容 */
+    Private_Key: string;
+    /** Base App Client ID */
+    Client_ID: string;
+    /** Base App Client Secret */
+    Client_Secret: string;
+    /** WebHook Secret */
+    WebHook_Secret: string;
+    /** 是否格式化 */
+    format?: formatParamType['format'];
+}
+
+/** 用户信息参数对象类型 */
+interface UserInfoParamType extends UserNameParamType {
+    /** 是否格式化日期 */
+    format?: formatParamType['format'];
+}
+/** 授权用户信息参数对象类型 */
+interface UserInfoByTokenParamType extends AccessTokenType {
+    /** 是否格式化日期 */
+    format?: formatParamType['format'];
+}
+/** 账户基本信息 */
+interface AccountBaseType {
+    /** 账号登录名 */
+    login: string;
+    /** 账号ID */
+    id: number;
+    /** 账号视图类型 */
+    user_view_type: string;
+    /** 账号节点ID */
+    node_id: string;
+    /** 账号头像URL */
+    avatar_url: string;
+    /** Gravatar ID */
+    gravatar_id: string | null;
+    /** 用户API URL */
+    url: string;
+    /** 账号主页URL */
+    html_url: string;
+    /** 仓库列表URL */
+    repos_url: string;
+    /** 账号类型 */
+    type: string;
+    /** 是否是站点管理员 */
+    site_admin: boolean;
+}
+interface UserPlanType {
+    /** 协作者数量 */
+    collaborators: number;
+    /** 计划名称 */
+    name: string;
+    /** 存储空间 */
+    space: number;
+    /** 私有仓库数量 */
+    private_repos: number;
+}
+/** GitHub用户详细信息 */
+interface UserInfoResponseType extends AccountBaseType {
+    /** 用户全名 */
+    name: string | null;
+    /** 公司 */
+    company: string | null;
+    /** 博客URL */
+    blog: string | null;
+    /** 所在地 */
+    location: string | null;
+    /** 邮箱 */
+    email: string | null;
+    /** 通知邮箱 */
+    notification_email?: string | null;
+    /** 是否可雇佣 */
+    hireable: boolean | null;
+    /** 个人简介 */
+    bio: string | null;
+    /** Twitter用户名 */
+    twitter_username: string | null;
+    /** 订阅列表URL */
+    subscriptions_url: string;
+    /** 组织列表URL */
+    organizations_url: string;
+    /** 事件列表URL */
+    events_url: string;
+    /** 接收事件列表URL */
+    received_events_url: string;
+    /** 粉丝列表URL */
+    followers_url: string;
+    /** 关注列表URL */
+    following_url: string;
+    /** Gists列表URL */
+    gists_url: string;
+    /** 星标仓库URL */
+    starred_url: string;
+    /** 公开仓库数量 */
+    public_repos: number;
+    /** 公开Gists数量 */
+    public_gists: number;
+    /** 粉丝数 */
+    followers: number;
+    /** 关注数 */
+    following: number;
+    /** 创建时间 */
+    created_at: string;
+    /** 更新时间 */
+    updated_at: string;
+    /** 私有Gists数量 */
+    private_gists?: number;
+    /** 总私有仓库数 */
+    total_private_repos?: number;
+    /** 拥有的私有仓库数 */
+    owned_private_repos?: number;
+    /** 磁盘使用量(单位KB) */
+    disk_usage?: number;
+    /** 协作者数量 */
+    collaborators?: number;
+    /** 是否启用双重认证 */
+    two_factor_authentication?: boolean;
+    /** 订阅计划 */
+    plan?: UserPlanType;
+    /** 是否是商业增强版 */
+    business_plus?: boolean;
+    /** LDAP DN */
+    ldap_dn?: string;
+}
+
+/** 仓库列表参数类型 */
+interface RepoListBaseParamType {
+    /** 排序方式，可选created， updated， pushed， full_name， 默认为 full_name */
+    sort?: 'created' | 'updated' | 'pushed' | 'full_name';
+    /** 排序方式，可选asc， desc， 默认为 desc */
+    direction?: 'asc' | 'desc';
+    /** 每页数量 */
+    per_page?: number;
+    /** 页码 */
+    page?: number;
+}
+/** 组织仓库列表参数类型 */
+interface OrgRepoListParmsType extends RepoListBaseParamType {
+    /** 组织名称 */
+    org: string;
+    /** 类型，可选all， public， private， forks， sources， member， 默认为 all */
+    type?: 'all' | 'public' | 'private' | 'forks' | 'sources' | 'member';
+    /** 是否格式化日期 */
+    format?: formatParamType['format'];
+}
+/** 用户仓库列表参数类型 */
+interface UserRepoListParamType extends RepoListBaseParamType {
+    /** 用户名 */
+    username: string;
+    /** 类型，可选all， owner， member， 默认为 all */
+    type?: 'all' | 'owner' | 'member';
+    /** 是否格式化日期 */
+    format?: formatParamType['format'];
+}
+interface UserByTokenRepoListParamType extends RepoListBaseParamType {
+    /** 仓库的可见性，可选all， public， private， 默认为 all */
+    visibility?: 'all' | 'public' | 'private';
+    /** 仓库的状态，可选all， public， private， 默认为 all */
+    affiliation?: 'owner' | 'collaborator' | 'organization_member';
+    /** 类型，可选all， owner， member， 默认为 all */
+    type?: 'all' | 'owner' | 'member';
+    /** 是否格式化日期 */
+    format?: formatParamType['format'];
+}
+/** 仓库信息响应类型 */
+interface RepoBaseParamType extends RepoOwnerParamType, RepoNameParamType {
+}
+/** 仓库信息请求参数 */
+type RepoInfoParamType = (RepoBaseParamType | RepoUrlParamType) & {
+    /** 是否格式化日期 */
+    format?: formatParamType['format'];
+};
+/** 拥有者信息 */
+interface Owner {
+    /** * 仓库的拥有者 */
+    name: string | null;
+    /** * 仓库的拥有者的邮箱 */
+    email: string | null;
+    /** * 拥有者的 Base 用户名 */
+    login: string;
+    /** * 拥有者的 Base 用户 ID */
+    id: number;
+    /** * 拥有者的节点 ID */
+    node_id: string;
+    /** * 拥有者的头像 URL */
+    avatar_url: string;
+    /** * 拥有者的 Gravatar ID */
+    gravatar_id: string | null;
+    /** * 拥有者的 Base API URL */
+    url: string;
+    /** * 拥有者的 Base 主页 URL */
+    html_url: string;
+    /** * 拥有者的粉丝列表 URL */
+    followers_url: string;
+    /** * 拥有者的关注列表 URL */
+    following_url: string;
+    /** * 拥有者的 Gists URL */
+    gists_url: string;
+    /** * 拥有者的 starred 仓库列表 URL */
+    starred_url: string;
+    /** * 拥有者的订阅列表 URL */
+    subscriptions_url: string;
+    /** * 拥有者的组织 URL */
+    organizations_url: string;
+    /** * 拥有者的仓库列表 URL */
+    repos_url: string;
+    /** * 拥有者的事件 URL */
+    events_url: string;
+    /** * 拥有者的接收事件 URL */
+    received_events_url: string;
+    /** * 拥有者的类型，例如 'User' 或 'Organization' */
+    type: string;
+    /** * 用户查看类型，通常是 'public' */
+    user_view_type: string;
+    /** * 是否是站点管理员 */
+    site_admin: boolean;
+    /** * 用户标星时间 */
+    starred_at: string;
+}
+/** 许可证信息 */
+interface License {
+    /** * 许可证的键，例如 'mit' */
+    key: string;
+    /** * 许可证的名称，例如 'MIT License' */
+    name: string;
+    /** * 许可证的 SPDX ID，例如 'MIT' */
+    spdx_id: string;
+    /** * 许可证的 URL 地址 */
+    url: string | null;
+    /** * 许可证的 HTML URL */
+    html_url?: string;
+    /** * 许可证的节点 ID */
+    node_id: string;
+}
+/** 仓库行为准则 */
+interface CodeOfConduct {
+    /** * 行为准则的键 */
+    key: string;
+    /** * 行为准则的名称 */
+    name: string;
+    /** * 行为准则的 URL */
+    url: string;
+    /** * 行为准则的主体 */
+    body?: string;
+    /** * 行为准则的 HTML URL */
+    html_url: string | null;
+}
+/** 仓库高级安全状态 */
+interface SecurityAnalysisAdvancedSecurity {
+    /** * 高级安全状态 */
+    status: string;
+}
+/** Dependabot 安全更新状态 */
+interface SecurityAnalysisDependabotSecurityUpdates {
+    /** * Dependabot 安全更新状态 */
+    status: string;
+}
+/** 秘钥扫描状态 */
+interface SecurityAnalysisSecretScanning {
+    /** * 秘钥扫描状态 */
+    status: string;
+}
+/** 秘钥扫描推送保护状态 */
+interface SecurityAnalysisSecretScanningPushProtection {
+    /** * 秘钥扫描推送保护状态 */
+    status: string;
+}
+/** 仓库安全和分析设置 */
+interface SecurityAndAnalysis {
+    /** * 高级安全设置 */
+    advanced_security?: SecurityAnalysisAdvancedSecurity;
+    /** * Dependabot 安全更新设置 */
+    dependabot_security_updates?: SecurityAnalysisDependabotSecurityUpdates;
+    /** * 秘钥扫描设置 */
+    secret_scanning?: SecurityAnalysisSecretScanning;
+    /** * 秘钥扫描推送保护设置 */
+    secret_scanning_push_protection?: SecurityAnalysisSecretScanningPushProtection;
+}
+/** 仓库的权限信息 */
+interface Permissions {
+    /** * 管理员权限 */
+    admin: boolean;
+    /** * 推送权限 */
+    push: boolean;
+    /** * 拉取权限 */
+    pull: boolean;
+    /** * 维护权限 */
+    maintain?: boolean;
+    /** * 分类权限 */
+    triage?: boolean;
+}
+/**
+ * 合并提交标题的格式选项
+ * - PR_TITLE: 使用 Pull Request 标题作为合并提交标题
+ * - MERGE_MESSAGE: 使用默认的合并消息格式作为标题
+ */
+type MergeCommitTitle = 'PR_TITLE' | 'MERGE_MESSAGE';
+/**
+ * 合并提交消息的格式选项
+ * - PR_BODY: 使用 Pull Request 正文作为合并提交消息
+ * - PR_TITLE: 使用 Pull Request 标题作为合并提交消息
+ * - BLANK: 留空合并提交消息
+ */
+type MergeCommitMessage = 'PR_BODY' | 'PR_TITLE' | 'BLANK';
+/**
+ * Squash 合并提交标题的格式选项
+ * - PR_TITLE: 使用 Pull Request 标题作为 Squash 合并提交标题
+ * - COMMIT_OR_PR_TITLE: 使用提交信息或 Pull Request 标题作为标题
+ */
+type SquashMergeCommitTitle = 'PR_TITLE' | 'COMMIT_OR_PR_TITLE';
+/**
+ * Squash 合并提交消息的格式选项
+ * - PR_BODY: 使用 Pull Request 正文作为 Squash 合并提交消息
+ * - COMMIT_MESSAGES: 使用所有提交信息作为 Squash 合并提交消息
+ * - BLANK: 留空 Squash 合并提交消息
+ */
+type SquashMergeCommitMessage = 'PR_BODY' | 'COMMIT_MESSAGES' | 'BLANK';
+/** * 仓库信息 */
+interface RepoInfoResponseType {
+    /** * 仓库的唯一 ID */
+    id: number;
+    /** * 仓库的节点 ID */
+    node_id: string;
+    /** * 仓库的名称 */
+    name: string;
+    /** * 仓库的完整名称，包含用户名或组织名 */
+    full_name: string;
+    /** * 仓库拥有者的信息 */
+    owner: Owner;
+    /** * 仓库是否私有 */
+    private: boolean;
+    /** * 仓库的 HTML 页面 URL */
+    html_url: string;
+    /** * 仓库的描述信息 */
+    description: string | null;
+    /** * 仓库是否是 fork 仓库 */
+    fork: boolean;
+    /** * 仓库的 API URL */
+    url: string;
+    /** * 获取仓库 fork 列表的 URL */
+    forks_url: string;
+    /** * 获取仓库 keys 列表的 URL */
+    keys_url: string;
+    /** * 获取仓库协作者列表的 URL */
+    collaborators_url: string;
+    /** * 获取仓库团队信息的 URL */
+    teams_url: string;
+    /** * 获取仓库 hooks 列表的 URL */
+    hooks_url: string;
+    /** * 获取仓库 issue 事件列表的 URL */
+    issue_events_url: string;
+    /** * 获取仓库所有事件的 URL */
+    events_url: string;
+    /** * 获取仓库分配人信息的 URL */
+    assignees_url: string;
+    /** * 获取仓库分支列表的 URL */
+    branches_url: string;
+    /** * 获取仓库标签列表的 URL */
+    tags_url: string;
+    /** * 获取仓库 blob 信息的 URL */
+    blobs_url: string;
+    /** * 获取仓库 git 标签信息的 URL */
+    git_tags_url: string;
+    /** * 获取仓库 git 引用信息的 URL */
+    git_refs_url: string;
+    /** * 获取仓库 git 树信息的 URL */
+    trees_url: string;
+    /** * 获取仓库状态信息的 URL */
+    statuses_url: string;
+    /** * 获取仓库语言信息的 URL */
+    languages_url: string;
+    /** * 获取仓库 Stargazers 列表的 URL */
+    stargazers_url: string;
+    /** * 获取仓库贡献者列表的 URL */
+    contributors_url: string;
+    /** * 获取仓库订阅者列表的 URL */
+    subscribers_url: string;
+    /** * 获取仓库订阅信息的 URL */
+    subscription_url: string;
+    /** * 获取仓库提交历史的 URL */
+    commits_url: string;
+    /** * 获取仓库 git 提交历史的 URL */
+    git_commits_url: string;
+    /** * 获取仓库评论的 URL */
+    comments_url: string;
+    /** * 获取仓库问题评论的 URL */
+    issue_comment_url: string;
+    /** * 获取仓库文件内容的 URL */
+    contents_url: string;
+    /** * 获取仓库比较信息的 URL */
+    compare_url: string;
+    /** * 获取仓库合并信息的 URL */
+    merges_url: string;
+    /** * 获取仓库归档的 URL */
+    archive_url: string;
+    /** * 获取仓库下载的 URL */
+    downloads_url: string;
+    /** * 获取仓库所有 issues 的 URL */
+    issues_url: string;
+    /** * 获取仓库所有 pull requests 的 URL */
+    pulls_url: string;
+    /** * 获取仓库所有里程碑的 URL */
+    milestones_url: string;
+    /** * 获取仓库所有通知的 URL */
+    notifications_url: string;
+    /** * 获取仓库所有标签的 URL */
+    labels_url: string;
+    /** * 获取仓库所有发布版本的 URL */
+    releases_url: string;
+    /** * 获取仓库所有部署的 URL */
+    deployments_url: string;
+    /** * 仓库的创建时间 */
+    created_at: string;
+    /** * 仓库的更新时间 */
+    updated_at: string;
+    /** * 仓库的推送时间 */
+    pushed_at: string;
+    /** * 仓库的 Git URL */
+    git_url: string;
+    /** * 仓库的 SSH URL */
+    ssh_url: string;
+    /** * 仓库的克隆 URL */
+    clone_url: string;
+    /** * 仓库的 SVN URL */
+    svn_url: string;
+    /** * 仓库的主页 URL，若无则为 null */
+    homepage: string | null;
+    /** * 仓库的大小（单位：KB） */
+    size: number;
+    /** * 仓库的 Stargazer 数量 */
+    stargazers_count: number;
+    /** * 仓库的 Watcher 数量 */
+    watchers_count: number;
+    /** * 仓库的主编程语言 */
+    language: string | null;
+    /** * 是否开启 issue 功能 */
+    has_issues: boolean;
+    /** * 是否开启项目功能 */
+    has_projects: boolean;
+    /** * 是否允许下载 */
+    has_downloads: boolean;
+    /** * 是否开启 Wiki 功能 */
+    has_wiki: boolean;
+    /** * 是否开启 Pages 功能 */
+    has_pages: boolean;
+    /** * 是否开启讨论区功能 */
+    has_discussions: boolean;
+    /** * 仓库的 fork 数量 */
+    forks_count: number;
+    /** * 仓库的镜像 URL */
+    mirror_url: string | null;
+    /** * 仓库是否已归档 */
+    archived: boolean;
+    /** * 仓库是否被禁用 */
+    disabled: boolean;
+    /** * 开放的 issue 数量 */
+    open_issues_count: number;
+    /** * 仓库的许可证信息 */
+    license: License | null;
+    /** * 是否允许 fork 仓库 */
+    allow_forking: boolean;
+    /** * 是否是模板仓库 */
+    is_template: boolean;
+    /** * 是否要求提交时签署承诺 */
+    web_commit_signoff_required: boolean;
+    /** * 仓库的主题标签 */
+    topics: string[];
+    /** * 仓库的可见性（如 public, private） */
+    visibility: string;
+    /** * 仓库的 fork 数量 */
+    forks: number;
+    /** * 仓库的开放问题数量 */
+    open_issues: number;
+    /** * 仓库的 Watcher 数量 */
+    watchers: number;
+    /** * 仓库的默认分支 */
+    default_branch: string;
+    /** *
+     * 仓库的主分支
+     * 该属性已被弃用，在部分旧版本的 API 中可能存在，
+     * @deprecated 已弃用，使用 default_branch 代替
+     * */
+    master_branch?: string;
+    /** * 临时克隆令牌 */
+    temp_clone_token: string | null;
+    /** * 仓库的网络计数 */
+    network_count: number;
+    /** * 仓库的订阅者数量 */
+    subscribers_count: number;
+    /** * 仓库的组织信息，如果属于组织的话 */
+    organization?: Owner | null;
+    /** * 模板仓库信息，如果是从模板创建的话 */
+    template_repository: RepoInfoResponseType | null;
+    /** * 父仓库信息，如果是 fork 的话 */
+    parent: RepoInfoResponseType | null;
+    /** * 源仓库信息，如果是 fork 的话 */
+    source: RepoInfoResponseType | null;
+    /** * 是否允许 rebase 合并 */
+    allow_rebase_merge?: boolean;
+    /** * 是否允许 squash 合并 */
+    allow_squash_merge?: boolean;
+    /** * 是否允许自动合并 */
+    allow_auto_merge?: boolean;
+    /** * 合并后是否删除分支 */
+    delete_branch_on_merge?: boolean;
+    /** * 是否允许合并提交 */
+    allow_merge_commit?: boolean;
+    /** * 是否允许更新分支 */
+    allow_update_branch?: boolean;
+    /** * 是否允许匿名 Git 访问 */
+    anonymous_access_enabled?: boolean;
+    /** * squash 合并提交标题的格式 */
+    squash_merge_commit_title?: SquashMergeCommitTitle;
+    /** * squash 合并提交消息的格式 */
+    squash_merge_commit_message?: SquashMergeCommitMessage;
+    /** * 合并提交标题的格式 */
+    merge_commit_title?: MergeCommitTitle;
+    /** * 合并提交消息的格式 */
+    merge_commit_message?: MergeCommitMessage;
+    /** * 行为准则信息 */
+    code_of_conduct?: CodeOfConduct | null;
+    /** * 安全和分析设置 */
+    security_and_analysis?: SecurityAndAnalysis | null;
+    /** * 权限设置 */
+    permissions?: Permissions;
+    /** * 自定义属性 */
+    custom_properties?: Record<string, any>;
+}
+/**
+ * 组织仓库列表类型
+ * 该类型包含了多个仓库的信息，每个仓库都有自己的详细信息。
+ */
+type OrgRepoListType = RepoInfoResponseType[];
+/** 用户仓库列表类型 */
+type UserRepoListType = Array<RepoInfoResponseType & {
+    /** * 仓库的角色名称 */
+    role_name?: string;
+}>;
+interface RepoVisibilityResponseType {
+    /** * 仓库的可见性 */
+    visibility: string;
+}
+interface RepoDefaultBranchResponseType {
+    /** * 仓库的默认分支名称 */
+    default_branch: string;
+}
+/** 协作者参数类型 */
+type CollaboratorParamType = RepoInfoParamType & UserNameParamType & {
+    /**
+     * 协作者权限 ,可选 pull，triage, push, maintain, admin，默认pull
+     * pull - 只读访问，协作者可以查看仓库内容。
+     * triage - 允许管理议题和拉取请求，包括标记、分配和修改状态。
+     * push - 允许推送代码到仓库分支，同时拥有 pull 权限。
+     * maintain - 允许管理仓库中的代码和议题，但不能更改仓库设置。
+     * admin - 拥有仓库的完全控制权，包括更改设置和删除仓库。
+     */
+    permission?: 'pull' | 'triage' | 'push' | 'maintain' | 'admin';
+};
+/** 邀请协作者响应类型 */
+interface AddCollaboratorResponseType {
+    /** 邀请唯一id */
+    id: number;
+    /** 邀请节点id */
+    node_id: string;
+    /** 邀请仓库信息 */
+    repository: RepoInfoResponseType;
+}
+/** 协作者列表参数类型 */
+type CollaboratorListParamType = RepoInfoParamType & {
+    /**
+     * 筛选按隶属关系返回的协作者
+     * outside - 列出所有外部协作者，包括仓库成员和外部 collaborator。
+     * direct - 列出仓库成员。
+     * all - 列出仓库成员和外部 collaborator。
+    */
+    affiliation?: 'outside' | 'direct' | 'all';
+    /**
+     * 筛选按权限关系返回的协作者
+     * pull - 只读访问，协作者可以查看仓库内容。
+     * triage - 允许管理议题和拉取请求，包括标记、分配和修改状态。
+     * push - 允许推送代码到仓库分支，同时拥有 pull 权限。
+     * maintain - 允许管理仓库中的代码和议题，但不能更改仓库设置。
+     * admin - 拥有仓库的完全控制权，包括更改设置和删除仓库。
+     */
+    permission?: 'pull' | 'triage' | 'push' | 'maintain' | 'admin';
+    /** 每页数量 */
+    per_page?: number;
+    /** 页码 */
+    page?: number;
+};
+/** 协作者信息类型 */
+interface CollaboratorInfo extends AccountBaseType {
+    /** 协作者邮箱 */
+    email: string | null;
+    /** 协作者姓名 */
+    name: string | null;
+    /** 粉丝URL */
+    followers_url: string;
+    /** 关注URL */
+    following_url: string;
+    /** Gists URL */
+    gists_url: string;
+    /** 标星URL */
+    starred_url: string;
+    /** 订阅URL */
+    subscriptions_url: string;
+    /** 组织URL */
+    organizations_url: string;
+    /** 仓库URL */
+    repos_url: string;
+    /** 事件URL */
+    events_url: string;
+    /** 接收事件URL */
+    received_events_url: string;
+    /** 权限设置 */
+    permissions: {
+        /** 拉取权限 */
+        pull: boolean;
+        /** 分类权限 */
+        triage: boolean;
+        /** 推送权限 */
+        push: boolean;
+        /** 维护权限 */
+        maintain: boolean;
+        /** 管理权限 */
+        admin: boolean;
+    };
+    /** 角色名称 */
+    role_name: string;
+}
+/** 协作者列表响应类型 */
+type CollaboratorListResponseType = CollaboratorInfo[];
+/** 移除协作者参数类型 */
+type RemoveCollaboratorParamType = (RepoBaseParamType | RepoUrlParamType) & UserNameParamType;
+/** 移除协作者响应类型 */
+interface RemoveCollaboratorResponseType {
+    /** 状态信息 */
+    info: string;
+}
+
+/**
+ * 定义 Base 应用所需的权限
+ */
+interface GitHubAppPermissions {
+    /** 对仓库内容的权限（例如读取、写入） */
+    contents: string;
+    /** 对部署的权限（例如读取、写入） */
+    deployments: string;
+    /** 对议题的权限（例如写） */
+    issues: string;
+    /** 对检查的权限 */
+    checks: string;
+    /** 对元数据的权限（例如读取） */
+    metadata: string;
+}
+/**
+ * 定义 Base 应用的详细信息
+ */
+interface GitHubAppInfoType {
+    /** 应用的唯一 ID */
+    id: number;
+    /** 应用的 Client ID */
+    client_id: string;
+    /** 应用的标识符（slug） */
+    slug: string;
+    /** 应用的唯一 Node ID */
+    node_id: string;
+    /** 应用所有者的信息 */
+    owner: Owner;
+    /** 应用的名称 */
+    name: string;
+    /** 应用的描述 */
+    description: string;
+    /** 应用的外部 URL */
+    external_url: string;
+    /** 应用的 Base 页面 URL */
+    html_url: string;
+    /** 应用创建时间的时间戳 */
+    created_at: string;
+    /** 应用最后更新时间的时间戳 */
+    updated_at: string;
+    /** 应用所需的权限 */
+    permissions: GitHubAppPermissions;
+    /** 应用监听的事件列表 */
+    events: string[];
+    /** 应用的安装数量 */
+    installations_count: number;
+}
+/** GitHub 账户基础信息类型 */
+interface GitHubAccountBaseType {
+    /** 账户名称 */
+    name: string | null;
+    /** 账户邮箱 */
+    email: string | null;
+    /** 账户登录名 */
+    login: string;
+    /** 账户ID */
+    id: number;
+    /** 账户节点ID */
+    node_id: string;
+    /** 账户头像URL */
+    avatar_url: string;
+    /** Gravatar ID */
+    gravatar_id: string | null;
+    /** API URL */
+    url: string;
+    /** 主页URL */
+    html_url: string;
+}
+/** GitHub 账户完整信息类型 */
+interface GitHubAccountType extends GitHubAccountBaseType {
+    /** 粉丝列表URL */
+    followers_url: string;
+    /** 关注列表URL */
+    following_url: string;
+    /** Gists列表URL */
+    gists_url: string;
+    /** 星标仓库URL */
+    starred_url: string;
+    /** 订阅列表URL */
+    subscriptions_url: string;
+    /** 组织列表URL */
+    organizations_url: string;
+    /** 仓库列表URL */
+    repos_url: string;
+    /** 事件列表URL */
+    events_url: string;
+    /** 接收事件列表URL */
+    received_events_url: string;
+    /** 账户类型 */
+    type: string;
+    /** 是否是站点管理员 */
+    site_admin: boolean;
+}
+/** GitHub 应用权限类型 */
+interface GitHubAppDetailedPermissions {
+    /** GitHub Actions工作流权限 */
+    actions?: 'read' | 'write';
+    /** 仓库管理权限 */
+    administration?: 'read' | 'write';
+    /** 代码检查权限 */
+    checks?: 'read' | 'write';
+    /** Codespaces权限 */
+    codespaces?: 'read' | 'write';
+    /** 仓库内容权限 */
+    contents?: 'read' | 'write';
+    /** Dependabot密钥权限 */
+    dependabot_secrets?: 'read' | 'write';
+    /** 部署权限 */
+    deployments?: 'read' | 'write';
+    /** 环境权限 */
+    environments?: 'read' | 'write';
+    /** Issues权限 */
+    issues?: 'read' | 'write';
+    /** 元数据权限 */
+    metadata?: 'read' | 'write';
+    /** 包管理权限 */
+    packages?: 'read' | 'write';
+    /** Pages权限 */
+    pages?: 'read' | 'write';
+    /** Pull Requests权限 */
+    pull_requests?: 'read' | 'write';
+    /** 仓库自定义属性权限 */
+    repository_custom_properties?: 'read' | 'write';
+    /** Webhook权限 */
+    repository_hooks?: 'read' | 'write';
+    /** 仓库项目权限 */
+    repository_projects?: 'read' | 'write' | 'admin';
+    /** 密钥扫描警报权限 */
+    secret_scanning_alerts?: 'read' | 'write';
+    /** 密钥管理权限 */
+    secrets?: 'read' | 'write';
+    /** 安全事件权限 */
+    security_events?: 'read' | 'write';
+    /** 单文件权限 */
+    single_file?: 'read' | 'write';
+    /** 状态权限 */
+    statuses?: 'read' | 'write';
+    /** 漏洞警报权限 */
+    vulnerability_alerts?: 'read' | 'write';
+    /** 工作流文件权限 */
+    workflows?: 'write';
+}
+/** GitHub应用安装仓库信息响应类型 */
+interface GitHubAppRepoInfoResponseType {
+    /** 安装的唯一ID */
+    id: number;
+    /** 安装的账户信息，可以是用户或企业 */
+    account: GitHubAccountType | null;
+    /** 仓库选择类型 */
+    repository_selection: 'all' | 'selected';
+    /** 访问令牌URL */
+    access_tokens_url: string;
+    /** 仓库列表URL */
+    repositories_url: string;
+    /** 安装页面URL */
+    html_url: string;
+    /** 应用ID */
+    app_id: number;
+    /** 目标ID（用户或组织的ID） */
+    target_id: number;
+    /** 目标类型（如'Organization'） */
+    target_type: string;
+    /** 权限配置 */
+    permissions: GitHubAppDetailedPermissions;
+    /** 事件列表 */
+    events: string[];
+    /** 创建时间 */
+    created_at: string;
+    /** 更新时间 */
+    updated_at: string;
+    /** 单文件名称 */
+    single_file_name: string | null;
+    /** 是否有多个单文件 */
+    has_multiple_single_files: boolean;
+    /** 单文件路径列表 */
+    single_file_paths: string[];
+    /** 应用标识符 */
+    app_slug: string;
+    /** 暂停操作的用户信息 */
+    suspended_by: GitHubAccountBaseType | null;
+}
+
+/** Github 授权令牌接口返回类型 */
+interface GithubOauthTokenResponseType {
+    /** 用户访问令牌， 格式为 ghu_ 开头 */
+    access_token: string;
+    /** access_token 过期前的秒数，默认值为 28800（8小时） */
+    expires_in: number | null;
+    /** 刷新令牌，格式为 ghr_ 开头，可能为 null */
+    refresh_token: `ghr_${string}` | null;
+    /** refresh_token 过期前的秒数，默认值为 15897600（6个月） */
+    refresh_token_expires_in: number | null;
+    /** 令牌范围，默认是空字符串 */
+    scope: string;
+    /** 令牌类型，始终为 'bearer' */
+    token_type: 'bearer';
+}
+/** Github 刷新令牌接口返回类型 */
+interface GithubOauthRefreshTokenResponseType {
+    /** 是否成功刷新 */
+    success: boolean;
+    /** 刷新令牌信息 */
+    info: string;
+    /** 用户访问令牌，格式为 ghu_ 开头 */
+    access_token: string;
+    /** access_token 过期前的秒数，默认值为 28800（8小时） */
+    expires_in: number | null;
+    /** 刷新令牌，格式为 ghr_ 开头，可能为 null */
+    refresh_token: `ghr_${string}` | null;
+    /** refresh_token 过期前的秒数，默认值为 15897600（6个月），可能为 null */
+    refresh_token_expires_in: number | null;
+    /** 令牌范围，默认是空字符串 */
+    scope: string;
+    /** 令牌类型，始终为 'bearer' */
+    token_type: 'bearer';
+}
+/** 检查Token状态返回类型 */
+interface GithubOauthCheckTokenResponseType {
+    /** 令牌是否有效 */
+    success: boolean;
+    /** 状态信息 */
+    info: string;
+}
+
+interface CommitInfoCommonParamType {
+    /** 提交SHA */
+    sha?: ShaParamType['sha'];
+    /** 是否格式化消息和日期 */
+    format: formatParamType['format'];
+}
+/**
+ * 提交信息基础参数类型
+ * 用于获取提交信息的基础参数类型，包含仓库的拥有者、仓库名称、提交SHA等信息。
+ * */
+interface CommitInfoBaseParamType extends RepoOwnerParamType, RepoNameParamType, CommitInfoCommonParamType {
+}
+/**
+ * 提交信息URL参数类型
+ * 用于获取提交信息的URL参数类型，包含仓库的URL和提交SHA等信息。
+ * */
+interface CommitInfoUrlParamType extends RepoUrlParamType, CommitInfoCommonParamType {
+}
+/** 提交参数类型 */
+type CommitInfoParamType = CommitInfoBaseParamType | CommitInfoUrlParamType;
+interface GitUser {
+    /** 用户姓名 */
+    name: string | null;
+    /** 用户邮箱 */
+    email: string | null;
+    /** 日期字符串 */
+    date: string;
+}
+/** 验证信息类型 */
+interface Verification {
+    /** 是否已验证 */
+    verified: boolean;
+    /** 验证原因 */
+    reason: string;
+    /** 验证负载 */
+    payload: string | null;
+    /** 验证签名 */
+    signature: string | null;
+    /** 验证时间 */
+    verified_at: string | null;
+}
+interface Commit$1 {
+    /** 提交的URL */
+    url: string;
+    /** 提交作者信息 */
+    author: GitUser | null;
+    /** 提交者信息 */
+    committer: GitUser | null;
+    /** 提交信息 */
+    message: string;
+    /**
+     * 提交标题
+     * 仅在开启格式化消息时返回
+     * @example "feat: add new feature"
+     */
+    title?: string;
+    /** 提交正文
+     * 仅在开启格式化消息时返回
+     * @example "This is a new feature that adds a new feature to the application."
+     */
+    body?: string;
+    /** 评论数量 */
+    comment_count: number;
+    /** 提交树信息 */
+    tree: {
+        /** 树对象的SHA */
+        sha: string;
+        /** 树对象的URL */
+        url: string;
+    };
+    /** 验证信息 */
+    verification: Verification;
+}
+interface DiffEntry {
+    /** 文件SHA */
+    sha: string;
+    /** 文件名 */
+    filename: string;
+    /** 文件状态 */
+    status: 'added' | 'removed' | 'modified' | 'renamed' | 'copied' | 'changed' | 'unchanged';
+    /** 新增行数 */
+    additions: number;
+    /** 删除行数 */
+    deletions: number;
+    /** 总变更行数 */
+    changes: number;
+    /** 文件blob URL */
+    blob_url: string;
+    /** 文件原始URL */
+    raw_url: string;
+    /** 文件内容URL */
+    contents_url: string;
+    /** 文件差异补丁 */
+    patch: string;
+    /** 之前的文件名 */
+    previous_filename: string | null;
+}
+interface CommitStats {
+    /** 新增行数 */
+    additions: number;
+    /** 删除行数 */
+    deletions: number;
+    /** 总变更行数 */
+    total: number;
+}
+interface ParentCommit {
+    /** 父提交SHA */
+    sha: string;
+    /** 父提交URL */
+    url: string;
+    /** 父提交HTML URL */
+    html_url: string;
+}
+interface CommitInfoResponseType {
+    /** 提交URL */
+    url: string;
+    /** 提交SHA */
+    sha: string;
+    /** 节点ID */
+    node_id: string;
+    /** HTML URL */
+    html_url: string;
+    /** 评论URL */
+    comments_url: string;
+    /** 提交信息 */
+    commit: Commit$1;
+    /** 提交作者 */
+    author: AccountBaseType | null;
+    /** 提交者 */
+    committer: AccountBaseType | null;
+    /** 父提交列表 */
+    parents: ParentCommit[];
+    /** 提交统计信息 */
+    stats?: CommitStats;
+    /** 变更文件列表 */
+    files?: DiffEntry[];
+}
+
+/** 议题信息参数类型 */
+type IssueInfoParamType = (RepoBaseParamType | RepoUrlParamType) & {
+    /** 议题ID */
+    issue_number: number;
+};
+/** 议题列表参数类型 */
+type RepoIssueListParamType = (RepoBaseParamType | RepoUrlParamType) & {
+    /**
+     * 里程碑筛选
+     * @default undefined
+     * - 传入数字时：按里程碑编号筛选
+     * - 传入 "*"：接受任何里程碑的议题
+     * - 传入 "none"：返回没有里程碑的议题
+     */
+    milestone?: string | number;
+    /**
+     * 议题状态
+     * @default "open"
+     * @enum {string}
+     * - open: 打开的议题
+     * - closed: 关闭的议题
+     * - all: 所有议题
+     */
+    state?: 'all' | 'open' | 'closed';
+    /**
+     * 指派人用户名
+     * - 传入用户名：返回指派给该用户的议题
+     * - 传入 "none"：返回未指派的议题
+     * - 传入 "*"：返回已指派给任何用户的议题
+     */
+    assignee?: string;
+    /**
+     * 议题类型
+     * - 传入类型名：返回指定类型的议题
+     * - 传入 "*"：接受任何类型的议题
+     * - 传入 "none"：返回没有类型的议题
+     */
+    type?: string;
+    /** 创建者用户名，筛选由特定用户创建的议题 */
+    creator?: string;
+    /** 提及的用户名，筛选提及特定用户的议题 */
+    mentioned?: string;
+    /**
+     * 标签列表
+     * 以逗号分隔的标签名称列表
+     * @example "bug,ui,@high"
+     */
+    labels?: string;
+    /**
+     * 排序方式
+     * @default "created"
+     * @enum {string}
+     * - created: 按创建时间排序
+     * - updated: 按更新时间排序
+     * - comments: 按评论数排序
+     */
+    sort?: 'created' | 'updated' | 'comments';
+    /**
+     * 排序方向
+     * @default "desc"
+     * @enum {string}
+     * - asc: 升序
+     * - desc: 降序
+     */
+    direction?: 'asc' | 'desc';
+    /**
+     * 筛选此时间之后更新的议题
+     * 仅显示在指定时间之后更新的结果
+     * 格式为 ISO 8601: YYYY-MM-DDTHH:MM:SSZ
+     * @example "2023-01-01T00:00:00Z"
+     */
+    since?: string;
+    /**
+     * 每页结果数量
+     * @default 30
+     * @remarks 取值范围：1-100
+     */
+    per_page?: number;
+    /**
+     * 页码
+     * @default 1
+     */
+    page?: number;
+};
+/** 议题标签类型 */
+interface IssueLabelType {
+    /** 标签ID */
+    id?: number;
+    /** 标签节点ID */
+    node_id?: string;
+    /** 标签URL */
+    url?: string;
+    /** 标签名称 */
+    name: string;
+    /** 标签描述 */
+    description?: string | null;
+    /** 标签颜色代码 */
+    color?: string | null;
+    /** 是否是默认标签 */
+    default?: boolean;
+}
+/** 议题里程碑类型 */
+interface MilestoneType {
+    /** 里程碑URL */
+    url: string;
+    /** 里程碑HTML URL */
+    html_url: string;
+    /** 里程碑标签URL */
+    labels_url: string;
+    /** 里程碑ID */
+    id: number;
+    /** 里程碑节点ID */
+    node_id: string;
+    /** 里程碑编号 */
+    number: number;
+    /** 里程碑状态: open/closed */
+    state: string;
+    /** 里程碑标题 */
+    title: string;
+    /** 里程碑描述 */
+    description: string | null;
+    /** 里程碑创建者 */
+    creator: UserInfoResponseType | null;
+    /** 开放议题数 */
+    open_issues: number;
+    /** 关闭议题数 */
+    closed_issues: number;
+    /** 创建时间 */
+    created_at: string;
+    /** 更新时间 */
+    updated_at: string;
+    /** 关闭时间 */
+    closed_at: string | null;
+    /** 截止时间 */
+    due_on: string | null;
+}
+/** 拉取请求关联信息类型 */
+interface PullRequestType {
+    /** 合并时间 */
+    merged_at: string | null;
+    /** 差异URL */
+    diff_url: string | null;
+    /** HTML URL */
+    html_url: string | null;
+    /** 补丁URL */
+    patch_url: string | null;
+    /** API URL */
+    url: string | null;
+}
+/** 议题详情响应类型 */
+interface IssueInfoResponseType {
+    /** 议题ID */
+    id: number;
+    /** 节点ID */
+    node_id: string;
+    /** 议题API URL */
+    url: string;
+    /** 仓库API URL */
+    repository_url: string;
+    /** 标签URL */
+    labels_url: string;
+    /** 评论URL */
+    comments_url: string;
+    /** 事件URL */
+    events_url: string;
+    /** 议题HTML页面URL */
+    html_url: string;
+    /** 议题编号 */
+    number: number;
+    /** 议题状态: open/closed */
+    state: string;
+    /** 状态原因: completed/reopened/not_planned/null */
+    state_reason: string | null;
+    /** 议题标题 */
+    title: string;
+    /** 议题正文内容 */
+    body: string | null;
+    /** 议题创建者用户信息 */
+    user: UserInfoResponseType | null;
+    /** 议题标签 */
+    labels: Array<IssueLabelType | string>;
+    /** 议题指派人 */
+    assignee: UserInfoResponseType | null;
+    /** 议题所有指派人列表 */
+    assignees: Array<UserInfoResponseType> | null;
+    /** 议题所属里程碑 */
+    milestone: MilestoneType | null;
+    /** 是否锁定 */
+    locked: boolean;
+    /** 活跃锁定原因 */
+    active_lock_reason: string | null;
+    /** 评论数 */
+    comments: number;
+    /** 关联的拉取请求信息 */
+    pull_request?: PullRequestType;
+    /** 关闭时间 */
+    closed_at: string | null;
+    /** 创建时间 */
+    created_at: string;
+    /** 更新时间 */
+    updated_at: string;
+    /** 是否是草稿 */
+    draft?: boolean;
+    /** 关闭者信息 */
+    closed_by?: UserInfoResponseType | null;
+}
+/** 议题列表响应类型 */
+type IssueListResponseType = IssueInfoResponseType[];
+/** 创建议题参数类型 */
+type CreteIssueParamType = RepoBaseParamType & {
+    /** 标题 */
+    title: string;
+    /** 正文内容 */
+    body?: string | null;
+    /**
+     * 分配的用户
+     * @deprecated 已弃用，请使用 assignees 字段
+    */
+    assignee?: string | null;
+    /** 里程碑 */
+    milestone?: number | string | null;
+    /** 标签列表 */
+    labels?: Array<string> | null;
+    /** 指派的用户名 */
+    assignees?: Array<string> | null;
+    /** 议题类型 */
+    type?: string;
+};
+/** 创建议题响应类型 */
+type CreateIssueResponseType = IssueInfoResponseType;
+/** 更新议题参数类型 */
+interface UpdateIssueParamType extends Omit<CreteIssueParamType, 'title' | 'type'> {
+    /** 议题ID */
+    issue_number: number;
+    /** 问题的名称 */
+    title?: string | null;
+    /** 问题的内容 */
+    body?: string | null;
+    /** 要分配给此问题的用户名（已弃用） */
+    assignee?: string | null;
+    /** 问题的状态：open/closed */
+    state?: 'open' | 'closed';
+    /** 状态更改的原因 */
+    state_reason?: 'completed' | 'not_planned' | 'reopened' | null;
+    /** 与此问题关联的里程碑 */
+    milestone?: number | string | null;
+    /** 与此问题关联的标签数组 */
+    labels?: string[];
+    /** 要分配给此问题的用户名数组 */
+    assignees?: string[];
+    /** 问题类型 */
+    type?: string | null;
+}
+/** 更新议题响应类型 */
+type UpdateIssueResponseType = IssueInfoResponseType;
+/** 打开议题参数类型 */
+interface OpenIssueParamType extends RepoBaseParamType {
+    /** 议题ID */
+    issue_number: number;
+}
+/** 打开议题响应类型 */
+type OpenIssueResponseType = IssueInfoResponseType;
+/** 关闭议题参数类型 */
+interface CloseIssueParamType extends OpenIssueParamType {
+    /** 关闭原因 */
+    state_reason?: IssueInfoResponseType['state_reason'];
+}
+/** 关闭议题响应类型 */
+type CloseIssueResponseType = IssueInfoResponseType;
+/** 锁定议题参数类型 */
+interface LockIssueParamType extends RepoBaseParamType {
+    /** 议题ID */
+    issue_number: number;
+    /**
+     * 锁定原因
+     * 可以是以下之一：
+     * - off-topic：锁定议题，因为该议题与仓库无关
+     * - too heated：锁定议题，因为讨论过于激烈
+     * - resolved：锁定议题，因为该议题已解决
+     * - spam：锁定议题，因为该议题是垃圾邮件
+     */
+    lock_reason?: 'off-topic' | 'too heated' | 'resolved' | 'spam';
+}
+/** 锁定议题响应类型 */
+interface LockIssueResponseType {
+    /** 锁定状态信息 */
+    info: string;
+}
+/** 解锁议题参数类型 */
+type UnLockIssueParamType = Omit<LockIssueParamType, 'lock_reason'>;
+/** 解锁议题响应类型 */
+type UnLockIssueResponseType = LockIssueResponseType;
+/** 议题评论信息参数类型 */
+interface IssueCommentInfoParamType extends RepoBaseParamType {
+    /** 评论id,评论唯一标识符 */
+    comment_id: string;
+}
+/** 议题评论信息响应类型 */
+interface IssueCommentInfoResponseType {
+    /** 评论ID */
+    id: number;
+    /** 评论节点ID */
+    node_id: string;
+    /** 评论URL */
+    url: string;
+    /** 评论内容 */
+    body: string;
+    /** 评论纯文本内容 */
+    body_text: string;
+    /** 评论HTML内容 */
+    body_html: string;
+    /** 评论HTML页面URL */
+    html_url: string;
+    /** 评论用户信息 */
+    user: UserInfoResponseType | null;
+    /** 创建时间 */
+    created_at: string;
+    /** 更新时间 */
+    updated_at: string;
+    /** 议题URL */
+    issue_url: string;
+    /** 作者关联类型 */
+    author_association: 'COLLABORATOR' | 'CONTRIBUTOR' | 'FIRST_TIMER' | 'FIRST_TIME_CONTRIBUTOR' | 'MANNEQUIN' | 'MEMBER' | 'NONE' | 'OWNER';
+    /** 通过GitHub App执行的操作信息 */
+    performed_via_github_app: GitHubAppInfoType | null;
+}
+/** 仓库评论列表参数类型 */
+interface RepoCommentListParamType extends RepoBaseParamType {
+    /**
+     * 排序依据
+     * 用于指定结果的排序属性
+     * @default created
+     * @enum {string}
+     * - created: 按创建时间排序
+     * - updated: 按更新时间排序
+     */
+    sort?: 'created' | 'updated';
+    /**
+     * 排序方向
+     * 指定结果的排序方向
+     * 注意：如果没有指定 sort 参数，此参数将被忽略
+     * @default desc 当 sort 参数存在时
+     * @enum {string}
+     * - asc: 升序
+     * - desc: 降序
+     */
+    direction?: 'asc' | 'desc';
+    /**
+     * 筛选此时间之后更新的评论
+     * 仅显示在指定时间之后更新的结果
+     * 格式为 ISO 8601: YYYY-MM-DDTHH:MM:SSZ
+     * @example "2023-01-01T00:00:00Z"
+     */
+    since?: string;
+    /**
+     * 每页结果数量
+     * 指定每页返回的结果数
+     * @default 30
+     * @remarks 取值范围：1-100
+     */
+    per_page?: number;
+    /**
+     * 页码
+     * 指定要获取的结果页码
+     * @default 1
+     * @remarks 必须大于等于1
+     */
+    page?: number;
+}
+/** 仓库评论列表响应类型 */
+type RepoCommentListResponseType = IssueCommentInfoResponseType[];
+/** 议题评论列表参数类型 */
+interface IssueCommentListParamType extends RepoBaseParamType {
+    /** 议题ID */
+    issue_number: number;
+    /**
+     * 筛选此时间之后更新的评论
+     * 仅显示在指定时间之后更新的结果
+     * 格式为 ISO 8601: YYYY-MM-DDTHH:MM:SSZ
+     * @example "2023-01-01T00:00:00Z"
+     */
+    since?: string;
+    /**
+     * 每页结果数量
+     * @default 30
+     * @remarks 取值范围：1-100
+     */
+    per_page?: number;
+    /**
+     * 页码
+     * @default 1
+     * @remarks 取值范围：1-100
+     */
+    page?: number;
+}
+/** 议题评论列表响应类型 */
+type IssueCommentListResponseType = IssueCommentInfoResponseType[];
+/** 创建议题评论参数类型 */
+interface CreteIssueCommentParamType extends RepoBaseParamType {
+    /** 议题ID */
+    issue_number: number;
+    /** 评论内容 */
+    body: string;
+}
+/** 创建议题评论响应类型 */
+type CreteIssueCommentResponseType = IssueCommentInfoResponseType;
+/** 更新议题评论参数类型 */
+interface UpdateIssueCommentParamType extends IssueCommentInfoParamType {
+    /** 评论内容 */
+    body: string;
+}
+/** 更新议题评论响应类型 */
+type UpdateIssueCommentResponseType = IssueCommentInfoResponseType;
+/** 删除议题评论参数类型 */
+interface RemoveIssueCommentParamType extends RepoBaseParamType {
+    /** 评论ID */
+    comment_id: string;
+}
+/** 删除议题评论响应类型 */
+interface RemoveIssueCommentResponseType {
+    /** 删除状态信息 */
+    info: string;
+}
+/** 获取子议题列表参数类型 */
+interface SubIssueListParamType extends RepoBaseParamType {
+    /** 议题ID */
+    issue_number: number;
+    /**
+     * 每页结果数量
+     * @default 30
+     */
+    per_page?: number;
+    /**
+     * 页码
+     * @default 1
+     */
+    page?: number;
+}
+/** 获取子议题列表响应类型 */
+type SubIssueListResponseType = IssueInfoResponseType[];
+/** 添加子议题参数类型 */
+interface AddSubIssueParamType extends RepoBaseParamType {
+    /** 议题ID */
+    issue_number: number;
+    /** * 子议题ID */
+    sub_issue_id: number;
+    /** * 是否替换父议题 */
+    replace_parent: boolean;
+}
+/** 添加子议题响应类型 */
+type AddSubIssueResponseType = IssueInfoResponseType;
+/** 删除子议题参数类型 */
+interface RemoveSubIssueParamType extends RepoBaseParamType {
+    /** 议题ID */
+    issue_number: number;
+    /** 子议题ID */
+    sub_issue_id: number;
+}
+/** 删除子议题响应类型 */
+type RemoveSubIssueResponseType = IssueInfoResponseType;
+/** 重新确定子议题优先级参数类型 */
+interface ReprioritizeSubIssueParamType extends RepoBaseParamType {
+    /** 议题ID */
+    issue_number: number;
+    /** 子议题ID */
+    sub_issue_id: number;
+    /**
+     * 要优先排序的子问题的 ID（与 before_id 互斥，只能指定其中一个）
+     * 在此 ID 之后放置子问题
+     */
+    after_id?: number;
+    /**
+     * 要优先排序的子问题的 ID（与 after_id 互斥，只能指定其中一个）
+     * 在此 ID 之前放置子问题
+     */
+    before_id?: number;
+}
+/** 重新确定子议题优先级响应类型 */
+type ReprioritizeSubIssueResponseType = IssueInfoResponseType;
+
+/** 创建组织仓库请求参数 */
+interface OrgRepoCreateParamType extends RepoOwnerParamType {
+    /** 仓库名称 */
+    name: string;
+    /** 仓库描述 */
+    description?: string;
+    /** 仓库主页 */
+    homepage?: string;
+    /** 仓库可见性 */
+    visibility?: 'public' | 'private';
+    /** 是否开启议题issue */
+    has_issues?: boolean;
+    /** 是否开启项目project */
+    has_projects?: boolean;
+    /** 是否开启wiki */
+    has_wiki?: boolean;
+    /** 是否开启下载 */
+    has_downloads?: boolean;
+    /** 是否设置为模板仓库 */
+    is_template?: boolean;
+    /** 仓库团队id, 这仅在组织中创建仓库时有效。 */
+    team_id?: number;
+    /** 仓库自动初始化 */
+    auto_init?: boolean;
+    /** 仓库的gitignore模板 */
+    gitignore_template?: string;
+    /** 仓库的license模板 */
+    license_template?: string;
+    /** 是否允许合并提交 */
+    allow_squash_merge?: boolean;
+    /** 是否允许变基合并提交 */
+    allow_merge_commit?: boolean;
+    /** 是否允许重新基础合并提交 */
+    allow_rebase_merge?: boolean;
+    /** 是否允许自动合并 */
+    allow_auto_merge?: boolean;
+    /** 是否删除分支后合并 */
+    delete_branch_on_merge?: boolean;
+    /** 合并提交标题格式 */
+    squash_merge_commit_title?: 'PR_TITLE' | 'COMMIT_OR_PR_TITLE';
+    /** 合并提交消息格式 */
+    squash_merge_commit_message?: 'PR_BODY' | 'COMMIT_MESSAGES' | 'BLANK';
+    /** 合并提交标题格式 */
+    merge_commit_title?: 'PR_TITLE' | 'MERGE_MESSAGE';
+    /** 合并提交消息格式 */
+    merge_commit_message?: 'PR_BODY' | 'COMMIT_MESSAGES' | 'BLANK';
+    /** 新存储库的自定义属性 */
+    custom_properties?: {
+        [key: string]: string;
+    };
+    /** 是否格式化日期 */
+    format: formatParamType['format'];
+}
+/**
+ * 组织的基本信息
+ */
+interface OrganizationBaseType extends AccountBaseType {
+    /** 组织的名称 */
+    name?: string;
+    /** 组织的描述 */
+    description: string | null;
+    /** 组织的公司名称 */
+    company?: string;
+    /** 组织的博客 URL */
+    blog: string | null;
+    /** 组织的所在地 */
+    location?: string;
+    /** 组织的邮箱地址 */
+    email?: string;
+    /** 组织的 Twitter 用户名 */
+    twitter_username?: string | null;
+    /** 组织是否已验证 */
+    is_verified?: boolean;
+    /** 账户类型（例如 "Organization"） */
+    type: string;
+    /** 创建时间 */
+    created_at: string;
+    /** 更新时间 */
+    updated_at: string;
+    /** 归档时间 */
+    archived_at: string | null;
+}
+/**
+ * 组织的计划信息
+ */
+interface OrganizationPlanType {
+    name: string;
+    space: number;
+    private_repos: number;
+    filled_seats?: number;
+    seats?: number;
+}
+/**
+ * 组织的 API URL 信息
+ */
+interface OrganizationUrlType {
+    /** 组织的 Webhook 列表 API URL */
+    hooks_url: string;
+    /** 组织的 Issues 列表 API URL */
+    issues_url: string;
+    /** 组织的成员列表 API URL 模板 */
+    members_url: string;
+    /** 组织的公开成员列表 API URL 模板 */
+    public_members_url: string;
+}
+/**
+ * 组织的仓库和 Gists 信息
+ */
+interface OrganizationRepositoryAndGistsType {
+    /** 组织的公开仓库数量 */
+    public_repos: number;
+    /** 组织的公开 Gists 数量 */
+    public_gists: number;
+    /** 组织的总私有仓库数量 */
+    total_private_repos?: number;
+    /** 组织拥有的私有仓库数量 */
+    owned_private_repos?: number;
+    /** 组织的私有 Gists 数量 */
+    private_gists?: number | null;
+    /** 组织的磁盘使用量 */
+    disk_usage?: number | null;
+}
+/**
+ * 组织的成员信息
+ */
+interface OrganizationMemberType {
+    /** 组织的关注者数量 */
+    followers: number;
+    /** 组织关注的数量 */
+    following: number;
+    /** 私有仓库中的协作者数量 */
+    collaborators?: number | null;
+}
+/**
+ * 组织的权限和配置信息
+ */
+interface OrganizationPermissionsAndConfigType {
+    /** 组织是否启用了组织项目 */
+    has_organization_projects: boolean;
+    /** 组织是否启用了仓库项目 */
+    has_repository_projects: boolean;
+    /** 组织的账单邮箱地址 */
+    billing_email?: string | null;
+    /** 组织的计划信息 */
+    plan?: OrganizationPlanType;
+    /** 默认的仓库权限 */
+    default_repository_permission?: string | null;
+    /** 成员是否可以创建仓库 */
+    members_can_create_repositories?: boolean | null;
+    /** 是否启用了两因素认证要求 */
+    two_factor_requirement_enabled?: boolean | null;
+    /** 成员允许的仓库创建类型 */
+    members_allowed_repository_creation_type?: string;
+    /** 成员是否可以创建公开仓库 */
+    members_can_create_public_repositories?: boolean;
+    /** 成员是否可以创建私有仓库 */
+    members_can_create_private_repositories?: boolean;
+    /** 成员是否可以创建内部仓库 */
+    members_can_create_internal_repositories?: boolean;
+    /** 成员是否可以创建 Pages */
+    members_can_create_pages?: boolean;
+    /** 成员是否可以创建公开 Pages */
+    members_can_create_public_pages?: boolean;
+    /** 成员是否可以创建私有 Pages */
+    members_can_create_private_pages?: boolean;
+    /** 成员是否可以 Fork 私有仓库 */
+    members_can_fork_private_repositories?: boolean | null;
+    /** 是否要求 Web 提交签名 */
+    web_commit_signoff_required?: boolean;
+    /** 控制是否允许为组织中的仓库添加和使用部署密钥 */
+    deploy_keys_enabled_for_repositories?: boolean;
+}
+/**
+ *  组织的安全配置信息
+ */
+interface OrganizationSecurityConfigType {
+    /** 对于新仓库和转移到此组织的仓库，是否启用了 GitHub Advanced Security */
+    advanced_security_enabled_for_new_repositories?: boolean;
+    /** 对于新仓库和转移到此组织的仓库，是否自动启用了 Dependabot alerts */
+    dependabot_alerts_enabled_for_new_repositories?: boolean;
+    /** 对于新仓库和转移到此组织的仓库，是否自动启用了 Dependabot security updates */
+    dependabot_security_updates_enabled_for_new_repositories?: boolean;
+    /** 对于新仓库和转移到此组织的仓库，是否自动启用了 dependency graph */
+    dependency_graph_enabled_for_new_repositories?: boolean;
+    /** 对于新仓库和转移到此组织的仓库，是否自动启用了 secret scanning */
+    secret_scanning_enabled_for_new_repositories?: boolean;
+    /** 对于新仓库和转移到此组织的仓库，是否自动启用了 secret scanning push protection */
+    secret_scanning_push_protection_enabled_for_new_repositories?: boolean;
+    /** 是否向因 push protection 而被阻止推送 secret 的贡献者显示自定义链接 */
+    secret_scanning_push_protection_custom_link_enabled?: boolean;
+    /** 显示给因 push protection 而被阻止推送 secret 的贡献者 */
+    secret_scanning_push_protection_custom_link?: string | null;
+}
+/**
+ * GitHub 组织的完整信息
+ */
+interface OrganizationInfoType extends OrganizationBaseType, OrganizationUrlType, OrganizationRepositoryAndGistsType, OrganizationMemberType, OrganizationPermissionsAndConfigType, OrganizationSecurityConfigType {
+}
+
+interface WebHookParamType {
+    /** WebHook 的 secret */
+    secret?: string;
+    /** 请求体 */
+    payload: string;
+    /** GitHub 发送的签名头 */
+    signature: string;
+}
+
+/**
+ * 格式化日期
+ * @param dateString - 日期字符串
+ * @param locale - 语言环境，默认为 'zh-cn'
+ * @param format - 日期格式，默认为 'YYYY-MM-DD HH:mm:ss'
+ * @returns 格式化后的日期字符串
+ * @example
+ * ```ts
+ * console.log(await formatDate('2025-04-16T10:00:00') // 输出 "2025-04-16 10:00:00"
+ * ```
+ */
+declare function formatDate(dateString: string, locale?: string, format?: string): Promise<string>;
+/**
+ * 获取相对时间
+ * @param dateString - 日期字符串
+ * @param locale - 语言环境，默认为 'zh-cn'
+ * @returns 相对时间
+ * @example
+ * ```ta
+ * console.log(await get_relative_time('2023-04-01 12:00:00')) // 输出 "1 小时前"
+ * ```
+ */
+declare function get_relative_time(dateString: string, locale?: string): Promise<string>;
+
+/**
+ * 生成一个用户唯一的标识符
+ * @returns 生成的唯一标识符
+ * @example
+ * ```ts
+ * const stateId = await create_state_id() // 输出 "34523452345234523452345234523452"
+ * ```
+ */
+declare function create_state_id(): Promise<string>;
+
+/**
+ * GitHub OAuth 授权管理类
+ *
+ * 提供完整的GitHub OAuth 2.0授权流程管理，包括：
+ * - 生成授权链接
+ * - 通过授权码(code)获取访问令牌(access_token)
+ * - 检查访问令牌状态
+ * - 刷新访问令牌
+ *
+ * @class Auth
+ * @extends Base GitHub基础操作类
+ */
+declare class Auth extends Base {
+    constructor(base: Base);
+    /**
+     * 生成Github App 授权链接
+     * @param state_id - 随机生成的 state_id，用于验证授权请求的状态，可选，默认不使用
+     * @returns 返回授权链接对象
+     * @returns create_auth_link 授权链接，用于跳转 Github 授权页
+     * @example
+     * ```ts
+     * const link = await auth.create_auth_link('state_id')
+     * console.log(link) // https://github.com/login/oauth/authorize?client_id=<client_id>&state=<state_id>
+     * ```
+     */
+    create_auth_link(state_id?: string): Promise<string>;
+    /**
+     * 通过 code 获取 token
+     * @param options - 获取 token 的参数
+     * - options.code - Github 返回的 code
+     * @returns 返回 token
+     * @example
+     * ```ts
+     * const token = await auth.get_token_by_code({ code: 'code' })
+     * console.log(token) // 输出token对象
+     * ```
+     */
+    get_token_by_code(options: AccessCodeType): Promise<ApiResponseType<GithubOauthTokenResponseType>>;
+    /**
+     * 获取 token 的状态
+     * @param options - 获取 token 的参数
+     * - options.access_token - Github 返回的 access_token
+     * 上一步 `get_token_by_code` 生成的 token
+     * @returns 返回 token 的状态
+     * @returns info - 返回 token 的状态信息，'Token 有效' | 'Token 无效'
+     * @example
+     * ```ts
+     * const status = await auth.check_token_status({ access_token: 'access_token' })
+     * console.log(status) // 输出token状态对象
+     */
+    check_token_status(options?: AccessTokenType): Promise<ApiResponseType<GithubOauthCheckTokenResponseType>>;
+    /**
+     * 通过 refresh_token 获取 token
+     * @param options - 获取 token 的参数
+     * - options.refresh_token - Github 返回的 refresh_token
+     * @returns 返回 token
+     * @example
+     * ```
+     * const token = await auth.refresh_token({ refresh_token: 'refresh_token' })
+     * console.log(token) // 输出token对象
+     * ```
+     */
+    refresh_token(options: RefreshTokenType): Promise<ApiResponseType<GithubOauthRefreshTokenResponseType>>;
+}
+
+/**
+ * Base 提交操作类
+ *
+ * 提供对GitHub Commit的CRUD操作，包括：
+ * - 获取一个提交信息
+ */
+declare class Commit extends Base {
+    constructor(base: Base);
+    /**
+     * 获取一个提交信息
+     * 权限:
+     * — Contents: read-only
+     * @param options - 提交信息参数对象
+     * - url 仓库URL地址
+     * - owner 仓库拥有者
+     * - repo 仓库名称
+     * url参数和owner、repo参数传入其中的一种
+     * - sha 提交的SHA值，如果不提供，则默认获取仓库的默认分支的最新提交信息
+     * - format - 可选，是否格式化提交信息, 默认为false
+     * @returns 提交信息
+     * @example
+     * ```ts
+     * const commitInfo = await commit.get_commit_info({ owner: 'owner', repo: 'repo' })
+     * console.log(commitInfo)
+     * ```
+     */
+    get_commit_info(options: CommitInfoParamType): Promise<ApiResponseType<CommitInfoResponseType>>;
+}
+
+/**
+ * GitHub Issue 处理类，提供WebHook相关操作功能
+ *
+ * 提供完整的GitHub Issue管理，包括：
+ * - 获取Issue列表
+ * - 获取Issue详情
+ * - 创建/更新/关闭/打开/锁定/解锁Issue
+ * - 获取仓库评论列表
+ * - 获取/创建/更新/删除Issue评论
+ * - 管理子Issue
+ *
+ * @remarks 每个拉取请求都是一个议题，但并非每个议题都是拉取请求。
+ */
+declare class Issue extends Base {
+    constructor(base: Base);
+    /**
+     * 获取Issue详情
+     * 权限:
+     * - Issues: Read-only
+     * @param options 请求参数列表
+     * - url 仓库URL地址
+     * - owner 仓库拥有者
+     * - repo 仓库名称
+     * - issue_number Issue编号
+     * url参数和owner、repo参数传入其中的一种
+     * @returns 包含Issue信息的响应对象
+     * @example
+     * ```ts
+     * const issue = get_issue() // 获取issue实例
+     * const res = await issue.get_issue_info({ owner: 'owner', repo:'repo', issue_number:1 })
+     * console.log(res) // { data: IssueInfoResponseType }
+     * ```
+     */
+    get_issue_info(options: IssueInfoParamType): Promise<ApiResponseType<IssueInfoResponseType>>;
+    /**
+     * 获取仓库的Issue列表
+     * 权限:
+     * - Issues:Read-only
+     * @param options 请求参数列表
+     * - url 仓库URL地址
+     * - owner 仓库拥有者
+     * - repo 仓库名称
+     * url参数和owner、repo参数传入其中的一种
+     * - milestones 里程碑ID列表
+     * - state  Issue状态，可选 'open' | 'closed' | 'all', 默认为'all'
+     * - labels 标签名称列表
+     * - assignee  指派人用户名
+     * - type  问题类型
+     * - creator  创建者用户名
+     * - mentioned  提及的用户名
+     * - sort  排序方式，可选 'created' | 'updated' | 'comments', 默认为'created'
+     * - direction  排序方向，可选 'asc' | 'desc', 默认为'desc'
+     * - since  筛选此时间之后的问题
+     * - per_page  每页数量，可选，默认为30
+     * - page  页码，可选，默认为1
+     * @returns 包含Issue列表的响应对象
+     * @example
+     * ```ts
+     * const issue = get_issue() // 获取issue实例
+     * const res = await issue.get_issue_list({ owner: 'owner', repo: 'repo' })
+     * console.log(res) // { data: IssueListResponseType[] }
+     * ```
+     */
+    get_repo_issue_list(options: RepoIssueListParamType): Promise<ApiResponseType<IssueListResponseType>>;
+    /**
+     * 创建一个Issue
+     * 权限:
+     * - Issues: Write
+     * @param options 发送Issue的参数对象
+     * - owner 仓库拥有者
+     * - repo 仓库名称
+     * - title 标题
+     * - body 内容
+     * - assignee 指派人
+     * - milestone 里程碑
+     * - labels 标签列表
+     * - type 问题类型
+     * @returns 包含Issue信息的响应对象
+     * @example
+     * ```ts
+     * const issue = get_issue() // 获取issue实例
+     * const res = await issue.create_issue({ owner: 'owner', repo:'repo', title:'title', body:'body' })
+     * console.log(res) // { data: CreateIssueResponseType }
+     * ```
+     */
+    create_issue(options: CreteIssueParamType): Promise<ApiResponseType<CreateIssueResponseType>>;
+    /**
+     * 更新一个Issue
+     * 权限:
+     * - Issues: Write
+     * - Pull requests: Write
+     * 需以上权限之一
+     * @param options 更新Issue的参数对象
+     * - owner 仓库拥有者
+     * - repo 仓库名称
+     * - issue_number Issue编号
+     * - title 标题
+     * - body 内容
+     * - assignee 指派人
+     * - milestone 里程碑
+     * - labels 标签列表
+     * - type 问题类型
+     * @returns 包含Issue信息的响应对象
+     * @example
+     * ```ts
+     * const issue = get_issue() // 获取issue实例
+     * const res = await issue.update_issue({ owner: 'owner', repo:'repo', issue_number:1, title:'title', body:'body' })
+     * console.log(res) // { data: CreateIssueResponseType }
+    * ```
+     */
+    update_issue(options: UpdateIssueParamType): Promise<ApiResponseType<UpdateIssueResponseType>>;
+    /**
+     * 重新打开一个Issue
+     * 权限:
+     * - Issues: Write
+     * - Pull requests: Write
+     * 需以上权限之一
+     * @param options 打开Issue的参数对象
+     * - owner 仓库拥有者
+     * - repo 仓库名称
+     * - issue_number Issue编号
+     * @returns 包含Issue信息的响应对象
+     * @example
+     * ```ts
+     * const issue = get_issue() // 获取issue实例
+     * const res = await issue.open_issue({ owner: 'owner', repo:'repo', issue_number:1 })
+     * console.log(res) // { data: CreateIssueResponseType }
+     * ```
+     */
+    open_issue(options: OpenIssueParamType): Promise<ApiResponseType<OpenIssueResponseType>>;
+    /**
+     * 重新打开一个议题
+     * 权限:
+     * - Issues: Write
+     * - Pull requests: Write
+     * 需以上权限之一
+     * @deprecated 请使用 open_issue 方法代替
+     */
+    reopen_issue(options: OpenIssueParamType): Promise<ApiResponseType<OpenIssueResponseType>>;
+    /**
+     * 关闭一个Issue
+     * 权限:
+     * - Issues: Write
+     * - Pull requests: Write
+     * 需以上权限之一
+     * @param options 关闭Issue的参数对象
+     * - owner 仓库拥有者
+     * - repo 仓库名称
+     * - issue_number Issue编号
+     * - state_reason 关闭原因
+     * @returns 包含Issue信息的响应对象
+     * @example
+     * ```ts
+     * const issue = get_issue() // 获取issue实例
+     * const res = await issue.close_issue({ owner: 'owner', repo:'repo', issue_number:1, state_reason:'completed' })
+     * console.log(res) // { data: CreateIssueResponseType }
+     * ```
+     */
+    close_issue(options: CloseIssueParamType): Promise<ApiResponseType<CloseIssueResponseType>>;
+    /**
+     * 锁定一个Issue
+     * 权限:
+     * - Issues: Write
+     * - Pull requests: Write
+     * 需以上权限之一
+     * @param options 锁定Issue的参数对象
+     * - owner 仓库拥有者
+     * - repo 仓库名称
+     * - issue_number Issue编号
+     * - lock_reason 锁定原因 可选 'off-topic' | 'too heated' | 'resolved' | 'spam'
+     * @returns 锁定状态信息
+     * @example
+     * ```ts
+     * const issue = get_issue() // 获取issue实例
+     * const res = await issue.lock_issue({ owner: 'owner', repo:'repo', issue_number:1, lock_reason:'off-topic' })
+     * console.log(res) // { data: LockIssueResponseType }
+     * ```
+     */
+    lock_issue(options: LockIssueParamType): Promise<ApiResponseType<LockIssueResponseType>>;
+    /**
+     * 解锁一个Issue
+     * 权限:
+     * - Issues: Write
+     * - Pull requests: Write
+     * 需以上权限之一
+     * @param options 解锁Issue的参数对象
+     * - owner 仓库拥有者
+     * - repo 仓库名称
+     * - issue_number Issue编号
+     * @returns 解锁状态信息
+     * @example
+     * ```ts
+     * const issue = get_issue() // 获取issue实例
+     * const res = await issue.unlock_issue({ owner: 'owner', repo:'repo', issue_number})
+     * console.log(res) // { data: UnLockIssueResponseType }
+     * ```
+     */
+    unlock_issue(options: UnLockIssueParamType): Promise<ApiResponseType<UnLockIssueResponseType>>;
+    /**
+     * 获取一个仓库下Issue的评论列表
+     * 权限:
+     * - Issues: Read-only
+     * - Pull requests: Read-only
+     * 需以上权限之一
+     * @param options 获取Issue评论列表的参数对象
+     * - owner 仓库拥有者
+     * - repo 仓库名称
+     * - sort 排序方式 可选 'created' | 'updated'
+     * - direction 排序方向 可选 'asc' | 'desc'，当sort不存在时此参数会被忽略
+     * - since 评论时间
+     * - per_page 每页评论数量
+     * - page 页码
+     * @returns 包含Issue评论列表的响应对象
+     * @example
+     * ```ts
+     * const issue = get_issue() // 获取issue实例
+     * const res = await issue.get_issue_comment_list({ owner: 'owner', repo:'repo', issue_number:1 })
+     * console.log(res) // { data: IssueCommentListResponseType[] }
+     * ```
+     */
+    get_repo_comment_list(options: RepoCommentListParamType): Promise<ApiResponseType<RepoCommentListResponseType>>;
+    /**
+     * 获取一个Issue下的评论列表
+     * 权限:
+     * - Issues: Read-only
+     * - Pull requests: Read-only
+     * 需以上权限之一
+     * @param options 获取Issue评论列表的参数对象
+     * - owner 仓库拥有者
+     * - repo 仓库名称
+     * - issue_number Issue编号
+     * - since 评论时间
+     * - per_page 每页评论数量
+     * - page 页码
+     * @returns 包含Issue评论列表的响应对象
+     * @example
+     * ```ts
+     * const issue = get_issue() // 获取issue实例
+     * const res = await issue.get_issue_comment_list({ owner: 'owner', repo:'repo', issue_number:1 })
+     * console.log(res) // { data: IssueCommentListResponseType[] }
+     * ```
+     */
+    get_issue_comment_list(options: IssueCommentListParamType): Promise<ApiResponseType<IssueCommentListParamType>>;
+    /**
+     * 获取Issue评论信息
+     * 权限:
+     * - Issues: Read-only
+     * - Pull requests: Read-only
+     * 需以上权限之一
+     * @param options 获取Issue评论信息的参数对象
+     * - owner 仓库拥有者
+     * - repo 仓库名称
+     * - comment_id 评论ID
+     * @returns Issue评论信息
+     * @example
+     * ```ts
+     * const issue = get_issue() // 获取issue实例
+     * const res = await issue.get_issue_comment({ owner: 'owner', repo:'repo', comment_id:1 })
+     * console.log(res) // { data: IssueCommentInfoResponseType }
+     * ```
+     */
+    get_issue_comment_info(options: IssueCommentInfoParamType): Promise<ApiResponseType<IssueCommentInfoResponseType>>;
+    /**
+     * 创建一个Issue评论
+     * 权限:
+     * - Issues: Write
+     * - Pull requests: Write
+     * 需以上权限之一
+     * @param options 创建Issue评论的参数对象
+     * - owner 仓库拥有者
+     * - repo 仓库名称
+     * - issue_number Issue编号
+     * - body 评论内容
+     * @returns 创建的Issue评论信息
+     * @example
+     * ```ts
+     * const issue = get_issue() // 获取issue实例
+     * const res = await issue.create_issue_comment({ owner: 'owner', repo:'repo', issue_number:1, body:'comment' })
+     * console.log(res) // { data: CreteIssueCommentResponseType }
+     * ```
+     */
+    create_issue_comment(options: CreteIssueCommentParamType): Promise<ApiResponseType<CreteIssueCommentResponseType>>;
+    /**
+     * 更新Issue评论信息
+     * 权限:
+     * - Issues: Write
+     * - Pull requests: Write
+     * 需以上权限之一
+     * @param options 更新Issue评论信息的参数对象
+     * - owner 仓库拥有者
+     * - repo 仓库名称
+     * - comment_id 评论ID
+     * - body 评论内容
+     * @returns 更新后的Issue评论信息
+     * @example
+     * ```ts
+     * const issue = get_issue() // 获取issue实例
+     * const res = await issue.update_issue_comment({ owner: 'owner', repo:'repo', comment_id:1, body:'body' })
+     * console.log(res) // { data: UpdateIssueCommentResponseType }
+     * ```
+     */
+    update_issue_comment(options: UpdateIssueCommentParamType): Promise<ApiResponseType<UpdateIssueCommentResponseType>>;
+    /**
+     * 删除Issue评论信息
+     * 权限:
+     * - Issues: Write
+     * - Pull requests: Write
+     * 需以上权限之一
+     * @param options 删除Issue评论信息的参数对象
+     * - owner 仓库拥有者
+     * - repo 仓库名称
+     * - comment_id 评论ID
+     * @returns 删除结果信息
+     * @example
+     * ```ts
+     * const issue = get_issue() // 获取issue实例
+     * const res = awaitissue.remove_issue_comment()
+     * console.log(res) // { data: RemoveIssueCommentResponseType }
+     * ```
+     */
+    remove_issue_comment(options: RemoveIssueCommentParamType): Promise<ApiResponseType<RemoveCollaboratorResponseType>>;
+    /**
+     * 删除Issue评论信息
+     * 权限:
+     * - Issues: Write
+     * - Pull requests: Write
+     * 需以上权限之一
+     * @deprecated 请使用 remove_issue_comment 方法代替
+     */
+    delete_issue_comment(options: RemoveIssueCommentParamType): Promise<ApiResponseType<RemoveCollaboratorResponseType>>;
+    /**
+     * 获取子议题列表
+     * 权限:
+     * - Issues: Read-only
+     * - Pull requests: Read-only
+     * 需以上权限之一
+     * @param options 获取子议题列表的参数对象
+     * - owner 仓库拥有者
+     * - repo 仓库名称
+     * - issue_number 议题编号
+     * @returns 子议题列表
+     * @example
+    * ```ts
+    * const issue = get_issue() // 获取issue实例
+    * const res = await issue.get_sub_issue_list({ owner: 'owner', repo:'repo', issue_number:1 })
+    * console.log(res) // { data: SubIssueListResponseType }
+    * ```
+    */
+    get_sub_issue_list(options: SubIssueListParamType): Promise<ApiResponseType<SubIssueListResponseType>>;
+    /**
+     * 添加子议题
+     * 添加一个子议题到指定的议题中
+     * 权限：
+     * - Issues：Write
+     * @param options 添加子议题的参数对象
+     * - owner 仓库拥有者
+     * - repo 仓库名称
+     * - issue_number 父议题编号
+     * - sub_issue_id 子议题编号
+     * - replace_parent 是否替换父议题
+     * @returns 添加结果信息
+     * @example
+     * ```ts
+     * const issue = get_issue() // 获取issue实例
+     * const res = await issue.add_sub_issue({ owner: 'owner', repo:'repo', issue_number:1, sub_issue_id:1, replace_parent:true })
+     * console.log(res) // { data: AddSubIssueResponseType }
+     * ```
+     */
+    add_sub_issue(options: AddSubIssueParamType): Promise<ApiResponseType<AddSubIssueResponseType>>;
+    /**
+     * 删除子议题
+     * 权限：
+     * - Issues：Write
+     * @param options 删除子议题的参数对象
+     * - owner 仓库拥有者
+     * - repo 仓库名称
+     * - issue_number 父议题编号
+     * - sub_issue_id 子议题编号
+     * @returns 删除结果信息
+    * @example
+    * ```ts
+    * const issue = get_issue() // 获取issue实例
+    * const res = await issue.remove_sub_issue({ owner: 'owner', repo:'repo', issue_number:1, sub_issue_id:1 })
+    * console.log(res) // { data: RemoveSubIssueResponseType }
+    * ```
+    */
+    remove_sub_issue(options: RemoveSubIssueParamType): Promise<ApiResponseType<RemoveSubIssueResponseType>>;
+    /**
+     * 删除子议题
+     * 删除一个子议题
+     * 权限：
+     * - Issues：Write
+     * @deprecated 请使用 remove_sub_issue 方法代替
+     */
+    delete_sub_issue(options: RemoveSubIssueParamType): Promise<ApiResponseType<RemoveSubIssueResponseType>>;
+    /**
+     * 重新排序子议题
+     * 重新确定子议题优先级
+     * 权限：
+     * - Issues：Write
+     * @param options 重新排序子议题的参数对象
+     * - owner 仓库拥有者
+     * - repo 仓库名称
+     * - issue_number 父议题编号
+     * - sub_issue_id 子议题编号
+     * - before_id 指定要在哪个子议题之前插入，传入目标子议题的编号
+     * - after_id 指定要在哪个子议题之后插入，传入目标子议题的编号
+     * @example
+     * ```ts
+     * const issue = get_issue() // 获取issue实例
+     * const res = await issue.reprioritize_sub_issue({ owner: 'owner', repo:'repo', issue_number:1, sub_issue_id:1, before_id:1 })
+     * console.log(res) // { data: ReprioritizeSubIssueResponseType }
+     * ```
+     */
+    reprioritize_sub_issue(options: ReprioritizeSubIssueParamType): Promise<ApiResponseType<ReprioritizeSubIssueResponseType>>;
+}
+
+/**
+ * Base 组织操作类
+ *
+ * 提供对GitHub组织的CRUD操作，包括：
+ * - 获取组织信息
+ */
+declare class Org extends Base {
+    constructor(base: Base);
+    /**
+     * 获取组织信息
+     * 权限:
+     * - Plan: Read-only ，若需要获取组织计划则需要该权限，并且是组织所有者
+     * @param options 组织参数
+     * - org 组织名称
+     * @returns 组织信息
+     * @example
+     * ```ts
+     * const orgInfo = await org.get_org_info({ org: 'org' })
+     * console.log(orgInfo)
+     * ```
+     */
+    get_org_info(options: OrganizationNameParamType): Promise<ApiResponseType<OrganizationInfoType>>;
+}
+
+/**
+ * GitHub 仓库操作类
+ *
+ * 提供对GitHub仓库的完整CRUD操作接口，包括：
+ * - 组织/用户仓库的查询、创建、删除
+ * - 仓库详细信息的获取
+ * - 仓库可见性检查
+ * - 支持通过URL或owner/repo两种方式操作仓库
+ *
+ */
+declare class Repo extends Base {
+    constructor(base: Base);
+    /**
+     * 获取组织仓库列表
+     * 权限: Metadata - Read-only , 如果获取公开仓库可无需此权限
+     * @param options - 请求参数对象
+     * - org - 组织名称
+     * - type - 仓库类型，可选值：'all' | 'public' | 'private' | 'forks' | 'sources' | 'member', 默认值：'all'
+     * - sort - 排序字段，可选值：'created' | 'updated' | 'pushed' | 'full_name', 默认值：'created'
+     * - direction - 排序方向，可选值：'asc' | 'desc', 默认值：'desc'
+     * - per_page - 每页数量（1-100）, 默认值：30
+     * - page - 页码 默认值：1
+     * @returns 组织仓库列表
+     * @example
+     * ```ts
+     * const repos = await repo.get_org_repos_list({ org: 'org' })
+     * console.log(repos)
+     * ```
+     */
+    get_org_repos_list(options: OrgRepoListParmsType): Promise<ApiResponseType<OrgRepoListType>>;
+    /**
+     * 查询仓库详细信息
+     * 权限: Metadata - read-only , 如果获取公开仓库可无需此权限
+     * @param options - 请求参数对象
+     * - type - 仓库类型，可选值：可选all， public， private
+     * - visibility - 仓库可见性，可选值：'public' | 'private' | 'internal', 默认值：'all'
+     * - affiliation - 仓库关联，可选值：'owner' | 'collaborator' | 'organization_member', 默认值：'owner,collaborator,organization_member'
+     * - sort - 排序字段，可选值：'created' | 'updated' | 'pushed' | 'full_name', 默认值：'created'
+     * - direction - 排序方向，可选值：'asc' | 'desc', 默认值：'desc'
+     * - per_page - 每页数量（1-100）, 默认值：30
+     * - page - 页码 默认值：1
+     * @returns 仓库详细信息
+     * @example
+     * ```ts
+     * const repos = await repo.get_repos_list({ username: 'username' })
+     * console.log(repos)
+     * ```
+     */
+    get_user_repos_list_by_token(options?: UserByTokenRepoListParamType): Promise<ApiResponseType<UserRepoListType>>;
+    /**
+     * 获取用户仓库列表
+     * 权限:
+     * - Metadata: Read-only, 如果只获取公开仓库可无需此权限
+     * @param options - 请求参数对象
+     * - username - 用户名
+     * 优先获取授权用户仓库列表，若授权用户不存在则获取指定用户仓库列表
+     * - type - 仓库类型，可选值：all， owner， member，, 默认值：'all'
+     * - sort - 排序字段，可选值：'created' | 'updated' | 'pushed' | 'full_name', 默认值：'created'
+     * - direction - 排序方向，可选值：'asc' | 'desc', 默认值：'desc'
+     * - per_page - 每页数量（1-100）, 默认值：30
+     * - page - 页码 默认值：1
+     * @returns 用户仓库列表
+     */
+    get_user_repos_list(options: UserRepoListParamType): Promise<ApiResponseType<UserRepoListType>>;
+    /**
+     * 获取仓库信息
+     * 权限:
+     * - Metadata: Read-only, 如果只获取公开仓库可无需此权限
+     * @param options - 仓库信息参数对象，必须包含以下两种组合之一：
+     * - options.url 仓库URL地址
+     * - options.owner 仓库拥有者
+     * - options.repo 仓库名称
+     * url参数和owner、repo参数传入其中的一种
+     * @example
+     * ```ts
+     * const repo = await repo.get_repo_info({ url: 'https://github.com/ClarityJS/git-neko-kit' })
+     * console.log(repo)
+     * ```
+     */
+    get_repo_info(options: RepoInfoParamType): Promise<ApiResponseType<RepoInfoResponseType>>;
+    /**
+     * 创建组织仓库
+     * 权限：
+     * - Administration: Read and write
+     * @param options 创建组织仓库参数
+     * - owner: 组织名称
+     * - name: 仓库名称
+     * - description: 仓库描述
+     * - homepage: 仓库主页URL
+     * - visibility: 仓库可见性，可选值：'public' | 'private', 默认值：'public'
+     * - has_issues: 是否启用issues功能, 默认值：true
+     * - has_projects: 是否启用projects功能, 默认值：true
+     * - has_wiki: 是否启用wiki功能, 默认值：true
+     * - has_downloads: 是否启用下载功能 默认值：true
+     * - is_template: 是否设置为模板仓库 默认值：false
+     * - team_id: 关联团队ID（组织仓库专用）
+     * - auto_init: 是否自动初始化仓库 默认值：false
+     * - gitignore_template: gitignore模板名称（需配合auto_init使用）
+     * - license_template: license模板名称（需配合auto_init使用）
+     * - allow_squash_merge: 是否允许squash merge, 默认值：true
+     * - allow_merge_commit: 是否允许普通合并, 默认值：true
+     * - allow_rebase_merge: 是否允许rebase合并 默认值：true
+     * - allow_auto_merge: 是否允许自动合并 默认值：false
+     * - delete_branch_on_merge: 合并后是否自动删除分支 默认值：false
+     * - squash_merge_commit_title: squash合并提交标题格式 默认值：'PR_TITLE'
+     * - squash_merge_commit_message: squash合并提交信息格式 默认值：'PR_BODY'
+     * - merge_commit_title: 合并提交标题格式 默认值：'PR_TITLE'
+     * - merge_commit_message: 合并提交信息格式 默认值：'PR_BODY'
+     * - custom_properties: 自定义键值对属性
+     * @returns 返回创建成功的仓库信息
+     */
+    create_org_repo(options: OrgRepoCreateParamType): Promise<ApiResponseType<RepoInfoResponseType>>;
+    /**
+     * 获取协作者列表
+     * 权限：
+     * - Metadata: Read
+     * @param options 获取协作者列表对象
+     * - owner: 仓库拥有者
+     * - repo: 仓库名称
+     * - url: 仓库地址
+     * url和owner、repo参数传入其中的一种
+     * - affiliation: 协作者类型，可选outside, direct, all，默认为all
+     * - permission: 协作者权限，可选pull，triage, push, maintain, admin，默认为pull
+     * - per_page: 每页数量，默认为30
+     * - page: 页码，默认为1
+     * @returns 返回获取协作者列表结果
+     * @example
+     * ```ts
+     * const result = await collaborator.get_collaborator_list(options)
+     * console.log(result)
+     * ```
+     */
+    get_collaborator_list(options: CollaboratorListParamType): Promise<ApiResponseType<CollaboratorListResponseType>>;
+    /**
+     * 邀请协作者
+     * 权限：
+     * - Administration: Read and write
+     * @param options 邀请协作者对象
+     * - owner: 仓库拥有者
+     * - repo: 仓库名称
+     * - url: 仓库地址
+     * owner和repo或者url选择一个即可
+     * - username: 要邀请协作者用户名
+     * - permission: 协作者权限，可选pull，triage, push, maintain, admin，默认为pull
+     * @returns 返回邀请协作者结果
+     * @example
+     * ```ts
+     * const result = await collaborator.add_collaborator({
+     *  owner: 'owner',
+     *  repo: 'repo',
+     *  username: 'username',
+     *  permission: 'pull'
+     * })
+     * console.log(result)
+     * ```
+     */
+    add_collaborator(options: CollaboratorParamType): Promise<ApiResponseType<AddCollaboratorResponseType>>;
+    /**
+     * 删除协作者
+     * 权限：
+     * - Administration: Read and write
+     * @param options 删除协作者对象
+     * - owner: 仓库拥有者
+     * - repo: 仓库名称
+     * - url: 仓库地址
+     * owner和repo或者url选择一个即可
+     * - username: 要删除协作者用户名
+     * @returns 返回删除协作者结果
+     * @example
+     * ```ts
+     * const result = await collaborator.remove_collaborator({
+     *  owner: 'owner',
+     *  repo:'repo',
+     *  username: 'username'
+     * })
+     * console.log(result)
+     * ```
+     */
+    remove_collaborator(options: RemoveCollaboratorParamType): Promise<ApiResponseType<RemoveCollaboratorResponseType>>;
+    /**
+     * 快速获取仓库可见性
+     * 权限:
+     * - Metadata: Read-only, 如果只获取公开仓库可无需此权限
+     * @param options
+     * - url 仓库URL地址
+     * - owner 仓库拥有者
+     * - repo 仓库名称
+     * url参数和owner、repo参数传入其中的一种
+     * @remarks 优先使用url参数，若url参数不存在则使用owner和repo参数
+     * @returns 仓库可见性，
+     * @example
+     * ```ts
+     * const visibility = await repo.get_repo_visibility({url: 'https://github.com/ClarityJS/git-neko-kit'})
+     * console.log(visibility) // 输出 public 或 private
+     * ```
+     */
+    get_repo_visibility(options: RepoInfoParamType): Promise<RepoVisibilityResponseType['visibility'] | null>;
+    /**
+     * 获取仓库默认分支
+     * 权限:
+     * - Metadata: Read-only, 如果只获取公开仓库可无需此权限
+     * @param options
+     * - url 仓库URL地址
+     * - owner 仓库拥有者
+     * - repo 仓库名称
+     * url参数和owner、repo参数传入其中的一种
+     * @example
+     * ```ts
+     * const defaultBranch = await repo.get_repo_default_branch({url: 'https://github.com/ClarityJS/meme-plugin')}
+     * console.log(defaultBranch) // 输出 main
+     * ```ts
+     */
+    get_repo_default_branch(options: RepoInfoParamType): Promise<RepoDefaultBranchResponseType['default_branch']>;
+}
+
+/**
+ * Base 用户操作类
+ *
+ * 提供对GitHub用户的CRUD操作，包括：
+ * - 获取用户信息
+ * - 关注指定用户
+ */
+declare class User extends Base {
+    constructor(base: Base);
+    /**
+     * 获取指定的用户信息
+     * 不止可以获取用户信息还可以获取组织信息
+     * 权限：无需任何权限
+     * @param options - 用户参数
+     * - username - 用户名或组织名
+     * @example
+     * ```ts
+     * const userInfo = await user.get_user_info({ username: 'username' })
+     * console.log(userInfo)
+     * ```
+     */
+    get_user_info(options: UserInfoParamType): Promise<ApiResponseType<UserInfoResponseType>>;
+    /**
+     * 通过用户id获取用户信息
+     * user_id 不是用户名, 而是github平台上用户的唯一标识符
+     * 权限：无需任何权限
+     * @param options - 用户参数
+     * - user_id： 用户id
+     * @returns 用户信息
+     * @example
+     * ```ts
+     * const userInfo = await user.get_user_info_by_user_id({ user_id: 123456789 })
+     * console.log(userInfo)
+     * ```
+     */
+    get_user_info_by_user_id(options: UserIdParamType): Promise<ApiResponseType<UserInfoResponseType>>;
+    /**
+     * 通过访问令牌获取用户信息
+     * 权限：无需任何权限
+     * @param options - 访问令牌配置参数对象
+     * - access_token - 访问令牌
+     * @example
+     * ```ts
+     * const userInfo = await user.get_user_info_by_token({ access_token: 'access_token' })
+     * console.log(userInfo)
+     * ```
+     */
+    get_user_info_by_token(options?: UserInfoByTokenParamType): Promise<ApiResponseType<UserInfoResponseType>>;
+    /**
+     * 获取用户贡献数据
+     * 权限：无需任何权限
+     * @param options - 用户参数
+     * - username: 用户名
+     * @returns 用户贡献数据
+     * @example
+     * ```ts
+     * const contribution = await user.get_user_contribution({ username: 'username' })
+     * console.log(contribution)
+     * ```
+     */
+    get_user_contribution(options: UserNameParamType): Promise<ApiResponseType<ContributionResult>>;
+    /**
+     * 快速获取获取用户id
+     * 权限：无需任何权限
+     * 该方法会自动获取当前用户的id，需要传入token
+     * @returns 用户id
+     * @example
+     * ```ts
+     * const userId = await user.get_user_id()
+     * console.log(userId)
+     */
+    get_user_id(): Promise<number | null>;
+    /**
+     * 快速获取获取用户名
+     * 权限：无需任何权限
+     * 该方法会自动获取当前用户的用户名，需要传入token
+     * @returns 用户名
+     * @example
+     * ```ts
+     * const username = await user.get_username()
+     * console.log(username)
+     * ```
+     */
+    get_username(): Promise<string | null>;
+    /**
+     * 快速获取获取用户昵称
+     * 该方法会自动获取当前用户的昵称，需要传入token
+     * 权限：无需任何权限
+     * @remarks 用户昵称可能会为null
+     * @returns 昵称
+     * @example
+     * ```ts
+     * const nickname = await user.get_nickname()
+     * console.log(nickname)
+     * ```
+     */
+    get_nickname(): Promise<string | null>;
+    /**
+     * 快速获取获取用户邮箱
+     * 该方法会自动获取当前用户的邮箱，需要传入token
+     * 权限：无需任何权限
+     * @returns 邮箱
+     * @example
+     * ```ts
+     * const email = await user.get_email()
+     * console.log(email)
+     * ```
+     */
+    get_user_email(): Promise<string | null>;
+    /**
+     * 快速获取获取用户头像地址
+     * 该方法会自动获取当前用户的头像地址，需要传入token
+     * 权限：无需任何权限
+     * @returns 头像地址
+     * @example
+     * ```ts
+     * const avatarUrl = await user.get_avatar_url()
+     * console.log(avatarUrl)
+     * ```
+     */
+    get_avatar_url(): Promise<string | null>;
+}
+
+/**
+ * Base WebHook操作类
+ *
+ * 提供对GitHub WebHook的CRUD操作，包括：
+ * - 检查webhook签名是否正确
+ */
+declare class WebHook extends Base {
+    constructor(base: Base);
+    /**
+     * 检查WebHook签名是否正确
+     * 权限：无需任何权限
+     * @param options - WebHook参数对象，必须包含以下参数：
+     * - secret: WebHook的密钥, 可以从Base类入口传递
+     * - payload: 要验证的签名主体
+     * - signature: 要验证的签名
+     * @returns 验证结果
+     * @example
+     * ```ts
+     * const res = await check_webhook_signature({
+     *   secret: 'your_secret',
+     *   payload: 'your_payload',
+     *   signature: 'your_signature'
+     * })
+     * ```
+     */
+    check_webhook_signature(options: WebHookParamType): Promise<ApiResponseType<boolean>>;
+}
+
+/**
+ * GitHub API 基础服务类，提供与GitHub API交互的核心功能
+ *
+ * 此类作为GitHub API功能的入口点，封装了以下核心能力：
+ * - JWT令牌生成与管理
+ * - 请求代理配置
+ * - 基础HTTP请求方法(GET/POST)
+ * - 应用认证管理
+ * - 模块化服务(App/Auth/Commit/Repo/User/WebHook)
+ *
+ * @example
+ * ```ts
+ * const base = new Base({
+ *   APP_ID: 12345,
+ *   Private_Key: '-----BEGIN PRIVATE KEY-----...',
+ *   Client_ID: 'Iv1.1234567890abcdef',
+ *   Client_Secret: 'abcdef1234567890abcdef1234567890abcdef12',
+ *   WebHook_Secret: 'webhook_secret'
+ * });
+ * ```
+ */
+declare class Base {
+    app: App;
+    auth: Auth;
+    commit: Commit;
+    repo: Repo;
+    user: User;
+    webhook: WebHook;
+    issue: Issue;
+    org: Org;
+    BaseUrl: string;
+    ApiUrl: string;
+    jwtToken: string;
+    userToken: string | null;
+    readonly format: boolean;
+    readonly Private_Key: string;
+    readonly Client_ID: string;
+    readonly Client_Secret: string;
+    readonly WebHook_Secret: string;
+    private currentRequestConfig;
+    private proxy?;
+    constructor(options: GitHubAuthType);
+    /**
+     * 获取App实例
+     * @returns App实例
+     * @example
+     * ```ts
+     * const app = await base.get_app()
+     * ```
+     */
+    get_app(): Promise<App>;
+    /**
+     * 获取Auth实例
+     * @returns Auth实例
+     * @example
+     * ```ts
+     * const auth = await base.get_auth()
+     * ```
+     */
+    get_auth(): Promise<Auth>;
+    /**
+     * 获取Commit实例
+     * @returns Commit实例
+     * @example
+     * ```ts
+     * const commit = await base.get_commit()
+     * ```
+     */
+    get_commit(): Promise<Commit>;
+    /**
+     * 获取Issue实例
+     * @returns Issue实例
+     * @example
+     * ```ts
+     * const issue = await base.get_issue()
+     * ```
+     */
+    get_issue(): Promise<Issue>;
+    /**
+     * 获取Repo实例
+     * @returns Repo实例
+     * @example
+     * ```ts
+     * const repo = await base.get_repo()
+     * ```
+     */
+    get_repo(): Promise<Repo>;
+    /**
+     * 获取User实例
+     * @returns User实例
+     * @example
+     * ```ts
+     * const user = await base.get_user()
+     * ```
+     */
+    get_user(): Promise<User>;
+    /**
+     * 获取Org实例
+     * @returns Org实例
+     * @example
+     * ```ts
+     * const org = await base.get_org()
+     * ```
+     */
+    get_org(): Promise<Org>;
+    /**
+     * 获取WebHook实例
+     * @returns WebHook实例
+     * @example
+     * ```ts
+     * const webhook = await base.get_webhook()
+     * ```
+     */
+    get_webhook(): Promise<WebHook>;
+    /**
+     * 设置请求代理
+     * @param proxy 代理参数
+     * @example
+     * ```ts
+     *  setProxy({
+     *    type: 'http',
+     *    address: 'http://127.0.0.1:7890'
+     * })
+     * ```
+     */
+    setProxy(proxy: ProxyParamsType): void;
+    /**
+     * 设置 token
+     * 传入的 token 必须以 ghu_ 开头，否则会抛出错误
+     * @param token 传入的 token
+     * @example
+     * ```ts
+     * setToken('ghu_xxxx')
+     * ```
+     */
+    setToken(token: string): this;
+    /**
+     * 生成 JWT Token
+     * @param options 生成 JWT 所需的参数
+     * @param options.APP_ID GitHub App ID
+     * @param options.Private_Key 私钥内容
+     * @returns 返回生成的 JWT
+     */
+    private generate_jwt;
+    /**
+     * 设置当前请求的配置
+     * @protected - 仅在类内部访问
+     * @param config - 配置对象，包含以下属性:
+     * - url: 请求的URL
+     * - token: 认证令牌
+     * - tokenType: 认证令牌类型，默认为 'Bearer'
+     */
+    protected setRequestConfig(config: RequestConfigType): void;
+    /**
+     * 创建一个新的请求实例
+     * @returns 返回一个新的 Request 实例
+     */
+    private createRequest;
+    /**
+     * Github GET 请求方法
+     * @param path - 请求路径
+     * @param parms - 请求参数
+     * @param customHeaders - 请求头，选项
+     * @returns 请求结果
+     */
+    get(path: string, parms?: any, customHeaders?: Record<string, string>): Promise<ApiResponseType>;
+    /**
+     * Github POST 请求方法
+     * @param path - 请求路径
+     * @param data - 请求数据
+     * @param customHeaders - 请求头，选项
+     * @returns 请求结果
+     */
+    post(path: string, data: any, customHeaders?: Record<string, string>): Promise<ApiResponseType>;
+    /**
+     * Github PATCH 请求方法
+     * @param path - 请求路径
+     * @param data - 请求数据
+     * @param params - URL查询参数
+     * @param customHeaders - 请求头，选项
+     * @returns 请求结果
+     */
+    patch(path: string, params: (Record<string, string> | null) | undefined, data: any, customHeaders?: Record<string, string>): Promise<ApiResponseType>;
+    /**
+     * Github PUT 请求方法
+     * @param path - 请求路径
+     * @param data - 请求数据
+     * @param customHeaders - 请求头，选项
+     * @returns 请求结果
+     */
+    put(path: string, data: any, customHeaders?: Record<string, string>): Promise<ApiResponseType>;
+    /**
+     * Github DELETE 请求方法
+     * @param path - 请求路径
+     * @param params - URL查询参数
+     * @param data - 请求体数据
+     * @param customHeaders - 请求头，选项
+     * @returns 请求结果
+     */
+    delete(path: string, params?: Record<string, string> | null, data?: any, customHeaders?: Record<string, string>): Promise<ApiResponseType>;
+}
+
+/**
+ * GitHub 应用管理类
+ *
+ * 提供对GitHub App的完整管理功能，包括：
+ * - 获取应用基本信息
+ * - 生成应用安装链接
+ * - 生成应用配置链接
+ *
+ */
+declare class App extends Base {
+    constructor(base: Base);
+    /**
+     * 获取当前 Github App 信息
+     * @returns 返回 Github App 信息
+     */
+    private get_info;
+    /**
+     * 生成Github App 安装链接
+     * @param state_id - 随机生成的 state_id，用于验证授权请求的状态，可选，默认不使用
+     * @returns 返回安装链接对象
+     * @returns state_id 随机生成的字符串，用于验证
+     * @returns install_link 安装链接，用于跳转 Github 安装页
+     */
+    create_install_link(state_id?: string): Promise<string>;
+    /**
+      * 生成Github Apps 配置链接
+      * @param state_id - 传入的 state_id, 随机字符串
+      * @returns 返回配置链接对象
+      * @returns config_install_link 配置链接
+      * @example
+      * ```ts
+      * const link = await app.create_config_install_link('state_id')
+      * console.log(link) // https://github.com/apps/<app_name>/installations/new?state=<state_id></state_id>
+      * ```
+      */
+    create_config_install_link(state_id?: string): Promise<string>;
+    /**
+     * 获取仓库的应用安装信息
+     * @param options - 仓库安装应用参数对象
+     * - owner 拥有者
+     * - repo 仓库名
+     * - url 仓库地址
+     * ownwe和repo与url只能二选一
+     * @returns 返回应用安装信息
+     * @example
+     * ```ts
+     * const app = base.get_app()
+     * console.log(app.get_app_installation_by_repo({owner: 'owner', repo: 'repo'})) // 输出仓库的应用信息
+     * ```
+     */
+    get_app_installation_by_repo(options: RepoInfoParamType): Promise<ApiResponseType<GitHubAppRepoInfoResponseType>>;
+    /**
+     * 快速获取当前 Github App 名称
+     * @returns 返回 Github App 名称
+     * @example
+     * ```ts
+     * const app = base.get_app()
+     * console.log(app.get_app_name()) // 输出AppName
+     * ```
+     */
+    get_app_name(): Promise<string>;
+}
+
+type index_App = App;
+declare const index_App: typeof App;
+type index_Auth = Auth;
+declare const index_Auth: typeof Auth;
+type index_Base = Base;
+declare const index_Base: typeof Base;
+type index_Commit = Commit;
+declare const index_Commit: typeof Commit;
+type index_Issue = Issue;
+declare const index_Issue: typeof Issue;
+type index_Org = Org;
+declare const index_Org: typeof Org;
+type index_Repo = Repo;
+declare const index_Repo: typeof Repo;
+type index_User = User;
+declare const index_User: typeof User;
+type index_WebHook = WebHook;
+declare const index_WebHook: typeof WebHook;
+declare namespace index {
+  export { index_App as App, index_Auth as Auth, index_Base as Base, index_Commit as Commit, index_Issue as Issue, index_Org as Org, index_Repo as Repo, index_User as User, index_WebHook as WebHook };
+}
+
+export { type AccessCodeType, type AccessTokenType, type AccountBaseType, type AddCollaboratorResponseType, type AddSubIssueParamType, type AddSubIssueResponseType, type ApiResponseType, type ApiType, type CloseIssueParamType, type CloseIssueResponseType, type CodeOfConduct, type CollaboratorInfo, type CollaboratorListParamType, type CollaboratorListResponseType, type CollaboratorParamType, type Commit$1 as Commit, type CommitInfoBaseParamType, type CommitInfoCommonParamType, type CommitInfoParamType, type CommitInfoResponseType, type CommitInfoUrlParamType, type CommitStats, type CommonProxyType, type ContributionData, type ContributionResult, type CreateIssueResponseType, type CreteIssueCommentParamType, type CreteIssueCommentResponseType, type CreteIssueParamType, type DiffEntry, type GitHubAccountBaseType, type GitHubAccountType, type GitHubAppDetailedPermissions, type GitHubAppInfoType, type GitHubAppPermissions, type GitHubAppRepoInfoResponseType, type GitHubAuthType, type GitUser, type GithubOauthCheckTokenResponseType, type GithubOauthRefreshTokenResponseType, type GithubOauthTokenResponseType, type HttpProxyType, type HttpsProxyType, type IssueCommentInfoParamType, type IssueCommentInfoResponseType, type IssueCommentListParamType, type IssueCommentListResponseType, type IssueInfoParamType, type IssueInfoResponseType, type IssueLabelType, type IssueListResponseType, type License, type LockIssueParamType, type LockIssueResponseType, type MergeCommitMessage, type MergeCommitTitle, type MilestoneType, type OpenIssueParamType, type OpenIssueResponseType, type OrgRepoCreateParamType, type OrgRepoListParmsType, type OrgRepoListType, type OrganizationBaseType, type OrganizationInfoType, type OrganizationMemberType, type OrganizationNameParamType, type OrganizationPermissionsAndConfigType, type OrganizationPlanType, type OrganizationRepositoryAndGistsType, type OrganizationSecurityConfigType, type OrganizationUrlType, type Owner, type ParentCommit, type Permissions, type PkgInfoType, type ProxyParamsType, type PullRequestType, type RefreshTokenType, type RemoveCollaboratorParamType, type RemoveCollaboratorResponseType, type RemoveIssueCommentParamType, type RemoveIssueCommentResponseType, type RemoveSubIssueParamType, type RemoveSubIssueResponseType, type RepoBaseParamType, type RepoCommentListParamType, type RepoCommentListResponseType, type RepoDefaultBranchResponseType, type RepoInfoParamType, type RepoInfoResponseType, type RepoIssueListParamType, type RepoListBaseParamType, type RepoNameParamType, type RepoOwnerParamType, type RepoUrlParamType, type RepoVisibilityResponseType, type ReprioritizeSubIssueParamType, type ReprioritizeSubIssueResponseType, type RequestConfigType, type RequestTokenType, type ResponseMsgType, type ResponseStatusCodeType, type ResponseSuccessType, type ResponseType, type ReverseProxyCommonUrlType, type SecurityAnalysisAdvancedSecurity, type SecurityAnalysisDependabotSecurityUpdates, type SecurityAnalysisSecretScanning, type SecurityAnalysisSecretScanningPushProtection, type SecurityAndAnalysis, type ShaParamType, type SocksProxyType, type SquashMergeCommitMessage, type SquashMergeCommitTitle, type SubIssueListParamType, type SubIssueListResponseType, type UnLockIssueParamType, type UnLockIssueResponseType, type UpdateIssueCommentParamType, type UpdateIssueCommentResponseType, type UpdateIssueParamType, type UpdateIssueResponseType, type UserByTokenRepoListParamType, type UserIdParamType, type UserInfoByTokenParamType, type UserInfoParamType, type UserInfoResponseType, type UserNameParamType, type UserPlanType, type UserRepoListParamType, type UserRepoListType, type Verification, type WebHookParamType, create_state_id, formatDate, type formatParamType, get_relative_time, index as github };