gangtise-openapi-cli 0.14.4 → 0.15.1

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 线同源问题）**
@@ -101,6 +125,22 @@ cd gangtise-openapi-cli
 npm install
 npm run dev -- --help
 ```
+
+## 发布
+
+npm 发版通过 GitHub Actions Trusted Publishing 完成，不需要 `NPM_TOKEN`。npm 包设置里的 Trusted Publisher 需要匹配本仓库和 workflow 文件名 `publish.yml`。
+
+```bash
+npm version patch --no-git-tag-version
+npm run prepare
+VERSION=$(node -p "require('./package.json').version")
+git commit -am "chore: release v$VERSION"
+git tag "v$VERSION"
+git push --follow-tags
+```
+
+推送 `v*` tag 后，`.github/workflows/publish.yml` 会在 GitHub-hosted runner 上使用 OIDC 发布到 `https://registry.npmjs.org/`。也可以从 GitHub Actions 页面手动运行该 workflow。
+
 ## 版本更新
 
 查看当前版本（自动与线上版本比对）：
@@ -240,6 +280,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 +591,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

@@ -46,6 +46,35 @@ async function runDownload(client, endpointKey, query, options) {
     const resolved = options.resolveOutputPath ? await options.resolveOutputPath(result) : undefined;
     await saveDownloadResult(result, options.fallbackName, resolved);
 }
+/**
+ * Register a download subcommand. All download commands share one shape: a
+ * required id option, optionally --file-type / --content-type, then --output.
+ * `idField` doubles as the commander option key and the query/title-cache
+ * field, so it must stay the camelCase twin of `idOption`.
+ */
+function addDownloadCommand(parent, spec) {
+    const cmd = parent.command(spec.name ?? "download").requiredOption(`${spec.idOption} <id>`);
+    if (spec.fileType?.required)
+        cmd.requiredOption("--file-type <number>", spec.fileType.description);
+    else if (spec.fileType)
+        cmd.option("--file-type <number>", spec.fileType.description, spec.fileType.default);
+    if (spec.contentTypeDescription)
+        cmd.requiredOption("--content-type <type>", spec.contentTypeDescription);
+    cmd.option("--output <path>").action((options) => withClient(async (client) => {
+        const id = options[spec.idField];
+        const qp = { [spec.idField]: id };
+        if (spec.fileType && options.fileType)
+            qp.fileType = parseNumberOption(options.fileType, "--file-type", { integer: true, min: 1 });
+        if (spec.contentTypeDescription)
+            qp.contentType = options.contentType;
+        const titleList = spec.titleListEndpoint;
+        await runDownload(client, spec.endpointKey, qp, {
+            output: options.output,
+            fallbackName: `${spec.fallbackPrefix}-${id}`,
+            resolveOutputPath: titleList ? (result) => resolveTitle(client, result, titleList, spec.idField, id) : undefined,
+        });
+    }));
+}
 function addTimeFilters(command) {
     return command
         .option("--from <number>", "Starting offset", "0")
@@ -80,15 +109,20 @@ program
     await printData({ hasEnvToken: Boolean(config.token), hasCachedToken: Boolean(cache?.accessToken), cache }, parseOutputFormat(options.format));
 }));
 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((options) => emit(options, (client) => client.call("lookup.research-areas.list")))))
-    .addCommand(new Command("broker-org").addCommand(new Command("list").option("--format <format>", "Output format", "table").action((options) => emit(options, (client) => client.call("lookup.broker-orgs.list")))))
-    .addCommand(new Command("meeting-org").addCommand(new Command("list").option("--format <format>", "Output format", "table").action((options) => emit(options, (client) => client.call("lookup.meeting-orgs.list")))))
-    .addCommand(new Command("industry").addCommand(new Command("list").option("--format <format>", "Output format", "table").action((options) => emit(options, (client) => client.call("lookup.industries.list")))))
-    .addCommand(new Command("region").description("Foreign report region codes").addCommand(new Command("list").option("--format <format>", "Output format", "table").action((options) => emit(options, (client) => client.call("lookup.regions.list")))))
-    .addCommand(new Command("announcement-category").description("Announcement category codes").addCommand(new Command("list").option("--format <format>", "Output format", "table").action((options) => emit(options, (client) => client.call("lookup.announcement-categories.list")))))
-    .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((options) => emit(options, (client) => client.call("lookup.industry-codes.list")))))
-    .addCommand(new Command("theme-id").description("Theme IDs for theme-tracking --theme-id").addCommand(new Command("list").option("--format <format>", "Output format", "table").action((options) => emit(options, (client) => client.call("lookup.theme-ids.list")))));
+const addLookupList = (name, endpointKey, description) => {
+    const cmd = new Command(name);
+    if (description)
+        cmd.description(description);
+    lookup.addCommand(cmd.addCommand(new Command("list").option("--format <format>", "Output format", "table").action((options) => emit(options, (client) => client.call(endpointKey)))));
+};
+addLookupList("research-area", "lookup.research-areas.list");
+addLookupList("broker-org", "lookup.broker-orgs.list");
+addLookupList("meeting-org", "lookup.meeting-orgs.list");
+addLookupList("industry", "lookup.industries.list");
+addLookupList("region", "lookup.regions.list", "Foreign report region codes");
+addLookupList("announcement-category", "lookup.announcement-categories.list", "Announcement category codes");
+addLookupList("industry-code", "lookup.industry-codes.list", "Shenwan industry codes for security-clue --gts-code");
+addLookupList("theme-id", "lookup.theme-ids.list", "Theme IDs for theme-tracking --theme-id");
 program.addCommand(lookup);
 const insight = new Command("insight").description("Insight APIs");
 const opinion = new Command("opinion");
@@ -115,16 +149,7 @@ addTimeFilters(summary.command("list").option("--search-type <number>", "Search
     researchAreaList: maybeArray(options.researchArea), securityList: maybeArray(options.security), institutionList: maybeArray(options.institution),
     categoryList: maybeArray(options.category), marketList: maybeArray(options.market), participantRoleList: maybeArray(options.participantRole),
 }), { endpointKey: "insight.summary.list", idField: "summaryId" }));
-summary.command("download").requiredOption("--summary-id <id>").option("--file-type <number>", "File type: 1=original(default) 2=HTML; only affects meeting platform summaries").option("--output <path>").action((options) => withClient(async (client) => {
-    const qp = { summaryId: options.summaryId };
-    if (options.fileType)
-        qp.fileType = parseNumberOption(options.fileType, "--file-type", { integer: true, min: 1 });
-    await runDownload(client, "insight.summary.download", qp, {
-        output: options.output,
-        fallbackName: `summary-${options.summaryId}`,
-        resolveOutputPath: (result) => resolveTitle(client, result, "insight.summary.list", "summaryId", options.summaryId),
-    });
-}));
+addDownloadCommand(summary, { endpointKey: "insight.summary.download", idOption: "--summary-id", idField: "summaryId", fallbackPrefix: "summary", fileType: { description: "File type: 1=original(default) 2=HTML; only affects meeting platform summaries" }, titleListEndpoint: "insight.summary.list" });
 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((options) => emit(options, (client) => client.call(endpointKey, {
     from: parseFrom(options.from), size: parseSize(options.size), startTime: options.startTime, endTime: options.endTime, keyword: options.keyword,
     researchAreaList: maybeArray(options.researchArea), institutionList: maybeArray(options.institution), securityList: maybeArray(options.security),
@@ -143,13 +168,7 @@ addTimeFilters(research.command("list").option("--search-type <number>", "Search
     ratingChangeList: maybeArray(options.ratingChange), minReportPages: parseOptionalNumberOption(options.minPages, "--min-pages", { integer: true, min: 0 }),
     maxReportPages: parseOptionalNumberOption(options.maxPages, "--max-pages", { integer: true, min: 0 }), sourceList: maybeArray(options.source),
 }), { 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((options) => withClient(async (client) => {
-    await runDownload(client, "insight.research.download", { reportId: options.reportId, fileType: parseNumberOption(options.fileType, "--file-type", { integer: true, min: 1 }) }, {
-        output: options.output,
-        fallbackName: `research-${options.reportId}`,
-        resolveOutputPath: (result) => resolveTitle(client, result, "insight.research.list", "reportId", options.reportId),
-    });
-}));
+addDownloadCommand(research, { endpointKey: "insight.research.download", idOption: "--report-id", idField: "reportId", fallbackPrefix: "research", fileType: { description: "File type: 1=PDF 2=Markdown", default: "1" }, titleListEndpoint: "insight.research.list" });
 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((options) => emit(options, (client) => client.call("insight.foreign-report.list", {
     from: parseFrom(options.from), size: parseSize(options.size), startTime: options.startTime, endTime: options.endTime, keyword: options.keyword,
     searchType: parseNumberOption(options.searchType, "--search-type", { integer: true, min: 1 }), rankType: parseNumberOption(options.rankType, "--rank-type", { integer: true, min: 1 }),
@@ -158,26 +177,14 @@ addTimeFilters(foreignReport.command("list").option("--search-type <number>", "S
     ratingList: maybeArray(options.rating), ratingChangeList: maybeArray(options.ratingChange),
     minReportPages: parseOptionalNumberOption(options.minPages, "--min-pages", { integer: true, min: 0 }), maxReportPages: parseOptionalNumberOption(options.maxPages, "--max-pages", { integer: true, min: 0 }),
 }), { 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((options) => withClient(async (client) => {
-    await runDownload(client, "insight.foreign-report.download", { reportId: options.reportId, fileType: parseNumberOption(options.fileType, "--file-type", { integer: true, min: 1 }) }, {
-        output: options.output,
-        fallbackName: `foreign-report-${options.reportId}`,
-        resolveOutputPath: (result) => resolveTitle(client, result, "insight.foreign-report.list", "reportId", options.reportId),
-    });
-}));
+addDownloadCommand(foreignReport, { endpointKey: "insight.foreign-report.download", idOption: "--report-id", idField: "reportId", fallbackPrefix: "foreign-report", fileType: { description: "File type: 1=PDF 2=Markdown 3=CN-PDF 4=CN-Markdown", default: "1" }, titleListEndpoint: "insight.foreign-report.list" });
 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((options) => emit(options, (client) => client.call("insight.announcement.list", {
     from: parseFrom(options.from), size: parseSize(options.size),
     startTime: parseTimestamp13(options.startTime, "--start-time"), endTime: parseTimestamp13(options.endTime, "--end-time"),
     searchType: parseNumberOption(options.searchType, "--search-type", { integer: true, min: 1 }), rankType: parseNumberOption(options.rankType, "--rank-type", { integer: true, min: 1 }), keyword: options.keyword,
     securityList: maybeArray(options.security), announcementTypeList: maybeArray(options.announcementType), categoryList: maybeArray(options.category),
 }), { 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((options) => withClient(async (client) => {
-    await runDownload(client, "insight.announcement.download", { announcementId: options.announcementId, fileType: parseNumberOption(options.fileType, "--file-type", { integer: true, min: 1 }) }, {
-        output: options.output,
-        fallbackName: `announcement-${options.announcementId}`,
-        resolveOutputPath: (result) => resolveTitle(client, result, "insight.announcement.list", "announcementId", options.announcementId),
-    });
-}));
+addDownloadCommand(announcement, { endpointKey: "insight.announcement.download", idOption: "--announcement-id", idField: "announcementId", fallbackPrefix: "announcement", fileType: { description: "File type: 1=PDF 2=Markdown", default: "1" }, titleListEndpoint: "insight.announcement.list" });
 addTimeFilters(announcementHk.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 (e.g. 01913.HK)", collectList, []).option("--category <id>", "Category ID", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>", "Output path")).action((options) => emit(options, (client) => client.call("insight.announcement-hk.list", {
     from: parseFrom(options.from), size: parseSize(options.size),
     startTime: options.startTime, endTime: options.endTime,
@@ -186,13 +193,7 @@ addTimeFilters(announcementHk.command("list").option("--search-type <number>", "
     keyword: options.keyword,
     securityList: maybeArray(options.security), categoryList: maybeArray(options.category),
 }), { endpointKey: "insight.announcement-hk.list", idField: "announcementId" }));
-announcementHk.command("download").requiredOption("--announcement-id <id>").option("--output <path>").action((options) => withClient(async (client) => {
-    await runDownload(client, "insight.announcement-hk.download", { announcementId: options.announcementId }, {
-        output: options.output,
-        fallbackName: `announcement-hk-${options.announcementId}`,
-        resolveOutputPath: (result) => resolveTitle(client, result, "insight.announcement-hk.list", "announcementId", options.announcementId),
-    });
-}));
+addDownloadCommand(announcementHk, { endpointKey: "insight.announcement-hk.download", idOption: "--announcement-id", idField: "announcementId", fallbackPrefix: "announcement-hk", titleListEndpoint: "insight.announcement-hk.list" });
 addTimeFilters(foreignOpinion.command("list").option("--rank-type <number>", "Rank type: 1=composite 2=time desc", "1").option("--security <code>", "Security code (e.g. UBER.N)", collectList, []).option("--region <code>", "Region code", collectList, []).option("--industry <id>", "Industry ID", collectList, []).option("--broker <id>", "Broker ID", collectList, []).option("--rating <name>", "Rating", collectList, []).option("--rating-change <name>", "Rating change", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>", "Output path")).action((options) => emit(options, (client) => client.call("insight.foreign-opinion.list", {
     from: parseFrom(options.from), size: parseSize(options.size),
     startTime: options.startTime, endTime: options.endTime,
@@ -210,12 +211,7 @@ addTimeFilters(independentOpinion.command("list").option("--rank-type <number>",
     industryList: maybeArray(options.industry), securityList: maybeArray(options.security),
     ratingList: maybeArray(options.rating), ratingChangeList: maybeArray(options.ratingChange),
 })));
-independentOpinion.command("download").requiredOption("--independent-opinion-id <id>").requiredOption("--file-type <number>", "File type: 1=original HTML 2=CN-translated HTML").option("--output <path>").action((options) => withClient(async (client) => {
-    await runDownload(client, "insight.independent-opinion.download", { independentOpinionId: options.independentOpinionId, fileType: parseNumberOption(options.fileType, "--file-type", { integer: true, min: 1 }) }, {
-        output: options.output,
-        fallbackName: `independent-opinion-${options.independentOpinionId}`,
-    });
-}));
+addDownloadCommand(independentOpinion, { endpointKey: "insight.independent-opinion.download", idOption: "--independent-opinion-id", idField: "independentOpinionId", fallbackPrefix: "independent-opinion", fileType: { description: "File type: 1=original HTML 2=CN-translated HTML", required: true } });
 insight.addCommand(opinion);
 insight.addCommand(summary);
 insight.addCommand(roadshow);
@@ -362,29 +358,11 @@ reference.command("securities-search").requiredOption("--keyword <text>", "Searc
 program.addCommand(reference);
 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((options) => emit(options, (client) => client.call("vault.drive.list", { from: parseFrom(options.from), size: parseSize(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 }), { endpointKey: "vault.drive.list", idField: "fileId" }));
-vault.command("drive-download").requiredOption("--file-id <id>").option("--output <path>").action((options) => withClient(async (client) => {
-    await runDownload(client, "vault.drive.download", { fileId: options.fileId }, {
-        output: options.output,
-        fallbackName: `file-${options.fileId}`,
-        resolveOutputPath: (result) => resolveTitle(client, result, "vault.drive.list", "fileId", options.fileId),
-    });
-}));
+addDownloadCommand(vault, { endpointKey: "vault.drive.download", name: "drive-download", idOption: "--file-id", idField: "fileId", fallbackPrefix: "file", titleListEndpoint: "vault.drive.list" });
 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((options) => emit(options, (client) => client.call("vault.record.list", { from: parseFrom(options.from), size: parseSize(options.size), startTime: options.startTime, endTime: options.endTime, keyword: options.keyword, categoryList: maybeArray(options.category), spaceTypeList: options.spaceType.length ? options.spaceType : undefined }), { 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((options) => withClient(async (client) => {
-    await runDownload(client, "vault.record.download", { recordId: options.recordId, contentType: options.contentType }, {
-        output: options.output,
-        fallbackName: `record-${options.recordId}`,
-        resolveOutputPath: (result) => resolveTitle(client, result, "vault.record.list", "recordId", options.recordId),
-    });
-}));
+addDownloadCommand(vault, { endpointKey: "vault.record.download", name: "record-download", idOption: "--record-id", idField: "recordId", fallbackPrefix: "record", contentTypeDescription: "Content type: original/asr/summary", titleListEndpoint: "vault.record.list" });
 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((options) => emit(options, (client) => client.call("vault.my-conference.list", { from: parseFrom(options.from), size: parseSize(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) }), { 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((options) => withClient(async (client) => {
-    await runDownload(client, "vault.my-conference.download", { conferenceId: options.conferenceId, contentType: options.contentType }, {
-        output: options.output,
-        fallbackName: `conference-${options.conferenceId}`,
-        resolveOutputPath: (result) => resolveTitle(client, result, "vault.my-conference.list", "conferenceId", options.conferenceId),
-    });
-}));
+addDownloadCommand(vault, { endpointKey: "vault.my-conference.download", name: "my-conference-download", idOption: "--conference-id", idField: "conferenceId", fallbackPrefix: "conference", contentTypeDescription: "Content type: asr/summary", titleListEndpoint: "vault.my-conference.list" });
 vault.command("wechat-message-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("--security <code>", "Security code (e.g. 000001.SZ)", collectList, []).option("--wechat-group-id <id>", "WeChat group ID", collectList, []).option("--industry <id>", "Industry ID", collectList, []).option("--category <name>", "Message type: text/image/documents/url", collectList, []).option("--tag <name>", "Tag: roadShow/research/strategyMeeting/meetingSummary/industryComment/companyComment/earningsReview", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action((options) => emit(options, (client) => client.call("vault.wechat-message.list", buildWechatMessageListBody(options))));
 vault.command("wechat-chatroom-list").option("--from <number>", "Starting offset", "0").option("--size <number>", "Rows to return", "20").option("--room-name <name>", "WeChat group name; repeat or comma-separate for multiple names", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action((options) => emit(options, (client) => client.call("vault.wechat-chatroom.list", buildWechatChatroomListBody(options))));
 vault.command("stock-pool-list").option("--format <format>", "Output format", "table").option("--output <path>").action((options) => emit(options, (client) => client.call("vault.stock-pool.list", {})));
@@ -412,6 +390,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/errors.js

@@ -21,6 +21,13 @@ const ERROR_HINTS = {
     "8000016": "开发账号状态异常。",
     "8000018": "开发账号已到期。",
     "903301": "今日调用次数已达上限。",
+    "410110": "异步内容生成中，稍后用对应 *-check 命令查询。",
+    "410111": "异步内容生成失败（终态），请更换参数后重新提交。",
+    "410004": "数据未找到，请检查查询条件。",
+    "430004": "下载失败（官方未文档化错误码），请确认 reportId 有效或更换 --file-type 重试。",
+    "430007": "行情查询超出限制，请缩短日期范围。",
+    "433007": "数据源不匹配，请检查 resourceType 与 sourceId 组合。",
+    "10011401": "白名单未开通，请联系管理员。",
 };
 export class ApiError extends CliError {
     code;

package/dist/src/version.js

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

package/package.json

@@ -1,17 +1,20 @@
 {
   "name": "gangtise-openapi-cli",
-  "version": "0.14.4",
+  "version": "0.15.1",
   "description": "CLI for Gangtise OpenAPI",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+ssh://git@github.com/gangtiser/gangtise-openapi-cli.git"
+    "url": "git+https://github.com/gangtiser/gangtise-openapi-cli.git"
   },
   "bugs": {
     "url": "https://github.com/gangtiser/gangtise-openapi-cli/issues"
   },
   "homepage": "https://github.com/gangtiser/gangtise-openapi-cli#readme",
   "type": "module",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
   "bin": {
     "gangtise": "dist/src/cli.js"
   },