gangtise-openapi-cli 0.15.1 → 0.17.0

package/README.md

@@ -4,6 +4,30 @@
 
 ## Changelog
 
+### v0.17.0 — 2026-06-15
+
+**接口变更（Breaking）**
+- 日程类命令（`roadshow` / `site-visit` / `strategy` / `forum` list）改为各自只暴露 API spec 支持的筛选选项，移除原先一刀切多出的无效选项：`strategy` 仅保留 `--institution` / `--location`；`forum` 仅保留 `--research-area` / `--location`；`site-visit` 移除 `--participant-role` / `--broker-type`；`roadshow` 移除 `--object`。传不支持的选项现由 commander 直接报 `unknown option`（此前会静默发送、服务端返回空结果）
+- `insight announcement list` 移除无效的 `--announcement-type`（服务端忽略、恒返全量）；A 股公告分类筛选用 `--category`（`aShareAnnouncementCategory` 常量 ID）
+
+**说明 / 修正**
+- `--industry` 用 `citicIndustry` 码（`1008001xx`，全命令通用）；`--research-area` 用 `gangtiseIndustry` 码（行业 `1008001xx` + 宏观/策略/固收/金工/海外等方向 `122000xxx`）。详见 `gangtise-openapi/references/commands/reference-and-lookup.md`
+- 日程类 `--location`（domesticCity）服务端过滤已生效（v0.16.0 时曾未生效）
+
+### 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；服务端过滤 v0.17.0 起已生效）
+
 ### v0.15.0 — 2026-05-29
 
 **新增接口**
@@ -135,7 +159,7 @@ 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 tag -a "v$VERSION" -m "v$VERSION"   # 必须 annotated：--follow-tags 不推 lightweight tag
 git push --follow-tags
 ```
 
@@ -235,7 +259,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` | 路演 |
@@ -249,6 +273,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线 |
@@ -302,19 +331,21 @@ 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 通用）
+gangtise reference constant-list --category gangtiseIndustry      # Gangtise 行业 + 方向（--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     # 会议机构（本地表）
 ```
 
 再调用业务命令：
 
 ```bash
-gangtise insight opinion list --industry 104710000
+gangtise insight opinion list --industry 100800128
 gangtise insight summary list --institution C100000017
 gangtise quote day-kline --security 600519.SH --start-date 2025-03-01 --end-date 2025-03-12
 gangtise ai knowledge-batch --query 比亚迪 --query 最近热门概念
@@ -388,10 +419,10 @@ gangtise auth status
 gangtise insight research list --start-time "2026-04-01 00:00:00" --end-time "2026-04-09 23:59:59"
 
 # 无时间范围 → 默认 --size 200
-gangtise insight research list --industry 104270000 --category company --llm-tag inDepth --rating buy
+gangtise insight research list --industry 100800126 --category company --llm-tag inDepth --rating buy
 
 # 多值 List 模式：一次查多家券商 + 多个行业 + 多个评级
-gangtise insight research list --broker C100000027 --broker C100000014 --industry 104340000 --industry 104370000 --rating buy --rating overweight --format json
+gangtise insight research list --broker C100000027 --broker C100000014 --industry 100800119 --industry 100800118 --rating buy --rating overweight --format json
 
 gangtise insight opinion list --keyword AI
 gangtise insight summary list --keyword 算力
@@ -421,7 +452,7 @@ gangtise insight foreign-opinion list --keyword "自动驾驶" --region us --ran
 gangtise insight foreign-opinion list --security APP.O --rating buy --format json
 
 # 外资独立观点
-gangtise insight independent-opinion list --keyword "肿瘤" --industry 104370000 --format json
+gangtise insight independent-opinion list --keyword "肿瘤" --industry 100800118 --format json
 gangtise insight independent-opinion download --independent-opinion-id 207051900018372 --file-type 2
 
 # 纪要下载（会议平台来源可选 HTML 格式）
@@ -436,6 +467,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
@@ -593,7 +637,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

@@ -108,21 +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");
+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("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");
@@ -150,16 +144,57 @@ addTimeFilters(summary.command("list").option("--search-type <number>", "Search
     categoryList: maybeArray(options.category), marketList: maybeArray(options.market), participantRoleList: maybeArray(options.participantRole),
 }), { endpointKey: "insight.summary.list", idField: "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),
-    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,
-})));
-addScheduleList(roadshow, "insight.roadshow.list");
-addScheduleList(siteVisit, "insight.site-visit.list");
-addScheduleList(strategy, "insight.strategy.list");
-addScheduleList(forum, "insight.forum.list");
+const addScheduleList = (command, endpointKey, fields) => {
+    const list = command.command("list");
+    if (fields.researchArea)
+        list.option("--research-area <id>", "Research area ID (constant-list category gangtiseIndustry: 1008001xx industries + 122000xxx macro/strategy/fixed-income/quant/overseas directions)", collectList, []);
+    if (fields.institution)
+        list.option("--institution <id>", "Lead institution ID", collectList, []);
+    if (fields.security)
+        list.option("--security <code>", "Security code", collectList, []);
+    if (fields.object)
+        list.option("--object <type>", "Object type: company/industry", collectList, []);
+    if (fields.category)
+        list.option("--category <name>", fields.category, collectList, []);
+    if (fields.market)
+        list.option("--market <name>", fields.market, collectList, []);
+    if (fields.participantRole)
+        list.option("--participant-role <name>", "Participant role: management/expert", collectList, []);
+    if (fields.brokerType)
+        list.option("--broker-type <name>", "Lead broker type: cnBroker/otherBroker", collectList, []);
+    if (fields.permission)
+        list.option("--permission <number>", "Permission: 1=public 2=private", collectNumberList, []);
+    if (fields.location)
+        list.option("--location <id>", "Location ID (domesticCity constant, via 'reference constant-list')", collectList, []);
+    list.option("--format <format>", "Output format", "table").option("--output <path>", "Output path");
+    addTimeFilters(list).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: fields.researchArea ? maybeArray(options.researchArea) : undefined,
+        institutionList: fields.institution ? maybeArray(options.institution) : undefined,
+        securityList: fields.security ? maybeArray(options.security) : undefined,
+        objectList: fields.object ? maybeArray(options.object) : undefined,
+        categoryList: fields.category ? maybeArray(options.category) : undefined,
+        marketList: fields.market ? maybeArray(options.market) : undefined,
+        participantRoleList: fields.participantRole ? maybeArray(options.participantRole) : undefined,
+        brokerTypeList: fields.brokerType ? maybeArray(options.brokerType) : undefined,
+        permission: fields.permission && options.permission?.length ? options.permission : undefined,
+        locationList: fields.location ? maybeArray(options.location) : undefined,
+    })));
+};
+addScheduleList(roadshow, "insight.roadshow.list", {
+    researchArea: true, institution: true, security: true, location: true,
+    category: "Roadshow type: earningsCall/strategyMeeting/companyAnalysis/industryAnalysis/fundRoadshow",
+    market: "Market: aShares/hkStocks/usChinaConcept/usStocks",
+    participantRole: true, brokerType: true, permission: true,
+});
+addScheduleList(siteVisit, "insight.site-visit.list", {
+    researchArea: true, institution: true, security: true, location: true, object: true,
+    category: "Site-visit form: single/series",
+    market: "Market: aShares/hkStocks/usChinaConcept",
+    permission: true,
+});
+addScheduleList(strategy, "insight.strategy.list", { institution: true, location: true });
+addScheduleList(forum, "insight.forum.list", { researchArea: true, location: true });
 addTimeFilters(research.command("list").option("--search-type <number>", "Search type: 1=title 2=fulltext", "1").option("--rank-type <number>", "Rank type: 1=composite 2=time desc", "1").option("--broker <id>", "Broker ID", collectList, []).option("--security <code>", "Security code", collectList, []).option("--industry <id>", "Industry ID", collectList, []).option("--category <name>", "Report category", collectList, []).option("--llm-tag <tag>", "Semantic tag", collectList, []).option("--rating <name>", "Rating", collectList, []).option("--rating-change <name>", "Rating change", collectList, []).option("--min-pages <number>", "Min report pages").option("--max-pages <number>", "Max report pages").option("--source <type>", "Source type", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>", "Output path")).action((options) => emit(options, (client) => client.call("insight.research.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 }),
@@ -178,11 +213,11 @@ addTimeFilters(foreignReport.command("list").option("--search-type <number>", "S
     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" }));
 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", {
+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("--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),
+    securityList: maybeArray(options.security), categoryList: maybeArray(options.category),
 }), { endpointKey: "insight.announcement.list", idField: "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", {
@@ -302,7 +337,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 });
 }));
@@ -355,6 +390,17 @@ 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" }));
@@ -390,8 +436,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/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.1";
+export const CLI_VERSION = "0.17.0";

package/package.json

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