gangtise-openapi-cli 0.15.1 → 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
 
 **新增接口**
@@ -135,7 +149,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 +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` | 路演 |
@@ -249,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线 |
@@ -302,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     # 会议机构（本地表）
 ```
 
 再调用业务命令：
@@ -436,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
@@ -593,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

@@ -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,11 +144,12 @@ 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, {
+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");
@@ -302,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 });
 }));
@@ -355,6 +350,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 +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/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.16.0";

package/package.json

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