gangtise-openapi-cli 0.14.3 → 0.15.0

package/README.md

@@ -4,6 +4,30 @@
 
 ## Changelog
 
+### v0.15.0 — 2026-05-29
+
+**新增接口**
+- `alternative concept-info` — 题材指数基本信息：返回题材整体画像（定义 / 投资逻辑 / 行业空间 / 竞争格局 / 催化事件）。按 `--concept-id` 查询，仅返回最新截面数据，不支持历史回溯
+- `alternative concept-securities` — 题材指数成分股（题材深度 F8）：按分组结构返回当前成分股，每只含是否重点个股 `isKey` 与纳入理由 `inclusionReason`。按 `--concept-id` 查询
+
+**接口变更**
+- `quote index-day-kline` 返回字段新增 `securityName`（指数名称，如"上证指数"）
+
+> `--concept-id` 与主题跟踪 `ai theme-tracking --theme-id` 共用同一套题材 ID 体系，可用 `gangtise lookup theme-id list` 按名称查询（如 机器人 → `121000130`）。
+
+### v0.14.4 — 2026-05-29
+
+**Bug fix（全市场 K 线分片容错）**
+- `quote day-kline --security all` 等全市场查询的日期分片改为容错：部分分片失败时返回已成功分片的数据并标记 `partial: true` + `failedShards`（失败的日期区间），同时向 stderr 告警；只有全部分片失败才抛错。此前为 fail-fast，单片失败会让整次查询失败，或在异常路径上被误判为空结果。
+
+### v0.14.3 — 2026-05-29
+
+**性能 / 健壮性**
+- 标题缓存按端点封顶（5000 条/端点）并清理过期项，修复 `title-cache.json` 无上限增长（曾达 ~58MB）拖慢启动的问题
+- 下载接口遇鉴权失效（`8000014` / `8000015`）自动刷新 token 并重试一次（此前仅普通 JSON 调用具备 token 自愈）
+- CLI handler 抽出 `emit` / `withClient` 公共封装去除重复样板；CSV 转义逻辑去重；翻页与 K 线分片统一走 `GANGTISE_PAGE_CONCURRENCY` 并发控制
+- 补齐多个 core 模块的单元测试
+
 ### v0.14.2 — 2026-05-22
 
 **Bug fix（A 股 / HK 全市场 K 线同源问题）**
@@ -240,6 +264,8 @@ cp -r gangtise-openapi ~/.hermes/skills/gangtise-openapi
 | | `stock-pool-list` / `stock-pool-stocks` | 自选股股票池列表与证券明细 |
 | **Alternative** | `edb-search` | 行业指标搜索（按关键词匹配，返回 indicatorId 等元信息） |
 | | `edb-data` | 行业指标时序数据（批量拉取，最多10个指标） |
+| | `concept-info` | 题材指数基本信息（投资逻辑/行业空间/竞争格局/催化事件） |
+| | `concept-securities` | 题材指数成分股（题材深度F8，按分组，标记重点个股） |
 | **Raw** | `call` | 原始接口调用（可访问任意 endpoint） |
 
 ## 命令概览
@@ -549,6 +575,12 @@ gangtise alternative edb-data \
   --end-date 2024-12-31 \
   --format csv \
   --output ./indicator.csv
+
+# 题材指数：先查 conceptId（与 theme-id 共用 ID 体系），再拉画像 / 成分股
+gangtise lookup theme-id list | grep 机器人        # → 121000130
+gangtise alternative concept-info --concept-id 121000130 --format json
+# 题材成分股（题材深度 F8，按分组返回，标记重点个股）
+gangtise alternative concept-securities --concept-id 121000130 --format json
 ```
 
 ### Raw

package/dist/src/cli.js

@@ -412,6 +412,8 @@ alternative.command("edb-data").option("--indicator-id <id>", "Indicator ID (rep
     }
     await printData(data, parseOutputFormat(options.format), options.output);
 }));
+alternative.command("concept-info").requiredOption("--concept-id <id>", "Concept (theme index) ID, e.g. 121000130 机器人; discover via 'gangtise lookup theme-id list'").option("--format <format>", "Output format", "json").option("--output <path>").action((options) => emit(options, (client) => client.call("alternative.concept-info", { conceptId: options.conceptId })));
+alternative.command("concept-securities").requiredOption("--concept-id <id>", "Concept (theme index) ID, e.g. 121000130 机器人; discover via 'gangtise lookup theme-id list'").option("--format <format>", "Output format", "json").option("--output <path>").action((options) => emit(options, (client) => client.call("alternative.concept-securities", { conceptId: options.conceptId })));
 program.addCommand(alternative);
 program.command("raw").description("Raw API calls").addCommand(new Command("call").argument("<endpointKey>").option("--body <json>").option("--query <key=value>", "Query string pair", collectKeyValue, {}).option("--format <format>", "Output format", "json").option("--output <path>").action(async (endpointKey, options) => {
     const endpoint = ENDPOINTS[endpointKey];

package/dist/src/core/endpoints.js

@@ -537,4 +537,18 @@ export const ENDPOINTS = {
         kind: "json",
         description: "Get industry indicator time-series data by indicator ID list",
     },
+    "alternative.concept-info": {
+        key: "alternative.concept-info",
+        method: "POST",
+        path: "/application/open-alternative/concept/info",
+        kind: "json",
+        description: "Query latest concept (theme index) profile by conceptId",
+    },
+    "alternative.concept-securities": {
+        key: "alternative.concept-securities",
+        method: "POST",
+        path: "/application/open-alternative/concept/securities",
+        kind: "json",
+        description: "Query concept (theme index) constituent securities, grouped",
+    },
 };

package/dist/src/core/quoteSharding.js

@@ -65,8 +65,22 @@ export async function callKlineWithSharding(client, endpointKey, body, config) {
     if (process.env.GANGTISE_VERBOSE === "1" || process.env.GANGTISE_VERBOSE === "true") {
         process.stderr.write(`[gangtise] sharding ${endpointKey} into ${shards.length} requests (${config.shardDays} day(s) each)\n`);
     }
+    // Per-shard fault tolerance: a failing shard is recorded and skipped (returns a
+    // null sentinel) instead of rejecting, so the surviving shards still complete.
+    // runWithConcurrency uses Promise.all under the hood, which would otherwise abort
+    // every shard on the first rejection.
+    const failedShards = [];
+    let firstError = null;
     const results = await runWithConcurrency(shards, config.concurrency ?? SHARD_CONCURRENCY, async (shard) => {
-        return client.call(endpointKey, { ...allMarketBody, startDate: shard.startDate, endDate: shard.endDate });
+        try {
+            return await client.call(endpointKey, { ...allMarketBody, startDate: shard.startDate, endDate: shard.endDate });
+        }
+        catch (error) {
+            if (!firstError)
+                firstError = error;
+            failedShards.push(shard);
+            return null;
+        }
     });
     let fieldList;
     let header = null;
@@ -82,10 +96,20 @@ export async function callKlineWithSharding(client, endpointKey, body, config) {
         if (Array.isArray(rec.list))
             merged.push(...rec.list);
     }
+    // Every shard failed → surface the error loudly (non-zero exit) rather than
+    // masking a total outage as an empty success.
+    if (failedShards.length === shards.length) {
+        throw firstError ?? new Error(`All ${shards.length} kline shards failed`);
+    }
     if (!header)
         return { list: [] };
     const out = { ...header, list: merged };
     if (fieldList)
         out.fieldList = fieldList;
+    if (failedShards.length > 0) {
+        out.partial = true;
+        out.failedShards = failedShards;
+        process.stderr.write(`[gangtise] warning: ${failedShards.length}/${shards.length} shards failed; results are partial (see failedShards)\n`);
+    }
     return out;
 }

package/dist/src/version.js

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

package/package.json

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