gangtise-openapi-cli 0.5.0 → 0.6.0

package/README.md

@@ -57,6 +57,8 @@ gangtise lookup research-area list
 gangtise lookup broker-org list
 gangtise lookup meeting-org list
 gangtise lookup industry list
+gangtise lookup region list              # 外资研报区域
+gangtise lookup announcement-category list  # 公告分类
 gangtise lookup industry-code list   # 申万行业代码（用于 security-clue --gts-code）
 ```
 
@@ -85,10 +87,9 @@ gangtise ai knowledge-batch --query 比亚迪 --query 最近热门概念
 - `ai cloud-disk-list`
 
 规则：
-- `--from` 表示起始偏移量
-- `--size` 表示最终最多返回多少条记录
-- 如果未传 `--size`，CLI 会根据返回里的 `total` 自动翻页，把从 `from` 开始的全部数据查全
-- 如果传了 `--size`，即使超过接口单次上限，CLI 也会自动翻页，直到累计记录数达到 `size` 或数据取完
+- **有时间范围时**（传了 `--start-time/--end-time` 或 `--start-date/--end-date`）：**省略 `--size`**，CLI 自动翻页查全
+- **无时间范围时**（未传时间参数）：默认 `--size 200`，防止一次查询数据量过大
+- 如果显式传了 `--size`，则按指定值翻页，直到达到 `size` 或数据取完
 
 ## 智能文件命名
 
@@ -112,11 +113,14 @@ gangtise auth status
 ### Insight
 
 ```bash
-# 只取前 120 条，CLI 内部自动翻页
-gangtise insight research list --start-time "2026-04-04 00:00:00" --end-time "2026-04-04 23:59:59" --size 120
+# 有时间范围 → 省略 --size，自动查全
+gangtise insight research list --start-time "2026-04-01 00:00:00" --end-time "2026-04-09 23:59:59"
 
-# 不传 size，自动查全
-gangtise insight research list --start-time "2026-04-04 00:00:00" --end-time "2026-04-04 23:59:59"
+# 无时间范围 → 默认 --size 200
+gangtise insight research list --industry 104270000 --category company --llm-tag inDepth --rating buy
+
+# 多值 List 模式：一次查多家券商 + 多个行业 + 多个评级
+gangtise insight research list --broker C100000027 --broker C100000014 --industry 104340000 --industry 104370000 --rating buy --rating overweight --format json
 
 gangtise insight opinion list --keyword AI
 gangtise insight summary list --keyword 算力
@@ -125,8 +129,12 @@ gangtise insight summary list --keyword 算力
 gangtise insight summary download --summary-id 4902586
 # → 超颖电子：2026年4月7日投资者关系活动记录表.txt
 
-gangtise insight research download --report-id 432092410345574400
-# → 建筑材料行业投资策略周报：战争对预期的影响仍大 中长期关注传统建材底部机会.pdf
+# 下载 Markdown 版本
+gangtise insight research download --report-id 432092410345574400 --file-type 2
+# 下载外资研报中文翻译版
+gangtise insight foreign-report download --report-id RPT20260401001 --file-type 4
+# 下载公告 Markdown 版本
+gangtise insight announcement download --announcement-id 123456 --file-type 2
 
 # 也可手动指定文件名
 gangtise insight research download --report-id 12345 --output ./report.pdf
@@ -144,7 +152,17 @@ gangtise quote day-kline --security 600519.SH --start-date 2026-03-01 --end-date
 
 ```bash
 gangtise fundamental income-statement --security-code 600519.SH --fiscal-year 2025 --period q3 --field netProfit
-gangtise fundamental main-business --security-code 600519.SH
+# 多年度：同时查2023-2025年报净利润
+gangtise fundamental income-statement --security-code 600519.SH --fiscal-year 2023 --fiscal-year 2024 --fiscal-year 2025 --period annual --field netProfit
+# 最新一期完整利润表
+gangtise fundamental income-statement --security-code 600519.SH --format json
+gangtise fundamental balance-sheet --security-code 600519.SH --fiscal-year 2025 --period q3 --field totalCurrAssets --field totalCurrLiab
+# 最新一期完整资产负债表
+gangtise fundamental balance-sheet --security-code 600519.SH --format json
+gangtise fundamental cash-flow --security-code 600519.SH --fiscal-year 2025 --period q3 --field netOpCashFlows --field netInvCashFlows --field netFinCashFlows
+# 最新一期完整现金流量表
+gangtise fundamental cash-flow --security-code 600519.SH --format json
+gangtise fundamental main-business --security-code 600519.SH --breakdown region
 gangtise fundamental valuation-analysis --security-code 600519.SH --indicator peTtm
 ```
 
@@ -152,12 +170,16 @@ gangtise fundamental valuation-analysis --security-code 600519.SH --indicator pe
 
 ```bash
 gangtise ai knowledge-batch --query 比亚迪 --query 最近热门概念
-gangtise ai security-clue --start-time "2026-03-01 00:00:00" --end-time "2026-03-23 23:59:59" --query-mode bySecurity --gts-code 000001.SZ --size 800
-gangtise ai security-clue --start-time "2026-04-01 00:00:00" --end-time "2026-04-07 23:59:59" --query-mode byIndustry --gts-code 821055.SWI
+# 多 resource-type：同时搜索券商研报和外资研报
+gangtise ai knowledge-batch --query 新能源汽车 --resource-type 10 --resource-type 11 --top 10
+gangtise ai security-clue --start-time "2026-04-01 00:00:00" --end-time "2026-04-09 23:59:59" --query-mode byIndustry --gts-code 821035.SWI --source researchReport --source announcement
 gangtise ai one-pager --security-code 600519.SH
 gangtise ai investment-logic --security-code 600519.SH
 gangtise ai peer-comparison --security-code 600519.SH
-gangtise ai cloud-disk-list --keyword 部门文档
+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 research-outline --security-code 600519.SH
+gangtise ai cloud-disk-list --keyword 部门文档 --space-type 1 --file-type 1
 
 # 云盘下载：自动使用文件标题命名
 gangtise ai cloud-disk-download --file-id 62130
@@ -178,12 +200,12 @@ gangtise raw call insight.opinion.list --body '{"from":0,"size":120}'
 ## 已验证的真实联调
 
 已真实跑通：
-- auth: `login`
-- lookup: `research-area list` / `broker-org list` / `meeting-org list` / `industry list` / `industry-code list`
+- auth: `login` / `status`
+- lookup: `research-area list` / `broker-org list` / `meeting-org list` / `industry list` / `industry-code list` / `region list` / `announcement-category list`
 - insight: `opinion list` / `summary list` / `summary download` / `roadshow list` / `site-visit list` / `strategy list` / `forum list` / `research list` / `research download` / `foreign-report list` / `foreign-report download` / `announcement list` / `announcement download`
 - quote: `day-kline`
 - fundamental: `income-statement` / `main-business` / `valuation-analysis`
-- ai: `knowledge-batch` / `knowledge-resource-download` / `security-clue` / `cloud-disk-list` / `cloud-disk-download` / `one-pager` / `investment-logic` / `peer-comparison`
+- ai: `knowledge-batch` / `knowledge-resource-download` / `security-clue` / `cloud-disk-list` / `cloud-disk-download` / `one-pager` / `investment-logic` / `peer-comparison` / `earnings-review` / `theme-tracking` / `research-outline`
 
 注意：`knowledge-resource-download` 依赖正确的 `resourceType + sourceId` 组合；错误组合会返回 `433007 不支持该数据源`。
 

package/dist/src/cli.js

@@ -1,15 +1,25 @@
 #!/usr/bin/env node
 import { Command, Option } from "commander";
-import fs from "node:fs/promises";
-import os from "node:os";
-import path, { extname } from "node:path";
 import { collectKeyValue, collectList, collectNumberList, maybeArray, toTimestamp13 } from "./core/args.js";
-import { readTokenCache } from "./core/auth.js";
-import { GangtiseClient } from "./core/client.js";
 import { loadConfig } from "./core/config.js";
 import { ApiError, ConfigError, DownloadError } from "./core/errors.js";
-import { renderOutput, saveOutputIfNeeded } from "./core/output.js";
-import { normalizeRows } from "./core/normalize.js";
+// --- Lazy-loaded modules (deferred to action handlers) ---
+async function createClient() {
+    const { GangtiseClient } = await import("./core/client.js");
+    return new GangtiseClient(loadConfig());
+}
+async function readTokenCache(...args) {
+    return (await import("./core/auth.js")).readTokenCache(...args);
+}
+async function normalizeRows(...args) {
+    return (await import("./core/normalize.js")).normalizeRows(...args);
+}
+async function renderOutput(...args) {
+    return (await import("./core/output.js")).renderOutput(...args);
+}
+async function saveOutputIfNeeded(...args) {
+    return (await import("./core/output.js")).saveOutputIfNeeded(...args);
+}
 function parseFormat(value) {
     const format = value ?? "table";
     if (["table", "json", "jsonl", "csv", "markdown"].includes(format)) {
@@ -18,21 +28,32 @@ function parseFormat(value) {
     throw new ConfigError(`Unsupported format: ${format}`);
 }
 // --- Title cache: list writes, download reads ---
-const TITLE_CACHE_PATH = path.join(os.homedir(), ".config", "gangtise", "title-cache.json");
+let _titleCachePath;
+function getTitleCachePath() {
+    if (!_titleCachePath) {
+        const path = require("node:path");
+        const os = require("node:os");
+        _titleCachePath = path.join(os.homedir(), ".config", "gangtise", "title-cache.json");
+    }
+    return _titleCachePath;
+}
 const TITLE_CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24h
 async function readTitleCache() {
     try {
-        return JSON.parse(await fs.readFile(TITLE_CACHE_PATH, "utf8"));
+        const fs = await import("node:fs/promises");
+        return JSON.parse(await fs.readFile(getTitleCachePath(), "utf8"));
     }
     catch {
         return {};
     }
 }
 async function writeTitleCache(endpoint, titles) {
+    const fs = await import("node:fs/promises");
+    const path = await import("node:path");
     const data = await readTitleCache();
     data[endpoint] = { titles, ts: Date.now() };
-    await fs.mkdir(path.dirname(TITLE_CACHE_PATH), { recursive: true });
-    await fs.writeFile(TITLE_CACHE_PATH, JSON.stringify(data), "utf8");
+    await fs.mkdir(path.dirname(getTitleCachePath()), { recursive: true });
+    await fs.writeFile(getTitleCachePath(), JSON.stringify(data), "utf8");
 }
 function lookupTitleCache(data, endpoint, id) {
     const entry = data[endpoint];
@@ -41,7 +62,7 @@ function lookupTitleCache(data, endpoint, id) {
     return entry.titles[id];
 }
 async function printData(data, format, output, cache) {
-    const normalized = normalizeRows(data);
+    const normalized = await normalizeRows(data);
     // Populate title cache from list results
     if (cache && Array.isArray(normalized)) {
         const titleField = cache.titleField ?? "title";
@@ -58,7 +79,7 @@ async function printData(data, format, output, cache) {
         if (Object.keys(titles).length > 0)
             writeTitleCache(cache.endpointKey, titles).catch(() => { });
     }
-    const content = renderOutput(normalized, format);
+    const content = await renderOutput(normalized, format);
     if (output) {
         await saveOutputIfNeeded(content, output);
         process.stdout.write(`${output}\n`);
@@ -100,6 +121,7 @@ function extFromContentType(contentType) {
 }
 /** Resolve a human-readable filename by looking up the title from cache or list endpoint. */
 async function resolveTitle(client, result, listEndpoint, idField, idValue, titleField = "title") {
+    const { extname } = await import("node:path");
     const file = result;
     const serverExt = file.filename ? extname(file.filename) : extFromContentType(file.contentType);
     function buildFilename(rawTitle) {
@@ -166,30 +188,15 @@ function addTimeFilters(command) {
         .option("--keyword <keyword>", "Keyword");
 }
 const program = new Command();
-import { createRequire } from "node:module";
-import { fileURLToPath } from "node:url";
-function loadPackageVersion() {
-    const __dirname = path.dirname(fileURLToPath(import.meta.url));
-    const req = createRequire(import.meta.url);
-    // Works from both src/ (dev) and dist/src/ (built)
-    try {
-        return req(path.resolve(__dirname, "../package.json")).version;
-    }
-    catch { }
-    try {
-        return req(path.resolve(__dirname, "../../package.json")).version;
-    }
-    catch { }
-    return "0.0.0";
-}
-program.name("gangtise").description("Gangtise OpenAPI CLI").version(loadPackageVersion());
+const CLI_VERSION = "0.6.0";
+program.name("gangtise").description("Gangtise OpenAPI CLI").version(CLI_VERSION);
 program
     .command("auth")
     .description("Authentication commands")
     .addCommand(new Command("login")
     .option("--format <format>", "Output format", "json")
     .action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.login(), parseFormat(options.format));
 }))
     .addCommand(new Command("status")
@@ -202,64 +209,36 @@ program
 const lookup = new Command("lookup").description("Lookup helper APIs");
 lookup
     .addCommand(new Command("research-area").addCommand(new Command("list").option("--format <format>", "Output format", "table").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("lookup.research-areas.list"), parseFormat(options.format));
 })))
     .addCommand(new Command("broker-org").addCommand(new Command("list").option("--format <format>", "Output format", "table").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("lookup.broker-orgs.list"), parseFormat(options.format));
 })))
     .addCommand(new Command("meeting-org").addCommand(new Command("list").option("--format <format>", "Output format", "table").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("lookup.meeting-orgs.list"), parseFormat(options.format));
 })))
     .addCommand(new Command("industry").addCommand(new Command("list").option("--format <format>", "Output format", "table").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("lookup.industries.list"), parseFormat(options.format));
 })))
     .addCommand(new Command("region").description("Foreign report region codes").addCommand(new Command("list").option("--format <format>", "Output format", "table").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("lookup.regions.list"), parseFormat(options.format));
 })))
     .addCommand(new Command("announcement-category").description("Announcement category codes").addCommand(new Command("list").option("--format <format>", "Output format", "table").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("lookup.announcement-categories.list"), parseFormat(options.format));
 })))
     .addCommand(new Command("industry-code").description("Shenwan industry codes for security-clue --gts-code").addCommand(new Command("list").option("--format <format>", "Output format", "table").action(async (options) => {
-    const data = [
-        { name: "申万农林牧渔", code: "821031.SWI" },
-        { name: "申万基础化工", code: "821032.SWI" },
-        { name: "申万钢铁", code: "821033.SWI" },
-        { name: "申万有色金属", code: "821034.SWI" },
-        { name: "申万电子", code: "821035.SWI" },
-        { name: "申万汽车", code: "821036.SWI" },
-        { name: "申万家用电器", code: "821037.SWI" },
-        { name: "申万食品饮料", code: "821038.SWI" },
-        { name: "申万纺织服饰", code: "821039.SWI" },
-        { name: "申万轻工制造", code: "821040.SWI" },
-        { name: "申万医药生物", code: "821041.SWI" },
-        { name: "申万公用事业", code: "821042.SWI" },
-        { name: "申万交通运输", code: "821043.SWI" },
-        { name: "申万房地产", code: "821044.SWI" },
-        { name: "申万商贸零售", code: "821045.SWI" },
-        { name: "申万社会服务", code: "821046.SWI" },
-        { name: "申万银行", code: "821047.SWI" },
-        { name: "申万非银金融", code: "821048.SWI" },
-        { name: "申万综合", code: "821049.SWI" },
-        { name: "申万建筑材料", code: "821050.SWI" },
-        { name: "申万建筑装饰", code: "821051.SWI" },
-        { name: "申万电力设备", code: "821052.SWI" },
-        { name: "申万机械设备", code: "821053.SWI" },
-        { name: "申万国防军工", code: "821054.SWI" },
-        { name: "申万计算机", code: "821055.SWI" },
-        { name: "申万传媒", code: "821056.SWI" },
-        { name: "申万通信", code: "821057.SWI" },
-        { name: "申万煤炭", code: "821058.SWI" },
-        { name: "申万石油石化", code: "821059.SWI" },
-        { name: "申万环保", code: "821060.SWI" },
-        { name: "申万美容护理", code: "821061.SWI" },
-    ];
-    await printData(data, parseFormat(options.format));
+    const client = await createClient();
+    await printData(await client.call("lookup.industry-codes.list"), parseFormat(options.format));
+})))
+    .addCommand(new Command("theme-id").description("Theme IDs for theme-tracking --theme-id").addCommand(new Command("list").option("--format <format>", "Output format", "table").action(async (options) => {
+    const client = await createClient();
+    await printData(await client.call("lookup.theme-ids.list"), parseFormat(options.format));
 })));
 program.addCommand(lookup);
 const insight = new Command("insight").description("Insight APIs");
@@ -273,7 +252,7 @@ const research = new Command("research");
 const foreignReport = new Command("foreign-report");
 const announcement = new Command("announcement");
 addTimeFilters(opinion.command("list").option("--rank-type <number>", "Rank type", "1").option("--research-area <id>", "Research area ID", collectList, []).option("--chief <id>", "Chief ID", collectList, []).option("--security <code>", "Security code", collectList, []).option("--broker <id>", "Broker ID", collectList, []).option("--industry <id>", "Industry ID", collectList, []).option("--concept <id>", "Concept ID", collectList, []).option("--llm-tag <tag>", "Semantic tag", collectList, []).option("--source <source>", "Source", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>", "Output path")).action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("insight.opinion.list", {
         from: Number(options.from), size: options.size === undefined ? undefined : Number(options.size), startTime: options.startTime, endTime: options.endTime,
         rankType: Number(options.rankType), keyword: options.keyword, researchAreaList: maybeArray(options.researchArea), chiefList: maybeArray(options.chief),
@@ -282,7 +261,7 @@ addTimeFilters(opinion.command("list").option("--rank-type <number>", "Rank type
     }), parseFormat(options.format), options.output);
 });
 addTimeFilters(summary.command("list").option("--search-type <number>", "Search type", "1").option("--rank-type <number>", "Rank type", "1").option("--source <number>", "Source type", collectNumberList, []).option("--research-area <id>", "Research area", collectList, []).option("--security <code>", "Security code", collectList, []).option("--institution <id>", "Institution ID", collectList, []).option("--category <name>", "Category", collectList, []).option("--market <name>", "Market", collectList, []).option("--participant-role <name>", "Participant role", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>", "Output path")).action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("insight.summary.list", {
         from: Number(options.from), size: options.size === undefined ? undefined : Number(options.size), startTime: options.startTime, endTime: options.endTime,
         searchType: Number(options.searchType), rankType: Number(options.rankType), keyword: options.keyword, sourceList: options.source.length ? options.source : undefined,
@@ -291,13 +270,13 @@ addTimeFilters(summary.command("list").option("--search-type <number>", "Search
     }), parseFormat(options.format), options.output, { endpointKey: "insight.summary.list", idField: "summaryId" });
 });
 summary.command("download").requiredOption("--summary-id <id>").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     const result = await client.call("insight.summary.download", undefined, { summaryId: options.summaryId });
     const title = options.output ? undefined : await resolveTitle(client, result, "insight.summary.list", "summaryId", options.summaryId);
     await saveDownloadResult(result, `summary-${options.summaryId}`, options.output ?? title);
 });
 const addScheduleList = (command, endpointKey) => addTimeFilters(command.command("list").option("--research-area <id>", "Research area", collectList, []).option("--institution <id>", "Institution ID", collectList, []).option("--security <code>", "Security code", collectList, []).option("--category <name>", "Category", collectList, []).option("--market <name>", "Market", collectList, []).option("--participant-role <name>", "Participant role", collectList, []).option("--broker-type <name>", "Broker type", collectList, []).option("--object <type>", "Object type: company/industry", collectList, []).option("--permission <number>", "Permission", collectNumberList, []).option("--format <format>", "Output format", "table").option("--output <path>", "Output path")).action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call(endpointKey, {
         from: Number(options.from), size: options.size === undefined ? undefined : Number(options.size), startTime: options.startTime, endTime: options.endTime, keyword: options.keyword,
         researchAreaList: maybeArray(options.researchArea), institutionList: maybeArray(options.institution), securityList: maybeArray(options.security),
@@ -310,7 +289,7 @@ addScheduleList(siteVisit, "insight.site-visit.list");
 addScheduleList(strategy, "insight.strategy.list");
 addScheduleList(forum, "insight.forum.list");
 addTimeFilters(research.command("list").option("--search-type <number>", "Search type: 1=title 2=fulltext", "1").option("--rank-type <number>", "Rank type: 1=composite 2=time desc", "1").option("--broker <id>", "Broker ID", collectList, []).option("--security <code>", "Security code", collectList, []).option("--industry <id>", "Industry ID", collectList, []).option("--category <name>", "Report category", collectList, []).option("--llm-tag <tag>", "Semantic tag", collectList, []).option("--rating <name>", "Rating", collectList, []).option("--rating-change <name>", "Rating change", collectList, []).option("--min-pages <number>", "Min report pages").option("--max-pages <number>", "Max report pages").option("--source <type>", "Source type", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>", "Output path")).action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("insight.research.list", {
         from: Number(options.from), size: options.size === undefined ? undefined : Number(options.size), startTime: options.startTime, endTime: options.endTime, keyword: options.keyword,
         searchType: Number(options.searchType), rankType: Number(options.rankType),
@@ -321,13 +300,13 @@ addTimeFilters(research.command("list").option("--search-type <number>", "Search
     }), parseFormat(options.format), options.output, { endpointKey: "insight.research.list", idField: "reportId" });
 });
 research.command("download").requiredOption("--report-id <id>").option("--file-type <number>", "File type: 1=PDF 2=Markdown", "1").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     const result = await client.call("insight.research.download", undefined, { reportId: options.reportId, fileType: Number(options.fileType) });
     const title = options.output ? undefined : await resolveTitle(client, result, "insight.research.list", "reportId", options.reportId);
     await saveDownloadResult(result, `research-${options.reportId}`, options.output ?? title);
 });
 addTimeFilters(foreignReport.command("list").option("--search-type <number>", "Search type: 1=title 2=fulltext", "1").option("--rank-type <number>", "Rank type: 1=composite 2=time desc", "1").option("--security <code>", "Security code", collectList, []).option("--region <id>", "Region ID", collectList, []).option("--category <name>", "Report category", collectList, []).option("--industry <id>", "Industry ID", collectList, []).option("--broker <id>", "Broker ID", collectList, []).option("--llm-tag <tag>", "Semantic tag", collectList, []).option("--rating <name>", "Rating", collectList, []).option("--rating-change <name>", "Rating change", collectList, []).option("--min-pages <number>", "Min report pages").option("--max-pages <number>", "Max report pages").option("--format <format>", "Output format", "table").option("--output <path>", "Output path")).action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("insight.foreign-report.list", {
         from: Number(options.from), size: options.size === undefined ? undefined : Number(options.size), startTime: options.startTime, endTime: options.endTime, keyword: options.keyword,
         searchType: Number(options.searchType), rankType: Number(options.rankType),
@@ -338,13 +317,13 @@ addTimeFilters(foreignReport.command("list").option("--search-type <number>", "S
     }), parseFormat(options.format), options.output, { endpointKey: "insight.foreign-report.list", idField: "reportId" });
 });
 foreignReport.command("download").requiredOption("--report-id <id>").option("--file-type <number>", "File type: 1=PDF 2=Markdown 3=CN-PDF 4=CN-Markdown", "1").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     const result = await client.call("insight.foreign-report.download", undefined, { reportId: options.reportId, fileType: Number(options.fileType) });
     const title = options.output ? undefined : await resolveTitle(client, result, "insight.foreign-report.list", "reportId", options.reportId);
     await saveDownloadResult(result, `foreign-report-${options.reportId}`, options.output ?? title);
 });
 addTimeFilters(announcement.command("list").option("--search-type <number>", "Search type: 1=title 2=fulltext", "1").option("--rank-type <number>", "Rank type: 1=composite 2=time desc", "1").option("--security <code>", "Security code", collectList, []).option("--announcement-type <type>", "Announcement type", collectList, []).option("--category <id>", "Category ID", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>", "Output path")).action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("insight.announcement.list", {
         from: Number(options.from), size: options.size === undefined ? undefined : Number(options.size),
         startTime: toTimestamp13(options.startTime), endTime: toTimestamp13(options.endTime),
@@ -353,7 +332,7 @@ addTimeFilters(announcement.command("list").option("--search-type <number>", "Se
     }), parseFormat(options.format), options.output, { endpointKey: "insight.announcement.list", idField: "announcementId" });
 });
 announcement.command("download").requiredOption("--announcement-id <id>").option("--file-type <number>", "File type: 1=PDF 2=Markdown", "1").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     const result = await client.call("insight.announcement.download", undefined, { announcementId: options.announcementId, fileType: Number(options.fileType) });
     const title = options.output ? undefined : await resolveTitle(client, result, "insight.announcement.list", "announcementId", options.announcementId);
     await saveDownloadResult(result, `announcement-${options.announcementId}`, options.output ?? title);
@@ -370,62 +349,133 @@ insight.addCommand(announcement);
 program.addCommand(insight);
 const quote = new Command("quote").description("Quote APIs");
 quote.command("day-kline").option("--security <code>", "Security code", collectList, []).option("--start-date <date>").option("--end-date <date>").option("--limit <number>").option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("quote.day-kline", { 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);
 });
 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 = new GangtiseClient(loadConfig());
-    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 : ["latest"], reportType: options.reportType.length ? options.reportType : ["consolidated"], fieldList: maybeArray(options.field) }), parseFormat(options.format), options.output);
+    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("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);
+});
+fundamental.command("cash-flow").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.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("main-business").requiredOption("--security-code <code>").option("--start-date <date>").option("--end-date <date>").option("--fiscal-year <year>", "Fiscal year", collectList, []).addOption(new Option("--breakdown <type>", "Breakdown: product/industry/region").choices(["product", "industry", "region"]).default("product")).addOption(new Option("--period <type>", "Period: interim/annual").choices(["interim", "annual"])).option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("fundamental.main-business", { securityCode: options.securityCode, startDate: options.startDate, endDate: options.endDate, fiscalYear: maybeArray(options.fiscalYear), breakdown: options.breakdown, period: options.period, fieldList: maybeArray(options.field) }), parseFormat(options.format), options.output);
 });
 fundamental.command("valuation-analysis").requiredOption("--security-code <code>").addOption(new Option("--indicator <name>", "Indicator").choices(["peTtm", "pbMrq", "peg", "psTtm", "pcfTtm", "em"]).makeOptionMandatory()).option("--start-date <date>").option("--end-date <date>").option("--limit <number>").option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("fundamental.valuation-analysis", { securityCode: options.securityCode, indicator: options.indicator, startDate: options.startDate, endDate: options.endDate, limit: options.limit ? Number(options.limit) : undefined, fieldList: maybeArray(options.field) }), parseFormat(options.format), options.output);
 });
 program.addCommand(fundamental);
 const ai = new Command("ai").description("AI APIs");
 ai.command("knowledge-batch").requiredOption("--query <text>", "Query", collectList, []).option("--top <number>", "Top", "10").option("--resource-type <number>", "Resource type", collectNumberList, []).option("--knowledge-name <name>", "Knowledge name", collectList, []).option("--start-time <ms>").option("--end-time <ms>").option("--format <format>", "Output format", "json").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("ai.knowledge-batch", { queries: options.query, top: Number(options.top), resourceTypes: options.resourceType.length ? options.resourceType : undefined, knowledgeNames: maybeArray(options.knowledgeName), startTime: options.startTime ? Number(options.startTime) : undefined, endTime: options.endTime ? Number(options.endTime) : undefined }), parseFormat(options.format), options.output);
 });
 ai.command("knowledge-resource-download").requiredOption("--resource-type <number>").requiredOption("--source-id <id>").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await saveDownloadResult(await client.call("ai.knowledge-resource.download", undefined, { resourceType: Number(options.resourceType), sourceId: options.sourceId }), `resource-${options.sourceId}`, options.output);
 });
 ai.command("security-clue").option("--from <number>", "Starting offset", "0").option("--size <number>", "Total rows to return; omit to fetch all").requiredOption("--start-time <datetime>").requiredOption("--end-time <datetime>").addOption(new Option("--query-mode <mode>").choices(["bySecurity", "byIndustry"]).makeOptionMandatory()).option("--gts-code <code>", "GTS code", collectList, []).option("--source <name>", "Source", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("ai.security-clue.list", { from: Number(options.from), size: options.size === undefined ? undefined : Number(options.size), startTime: options.startTime, endTime: options.endTime, queryMode: options.queryMode, gtsCodeList: maybeArray(options.gtsCode), source: maybeArray(options.source) }), parseFormat(options.format), options.output);
 });
 ai.command("one-pager").requiredOption("--security-code <code>").option("--format <format>", "Output format", "json").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("ai.one-pager", { securityCode: options.securityCode }), parseFormat(options.format), options.output);
 });
 ai.command("investment-logic").requiredOption("--security-code <code>").option("--format <format>", "Output format", "json").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("ai.investment-logic", { securityCode: options.securityCode }), parseFormat(options.format), options.output);
 });
 ai.command("peer-comparison").requiredOption("--security-code <code>").option("--format <format>", "Output format", "json").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("ai.peer-comparison", { securityCode: options.securityCode }), parseFormat(options.format), options.output);
 });
+ai.command("earnings-review").requiredOption("--security-code <code>").requiredOption("--period <period>", "Report period (e.g. 2025q3, 2025interim, 2025annual)").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.earnings-review.get-id", { securityCode: options.securityCode, period: options.period });
+    const dataId = idResult?.dataId;
+    if (!dataId) {
+        process.stderr.write("Failed to get earnings review ID. The report may not be available yet.\n");
+        process.exitCode = 1;
+        return;
+    }
+    // Non-blocking: return dataId immediately
+    if (!options.wait) {
+        process.stderr.write(`Earnings review task submitted. dataId: ${dataId}\n`);
+        process.stdout.write(`${JSON.stringify({ dataId, status: "pending", hint: `Run 'gangtise ai earnings-review-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.earnings-review.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 earnings-review-check --data-id ${dataId}\n`);
+    process.exitCode = 1;
+});
+ai.command("earnings-review-check").requiredOption("--data-id <id>", "dataId from earnings-review").option("--format <format>", "Output format", "json").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    try {
+        const contentResult = await client.call("ai.earnings-review.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`);
+    }
+    catch (error) {
+        if (error instanceof ApiError && (error.code === "410110" || error.message?.includes("生成中"))) {
+            process.stdout.write(`${JSON.stringify({ dataId: options.dataId, status: "pending", hint: "Content not ready yet, retry in ~2 minutes" })}\n`);
+            return;
+        }
+        throw error;
+    }
+});
+ai.command("theme-tracking").requiredOption("--theme-id <id>", "Theme ID (use lookup theme-id list)").requiredOption("--date <date>", "Date (yyyy-MM-dd)").option("--type <name>", "Report type: morning/night", collectList, []).option("--format <format>", "Output format", "json").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    const typeList = options.type.length ? options.type : undefined;
+    await printData(await client.call("ai.theme-tracking", { themeId: options.themeId, date: options.date, type: typeList }), parseFormat(options.format), options.output);
+});
+ai.command("research-outline").requiredOption("--security-code <code>").option("--format <format>", "Output format", "json").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    await printData(await client.call("ai.research-outline", { securityCode: options.securityCode }), parseFormat(options.format), options.output);
+});
 ai.command("cloud-disk-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 = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("ai.cloud-disk.list", { from: Number(options.from), size: options.size === undefined ? undefined : Number(options.size), startTime: options.startTime, endTime: options.endTime, keyword: options.keyword, fileTypeList: options.fileType.length ? options.fileType : undefined, spaceTypeList: options.spaceType.length ? options.spaceType : undefined }), parseFormat(options.format), options.output, { endpointKey: "ai.cloud-disk.list", idField: "fileId" });
 });
 ai.command("cloud-disk-download").requiredOption("--file-id <id>").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     const result = await client.call("ai.cloud-disk.download", undefined, { fileId: options.fileId });
     const title = options.output ? undefined : await resolveTitle(client, result, "ai.cloud-disk.list", "fileId", options.fileId);
     await saveDownloadResult(result, `file-${options.fileId}`, options.output ?? title);
 });
 program.addCommand(ai);
 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 client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     const body = options.body ? JSON.parse(options.body) : undefined;
     const data = await client.call(endpointKey, body, options.query);
     if (data && typeof data === "object" && "data" in data && data.data instanceof Uint8Array) {
@@ -455,4 +505,3 @@ async function main() {
     }
 }
 void main();
-//# sourceMappingURL=cli.js.map

package/dist/src/core/args.js

@@ -44,4 +44,3 @@ export function toTimestamp13(value) {
         return undefined;
     return ms;
 }
-//# sourceMappingURL=args.js.map

package/dist/src/core/auth.js

@@ -33,4 +33,3 @@ export function requireAccessCredentials(accessKey, secretKey) {
     }
     return { accessKey, secretKey };
 }
-//# sourceMappingURL=auth.js.map