gangtise-openapi-cli 0.15.0 → 0.16.0

package/README.md

@@ -4,6 +4,20 @@
 
 ## Changelog
 
+### v0.16.0 — 2026-06-12
+
+**新增接口（参考数据 · 常量查询，均免积分）**
+- `reference constant-category` — 查询常量分类：全量导出常量分类及各分类适用于哪些接口的哪些参数（7 个分类：中信/申万/Gangtise 行业、国内城市、A股/港股公告分类、区域）
+- `reference constant-list --category <code>` — 查询常量值：按分类导出全量常量（`constantId` / `constantName`，树形分类含 `children` 嵌套）
+- `reference concept-search --keyword <kw>` — 查询题材 ID：按名称/拼音/分组名搜索，返回 `conceptId`（供 `alternative concept-info / concept-securities`、`ai theme-tracking` 使用）
+- `reference sector-search --keyword <kw>` — 查询板块 ID：返回 `sectorId` + `hierarchy` 层级路径
+- `reference sector-constituents --sector-id <id>` — 查询板块成分股：返回该板块全量成分股（`gtsCode` / `gtsName`）；注意 sectorId 必须来自 sector-search，题材 conceptId 查不到成分
+
+**接口变更（Breaking）**
+- 移除已被新 API 覆盖的 6 个本地 lookup 子命令及静态数据：`lookup research-area / industry / region / announcement-category / theme-id / industry-code list`，请改用 `reference constant-list` / `reference concept-search` / `reference sector-constituents`（申万行业代码 `821xxx.SWI` 全量：`sector-constituents --sector-id 2000000014`，即申万一级行业指数板块）
+- `lookup` 仅保留 2 个 API 未覆盖的本地表：`broker-org` / `meeting-org`
+- 路演/调研/策略会/论坛 list 新增 `--location <id>` 按城市过滤（domesticCity 常量 ID；实测 2026-06-12 服务端过滤暂未生效）
+
 ### v0.15.0 — 2026-05-29
 
 **新增接口**
@@ -125,6 +139,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 -a "v$VERSION" -m "v$VERSION"   # 必须 annotated：--follow-tags 不推 lightweight tag
+git push --follow-tags
+```
+
+推送 `v*` tag 后，`.github/workflows/publish.yml` 会在 GitHub-hosted runner 上使用 OIDC 发布到 `https://registry.npmjs.org/`。也可以从 GitHub Actions 页面手动运行该 workflow。
+
 ## 版本更新
 
 查看当前版本（自动与线上版本比对）：
@@ -219,7 +249,7 @@ cp -r gangtise-openapi ~/.hermes/skills/gangtise-openapi
 | 模块 | 子命令 | 说明 |
 |------|--------|------|
 | **Auth** | `login` / `status` | 认证登录、状态查询 |
-| **Lookup** | `research-area list` / `broker-org list` / `meeting-org list` / `industry list` / `industry-code list` / `region list` / `announcement-category list` / `theme-id list` | 枚举速查（内置，无需额外文档） |
+| **Lookup** | `broker-org list` / `meeting-org list` | 本地枚举表（API 未覆盖的部分；行业/区域/公告分类/题材/申万行业代码改用 Reference 接口） |
 | **Insight** | `opinion list` | 内资机构观点 |
 | | `summary list` / `download` | 纪要（含下载，支持 `--file-type` 选原始/HTML） |
 | | `roadshow list` | 路演 |
@@ -233,6 +263,11 @@ cp -r gangtise-openapi ~/.hermes/skills/gangtise-openapi
 | | `foreign-opinion list` | 外资机构观点 |
 | | `independent-opinion list` / `download` | 外资独立分析师观点（含原文/翻译HTML下载） |
 | **Reference** | `securities-search` | GTS Code 搜索（按名称/代码/拼音匹配） |
+| | `constant-category` | 常量分类列表（含各分类适用的接口与参数） |
+| | `constant-list` | 按分类导出常量值全量列表（行业/城市/公告分类/区域等） |
+| | `concept-search` | 题材 ID 搜索（名称/拼音/分组名匹配） |
+| | `sector-search` | 板块 ID 搜索（返回层级路径） |
+| | `sector-constituents` | 板块成分股查询 |
 | **Quote** | `day-kline` / `day-kline-hk` / `day-kline-us` | A股/港股/美股历史日K线 |
 | | `index-day-kline` | 沪深京指数日K线 |
 | | `minute-kline` | A股分钟K线 |
@@ -286,13 +321,14 @@ cp -r gangtise-openapi ~/.hermes/skills/gangtise-openapi
 先查枚举/参数：
 
 ```bash
-gangtise lookup research-area list
-gangtise lookup broker-org list
-gangtise lookup meeting-org list
-gangtise lookup industry list
-gangtise lookup region list              # 外资研报区域
-gangtise lookup announcement-category list  # 公告分类
-gangtise lookup industry-code list   # 申万行业代码（用于 security-clue --gts-code）
+gangtise reference constant-category                              # 有哪些常量分类、各用于哪些参数
+gangtise reference constant-list --category citicIndustry         # 中信行业（--industry / --research-area）
+gangtise reference constant-list --category swIndustry            # 申万行业
+gangtise reference constant-list --category regionCategory        # 外资研报区域
+gangtise reference constant-list --category aShareAnnouncementCategory  # A股公告分类（树形）
+gangtise reference sector-constituents --sector-id 2000000014   # 申万行业代码 821xxx.SWI 全量（security-clue --gts-code 用）
+gangtise lookup broker-org list      # 券商机构（本地表）
+gangtise lookup meeting-org list     # 会议机构（本地表）
 ```
 
 再调用业务命令：
@@ -420,6 +456,19 @@ gangtise reference securities-search --keyword "贵州茅台" --category stock
 gangtise reference securities-search --keyword "600519" --category stock
 gangtise reference securities-search --keyword gzmt --top 5
 gangtise reference securities-search --keyword "银行" --category stock --category index
+
+# 常量查询：先看分类，再按分类导出全量常量值
+gangtise reference constant-category --format json
+gangtise reference constant-list --category citicIndustry --format json
+gangtise reference constant-list --category aShareAnnouncementCategory --format json   # 树形，含 children
+
+# 题材 ID 搜索（供 concept-info / concept-securities / theme-tracking 使用）
+gangtise reference concept-search --keyword 机器人 --top 3 --format json
+gangtise reference concept-search --keyword jqr   # 拼音首字母
+
+# 板块：先搜板块 ID，再查成分股（sectorId 必须来自 sector-search）
+gangtise reference sector-search --keyword 半导体设备 --format json
+gangtise reference sector-constituents --sector-id 1000001005 --format json
 ```
 
 ### Quote
@@ -577,7 +626,7 @@ gangtise alternative edb-data \
   --output ./indicator.csv
 
 # 题材指数：先查 conceptId（与 theme-id 共用 ID 体系），再拉画像 / 成分股
-gangtise lookup theme-id list | grep 机器人        # → 121000130
+gangtise reference concept-search --keyword 机器人 --format json   # → 121000130
 gangtise alternative concept-info --concept-id 121000130 --format json
 # 题材成分股（题材深度 F8，按分组返回，标记重点个股）
 gangtise alternative concept-securities --concept-id 121000130 --format json

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")
@@ -79,16 +108,15 @@ program
     const cache = await readTokenCache(config.tokenCachePath);
     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 lookup = new Command("lookup").description("Local lookup tables (IDs not covered by 'reference constant-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("broker-org", "lookup.broker-orgs.list");
+addLookupList("meeting-org", "lookup.meeting-orgs.list");
 program.addCommand(lookup);
 const insight = new Command("insight").description("Insight APIs");
 const opinion = new Command("opinion");
@@ -115,21 +143,13 @@ 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),
-    });
-}));
-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, {
+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("--location <id>", "Location ID (domesticCity constant, via 'reference constant-list')", collectList, []).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),
     categoryList: maybeArray(options.category), marketList: maybeArray(options.market), participantRoleList: maybeArray(options.participantRole),
     brokerTypeList: maybeArray(options.brokerType), objectList: maybeArray(options.object), permission: options.permission.length ? options.permission : undefined,
+    locationList: maybeArray(options.location),
 })));
 addScheduleList(roadshow, "insight.roadshow.list");
 addScheduleList(siteVisit, "insight.site-visit.list");
@@ -143,13 +163,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 +172,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 +188,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 +206,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);
@@ -306,7 +297,7 @@ ai.command("earnings-review").requiredOption("--security-code <code>").requiredO
     }
 }));
 ai.command("earnings-review-check").requiredOption("--data-id <id>", "dataId from earnings-review").option("--format <format>", "Output format", "json").option("--output <path>").action((options) => withClient((client) => checkAsyncContent(client, "ai.earnings-review.get-content", options.dataId, parseOutputFormat(options.format), options.output)));
-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((options) => emit(options, (client) => {
+ai.command("theme-tracking").requiredOption("--theme-id <id>", "Theme ID (use 'reference concept-search')").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((options) => emit(options, (client) => {
     const typeList = options.type.length ? options.type : undefined;
     return client.call("ai.theme-tracking", { themeId: options.themeId, date: options.date, type: typeList });
 }));
@@ -359,32 +350,25 @@ reference.command("securities-search").requiredOption("--keyword <text>", "Searc
     category: options.category.length ? options.category : undefined,
     top: parseNumberOption(options.top, "--top", { integer: true, min: 1 }),
 })));
+reference.command("constant-category").description("List constant categories and which API params accept them").option("--format <format>", "Output format", "table").option("--output <path>").action((options) => emit(options, (client) => client.call("reference.constant-category")));
+reference.command("constant-list").requiredOption("--category <code>", "Category code from 'reference constant-category' (e.g. citicIndustry/swIndustry/regionCategory)").option("--format <format>", "Output format", "table").option("--output <path>").action((options) => emit(options, (client) => client.call("reference.constant-list", { category: options.category })));
+reference.command("concept-search").requiredOption("--keyword <text>", "Search keyword (name/pinyin/group name)").option("--top <number>", "Max results (default: 10, max: 10)", "10").option("--format <format>", "Output format", "table").option("--output <path>").action((options) => emit(options, (client) => client.call("reference.concept-search", {
+    keyword: options.keyword,
+    top: parseNumberOption(options.top, "--top", { integer: true, min: 1 }),
+})));
+reference.command("sector-search").option("--keyword <text>", "Search keyword (name/pinyin)").option("--top <number>", "Max results (default: 10, max: 10)", "10").option("--format <format>", "Output format", "table").option("--output <path>").action((options) => emit(options, (client) => client.call("reference.sector-search", {
+    keyword: options.keyword,
+    top: parseNumberOption(options.top, "--top", { integer: true, min: 1 }),
+})));
+reference.command("sector-constituents").requiredOption("--sector-id <id>", "Sector ID from 'reference sector-search'").option("--format <format>", "Output format", "table").option("--output <path>").action((options) => emit(options, (client) => client.call("reference.sector-constituents", { sectorId: options.sectorId })));
 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,8 +396,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 })));
+alternative.command("concept-info").requiredOption("--concept-id <id>", "Concept (theme index) ID, e.g. 121000130 机器人; discover via 'gangtise reference concept-search'").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 reference concept-search'").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/client.js

@@ -101,14 +101,8 @@ export class GangtiseClient {
     }
     async readLocalLookup(endpoint) {
         const keyMapping = {
-            "lookup.research-areas.list": "research-areas",
             "lookup.broker-orgs.list": "broker-orgs",
             "lookup.meeting-orgs.list": "meeting-orgs",
-            "lookup.industries.list": "industries",
-            "lookup.regions.list": "regions",
-            "lookup.announcement-categories.list": "announcement-categories",
-            "lookup.industry-codes.list": "industry-codes",
-            "lookup.theme-ids.list": "theme-ids",
         };
         const lookupKey = keyMapping[endpoint.key];
         if (lookupKey) {

package/dist/src/core/endpoints.js

@@ -8,13 +8,6 @@ export const ENDPOINTS = {
         description: "Get access token",
     },
     // ─── lookup (served from local data, not HTTP) ───
-    "lookup.research-areas.list": {
-        key: "lookup.research-areas.list",
-        method: "GET",
-        path: "/guide/research-area-local",
-        kind: "json",
-        description: "List research areas from local docs",
-    },
     "lookup.broker-orgs.list": {
         key: "lookup.broker-orgs.list",
         method: "GET",
@@ -29,41 +22,6 @@ export const ENDPOINTS = {
         kind: "json",
         description: "List meeting orgs from local docs",
     },
-    "lookup.industries.list": {
-        key: "lookup.industries.list",
-        method: "GET",
-        path: "/guide/industries-local",
-        kind: "json",
-        description: "List industries from local docs",
-    },
-    "lookup.regions.list": {
-        key: "lookup.regions.list",
-        method: "GET",
-        path: "/guide/regions-local",
-        kind: "json",
-        description: "List regions from local docs",
-    },
-    "lookup.announcement-categories.list": {
-        key: "lookup.announcement-categories.list",
-        method: "GET",
-        path: "/guide/announcement-categories-local",
-        kind: "json",
-        description: "List announcement categories from local docs",
-    },
-    "lookup.industry-codes.list": {
-        key: "lookup.industry-codes.list",
-        method: "GET",
-        path: "/guide/industry-codes-local",
-        kind: "json",
-        description: "List Shenwan industry codes from local docs",
-    },
-    "lookup.theme-ids.list": {
-        key: "lookup.theme-ids.list",
-        method: "GET",
-        path: "/guide/theme-ids-local",
-        kind: "json",
-        description: "List theme IDs from local docs",
-    },
     // ─── insight ───
     "insight.opinion.list": {
         key: "insight.opinion.list",
@@ -211,6 +169,41 @@ export const ENDPOINTS = {
         kind: "json",
         description: "Search GTS codes (securities)",
     },
+    "reference.constant-category": {
+        key: "reference.constant-category",
+        method: "GET",
+        path: "/application/open-reference/constants/category",
+        kind: "json",
+        description: "List constant categories and their API usage scopes",
+    },
+    "reference.constant-list": {
+        key: "reference.constant-list",
+        method: "POST",
+        path: "/application/open-reference/constants/getList",
+        kind: "json",
+        description: "List all constant values of a category",
+    },
+    "reference.concept-search": {
+        key: "reference.concept-search",
+        method: "POST",
+        path: "/application/open-reference/concepts/search",
+        kind: "json",
+        description: "Search concept (theme) IDs by keyword",
+    },
+    "reference.sector-search": {
+        key: "reference.sector-search",
+        method: "POST",
+        path: "/application/open-reference/sectors/search",
+        kind: "json",
+        description: "Search sector IDs by keyword",
+    },
+    "reference.sector-constituents": {
+        key: "reference.sector-constituents",
+        method: "POST",
+        path: "/application/open-reference/sectors/constituents",
+        kind: "json",
+        description: "List constituent securities of a sector",
+    },
     // ─── quote ───
     "quote.day-kline": {
         key: "quote.day-kline",

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/core/lookupData/index.js

@@ -1,13 +1,7 @@
 const cache = new Map();
 const loaders = {
-    "research-areas": () => import("./research-areas.js"),
     "broker-orgs": () => import("./broker-orgs.js"),
     "meeting-orgs": () => import("./meeting-orgs.js"),
-    "industries": () => import("./industries.js"),
-    "regions": () => import("./regions.js"),
-    "announcement-categories": () => import("./announcement-categories.js"),
-    "industry-codes": () => import("./industry-codes.js"),
-    "theme-ids": () => import("./theme-ids.js"),
 };
 export async function getLookupData(key) {
     if (cache.has(key))

package/dist/src/core/normalize.js

@@ -29,5 +29,10 @@ export function normalizeRows(value) {
         const hasMeta = Object.keys(meta).length > 0;
         return hasMeta ? { ...meta, list: chatRoomList } : chatRoomList;
     }
+    if (Array.isArray(record.constants)) {
+        const { constants, ...meta } = record;
+        const hasMeta = Object.keys(meta).length > 0;
+        return hasMeta ? { ...meta, list: constants } : constants;
+    }
     return value;
 }

package/dist/src/version.js

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

package/package.json

@@ -1,17 +1,20 @@
 {
   "name": "gangtise-openapi-cli",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "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"
   },