gangtise-openapi-cli 0.22.0 → 0.23.0

package/README.md

@@ -4,6 +4,51 @@
 
 ## Changelog
 
+### v0.23.0 — 2026-07-05
+
+**行为变更（注意）**
+- ⚠️ 默认 API 域名迁移：`https://open.gangtise.com` → `https://openapi.gangtise.com`。旧域名仍可用，CLI 只是切换了默认值（新旧域名多接口实测等价）；如需固定旧域名设 `GANGTISE_BASE_URL=https://open.gangtise.com`
+- `vault wechat-chatroom-list`：服务端接口改版为返回 `{ total, list }`（此前无 `total`、列名 `chatRoomList`）。CLI 相应改为按 `total` 并发翻页（不再串行翻页）；省略 `--size` 仍拉全量、传 `--size N` 取前 N 条，`Total:` 提示恢复
+- 无翻页的行情端点（`quote fund-flow` / `minute-kline` / 显式多标的的日 K：`day-kline`·`-hk`·`-us`·`index-day-kline`）返回行数撞上单次 `--limit` 时标 `partial`（退出码 3）+ stderr 警告，避免被静默截断；`--limit` 现本地校验 ≤ 10000（撞服务端上限也不漏标）。K 线 `--security all` 仍走日期分片自动补全，不受影响
+
+**新增**
+- `quote fund-flow` — A股个股日资金流向（沪深京），含小/中/大/特大单流入流出金额及占比、主力净流入等字段；`--security`（或 `aShares` 全市场）、`--start-date` / `--end-date`、`--limit`（默认 6000，上限 10000）、`--field` 指定返回字段；无积分消耗（单只证券无翻页，撞 `--limit` 时的截断处理见上「行为变更」；**`aShares` 全市场须显式传 `--start-date`/`--end-date`，CLI 按日自动分片并发合并——缺日期会本地报错**）
+- `reference institution-search` — 机构 ID 搜索，输入机构名/简称返回 `institutionId` 及适用接口参数（`usageScopes`）；`--keyword`（必填）、`--category`（`domesticBroker`/`foreignInstitution`/`leadInstitution`/`opinionInstitution`/`foreignOpinionInstitution`，可重复）、`--top`（默认 10，上限 10）；免费。覆盖既有 `--broker`/`--institution` 全部机构类（research/foreign-report/opinion/foreign-opinion/summary/roadshow/site-visit/strategy/my-conference）
+- `vault my-conference-list` 新增 `--source` — 按录制来源筛选（`1`=企微会议助理 `2`=会议服务微信群，可重复；不传返回全部）
+
+### v0.22.1 — 2026-07-03
+
+**修复**
+- 错误码 `410004` 提示改为中性措辞「数据未找到或无指标权限，请检查查询条件与指标权限」——此前只说"数据未找到"，与 `indicator` 内层信封的"无权限"消息拼接后自相矛盾
+
+**文档 / Skill**（随 `/sync-skill` 分发，不影响 CLI 行为）
+- gangtise-openapi Agent Skill 经 fable5 审计 + 多轮 review 优化：官方积分计费速查表 + 高积分 pre-flight 闸门、AI 同步生成命令 `GANGTISE_TIMEOUT_MS=120000` 超时前置、大结果集 `--output` 落盘、异步 `--wait` 主路径、行业码口径收敛到单一权威、市值量纲实测（`qte_mkt_cptl` 仅 A 股 / 默认原始「元」/ `scale`+`currency`）等文档补全与消歧
+
+### v0.22.0 — 2026-07-02
+
+**行为变更（注意）**
+- ⚠️ 自动翻页接口省略 `--size` 现在一律拉全量（不再区分是否传时间范围）；需要只取前 N 条时请显式传 `--size N`。数据量未知时可先用 `--size 1` 从 stderr 的 `Total: N` 探明量级
+- 部分结果可机器识别：翻页页失败、K 线分片失败、或服务端提前短页但仍报告更大 `total` 时，结果会带 `partial: true`（页失败另有 `failedPages`，分片为 `failedShards`），非 json 行式输出仍只输出数据行，但进程退出码为 3
+
+**修复（鉴权 / 请求可靠性）**
+- Token 自愈覆盖服务端 `0000001008` 踢线失效，并能处理 HTTP 4xx 错误信封；`GANGTISE_TOKEN` + AK/SK 场景下环境 token 失效后不再反复回放旧 token
+- 并发请求同时遇到旧 token 失效时复用一次刷新结果；若刚拿到的新 token 本身被踢掉，则强制再次登录，避免"刚登录窗口期"误跳过刷新
+- 自动重试范围扩展到 429、DNS/网络临时错误与 undici 超时类错误；`GANGTISE_BASE_URL` 带路径前缀时 URL 拼接不再丢前缀
+
+**修复（下载 / 输出 / 数据正确性）**
+- 下载接口跟随最多 3 次 30x 跳转；跨域跳到对象存储签名 URL 时不携带 Authorization；服务端返回 `{url}` 且用户传 `--output` 时会真正下载文件，而不是把 URL 字符串写进文件
+- 自动文件名补齐清洗、截断与去重：服务端文件名、标题缓存名和 fallback 名都不会把 `/`、控制字符、过长中文名或重复标题变成路径/覆盖问题
+- `table`/`markdown` 输出清理控制字符、正确按 CJK 宽字符对齐，并转义 markdown 表头中的 `|`；CSV 输出转义表头、文件输出带 UTF-8 BOM，流式 CSV 遇全标量列表时回退到正常渲染而不是只写 BOM
+- `indicator search` / `cross-section` / `time-series` 的内层失败信封即使没有 `data` 字段也会抛出 `ApiError`，不再把"无权限/参数错误"渲染成成功结果
+- `--indicator-param` 等逗号列表支持全角逗号 `，`；日期型时间参数按本地零点解析，避免 `yyyy-MM-dd` 被当作 UTC 造成查询窗口偏移
+- `fundamental earning-forecast` 省略 `--start-date` 时按传入的 `--end-date` 往前一年计算，不再总是按今天往前一年
+- AI 异步 `--wait` 对 `410111` 终态失败只提示"不要重试"，超时才提示稍后用 check 命令查询；等待说明同步为最长约 5 分钟
+
+**CLI / 工程**
+- `raw call` 会在本地拒绝 JSON endpoint 的 `--query` 和 download endpoint 的 `--body`，避免静默丢参数；`--format` 在发请求前校验，格式拼错不再先消耗接口调用
+- `gangtise ... | head` 遇 stdout `EPIPE` 时安静退出；只有首个参数是 `--version` / `-V` 时才触发版本快捷路径
+- Endpoint registry 的 `key` 改为由记录键自动派生，减少映射漂移；新增真实 CLI 选项到请求体的 stub 测试；测试 272 → 323
+
 ### v0.21.0 — 2026-06-29
 
 **行为变更（注意）**
@@ -116,7 +161,7 @@ npm run dev -- --help
 ```bash
 export GANGTISE_ACCESS_KEY="your-ak"
 export GANGTISE_SECRET_KEY="your-sk"
-export GANGTISE_BASE_URL="https://open.gangtise.com"
+export GANGTISE_BASE_URL="https://openapi.gangtise.com"
 export GANGTISE_TOKEN="Bearer xxx"
 
 # 性能/调试可选项
@@ -194,7 +239,7 @@ cp -r gangtise-openapi ~/.hermes/skills/gangtise-openapi
 | 模块 | 子命令 | 说明 |
 |------|--------|------|
 | **Auth** | `login` / `status` | 认证登录、状态查询 |
-| **Lookup** | `broker-org list` / `meeting-org list` | 本地枚举表（API 未覆盖的部分；行业/区域/公告分类/题材/申万行业代码改用 Reference 接口） |
+| **Lookup** | `broker-org list` / `meeting-org list` | 券商/会议机构本地全量枚举表（按名称找 ID 优先 `reference institution-search`；行业/区域/公告分类/题材/申万码已改用 Reference 接口） |
 | **Insight** | `opinion list` | 内资机构观点 |
 | | `summary list` / `download` | 纪要（含下载，支持 `--file-type` 选原始/HTML） |
 | | `roadshow list` | 路演 |
@@ -211,6 +256,7 @@ cp -r gangtise-openapi ~/.hermes/skills/gangtise-openapi
 | | `official-account list` / `download` | 产业公众号资讯（含 txt/HTML 下载） |
 | **Reference** | `securities-search` | GTS Code 搜索（按名称/代码/拼音匹配） |
 | | `chiefs-search` | 首席分析师 ID 搜索（按姓名/机构/团队匹配） |
+| | `institution-search` | 机构 ID 搜索（内资券商/外资/牵头/观点机构，按名称匹配） |
 | | `constant-category` | 常量分类列表（含各分类适用的接口与参数） |
 | | `constant-list` | 按分类导出常量值全量列表（行业/城市/公告分类/区域等） |
 | | `concept-search` | 题材 ID 搜索（名称/拼音/分组名匹配） |
@@ -220,6 +266,7 @@ cp -r gangtise-openapi ~/.hermes/skills/gangtise-openapi
 | | `index-day-kline` | 沪深京指数日K线 |
 | | `minute-kline` | A股分钟K线 |
 | | `realtime` | 个股实时行情快照（A股/港股/美股） |
+| | `fund-flow` | A股个股日资金流向（沪深京；小/中/大/特大单 + 主力净流入） |
 | **Fundamental** | `income-statement` / `balance-sheet` / `cash-flow` | A股三大财务报表（累计） |
 | | `income-statement-quarterly` / `cash-flow-quarterly` | A股利润表/现金流量表（单季度） |
 | | `income-statement-hk` / `balance-sheet-hk` / `cash-flow-hk` | 港股三大财务报表（中国会计准则） |
@@ -329,7 +376,7 @@ gangtise ai knowledge-batch --query 比亚迪 --query 最近热门概念
 - `vault record-list`
 - `vault my-conference-list`
 - `vault wechat-message-list`
-- `vault wechat-chatroom-list`（特例：接口无 `total`，CLI 串行翻页）
+- `vault wechat-chatroom-list`
 - `ai hot-topic`
 
 规则：
@@ -340,7 +387,6 @@ gangtise ai knowledge-batch --query 比亚迪 --query 最近热门概念
 - 安全上限：自动翻页最多 1000 页，防止异常循环
 - 部分页失败、或服务端实际返回行数与 `total` 矛盾（提前短页）时，不丢弃已取到的数据：结果带 `partial: true`（页失败时另有 `failedPages`；K线分片为 `failedShards`；`--format json` 可见），stderr 输出警告，**进程退出码为 3**（完整成功为 0）
 - 分页结果中 `total` 字段会被保留（json 格式输出 `{total, list}`）；其他格式下 stderr 输出 `Total: N, showing: M`（json 格式不输出该行）
-- `vault wechat-chatroom-list` 是特例：接口不返回 `total`，CLI 改为串行翻页——省略 `--size` 拉全量、传 `--size N` 取前 N 条，单页 50，无 `Total:` 提示
 
 ## 智能文件命名
 
@@ -429,6 +475,8 @@ gangtise reference securities-search --keyword "银行" --category stock --categ
 # 首席分析师 ID 搜索（按姓名/机构/团队；拿 chiefId 供 insight opinion list --chief 使用）
 gangtise reference chiefs-search --keyword 东吴证券 --top 3 --format json
 gangtise reference chiefs-search --keyword 芦哲 --format json
+# 机构 ID 搜索（--category: domesticBroker/foreignInstitution/leadInstitution/opinionInstitution）
+gangtise reference institution-search --keyword 招商证券 --category domesticBroker --top 3 --format json
 
 # 常量查询：先看分类，再按分类导出全量常量值
 gangtise reference constant-category --format json
@@ -469,6 +517,8 @@ gangtise quote minute-kline --security 600519.SH --start-time "2026-04-15 09:30:
 gangtise quote realtime --security 600519.SH --security 00700.HK --security AAPL.O --field securityCode --field tradeTime --field latestPrice --field pctChange --field volume --format json
 # 实时行情：全市场批量（建议配合 --field 精简字段）
 gangtise quote realtime --security aShares --field securityCode --field latestPrice --field pctChange --field volume --format json
+# A股个股日资金流向（沪深京；--security aShares 全市场；--limit 上限 10000，超限缩短日期区间分批）
+gangtise quote fund-flow --security 600519.SH --security 000001.SZ --start-date 2026-06-01 --end-date 2026-06-05 --field mainNetInflow --field largeInflow --field xlargeInflow --format json
 ```
 
 > **历史 vs 实时**：`day-kline*` 仅返回历史数据（当日数据入库时间：A 股 ~15:30 / 港股 ~16:30 / 美股 ~07:00 北京时间）。盘中需要最新成交价、振幅等实时字段必须走 `quote realtime`。
@@ -565,8 +615,9 @@ gangtise vault record-list --keyword 晨会 --category upload --category mobile
 # 录音速记下载（--content-type: original/asr/summary）
 gangtise vault record-download --record-id 49412 --content-type summary
 
-# 我的会议列表
+# 我的会议列表（--source 录制来源：1=企微会议助理 2=会议服务微信群，可重复；不传返回全部）
 gangtise vault my-conference-list --keyword AI --category earningsCall --institution C100000027
+gangtise vault my-conference-list --source 2 --category earningsCall --size 20
 # 我的会议下载（--content-type: asr/summary）
 gangtise vault my-conference-download --conference-id 43319 --content-type asr
 

package/dist/src/cli.js

@@ -5,7 +5,7 @@ import { readTokenCache, redactTokenCache } from "./core/auth.js";
 import { collectKeyValue, collectList, collectNumberList, maybeArray, parseFrom, parseNumberOption, parseOptionalNumberOption, parseSize, parseTimestamp13 } from "./core/args.js";
 import { buildIndicatorCrossSectionBody, buildIndicatorTimeSeriesBody, buildQuoteKlineBody, buildStockPoolStocksBody, buildWechatChatroomListBody, buildWechatMessageListBody } from "./core/commandBodies.js";
 import { flattenCrossSection, flattenTimeSeries, unwrapIndicatorData } from "./core/indicatorMatrix.js";
-import { callKlineWithSharding } from "./core/quoteSharding.js";
+import { callKlineWithSharding, isAllMarket, isFullMarket } from "./core/quoteSharding.js";
 import { loadConfig } from "./core/config.js";
 import { resolveTitle, saveDownloadResult, uniquePath } from "./core/download.js";
 import { ENDPOINTS } from "./core/endpoints.js";
@@ -35,6 +35,33 @@ async function emit(options, produce, cache) {
 async function withClient(fn) {
     await fn(await createClient());
 }
+/**
+ * Server-side default row cap shared by the limit-capped, non-paginated quote endpoints
+ * (fund-flow, minute-kline, day/index kline — all default to 6000 per the API docs). We
+ * send it EXPLICITLY when `--limit` is omitted (rather than letting the server apply its
+ * own default) so the request limit and the truncation `cap` below are always the same
+ * number — never a guess about the server's default that can drift out of sync.
+ */
+const DEFAULT_QUOTE_LIMIT = 6000;
+/**
+ * Limit-capped, non-paginated endpoints (fund-flow, kline) report `total` as the
+ * RETURNED row count, not the true total, so a full page (rows == the limit we sent) is
+ * the only truncation signal. Flag the result partial (printData → exit 3) + warn so a
+ * capped export isn't mistaken for the full set. `cap` MUST be the exact limit the caller
+ * sent on the request; `--limit` is validated to <= 10000 so `cap` can't exceed the
+ * server ceiling and hide a truncation.
+ */
+function flagIfLimitTruncated(data, cap, label) {
+    if (!data || typeof data !== "object" || Array.isArray(data))
+        return;
+    const rec = data;
+    if (rec.partial === true)
+        return;
+    if (Array.isArray(rec.list) && rec.list.length >= cap) {
+        rec.partial = true;
+        process.stderr.write(`[gangtise] warning: ${label} returned ${rec.list.length} rows = the ${cap}-row limit; results are likely truncated (this endpoint has no pagination). Narrow --start-date/--end-date or raise --limit (max 10000), fetching in date batches.\n`);
+    }
+}
 /**
  * Run a download. If `output` is set we already know the destination, so the
  * client streams the body straight to disk (no in-memory Uint8Array copy);
@@ -307,13 +334,63 @@ const addKlineCommand = (name, endpointKey, securityHelp, shardDays) => quote.co
     .option("--field <field>", "Field", collectList, [])
     .option("--format <format>", "Output format", "table")
     .option("--output <path>")
-    .action((options) => emit(options, (client) => callKlineWithSharding(client, endpointKey, buildQuoteKlineBody(options), { shardDays })));
+    .action((options) => withClient(async (client) => {
+    const format = parseOutputFormat(options.format);
+    const body = buildQuoteKlineBody(options);
+    if (isAllMarket(body)) {
+        // `--security all` is date-sharded: callKlineWithSharding lifts the limit to the
+        // API max and owns completeness (partial / failedShards), so leave `limit` unset
+        // and skip the single-request truncation guard.
+        const data = await callKlineWithSharding(client, endpointKey, body, { shardDays });
+        await printData(data, format, options.output);
+        return;
+    }
+    // Explicit securities go out as one request: pin the limit to the known default so
+    // the sent limit and the truncation cap are the same number by construction.
+    const limit = body.limit ?? DEFAULT_QUOTE_LIMIT;
+    const data = await callKlineWithSharding(client, endpointKey, { ...body, limit }, { shardDays });
+    flagIfLimitTruncated(data, limit, name);
+    await printData(data, format, options.output);
+}));
 addKlineCommand("day-kline", "quote.day-kline", "Security code (A-share: .SH/.SZ/.BJ, or 'all' for full market)", 1);
 addKlineCommand("day-kline-hk", "quote.day-kline-hk", "Security code (HK stock: .HK, or 'all' for full market)", 2);
 addKlineCommand("day-kline-us", "quote.day-kline-us", "Security code (US stock: e.g. AAPL.O, or 'all' for full market)", 1);
 addKlineCommand("index-day-kline", "quote.index-day-kline", "Index code (.SH/.SZ/.BJ, or 'all' for full market)", 30);
-quote.command("minute-kline").option("--security <code>", "Security code (A-share only: .SH/.SZ/.BJ)").option("--start-time <datetime>", "Start time (yyyy-MM-dd HH:mm:ss)").option("--end-time <datetime>", "End time (yyyy-MM-dd HH:mm:ss)").option("--limit <number>", "Max rows per request (default: 5000, max: 10000)").option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action((options) => emit(options, (client) => client.call("quote.minute-kline", { securityCode: options.security, startTime: options.startTime, endTime: options.endTime, limit: parseOptionalNumberOption(options.limit, "--limit", { integer: true, min: 1 }), fieldList: maybeArray(options.field) })));
+quote.command("minute-kline").option("--security <code>", "Security code (A-share only: .SH/.SZ/.BJ)").option("--start-time <datetime>", "Start time (yyyy-MM-dd HH:mm:ss)").option("--end-time <datetime>", "End time (yyyy-MM-dd HH:mm:ss)").option("--limit <number>", "Max rows per request (default: 6000, max: 10000)").option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action((options) => withClient(async (client) => {
+    const format = parseOutputFormat(options.format);
+    const limit = parseOptionalNumberOption(options.limit, "--limit", { integer: true, min: 1, max: 10000 }) ?? DEFAULT_QUOTE_LIMIT;
+    const data = await client.call("quote.minute-kline", { securityCode: options.security, startTime: options.startTime, endTime: options.endTime, limit, fieldList: maybeArray(options.field) });
+    flagIfLimitTruncated(data, limit, "minute-kline");
+    await printData(data, format, options.output);
+}));
 quote.command("realtime").description("Realtime quote snapshot (A-share / HK / US)").option("--security <code>", "Security code (e.g. 600519.SH / 00700.HK / AAPL.O), or market keyword: aShares / hkStocks / usStocks", collectList, []).option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action((options) => emit(options, (client) => client.call("quote.realtime", { securityList: maybeArray(options.security), fieldList: maybeArray(options.field) })));
+quote.command("fund-flow").description("A-share daily fund flow (SH/SZ/BJ)").option("--security <code>", "Security code (e.g. 600519.SH / 872931.BJ), or 'aShares' for full A-share market — auto-sharded by day (repeat)", collectList, []).option("--start-date <date>", "Start date yyyy-MM-dd (default: endDate minus 1 year)").option("--end-date <date>", "End date yyyy-MM-dd (default: latest trading day)").option("--limit <number>", "Max rows per request (default: 6000, max: 10000; single-security cap — aShares auto-shards by day)").option("--field <field>", "Field, e.g. mainNetInflow/largeInflow/xlargeOutflow (repeat); omit for all", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action((options) => withClient(async (client) => {
+    const format = parseOutputFormat(options.format);
+    const body = {
+        securityList: maybeArray(options.security),
+        startDate: options.startDate,
+        endDate: options.endDate,
+        limit: parseOptionalNumberOption(options.limit, "--limit", { integer: true, min: 1, max: 10000 }),
+        fieldList: maybeArray(options.field),
+    };
+    if (isFullMarket(body, "aShares")) {
+        // Full-market fund-flow: the server errors (430012/430013) instead of truncating when
+        // a single request exceeds the row cap, so date-shard by day (~5.4k A-share rows/day,
+        // under the lifted API cap) and merge — same mechanism as `--security all` kline.
+        // Sharding needs an explicit range; without both dates it would fall back to one
+        // doomed full-market request, so require the range up front with a clear message.
+        if (!body.startDate || !body.endDate) {
+            throw new ValidationError("quote fund-flow --security aShares requires both --start-date and --end-date (the full market is fetched via per-day shards)");
+        }
+        const data = await callKlineWithSharding(client, "quote.fund-flow", body, { shardDays: 1, fullMarketValue: "aShares" });
+        await printData(data, format, options.output);
+        return;
+    }
+    const limit = body.limit ?? DEFAULT_QUOTE_LIMIT;
+    const data = await client.call("quote.fund-flow", { ...body, limit });
+    flagIfLimitTruncated(data, limit, "fund-flow");
+    await printData(data, format, options.output);
+}));
 program.addCommand(quote);
 const fundamental = new Command("fundamental").description("Fundamental APIs");
 const addFinancialReport = (name, endpointKey, periodHelp = "Period") => fundamental.command(name).requiredOption("--security-code <code>").option("--start-date <date>").option("--end-date <date>").option("--fiscal-year <year>", "Fiscal year", collectList, []).option("--period <period>", periodHelp, collectList, []).option("--report-type <type>", "Report type", collectList, []).option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action((options) => emit(options, (client) => client.call(endpointKey, { securityCode: options.securityCode, startDate: options.startDate, endDate: options.endDate, fiscalYear: maybeArray(options.fiscalYear), period: options.period.length ? options.period : undefined, reportType: options.reportType.length ? options.reportType : undefined, fieldList: maybeArray(options.field) })));
@@ -479,13 +556,18 @@ reference.command("chiefs-search").requiredOption("--keyword <text>", "Search ke
     keyword: options.keyword,
     top: parseNumberOption(options.top, "--top", { integer: true, min: 1 }),
 })));
+reference.command("institution-search").requiredOption("--keyword <text>", "Search keyword (institution name / abbreviation)").option("--category <name>", "Category: domesticBroker/foreignInstitution/leadInstitution/opinionInstitution/foreignOpinionInstitution (repeat); omit for all", collectList, []).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.institution-search", {
+    keyword: options.keyword,
+    categoryList: maybeArray(options.category),
+    top: parseNumberOption(options.top, "--top", { integer: true, min: 1 }),
+})));
 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" }));
 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" }));
 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-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("--source <number>", "Recording source: 1=企微会议助理 2=会议服务微信群 (repeat)", collectNumberList, []).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), sourceList: options.source.length ? options.source : undefined }), { endpointKey: "vault.my-conference.list", idField: "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>", "Total rows to return; omit to fetch all").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))));

package/dist/src/core/args.js

@@ -24,6 +24,9 @@ export function parseNumberOption(value, optionName, config = {}) {
     if (config.min !== undefined && parsed < config.min) {
         throw new ValidationError(`Invalid ${optionName}: expected a number >= ${config.min}`);
     }
+    if (config.max !== undefined && parsed > config.max) {
+        throw new ValidationError(`Invalid ${optionName}: expected a number <= ${config.max}`);
+    }
     return parsed;
 }
 export function parseOptionalNumberOption(value, optionName, config = {}) {

package/dist/src/core/client.js

@@ -294,75 +294,6 @@ export class GangtiseClient {
         }
         return out;
     }
-    /**
-     * Sequential pagination for endpoints that page by offset but return NO `total`
-     * and use a non-standard list key (e.g. wechat chatroom's `chatRoomList`). We
-     * can't fan out like requestPaginated (no total ⇒ unknown page count), so page
-     * serially until a short page (fewer rows than requested) signals the end.
-     * Returns `{ [listKey]: rows }` so normalize/printer treat it like any list.
-     */
-    async requestSequentialPaginated(endpoint, body) {
-        const initialBody = body && typeof body === 'object' ? { ...body } : {};
-        if ('from' in initialBody && (typeof initialBody.from !== 'number' || !Number.isFinite(initialBody.from) || initialBody.from < 0)) {
-            throw new ValidationError('Invalid from: expected a non-negative number');
-        }
-        if ('size' in initialBody && initialBody.size !== undefined && (typeof initialBody.size !== 'number' || !Number.isFinite(initialBody.size) || initialBody.size <= 0)) {
-            throw new ValidationError('Invalid size: expected a positive number');
-        }
-        const listKey = endpoint.pagination?.listKey ?? 'list';
-        const maxPageSize = endpoint.pagination?.maxPageSize ?? 50;
-        const startFrom = typeof initialBody.from === 'number' && Number.isFinite(initialBody.from) ? initialBody.from : 0;
-        const requestedSize = typeof initialBody.size === 'number' && Number.isFinite(initialBody.size) ? initialBody.size : undefined;
-        const extractList = (page) => {
-            if (!page || typeof page !== 'object')
-                return null;
-            const arr = page[listKey];
-            return Array.isArray(arr) ? arr : null;
-        };
-        const collected = [];
-        let firstPage = null;
-        let from = startFrom;
-        const MAX_PAGES = 1000;
-        let truncatedByPageCap = false;
-        let partialShape = false;
-        for (let page = 0;; page++) {
-            const remaining = requestedSize === undefined ? maxPageSize : requestedSize - collected.length;
-            if (requestedSize !== undefined && remaining <= 0)
-                break;
-            const size = Math.min(maxPageSize, remaining);
-            const pageData = await this.requestJson(endpoint, { ...initialBody, from, size });
-            if (firstPage === null)
-                firstPage = pageData;
-            const list = extractList(pageData);
-            if (list === null) {
-                // First response isn't a paginated-list shape → return it untouched. But a
-                // LATER page losing shape must NOT discard the rows already collected (mirrors
-                // requestPaginated's fail-soft fan-out): stop, keep them, and warn loudly.
-                if (page === 0)
-                    return firstPage;
-                partialShape = true;
-                process.stderr.write(`[gangtise] warning: a page response had unexpected shape; results are partial — ${collected.length} rows fetched.\n`);
-                break;
-            }
-            for (const item of list)
-                collected.push(item);
-            if (list.length < size)
-                break; // short page ⇒ no more rows
-            if (page + 1 >= MAX_PAGES) {
-                truncatedByPageCap = true;
-                break;
-            }
-            from += list.length;
-        }
-        if (truncatedByPageCap) {
-            process.stderr.write(`[gangtise] warning: hit the ${MAX_PAGES}-page safety cap; fetched ${collected.length} rows. Pass --size to fetch a bounded subset.\n`);
-        }
-        const rows = requestedSize === undefined ? collected : collected.slice(0, requestedSize);
-        const out = { [listKey]: rows };
-        if (partialShape)
-            out.partial = true;
-        return out;
-    }
     async login() {
         const authorization = await this.getAuthorizationHeader();
         const cache = await readTokenCache(this.config.tokenCachePath);
@@ -572,9 +503,7 @@ export class GangtiseClient {
             return this.download(endpoint, query ?? {}, options);
         }
         if (endpoint.kind === 'json' && endpoint.pagination?.enabled) {
-            return endpoint.pagination.sequential
-                ? this.requestSequentialPaginated(endpoint, body)
-                : this.requestPaginated(endpoint, body);
+            return this.requestPaginated(endpoint, body);
         }
         return this.requestJson(endpoint, body);
     }

package/dist/src/core/commandBodies.js

@@ -4,7 +4,7 @@ export function buildQuoteKlineBody(options) {
         securityList: maybeArray(options.security),
         startDate: options.startDate,
         endDate: options.endDate,
-        limit: parseOptionalNumberOption(options.limit, "--limit", { integer: true, min: 1 }),
+        limit: parseOptionalNumberOption(options.limit, "--limit", { integer: true, min: 1, max: 10000 }),
         fieldList: maybeArray(options.field),
     };
 }

package/dist/src/core/config.js

@@ -1,6 +1,6 @@
 import os from "node:os";
 import path from "node:path";
-export const DEFAULT_BASE_URL = "https://open.gangtise.com";
+export const DEFAULT_BASE_URL = "https://openapi.gangtise.com";
 export const DEFAULT_TIMEOUT_MS = 30_000;
 export const DEFAULT_TOKEN_CACHE_PATH = path.join(os.homedir(), ".config", "gangtise", "token.json");
 export function loadConfig() {

package/dist/src/core/endpoints.js

@@ -181,6 +181,12 @@ const ENDPOINT_DEFS = {
         kind: "json",
         description: "Search chief analyst IDs by name / institution / team",
     },
+    "reference.institution-search": {
+        method: "POST",
+        path: "/application/open-reference/institutions/search",
+        kind: "json",
+        description: "Search institution IDs by keyword (domestic broker / foreign / lead / opinion institution)",
+    },
     "reference.constant-category": {
         method: "GET",
         path: "/application/open-reference/constants/category",
@@ -248,6 +254,12 @@ const ENDPOINT_DEFS = {
         kind: "json",
         description: "Query realtime quote snapshot (A-share / HK / US)",
     },
+    "quote.fund-flow": {
+        method: "POST",
+        path: "/application/open-quote/fund-flow/daily",
+        kind: "json",
+        description: "Query A-share daily fund flow (SH/SZ/BJ; small/medium/large/xlarge orders + main net inflow)",
+    },
     // ─── fundamental ───
     "fundamental.income-statement": {
         method: "POST",
@@ -490,8 +502,8 @@ const ENDPOINT_DEFS = {
         path: "/application/open-vault/wechatgroupmsg/chatroomId",
         kind: "json",
         description: "List WeChat group chatroom IDs",
-        // No `total` in the response, list key is `chatRoomList`, server caps size at 50.
-        pagination: { enabled: true, maxPageSize: 50, sequential: true, listKey: "chatRoomList" },
+        // Response is `{ total, list }` (server caps size at 50); auto-paginate by total.
+        pagination: { enabled: true, maxPageSize: 50 },
     },
     "vault.stock-pool.list": {
         method: "POST",

package/dist/src/core/errors.js

@@ -24,7 +24,7 @@ const ERROR_HINTS = {
     "903301": "今日调用次数已达上限。",
     "410110": "异步内容生成中，稍后用对应 *-check 命令查询。",
     "410111": "异步内容生成失败（终态），请更换参数后重新提交。",
-    "410004": "数据未找到，请检查查询条件。",
+    "410004": "数据未找到或无指标权限，请检查查询条件与指标权限。",
     "430004": "下载失败（官方未文档化错误码），请确认 reportId 有效或更换 --file-type 重试。",
     "430007": "行情查询超出限制，请缩短日期范围。",
     "433007": "数据源不匹配，请检查 resourceType 与 sourceId 组合。",

package/dist/src/core/normalize.js

@@ -24,11 +24,6 @@ export function normalizeRows(value) {
         const hasMeta = Object.keys(meta).length > 0;
         return hasMeta ? { ...meta, list } : list;
     }
-    if (Array.isArray(record.chatRoomList)) {
-        const { chatRoomList, ...meta } = record;
-        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;

package/dist/src/core/quoteSharding.js

@@ -16,11 +16,16 @@ function parseDate(value) {
 function formatDate(d) {
     return d.toISOString().slice(0, 10);
 }
-function isAllMarket(body) {
+export function isFullMarket(body, fullMarketValue) {
     const list = body.securityList;
     if (!Array.isArray(list) || list.length !== 1)
         return false;
-    return list[0] === "all";
+    return list[0] === fullMarketValue;
+}
+/** Kline uses `all` as its whole-market keyword; fund-flow uses `aShares`. Thin wrapper
+ * so kline call sites read naturally. */
+export function isAllMarket(body) {
+    return isFullMarket(body, "all");
 }
 function buildShards(start, end, shardDays) {
     const shards = [];
@@ -43,7 +48,8 @@ function buildShards(start, end, shardDays) {
  * single-security queries this is a no-op.
  */
 export async function callKlineWithSharding(client, endpointKey, body, config) {
-    if (!isAllMarket(body)) {
+    const fullMarketValue = config.fullMarketValue ?? "all";
+    if (!isFullMarket(body, fullMarketValue)) {
         return client.call(endpointKey, body);
     }
     // `--security all` returns thousands of rows per day; lift the default 6000-row
@@ -51,17 +57,40 @@ export async function callKlineWithSharding(client, endpointKey, body, config) {
     // must apply even when a date is missing (no sharding possible then, but the
     // single request still needs the lifted cap).
     const allMarketBody = { ...body, limit: body.limit ?? ALL_MARKET_LIMIT };
+    const perShardLimit = allMarketBody.limit ?? ALL_MARKET_LIMIT;
+    // A shard maxes out for two reasons with different fixes: a user-set low --limit is
+    // raisable; hitting the API cap itself is not (only a smaller internal shardDays window
+    // would help). Word the truncation warning accordingly.
+    const truncationHint = perShardLimit < ALL_MARKET_LIMIT
+        ? "raise or omit --limit to fetch the full market"
+        : `a single ${config.shardDays}-day window exceeds the ${ALL_MARKET_LIMIT}-row API cap`;
+    // A full-market response whose row count reaches the per-request limit was itself
+    // capped (a low user --limit, or a single day exceeding the API row cap) — its slice
+    // is incomplete, so the result must be flagged partial rather than shown as complete.
+    const isTruncated = (rec) => Array.isArray(rec.list) && rec.list.length >= perShardLimit;
+    // A single full-market request (missing/unparseable dates, or a range that fits one
+    // shard) skips the merge loop below, so it needs the same truncation check inline — or
+    // a low --limit / oversized day slips through as a silent exit-0 success.
+    const callSingle = async () => {
+        const single = await client.call(endpointKey, allMarketBody);
+        if (single && typeof single === "object" && !Array.isArray(single) && isTruncated(single)) {
+            ;
+            single.partial = true;
+            process.stderr.write(`[gangtise] warning: full-market request hit the ${perShardLimit}-row limit and was likely truncated; results are partial — ${truncationHint}.\n`);
+        }
+        return single;
+    };
     if (!body.startDate || !body.endDate) {
-        return client.call(endpointKey, allMarketBody);
+        return callSingle();
     }
     const start = parseDate(body.startDate);
     const end = parseDate(body.endDate);
     if (!start || !end || end < start) {
-        return client.call(endpointKey, allMarketBody);
+        return callSingle();
     }
     const totalDays = Math.floor((end.getTime() - start.getTime()) / DAY_MS) + 1;
     if (totalDays <= config.shardDays) {
-        return client.call(endpointKey, allMarketBody);
+        return callSingle();
     }
     const shards = buildShards(start, end, config.shardDays);
     // isVerbose() (not a direct env read) so the global --verbose flag reaches
@@ -89,6 +118,7 @@ export async function callKlineWithSharding(client, endpointKey, body, config) {
     let fieldList;
     let header = null;
     const merged = [];
+    let truncatedShards = 0;
     for (const r of results) {
         if (!(r && typeof r === "object"))
             continue;
@@ -97,6 +127,8 @@ export async function callKlineWithSharding(client, endpointKey, body, config) {
             header = rec;
         if (!fieldList && Array.isArray(rec.fieldList))
             fieldList = rec.fieldList;
+        if (isTruncated(rec))
+            truncatedShards++;
         // Append one-by-one rather than push(...list): a future higher row cap could
         // make a single shard's list large enough to overflow the stack via spread.
         if (Array.isArray(rec.list))
@@ -110,7 +142,9 @@ export async function callKlineWithSharding(client, endpointKey, body, config) {
     }
     if (!header)
         return { list: [] };
-    const out = { ...header, list: merged };
+    // `total` on a shard is that shard's own row count; overwrite it with the merged count
+    // so the JSON `total` and the `Total:` stderr line reflect the whole combined result.
+    const out = { ...header, total: merged.length, list: merged };
     if (fieldList)
         out.fieldList = fieldList;
     if (failedShards.length > 0) {
@@ -118,5 +152,9 @@ export async function callKlineWithSharding(client, endpointKey, body, config) {
         out.failedShards = failedShards;
         process.stderr.write(`[gangtise] warning: ${failedShards.length}/${shards.length} shards failed; results are partial (see failedShards)\n`);
     }
+    if (truncatedShards > 0) {
+        out.partial = true;
+        process.stderr.write(`[gangtise] warning: ${truncatedShards}/${shards.length} shard(s) hit the ${perShardLimit}-row limit and were likely truncated; results are partial — ${truncationHint}.\n`);
+    }
     return out;
 }

package/dist/src/version.js

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

package/package.json

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