daxiapi-cli 1.2.0 → 2.0.1

package/README.md

@@ -1,6 +1,6 @@
 # daxiapi-cli
 
-大虾皮(daxiapi.com)金融数据API命令行工具。需要注册 daxiapi.com 网站，并且获取API Token之后才能使用。
+大虾皮金融数据API命令行工具。需要注册 daxiapi.com 网站，并且获取API Token之后才能使用。
 
 ## 安装
 
@@ -45,116 +45,124 @@ daxiapi config delete token
 ### 市场数据
 
 ```bash
-# 市场概览（默认）
+# 市场概览（主流指数）
 daxiapi market
 
 # 市场温度
-daxiapi market -d
+daxiapi market temp
 
-# 大小盘风格
-daxiapi market -s
+# 市场风格
+daxiapi market style
 
-# 指数估值
-daxiapi market -v
-
-# 收盘新闻
-daxiapi market -n
-```
-
-### 指数K线
-
-```bash
-# 获取上证指数K线
-daxiapi index
+# 市场估值
+daxiapi market value
 ```
 
 ### 板块数据
 
 ```bash
-# 板块热力图
+# 板块列表
 daxiapi sector
 
-# 指定排序字段和天数
-daxiapi sector -o zdf -l 10
+# 指定排序和数量
+daxiapi sector --order zdf --limit 10
+
+# 行业板块数据
+daxiapi sector bk
 
-# 获取板块内个股排名
-daxiapi sector -c BK0477 -o cs
+# 板块内个股排名
+daxiapi sector stocks --code BK0477
 
-# 获取概念内个股
-daxiapi sector -g GN1234
+# 热门股票
+daxiapi sector top
+
+# 热门概念
+daxiapi sector gn
 ```
 
-### 个股查询
+### 股票数据
 
 ```bash
+# 搜索股票或板块
+daxiapi search 平安
+daxiapi search 锂电 --type bk
+
 # 查询单个股票
 daxiapi stock 000001
 
 # 查询多个股票
 daxiapi stock 000001 600031 300750
 
-# JSON格式输出
-daxiapi stock 000001 --json
+# 概念股查询
+daxiapi stock gn GN1234
+```
+
+### K线数据
+
+```bash
+# 获取K线数据
+daxiapi kline 000001
 ```
 
-### 搜索
+### 涨跌停
 
 ```bash
-# 搜索股票
-daxiapi search 三一重工
+# 涨停池
+daxiapi zdt
 
-# 搜索行业
-daxiapi search 机械 -t hy
+# 跌停池
+daxiapi zdt --type dt
+```
+
+### 工具
+
+```bash
+# 代码转换
+daxiapi secid 000001
 ```
 
 > 💡 提示：`daxiapi` 命令也可以使用简写 `dxp`
 
-## 输出示例
+## 全局选项
 
-### 市场概览
+```bash
+# 查看帮助
+daxiapi --help
+daxiapi market --help
 
-```
-📈 市场概览
-
-主要指数:
-┌─────────┬────────┬───────────┬───────┬─────────┬─────────┐
-│ (index) │  名称  │  涨跌幅   │  CS   │   5日   │   20日  │
-├─────────┼────────┼───────────┼───────┼─────────┼─────────┤
-│    0    │ '上证' │ '0.50%'   │  5.23 │ '2.10%' │ '3.50%' │
-│    1    │ '深证' │ '0.80%'   │  6.45 │ '2.50%' │ '4.20%' │
-│    2    │ '创业' │ '1.20%'   │  8.12 │ '3.00%' │ '5.10%' │
-└─────────┴────────┴───────────┴───────┴─────────┴─────────┘
+# 查看版本
+daxiapi --version
 ```
 
-### 个股详情
+## 错误处理
+
+CLI 工具提供详细的错误提示和解决建议：
+
+### 认证错误 (401)
 
 ```
-📊 个股详情
+❌ 错误: API Token 无效或已过期
+
+解决方法:
+  1. 检查 Token 是否正确配置:
+     daxiapi config set token YOUR_TOKEN
 
-三一重工 (600031)
-────────────────────────────────────────
-价格: 18.50  涨跌幅: 2.50%
+  2. 或设置环境变量:
+     export DAXIAPI_TOKEN=YOUR_TOKEN
 
-动量指标:
-  CS(短期): 8.25  SM(中期): 5.30  ML(长期): 3.20
-  RPS: 85  SCTR: 72
+  3. Token 可在 daxiapi.com 用户中心获取
+```
+
+### 限流错误 (429)
 
-形态标签: Good, LPS
-技术形态: VCP, SOS
 ```
+❌ 错误: 请求频率超限
 
-## 核心指标说明
-
-| 指标 | 说明 |
-|------|------|
-| CS | 短期动量，股价与20日均线乖离率。>0在均线上方，>30可能反转 |
-| SM | 中期动量，短期与中期均线乖离率。>0多头排列 |
-| ML | 长期动量，中期与长期均线乖离率 |
-| RPS | 欧奈尔相对强度，>80为强势股 |
-| SCTR | 技术排名百分比，如60代表强于市场60%股票 |
-| VCP | 马克米勒维尼波动收缩模式 |
-| SOS | Wyckoff强势走势行为 |
-| LPS | Wyckoff最后支撑点 |
+解决方法:
+  1. 请稍后重试
+  2. 检查您的请求频率是否过高
+  3. 升级账户获取更高配额
+```
 
 ## 限流规则
 

package/bin/index.js

@@ -1,209 +1,21 @@
 #!/usr/bin/env node
 
 const {program} = require('commander');
-const chalk = require('chalk');
-const config = require('../lib/config');
-const api = require('../lib/api');
-const output = require('../lib/output');
-
-// 显示欢迎信息
-function showWelcome() {
-    console.log(chalk.cyan.bold('\n📊 大虾皮 CLI - A股量化数据工具\n'));
-}
-
-// 检查Token配置
-function checkToken() {
-    const token = config.getToken();
-    if (!token) {
-        console.log(chalk.yellow('⚠️  未配置 API Token'));
-        console.log(chalk.gray('   请先运行: daxiapi config set token YOUR_TOKEN'));
-        console.log(chalk.gray('   或设置环境变量: DAXIAPI_TOKEN=YOUR_TOKEN\n'));
-        process.exit(1);
-    }
-    return token;
-}
+const package = require('../package.json');
 
 program
     .name('daxiapi')
-    .version('1.0.0')
-    .description('大虾皮(daxiapi.com)金融数据API命令行工具');
-
-// ==================== 配置命令 ====================
-program
-    .command('config')
-    .description('配置管理')
-    .argument('<action>', 'set/get/delete')
-    .argument('[key]', '配置项名称')
-    .argument('[value]', '配置项值')
-    .action((action, key, value) => {
-        switch (action) {
-            case 'set':
-                if (!key || !value) {
-                    console.log(chalk.red('用法: daxiapi config set <key> <value>'));
-                    console.log(chalk.gray('示例: daxiapi config set token abc123...'));
-                    return;
-                }
-                config.set(key, value);
-                console.log(chalk.green(`✓ 已设置 ${key}`));
-                break;
-            case 'get':
-                if (!key) {
-                    const all = config.getAll();
-                    console.log(JSON.stringify(all, null, 2));
-                } else {
-                    console.log(config.get(key) || '');
-                }
-                break;
-            case 'delete':
-                config.delete(key);
-                console.log(chalk.green(`✓ 已删除 ${key}`));
-                break;
-            default:
-                console.log(chalk.red('未知操作:', action));
-        }
-    });
-
-// ==================== 市场数据命令 ====================
-program
-    .command('market')
-    .description('市场数据')
-    .option('-d, --degree', '获取市场温度')
-    .option('-s, --style', '获取大小盘风格')
-    .option('-v, --value', '获取指数估值')
-    .option('-n, --news', '获取收盘新闻')
-    .action(async options => {
-        showWelcome();
-        const token = checkToken();
-
-        try {
-            if (options.degree) {
-                const data = await api.getMarketDegree(token);
-                output.text(data);
-            } else if (options.style) {
-                const data = await api.getMarketStyle(token);
-                output.table(data);
-            } else if (options.value) {
-                const data = await api.getMarketValueData(token);
-                output.valueTable(data);
-            } else if (options.news) {
-                const data = await api.getMarketNews(token);
-                output.newsList(data);
-            } else {
-                // 默认获取市场概览
-                const data = await api.getMarketData(token);
-                output.marketOverview(data);
-            }
-        } catch (err) {
-            output.error(err);
-        }
-    });
-
-// ==================== 指数K线命令 ====================
-program
-    .command('index')
-    .description('获取上证指数K线数据')
-    .action(async () => {
-        showWelcome();
-        const token = checkToken();
-
-        try {
-            const data = await api.getIndexK(token);
-            output.klines(data);
-        } catch (err) {
-            output.error(err);
-        }
-    });
-
-// ==================== 板块数据命令 ====================
-program
-    .command('sector')
-    .description('板块数据')
-    .option('-c, --code <code>', '板块代码，获取板块内个股')
-    .option('-o, --order <field>', '排序字段', 'cs')
-    .option('-l, --limit <days>', '天数', '5')
-    .option('-g, --gn <gnId>', '概念代码，获取概念内个股')
-    .action(async options => {
-        showWelcome();
-        const token = checkToken();
-
-        try {
-            if (options.code) {
-                const data = await api.getSectorRankStock(token, options.code, options.order);
-                output.stockList(data);
-            } else if (options.gn) {
-                const data = await api.getGainianStock(token, options.gn);
-                output.stockList(data);
-            } else {
-                const data = await api.getSectorData(token, options.order, parseInt(options.limit));
-                output.sectorHeatmap(data);
-            }
-        } catch (err) {
-            output.error(err);
-        }
-    });
-
-// ==================== 个股查询命令 ====================
-program
-    .command('stock <codes...>')
-    .description('获取个股数据，支持多个股票代码')
-    .option('-j, --json', '输出JSON格式')
-    .action(async (codes, options) => {
-        showWelcome();
-        const token = checkToken();
-
-        try {
-            const data = await api.getStockData(token, codes.join(','));
-            if (options.json) {
-                console.log(JSON.stringify(data, null, 2));
-            } else {
-                output.stockDetail(data);
-            }
-        } catch (err) {
-            output.error(err);
-        }
-    });
-
-// ==================== 搜索命令 ====================
-program
-    .command('search <keyword>')
-    .description('搜索股票或行业')
-    .option('-t, --type <type>', '类型: stock/hy', 'stock')
-    .action(async (keyword, options) => {
-        showWelcome();
-        const token = checkToken();
-
-        try {
-            const data = await api.queryStock(token, keyword, options.type);
-            output.searchResult(data);
-        } catch (err) {
-            output.error(err);
-        }
-    });
-
-// ==================== K线数据命令 ====================
-program
-    .command('kline <code>')
-    .description('获取个股K线数据')
-    .option('-l, --limit <days>', '数据条数', '300')
-    .option('-t, --type <type>', 'K线类型: day/week/month', 'day')
-    .option('-j, --json', '输出JSON格式')
-    .option('-s, --simple', '简单输出格式')
-    .action(async (code, options) => {
-        showWelcome();
-        // K线数据不需要token，使用免费数据源
-
-        try {
-            const data = await api.getKline(code, parseInt(options.limit), options.type);
-            if (options.json) {
-                console.log(JSON.stringify(data, null, 2));
-            } else if (options.simple) {
-                output.klineSimple(data, 10);
-            } else {
-                output.klineData(data, 20);
-            }
-        } catch (err) {
-            output.error(err);
-        }
-    });
-
-program.parse();
+    .alias('dxp')
+    .version(package.version)
+    .description('大虾皮金融数据API命令行工具');
+
+require('../commands/config')(program);
+require('../commands/market')(program);
+require('../commands/sector')(program);
+require('../commands/stock')(program);
+require('../commands/kline')(program);
+require('../commands/zdt')(program);
+require('../commands/secid')(program);
+require('../commands/search')(program);
+
+program.parse(process.argv);

package/commands/config.js

@@ -0,0 +1,67 @@
+const config = require('../lib/config');
+const { handleError, createParameterError } = require('../lib/error');
+
+module.exports = function(program) {
+    const configCmd = program.command('config');
+
+    configCmd
+        .command('set <key> <value>')
+        .description('设置配置项')
+        .action((key, value) => {
+            try {
+                if (!key || !value) {
+                    throw createParameterError(
+                        '参数无效',
+                        [
+                            "参数 'key' 不能为空",
+                            "参数 'value' 不能为空"
+                        ],
+                        [
+                            'daxiapi config set token YOUR_TOKEN',
+                            'daxiapi config set baseUrl https://daxiapi.com'
+                        ]
+                    );
+                }
+
+                config.set(key, value);
+                console.log(`✓ ${key} 已设置`);
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
+
+    configCmd
+        .command('get')
+        .description('查看所有配置')
+        .action(() => {
+            try {
+                const allConfig = config.getAll();
+                console.log(JSON.stringify(allConfig, null, 2));
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
+
+    configCmd
+        .command('delete <key>')
+        .description('删除配置项')
+        .action((key) => {
+            try {
+                if (!key) {
+                    throw createParameterError(
+                        '参数无效',
+                        ["参数 'key' 不能为空"],
+                        ['daxiapi config delete token']
+                    );
+                }
+
+                config.delete(key);
+                console.log(`✓ ${key} 已删除`);
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
+};

package/commands/kline.js

@@ -0,0 +1,34 @@
+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('kline <code>')
+        .description('获取A股股票、指数、板块的K线数据，支持股票代码、指数代码、板块代码。默认返回上证指数(000001)的K线，可指定K线条数(1-500，默认60)。返回开盘价、收盘价、最高价、最低价、成交量等K线数据，可用于技术分析和趋势判断。')
+        .action(async (code) => {
+            try {
+                const token = config.getToken();
+                if (!token) {
+                    const error = new Error('未配置 API Token');
+                    error.response = {status: 401};
+                    throw error;
+                }
+
+                if (!code) {
+                    throw createParameterError(
+                        '参数无效',
+                        ['参数 \'code\' 不能为空'],
+                        ['daxiapi kline 000001']
+                    );
+                }
+
+                const data = await api.getKline(token, code);
+                output(data);
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
+};

package/commands/market.js

@@ -0,0 +1,96 @@
+const config = require('../lib/config');
+const api = require('../lib/api');
+const {handleError} = require('../lib/error');
+const {output} = require('../lib/output');
+
+module.exports = function (program) {
+    const marketCmd = program.command('market');
+
+    marketCmd
+        .command('index')
+        .description(
+            '获取A股市场主流指数数据，包括上证指数、深证成指、沪深300、上证50、中证500、创业板指、科创50等指数的强度值和多日涨跌幅。可用于市场风格判断、趋势分析、强弱排名、板块轮动分析和投资决策辅助。'
+        )
+        .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.getMarketData(token);
+                output(data);
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
+
+    marketCmd
+        .command('temp')
+        .description(
+            '获取A股市场温度数据，包括估值温度、恐贪指数、趋势温度、动量温度等核心指标。可用于判断市场整体情绪、风险水平、趋势强度和动量状态，为投资决策提供参考。'
+        )
+        .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.getMarketTemp(token);
+                output(data);
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
+
+    marketCmd
+        .command('style')
+        .description(
+            '获取A股市场风格数据，计算中证500(小盘)与沪深300(大盘)的涨跌幅差值。当差值为正时表示小盘强于大盘，为负时表示大盘强于小盘，可用于判断市场风格偏向和风格轮动趋势。'
+        )
+        .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.getMarketStyle(token);
+                output(data);
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
+
+    marketCmd
+        .command('value')
+        .description(
+            '获取A股主要指数估值数据，包括市盈率(PE)、市净率(PB)、估值温度、PE百分位、PB百分位等核心估值指标。支持对红利类指数的特殊估值计算，可用于判断指数当前估值水平和投资价值。'
+        )
+        .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.getMarketValueData(token);
+                output(data);
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
+};

package/commands/search.js

@@ -0,0 +1,35 @@
+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('search <keyword>')
+        .description('搜索A股股票或板块，支持关键词模糊查询（股票名称、拼音缩写等）。支持两种搜索类型：stock(股票)和bk(板块)，默认搜索股票。从东方财富API获取数据，返回代码、名称、类型、拼音等信息，最多返回10条结果。可用于快速查找股票代码和板块信息。')
+        .option('-t, --type <type>', '搜索类型：stock（股票）或 bk（板块）', 'stock')
+        .action(async (keyword, options) => {
+            try {
+                const token = config.getToken();
+                if (!token) {
+                    const error = new Error('未配置 API Token');
+                    error.response = {status: 401};
+                    throw error;
+                }
+
+                if (!keyword) {
+                    throw createParameterError(
+                        '参数无效',
+                        ["参数 'keyword' 不能为空"],
+                        ['daxiapi search 平安', 'daxiapi search 锂电 --type bk']
+                    );
+                }
+
+                const data = await api.queryStockData(token, keyword, options.type);
+                output(data);
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
+};

package/commands/secid.js

@@ -0,0 +1,34 @@
+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('secid <code>')
+        .description('将各种股票代码格式转换为标准secid格式，支持以下格式：6位数字股票代码(000001)、sh/sz前缀(sh000001)、BK开头板块代码(BK0428)、纯数字板块代码(428)。返回标准secid格式，如1.600000(沪市)、0.000001(深市)、90.BK0428(板块)。可用于统一代码格式和K线数据查询。')
+        .action(async (code) => {
+            try {
+                const token = config.getToken();
+                if (!token) {
+                    const error = new Error('未配置 API Token');
+                    error.response = {status: 401};
+                    throw error;
+                }
+
+                if (!code) {
+                    throw createParameterError(
+                        '参数无效',
+                        ["参数 'code' 不能为空"],
+                        ['daxiapi secid 000001']
+                    );
+                }
+
+                const data = await api.getSecId(token, code);
+                output(data);
+            } catch (error) {
+                handleError(error);
+                process.exit(1);
+            }
+        });
+};