stock-sdk 1.0.0 → 1.0.2

package/README.md

@@ -2,6 +2,16 @@
 
 基于腾讯财经 `qt.gtimg.cn` 非官方接口封装的 TypeScript SDK，支持 A 股、港股、美股、公募基金实时行情查询。
 
+**同时支持浏览器端和 Node.js 端使用。**
+
+## 特性
+
+- ✅ 支持浏览器和 Node.js 双端运行
+- ✅ 同时提供 ESM 和 CommonJS 两种模块格式
+- ✅ 完整的 TypeScript 类型定义
+- ✅ A 股、港股、美股、公募基金实时行情
+- ✅ 资金流向、盘口大单等扩展数据
+
 ## 安装
 
 ```bash
@@ -13,9 +23,13 @@ yarn add stock-sdk
 ## 快速开始
 
 ```typescript
-import StockSDK from 'stock-sdk';
+// ESM (浏览器 / Node.js)
+import { TencentStockSDK } from 'stock-sdk';
 
-const sdk = new StockSDK();
+// CommonJS (Node.js)
+// const { TencentStockSDK } = require('stock-sdk');
+
+const sdk = new TencentStockSDK();
 
 // A 股全量行情
 const fullQuotes = await sdk.getFullQuotes(['sz000858', 'sh600000']);
@@ -59,12 +73,21 @@ interface FullQuote {
   volume2: number;       // 成交量(手)
   amount: number;        // 成交额(万)
   turnoverRate: number | null;  // 换手率%
-  pe: number | null;            // 市盈率
+  pe: number | null;            // 市盈率(TTM)
+  amplitude: number | null;     // 振幅%
   circulatingMarketCap: number | null;  // 流通市值(亿)
   totalMarketCap: number | null;        // 总市值(亿)
   pb: number | null;            // 市净率
   limitUp: number | null;       // 涨停价
   limitDown: number | null;     // 跌停价
+  volumeRatio: number | null;   // 量比
+  avgPrice: number | null;      // 均价
+  peStatic: number | null;      // 市盈率(静)
+  peDynamic: number | null;     // 市盈率(动)
+  high52w: number | null;       // 52周最高价
+  low52w: number | null;        // 52周最低价
+  circulatingShares: number | null;  // 流通股本(股)
+  totalShares: number | null;        // 总股本(股)
   raw: string[];                // 原始字段数组
 }
 ```
@@ -311,17 +334,33 @@ console.log(raw[0].fields); // ['51', '五 粮 液', '000858', ...]
 
 ---
 
+## 浏览器使用说明
+
+在浏览器端使用时，SDK 会自动使用浏览器原生的 `TextDecoder` 来解码 GBK 编码的响应数据，无需额外的 polyfill。
+
+```html
+<script type="module">
+  import { TencentStockSDK } from 'https://unpkg.com/stock-sdk/dist/index.js';
+  
+  const sdk = new TencentStockSDK();
+  const quotes = await sdk.getFullQuotes(['sz000858']);
+  console.log(quotes[0].name, quotes[0].price);
+</script>
+```
+
+> **注意**：由于 `qt.gtimg.cn` 接口不支持 CORS，在浏览器端使用时需要配置代理服务器。
+
 ## 开发
 
 ```bash
 # 安装依赖
-npm install
+yarn install
 
 # 运行测试
-npm test
+yarn test
 
 # 构建
-npm run build
+yarn build
 ```
 
 ## 许可证

package/dist/index.cjs

@@ -0,0 +1,304 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  TencentStockSDK: () => TencentStockSDK,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+var import_axios = __toESM(require("axios"), 1);
+var BASE_URL = "http://qt.gtimg.cn";
+function isBrowser() {
+  return typeof window !== "undefined" && typeof window.document !== "undefined";
+}
+async function decodeGBK(data) {
+  if (isBrowser()) {
+    const decoder = new TextDecoder("gbk");
+    return decoder.decode(data);
+  } else {
+    const iconvModule = await import("iconv-lite");
+    const iconv = iconvModule.default || iconvModule;
+    return iconv.decode(Buffer.from(data), "gbk");
+  }
+}
+function safeNumber(val) {
+  if (!val || val === "") return 0;
+  const n = parseFloat(val);
+  return Number.isNaN(n) ? 0 : n;
+}
+function safeNumberOrNull(val) {
+  if (!val || val === "") return null;
+  const n = parseFloat(val);
+  return Number.isNaN(n) ? null : n;
+}
+function parseResponse(text) {
+  const lines = text.split(";").map((l) => l.trim()).filter(Boolean);
+  const results = [];
+  for (const line of lines) {
+    const eqIdx = line.indexOf("=");
+    if (eqIdx < 0) continue;
+    let key = line.slice(0, eqIdx).trim();
+    if (key.startsWith("v_")) key = key.slice(2);
+    let raw = line.slice(eqIdx + 1).trim();
+    if (raw.startsWith('"') && raw.endsWith('"')) {
+      raw = raw.slice(1, -1);
+    }
+    const fields = raw.split("~");
+    results.push({ key, fields });
+  }
+  return results;
+}
+var TencentStockSDK = class {
+  constructor() {
+    this.client = import_axios.default.create({
+      baseURL: BASE_URL,
+      responseType: "arraybuffer",
+      timeout: 1e4
+    });
+  }
+  async fetch(params) {
+    const resp = await this.client.get("/", { params: { q: params } });
+    const text = await decodeGBK(resp.data);
+    return parseResponse(text);
+  }
+  // ---------- 实时全量行情 ----------
+  /**
+   * 获取 A 股 / 指数 全量行情
+   * @param codes 如 ['sz000858', 'sh600000']
+   */
+  async getFullQuotes(codes) {
+    const data = await this.fetch(codes.join(","));
+    return data.map((d) => this.parseFullQuote(d.fields));
+  }
+  parseFullQuote(f) {
+    const bid = [];
+    for (let i = 0; i < 5; i++) {
+      bid.push({ price: safeNumber(f[9 + i * 2]), volume: safeNumber(f[10 + i * 2]) });
+    }
+    const ask = [];
+    for (let i = 0; i < 5; i++) {
+      ask.push({ price: safeNumber(f[19 + i * 2]), volume: safeNumber(f[20 + i * 2]) });
+    }
+    return {
+      marketId: f[0] ?? "",
+      name: f[1] ?? "",
+      code: f[2] ?? "",
+      price: safeNumber(f[3]),
+      prevClose: safeNumber(f[4]),
+      open: safeNumber(f[5]),
+      volume: safeNumber(f[6]),
+      outerVolume: safeNumber(f[7]),
+      innerVolume: safeNumber(f[8]),
+      bid,
+      ask,
+      time: f[30] ?? "",
+      change: safeNumber(f[31]),
+      changePercent: safeNumber(f[32]),
+      high: safeNumber(f[33]),
+      low: safeNumber(f[34]),
+      volume2: safeNumber(f[36]),
+      amount: safeNumber(f[37]),
+      turnoverRate: safeNumberOrNull(f[38]),
+      pe: safeNumberOrNull(f[39]),
+      amplitude: safeNumberOrNull(f[43]),
+      circulatingMarketCap: safeNumberOrNull(f[44]),
+      totalMarketCap: safeNumberOrNull(f[45]),
+      pb: safeNumberOrNull(f[46]),
+      limitUp: safeNumberOrNull(f[47]),
+      limitDown: safeNumberOrNull(f[48]),
+      volumeRatio: safeNumberOrNull(f[49]),
+      avgPrice: safeNumberOrNull(f[51]),
+      peStatic: safeNumberOrNull(f[52]),
+      peDynamic: safeNumberOrNull(f[53]),
+      high52w: safeNumberOrNull(f[67]),
+      low52w: safeNumberOrNull(f[68]),
+      circulatingShares: safeNumberOrNull(f[72]),
+      totalShares: safeNumberOrNull(f[73]),
+      raw: f
+    };
+  }
+  // ---------- 简要行情 ----------
+  /**
+   * 获取简要行情
+   * @param codes 如 ['s_sz000858', 's_sh000001']
+   */
+  async getSimpleQuotes(codes) {
+    const data = await this.fetch(codes.join(","));
+    return data.map((d) => this.parseSimpleQuote(d.fields));
+  }
+  parseSimpleQuote(f) {
+    return {
+      marketId: f[0] ?? "",
+      name: f[1] ?? "",
+      code: f[2] ?? "",
+      price: safeNumber(f[3]),
+      change: safeNumber(f[4]),
+      changePercent: safeNumber(f[5]),
+      volume: safeNumber(f[6]),
+      amount: safeNumber(f[7]),
+      marketCap: safeNumberOrNull(f[9]),
+      marketType: f[10] ?? "",
+      raw: f
+    };
+  }
+  // ---------- 资金流向 ----------
+  /**
+   * 获取资金流向
+   * @param codes 如 ['ff_sz000858']
+   */
+  async getFundFlow(codes) {
+    const data = await this.fetch(codes.join(","));
+    return data.map((d) => this.parseFundFlow(d.fields));
+  }
+  parseFundFlow(f) {
+    return {
+      code: f[0] ?? "",
+      mainInflow: safeNumber(f[1]),
+      mainOutflow: safeNumber(f[2]),
+      mainNet: safeNumber(f[3]),
+      mainNetRatio: safeNumber(f[4]),
+      retailInflow: safeNumber(f[5]),
+      retailOutflow: safeNumber(f[6]),
+      retailNet: safeNumber(f[7]),
+      retailNetRatio: safeNumber(f[8]),
+      totalFlow: safeNumber(f[9]),
+      name: f[12] ?? "",
+      date: f[13] ?? "",
+      raw: f
+    };
+  }
+  // ---------- 盘口大单占比 ----------
+  /**
+   * 获取盘口大单占比
+   * @param codes 如 ['s_pksz000858']
+   */
+  async getPanelLargeOrder(codes) {
+    const data = await this.fetch(codes.join(","));
+    return data.map((d) => this.parsePanelLargeOrder(d.fields));
+  }
+  parsePanelLargeOrder(f) {
+    return {
+      buyLargeRatio: safeNumber(f[0]),
+      buySmallRatio: safeNumber(f[1]),
+      sellLargeRatio: safeNumber(f[2]),
+      sellSmallRatio: safeNumber(f[3]),
+      raw: f
+    };
+  }
+  // ---------- 港股扩展行情 ----------
+  /**
+   * 获取港股扩展行情
+   * @param codes 如 ['r_hk09988']
+   */
+  async getHKQuotes(codes) {
+    const data = await this.fetch(codes.join(","));
+    return data.map((d) => this.parseHKQuote(d.fields));
+  }
+  parseHKQuote(f) {
+    return {
+      marketId: f[0] ?? "",
+      name: f[1] ?? "",
+      code: f[2] ?? "",
+      price: safeNumber(f[3]),
+      prevClose: safeNumber(f[4]),
+      open: safeNumber(f[5]),
+      volume: safeNumber(f[6]),
+      time: f[30] ?? "",
+      change: safeNumber(f[31]),
+      changePercent: safeNumber(f[32]),
+      high: safeNumber(f[33]),
+      low: safeNumber(f[34]),
+      amount: safeNumber(f[36]),
+      lotSize: safeNumberOrNull(f[40]),
+      circulatingMarketCap: safeNumberOrNull(f[46]),
+      totalMarketCap: safeNumberOrNull(f[47]),
+      currency: f[f.length - 3] ?? "",
+      raw: f
+    };
+  }
+  // ---------- 美股简要行情 ----------
+  /**
+   * 获取美股简要行情
+   * @param codes 如 ['s_usBABA']
+   */
+  async getUSQuotes(codes) {
+    const data = await this.fetch(codes.join(","));
+    return data.map((d) => this.parseUSQuote(d.fields));
+  }
+  parseUSQuote(f) {
+    return {
+      marketId: f[0] ?? "",
+      name: f[1] ?? "",
+      code: f[2] ?? "",
+      price: safeNumber(f[3]),
+      change: safeNumber(f[4]),
+      changePercent: safeNumber(f[5]),
+      volume: safeNumber(f[6]),
+      amount: safeNumber(f[7]),
+      marketCap: safeNumberOrNull(f[8]),
+      raw: f
+    };
+  }
+  // ---------- 公募基金行情 ----------
+  /**
+   * 获取公募基金行情
+   * @param codes 如 ['jj000001']
+   */
+  async getFundQuotes(codes) {
+    const data = await this.fetch(codes.join(","));
+    return data.map((d) => this.parseFundQuote(d.fields));
+  }
+  parseFundQuote(f) {
+    return {
+      code: f[0] ?? "",
+      name: f[1] ?? "",
+      nav: safeNumber(f[5]),
+      accNav: safeNumber(f[6]),
+      change: safeNumber(f[7]),
+      navDate: f[8] ?? "",
+      raw: f
+    };
+  }
+  // ---------- 批量混合查询 ----------
+  /**
+   * 批量混合查询，返回原始解析结果（key + fields）
+   * @param params 如 'sz000858,s_sh000001,jj000001'
+   */
+  async batchRaw(params) {
+    return this.fetch(params);
+  }
+};
+var index_default = TencentStockSDK;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TencentStockSDK
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import axios, { AxiosInstance } from 'axios';\nimport {\n  FullQuote,\n  SimpleQuote,\n  FundFlow,\n  PanelLargeOrder,\n  HKQuote,\n  USQuote,\n  FundQuote,\n} from './types';\n\nexport * from './types';\n\nconst BASE_URL = 'http://qt.gtimg.cn';\n\n/**\n * 检测是否在浏览器环境\n */\nfunction isBrowser(): boolean {\n  return typeof window !== 'undefined' && typeof window.document !== 'undefined';\n}\n\n/**\n * 将 ArrayBuffer 解码为 GBK 字符串\n * 浏览器端使用 TextDecoder，Node.js 端使用 iconv-lite\n */\nasync function decodeGBK(data: ArrayBuffer): Promise<string> {\n  if (isBrowser()) {\n    // 浏览器端使用 TextDecoder (原生支持 GBK)\n    const decoder = new TextDecoder('gbk');\n    return decoder.decode(data);\n  } else {\n    // Node.js 端使用 iconv-lite\n    // 动态导入返回模块对象，需要处理 ESM/CJS 兼容性\n    const iconvModule = await import('iconv-lite');\n    const iconv = iconvModule.default || iconvModule;\n    return iconv.decode(Buffer.from(data), 'gbk');\n  }\n}\n\nfunction safeNumber(val: string | undefined): number {\n  if (!val || val === '') return 0;\n  const n = parseFloat(val);\n  return Number.isNaN(n) ? 0 : n;\n}\n\nfunction safeNumberOrNull(val: string | undefined): number | null {\n  if (!val || val === '') return null;\n  const n = parseFloat(val);\n  return Number.isNaN(n) ? null : n;\n}\n\n/**\n * 解析响应文本，按 `;` 拆行，提取 `v_xxx=\"...\"` 里的内容，返回 { key, fields }[]\n */\nfunction parseResponse(text: string): { key: string; fields: string[] }[] {\n  const lines = text.split(';').map((l) => l.trim()).filter(Boolean);\n  const results: { key: string; fields: string[] }[] = [];\n  for (const line of lines) {\n    const eqIdx = line.indexOf('=');\n    if (eqIdx < 0) continue;\n    let key = line.slice(0, eqIdx).trim();\n    if (key.startsWith('v_')) key = key.slice(2);\n    let raw = line.slice(eqIdx + 1).trim();\n    if (raw.startsWith('\"') && raw.endsWith('\"')) {\n      raw = raw.slice(1, -1);\n    }\n    const fields = raw.split('~');\n    results.push({ key, fields });\n  }\n  return results;\n}\n\nexport class TencentStockSDK {\n  private client: AxiosInstance;\n\n  constructor() {\n    this.client = axios.create({\n      baseURL: BASE_URL,\n      responseType: 'arraybuffer',\n      timeout: 10000,\n    });\n  }\n\n  private async fetch(params: string): Promise<{ key: string; fields: string[] }[]> {\n    const resp = await this.client.get('/', { params: { q: params } });\n    const text = await decodeGBK(resp.data);\n    return parseResponse(text);\n  }\n\n  // ---------- 实时全量行情 ----------\n  /**\n   * 获取 A 股 / 指数 全量行情\n   * @param codes 如 ['sz000858', 'sh600000']\n   */\n  async getFullQuotes(codes: string[]): Promise<FullQuote[]> {\n    const data = await this.fetch(codes.join(','));\n    return data.map((d) => this.parseFullQuote(d.fields));\n  }\n\n  private parseFullQuote(f: string[]): FullQuote {\n    const bid: { price: number; volume: number }[] = [];\n    for (let i = 0; i < 5; i++) {\n      bid.push({ price: safeNumber(f[9 + i * 2]), volume: safeNumber(f[10 + i * 2]) });\n    }\n    const ask: { price: number; volume: number }[] = [];\n    for (let i = 0; i < 5; i++) {\n      ask.push({ price: safeNumber(f[19 + i * 2]), volume: safeNumber(f[20 + i * 2]) });\n    }\n    return {\n      marketId: f[0] ?? '',\n      name: f[1] ?? '',\n      code: f[2] ?? '',\n      price: safeNumber(f[3]),\n      prevClose: safeNumber(f[4]),\n      open: safeNumber(f[5]),\n      volume: safeNumber(f[6]),\n      outerVolume: safeNumber(f[7]),\n      innerVolume: safeNumber(f[8]),\n      bid,\n      ask,\n      time: f[30] ?? '',\n      change: safeNumber(f[31]),\n      changePercent: safeNumber(f[32]),\n      high: safeNumber(f[33]),\n      low: safeNumber(f[34]),\n      volume2: safeNumber(f[36]),\n      amount: safeNumber(f[37]),\n      turnoverRate: safeNumberOrNull(f[38]),\n      pe: safeNumberOrNull(f[39]),\n      amplitude: safeNumberOrNull(f[43]),\n      circulatingMarketCap: safeNumberOrNull(f[44]),\n      totalMarketCap: safeNumberOrNull(f[45]),\n      pb: safeNumberOrNull(f[46]),\n      limitUp: safeNumberOrNull(f[47]),\n      limitDown: safeNumberOrNull(f[48]),\n      volumeRatio: safeNumberOrNull(f[49]),\n      avgPrice: safeNumberOrNull(f[51]),\n      peStatic: safeNumberOrNull(f[52]),\n      peDynamic: safeNumberOrNull(f[53]),\n      high52w: safeNumberOrNull(f[67]),\n      low52w: safeNumberOrNull(f[68]),\n      circulatingShares: safeNumberOrNull(f[72]),\n      totalShares: safeNumberOrNull(f[73]),\n      raw: f,\n    };\n  }\n\n  // ---------- 简要行情 ----------\n  /**\n   * 获取简要行情\n   * @param codes 如 ['s_sz000858', 's_sh000001']\n   */\n  async getSimpleQuotes(codes: string[]): Promise<SimpleQuote[]> {\n    const data = await this.fetch(codes.join(','));\n    return data.map((d) => this.parseSimpleQuote(d.fields));\n  }\n\n  private parseSimpleQuote(f: string[]): SimpleQuote {\n    return {\n      marketId: f[0] ?? '',\n      name: f[1] ?? '',\n      code: f[2] ?? '',\n      price: safeNumber(f[3]),\n      change: safeNumber(f[4]),\n      changePercent: safeNumber(f[5]),\n      volume: safeNumber(f[6]),\n      amount: safeNumber(f[7]),\n      marketCap: safeNumberOrNull(f[9]),\n      marketType: f[10] ?? '',\n      raw: f,\n    };\n  }\n\n  // ---------- 资金流向 ----------\n  /**\n   * 获取资金流向\n   * @param codes 如 ['ff_sz000858']\n   */\n  async getFundFlow(codes: string[]): Promise<FundFlow[]> {\n    const data = await this.fetch(codes.join(','));\n    return data.map((d) => this.parseFundFlow(d.fields));\n  }\n\n  private parseFundFlow(f: string[]): FundFlow {\n    return {\n      code: f[0] ?? '',\n      mainInflow: safeNumber(f[1]),\n      mainOutflow: safeNumber(f[2]),\n      mainNet: safeNumber(f[3]),\n      mainNetRatio: safeNumber(f[4]),\n      retailInflow: safeNumber(f[5]),\n      retailOutflow: safeNumber(f[6]),\n      retailNet: safeNumber(f[7]),\n      retailNetRatio: safeNumber(f[8]),\n      totalFlow: safeNumber(f[9]),\n      name: f[12] ?? '',\n      date: f[13] ?? '',\n      raw: f,\n    };\n  }\n\n  // ---------- 盘口大单占比 ----------\n  /**\n   * 获取盘口大单占比\n   * @param codes 如 ['s_pksz000858']\n   */\n  async getPanelLargeOrder(codes: string[]): Promise<PanelLargeOrder[]> {\n    const data = await this.fetch(codes.join(','));\n    return data.map((d) => this.parsePanelLargeOrder(d.fields));\n  }\n\n  private parsePanelLargeOrder(f: string[]): PanelLargeOrder {\n    return {\n      buyLargeRatio: safeNumber(f[0]),\n      buySmallRatio: safeNumber(f[1]),\n      sellLargeRatio: safeNumber(f[2]),\n      sellSmallRatio: safeNumber(f[3]),\n      raw: f,\n    };\n  }\n\n  // ---------- 港股扩展行情 ----------\n  /**\n   * 获取港股扩展行情\n   * @param codes 如 ['r_hk09988']\n   */\n  async getHKQuotes(codes: string[]): Promise<HKQuote[]> {\n    const data = await this.fetch(codes.join(','));\n    return data.map((d) => this.parseHKQuote(d.fields));\n  }\n\n  private parseHKQuote(f: string[]): HKQuote {\n    return {\n      marketId: f[0] ?? '',\n      name: f[1] ?? '',\n      code: f[2] ?? '',\n      price: safeNumber(f[3]),\n      prevClose: safeNumber(f[4]),\n      open: safeNumber(f[5]),\n      volume: safeNumber(f[6]),\n      time: f[30] ?? '',\n      change: safeNumber(f[31]),\n      changePercent: safeNumber(f[32]),\n      high: safeNumber(f[33]),\n      low: safeNumber(f[34]),\n      amount: safeNumber(f[36]),\n      lotSize: safeNumberOrNull(f[40]),\n      circulatingMarketCap: safeNumberOrNull(f[46]),\n      totalMarketCap: safeNumberOrNull(f[47]),\n      currency: f[f.length - 3] ?? '',\n      raw: f,\n    };\n  }\n\n  // ---------- 美股简要行情 ----------\n  /**\n   * 获取美股简要行情\n   * @param codes 如 ['s_usBABA']\n   */\n  async getUSQuotes(codes: string[]): Promise<USQuote[]> {\n    const data = await this.fetch(codes.join(','));\n    return data.map((d) => this.parseUSQuote(d.fields));\n  }\n\n  private parseUSQuote(f: string[]): USQuote {\n    return {\n      marketId: f[0] ?? '',\n      name: f[1] ?? '',\n      code: f[2] ?? '',\n      price: safeNumber(f[3]),\n      change: safeNumber(f[4]),\n      changePercent: safeNumber(f[5]),\n      volume: safeNumber(f[6]),\n      amount: safeNumber(f[7]),\n      marketCap: safeNumberOrNull(f[8]),\n      raw: f,\n    };\n  }\n\n  // ---------- 公募基金行情 ----------\n  /**\n   * 获取公募基金行情\n   * @param codes 如 ['jj000001']\n   */\n  async getFundQuotes(codes: string[]): Promise<FundQuote[]> {\n    const data = await this.fetch(codes.join(','));\n    return data.map((d) => this.parseFundQuote(d.fields));\n  }\n\n  private parseFundQuote(f: string[]): FundQuote {\n    return {\n      code: f[0] ?? '',\n      name: f[1] ?? '',\n      nav: safeNumber(f[5]),\n      accNav: safeNumber(f[6]),\n      change: safeNumber(f[7]),\n      navDate: f[8] ?? '',\n      raw: f,\n    };\n  }\n\n  // ---------- 批量混合查询 ----------\n  /**\n   * 批量混合查询，返回原始解析结果（key + fields）\n   * @param params 如 'sz000858,s_sh000001,jj000001'\n   */\n  async batchRaw(params: string): Promise<{ key: string; fields: string[] }[]> {\n    return this.fetch(params);\n  }\n}\n\nexport default TencentStockSDK;\n\n"],"mappings":"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","names":["axios"]}

package/dist/{types.d.ts → index.d.cts}

@@ -1,7 +1,7 @@
 /**
  * A 股 / 指数 全量行情
  */
-export interface FullQuote {
+interface FullQuote {
     /** 市场标识 */
     marketId: string;
     /** 名称 */
@@ -46,8 +46,10 @@ export interface FullQuote {
     amount: number;
     /** 换手率% */
     turnoverRate: number | null;
-    /** 市盈率 */
+    /** 市盈率(TTM) */
     pe: number | null;
+    /** 振幅% */
+    amplitude: number | null;
     /** 流通市值(亿) */
     circulatingMarketCap: number | null;
     /** 总市值(亿) */
@@ -58,13 +60,29 @@ export interface FullQuote {
     limitUp: number | null;
     /** 跌停价 */
     limitDown: number | null;
+    /** 量比 */
+    volumeRatio: number | null;
+    /** 均价 */
+    avgPrice: number | null;
+    /** 市盈率(静) */
+    peStatic: number | null;
+    /** 市盈率(动) */
+    peDynamic: number | null;
+    /** 52周最高价 */
+    high52w: number | null;
+    /** 52周最低价 */
+    low52w: number | null;
+    /** 流通股本(股) */
+    circulatingShares: number | null;
+    /** 总股本(股) */
+    totalShares: number | null;
     /** 原始字段数组(供扩展使用) */
     raw: string[];
 }
 /**
  * 简要行情（股票 / 指数）
  */
-export interface SimpleQuote {
+interface SimpleQuote {
     marketId: string;
     name: string;
     code: string;
@@ -82,7 +100,7 @@ export interface SimpleQuote {
 /**
  * 资金流向
  */
-export interface FundFlow {
+interface FundFlow {
     code: string;
     /** 主力流入 */
     mainInflow: number;
@@ -109,7 +127,7 @@ export interface FundFlow {
 /**
  * 盘口大单占比
  */
-export interface PanelLargeOrder {
+interface PanelLargeOrder {
     /** 买盘大单占比 */
     buyLargeRatio: number;
     /** 买盘小单占比 */
@@ -123,7 +141,7 @@ export interface PanelLargeOrder {
 /**
  * 港股扩展行情
  */
-export interface HKQuote {
+interface HKQuote {
     marketId: string;
     name: string;
     code: string;
@@ -146,7 +164,7 @@ export interface HKQuote {
 /**
  * 美股简要行情
  */
-export interface USQuote {
+interface USQuote {
     marketId: string;
     name: string;
     code: string;
@@ -161,7 +179,7 @@ export interface USQuote {
 /**
  * 公募基金行情
  */
-export interface FundQuote {
+interface FundQuote {
     code: string;
     name: string;
     /** 最新单位净值 */
@@ -174,4 +192,61 @@ export interface FundQuote {
     navDate: string;
     raw: string[];
 }
-//# sourceMappingURL=types.d.ts.map
+
+declare class TencentStockSDK {
+    private client;
+    constructor();
+    private fetch;
+    /**
+     * 获取 A 股 / 指数 全量行情
+     * @param codes 如 ['sz000858', 'sh600000']
+     */
+    getFullQuotes(codes: string[]): Promise<FullQuote[]>;
+    private parseFullQuote;
+    /**
+     * 获取简要行情
+     * @param codes 如 ['s_sz000858', 's_sh000001']
+     */
+    getSimpleQuotes(codes: string[]): Promise<SimpleQuote[]>;
+    private parseSimpleQuote;
+    /**
+     * 获取资金流向
+     * @param codes 如 ['ff_sz000858']
+     */
+    getFundFlow(codes: string[]): Promise<FundFlow[]>;
+    private parseFundFlow;
+    /**
+     * 获取盘口大单占比
+     * @param codes 如 ['s_pksz000858']
+     */
+    getPanelLargeOrder(codes: string[]): Promise<PanelLargeOrder[]>;
+    private parsePanelLargeOrder;
+    /**
+     * 获取港股扩展行情
+     * @param codes 如 ['r_hk09988']
+     */
+    getHKQuotes(codes: string[]): Promise<HKQuote[]>;
+    private parseHKQuote;
+    /**
+     * 获取美股简要行情
+     * @param codes 如 ['s_usBABA']
+     */
+    getUSQuotes(codes: string[]): Promise<USQuote[]>;
+    private parseUSQuote;
+    /**
+     * 获取公募基金行情
+     * @param codes 如 ['jj000001']
+     */
+    getFundQuotes(codes: string[]): Promise<FundQuote[]>;
+    private parseFundQuote;
+    /**
+     * 批量混合查询，返回原始解析结果（key + fields）
+     * @param params 如 'sz000858,s_sh000001,jj000001'
+     */
+    batchRaw(params: string): Promise<{
+        key: string;
+        fields: string[];
+    }[]>;
+}
+
+export { type FullQuote, type FundFlow, type FundQuote, type HKQuote, type PanelLargeOrder, type SimpleQuote, TencentStockSDK, type USQuote, TencentStockSDK as default };