gangtise-openapi-cli 0.5.1 → 0.7.0

package/README.md

@@ -44,6 +44,7 @@ export GANGTISE_TOKEN="Bearer xxx"
 - `gangtise quote ...`
 - `gangtise fundamental ...`
 - `gangtise ai ...`
+- `gangtise vault ...`
 - `gangtise raw call ...`
 
 其中 `lookup` 下的研究方向、机构、行业枚举已内置在项目中，无需额外本地文档文件。
@@ -84,7 +85,7 @@ gangtise ai knowledge-batch --query 比亚迪 --query 最近热门概念
 - `insight foreign-report list`
 - `insight announcement list`
 - `ai security-clue`
-- `ai cloud-disk-list`
+- `vault drive-list`
 
 规则：
 - **有时间范围时**（传了 `--start-time/--end-time` 或 `--start-date/--end-date`）：**省略 `--size`**，CLI 自动翻页查全
@@ -93,7 +94,7 @@ gangtise ai knowledge-batch --query 比亚迪 --query 最近热门概念
 
 ## 智能文件命名
 
-下载命令（`summary download`、`research download`、`foreign-report download`、`announcement download`、`cloud-disk-download`）省略 `--output` 时，自动使用真实标题作为文件名：
+下载命令（`summary download`、`research download`、`foreign-report download`、`announcement download`、`vault drive-download`）省略 `--output` 时，自动使用真实标题作为文件名：
 
 1. **缓存优先** — 如果之前执行过对应的 `list` 命令，标题已缓存在 `~/.config/gangtise/title-cache.json`，直接使用，无额外 API 调用
 2. **API 回查** — 缓存未命中时，自动查询最近 200 条记录匹配标题
@@ -146,14 +147,26 @@ gangtise insight roadshow list --institution C100000017
 
 ```bash
 gangtise quote day-kline --security 600519.SH --start-date 2026-03-01 --end-date 2026-03-31
+# 不传 --security 默认返回全市场，不传 --start-date 默认往前一年，不传 --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
 ```
 
 ### Fundamental
 
 ```bash
 gangtise fundamental income-statement --security-code 600519.SH --fiscal-year 2025 --period q3 --field netProfit
-# 多周期：同时查一季报和中报
-gangtise fundamental income-statement --security-code 600519.SH --fiscal-year 2024 --period q1 --period q2 --report-type consolidated
+# 多年度：同时查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
 ```
@@ -168,14 +181,22 @@ gangtise ai security-clue --start-time "2026-04-01 00:00:00" --end-time "2026-04
 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 部门文档 --space-type 1 --file-type 1
+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
+```
+
+### Vault
+
+```bash
+gangtise vault drive-list --keyword 部门文档 --space-type 1 --file-type 1
 
 # 云盘下载：自动使用文件标题命名
-gangtise ai cloud-disk-download --file-id 62130
+gangtise vault drive-download --file-id 62130
 # → 2028 全球智能危机  一份来自未来的金融史思想实验  .pdf
+```
 
 gangtise ai knowledge-resource-download --resource-type 60 --source-id 3052524 --output ./resource.txt
-# 若接口返回外链 URL，也会直接输出 URL 或按 --output 保存
 ```
 
 ### Raw
@@ -192,9 +213,10 @@ gangtise raw call insight.opinion.list --body '{"from":0,"size":120}'
 - 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`
+- quote: `day-kline` / `day-kline-hk`
 - 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` / `one-pager` / `investment-logic` / `peer-comparison` / `earnings-review` / `theme-tracking` / `research-outline`
+- vault: `drive-list` / `drive-download`
 
 注意：`knowledge-resource-download` 依赖正确的 `resourceType + sourceId` 组合；错误组合会返回 `433007 不支持该数据源`。
 
@@ -210,17 +232,22 @@ gangtise raw call insight.opinion.list --body '{"from":0,"size":120}'
 
 ## Claude Code Skill
 
-本项目包含一个 [Claude Code](https://claude.ai/claude-code) skill 定义（`SKILL.md`），可让 AI agent 自动调用 `gangtise` CLI 完成投研数据查询。
+本项目包含一个 [Claude Code](https://claude.ai/claude-code) skill 定义（`gangtise-openapi/SKILL.md`），可让 AI agent 自动调用 `gangtise` CLI 完成投研数据查询。
+
+Skill 目录结构：
+
+```
+gangtise-openapi/
+├── SKILL.md                    # 主 skill 文件（命令参考、参数枚举、使用规则）
+└── references/
+    └── lookup-ids.md           # 常用 ID 速查表（行业/券商/机构/公告分类等）
+```
 
 安装到 Claude Code：
 
 ```bash
-# 方式一：从本地项目安装
-cp SKILL.md ~/.claude/skills/gangtise-openapi/SKILL.md
-
-# 方式二：手动创建目录并复制
-mkdir -p ~/.claude/skills/gangtise-openapi
-cp SKILL.md ~/.claude/skills/gangtise-openapi/
+# 从项目根目录复制整个 skill 目录
+cp -r gangtise-openapi ~/.claude/skills/gangtise-openapi
 ```
 
 安装后，在 Claude Code 中可以用自然语言触发，例如：

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,32 +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 client = new GangtiseClient(loadConfig());
+    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");
@@ -241,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),
@@ -250,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,
@@ -259,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),
@@ -278,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),
@@ -289,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),
@@ -306,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),
@@ -321,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);
@@ -337,63 +348,140 @@ insight.addCommand(foreignReport);
 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());
+quote.command("day-kline").option("--security <code>", "Security code (A-share only: .SH/.SZ/.BJ)", collectList, []).option("--start-date <date>", "Start date (default: 1 year before end-date)").option("--end-date <date>", "End date (default: latest)").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.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);
 });
+quote.command("day-kline-hk").option("--security <code>", "Security code (HK stock only: .HK)", collectList, []).option("--start-date <date>", "Start date (default: 1 year before end-date)").option("--end-date <date>", "End date (default: latest)").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.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);
+});
 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("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());
-    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("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);
+});
+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();
+    await printData(await client.call("vault.drive.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: "vault.drive.list", idField: "fileId" });
 });
-ai.command("cloud-disk-download").requiredOption("--file-id <id>").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
-    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);
+vault.command("drive-download").requiredOption("--file-id <id>").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    const result = await client.call("vault.drive.download", undefined, { fileId: options.fileId });
+    const title = options.output ? undefined : await resolveTitle(client, result, "vault.drive.list", "fileId", options.fileId);
     await saveDownloadResult(result, `file-${options.fileId}`, options.output ?? title);
 });
+program.addCommand(vault);
 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) {
@@ -423,4 +511,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