gangtise-openapi-cli 0.9.0 → 0.10.1

package/README.md

@@ -64,6 +64,7 @@ export GANGTISE_TOKEN="Bearer xxx"
 | | `income-statement-quarterly` / `cash-flow-quarterly` | 利润表/现金流量表（单季度） |
 | | `main-business` | 主营构成（按地区/产品拆分） |
 | | `valuation-analysis` | 估值分析 |
+| | `earning-forecast` | 盈利预测（一致预期） |
 | **AI** | `knowledge-batch` | 知识库批量检索 |
 | | `knowledge-resource-download` | 知识资源下载 |
 | | `security-clue` | 个股线索 |
@@ -78,6 +79,8 @@ export GANGTISE_TOKEN="Bearer xxx"
 | | `management-discuss-earnings-call` | 管理层讨论-业绩会 |
 | | `viewpoint-debate` / `viewpoint-debate-check` | 观点PK（异步） |
 | **Vault** | `drive-list` / `drive-download` | 云盘文件列表与下载 |
+| | `record-list` / `record-download` | 录音速记列表与下载 |
+| | `my-conference-list` / `my-conference-download` | 我的会议列表与下载 |
 | **Raw** | `call` | 原始接口调用（可访问任意 endpoint） |
 
 ## AI Agent Skill
@@ -165,6 +168,8 @@ gangtise ai knowledge-batch --query 比亚迪 --query 最近热门概念
 - `insight announcement list`
 - `ai security-clue`
 - `vault drive-list`
+- `vault record-list`
+- `vault my-conference-list`
 - `ai hot-topic`
 
 规则：
@@ -174,7 +179,7 @@ gangtise ai knowledge-batch --query 比亚迪 --query 最近热门概念
 
 ## 智能文件命名
 
-下载命令（`summary download`、`research download`、`foreign-report download`、`announcement download`、`vault drive-download`）省略 `--output` 时，自动使用真实标题作为文件名：
+下载命令（`summary download`、`research download`、`foreign-report download`、`announcement download`、`vault drive-download`、`vault record-download`、`vault my-conference-download`）省略 `--output` 时，自动使用真实标题作为文件名：
 
 1. **缓存优先** — 如果之前执行过对应的 `list` 命令，标题已缓存在 `~/.config/gangtise/title-cache.json`，直接使用，无额外 API 调用
 2. **API 回查** — 缓存未命中时，自动查询最近 200 条记录匹配标题
@@ -253,6 +258,8 @@ 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 earning-forecast --security-code 600519.SH --consensus netIncome --consensus eps --consensus pe
 # 利润表（单季度）
 gangtise fundamental income-statement-quarterly --security-code 600519.SH --fiscal-year 2025 --period q2 --field netProfit
 # 现金流量表（单季度）
@@ -296,6 +303,16 @@ gangtise vault drive-list --keyword 部门文档 --space-type 1 --file-type 1
 # 云盘下载：自动使用文件标题命名
 gangtise vault drive-download --file-id 62130
 # → 2028 全球智能危机  一份来自未来的金融史思想实验  .pdf
+
+# 录音速记列表
+gangtise vault record-list --keyword 晨会 --category upload --category mobile
+# 录音速记下载（--content-type: original/asr/summary）
+gangtise vault record-download --record-id 49412 --content-type summary
+
+# 我的会议列表
+gangtise vault my-conference-list --keyword AI --category earningsCall --institution C100000027
+# 我的会议下载（--content-type: asr/summary）
+gangtise vault my-conference-download --conference-id 43319 --content-type asr
 ```
 
 ### Raw
@@ -331,3 +348,4 @@ gangtise raw call insight.opinion.list --body '{"from":0,"size":120}'
 | `999997` | 未开通接口权限 |
 | `999999` | Gangtise 系统错误，请稍后重试 |
 | `433007` | 不支持该数据源（`knowledge-resource-download` 需正确的 `resourceType + sourceId` 组合） |
+| `430007` | 行情查询超出限制（日K线/分钟K线不传 `--security` 返回全市场，数据量过大；请指定证券代码或缩短日期范围） |

package/dist/src/cli.js

@@ -390,6 +390,10 @@ fundamental.command("valuation-analysis").requiredOption("--security-code <code>
     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);
 });
+fundamental.command("earning-forecast").requiredOption("--security-code <code>").option("--start-date <date>").option("--end-date <date>").option("--consensus <name>", "Consensus indicator: netIncome/netIncomeYoy/eps/pe/bps/pb/peg/roe/ps", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    await printData(await client.call("fundamental.earning-forecast", { securityCode: options.securityCode, startDate: options.startDate, endDate: options.endDate, consensusList: maybeArray(options.consensus) }), 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) => {
@@ -439,10 +443,17 @@ ai.command("earnings-review").requiredOption("--security-code <code>").requiredO
     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;
+        try {
+            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;
+            }
+        }
+        catch (error) {
+            if (!(error instanceof ApiError && (error.code === "410110" || error.message?.includes("生成中")))) {
+                throw error;
+            }
         }
         if (attempts < maxAttempts) {
             process.stderr.write(`Attempt ${attempts}/${maxAttempts}: content not ready, retrying in 15s...\n`);
@@ -531,10 +542,17 @@ ai.command("viewpoint-debate").requiredOption("--viewpoint <text>", "Viewpoint t
     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;
+        try {
+            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;
+            }
+        }
+        catch (error) {
+            if (!(error instanceof ApiError && (error.code === "410110" || error.message?.includes("生成中")))) {
+                throw error;
+            }
         }
         if (attempts < maxAttempts) {
             process.stderr.write(`Attempt ${attempts}/${maxAttempts}: content not ready, retrying in 15s...\n`);
@@ -546,12 +564,21 @@ ai.command("viewpoint-debate").requiredOption("--viewpoint <text>", "Viewpoint t
 });
 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;
+    try {
+        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`);
+    }
+    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;
     }
-    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) => {
@@ -564,6 +591,26 @@ vault.command("drive-download").requiredOption("--file-id <id>").option("--outpu
     const title = options.output ? undefined : await resolveTitle(client, result, "vault.drive.list", "fileId", options.fileId);
     await saveDownloadResult(result, `file-${options.fileId}`, options.output ?? title);
 });
+vault.command("record-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("--category <name>", "Recording type: upload/link/mobile/gtNote/pc/share", collectList, []).option("--space-type <number>", "Space type: 1=my records / 2=tenant records", collectNumberList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    await printData(await client.call("vault.record.list", { from: Number(options.from), size: options.size === undefined ? undefined : Number(options.size), startTime: options.startTime, endTime: options.endTime, keyword: options.keyword, categoryList: maybeArray(options.category), spaceTypeList: options.spaceType.length ? options.spaceType : undefined }), parseFormat(options.format), options.output, { endpointKey: "vault.record.list", idField: "recordId" });
+});
+vault.command("record-download").requiredOption("--record-id <id>").requiredOption("--content-type <type>", "Content type: original/asr/summary").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    const result = await client.call("vault.record.download", undefined, { recordId: options.recordId, contentType: options.contentType });
+    const title = options.output ? undefined : await resolveTitle(client, result, "vault.record.list", "recordId", options.recordId);
+    await saveDownloadResult(result, `record-${options.recordId}`, options.output ?? title);
+});
+vault.command("my-conference-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("--research-area <id>", "Research area ID", collectList, []).option("--security <code>", "Security code", collectList, []).option("--institution <id>", "Institution ID", collectList, []).option("--category <name>", "Conference category: earningsCall/strategyMeeting/fundRoadshow/shareholdersMeeting/maMeeting/specialMeeting/companyAnalysis/industryAnalysis/other", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    await printData(await client.call("vault.my-conference.list", { 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), securityList: maybeArray(options.security), institutionList: maybeArray(options.institution), categoryList: maybeArray(options.category) }), parseFormat(options.format), options.output, { endpointKey: "vault.my-conference.list", idField: "conferenceId" });
+});
+vault.command("my-conference-download").requiredOption("--conference-id <id>").requiredOption("--content-type <type>", "Content type: asr/summary").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    const result = await client.call("vault.my-conference.download", undefined, { conferenceId: options.conferenceId, contentType: options.contentType });
+    const title = options.output ? undefined : await resolveTitle(client, result, "vault.my-conference.list", "conferenceId", options.conferenceId);
+    await saveDownloadResult(result, `conference-${options.conferenceId}`, 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) => {

package/dist/src/core/endpoints.js

@@ -204,6 +204,13 @@ export const ENDPOINTS = {
         kind: "json",
         description: "Query main business composition",
     },
+    fundamentalEarningForecast: {
+        key: "fundamental.earning-forecast",
+        method: "POST",
+        path: "/application/open-fundamental/earning-forecast",
+        kind: "json",
+        description: "Query earning forecast (consensus estimates)",
+    },
     fundamentalValuationAnalysis: {
         key: "fundamental.valuation-analysis",
         method: "POST",
@@ -354,6 +361,36 @@ export const ENDPOINTS = {
         kind: "download",
         description: "Download vault drive file",
     },
+    vaultRecordList: {
+        key: "vault.record.list",
+        method: "POST",
+        path: "/application/open-vault/record/getList",
+        kind: "json",
+        description: "List voice recording transcriptions",
+        pagination: { enabled: true, maxPageSize: 50 },
+    },
+    vaultRecordDownload: {
+        key: "vault.record.download",
+        method: "GET",
+        path: "/application/open-vault/record/download/file",
+        kind: "download",
+        description: "Download voice recording transcription file",
+    },
+    vaultMyConferenceList: {
+        key: "vault.my-conference.list",
+        method: "POST",
+        path: "/application/open-vault/my-conference/getList",
+        kind: "json",
+        description: "List my conferences",
+        pagination: { enabled: true, maxPageSize: 50 },
+    },
+    vaultMyConferenceDownload: {
+        key: "vault.my-conference.download",
+        method: "GET",
+        path: "/application/open-vault/my-conference/download/file",
+        kind: "download",
+        description: "Download my conference resource",
+    },
 };
 export const ENDPOINT_REGISTRY = Object.values(ENDPOINTS).reduce((accumulator, endpoint) => {
     accumulator[endpoint.key] = endpoint;

package/dist/src/version.js

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

package/package.json

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