dna-api 0.2.1

package/src/index.ts

@@ -0,0 +1,935 @@
+import * as forge from "node-forge"
+//#region const
+const MAIN_URL = "https://dnabbs-api.yingxiong.com"
+const LOGIN_URL = `${MAIN_URL}/user/sdkLogin`
+const GET_RSA_PUBLIC_KEY_URL = `${MAIN_URL}/config/getRsaPublicKey`
+const LOGIN_LOG_URL = `${MAIN_URL}/user/login/log`
+const ROLE_LIST_URL = `${MAIN_URL}/role/list`
+const ROLE_FOR_TOOL_URL = `${MAIN_URL}/role/defaultRoleForTool`
+const ROLE_DETAIL_URL = `${MAIN_URL}/role/getCharDetail`
+const WEAPON_DETAIL_URL = `${MAIN_URL}/weapon/detail`
+const SHORT_NOTE_URL = `${MAIN_URL}/role/getShortNoteInfo`
+const SIGN_CALENDAR_URL = `${MAIN_URL}/encourage/signin/show`
+const GAME_SIGN_URL = `${MAIN_URL}/encourage/signin/signin`
+const BBS_SIGN_URL = `${MAIN_URL}/user/signIn`
+const HAVE_SIGN_IN_URL = `${MAIN_URL}/user/haveSignInNew`
+const GET_TASK_PROCESS_URL = `${MAIN_URL}/encourage/level/getTaskProcess`
+const GET_POST_LIST_URL = `${MAIN_URL}/forum/list`
+const GET_POST_DETAIL_URL = `${MAIN_URL}/forum/getPostDetail`
+const LIKE_POST_URL = `${MAIN_URL}/forum/like`
+const SHARE_POST_URL = `${MAIN_URL}/encourage/level/shareTask`
+const REPLY_POST_URL = `${MAIN_URL}/forum/comment/createComment`
+const ANN_LIST_URL = `${MAIN_URL}/user/mine`
+
+enum RespCode {
+    ERROR = -999,
+    OK_ZERO = 0,
+    OK_HTTP = 200,
+    BAD_REQUEST = 400,
+    SERVER_ERROR = 500,
+}
+
+const DNA_GAME_ID = 268
+//#endregion
+
+/**
+ * DNA API类，用于与DNA游戏服务器交互
+ */
+export class DNAAPI {
+    public fetchFn: typeof fetch
+    public is_h5 = false
+    public rsa_public_key =
+        "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDGpdbezK+eknQZQzPOjp8mr/dP+QHwk8CRkQh6C6qFnfLH3tiyl0pnt3dePuFDnM1PUXGhCkQ157ePJCQgkDU2+mimDmXh0oLFn9zuWSp+U8uLSLX3t3PpJ8TmNCROfUDWvzdbnShqg7JfDmnrOJz49qd234W84nrfTHbzdqeigQIDAQAB"
+
+    /**
+     * 构造函数
+     * @param dev_code 设备码
+     * @param uid 用户ID
+     * @param token 访问令牌
+     * @param options 选项
+     * @param options.fetchFn 自定义fetch函数
+     * @param options.is_h5 是否为H5端
+     * @param options.rsa_public_key RSA公钥(base64) 设为空字符串从服务器获取
+     */
+    constructor(
+        public dev_code: string,
+        public uid = "",
+        public token = "",
+        options: { fetchFn?: typeof fetch; is_h5?: boolean; rsa_public_key?: string } = {},
+    ) {
+        this.fetchFn = options.fetchFn || fetch.bind(window)
+        if (options.is_h5 !== undefined) this.is_h5 = options.is_h5
+        if (options.rsa_public_key !== undefined) this.rsa_public_key = options.rsa_public_key
+    }
+
+    /**
+     * 获取RSA公钥
+     * @returns RSA公钥(base64)
+     */
+    async getRsaPublicKey() {
+        if (this.rsa_public_key) {
+            return this.rsa_public_key
+        }
+        const res = await this._dna_request<{ key: string }>(GET_RSA_PUBLIC_KEY_URL)
+
+        if (res.is_success && res.data) {
+            const key = res.data.key
+            if (typeof key === "string") {
+                this.rsa_public_key = key
+            }
+        }
+        return this.rsa_public_key
+    }
+
+    /**
+     * 登录
+     */
+    async login(mobile: string, code: string, dev_code: string) {
+        const data = { mobile, code, gameList: DNA_GAME_ID }
+        const res = await this._dna_request<DNALoginRes>(LOGIN_URL, data, { sign: true, refer: true })
+        if (res.is_success && res.data) {
+            const data = res.data
+            if (typeof data.userId === "string") {
+                this.uid = data.userId
+            }
+            if (typeof data.token === "string") {
+                this.token = data.token
+            }
+        }
+        return res
+    }
+
+    /**
+     * 获取登录日志
+     */
+    async loginLog() {
+        return await this._dna_request<DNALoginRes>(LOGIN_LOG_URL)
+    }
+
+    /**
+     * 获取角色列表
+     */
+    async getRoleList() {
+        return await this._dna_request<DNARoleListRes>(ROLE_LIST_URL)
+    }
+
+    /**
+     * 获取默认角色
+     */
+    async getDefaultRoleForTool() {
+        const data = { type: 1 }
+        return await this._dna_request<DNARoleForToolRes>(ROLE_FOR_TOOL_URL, data, { sign: true })
+    }
+
+    /**
+     * 获取角色详情
+     */
+    async getRoleDetail(char_id: string, char_eid: string) {
+        const data = { charId: char_id, charEid: char_eid, type: 1 }
+        return await this._dna_request<DNARoleDetailRes>(ROLE_DETAIL_URL, data)
+    }
+
+    /**
+     * 获取武器详情
+     */
+    async getWeaponDetail(weapon_id: string) {
+        const data = { weaponId: weapon_id, type: 1 }
+        return await this._dna_request<DNARoleDetailRes>(WEAPON_DETAIL_URL, data)
+    }
+
+    /**
+     * 获取角色简讯
+     */
+    async getShortNoteInfo() {
+        return await this._dna_request<DNARoleShortNoteRes>(SHORT_NOTE_URL)
+    }
+
+    /**
+     * 检查是否签到
+     */
+    async haveSignIn() {
+        const data = { gameId: DNA_GAME_ID }
+        return await this._dna_request<DNAHaveSignInRes>(HAVE_SIGN_IN_URL, data)
+    }
+
+    /**
+     * 签到日历
+     */
+    async signCalendar() {
+        const data = { gameId: DNA_GAME_ID }
+        return await this._dna_request<DNACalendarSignRes>(SIGN_CALENDAR_URL, data)
+    }
+
+    /**
+     * 游戏签到
+     */
+    async gameSign(day_award_id: number, period: number) {
+        const data = {
+            dayAwardId: day_award_id,
+            periodId: period,
+            signinType: 1,
+        }
+        return await this._dna_request(GAME_SIGN_URL, data)
+    }
+
+    /**
+     * 皎皎角签到
+     */
+    async bbsSign() {
+        const data = { gameId: DNA_GAME_ID }
+        return await this._dna_request(BBS_SIGN_URL, data)
+    }
+
+    /**
+     * 获取任务进度
+     */
+    async getTaskProcess() {
+        const data = { gameId: DNA_GAME_ID }
+        return await this._dna_request<DNATaskProcessRes>(GET_TASK_PROCESS_URL, data)
+    }
+
+    /**
+     * 获取帖子列表
+     */
+    async getPostList() {
+        const data = {
+            forumId: 46, // 全部
+            gameId: DNA_GAME_ID,
+            pageIndex: 1,
+            pageSize: 20,
+            searchType: 1, // 1:最新 2:热门
+            timeType: 0,
+        }
+        return await this._dna_request<DNAPostListRes>(GET_POST_LIST_URL, data)
+    }
+
+    /**
+     * 获取帖子详情
+     */
+    async getPostDetail(post_id: string) {
+        const data = { postId: post_id }
+        try {
+            return await this._dna_request<DNAPostDetailRes>(GET_POST_DETAIL_URL, data)
+        } catch (e) {
+            console.error("get_post_detail", e as Error)
+            return DNAApiResponse.err("请求皎皎角服务失败")
+        }
+    }
+
+    /**
+     * 点赞帖子
+     */
+    async doLike(post: { gameForumId: string; postId: string; postType: string; userId: string }) {
+        const data = {
+            forumId: post.gameForumId,
+            gameId: DNA_GAME_ID,
+            likeType: "1",
+            operateType: "1",
+            postCommentId: "",
+            postCommentReplyId: "",
+            postId: post.postId,
+            postType: post.postType,
+            toUserId: post.userId,
+        }
+        try {
+            return await this._dna_request(LIKE_POST_URL, data)
+        } catch (e) {
+            console.error("do_like", e as Error)
+            return DNAApiResponse.err("请求皎皎角服务失败")
+        }
+    }
+
+    // 分享帖子
+    async doShare() {
+        const data = { gameId: DNA_GAME_ID }
+        try {
+            return await this._dna_request(SHARE_POST_URL, data)
+        } catch (e) {
+            console.error("do_share", e as Error)
+            return DNAApiResponse.err("请求皎皎角服务失败")
+        }
+    }
+
+    // 回复帖子
+    async doReply(post: Record<string, any>, content: string) {
+        const content_json = JSON.stringify([
+            {
+                content,
+                contentType: "1",
+                imgHeight: 0,
+                imgWidth: 0,
+                url: "",
+            },
+        ])
+        const data = {
+            postId: post.postId,
+            forumId: post.gameForumId || 47,
+            postType: "1",
+            content: content_json,
+        }
+
+        return await this._dna_request(REPLY_POST_URL, data, { sign: true, refer: true, params: { toUserId: post.userId } })
+    }
+
+    // 获取游戏公告列表
+    async getAnnList() {
+        const data = {
+            otherUserId: "709542994134436647",
+            searchType: 1,
+            type: 2,
+        }
+        return await this._dna_request<DNAPostListRes>(ANN_LIST_URL, data)
+    }
+
+    async getHeaders(options?: {
+        payload?: Record<string, any> | string
+        exparams?: Record<string, any>
+        dev_code?: string
+        refer?: boolean
+        token?: string
+    }) {
+        let { payload, exparams, dev_code = this.dev_code, refer, token = this.token } = options || {}
+
+        const CONTENT_TYPE = "application/x-www-form-urlencoded; charset=utf-8"
+        const iosBaseHeader = {
+            version: "1.1.3",
+            source: "ios",
+            "Content-Type": CONTENT_TYPE,
+            "User-Agent": "DoubleHelix/4 CFNetwork/3860.100.1 Darwin/25.0.0",
+        }
+        const h5BaseHeader = {
+            version: "3.11.0",
+            source: "h5",
+            "Content-Type": CONTENT_TYPE,
+            "User-Agent":
+                "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36",
+        }
+        // 默认获取ios头
+        const headers = { ...(this.is_h5 ? h5BaseHeader : iosBaseHeader) } as Record<string, any>
+        if (dev_code) {
+            headers.devCode = dev_code
+        }
+        if (refer) {
+            headers.origin = "https://dnabbs.yingxiong.com"
+            headers.refer = "https://dnabbs.yingxiong.com/"
+        }
+        if (token) {
+            headers.token = token
+        }
+        if (typeof payload === "object") {
+            const si = build_signature(payload)
+            Object.assign(payload, { sign: si.s, timestamp: si.t })
+            if (exparams) {
+                Object.assign(payload, exparams)
+            }
+
+            const params = new URLSearchParams()
+            Object.entries(payload).forEach(([key, value]) => {
+                params.append(key, String(value))
+            })
+            payload = params.toString()
+
+            const rk = si.k
+            const pk = await this.getRsaPublicKey()
+            const ek = rsa_encrypt(rk, pk)
+            if (this.is_h5) {
+                headers.k = ek
+            } else {
+                headers.rk = rk
+                headers.key = ek
+            }
+        }
+        return { headers, payload }
+    }
+
+    private async _dna_request<T = any>(
+        url: string,
+        data?: any,
+        options?: {
+            method?: "GET" | "POST"
+            sign?: boolean
+            refer?: boolean
+            params?: Record<string, any>
+            max_retries?: number
+            retry_delay?: number
+            timeout?: number
+        },
+    ): Promise<DNAApiResponse<T>> {
+        let { method = "POST", sign, refer, params, max_retries = 3, retry_delay = 1, timeout = 10000 } = options || {}
+        let headers: Record<string, any>
+        if (sign) {
+            const { payload: p, headers: h } = await this.getHeaders({ payload: data, refer, exparams: params })
+            data = p
+            headers = h
+        } else {
+            const { headers: h } = await this.getHeaders()
+            headers = h
+        }
+
+        for (let attempt = 0; attempt < max_retries; attempt++) {
+            try {
+                const fetchOptions: RequestInit = {
+                    method,
+                    headers,
+                    body: data,
+                }
+
+                // 实现超时控制
+                const controller = new AbortController()
+                const timeoutId = setTimeout(() => controller.abort(), timeout)
+
+                const response = await this.fetchFn(url, {
+                    ...fetchOptions,
+                    signal: controller.signal,
+                })
+                clearTimeout(timeoutId)
+
+                // 获取响应头的 content-type
+                const contentType = response.headers.get("content-type") || ""
+                let raw_res: any
+
+                // 根据 content-type 处理响应数据
+                if (contentType.includes("text/")) {
+                    const textData = await response.text()
+                    raw_res = {
+                        code: RespCode.ERROR,
+                        data: textData,
+                    }
+                } else {
+                    raw_res = await response.json()
+                }
+
+                if (typeof raw_res === "object" && raw_res !== null) {
+                    try {
+                        if (typeof raw_res.data === "string") {
+                            raw_res.data = JSON.parse(raw_res.data)
+                        }
+                    } catch (e) {
+                        // 忽略解析错误
+                    }
+                }
+
+                console.debug(
+                    `[DNA] url:[${url}] headers:[${JSON.stringify(headers)}] data:[${JSON.stringify(data)}] raw_res:${JSON.stringify(raw_res)}`,
+                )
+                return new DNAApiResponse<T>(raw_res)
+            } catch (e) {
+                console.error(`请求失败: ${(e as Error).message}`)
+                if (attempt < max_retries - 1) {
+                    await new Promise((resolve) => setTimeout(resolve, retry_delay * Math.pow(2, attempt)))
+                }
+            }
+        }
+
+        return DNAApiResponse.err("请求服务器失败，已达最大重试次数")
+    }
+}
+
+//#region 接口定义
+
+export interface UserGame {
+    gameId: number // gameId
+    gameName: string // gameName
+}
+
+export interface DNALoginRes {
+    applyCancel?: number // applyCancel
+    gender?: number // gender
+    signature?: string // signature
+    headUrl: string // headUrl
+    userName: string // userName
+    userId: string // userId
+    isOfficial: number // isOfficial
+    token: string // token
+    userGameList: UserGame[] // userGameList
+    isRegister: number // isRegister
+    status: number // status
+    /** 是否完成绑定 0: 未绑定, 1: 已绑定 */
+    isComplete: number
+    refreshToken: string // refreshToken
+}
+
+export interface DNARoleShowVo {
+    roleId: string // roleId
+    headUrl?: string // headUrl
+    level?: number // level
+    roleName?: string // roleName
+    isDefault?: number // isDefault
+    roleRegisterTime?: string // roleRegisterTime
+    boundType?: number // boundType
+    roleBoundId: string // roleBoundId
+}
+
+export interface DNARole {
+    gameName: string // gameName
+    showVoList: DNARoleShowVo[] // showVoList
+    gameId: number // gameId
+}
+
+export interface DNARoleListRes {
+    roles: DNARole[] // roles
+}
+
+/** 密函 */
+export interface DNARoleForToolInstance {
+    id: number // id
+    name: string // name
+    /** 密函编码 */
+    code: string
+    on: number // 0
+}
+
+enum DNAInstanceMHType {
+    "角色" = "role",
+    "武器" = "weapon",
+    "魔之楔" = "mzx",
+    "role" = "角色",
+    "weapon" = "武器",
+    "mzx" = "魔之楔",
+}
+
+export function getDNAInstanceMHType(key: keyof typeof DNAInstanceMHType) {
+    return DNAInstanceMHType[key]
+}
+
+export interface DNARoleForToolInstanceInfo {
+    /** 密函列表 */
+    instances: DNARoleForToolInstance[] // instances
+    /** 密函类型 */
+    mh_type?: DNAInstanceMHType // 密函类型
+}
+
+export interface DraftDoingInfo {
+    draftCompleteNum: number // draftCompleteNum
+    draftDoingNum: number // draftDoingNum
+    /** 结束时间 */
+    endTime: string
+    /** 产品id */
+    productId?: number
+    /** 产品名称 */
+    productName: string
+    /** 开始时间 */
+    startTime: string
+}
+
+export interface DraftInfo {
+    /** 正在做的锻造 */
+    draftDoingInfo?: DraftDoingInfo[]
+    /** 正在做的锻造数量 */
+    draftDoingNum: number
+    /** 最大锻造数量 */
+    draftMaxNum: number
+}
+
+export interface DNARoleShortNoteRes {
+    /** 迷津进度 */
+    rougeLikeRewardCount: number
+    /** 迷津总数 */
+    rougeLikeRewardTotal: number
+    /** 备忘手记进度 */
+    currentTaskProgress: number
+    /** 备忘手记总数 */
+    maxDailyTaskProgress: number
+    /** 梦魇进度 */
+    hardBossRewardCount: number
+    /** 梦魇总数 */
+    hardBossRewardTotal: number
+    /** 锻造信息 */
+    draftInfo: DraftInfo
+}
+
+export interface WeaponInsForTool {
+    /** 武器类型图标 */
+    elementIcon: string
+    /** 武器图标 */
+    icon: string
+    /** 武器等级 */
+    level: number
+    /** 武器名称 */
+    name: string
+    /** 是否解锁 */
+    unLocked: boolean
+    weaponEid?: string
+    weaponId: number
+}
+
+export interface RoleInsForTool {
+    charEid?: string
+    charId: number
+    /** 元素图标 */
+    elementIcon: string
+    /** 命座等级 */
+    gradeLevel: number
+    /** 角色图标 */
+    icon: string
+    /** 角色等级 */
+    level: number
+    /** 角色名称 */
+    name: string
+    /** 是否解锁 */
+    unLocked: boolean
+}
+
+export interface RoleAchievement {
+    paramKey: string // paramKey
+    paramValue: string // paramValue
+}
+
+export interface RoleShowForTool {
+    /** 角色列表 */
+    roleChars: RoleInsForTool[]
+    /** 武器列表 */
+    langRangeWeapons: WeaponInsForTool[]
+    /** 武器列表 */
+    closeWeapons: WeaponInsForTool[]
+    /** 等级 */
+    level: number
+    /** 成就列表 */
+    params: RoleAchievement[]
+    /** 角色id */
+    roleId: string
+    /** 角色名称 */
+    roleName: string
+}
+
+export interface RoleInfoForTool {
+    /** 角色信息 */
+    roleShow: RoleShowForTool
+}
+
+export interface DNARoleForToolRes {
+    /** 角色信息 */
+    roleInfo: RoleInfoForTool
+    /** 密函 */
+    instanceInfo: DNARoleForToolInstanceInfo[]
+}
+
+export interface RoleAttribute {
+    /** 技能范围 */
+    skillRange: string
+    /** 强化值 */
+    strongValue: string
+    /** 技能威力 */
+    skillIntensity: string
+    /** 武器精通 */
+    weaponTags: string[]
+    /** 防御 */
+    defense: number
+    /** 仇恨值 */
+    enmityValue: string
+    /** 技能效益 */
+    skillEfficiency: string
+    /** 技能耐久 */
+    skillSustain: string
+    /** 最大生命值 */
+    maxHp: number
+    /** 攻击 */
+    atk: number
+    /** 最大护盾 */
+    maxES: number
+    /** 最大神志 */
+    maxSp: number
+}
+
+export interface RoleSkill {
+    /** 技能id */
+    skillId: number
+    /** 技能图标 */
+    icon: string
+    /** 技能等级 */
+    level: number
+    /** 技能名称 */
+    skillName: string
+}
+
+export interface RoleTrace {
+    /** 溯源图标 */
+    icon: string
+    /** 溯源描述 */
+    description: string
+}
+
+export interface Mode {
+    /** id 没佩戴为-1 */
+    id: number
+    /** 图标 */
+    icon?: string
+    /** 质量 */
+    quality?: number
+    /** 名称 */
+    name?: string
+}
+
+export interface RoleDetail {
+    /** 角色属性 */
+    attribute: RoleAttribute
+    /** 角色技能 */
+    skills: RoleSkill[]
+    /** 立绘 */
+    paint: string
+    /** 角色名称 */
+    charName: string
+    /** 元素图标 */
+    elementIcon: string
+    /** 溯源 */
+    traces: RoleTrace[]
+    /** 当前魔之楔 */
+    currentVolume: number
+    /** 最大魔之楔 */
+    sumVolume: number
+    /** 角色等级 */
+    level: number
+    /** 角色头像 */
+    icon: string
+    /** 溯源等级 0-6 */
+    gradeLevel: number
+    /** 元素名称 */
+    elementName: string
+    /** mode */
+    modes: Mode[]
+}
+
+export interface DNARoleDetailRes {
+    /** 角色详情 */
+    charDetail: RoleDetail
+}
+
+export interface DNADayAward {
+    gameId: number // gameId
+    periodId: number // periodId
+    iconUrl: string // iconUrl
+    id: number // id
+    dayInPeriod: number // dayInPeriod
+    updateTime: number // updateTime
+    awardNum: number // awardNum
+    thirdProductId: string // thirdProductId
+    createTime: number // createTime
+    awardName: string // awardName
+}
+
+export interface DNACaSignPeriod {
+    gameId: number // gameId
+    retryCos: number // retryCos
+    endDate: number // endDate
+    id: number // id
+    startDate: number // startDate
+    retryTimes: number // retryTimes
+    overDays: number // overDays
+    createTime: number // createTime
+    name: string // name
+}
+
+export interface DNACaSignRoleInfo {
+    headUrl: string // headUrl
+    roleId: string // roleId
+    roleName: string // roleName
+    level: number // level
+    roleBoundId: string // roleBoundId
+}
+
+export interface DNAHaveSignInRes {
+    /** 已签到天数 */
+    totalSignInDay: number
+}
+
+export interface DNACalendarSignRes {
+    todaySignin: boolean // todaySignin
+    userGoldNum: number // userGoldNum
+    dayAward: DNADayAward[] // dayAward
+    signinTime: number // signinTime
+    period: DNACaSignPeriod // period
+    roleInfo: DNACaSignRoleInfo // roleInfo
+}
+
+export interface DNABBSTask {
+    /** 备注 */
+    remark: string
+    /** 完成次数 */
+    completeTimes: number
+    /** 需要次数 */
+    times: number
+    /** skipType */
+    skipType: number
+    /** 获取经验 */
+    gainExp: number
+    /** 进度 */
+    process: number
+    /** 获取金币 */
+    gainGold: number
+    /** 任务标识名 */
+    markName?: string
+}
+
+export interface DNATaskProcessRes {
+    dailyTask: DNABBSTask[] // dailyTask
+}
+
+export interface DNAPostListRes {
+    postList: DNAPost[] // posts
+}
+
+export interface DNAPost {
+    postId: number // postId
+    title: string // title
+}
+
+export interface DNAPostDetailRes {
+    postDetail: DNAPostDetail // post
+}
+
+export interface DNAPostDetail {
+    postId: number // postId
+    postTime: number // postTime
+    postContent: DNAPostContent[] // postContent
+    title: string // title
+}
+
+export enum PostContentType {
+    TEXT = 1,
+    IMAGE = 2,
+    VIDEO = 5,
+}
+
+export interface DNAPostContent {
+    contentType: PostContentType // content
+    content: string // content
+    url?: string // url
+    contentVideo?: DNAPostContentVideo // contentVideo
+}
+
+export interface DNAPostContentVideo {
+    videoUrl: string // videoUrl
+    coverUrl?: string // coverUrl
+}
+
+// interface DNAWikiDetail {
+//     name: string // name
+// }
+
+// interface DNAWikiRes {
+//     wikis: DNAWikiDetail[] // wikis
+// }
+
+class DNAApiResponse<T = any> {
+    code: number = 0
+    msg: string = ""
+    success: boolean = false
+    data?: T
+
+    constructor(raw_data: any) {
+        this.code = raw_data.code || 0
+        this.msg = raw_data.msg || ""
+        this.success = raw_data.success || false
+        this.data = raw_data.data
+    }
+
+    // 判断是否成功
+    get is_success() {
+        return this.success && [RespCode.OK_ZERO, RespCode.OK_HTTP].includes(this.code)
+    }
+
+    // 错误响应静态方法
+    static err<T = undefined>(msg: string, code: number = RespCode.ERROR): DNAApiResponse<T> {
+        return new DNAApiResponse<T>({ code, msg, data: undefined, success: false })
+    }
+}
+//#endregion
+
+//#region utils
+
+// RSA加密函数
+function rsa_encrypt(text: string, public_key_b64: string): string {
+    try {
+        // 将base64公钥转换为PEM格式
+        const lines: string[] = []
+        for (let i = 0; i < public_key_b64.length; i += 64) {
+            lines.push(public_key_b64.slice(i, i + 64))
+        }
+        const pem = `-----BEGIN PUBLIC KEY-----\n${lines.join("\n")}\n-----END PUBLIC KEY-----`
+
+        // 导入PEM格式的RSA公钥
+        const publicKey = forge.pki.publicKeyFromPem(pem)
+
+        // 执行PKCS1_v1_5加密
+        const textBytes = forge.util.encodeUtf8(text)
+        const encrypted = publicKey.encrypt(textBytes)
+
+        return forge.util.encode64(encrypted)
+    } catch (e) {
+        throw new Error(`[DNA] RSA 加密失败: ${(e as Error).message}`)
+    }
+}
+
+// 生成随机字符串
+function rand_str(length: number = 16): string {
+    const chars = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
+    let result = ""
+    for (let i = 0; i < length; i++) {
+        result += chars.charAt(Math.floor(Math.random() * chars.length))
+    }
+    return result
+}
+
+// MD5加密并转换为大写
+function md5_upper(text: string): string {
+    const md = forge.md.md5.create()
+    md.update(text)
+    return md.digest().toHex().toUpperCase()
+}
+
+// 签名哈希函数
+function signature_hash(text: string): string {
+    function swap_positions(text: string, positions: number[]): string {
+        const chars = text.split("")
+        for (let i = 1; i < positions.length; i += 2) {
+            const p1 = positions[i - 1]
+            const p2 = positions[i]
+            if (p1 >= 0 && p1 < chars.length && p2 >= 0 && p2 < chars.length) {
+                ;[chars[p1], chars[p2]] = [chars[p2], chars[p1]]
+            }
+        }
+        return chars.join("")
+    }
+
+    return swap_positions(md5_upper(text), [1, 13, 5, 17, 7, 23])
+}
+
+// 签名函数
+function sign_fI(data: Record<string, any>, secret: string): string {
+    const pairs: string[] = []
+    const sortedKeys = Object.keys(data).sort()
+    for (const k of sortedKeys) {
+        const v = data[k]
+        if (v !== null && v !== undefined && v !== "") {
+            pairs.push(`${k}=${v}`)
+        }
+    }
+    const qs = pairs.join("&")
+    return signature_hash(`${qs}&${secret}`)
+}
+
+// XOR编码函数
+function xor_encode(text: string, key: string): string {
+    const encoder = new TextEncoder()
+    const tb = encoder.encode(text)
+    const kb = encoder.encode(key)
+    const out: string[] = []
+    for (let i = 0; i < tb.length; i++) {
+        const b = tb[i]
+        const e = (b & 255) + (kb[i % kb.length] & 255)
+        out.push(`@${e}`)
+    }
+    return out.join("")
+}
+
+// 构建签名
+function build_signature(data: Record<string, any>, token?: string): Record<string, any> {
+    const ts = Date.now()
+    const sign_data = { ...data, timestamp: ts, token }
+    const sec = rand_str(16)
+    const sig = sign_fI(sign_data, sec)
+    const enc = xor_encode(sig, sec)
+    return { s: enc, t: ts, k: sec }
+}
+
+//#endregion