gangtise-openapi-cli 0.26.0 → 0.28.0

package/gangtise-openapi/references/fields.md

@@ -0,0 +1,166 @@
+# CLI 可选字段速查
+
+> 按命令分组，`--field` 参数可重复传入。不传 `--field` 时返回全部字段。
+
+---
+
+## Quote 行情
+
+### 日K线（A股 `quote day-kline` / 港股 `quote day-kline-hk` / 美股 `quote day-kline-us`）
+
+三者字段相同（货币单位随市场：A股=元、港股=港元、美股=美元）：
+
+| 字段 | 含义 | 字段 | 含义 |
+|------|------|------|------|
+| `securityCode` | 证券代码 | `tradeDate` | 交易日期 |
+| `open` | 开盘价 | `high` | 最高价 |
+| `low` | 最低价 | `close` | 收盘价 |
+| `preClose` | 昨收价 | `change` | 涨跌额 |
+| `pctChange` | 涨跌幅(%) | `volume` | 成交量(股) |
+| `amount` | 成交总额 | `adjustFactor` | 复权因子 |
+
+### 实时行情（`quote realtime`，A股/港股/美股）
+
+| 字段 | 含义 | 字段 | 含义 |
+|------|------|------|------|
+| `securityCode` | 证券代码 | `exchange` | 交易所代码（SH/SZ/BJ/HK/NYSE/NASDAQ/AMEX） |
+| `tradeDate` | 交易日期 | `tradeTime` | 最新行情时间 HH:mm:ss |
+| `latestPrice` | 最新价 | `preClose` | 昨收价 |
+| `open` | 开盘价 | `high` | 最高价 |
+| `low` | 最低价 | `change` | 涨跌额 |
+| `pctChange` | 涨跌幅(%) | `volume` | 成交量(股，当日累计) |
+| `amount` | 成交总额(当日累计) | `amplitude` | 振幅(%) |
+
+### 指数日K线（沪深京 `quote index-day-kline`）
+
+| 字段 | 含义 | 字段 | 含义 |
+|------|------|------|------|
+| `securityCode` | 指数代码 | `securityName` | 指数名称（如 上证指数，v0.15.0 起） |
+| `tradeDate` | 交易日期 | `open` | 开盘价 |
+| `high` | 最高价 | `low` | 最低价 |
+| `close` | 收盘价 | `preClose` | 昨收价 |
+| `change` | 涨跌额 | `pctChange` | 涨跌幅(%) |
+| `volume` | 成交量(手) | `amount` | 成交总额(元) |
+
+---
+
+## Fundamental 基本面
+
+### 利润表 (`fundamental income-statement`)
+
+**一级科目：**
+
+| 字段 | 含义 | 字段 | 含义 |
+|------|------|------|------|
+| `totalOpRev` | 一、营业总收入 | `totalOpCost` | 二、营业总成本 |
+| `nonOpNetIncome` | 三、非经营性净收益 | `opProfit` | 四、营业利润 |
+| `totalProfit` | 五、利润总额 | `netProfit` | 六、净利润 |
+| `otherCompIncome` | 七、其他综合收益税后净额 | `totalCompIncome` | 八、综合收益总额 |
+| `basicEPS` | 基本每股收益 | `dilutedEPS` | 稀释每股收益 |
+
+**二三级科目：**
+
+| 字段 | 含义 | 字段 | 含义 |
+|------|------|------|------|
+| `opRev` | 营业收入 | `salesRev` | ↳主营业务收入 |
+| `otherOpRev` | ↳其他业务收入 | `opCost` | 营业成本 |
+| `salesCost` | ↳主营业务成本 | `opTaxSurcharges` | 营业税金及附加 |
+| `salesExp` | 销售费用 | `totalAdminExp` | 管理费用合计 |
+| `adminExp` | ↳管理费用 | `rdExp` | 研发费用 |
+| `finExp` | 财务费用 | `invIncome` | 投资净收益 |
+| `fvChangeGain` | 公允价值变动净收益 | `creditImpairLossProfit` | 信用减值损失 |
+| `assetImpairLossProfit` | 资产减值损失 | `gainAssetDisposal` | 资产处置收益 |
+| `addNonopIncome` | 加：营业外收入 | `lessNonopExp` | 减：营业外支出 |
+| `lessIncTaxExp` | 减：所得税费用 | `profitContOps` | 持续经营净利润 |
+| `profitDiscOps` | 终止经营净利润 | `netProfitAttrParent` | 归母净利润 |
+| `netProfitAttrOrdShare` | ↳归母普通股净利润 | `netProfitAttrNoncontrol` | 少数股东损益 |
+| `netIntIncome` | 利息净收入 | `premEarned` | 已赚保费 |
+| `netCommIncome` | 手续费及佣金净收入 | `guaranteeIncome` | 担保业务收入 |
+| `OCIParentOwners` | 归母其他综合收益 | `OCIAttrNoncontrol` | 少数股东其他综合收益 |
+| `compIncomeAttrParent` | 归母综合收益总额 | `compIncomeAttrNoncontrol` | 少数股东综合收益总额 |
+
+### 资产负债表 (`fundamental balance-sheet`)
+
+**一级科目：**
+
+| 字段 | 含义 | 字段 | 含义 |
+|------|------|------|------|
+| `currAssets` | 流动资产 | `nonCurrAssets` | 非流动资产 |
+| `otherAssets` | 其他资产 | `totalAssets` | 资产总计 |
+| `currLiab` | 流动负债 | `nonCurrLiab` | 非流动负债 |
+| `otherLiab` | 其他负债 | `totalLiab` | 负债合计 |
+| `equity` | 所有者权益 | `totalEquity` | 所有者权益合计 |
+| `liabAndEquity` | 负债和所有者权益 | `totalLAndE` | 负债和所有者权益总计 |
+
+**二三级科目：**
+
+| 字段 | 含义 | 字段 | 含义 |
+|------|------|------|------|
+| `monetaryAssets` | 货币资金 | `cash` | ↳货币资金 |
+| `notesAcctsRecv` | 应收票据及应收账款 | `notesReceivable` | ↳应收票据 |
+| `acctsReceivable` | ↳应收账款 | `advPay` | 预付款项 |
+| `inventory` | 存货 | `totalCurrAssets` | 流动资产合计 |
+| `ltEquityInvest` | 长期股权投资 | `totalPPE` | 固定资产合计 |
+| `totalCIP` | 在建工程合计 | `intangAssets` | 无形资产 |
+| `goodwill` | 商誉 | `deferredTaxAssets` | 递延所得税资产 |
+| `totalNonCurrAssets` | 非流动资产合计 | `stBorrowings` | 短期借款 |
+| `notesAcctsPay` | 应付票据及应付账款 | `contractLiab` | 合同负债 |
+| `empBenefitsPay` | 应付职工薪酬 | `taxPayable` | 应交税费 |
+| `totalCurrLiab` | 流动负债合计 | `ltBorrowings` | 长期借款 |
+| `bondsPay` | 应付债券 | `leaseLiab` | 租赁负债 |
+| `deferredTaxLiab` | 递延所得税负债 | `totalNonCurrLiab` | 非流动负债合计 |
+| `shareCapital` | 股本 | `capReserve` | 资本公积 |
+| `lessTreasuryShares` | 减：库存股 | `surplusReserve` | 盈余公积 |
+| `retainedEarn` | 未分配利润 | `totalParentEq` | 归母所有者权益 |
+| `nonControllingInterests` | 少数股东权益 | | |
+
+### 现金流量表 (`fundamental cash-flow`)
+
+**一级科目：**
+
+| 字段 | 含义 | 字段 | 含义 |
+|------|------|------|------|
+| `opCashFlows` | 一、经营活动现金流量 | `invCashFlows` | 二、投资活动现金流量 |
+| `finCashFlows` | 三、筹资活动现金流量 | `cashEquivalents` | 四、现金及现金等价物 |
+| `cashEquivalentsIncrease` | 五、现金等价物净增加额 | | |
+
+**二三级科目：**
+
+| 字段 | 含义 | 字段 | 含义 |
+|------|------|------|------|
+| `cashFromSales` | 销售商品收到的现金 | `subtotalOpInflows` | 经营活动现金流入小计 |
+| `cashPaidForGoodsServices` | 购买商品支付的现金 | `cashPaidEmployees` | 支付给职工的现金 |
+| `cashPaidTaxes` | 支付的各项税费 | `subtotalOpOutflows` | 经营活动现金流出小计 |
+| `netOpCashFlows` | 经营活动现金流量净额 | `cashRecoveredInvestments` | 收回投资收到的现金 |
+| `cashPaidAcqConstructAssets` | 购建固定资产等支付的现金 | `cashPaidInvestments` | 投资支付的现金 |
+| `netInvCashFlows` | 投资活动现金流量净额 | `cashFromBorrowings` | 取得借款收到的现金 |
+| `cashPaidDebtRepayment` | 偿还债务支付的现金 | `cashPaidDividendsInterest` | 分配股利或偿付利息支付的现金 |
+| `netFinCashFlows` | 筹资活动现金流量净额 | `fxEffectOnCash` | 汇率变动对现金的影响 |
+| `netIncCashEquivalents` | 现金等价物净增加额 | `addOpeningCashBalance` | 期初现金余额 |
+| `closingCashBalance` | 期末现金余额 | | |
+
+**补充资料（将净利润调节为经营现金流）：**
+
+| 字段 | 含义 | 字段 | 含义 |
+|------|------|------|------|
+| `netProfit` | 净利润 | `depAmortFixedAssets` | 固定资产折旧等 |
+| `decreaseOpReceivables` | 经营性应收项目的减少 | `increaseOpPayables` | 经营性应付项目的增加 |
+
+### 主营业务 (`fundamental main-business`)
+
+| 字段 | 含义 | 字段 | 含义 |
+|------|------|------|------|
+| `opRevenue` | 营业收入 | `opRevenueYoy` | 营业收入同比增速 |
+| `opRevenueRatio` | 营业收入占比 | `opCost` | 营业成本 |
+| `opCostYoy` | 营业成本同比增速 | `opCostRatio` | 营业成本占比 |
+| `grossProfit` | 毛利 | `grossProfitYoy` | 毛利同比增速 |
+| `grossProfitRatio` | 毛利占比 | `grossMargin` | 毛利率 |
+| `grossMarginYoy` | 毛利率同比变化 | `grossMarginRatio` | 毛利率占比 |
+
+### 估值分析 (`fundamental valuation-analysis`)
+
+| 字段 | 含义 | 字段 | 含义 |
+|------|------|------|------|
+| `value` | 原始值 | `percentileRank` | 分位点 |
+| `average` | 平均值 | `median` | 中位数 |
+| `upper1Std` | +1标准差 | `lower1Std` | -1标准差 |

package/gangtise-openapi/references/lookup-ids.md

@@ -0,0 +1,264 @@
+# 常用 ID 速查表
+
+> 供 `gangtise-openapi` skill 按需引用，不需要在每次触发时全部加载。
+
+---
+
+## 中信行业分类（--industry 参数）
+
+完整列表用 `reference constant-list --category citicIndustry`。**`--industry` 全命令通用首选用这套（`1008001xx`）**——opinion / research / foreign-report / foreign-opinion / independent-opinion / wechat-message 都正确过滤；这套 ID 同时也是 `--research-area` 的行业部分（见下方研究方向）。
+
+| ID | 行业 | ID | 行业 |
+|----|------|----|------|
+| 100800101 | 石油石化 | 100800102 | 煤炭 |
+| 100800103 | 有色金属 | 100800104 | 电公 |
+| 100800105 | 钢铁 | 100800106 | 基础化工 |
+| 100800107 | 建筑 | 100800108 | 建材 |
+| 100800109 | 轻工制造 | 100800110 | 机械 |
+| 100800111 | 电新 | 100800112 | 国防军工 |
+| 100800113 | 汽车 | 100800114 | 商贸零售 |
+| 100800115 | 消服 | 100800116 | 家电 |
+| 100800117 | 纺织服装 | 100800118 | 医药 |
+| 100800119 | 食品饮料 | 100800120 | 农林牧渔 |
+| 100800121 | 银行 | 100800122 | 非银 |
+| 100800123 | 房地产 | 100800124 | 综合金融 |
+| 100800125 | 交通运输 | 100800126 | 电子 |
+| 100800127 | 通信 | 100800128 | 计算机 |
+| 100800129 | 传媒 | 100800130 | 综合 |
+
+---
+
+## 申万行业（--industry 参数）
+
+完整列表用 `reference constant-list --category swIndustry`。⚠️ 申万码（`104xxx`）只在**部分** insight list 上作 `--industry` 等效、**不能用于 `--research-area`（返 0）**、`vault wechat-message-list` 会**静默返全量**——哪套码用于哪些命令的**权威口径见 `references/commands/reference-and-lookup.md`「行业 / 研究方向过滤——选哪套 category」**，勿在此重复枚举。拿不准就统一用上方中信码。
+
+| ID | 行业 | ID | 行业 | ID | 行业 |
+|----|------|----|------|----|------|
+| 104110000 | 农林牧渔 | 104220000 | 基础化工 | 104230000 | 钢铁 |
+| 104240000 | 有色金属 | 104270000 | 电子 | 104280000 | 汽车 |
+| 104330000 | 家用电器 | 104340000 | 食品饮料 | 104350000 | 纺织服饰 |
+| 104360000 | 轻工制造 | 104370000 | 医药生物 | 104410000 | 公用事业 |
+| 104420000 | 交通运输 | 104430000 | 房地产 | 104450000 | 商贸零售 |
+| 104460000 | 社会服务 | 104480000 | 银行 | 104490000 | 非银金融 |
+| 104510000 | 综合 | 104610000 | 建筑材料 | 104620000 | 建筑装饰 |
+| 104630000 | 电力设备 | 104640000 | 机械设备 | 104650000 | 国防军工 |
+| 104710000 | 计算机 | 104720000 | 传媒 | 104730000 | 通信 |
+| 104740000 | 煤炭 | 104750000 | 石油石化 | 104760000 | 环保 |
+| 104770000 | 美容护理 | | | | |
+
+---
+
+## 申万行业代码（--gts-code 参数，用于 ai security-clue）
+
+完整列表用 `reference sector-search --keyword 申万一级行业指数`（取「指数数据板块」层级的 sectorId，即 `2000000014`）+ `reference sector-constituents --sector-id 2000000014`
+
+| 代码 | 行业 | 代码 | 行业 | 代码 | 行业 |
+|------|------|------|------|------|------|
+| 821031.SWI | 农林牧渔 | 821032.SWI | 基础化工 | 821033.SWI | 钢铁 |
+| 821034.SWI | 有色金属 | 821035.SWI | 电子 | 821036.SWI | 汽车 |
+| 821037.SWI | 家用电器 | 821038.SWI | 食品饮料 | 821039.SWI | 纺织服饰 |
+| 821040.SWI | 轻工制造 | 821041.SWI | 医药生物 | 821042.SWI | 公用事业 |
+| 821043.SWI | 交通运输 | 821044.SWI | 房地产 | 821045.SWI | 商贸零售 |
+| 821046.SWI | 社会服务 | 821047.SWI | 银行 | 821048.SWI | 非银金融 |
+| 821049.SWI | 综合 | 821050.SWI | 建筑材料 | 821051.SWI | 建筑装饰 |
+| 821052.SWI | 电力设备 | 821053.SWI | 机械设备 | 821054.SWI | 国防军工 |
+| 821055.SWI | 计算机 | 821056.SWI | 传媒 | 821057.SWI | 通信 |
+| 821058.SWI | 煤炭 | 821059.SWI | 石油石化 | 821060.SWI | 环保 |
+| 821061.SWI | 美容护理 | | | | |
+
+> 与「申万行业」ID 用途不同：行业 ID（如 `104270000`）用于 `--industry` 参数，行业代码（如 `821035.SWI`）用于投研线索 `--gts-code` 参数。
+
+---
+
+## 常用券商（--broker 参数）
+
+完整列表用 `lookup broker-org list`
+
+| ID | 券商 | ID | 券商 |
+|----|------|----|------|
+| C100000027 | 中信证券 | C100000095 | 中信建投 |
+| C100000026 | 中金公司 | C100000047 | 国泰海通 |
+| C100000021 | 广发证券 | C100000020 | 招商证券 |
+| C100000023 | 国信证券 | C100000014 | 华泰证券 |
+| C100000051 | 兴业证券 | C100000119 | 申万宏源 |
+| C100000050 | 天风证券 | C100000039 | 长江证券 |
+| C100000068 | 华创证券 | C100000042 | 东方证券 |
+| C100000029 | 光大证券 | C100000006 | 国金证券 |
+| C100000034 | 民生证券 | C100000062 | 中泰证券 |
+| C100000099 | 中国银河 | C100000096 | 国投证券 |
+| C100000075 | 浙商证券 | C100000085 | 财通证券 |
+| C100000083 | 国盛证券 | C100000084 | 德邦证券 |
+| C100000098 | 瑞银证券 | C100000092 | 高华证券 |
+
+---
+
+## 常用外资券商（--broker 参数）
+
+| ID | 券商 | ID | 券商 |
+|----|------|----|------|
+| C800110443 | 高盛 | C800114009 | 摩根大通 |
+| C800070012 | 德意志银行 | C800065266 | 巴克莱 |
+| C800105979 | 汇丰控股 | C800090764 | 花旗银行 |
+| C800127057 | 瑞银集团 | C800070011 | 大和证券 |
+| C800033691 | 麦格理 | C800080335 | 高盛集团 |
+| C800082057 | 高盛 | C800160866 | 中信里昂证券 |
+| C800022831 | 里昂证券 | C800096075 | 海通国际 |
+| C801303042 | 杰富瑞集团 | C800044779 | 加拿大皇家银行 |
+
+---
+
+## 常用研究方向（--research-area 参数）
+
+`--research-area` 用 **gangtiseIndustry**：= 30 个行业（`1008001xx`，与上方「中信行业分类」表完全相同）+ 6 个方向。完整列表用 `reference constant-list --category gangtiseIndustry`。适用 opinion / summary / roadshow / site-visit / forum / my-conference（strategy 无此参数）。
+
+**6 个研究方向（gangtiseIndustry 独有，citicIndustry 没有，已实测正确过滤）：**
+
+| ID | 方向 | ID | 方向 |
+|----|------|----|------|
+| 122000001 | 宏观 | 122000002 | 策略 |
+| 122000003 | 固收 | 122000004 | 金工 |
+| 122000005 | 海外 | 122000007 | 其他 |
+
+30 个行业的 ID 直接用上方「中信行业分类」表（`1008001xx`）。⚠️ **申万码 `104xxx` 不能用于 `--research-area`**（除 summary / my-conference 的 spec 例外，其余返 0）。
+
+---
+
+## 常用会议机构（--institution 参数）
+
+完整列表用 `lookup meeting-org list`
+
+| ID | 机构 | ID | 机构 |
+|----|------|----|------|
+| C100000027 | 中信证券 | C100000095 | 中信建投 |
+| C100000026 | 中金公司 | C100000047 | 国泰海通 |
+| C100000021 | 广发证券 | C100000023 | 国信证券 |
+| C100000014 | 华泰证券 | C100000051 | 兴业证券 |
+| C100000050 | 天风证券 | C100000068 | 华创证券 |
+| C100000020 | 招商证券 | C100000042 | 东方证券 |
+| C000000000 | 公司自发 | C100000039 | 长江证券 |
+| C100000075 | 浙商证券 | C100000083 | 国盛证券 |
+| C100000084 | 德邦证券 | C100000085 | 财通证券 |
+| C100000096 | 国投证券 | C100000099 | 银河证券 |
+| C100000100 | 信达证券 | C100000034 | 民生证券 |
+| C900005224 | 摩根大通 | C200000163 | 易方达基金 |
+| C200000165 | 华夏基金 | C200000168 | 工银瑞信基金 |
+
+---
+
+## 外资研报区域（--region 参数）
+
+完整列表用 `reference constant-list --category regionCategory`
+
+| ID | 区域 | ID | 区域 | ID | 区域 |
+|----|------|----|------|----|------|
+| cn | 中国 | cnHk | 香港 | cnTw | 台湾 |
+| us | 美国 | jp | 日本 | sea | 东南亚 |
+| gl | 全球 | uk | 英国 | fr | 法国 |
+| de | 德国 | kr | 韩国 | in | 印度 |
+| ca | 加拿大 | me | 中东 | othAs | 亚洲其他 |
+| othEur | 欧洲其他 | latAm | 拉美 | oce | 大洋洲 |
+| af | 非洲 | | | | |
+
+---
+
+## 公告分类
+
+完整列表用 `reference constant-list --category aShareAnnouncementCategory`（港股用 `hkShareAnnouncementCategory`，美股用 `usShareAnnouncementCategory`，`103980xxx` 段），树形结构含一级和二级分类。
+
+### 一级分类
+
+| ID | 分类 | ID | 分类 |
+|----|------|----|------|
+| 103910100 | IPO | 103910200 | 财务报告 |
+| 103910300 | 重大事项 | 103910400 | 交易提示 |
+| 103910500 | 配股 | 103910600 | 增发 |
+| 103910700 | 股权股本 | 103910800 | 一般公告 |
+| 103910900 | 公司治理 | | |
+
+### 二级分类（精确筛选用）
+
+| 一级分类 | 二级 ID | 二级分类 |
+|----------|---------|----------|
+| IPO | 103910101 | 招股说明书(申报稿) |
+| | 103910102 | 申报反馈 |
+| | 103910103 | 招股说明书 |
+| | 103910104 | 发行定价 |
+| | 103910105 | 发行结果 |
+| | 103910106 | 上市公告书 |
+| | 103910108 | 其他首发公告 |
+| 财务报告 | 103910201 | 业绩预告 |
+| | 103910202 | 业绩快报 |
+| | 103910203 | 一季度报告 |
+| | 103910205 | 三季度报告 |
+| | 103910207 | 半年度报告 |
+| | 103910208 | 年度报告 |
+| | 103910209 | 补充更正 |
+| | 103910210 | 其他财务报告 |
+| | 103910214 | 财报摘要 |
+| 重大事项 | 103910301 | 董事会公告 |
+| | 103910302 | 股东大会公告 |
+| | 103910303 | 利润分配 |
+| | 103910304 | 资产重组 |
+| | 103910305 | 收购兼并 |
+| | 103910306 | 关联交易 |
+| | 103910307 | 借贷担保 |
+| | 103910308 | 合同及协议 |
+| | 103910309 | 人事变动 |
+| | 103910310 | 资金投向 |
+| | 103910311 | 违纪违规 |
+| | 103910319 | 资金占用 |
+| 交易提示 | 103910401 | 停复牌提示 |
+| | 103910402 | 交易异动 |
+| | 103910403 | 澄清致歉 |
+| | 103910404 | 风险提示 |
+| | 103910405 | 特别处理 |
+| | 103910406 | 终止上市 |
+| | 103910407 | 恢复上市 |
+| | 103910408 | 暂停上市 |
+| | 103910409 | 披露提示 |
+| 配股 | 103910501 | 配股预案 |
+| | 103910502 | 配股说明书 |
+| | 103910503 | 配股获准 |
+| | 103910504 | 配股发行 |
+| | 103910505 | 配股上市 |
+| | 103910506 | 配股结果 |
+| | 103910507 | 其他配股公告 |
+| 增发 | 103910601 | 增发预案 |
+| | 103910602 | 增发说明书 |
+| | 103910603 | 增发获准 |
+| | 103910604 | 增发发行 |
+| | 103910605 | 增发上市 |
+| | 103910607 | 其他增发公告 |
+| | 103910608 | 增发结果 |
+| 股权股本 | 103910701 | 股权变动 |
+| | 103910702 | 股本变动 |
+| | 103910703 | 质押冻结 |
+| | 103910704 | 质押式回购 |
+| | 103910705 | 股权回购 |
+| | 103910706 | 约定购回 |
+| | 103910707 | 股权分置改革 |
+| | 103910708 | 可转债 |
+| 一般公告 | 103910801 | 投资理财 |
+| | 103910802 | 员工持股 |
+| | 103910803 | 股权激励 |
+| | 103910804 | 政策影响 |
+| | 103910805 | 权证公告 |
+| | 103910806 | 中介公告 |
+| | 103910807 | 法律纠纷 |
+| | 103910808 | 融资融券 |
+| | 103910809 | 投资者关系 |
+| | 103910810 | 公司资料变更 |
+| | 103910812 | 一般补充更正 |
+| | 103910813 | 其他公告 |
+| | 103910817 | 经营快报 |
+| | 103910818 | 股份增减持 |
+| | 103910819 | 公司制度文件 |
+| | 103910820 | ESG报告 |
+| | 103910822 | 监事会公告 |
+| | 103910823 | 问询函及回复 |
+| | 103910827 | 独立董事声明 |
+| | 103910832 | 发明专利证书 |
+| | 103910833 | 关联H股 |
+| 公司治理 | 103910901 | 董监高工作报告 |
+| | 103910902 | 内部控制与自查 |
+| | 103910903 | 专项意见 |

package/gangtise-openapi/references/response-schema.md

@@ -0,0 +1,85 @@
+# 响应结构详细对照
+
+CLI 自动处理 envelope：`{code, msg, data}` 信封会按 `code === "000000"` 解包，stdout 直接是 `data`。无 envelope 的响应原样透传。
+
+> 例外：`indicator`（EDE）三个接口成功时**双层信封**（`data` 里再裹一层 `{code, status, data}`），内层字段名为 `securityCodeList/securityNameList/indicatorCodeList/indicatorNameList/dataTypes`，`values` 是 2D 矩阵（截面 `[指标][证券]`、时序 `[序列][日期]`）；无数据为 `null` 单元格。`indicator` 子命令已在客户端二次解包并拍平成宽表；但直接 `raw call indicator.*` 只会剥外层，需自行处理内层。
+
+## 通用模式（5 类）
+
+| 模式 | 结构 | 提取方式 |
+|------|------|---------|
+| 列表 | `{list: [...], total: N}` | 遍历 `list[]`；`total` 决定是否还有更多 |
+| 下载 | stdout = 文件路径字符串 | 直接读取整行 |
+| AI 内容 | `{content: "markdown文本"}` | 直接呈现 `content` |
+| 列式 K 线 | `{fieldList: [...], list: [[...], ...]}` 或 `{list: [{...}]}` | CLI 已规范化为对象 list |
+| 异步任务 | 提交：`{dataId}`；轮询：`{status:"pending"}` 或 `{date, content}` | 详见 `commands/ai.md` |
+
+## 全命令字段对照
+
+| 命令 | data 结构 | 关键提取字段 |
+|------|----------|------------|
+| insight opinion list | `{list, total}` | `list[].id` / `list[].title` / `list[].publishDate` / `list[].chiefName` / `list[].securityCode` / `list[].institutionName` |
+| insight summary list | `{list, total}` | `list[].summaryId` / `list[].title` / `list[].publishTime` |
+| insight summary download | 文件路径（stdout） | — |
+| insight roadshow / site-visit / strategy / forum list | `{list, total}` | `list[].id` / `list[].title` / `list[].publishTime` / `list[].institution.institutionName` |
+| insight research list | `{list, total}` | `list[].reportId` / `list[].title` / `list[].brief`（全文摘要） / `list[].publishTime` / `list[].publisher.brokerName` / `list[].securityList[].rating` |
+| insight research download | 文件路径（stdout） | — |
+| insight foreign-report list | `{list, total}` | `list[].reportId` / `list[].title` / `list[].titleTranslate` / `list[].brief` / `list[].briefTranslate`（中译全文摘要） / `list[].publishTime` / `list[].publisher.brokerName` |
+| insight foreign-report download | 文件路径（stdout） | — |
+| insight announcement list | `{list, total}` | `list[].announcementId` / `list[].title` / `list[].publishTime` / `list[].securityCode` |
+| insight announcement download | 文件路径（stdout） | — |
+| insight announcement-hk list | `{list, total}` | `list[].announcementId` / `list[].title` / `list[].titleTranslate` / `list[].publishTime` / `list[].securityCode` / `list[].primaryCategory.categoryName` |
+| insight announcement-hk download | 文件路径（stdout） | — |
+| insight announcement-us list | `{list, total}` | `list[].announcementId` / `list[].title` / `list[].publishTime` / `list[].securityList[].securityCode` / `list[].primaryCategory.categoryName` / `list[].sourceName` |
+| insight announcement-us download | 文件路径（stdout） | — |
+| insight foreign-opinion list | `{list, total}` | `list[].foreignOpinionId` / `list[].titleTranslate` / `list[].publishTime` / `list[].publisher.brokerName` / `list[].securityList[].rating` |
+| insight independent-opinion list | `{list, total}` | `list[].independentOpinionId` / `list[].titleTranslate` / `list[].briefTranslate` / `list[].publishTime` / `list[].analyst.analystName` |
+| insight independent-opinion download | 文件路径（stdout） | — |
+| insight official-account list | `{list, total}` | `list[].articleId` / `list[].accountName` / `list[].title` / `list[].publishTime` / `list[].articleCategory` / `list[].summary` / `list[].industryList[].industryName` / `list[].conceptList[].conceptName` / `list[].securityList[].securityCode` |
+| insight official-account download | 文件路径（stdout） | — |
+| insight qa list | `{list, total}` | `list[].source`（conference/interactive/survey）/ `list[].publishTime` / `list[].question` / `list[].answer` / `list[].member` / `list[].securityCode` / `list[].questionCategory[]` / `list[].answerImportant`（1/0） |
+| insight report-image list | `[{...}]`（扁平数组，无 `total`） | `[].chunkId`（下载用 `--chunk-id`）/ `[].title` / `[].sourceId` / `[].broker` / `[].category` / `[].page` / `[].totalPages` / `[].imageCaption[]` / `[].imageFootnote[]` / `[].pageContent`（该页 OCR/描述） |
+| insight report-image download | 文件路径（stdout，JPEG） | — |
+| reference securities-search | `{returnedCount, list}` | `list[].gtsCode` / `list[].gtsName` / `list[].category` / `list[].matchScore` / `list[].matchType` |
+| reference chiefs-search | `{returnedCount, list}` | `list[].chiefId` / `list[].chiefName` / `list[].institution` / `list[].team` / `list[].matchScore` |
+| reference institution-search | `{returnedCount, list}` | `list[].institutionId` / `list[].institutionName` / `list[].category` / `list[].usageScopes[{apiName, paramName}]` / `list[].matchScore` |
+| reference official-account-search | `{returnedCount, list}` | `list[].accountId`（喂 `insight official-account list --account-id`）/ `list[].accountName` / `list[].category`（四类或 `null`）/ `list[].matchScore` |
+| reference constant-category | `{total, list}` | `list[].category` / `list[].categoryName` / `list[].structureType`（flat/tree） / `list[].maxLevel` / `list[].usageScopes[].apiName` / `.paramName` |
+| reference constant-list | `{category, structureType, maxLevel, constantCount, list}`（CLI 把 `constants` 规范化为 `list`） | `list[].constantId` / `list[].constantName` / `list[].level`；树形分类父节点含 `list[].children[]`（递归同构） |
+| reference concept-search | `{returnedCount, list}` | `list[].conceptId` / `list[].conceptName` / `list[].matchScore` |
+| reference sector-search | `{returnedCount, list}` | `list[].sectorId` / `list[].sectorName` / `list[].hierarchy`（层级路径） / `list[].matchScore` |
+| reference sector-constituents | `{total, list}` | `list[].gtsCode` / `list[].gtsName`；total=0 说明 sectorId 不对（先 sector-search 确认） |
+| quote day-kline / day-kline-hk / day-kline-us / index-day-kline | `{fieldList, list}` 或规范化后 `{list: [{...}]}` | `tradeDate` / `securityCode` / `open` / `close` / `pctChange` / `volume`；index 另含 `securityName`（指数名称，v0.15.0 起） |
+| quote minute-kline | `{list: [{...}]}` | `tradeTime` / `open` / `close` / `volume` |
+| quote realtime | `{fieldList, list, total}` 或规范化后 `{list: [{...}]}` | `securityCode` / `exchange` / `tradeDate` / `tradeTime` / `latestPrice` / `pctChange` / `volume` / `amount` / `amplitude` |
+| quote fund-flow | `{fieldList, list, total}` 列式 → 规范化后 `{list: [{...}], total}` 宽表 | `securityCode` / `tradeDate` + 请求的字段（`mainNetInflow` / `largeInflow` / `xlargeOutflow` / …） |
+| fundamental income-statement / balance-sheet / cash-flow（含 quarterly / -hk / -us） | `{total, list: [{...}]}` | `fiscalYear` / `period` / `endDate` / `companyName` / `companyType`（企业类型名称，如 `一般企业`/`银行`）+ 各 `--field` 字段；港股/美股另含 `timeCovered`（不规则跨度） |
+| fundamental main-business | `{list: [{...}]}` | `endDate` / `breakdownName` / `revenue` / `revenueRatio` / `grossProfitRatio` |
+| fundamental valuation-analysis | `{list: [{...}]}` | `tradeDate` / `value` / `percentileRank` |
+| fundamental earning-forecast | `{securityCode, securityName, updateList: [...]}` | `updateList[].date` / `updateList[].fieldList[].forecastYear` + 各 consensus 指标 |
+| fundamental top-holders | `{holderType, list: [{...}]}` | `reportPeriod` / `rank` / `shareholderName` / `holdingNum` / `holdingPct` / `chgNum` / `chgPct` |
+| ai knowledge-batch | `{list: [{...}]}` | `list[].resourceType` / `list[].sourceId` / `list[].title` / `list[].summary` |
+| ai security-clue | `{list, total}` | `list[].securityCode` / `list[].title` / `list[].clueType` / `list[].clueDate` |
+| ai stock-summary | `{list, total}` | `list[].securityCode` / `list[].securityName` / `list[].summary` / `list[].date`；无看点的证券不在 list 中 |
+| ai one-pager / investment-logic / peer-comparison / research-outline | `{content}` | `content` 直接呈现（Markdown） |
+| ai theme-tracking | `[{type, date, content}, ...]`（列表，每元素一份报告） | 遍历筛选 `type === "morning" / "night"`；某主题在该日期可能只有一种类型，或两种都没（空列表） |
+| ai hot-topic | `{list, total}` | `list[].title` / `list[].reportDate` / `list[].category` / `list[].topics[].topicTitle` / `list[].topics[].driverEvent` / `list[].topics[].investLogic` |
+| ai management-discuss-* | `{securityCode, reportDate, discussionDimension, content}` | `content` 为字符串（业绩会）或字符串数组（财报） |
+| ai earnings-review | `{dataId}`（提交）/ `{status:"pending"}` 或 `{date, content}`（check） | `dataId` 用于轮询；最终 `content` 直接呈现 |
+| ai viewpoint-debate | 同 earnings-review | — |
+| vault drive-list | `{list, total}` | `list[].fileId`（下载用 `--file-id`）/ `list[].title` / `list[].fileType` / `list[].uploadTime` |
+| vault drive-download | 文件路径（stdout） | — |
+| vault record-list | `{list, total}` | `list[].recordId` / `list[].title` / `list[].category` / `list[].createTime` / `list[].recordDuration` |
+| vault record-download | 文件路径（stdout） | — |
+| vault my-conference-list | `{list, total}` | `list[].conferenceId` / `list[].title` / `list[].category` / `list[].institution.institutionName` / `list[].publishTime` |
+| vault my-conference-download | 文件路径（stdout） | — |
+| vault wechat-message-list | `{list, total}` | `list[].msgId` / `list[].msgContent` / `list[].msgTime` / `list[].wechatGroupName` / `list[].speakerName` / `list[].category` / `list[].tagList` |
+| vault wechat-chatroom-list | `{list, total}` | `list[].chatroomName` / `list[].chatroomId` |
+| alternative edb-search | `{list: [...]}` 指标列表 | `indicatorId` / `indicatorName` / `dataSource` / `frequency` / `unit` |
+| alternative edb-data | 列表，每行 `{date, <indicatorId>: value, ...}` 宽表 | `date` + 每个 `--indicator-id` 一列（该日指标值） |
+| alternative concept-info | `{conceptId, conceptName, ...}`（单对象，**非列表**） | `conceptName` / `definition` / `investmentLogic` / `industrySpace` / `competitiveLandscape` / `keyEvents[].date` / `keyEvents[].content`；文本字段未配置为 `null` |
+| alternative concept-securities | `{conceptId, conceptName, securityCount, securityDetail}`（单对象，分组） | `securityCount` / `securityDetail[].groupName` / `securityDetail[].securityList[].securityCode` / `.securityName` / `.isKey` / `.inclusionReason`；无成分股时 `securityDetail` 为 `null` |
+| indicator search | `[{indicatorCode, indicatorName, ...}]`（列表） | `indicatorCode` / `indicatorName` / `description` / `scope` / `parameterList[].paramKey` / `.enumList[].value`（专属参数及枚举） / `score` |
+| indicator cross-section | CLI 拍平为宽表 `{list, total}` | `list[].date` / `list[].security` / `list[].name` + 每个指标名一列；**单日多指标 × 多证券**，每行一只证券 |
+| indicator time-series | CLI 拍平为宽表 `{list, total}` | `list[].date` + 序列列：单证券时列=各指标、多证券时列=各证券；每行一个日期 |
+| lookup broker-org / meeting-org list | `[...]` | `[].id` / `[].name` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gangtise-openapi-cli",
-  "version": "0.26.0",
+  "version": "0.28.0",
   "description": "CLI for Gangtise OpenAPI",
   "license": "MIT",
   "repository": {
@@ -20,6 +20,7 @@
   },
   "files": [
     "dist/",
+    "gangtise-openapi/",
     "README.md"
   ],
   "scripts": {
@@ -27,7 +28,7 @@
     "build": "tsc -p tsconfig.json",
     "dev": "tsx src/cli.ts",
     "test": "vitest run",
-    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.test.json",
     "prepare": "node scripts/prepare.cjs && npm run build"
   },
   "engines": {