daxiapi-cli 1.2.0 → 2.0.1

package/commands/sector.js

@@ -0,0 +1,121 @@
+const config = require('../lib/config');
+const api = require('../lib/api');
+const {handleError, createParameterError} = require('../lib/error');
+const {output} = require('../lib/output');
+
+module.exports = function (program) {
+    const sectorCmd = program.command('sector');
+
+    sectorCmd
+        .command('heatmap')
+        .description('获取A股板块热力图数据（同花顺分类），支持按强度(cs)、涨跌幅(zdf)等多个维度排序，可查询1-30天数据。返回板块强度热力图、涨跌幅热力图、箱体突破板块统计、强度与均线交叉板块等信息。可用于板块轮动分析、强势板块识别和热点追踪。')
+        .option('--order <field>', '排序字段', 'cs')
+        .option('--limit <num>', '数量限制', 5)
+        .action(async options => {
+            try {
+                const token = config.getToken();
+                if (!token) {
+                    const error = new Error('未配置 API Token');
+                    error.response = {status: 401};
+                    throw error;
+                }
+
+                const data = await api.getSectorData(token, options.order, options.limit);
+                output(data);
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
+
+    sectorCmd
+        .command('bk')
+        .description('获取A股行业板块数据（同花顺分类），包括行业名称、今日涨幅、5日涨幅、20日涨幅、CS强度、CS均线、强度指标(QD)等核心数据。数据按今日涨幅降序排列，可用于板块轮动分析、强势板块识别和行业配置参考。')
+        .action(async () => {
+            try {
+                const token = config.getToken();
+                if (!token) {
+                    const error = new Error('未配置 API Token');
+                    error.response = {status: 401};
+                    throw error;
+                }
+
+                const data = await api.getBkData(token);
+                output(data);
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
+
+    sectorCmd
+        .command('stocks')
+        .description('获取A股指定板块内股票排名，支持BK0428、0428、881155等多种板块代码格式。支持按强度(cs)、涨跌幅(zdf)、市值(sm)、成交额(cg)、换手率(cr)、SCTR排名等多种维度排序。返回板块内前20只股票的详细数据，可用于板块内强势股筛选和个股分析。')
+        .requiredOption('--code <bkCode>', '板块代码')
+        .option('--order <field>', '排序字段', 'cs')
+        .action(async options => {
+            try {
+                const token = config.getToken();
+                if (!token) {
+                    const error = new Error('未配置 API Token');
+                    error.response = {status: 401};
+                    throw error;
+                }
+
+                const data = await api.getSectorRankStock(token, options.code, options.order);
+                output(data);
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
+
+    sectorCmd
+        .command('top')
+        .description('获取A股热门股票数据，筛选当日涨幅>7%且IBS>50的强势股，按板块分组展示每个板块内强度排名前10的股票。返回股票名称、代码、涨幅、5/10/20日涨跌幅、所属板块、概念等信息，可用于短线热点追踪和强势股挖掘。')
+        .action(async () => {
+            try {
+                const token = config.getToken();
+                if (!token) {
+                    const error = new Error('未配置 API Token');
+                    error.response = {status: 401};
+                    throw error;
+                }
+
+                const data = await api.getTopStocks(token);
+                output(data);
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
+
+    sectorCmd
+        .command('gn')
+        .description('获取A股热门概念板块列表，支持同花顺(ths)和东方财富(dfcf)两个数据源。按板块内涨幅7%以上股票个数降序排序，返回前20个概念板块的名称、今日涨幅、7%+股票数、5/10/20日涨幅、强度指标(QD)、CS强度等信息。可用于概念板块热度分析和热点追踪。')
+        .option('--type <type>', '数据源类型 (dfcf|ths)', 'ths')
+        .action(async options => {
+            try {
+                const token = config.getToken();
+                if (!token) {
+                    const error = new Error('未配置 API Token');
+                    error.response = {status: 401};
+                    throw error;
+                }
+
+                if (!['dfcf', 'ths'].includes(options.type)) {
+                    throw createParameterError(
+                        '参数无效',
+                        ["参数 'type' 必须是 dfcf 或 ths"],
+                        ['daxiapi sector gn --type ths', 'daxiapi sector gn --type dfcf']
+                    );
+                }
+
+                const data = await api.getGnHot(token, options.type);
+                output(data);
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
+};

package/commands/stock.js

@@ -0,0 +1,80 @@
+const config = require('../lib/config');
+const api = require('../lib/api');
+const {handleError, createParameterError} = require('../lib/error');
+const {output} = require('../lib/output');
+
+module.exports = function(program) {
+    const stockCmd = program.command('stock');
+
+    stockCmd
+        .command('info')
+        .description('根据股票代码获取A股详细信息，支持多个代码用逗号分隔（最多20只），支持6位数字代码和116.xxx格式。返回股票名称、代码、涨跌幅、CS强度、SCTR排名、所属板块、概念、市值、成交额等详细数据。可用于个股分析和多只股票对比。')
+        .argument('<codes...>', '股票代码（支持多个）')
+        .action(async (codes) => {
+            try {
+                const token = config.getToken();
+                if (!token) {
+                    const error = new Error('未配置 API Token');
+                    error.response = {status: 401};
+                    throw error;
+                }
+
+                if (!codes || codes.length === 0) {
+                    throw createParameterError(
+                        '参数无效',
+                        ["参数 'codes' 不能为空"],
+                        [
+                            'daxiapi stock info 000001',
+                            'daxiapi stock info 000001 600031 300750'
+                        ]
+                    );
+                }
+
+                const data = await api.getStockData(token, codes);
+                output(data);
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
+
+    stockCmd
+        .command('gn <gnId>')
+        .description('根据概念板块ID获取该概念下的所有股票数据，支持同花顺(881155)和东方财富(BK0428)两种格式的板块ID。自动根据ID格式选择数据源，返回股票名称、代码、涨跌幅、CS强度、SCTR排名等详细信息，最多返回300只股票。可用于概念板块成分股分析和板块内股票筛选。')
+        .option('--type <type>', '数据源类型 (dfcf|ths)', 'ths')
+        .action(async (gnId, options) => {
+            try {
+                const token = config.getToken();
+                if (!token) {
+                    const error = new Error('未配置 API Token');
+                    error.response = {status: 401};
+                    throw error;
+                }
+
+                if (!gnId) {
+                    throw createParameterError(
+                        '参数无效',
+                        ["参数 'gnId' 不能为空"],
+                        ['daxiapi stock gn GN1234']
+                    );
+                }
+
+                if (!['dfcf', 'ths'].includes(options.type)) {
+                    throw createParameterError(
+                        '参数无效',
+                        ["参数 'type' 必须是 dfcf 或 ths"],
+                        [
+                            'daxiapi stock gn GN1234 --type ths',
+                            'daxiapi stock gn GN1234 --type dfcf'
+                        ]
+                    );
+                }
+
+                const data = await api.getGainianStock(token, gnId, options.type);
+                output(data);
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
+};

package/commands/zdt.js

@@ -0,0 +1,39 @@
+const config = require('../lib/config');
+const api = require('../lib/api');
+const {handleError, createParameterError} = require('../lib/error');
+const {output} = require('../lib/output');
+
+module.exports = function(program) {
+    program
+        .command('zdt')
+        .description('获取A股涨跌停股票池数据，支持查询涨停(zt)、跌停(dt)、炸板(zb)三类股票。返回股票代码、名称、涨停统计、所属行业、概念、CS强度、SCTR排名等信息，并提供市场整体涨跌停统计。可用于短线热点追踪和市场情绪分析。')
+        .option('--type <type>', '类型 (zt|dt|zb)', 'zt')
+        .action(async (options) => {
+            try {
+                const token = config.getToken();
+                if (!token) {
+                    const error = new Error('未配置 API Token');
+                    error.response = {status: 401};
+                    throw error;
+                }
+
+                if (!['zt', 'dt', 'zb'].includes(options.type)) {
+                    throw createParameterError(
+                        '参数无效',
+                        ["参数 'type' 必须是 zt、dt 或 zb"],
+                        [
+                            'daxiapi zdt --type zt',
+                            'daxiapi zdt --type dt',
+                            'daxiapi zdt --type zb'
+                        ]
+                    );
+                }
+
+                const data = await api.getZdtPool(token, options.type);
+                output(data);
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
+};

package/lib/api.js

@@ -1,286 +1,128 @@
 const axios = require('axios');
 const config = require('./config');
 
-const BASE_URL = config.getBaseUrl() || 'https://daxiapi.com';
+const BASE_URL = config.get('baseUrl') || 'https://daxiapi.com';
 
-/**
- * 获取市场类型前缀
- */
-function getMarketPrefix(code) {
-    if (code.startsWith('688') || code.startsWith('689')) {
-        return 'sh';
-    }
-    if (code.startsWith('60')) {
-        return 'sh';
-    }
-    return 'sz';
-}
-
-/**
- * 创建请求实例
- */
 function createClient(token) {
     return axios.create({
         baseURL: `${BASE_URL}/coze`,
         headers: {
-            'X-API-Token': token,
+            'Authorization': `Bearer ${token}`,
             'Content-Type': 'application/json'
         },
         timeout: 30000
     });
 }
 
-/**
- * GET 请求
- */
 async function get(client, path) {
     const {data} = await client.get(path);
     if (data.errCode !== 0) {
-        throw new Error(data.errMsg || `API Error: ${data.errCode}`);
+        const error = new Error(data.errMsg || `API Error: ${data.errCode}`);
+        error.response = {status: data.errCode};
+        throw error;
     }
     return data.data;
 }
 
-/**
- * POST 请求
- */
 async function post(client, path, body = {}) {
     const {data} = await client.post(path, body);
     if (data.errCode !== 0) {
-        throw new Error(data.errMsg || `API Error: ${data.errCode}`);
+        const error = new Error(data.errMsg || `API Error: ${data.errCode}`);
+        error.response = {status: data.errCode};
+        throw error;
     }
     return data.data;
 }
 
-// ==================== API 方法 ====================
-
-/**
- * 获取指数K线
- */
-async function getIndexK(token) {
-    const client = createClient(token);
-    return get(client, '/get_index_k');
-}
-
-/**
- * 获取市场数据
- */
 async function getMarketData(token) {
     const client = createClient(token);
-    return get(client, '/get_market_data');
+    return get(client, '/get_index_data');
 }
 
-/**
- * 获取市场温度
- */
-async function getMarketDegree(token) {
+async function getMarketTemp(token) {
     const client = createClient(token);
-    return get(client, '/get_market_degree');
+    return get(client, '/get_market_temp');
 }
 
-/**
- * 获取市场风格
- */
 async function getMarketStyle(token) {
     const client = createClient(token);
     return get(client, '/get_market_style');
 }
 
-/**
- * 获取指数估值
- */
 async function getMarketValueData(token) {
     const client = createClient(token);
     return get(client, '/get_market_value_data');
 }
 
-/**
- * 获取收盘新闻
- */
-async function getMarketNews(token) {
+async function getBkData(token) {
     const client = createClient(token);
-    return get(client, '/get_market_end_news');
+    return get(client, '/get_bk_data');
 }
 
-/**
- * 获取板块热力图
- */
-async function getSectorData(token, orderBy = 'cs', lmt = 5) {
+async function getSectorData(token, orderBy = 'cs', limit = 5) {
     const client = createClient(token);
-    return post(client, '/get_sector_data', {orderBy, lmt});
+    return post(client, '/get_sector_data', {orderBy, lmt: limit});
 }
 
-/**
- * 获取板块内个股排名
- */
 async function getSectorRankStock(token, sectorCode, orderBy = 'cs') {
     const client = createClient(token);
     return post(client, '/get_sector_rank_stock', {sectorCode, orderBy});
 }
 
-/**
- * 获取概念内个股
- */
-async function getGainianStock(token, gnId) {
+async function getTopStocks(token) {
     const client = createClient(token);
-    return post(client, '/get_gainian_stock', {gnId});
+    return post(client, '/get_top_stocks', {});
+}
+
+async function getGnHot(token, type = 'ths') {
+    const client = createClient(token);
+    return post(client, '/get_gn_hot', {type});
 }
 
-/**
- * 获取个股数据
- */
 async function getStockData(token, codes) {
     const client = createClient(token);
     return post(client, '/get_stock_data', {code: codes});
 }
 
-/**
- * 搜索股票/行业
- */
-async function queryStock(token, keyword, type = 'stock') {
+async function getGainianStock(token, gnId, type = 'ths') {
     const client = createClient(token);
-    return post(client, '/query_stock_data', {q: keyword, type});
+    return post(client, '/get_gainian_stock', {gnId, type});
 }
 
-/**
- * 获取概念板块数据
- */
-async function getGnTable(token) {
+async function getKline(token, code) {
     const client = createClient(token);
-    return post(client, '/get_gn_table');
+    return post(client, '/get_kline', {code});
 }
 
-// ==================== K线数据（多数据源） ====================
-
-/**
- * 获取K线数据（首选腾讯，备选东方财富）
- * @param {string} code - 股票代码
- * @param {number} limit - 数据条数，默认300
- * @param {string} type - K线类型: day(日线), week(周线), month(月线)
- * @returns {Promise<Object>} K线数据
- */
-async function getKline(code, limit = 300, type = 'day') {
-    // 首选腾讯
-    try {
-        const data = await getKlineFromQQ(code, limit, type);
-        return {source: 'qq', ...data};
-    } catch (err) {
-        console.log('腾讯数据源失败，切换到东方财富...');
-    }
-
-    // 备选东方财富
-    try {
-        const data = await getKlineFromEastmoney(code, limit, type);
-        return {source: 'eastmoney', ...data};
-    } catch (err) {
-        throw new Error('所有数据源均失败，请稍后重试');
-    }
+async function getZdtPool(token, type = 'zt') {
+    const client = createClient(token);
+    return post(client, '/get_zdt_pool', {type});
 }
 
-/**
- * 腾讯财经K线数据
- * @param {string} code - 股票代码
- * @param {number} limit - 数据条数
- * @param {string} type - K线类型
- */
-async function getKlineFromQQ(code, limit = 500, type = 'day') {
-    const market = getMarketPrefix(code);
-    const fullCode = `${market}${code}`;
-
-    // 腾讯接口限制最大2000条
-    if (limit > 2000) {
-        limit = 2000;
-    }
-
-    const url = `https://proxy.finance.qq.com/ifzqgtimg/appstock/app/newfqkline/get?_var=&param=${fullCode},${type},,,${limit},qfq&r=0.${Date.now()}`;
-
-    const {data} = await axios.get(url, {timeout: 10000});
-
-    if (!data.data || !data.data[fullCode]) {
-        throw new Error('腾讯数据源返回异常');
-    }
-
-    const klineData = data.data[fullCode].qfqday || data.data[fullCode].day;
-    if (!klineData || klineData.length === 0) {
-        throw new Error('无K线数据');
-    }
-
-    const klines = klineData.map(([date, open, close, high, low, volume, , , amount]) => ({
-        date,
-        open: parseFloat(open),
-        close: parseFloat(close),
-        high: parseFloat(high),
-        low: parseFloat(low),
-        volume: parseFloat(volume),
-        amount: parseFloat(amount)
-    }));
-
-    return {
-        code,
-        name: data.data[fullCode].qt?.[fullCode]?.[1] || code,
-        klines,
-        count: klines.length
-    };
+async function getSecId(token, code) {
+    const client = createClient(token);
+    return post(client, '/get_sec_id', {code});
 }
 
-/**
- * 东方财富K线数据
- * @param {string} code - 股票代码
- * @param {number} limit - 数据条数
- * @param {string} type - K线类型: day=101, week=102, month=103
- */
-async function getKlineFromEastmoney(code, limit = 300, type = 'day') {
-    // K线类型映射
-    const kltMap = {day: '101', week: '102', month: '103'};
-    const klt = kltMap[type] || '101';
-
-    // 市场代码
-    const secid = code.startsWith('6') ? `1.${code}` : `0.${code}`;
-
-    const url = `https://push2his.eastmoney.com/api/qt/stock/kline/get?fields1=f1,f2,f3,f4,f5,f6&fields2=f51,f52,f53,f54,f55,f56,f57,f58,f61&ut=7eea3edcaed734bea9cbfc24409ed989&end=29991010&klt=${klt}&secid=${secid}&fqt=1&lmt=${limit}`;
-
-    const {data} = await axios.get(url, {timeout: 10000});
-
-    if (!data.data || !data.data.klines) {
-        throw new Error('东方财富数据源返回异常');
-    }
-
-    const klines = data.data.klines.map(line => {
-        const [date, open, close, high, low, volume, amount, , turnover] = line.split(',');
-        return {
-            date,
-            open: parseFloat(open),
-            close: parseFloat(close),
-            high: parseFloat(high),
-            low: parseFloat(low),
-            volume: parseFloat(volume),
-            amount: parseFloat(amount),
-            turnover: parseFloat(turnover) || 0
-        };
-    });
-
-    return {
-        code,
-        name: data.data.name || code,
-        klines,
-        count: klines.length
-    };
+async function queryStockData(token, q, type = 'stock') {
+    const client = createClient(token);
+    return post(client, '/query_stock_data', {q, type});
 }
 
 module.exports = {
-    getIndexK,
     getMarketData,
-    getMarketDegree,
+    getMarketTemp,
     getMarketStyle,
     getMarketValueData,
-    getMarketNews,
+    getBkData,
     getSectorData,
     getSectorRankStock,
-    getGainianStock,
+    getTopStocks,
+    getGnHot,
     getStockData,
-    queryStock,
-    getGnTable,
+    getGainianStock,
     getKline,
-    getKlineFromQQ,
-    getKlineFromEastmoney
+    getZdtPool,
+    getSecId,
+    queryStockData
 };

package/lib/config.js

@@ -17,30 +17,18 @@ const config = new Conf({
     schema 
 });
 
-/**
- * 获取Token（优先环境变量）
- */
 function getToken() {
     return process.env.DAXIAPI_TOKEN || config.get('token');
 }
 
-/**
- * 获取配置项
- */
 function get(key) {
     return config.get(key);
 }
 
-/**
- * 设置配置项
- */
 function set(key, value) {
     config.set(key, value);
 }
 
-/**
- * 获取所有配置
- */
 function getAll() {
     return {
         token: getToken() ? '******' + getToken().slice(-4) : undefined,
@@ -48,9 +36,6 @@ function getAll() {
     };
 }
 
-/**
- * 删除配置项
- */
 function del(key) {
     config.delete(key);
 }

package/lib/error.js

@@ -0,0 +1,80 @@
+const chalk = require('chalk');
+
+const errorMessages = {
+    401: {
+        title: 'API Token 无效或已过期',
+        solutions: [
+            '检查 Token 是否正确配置:\n     daxiapi config set token YOUR_TOKEN',
+            '或设置环境变量:\n     export DAXIAPI_TOKEN=YOUR_TOKEN',
+            'Token 可在 daxiapi.com 用户中心获取'
+        ]
+    },
+    403: {
+        title: '无访问权限',
+        solutions: [
+            '检查您的账户是否有访问该接口的权限',
+            '联系管理员开通相关权限',
+            '访问 daxiapi.com 了解权限说明'
+        ]
+    },
+    429: {
+        title: '请求频率超限',
+        solutions: [
+            '请稍后重试',
+            '检查您的请求频率是否过高',
+            '升级账户获取更高配额'
+        ]
+    },
+    500: {
+        title: '服务器内部错误',
+        solutions: [
+            '请稍后重试',
+            '如果问题持续，请联系技术支持',
+            '访问 daxiapi.com 查看服务状态'
+        ]
+    }
+};
+
+function handleError(error) {
+    console.log(chalk.red.bold('\n❌ 错误:'), error.message || error.title);
+
+    const statusCode = error.response?.status || error.statusCode;
+    const errorInfo = errorMessages[statusCode];
+
+    if (errorInfo) {
+        console.log(chalk.bold('\n解决方法:'));
+        errorInfo.solutions.forEach((solution, index) => {
+            console.log(`  ${index + 1}. ${solution}`);
+        });
+    } else if (error.code === 'ECONNREFUSED' || error.code === 'ENOTFOUND') {
+        console.log(chalk.bold('\n解决方法:'));
+        console.log('  1. 检查网络连接是否正常');
+        console.log('  2. 检查 API 地址是否正确:\n     daxiapi config set baseUrl https://daxiapi.com');
+        console.log('  3. 如果使用代理，请检查代理配置');
+    } else if (error.details) {
+        console.log(chalk.bold('\n详细信息:'));
+        error.details.forEach(detail => {
+            console.log(`  - ${detail}`);
+        });
+        if (error.examples) {
+            console.log(chalk.bold('\n使用示例:'));
+            error.examples.forEach(example => {
+                console.log(`  ${example}`);
+            });
+        }
+    }
+
+    console.log('');
+}
+
+function createParameterError(message, details, examples) {
+    const error = new Error(message);
+    error.details = details;
+    error.examples = examples;
+    return error;
+}
+
+module.exports = {
+    handleError,
+    createParameterError
+};