gangtise-openapi-cli 0.12.0 → 0.13.1

package/README.md

@@ -4,6 +4,20 @@
 
 ## Changelog
 
+### v0.13.0 — 2026-05-15
+
+**新增接口**
+- `fundamental income-statement-hk / balance-sheet-hk / cash-flow-hk` — 港股三大报表（中国会计准则）
+- `alternative edb-search` — 行业指标列表搜索（按关键词匹配指标名称，返回 indicatorId 等元信息）
+- `alternative edb-data` — 行业指标时序数据（批量按 indicatorId 拉取时间序列，最多 10 个指标）
+- `vault stock-pool-list` — 查询用户自选股股票池列表（poolId / poolName）
+- `vault stock-pool-stocks` — 查询股票池证券明细（支持 `--pool-id all` 全量查询）
+
+**接口变更**
+- `fundamental income-statement / balance-sheet / cash-flow / income-statement-quarterly / cash-flow-quarterly` 名称调整为 A股报表（路径不变）
+- `ai management-discuss-announcement` `--dimension` 新增 `all` 选项，返回报告中完整的管理层讨论内容（内容可能较长）
+- `vault wechat-message-list` 新增 `--security <code>` 参数（按证券代码过滤），返回结果增加 `securityList` 字段
+
 ### v0.12.0 — 2026-05-10
 
 **性能 / 架构**
@@ -111,10 +125,20 @@ Skill 目录结构：
 
 ```
 gangtise-openapi/
-├── SKILL.md                    # 主 skill 文件（命令参考、参数枚举、使用规则）
+├── SKILL.md                          # 主 skill 文件（必备规则、速查表、按需引用 references）
 └── references/
-    ├── fields.md               # 字段中英文对照速查表
-    └── lookup-ids.md           # 常用 ID 速查表（行业/券商/机构/公告分类等）
+    ├── commands/                     # 按命令组拆分的详细参数文档（agent 按需 Read）
+    │   ├── ai.md                     #   AI 能力命令（one-pager / earnings-review / viewpoint-debate 等）
+    │   ├── alternative.md            #   行业指标数据库（EDB search / EDB data）
+    │   ├── fundamental.md            #   财务数据命令（A股/港股三大报表 / 估值 / 盈利预测 / 股东）
+    │   ├── insight.md                #   投研内容命令（研报 / 观点 / 纪要 / 公告 / 外资）
+    │   ├── quote.md                  #   行情命令（A股/港股/指数 K 线）
+    │   ├── reference-and-lookup.md   #   GTS Code 搜索与枚举速查
+    │   └── vault.md                  #   云盘/录音/会议/群消息/股票池
+    ├── examples.md                   # 典型场景的端到端示例
+    ├── fields.md                     # K线/财务字段中英文对照速查表
+    ├── lookup-ids.md                 # 常用 ID 速查表（行业/券商/机构/公告分类等）
+    └── response-schema.md            # 各接口响应字段说明
 ```
 
 安装：
@@ -166,8 +190,9 @@ cp -r gangtise-openapi ~/.hermes/skills/gangtise-openapi
 | **Quote** | `day-kline` / `day-kline-hk` | A股/港股日K线 |
 | | `index-day-kline` | 沪深京指数日K线 |
 | | `minute-kline` | A股分钟K线 |
-| **Fundamental** | `income-statement` / `balance-sheet` / `cash-flow` | 三大财务报表（累计） |
-| | `income-statement-quarterly` / `cash-flow-quarterly` | 利润表/现金流量表（单季度） |
+| **Fundamental** | `income-statement` / `balance-sheet` / `cash-flow` | A股三大财务报表（累计） |
+| | `income-statement-quarterly` / `cash-flow-quarterly` | A股利润表/现金流量表（单季度） |
+| | `income-statement-hk` / `balance-sheet-hk` / `cash-flow-hk` | 港股三大财务报表（中国会计准则） |
 | | `main-business` | 主营构成（按地区/产品拆分） |
 | | `valuation-analysis` | 估值分析 |
 | | `earning-forecast` | 盈利预测（一致预期） |
@@ -189,6 +214,9 @@ cp -r gangtise-openapi ~/.hermes/skills/gangtise-openapi
 | | `record-list` / `record-download` | 录音速记列表与下载 |
 | | `my-conference-list` / `my-conference-download` | 我的会议列表与下载 |
 | | `wechat-message-list` / `wechat-chatroom-list` | 群消息列表与群ID查询 |
+| | `stock-pool-list` / `stock-pool-stocks` | 自选股股票池列表与证券明细 |
+| **Alternative** | `edb-search` | 行业指标搜索（按关键词匹配，返回 indicatorId 等元信息） |
+| | `edb-data` | 行业指标时序数据（批量拉取，最多10个指标） |
 | **Raw** | `call` | 原始接口调用（可访问任意 endpoint） |
 
 ## 命令概览
@@ -200,6 +228,7 @@ cp -r gangtise-openapi ~/.hermes/skills/gangtise-openapi
 - `gangtise fundamental ...`
 - `gangtise ai ...`
 - `gangtise vault ...`
+- `gangtise alternative ...`
 - `gangtise reference ...`
 - `gangtise raw call ...`
 
@@ -390,6 +419,14 @@ gangtise fundamental cash-flow-quarterly --security-code 600519.SH --fiscal-year
 gangtise fundamental top-holders --security-code 600519.SH --holder-type top10 --fiscal-year 2025 --format json
 # 前十大流通股东（按日期范围）
 gangtise fundamental top-holders --security-code 600519.SH --holder-type top10Float --start-date 2025-01-01 --end-date 2025-12-31 --period q3 --format json
+
+# 港股三大报表（中国会计准则，--security-code 用港股代码）
+gangtise fundamental income-statement-hk --security-code 09992.HK --fiscal-year 2025 --period annual --field netProfit --field basicEPS
+gangtise fundamental income-statement-hk --security-code 09992.HK --fiscal-year 2023 --fiscal-year 2024 --fiscal-year 2025 --period annual --field netProfit
+gangtise fundamental balance-sheet-hk --security-code 09992.HK --fiscal-year 2025 --period h1 --field totalCurrAssets --field totalNonCurrAssets --field totalCurrLiab --field totalNonCurrLiab
+gangtise fundamental cash-flow-hk --security-code 09992.HK --fiscal-year 2025 --period annual --field netOpCashFlows --field netInvCashFlows --field netFinCashFlows
+# 最新一期完整港股利润表
+gangtise fundamental income-statement-hk --security-code 09992.HK --format json
 ```
 
 ### AI
@@ -408,8 +445,11 @@ gangtise ai hot-topic --start-date 2026-03-22 --end-date 2026-03-27 --category m
 # 不传 --category 默认查全部类型（早报+午报+盘中快报+晚报），--with-related-securities 和 --with-close-reading 默认开启，可用 --no-with-related-securities / --no-with-close-reading 关闭
 gangtise ai hot-topic --start-date 2026-04-15 --end-date 2026-04-17
 gangtise ai research-outline --security-code 600519.SH
-# 管理层讨论-财报
+# 管理层讨论-财报（三个细分维度）
 gangtise ai management-discuss-announcement --report-date 2025-06-30 --security-code 000001.SZ --dimension businessOperation
+gangtise ai management-discuss-announcement --report-date 2025-12-31 --security-code 000001.SZ --dimension financialPerformance
+# 传入 all 返回完整管理层讨论内容（内容较长，谨慎使用）
+gangtise ai management-discuss-announcement --report-date 2025-12-31 --security-code 000001.SZ --dimension all
 # 管理层讨论-业绩会
 gangtise ai management-discuss-earnings-call --report-date 2025-06-30 --security-code 000001.SZ --dimension financialPerformance
 # 观点PK（异步，返回 dataId）
@@ -443,6 +483,39 @@ gangtise vault my-conference-download --conference-id 43319 --content-type asr
 # 群消息：先按群名称查群ID，再按群ID查消息
 gangtise vault wechat-chatroom-list --room-name "AI学习群,投研分享群" --size 50
 gangtise vault wechat-message-list --keyword AI应用 --wechat-group-id ueKEGyhdjFGkjyebh --category text --category url --tag roadShow --tag meetingSummary --size 50
+# 按证券代码过滤群消息
+gangtise vault wechat-message-list --security 000001.SZ --security 300750.SZ --size 50
+
+# 自选股股票池
+gangtise vault stock-pool-list
+# 查询指定股票池中的证券
+gangtise vault stock-pool-stocks --pool-id 808477293
+# 查询所有股票池中的全量证券（默认行为）
+gangtise vault stock-pool-stocks
+```
+
+### Alternative（行业指标数据库 EDB）
+
+```bash
+# Step 1：按关键词搜索指标，获取 indicatorId
+gangtise alternative edb-search --keyword 空调 --limit 50 --format table
+gangtise alternative edb-search --keyword "海尔销量"
+
+# Step 2：按 indicatorId 拉取时间序列数据（最多10个指标）
+gangtise alternative edb-data \
+  --indicator-id S14001618 \
+  --indicator-id S14001620 \
+  --start-date 2024-01-01 \
+  --end-date 2024-12-31 \
+  --format table
+
+# 导出为 CSV
+gangtise alternative edb-data \
+  --indicator-id S14001618 \
+  --start-date 2023-01-01 \
+  --end-date 2024-12-31 \
+  --format csv \
+  --output ./indicator.csv
 ```
 
 ### Raw

package/dist/src/cli.js

@@ -303,6 +303,9 @@ addFinancialReport("income-statement-quarterly", "fundamental.income-statement-q
 addFinancialReport("balance-sheet", "fundamental.balance-sheet");
 addFinancialReport("cash-flow", "fundamental.cash-flow");
 addFinancialReport("cash-flow-quarterly", "fundamental.cash-flow-quarterly", "Period: q1/q2/q3/q4/latest");
+addFinancialReport("income-statement-hk", "fundamental.income-statement-hk", "Period: q1/h1/q3/h2/nsd/annual/latest");
+addFinancialReport("balance-sheet-hk", "fundamental.balance-sheet-hk", "Period: q1/h1/q3/h2/nsd/annual/latest");
+addFinancialReport("cash-flow-hk", "fundamental.cash-flow-hk", "Period: q1/h1/q3/h2/nsd/annual/latest");
 fundamental.command("main-business").requiredOption("--security-code <code>").option("--start-date <date>").option("--end-date <date>").addOption(new Option("--breakdown <type>", "Breakdown: product/industry/region").choices(["product", "industry", "region"]).default("product")).option("--period <type>", "Period: interim/annual", collectList, []).option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
     const client = await createClient();
     await printData(await client.call("fundamental.main-business", { securityCode: options.securityCode, startDate: options.startDate, endDate: options.endDate, breakdown: options.breakdown, periodList: maybeArray(options.period), fieldList: maybeArray(options.field) }), parseOutputFormat(options.format), options.output);
@@ -412,7 +415,7 @@ ai.command("hot-topic").option("--from <number>", "Starting offset", "0").option
         withCloseReading: options.withCloseReading === false ? undefined : true,
     }), parseOutputFormat(options.format), options.output);
 });
-ai.command("management-discuss-announcement").requiredOption("--report-date <date>", "Report date (yyyy-MM-dd, e.g. 2025-06-30)").requiredOption("--security-code <code>", "Security code (e.g. 000001.SZ)").addOption(new Option("--dimension <name>", "Discussion dimension").choices(["businessOperation", "financialPerformance", "developmentAndRisk"]).makeOptionMandatory()).option("--format <format>", "Output format", "json").option("--output <path>").action(async (options) => {
+ai.command("management-discuss-announcement").requiredOption("--report-date <date>", "Report date (yyyy-MM-dd, e.g. 2025-06-30)").requiredOption("--security-code <code>", "Security code (e.g. 000001.SZ)").addOption(new Option("--dimension <name>", "Discussion dimension: businessOperation/financialPerformance/developmentAndRisk/all").choices(["businessOperation", "financialPerformance", "developmentAndRisk", "all"]).makeOptionMandatory()).option("--format <format>", "Output format", "json").option("--output <path>").action(async (options) => {
     const client = await createClient();
     await printData(await client.call("ai.management-discuss-announcement", {
         reportDate: options.reportDate,
@@ -499,7 +502,7 @@ vault.command("my-conference-download").requiredOption("--conference-id <id>").r
         resolveOutputPath: (result) => resolveTitle(client, result, "vault.my-conference.list", "conferenceId", options.conferenceId),
     });
 });
-vault.command("wechat-message-list").option("--from <number>", "Starting offset", "0").option("--size <number>", "Total rows to return; omit to fetch all").option("--start-time <datetime>").option("--end-time <datetime>").option("--keyword <text>").option("--wechat-group-id <id>", "WeChat group ID", collectList, []).option("--industry <id>", "Industry ID", collectList, []).option("--category <name>", "Message type: text/image/documents/url", collectList, []).option("--tag <name>", "Tag: roadShow/research/strategyMeeting/meetingSummary/industryComment/companyComment/earningsReview", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
+vault.command("wechat-message-list").option("--from <number>", "Starting offset", "0").option("--size <number>", "Total rows to return; omit to fetch all").option("--start-time <datetime>").option("--end-time <datetime>").option("--keyword <text>").option("--security <code>", "Security code (e.g. 000001.SZ)", collectList, []).option("--wechat-group-id <id>", "WeChat group ID", collectList, []).option("--industry <id>", "Industry ID", collectList, []).option("--category <name>", "Message type: text/image/documents/url", collectList, []).option("--tag <name>", "Tag: roadShow/research/strategyMeeting/meetingSummary/industryComment/companyComment/earningsReview", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
     const client = await createClient();
     await printData(await client.call("vault.wechat-message.list", buildWechatMessageListBody(options)), parseOutputFormat(options.format), options.output);
 });
@@ -507,8 +510,42 @@ vault.command("wechat-chatroom-list").option("--from <number>", "Starting offset
     const client = await createClient();
     await printData(await client.call("vault.wechat-chatroom.list", buildWechatChatroomListBody(options)), parseOutputFormat(options.format), options.output);
 });
+vault.command("stock-pool-list").option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    await printData(await client.call("vault.stock-pool.list", {}), parseOutputFormat(options.format), options.output);
+});
+vault.command("stock-pool-stocks").option("--pool-id <id>", "Pool ID; repeat for multiple; use 'all' for all pools", collectList, ["all"]).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    await printData(await client.call("vault.stock-pool.stocks", { poolIdList: options.poolId }), parseOutputFormat(options.format), options.output);
+});
 program.addCommand(vault);
 program.addCommand(ai);
+const alternative = new Command("alternative").description("Alternative data APIs");
+alternative.command("edb-search").requiredOption("--keyword <text>", "Search keyword (e.g. '空调')").option("--limit <number>", "Max results (default: 100, max: 200)", "100").option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    await printData(await client.call("alternative.edb-search", {
+        keyword: options.keyword,
+        limit: parseNumberOption(options.limit, "--limit", { integer: true, min: 1 }),
+    }), parseOutputFormat(options.format), options.output);
+});
+alternative.command("edb-data").option("--indicator-id <id>", "Indicator ID (repeat, max 10)", collectList, []).requiredOption("--start-date <date>", "Start date (yyyy-MM-dd)").requiredOption("--end-date <date>", "End date (yyyy-MM-dd)").option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    const raw = await client.call("alternative.edb-data", {
+        indicatorIdList: options.indicatorId,
+        startDate: options.startDate,
+        endDate: options.endDate,
+    });
+    let data = raw;
+    if (raw && Array.isArray(raw.fieldList) && Array.isArray(raw.dataList)) {
+        const list = raw.dataList.map((row) => raw.fieldList.reduce((acc, field, i) => {
+            acc[field] = row[i];
+            return acc;
+        }, {}));
+        data = { list, total: list.length };
+    }
+    await printData(data, parseOutputFormat(options.format), options.output);
+});
+program.addCommand(alternative);
 program.command("raw").description("Raw API calls").addCommand(new Command("call").argument("<endpointKey>").option("--body <json>").option("--query <key=value>", "Query string pair", collectKeyValue, {}).option("--format <format>", "Output format", "json").option("--output <path>").action(async (endpointKey, options) => {
     const endpoint = ENDPOINTS[endpointKey];
     if (!endpoint) {

package/dist/src/core/commandBodies.js

@@ -15,6 +15,7 @@ export function buildWechatMessageListBody(options) {
         startTime: options.startTime,
         endTime: options.endTime,
         keyword: options.keyword,
+        securityList: maybeArray(options.security),
         wechatGroupIdList: maybeArray(options.wechatGroupId),
         industryIdList: maybeArray(options.industry),
         categoryList: maybeArray(options.category),

package/dist/src/core/endpoints.js

@@ -246,35 +246,56 @@ export const ENDPOINTS = {
         method: "POST",
         path: "/application/open-fundamental/financial-report/income-statement/accumulated",
         kind: "json",
-        description: "Query income statement (accumulated)",
+        description: "Query A-share income statement (accumulated)",
     },
     "fundamental.income-statement-quarterly": {
         key: "fundamental.income-statement-quarterly",
         method: "POST",
         path: "/application/open-fundamental/financial-report/income-statement/quarterly",
         kind: "json",
-        description: "Query income statement (quarterly)",
+        description: "Query A-share income statement (quarterly)",
     },
     "fundamental.balance-sheet": {
         key: "fundamental.balance-sheet",
         method: "POST",
         path: "/application/open-fundamental/financial-report/balance-sheet/accumulated",
         kind: "json",
-        description: "Query balance sheet (accumulated)",
+        description: "Query A-share balance sheet (accumulated)",
     },
     "fundamental.cash-flow": {
         key: "fundamental.cash-flow",
         method: "POST",
         path: "/application/open-fundamental/financial-report/cash-flow-statement/accumulated",
         kind: "json",
-        description: "Query cash flow statement (accumulated)",
+        description: "Query A-share cash flow statement (accumulated)",
     },
     "fundamental.cash-flow-quarterly": {
         key: "fundamental.cash-flow-quarterly",
         method: "POST",
         path: "/application/open-fundamental/financial-report/cash-flow-statement/quarterly",
         kind: "json",
-        description: "Query cash flow statement (quarterly)",
+        description: "Query A-share cash flow statement (quarterly)",
+    },
+    "fundamental.income-statement-hk": {
+        key: "fundamental.income-statement-hk",
+        method: "POST",
+        path: "/application/open-fundamental/financial-report/income-statement/hk",
+        kind: "json",
+        description: "Query HK income statement (China GAAP)",
+    },
+    "fundamental.balance-sheet-hk": {
+        key: "fundamental.balance-sheet-hk",
+        method: "POST",
+        path: "/application/open-fundamental/financial-report/balance-sheet/hk",
+        kind: "json",
+        description: "Query HK balance sheet (China GAAP)",
+    },
+    "fundamental.cash-flow-hk": {
+        key: "fundamental.cash-flow-hk",
+        method: "POST",
+        path: "/application/open-fundamental/financial-report/cash-flow-statement/hk",
+        kind: "json",
+        description: "Query HK cash flow statement (China GAAP)",
     },
     "fundamental.main-business": {
         key: "fundamental.main-business",
@@ -473,4 +494,33 @@ export const ENDPOINTS = {
         kind: "json",
         description: "List WeChat group chatroom IDs",
     },
+    "vault.stock-pool.list": {
+        key: "vault.stock-pool.list",
+        method: "POST",
+        path: "/application/open-vault/stock-pool/getPoolList",
+        kind: "json",
+        description: "List user stock pool IDs and names",
+    },
+    "vault.stock-pool.stocks": {
+        key: "vault.stock-pool.stocks",
+        method: "POST",
+        path: "/application/open-vault/stock-pool/getStockList",
+        kind: "json",
+        description: "List securities in stock pool(s)",
+    },
+    // ─── alternative ───
+    "alternative.edb-search": {
+        key: "alternative.edb-search",
+        method: "POST",
+        path: "/application/open-alternative/EDB/search",
+        kind: "json",
+        description: "Search industry indicator list by keyword",
+    },
+    "alternative.edb-data": {
+        key: "alternative.edb-data",
+        method: "POST",
+        path: "/application/open-alternative/EDB/getData",
+        kind: "json",
+        description: "Get industry indicator time-series data by indicator ID list",
+    },
 };

package/dist/src/version.js

@@ -1,2 +1,2 @@
 // Auto-generated — DO NOT EDIT
-export const CLI_VERSION = "0.12.0";
+export const CLI_VERSION = "0.13.1";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gangtise-openapi-cli",
-  "version": "0.12.0",
+  "version": "0.13.1",
   "description": "CLI for Gangtise OpenAPI",
   "license": "MIT",
   "repository": {