gangtise-openapi-cli 0.7.7 → 0.9.0

package/README.md

@@ -59,7 +59,9 @@ export GANGTISE_TOKEN="Bearer xxx"
 | | `foreign-report list` / `download` | 外资研报（含中文翻译下载） |
 | | `announcement list` / `download` | 公告（含 Markdown 下载） |
 | **Quote** | `day-kline` / `day-kline-hk` | A股/港股日K线 |
-| **Fundamental** | `income-statement` / `balance-sheet` / `cash-flow` | 三大财务报表 |
+| | `minute-kline` | A股分钟K线 |
+| **Fundamental** | `income-statement` / `balance-sheet` / `cash-flow` | 三大财务报表（累计） |
+| | `income-statement-quarterly` / `cash-flow-quarterly` | 利润表/现金流量表（单季度） |
 | | `main-business` | 主营构成（按地区/产品拆分） |
 | | `valuation-analysis` | 估值分析 |
 | **AI** | `knowledge-batch` | 知识库批量检索 |
@@ -70,7 +72,11 @@ export GANGTISE_TOKEN="Bearer xxx"
 | | `peer-comparison` | 同业对比 |
 | | `earnings-review` / `earnings-review-check` | 业绩回顾 |
 | | `theme-tracking` | 主题跟踪 |
+| | `hot-topic` | 热点话题 |
 | | `research-outline` | 研究提纲 |
+| | `management-discuss-announcement` | 管理层讨论-财报 |
+| | `management-discuss-earnings-call` | 管理层讨论-业绩会 |
+| | `viewpoint-debate` / `viewpoint-debate-check` | 观点PK（异步） |
 | **Vault** | `drive-list` / `drive-download` | 云盘文件列表与下载 |
 | **Raw** | `call` | 原始接口调用（可访问任意 endpoint） |
 
@@ -159,6 +165,7 @@ gangtise ai knowledge-batch --query 比亚迪 --query 最近热门概念
 - `insight announcement list`
 - `ai security-clue`
 - `vault drive-list`
+- `ai hot-topic`
 
 规则：
 - **有时间范围时**（传了 `--start-time/--end-time` 或 `--start-date/--end-date`）：**省略 `--size`**，CLI 自动翻页查全
@@ -224,6 +231,8 @@ gangtise quote day-kline --security 600519.SH --start-date 2026-03-01 --end-date
 gangtise quote day-kline --format json
 # 港股日K线
 gangtise quote day-kline-hk --security 00700.HK --start-date 2026-03-01 --end-date 2026-03-31
+# A股分钟K线
+gangtise quote minute-kline --security 600519.SH --start-time "2026-04-15 09:30:00" --end-time "2026-04-15 15:00:00" --field open --field close --field volume
 ```
 
 ### Fundamental
@@ -241,7 +250,13 @@ gangtise fundamental cash-flow --security-code 600519.SH --fiscal-year 2025 --pe
 # 最新一期完整现金流量表
 gangtise fundamental cash-flow --security-code 600519.SH --format json
 gangtise fundamental main-business --security-code 600519.SH --breakdown region
+# 多报告期：--period 可传多个值
+gangtise fundamental main-business --security-code 600519.SH --breakdown product --period annual --period interim
 gangtise fundamental valuation-analysis --security-code 600519.SH --indicator peTtm
+# 利润表（单季度）
+gangtise fundamental income-statement-quarterly --security-code 600519.SH --fiscal-year 2025 --period q2 --field netProfit
+# 现金流量表（单季度）
+gangtise fundamental cash-flow-quarterly --security-code 600519.SH --fiscal-year 2025 --period q2 --field netOpCashFlows
 ```
 
 ### AI
@@ -256,7 +271,20 @@ gangtise ai investment-logic --security-code 600519.SH
 gangtise ai peer-comparison --security-code 600519.SH
 gangtise ai earnings-review --security-code 600519.SH --period 2025q3
 gangtise ai theme-tracking --theme-id 121000131 --date 2026-03-01 --type morning
+gangtise ai hot-topic --start-date 2026-03-22 --end-date 2026-03-27 --category morningBriefing --category noonBriefing --with-related-securities --with-close-reading
+# 不传 --category 默认查全部类型（早报+午报+盘中快报+晚报），--with-related-securities 和 --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-earnings-call --report-date 2025-06-30 --security-code 000001.SZ --dimension financialPerformance
+# 观点PK（异步，返回 dataId）
+gangtise ai viewpoint-debate --viewpoint "飞天茅台的批价低点是1500元"
+# 等待生成完成后查询结果
+gangtise ai viewpoint-debate-check --data-id 202603310528
+# 也可以 --wait 同步等待结果（最长3分钟）
+gangtise ai viewpoint-debate --viewpoint "比亚迪股价将突破500元" --wait
 gangtise ai knowledge-resource-download --resource-type 60 --source-id 3052524 --output ./resource.txt
 ```
 

package/dist/src/cli.js

@@ -356,12 +356,20 @@ quote.command("day-kline-hk").option("--security <code>", "Security code (HK sto
     const client = await createClient();
     await printData(await client.call("quote.day-kline-hk", { securityList: maybeArray(options.security), startDate: options.startDate, endDate: options.endDate, limit: options.limit ? Number(options.limit) : undefined, fieldList: maybeArray(options.field) }), parseFormat(options.format), options.output);
 });
+quote.command("minute-kline").option("--security <code>", "Security code (A-share only: .SH/.SZ/.BJ)").option("--start-time <datetime>", "Start time (yyyy-MM-dd HH:mm:ss)").option("--end-time <datetime>", "End time (yyyy-MM-dd HH:mm:ss)").option("--limit <number>", "Max rows per request (default: 5000, max: 10000)").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("quote.minute-kline", { securityCode: options.security, startTime: options.startTime, endTime: options.endTime, limit: options.limit ? Number(options.limit) : undefined, fieldList: maybeArray(options.field) }), parseFormat(options.format), options.output);
+});
 program.addCommand(quote);
 const fundamental = new Command("fundamental").description("Fundamental APIs");
 fundamental.command("income-statement").requiredOption("--security-code <code>").option("--start-date <date>").option("--end-date <date>").option("--fiscal-year <year>", "Fiscal year", collectList, []).option("--period <period>", "Period", collectList, []).option("--report-type <type>", "Report type", 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.income-statement", { securityCode: options.securityCode, startDate: options.startDate, endDate: options.endDate, fiscalYear: maybeArray(options.fiscalYear), period: options.period.length ? options.period : undefined, reportType: options.reportType.length ? options.reportType : undefined, fieldList: maybeArray(options.field) }), parseFormat(options.format), options.output);
 });
+fundamental.command("income-statement-quarterly").requiredOption("--security-code <code>").option("--start-date <date>").option("--end-date <date>").option("--fiscal-year <year>", "Fiscal year", collectList, []).option("--period <period>", "Period: q1/q2/q3/q4/latest", collectList, []).option("--report-type <type>", "Report type", 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.income-statement-quarterly", { securityCode: options.securityCode, startDate: options.startDate, endDate: options.endDate, fiscalYear: maybeArray(options.fiscalYear), period: options.period.length ? options.period : undefined, reportType: options.reportType.length ? options.reportType : undefined, fieldList: maybeArray(options.field) }), parseFormat(options.format), options.output);
+});
 fundamental.command("balance-sheet").requiredOption("--security-code <code>").option("--start-date <date>").option("--end-date <date>").option("--fiscal-year <year>", "Fiscal year", collectList, []).option("--period <period>", "Period", collectList, []).option("--report-type <type>", "Report type", 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.balance-sheet", { securityCode: options.securityCode, startDate: options.startDate, endDate: options.endDate, fiscalYear: maybeArray(options.fiscalYear), period: options.period.length ? options.period : undefined, reportType: options.reportType.length ? options.reportType : undefined, fieldList: maybeArray(options.field) }), parseFormat(options.format), options.output);
@@ -370,6 +378,10 @@ fundamental.command("cash-flow").requiredOption("--security-code <code>").option
     const client = await createClient();
     await printData(await client.call("fundamental.cash-flow", { securityCode: options.securityCode, startDate: options.startDate, endDate: options.endDate, fiscalYear: maybeArray(options.fiscalYear), period: options.period.length ? options.period : undefined, reportType: options.reportType.length ? options.reportType : undefined, fieldList: maybeArray(options.field) }), parseFormat(options.format), options.output);
 });
+fundamental.command("cash-flow-quarterly").requiredOption("--security-code <code>").option("--start-date <date>").option("--end-date <date>").option("--fiscal-year <year>", "Fiscal year", collectList, []).option("--period <period>", "Period: q1/q2/q3/q4/latest", collectList, []).option("--report-type <type>", "Report type", 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.cash-flow-quarterly", { securityCode: options.securityCode, startDate: options.startDate, endDate: options.endDate, fiscalYear: maybeArray(options.fiscalYear), period: options.period.length ? options.period : undefined, reportType: options.reportType.length ? options.reportType : undefined, fieldList: maybeArray(options.field) }), parseFormat(options.format), options.output);
+});
 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) }), parseFormat(options.format), options.output);
@@ -467,6 +479,80 @@ ai.command("research-outline").requiredOption("--security-code <code>").option("
     const client = await createClient();
     await printData(await client.call("ai.research-outline", { securityCode: options.securityCode }), parseFormat(options.format), options.output);
 });
+ai.command("hot-topic").option("--from <number>", "Starting offset", "0").option("--size <number>", "Total rows to return; omit to fetch all").option("--start-date <date>", "Start date (yyyy-MM-dd)").option("--end-date <date>", "End date (yyyy-MM-dd)").option("--category <name>", "Report type: morningBriefing/noonBriefing/afternoonFlash/eveningBriefing", collectList, []).option("--with-related-securities", "Include related securities info", true).option("--with-close-reading", "Include close reading content", true).option("--format <format>", "Output format", "json").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    const ALL_CATEGORIES = ["morningBriefing", "noonBriefing", "afternoonFlash", "eveningBriefing"];
+    await printData(await client.call("ai.hot-topic", {
+        from: Number(options.from),
+        size: options.size === undefined ? undefined : Number(options.size),
+        startDate: options.startDate,
+        endDate: options.endDate,
+        categoryList: options.category.length > 0 ? options.category : ALL_CATEGORIES,
+        withRelatedSecurities: options.withRelatedSecurities || undefined,
+        withCloseReading: options.withCloseReading || undefined,
+    }), parseFormat(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) => {
+    const client = await createClient();
+    await printData(await client.call("ai.management-discuss-announcement", {
+        reportDate: options.reportDate,
+        securityCode: options.securityCode,
+        discussionDimension: options.dimension,
+    }), parseFormat(options.format), options.output);
+});
+ai.command("management-discuss-earnings-call").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) => {
+    const client = await createClient();
+    await printData(await client.call("ai.management-discuss-earnings-call", {
+        reportDate: options.reportDate,
+        securityCode: options.securityCode,
+        discussionDimension: options.dimension,
+    }), parseFormat(options.format), options.output);
+});
+ai.command("viewpoint-debate").requiredOption("--viewpoint <text>", "Viewpoint text (max 1000 chars)").option("--wait", "Wait for content generation (blocking, up to 3 min)").option("--format <format>", "Output format", "json").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    // Step 1: get dataId
+    const idResult = await client.call("ai.viewpoint-debate.get-id", { viewpoint: options.viewpoint });
+    const dataId = idResult?.dataId;
+    if (!dataId) {
+        process.stderr.write("Failed to get viewpoint debate ID.\n");
+        process.exitCode = 1;
+        return;
+    }
+    // Non-blocking: return dataId immediately
+    if (!options.wait) {
+        process.stderr.write(`Viewpoint debate task submitted. dataId: ${dataId}\n`);
+        process.stdout.write(`${JSON.stringify({ dataId, status: "pending", hint: `Run 'gangtise ai viewpoint-debate-check --data-id ${dataId}' in ~2 minutes to get results` })}\n`);
+        return;
+    }
+    // Blocking (--wait): poll for content
+    process.stderr.write(`Got dataId: ${dataId}, waiting for content generation...\n`);
+    let attempts = 0;
+    const maxAttempts = 12;
+    const delayMs = 15_000;
+    while (attempts < maxAttempts) {
+        attempts++;
+        const contentResult = await client.call("ai.viewpoint-debate.get-content", { dataId });
+        if (contentResult?.data?.content) {
+            await printData(contentResult.data, parseFormat(options.format), options.output);
+            return;
+        }
+        if (attempts < maxAttempts) {
+            process.stderr.write(`Attempt ${attempts}/${maxAttempts}: content not ready, retrying in 15s...\n`);
+            await new Promise(resolve => setTimeout(resolve, delayMs));
+        }
+    }
+    process.stderr.write(`Content not available after ${maxAttempts} attempts. Try again later with: gangtise ai viewpoint-debate-check --data-id ${dataId}\n`);
+    process.exitCode = 1;
+});
+ai.command("viewpoint-debate-check").requiredOption("--data-id <id>", "dataId from viewpoint-debate").option("--format <format>", "Output format", "json").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    const contentResult = await client.call("ai.viewpoint-debate.get-content", { dataId: options.dataId });
+    if (contentResult?.data?.content) {
+        await printData(contentResult.data, parseFormat(options.format), options.output);
+        return;
+    }
+    process.stdout.write(`${JSON.stringify({ dataId: options.dataId, status: "pending", hint: "Content not ready yet, retry in ~2 minutes" })}\n`);
+});
 const vault = new Command("vault").description("Vault APIs");
 vault.command("drive-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("--file-type <number>", "File type", collectNumberList, []).option("--space-type <number>", "Space type", collectNumberList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
     const client = await createClient();

package/dist/src/core/endpoints.js

@@ -282,6 +282,63 @@ export const ENDPOINTS = {
         kind: "json",
         description: "Get company research outline",
     },
+    aiHotTopic: {
+        key: "ai.hot-topic",
+        method: "POST",
+        path: "/application/open-ai/hot-topic/getList",
+        kind: "json",
+        description: "List hot topic reports",
+        pagination: { enabled: true, maxPageSize: 20 },
+    },
+    aiManagementDiscussAnnouncement: {
+        key: "ai.management-discuss-announcement",
+        method: "POST",
+        path: "/application/open-ai/management-discuss/from-announcement",
+        kind: "json",
+        description: "Management discussion from financial reports (half-year/annual)",
+    },
+    aiManagementDiscussEarningsCall: {
+        key: "ai.management-discuss-earnings-call",
+        method: "POST",
+        path: "/application/open-ai/management-discuss/from-earningsCall",
+        kind: "json",
+        description: "Management discussion from earnings calls",
+    },
+    aiViewpointDebateGetId: {
+        key: "ai.viewpoint-debate.get-id",
+        method: "POST",
+        path: "/application/open-ai/agent/viewpoint-debate-getid",
+        kind: "json",
+        description: "Get viewpoint debate ID",
+    },
+    aiViewpointDebateGetContent: {
+        key: "ai.viewpoint-debate.get-content",
+        method: "POST",
+        path: "/application/open-ai/agent/viewpoint-debate-getcontent",
+        kind: "json",
+        description: "Get viewpoint debate content",
+    },
+    quoteMinuteKline: {
+        key: "quote.minute-kline",
+        method: "POST",
+        path: "/application/open-quote/kline/minute",
+        kind: "json",
+        description: "Query A-share minute kline (SH/SZ/BJ)",
+    },
+    fundamentalIncomeStatementQuarterly: {
+        key: "fundamental.income-statement-quarterly",
+        method: "POST",
+        path: "/application/open-fundamental/financial-report/income-statement/quarterly",
+        kind: "json",
+        description: "Query income statement (quarterly)",
+    },
+    fundamentalCashFlowQuarterly: {
+        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)",
+    },
     vaultDriveList: {
         key: "vault.drive.list",
         method: "POST",

package/dist/src/version.js

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

package/package.json

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