finej3 1.0.0

package/dist/esm/clients/main.js

@@ -0,0 +1,371 @@
+import { HttpClient } from '../core/http.js';
+/** 主站官方地址 */
+export const MAIN_BASE_URL = 'https://seasun.nicemoe.cn';
+/**
+ * JX3API 主站客户端（seasun.nicemoe.cn，GET + query）。
+ *
+ * - 响应信封 `{ code, msg, data, time }` 原样返回，不解包、业务错误不抛异常（自行判断 code）。
+ * - 所有方法自动注入 token；推栏相关方法自动注入配置中的 ticket（可在参数中覆盖）。
+ * - 榜单类接口 server 为可选筛选条件：指定 server 时 data 为单个对象，
+ *   不指定时 data 为数组（已用方法重载表达）。
+ * - 传 `baseUrl` 可指向自建代理 / 镜像，缺省用 {@link MAIN_BASE_URL}。
+ */
+export class Jx3Api extends HttpClient {
+    constructor(options) {
+        super(MAIN_BASE_URL, options);
+    }
+    activeCalendar(params = {}) {
+        return this.get('/active/calendar', params);
+    }
+    /** 地图活动：楚天社 / 云从社 / 披风会接下来 10 条排期 */
+    activeCelebs(params) {
+        return this.get('/active/celebs', params);
+    }
+    /** 关隘首领状态，按服务器分组 */
+    castleStatus() {
+        return this.get('/castle/status', {});
+    }
+    /** 今日赤兔记录（未实测：探测时暂无数据） */
+    chituRecords() {
+        return this.get('/chitu/records', {});
+    }
+    /** 本周赤兔到达地图 */
+    chituWeekRecords() {
+        return this.get('/chitu/week/records', {});
+    }
+    /** 阵营奉献：据点争夺记录 */
+    fenxianRecords(params = {}) {
+        return this.get('/fenxian/records', params);
+    }
+    /** 烟花记录（未实测：探测角色无记录） */
+    fireworkRecords(params) {
+        return this.get('/firework/records', params);
+    }
+    /** 马场预告：各地图下一匹的预计时刻 */
+    ranchChat(params) {
+        return this.get('/ranch/chat', params);
+    }
+    /** 马场事件：播报预告 + 本周期赤兔 / 的卢出世情况 */
+    ranchRecords(params) {
+        return this.get('/ranch/records', params);
+    }
+    /** 下次扶摇：指定服返回该服未来场次，否则全服各返回下一场 */
+    soarNext(params = {}) {
+        return this.get('/soar/next', { limit: 10, ...params });
+    }
+    /** 诛恶事件刷新记录 */
+    wickedRecords(params = {}) {
+        return this.get('/wicked/records', params);
+    }
+    // ---------- 名剑相关（需要推栏 ticket） ----------
+    /** 名剑排行：某比赛模式竞技场排行榜前 limit 名 */
+    arenaAwesome(params = {}) {
+        const { ticket, ...rest } = params;
+        return this.get('/arena/awesome', { mode: 33, limit: 20, ...rest, ticket: this.requireTicket(ticket, '/arena/awesome') });
+    }
+    arenaRecent(params) {
+        const { ticket, ...rest } = params;
+        return this.get('/arena/recent', { ...rest, ticket: this.requireTicket(ticket, '/arena/recent') });
+    }
+    /** 名剑统计：某比赛模式下各门派的竞技场周统计 */
+    arenaSchools(params = {}) {
+        const { ticket, ...rest } = params;
+        return this.get('/arena/schools', { mode: 33, ...rest, ticket: this.requireTicket(ticket, '/arena/schools') });
+    }
+    rankArena(params = {}) {
+        return this.get('/rank/arena', params);
+    }
+    rankChampionship(params = {}) {
+        return this.get('/rank/championship', params);
+    }
+    rankConstable(params = {}) {
+        return this.get('/rank/constable', params);
+    }
+    rankOutlaw(params = {}) {
+        return this.get('/rank/outlaw', params);
+    }
+    rankStatistics(params) {
+        return this.get('/rank/statistics', params);
+    }
+    rankTrials(params) {
+        return this.get('/rank/trials', params);
+    }
+    rankWanted(params = {}) {
+        return this.get('/rank/wanted', params);
+    }
+    /** 资历榜单：指定服 / 门派（默认全服全门派）的资历前 100 名 */
+    schoolSeniority(params = {}) {
+        const { ticket, ...rest } = params;
+        return this.get('/school/seniority', { ...rest, ticket: this.requireTicket(ticket, '/school/seniority') });
+    }
+    /**
+     * 资历分布（未实测）。2026-07-23 探测时服务端对所有参数组合均返回 `code: 500 请求异常`
+     * （已排除绑定与 ticket 因素），返回类型待服务端恢复后补齐。
+     */
+    tuilanAchievement(params) {
+        const { ticket, ...rest } = params;
+        return this.get('/tuilan/achievement', { ...rest, ticket: ticket ?? this.options.ticket });
+    }
+    // ---------- 物价交易 ----------
+    /** 阵营拍卖记录 */
+    auctionRecords(params) {
+        return this.get('/auction/records', params);
+    }
+    /** 的卢拍卖：指定服最新 10 条，不指定则每服最新 1 条 */
+    steedRecords(params = {}) {
+        return this.get('/steed/records', params);
+    }
+    /** 金价行情 */
+    tradeDemon(params = {}) {
+        return this.get('/trade/demon', params);
+    }
+    /** 外观价格：历史成交 + 万宝楼挂单 */
+    tradeItemRecords(params) {
+        return this.get('/trade/item/records', params);
+    }
+    /** 外观搜索（先精确后模糊） */
+    tradeItemSearch(params) {
+        return this.get('/trade/item/search', params);
+    }
+    /** 成本计算：按成品配方算材料成本 */
+    tradeManufacture(params) {
+        return this.get('/trade/manufacture', params);
+    }
+    /** 物品价格：各区 / 指定服历史成交价 */
+    tradeRecords(params) {
+        return this.get('/trade/records', params);
+    }
+    /** 万宝楼编号搜索（未实测） */
+    tradeWanbaolou(params) {
+        return this.get('/trade/wanbaolou', params);
+    }
+    // ---------- 阵营战场 ----------
+    /** 帮战记录：某服最近 30 场 */
+    battleRecords(params) {
+        return this.get('/battle/records', params);
+    }
+    /** 沙盘据点归属 */
+    sandRecords(params) {
+        return this.get('/sand/records', params);
+    }
+    // ---------- 角色查询 ----------
+    /** 名片缓存 */
+    cardCached(params) {
+        return this.get('/card/cached', params);
+    }
+    /** 名片预设（推栏预设图与获赞数） */
+    cardPreset(params) {
+        const { ticket, ...rest } = params;
+        return this.get('/card/preset', { ...rest, ticket: this.requireTicket(ticket, '/card/preset') });
+    }
+    /** 随机名片 */
+    cardRandom(params = {}) {
+        return this.get('/card/random', params);
+    }
+    /** 名片记录 */
+    cardRecord(params) {
+        return this.get('/card/record', params);
+    }
+    /** 名片历史列表 */
+    cardRecords(params) {
+        return this.get('/card/records', params);
+    }
+    /** 奇遇汇总：白名单奇遇近 num 天触发次数 + 最新一条 */
+    eventCollect(params) {
+        return this.get('/event/collect', params);
+    }
+    /** 该角色尚未触发的奇遇 */
+    eventMissing(params) {
+        return this.get('/event/missing', params);
+    }
+    /** 某服最近触发的奇遇 */
+    eventRecent(params) {
+        return this.get('/event/recent', params);
+    }
+    /** 角色奇遇记录 */
+    eventRecords(params) {
+        return this.get('/event/records', params);
+    }
+    /** 某奇遇最近的触发记录 */
+    eventStatistics(params) {
+        return this.get('/event/statistics', params);
+    }
+    /** 奇遇攻略（白名单配置） */
+    eventStrategy(params) {
+        return this.get('/event/strategy', params);
+    }
+    /** 角色百战技能配装：体力 / 精力属性与技能列表。未打过百战的角色会返回 404 未收录 */
+    monsterRecords(params) {
+        return this.get('/monster/records', params);
+    }
+    /**
+     * 本周百战异闻录：本周首领与 100 层关卡（无需 server / name）。
+     *
+     * 「百战记录」分组下后端新增的接口，晚于最初的接口文档，故原始文档中没有；
+     * 字段依据实测。
+     */
+    monsterWeekly() {
+        return this.get('/monster/weekly', {});
+    }
+    /**
+     * 成就查询：角色名片 + 按 `name` 模糊匹配的成就列表，标记该角色完成情况。
+     * `role` 为角色名，`name` 为成就名/分类关键词。
+     */
+    roleAchievement(params) {
+        return this.get('/role/achievement', params);
+    }
+    /** 角色详情（history=1 时附改名 / 帮会历史） */
+    roleDetail(params) {
+        return this.get('/role/detail', params);
+    }
+    /** 蹲宠查询：七宠白名单命中情况 */
+    shareStay(params) {
+        return this.get('/share/stay', params);
+    }
+    // ---------- 游戏社区 ----------
+    /** 统战歪歪：各服 YY 语音在线主播 */
+    duowanStatistics(params = {}) {
+        return this.get('/duowan/statistics', params);
+    }
+    /** 小吃小药（指定心法或全部） */
+    foodList(params = {}) {
+        return this.get('/food/list', params);
+    }
+    /** 骗子查询：按 UID 查风控记录 */
+    fraudDetail(params) {
+        return this.get('/fraud/detail', params);
+    }
+    /** 家园鲜花行情，按地图归组 */
+    homeFlower(params) {
+        return this.get('/home/flower', params);
+    }
+    /**
+     * 家园装饰。`name` 必须是完整精确的装饰名（如 "龙门香梦"），
+     * 模糊名会返回 `code: 400 参数不正确`。返回数组，同名装饰可能有多条。
+     */
+    homeFurniture(params) {
+        return this.get('/home/furniture', params);
+    }
+    /**
+     * 器物图谱。`name` 必须是完整精确的器物名（如 "日晷"），
+     * 模糊名会返回 `code: 400 参数不正确`。返回数组，结构与 {@link Jx3Api.homeFurniture} 一致。
+     */
+    homeTravel(params) {
+        return this.get('/home/travel', params);
+    }
+    /** 师徒列表（label 1=师父 / 2=徒弟） */
+    mentorSearch(params) {
+        return this.get('/mentor/search', { label: 1, ...params });
+    }
+    /** 维护公告（标题含「版本更新」） */
+    newsAnnounce(params = {}) {
+        return this.get('/news/announce', params);
+    }
+    /** 新闻资讯 */
+    newsRecords(params = {}) {
+        return this.get('/news/records', params);
+    }
+    /** 团队招募 */
+    recruitSearch(params) {
+        return this.get('/recruit/search', { label: 1, limit: 50, ...params });
+    }
+    /** 分类骚话语录（疯狂星期四 / 彩虹屁 / 毒鸡汤 / 朋友圈） */
+    saohuaContext(params) {
+        return this.get('/saohua/context', params);
+    }
+    /**
+     * 随机骚话（无需参数）。「骚话语录」分组下后端新增的接口，晚于最初的接口文档，
+     * 类型依据实测。注意返回字段是 `text`，不同于 saohuaContext 的 `content`。
+     */
+    saohuaRandom() {
+        return this.get('/saohua/random', {});
+    }
+    /**
+     * 舔狗日记（无需参数），返回一段较长的舔狗日记文本。
+     * 同为「骚话语录」分组下后端新增的接口，返回结构与 saohuaRandom 一致（字段 `text`）。
+     */
+    saohuaContent() {
+        return this.get('/saohua/content', {});
+    }
+    /** 贴吧外观记录 */
+    tiebaItemRecords(params) {
+        return this.get('/tieba/item/records', params);
+    }
+    /** 百度贴吧：按帖子类型随机取近 31 天帖子 */
+    tiebaRandom(params) {
+        return this.get('/tieba/random', params);
+    }
+    /** 贴吧帖子 AI 总结 */
+    tiebaSummary(params) {
+        return this.get('/tieba/summary', { id: String(params.id) });
+    }
+    // ---------- 副本秘境 ----------
+    /** 秘境方位：按 15 分钟档推算 */
+    mechDecrypt() {
+        return this.get('/mech/decrypt', {});
+    }
+    /** 团队副本 CD 列表 */
+    raidRecords(params) {
+        return this.get('/raid/records', params);
+    }
+    /** 掉落统计：按物品名模糊匹配 */
+    rewardStatistics(params) {
+        return this.get('/reward/statistics', { limit: 20, ...params });
+    }
+    // ---------- 心法配装（需要推栏 ticket） ----------
+    /** 阵眼效果 */
+    schoolMatrix(params) {
+        const { ticket, ...rest } = params;
+        return this.get('/school/matrix', { ...rest, ticket: this.requireTicket(ticket, '/school/matrix') });
+    }
+    /** 推栏推荐配装 */
+    schoolSearch(params) {
+        const { ticket, ...rest } = params;
+        return this.get('/school/search', { ...rest, ticket: this.requireTicket(ticket, '/school/search') });
+    }
+    /** 技能信息 */
+    schoolSkills(params) {
+        const { ticket, ...rest } = params;
+        return this.get('/school/skills', { ...rest, ticket: this.requireTicket(ticket, '/school/skills') });
+    }
+    /** 奇穴信息 */
+    schoolTalent(params) {
+        const { ticket, ...rest } = params;
+        return this.get('/school/talent', { ...rest, ticket: this.requireTicket(ticket, '/school/talent') });
+    }
+    // ---------- 系统工具 ----------
+    /** 科举答案：按题目或拼音模糊匹配 */
+    examSearch(params) {
+        return this.get('/exam/search', params);
+    }
+    serverStatusCheck(params = {}) {
+        return this.get('/server/status/check', params);
+    }
+    /** 默认接口服务（服务状态自检） */
+    siteIndex(params = {}) {
+        return this.get('/site/index', params);
+    }
+    /** 急速计算：按技能 cd 推算各急速档位 */
+    skillCalculate(params = {}) {
+        return this.get('/skill/calculate', params);
+    }
+    /**
+     * 技改记录（无需参数）：武学调整公告列表，时间倒序。
+     * 后端新增的接口，晚于最初的接口文档，类型依据实测。
+     */
+    skillRework() {
+        return this.get('/skill/rework', {});
+    }
+    /** 语音合成（未实测：需要用户自己的阿里云密钥） */
+    soundConverter(params) {
+        return this.get('/sound/converter', { ...params });
+    }
+    /**
+     * 更新日常：客户端上报当日大战 / 秘境 / 团本。
+     * 注意：这是写入型接口，会修改服务端日历数据。
+     */
+    updateCalendar(params) {
+        return this.get('/update/calendar', { ...params });
+    }
+}
+//# sourceMappingURL=main.js.map

package/dist/esm/clients/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/clients/main.ts"],"names":[],"mappings":"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"}

package/dist/esm/clients/search.d.ts

@@ -0,0 +1,69 @@
+import { HttpClient, type GatewayEnvelope, type Jx3Options } from '../core/http.js';
+import type * as T from '../types/search.js';
+/** 搜索服务官方地址 */
+export declare const SEARCH_BASE_URL = "https://search.client.nicemoe.cn";
+/**
+ * 搜索服务客户端（search.client.nicemoe.cn，POST + JSON body，单入口 action 分发）。
+ * 响应信封 `{ status, detail }` 原样返回，不解包、业务错误不抛异常（自行判断 status；
+ * 业务错误时 detail 为错误描述字符串）。
+ * 传 `baseUrl` 可指向自建代理 / 镜像，缺省用 {@link SEARCH_BASE_URL}。
+ */
+export declare class Jx3SearchApi extends HttpClient {
+    constructor(options: Jx3Options);
+    /**
+     * 装备详情。
+     * format='client'（默认）返回原始装备列表；其他值会展开装备详情与属性面板（附加字段见响应）。
+     * online 非 0 时走在线实时查询。
+     */
+    roleEquipDetail(params: {
+        server: string;
+        name: string;
+        format?: string;
+        online?: number;
+    }): Promise<GatewayEnvelope<T.RoleEquipDetail>>;
+    /** 历史装备：按时间降序的全部历史快照（仅心法 / 配装类型 / 时间戳） */
+    roleEquipSearch(params: {
+        server: string;
+        name: string;
+    }): Promise<GatewayEnvelope<T.RoleEquipHistory>>;
+    /** 指定配装：server + name + kungfu + type 四元组唯一匹配一条历史装备记录 */
+    roleEquipCalcd(params: {
+        server: string;
+        name: string;
+        /** 心法名称（如「花间游」） */
+        kungfu: string;
+        /** 装备类型（秘境挑战 / 竞技对抗 / 休闲 / 通用） */
+        type: string;
+        format?: string;
+    }): Promise<GatewayEnvelope<T.RoleEquipDetail>>;
+    /** 聊天记录：limit 自动夹紧到 [1, 50]，page 至少为 1，按时间降序 */
+    roleChatRecords(params: {
+        server: string;
+        name: string;
+        limit?: number;
+        page?: number;
+    }): Promise<GatewayEnvelope<T.ChatRecordsData>>;
+    /** 角色对话：默认 system prompt 约束为 {nickname} 角色（回复 ≤15 字撒娇语气） */
+    callModelChat(params: {
+        content: string;
+        nickname: string;
+        syst_content?: string;
+    }): Promise<GatewayEnvelope<T.ModelChatData>>;
+    /** 物品价格：jx3box 搜索 + 拍卖行数据，单品命中时额外补月度均价 */
+    itemTradeSearch(params: {
+        server: string;
+        keyword: string;
+        quality?: string;
+    }): Promise<GatewayEnvelope<T.ItemTradeSearchItem[]>>;
+    /** 贴吧骗子搜索：按用户 ID */
+    tiebaScammerCheck(params: {
+        uid: string | number;
+        server?: string;
+    }): Promise<GatewayEnvelope<T.TiebaScammerItem[]>>;
+    /** 贴吧关键词搜索 */
+    tiebaKeywordCheck(params: {
+        keyword: string;
+        server?: string;
+    }): Promise<GatewayEnvelope<T.TiebaKeywordItem[]>>;
+}
+//# sourceMappingURL=search.d.ts.map

package/dist/esm/clients/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/clients/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACpF,OAAO,KAAK,KAAK,CAAC,MAAM,oBAAoB,CAAC;AAE7C,eAAe;AACf,eAAO,MAAM,eAAe,qCAAqC,CAAC;AAElE;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,UAAU;gBAC9B,OAAO,EAAE,UAAU;IAI/B;;;;OAIG;IACH,eAAe,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IAIxI,0CAA0C;IAC1C,eAAe,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAIvG,yDAAyD;IACzD,cAAc,CAAC,MAAM,EAAE;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,mBAAmB;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,kCAAkC;QAClC,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IAI/C,gDAAgD;IAChD,eAAe,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IAIrI,4DAA4D;IAC5D,aAAa,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IAI9H,0CAA0C;IAC1C,eAAe,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAIjI,oBAAoB;IACpB,iBAAiB,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAIpH,cAAc;IACd,iBAAiB,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC;CAGhH"}

package/dist/esm/clients/search.js

@@ -0,0 +1,51 @@
+import { HttpClient } from '../core/http.js';
+/** 搜索服务官方地址 */
+export const SEARCH_BASE_URL = 'https://search.client.nicemoe.cn';
+/**
+ * 搜索服务客户端（search.client.nicemoe.cn，POST + JSON body，单入口 action 分发）。
+ * 响应信封 `{ status, detail }` 原样返回，不解包、业务错误不抛异常（自行判断 status；
+ * 业务错误时 detail 为错误描述字符串）。
+ * 传 `baseUrl` 可指向自建代理 / 镜像，缺省用 {@link SEARCH_BASE_URL}。
+ */
+export class Jx3SearchApi extends HttpClient {
+    constructor(options) {
+        super(SEARCH_BASE_URL, options);
+    }
+    /**
+     * 装备详情。
+     * format='client'（默认）返回原始装备列表；其他值会展开装备详情与属性面板（附加字段见响应）。
+     * online 非 0 时走在线实时查询。
+     */
+    roleEquipDetail(params) {
+        return this.post('role_equip_detail', { ...params });
+    }
+    /** 历史装备：按时间降序的全部历史快照（仅心法 / 配装类型 / 时间戳） */
+    roleEquipSearch(params) {
+        return this.post('role_equip_search', { ...params });
+    }
+    /** 指定配装：server + name + kungfu + type 四元组唯一匹配一条历史装备记录 */
+    roleEquipCalcd(params) {
+        return this.post('role_equip_calcd', { ...params });
+    }
+    /** 聊天记录：limit 自动夹紧到 [1, 50]，page 至少为 1，按时间降序 */
+    roleChatRecords(params) {
+        return this.post('role_chat_records', { limit: 10, page: 1, ...params });
+    }
+    /** 角色对话：默认 system prompt 约束为 {nickname} 角色（回复 ≤15 字撒娇语气） */
+    callModelChat(params) {
+        return this.post('call_model_chat', { ...params });
+    }
+    /** 物品价格：jx3box 搜索 + 拍卖行数据，单品命中时额外补月度均价 */
+    itemTradeSearch(params) {
+        return this.post('item_trade_search', { ...params });
+    }
+    /** 贴吧骗子搜索：按用户 ID */
+    tiebaScammerCheck(params) {
+        return this.post('tieba_scammer_check', { ...params, uid: String(params.uid) });
+    }
+    /** 贴吧关键词搜索 */
+    tiebaKeywordCheck(params) {
+        return this.post('tieba_keyword_check', { ...params });
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/esm/clients/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/clients/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyC,MAAM,iBAAiB,CAAC;AAGpF,eAAe;AACf,MAAM,CAAC,MAAM,eAAe,GAAG,kCAAkC,CAAC;AAElE;;;;;GAKG;AACH,MAAM,OAAO,YAAa,SAAQ,UAAU;IAC1C,YAAY,OAAmB;QAC7B,KAAK,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,MAA0E;QACxF,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,0CAA0C;IAC1C,eAAe,CAAC,MAAwC;QACtD,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,yDAAyD;IACzD,cAAc,CAAC,MAQd;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,gDAAgD;IAChD,eAAe,CAAC,MAAuE;QACrF,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,4DAA4D;IAC5D,aAAa,CAAC,MAAoE;QAChF,OAAO,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,0CAA0C;IAC1C,eAAe,CAAC,MAA6D;QAC3E,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,oBAAoB;IACpB,iBAAiB,CAAC,MAAiD;QACjE,OAAO,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,cAAc;IACd,iBAAiB,CAAC,MAA4C;QAC5D,OAAO,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/esm/core/http.d.ts

@@ -0,0 +1,48 @@
+/** SDK 公共配置 */
+export interface Jx3Options {
+    /** 站点访问令牌，所有接口必需 */
+    token: string;
+    /** 推栏标识鉴权，名剑 / 配装 / 资历等推栏数据接口需要 */
+    ticket?: string;
+    /**
+     * 覆盖该客户端的服务地址（自建代理 / 镜像 / 测试环境）。
+     * 缺省使用各客户端的官方地址，末尾斜杠会被忽略。
+     */
+    baseUrl?: string;
+    /** 自定义 fetch 实现（默认使用全局 fetch） */
+    fetch?: typeof fetch;
+    /** 请求超时毫秒数，默认 30000 */
+    timeoutMs?: number;
+}
+/** 主站（seasun.nicemoe.cn）响应信封，原样返回不解包 */
+export interface Jx3Envelope<T> {
+    /** 业务码：200 成功，其余为业务错误（如 400 / 404 / -700） */
+    code: number;
+    msg: string;
+    /** 业务数据；业务错误时可能为 null 或缺省 */
+    data: T;
+    time: number;
+}
+/** 网关服务（search / submit）响应信封，原样返回不解包 */
+export interface GatewayEnvelope<T> {
+    /** 业务码：200 成功，其余为业务错误（如 401 / 404 / 503） */
+    status: number;
+    /** 业务数据；业务错误时为错误描述字符串 */
+    detail: T | string;
+}
+export type QueryValue = string | number | boolean | undefined;
+/** 三个客户端共用的 HTTP 基类。业务错误不抛异常，信封原样返回；仅网络失败 / 非 JSON 响应抛错。 */
+export declare class HttpClient {
+    protected readonly options: Jx3Options;
+    private readonly baseUrl;
+    /** @param defaultBaseUrl 该客户端的官方地址，被 options.baseUrl 覆盖 */
+    constructor(defaultBaseUrl: string, options: Jx3Options);
+    /** 取必填 ticket：调用参数 > 配置项，否则报错 */
+    protected requireTicket(ticket: string | undefined, endpoint: string): string;
+    private fetchJson;
+    /** 主站 GET：注入 token，原样返回响应信封 */
+    protected get<T>(path: string, params: object): Promise<Jx3Envelope<T>>;
+    /** 网关 POST（单入口 action 分发）：注入 token，原样返回响应信封 */
+    protected post<T>(action: string, payload: Record<string, unknown>): Promise<GatewayEnvelope<T>>;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/esm/core/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/core/http.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,MAAM,WAAW,UAAU;IACzB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wCAAwC;AACxC,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wCAAwC;AACxC,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/D,4DAA4D;AAC5D,qBAAa,UAAU;IACrB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,2DAA2D;gBAC/C,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU;IAMvD,iCAAiC;IACjC,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;YAQ/D,SAAS;IAYvB,+BAA+B;cACf,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAS7E,+CAA+C;cAC/B,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;CAWvG"}

package/dist/esm/core/http.js

@@ -0,0 +1,51 @@
+/** 三个客户端共用的 HTTP 基类。业务错误不抛异常，信封原样返回；仅网络失败 / 非 JSON 响应抛错。 */
+export class HttpClient {
+    options;
+    baseUrl;
+    /** @param defaultBaseUrl 该客户端的官方地址，被 options.baseUrl 覆盖 */
+    constructor(defaultBaseUrl, options) {
+        if (!options.token)
+            throw new Error('jx3api-ts: 必须提供 token');
+        this.baseUrl = (options.baseUrl ?? defaultBaseUrl).replace(/\/+$/, '');
+        this.options = options;
+    }
+    /** 取必填 ticket：调用参数 > 配置项，否则报错 */
+    requireTicket(ticket, endpoint) {
+        const value = ticket ?? this.options.ticket;
+        if (!value) {
+            throw new Error(`jx3api-ts: [${endpoint}] 需要推栏 ticket（或在配置中提供 ticket）`);
+        }
+        return value;
+    }
+    async fetchJson(url, init, endpoint) {
+        const doFetch = this.options.fetch ?? fetch;
+        const timeout = this.options.timeoutMs ?? 30_000;
+        const response = await doFetch(url, { ...init, signal: AbortSignal.timeout(timeout) });
+        const text = await response.text();
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            throw new Error(`jx3api-ts: [${endpoint}] 响应不是合法 JSON (http ${response.status}): ${text.slice(0, 200)}`);
+        }
+    }
+    /** 主站 GET：注入 token，原样返回响应信封 */
+    async get(path, params) {
+        const query = new URLSearchParams();
+        for (const [key, value] of Object.entries(params)) {
+            if (value !== undefined)
+                query.set(key, String(value));
+        }
+        query.set('token', this.options.token);
+        return (await this.fetchJson(`${this.baseUrl}${path}?${query}`, { method: 'GET' }, path));
+    }
+    /** 网关 POST（单入口 action 分发）：注入 token，原样返回响应信封 */
+    async post(action, payload) {
+        return (await this.fetchJson(this.baseUrl + '/', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ action, ...payload, token: this.options.token }),
+        }, action));
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/esm/core/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/core/http.ts"],"names":[],"mappings":"AAqCA,4DAA4D;AAC5D,MAAM,OAAO,UAAU;IACF,OAAO,CAAa;IACtB,OAAO,CAAS;IAEjC,2DAA2D;IAC3D,YAAY,cAAsB,EAAE,OAAmB;QACrD,IAAI,CAAC,OAAO,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC7D,IAAI,CAAC,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACvE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,iCAAiC;IACvB,aAAa,CAAC,MAA0B,EAAE,QAAgB;QAClE,MAAM,KAAK,GAAG,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,eAAe,QAAQ,+BAA+B,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,IAAiB,EAAE,QAAgB;QACtE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;QACjD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACvF,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,eAAe,QAAQ,uBAAuB,QAAQ,CAAC,MAAM,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3G,CAAC;IACH,CAAC;IAED,+BAA+B;IACrB,KAAK,CAAC,GAAG,CAAI,IAAY,EAAE,MAAc;QACjD,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;QACpC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAgC,EAAE,CAAC;YACjF,IAAI,KAAK,KAAK,SAAS;gBAAE,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACvC,OAAO,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,IAAI,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,CAAmB,CAAC;IAC9G,CAAC;IAED,+CAA+C;IACrC,KAAK,CAAC,IAAI,CAAI,MAAc,EAAE,OAAgC;QACtE,OAAO,CAAC,MAAM,IAAI,CAAC,SAAS,CAC1B,IAAI,CAAC,OAAO,GAAG,GAAG,EAClB;YACE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;SACxE,EACD,MAAM,CACP,CAAuB,CAAC;IAC3B,CAAC;CACF"}