@v587d/capital-generation 2.8.2 → 2.8.3

package/CHANGELOG.md

@@ -7,6 +7,39 @@
 - **第三位（patch）**：不破坏既有工具 / 配置 / 会话的新增与修复（如 2.1.1、2.1.2）。
 - **第二位（minor）**：有需要用户知晓的行为变更，且段内附迁移说明（如 2.1.0 的图表呈现通道重做、2.2.0 的数据源与检索来源扩容、2.4.0 的**必须换宿主版本**——本插件自己的工具与数据契约没变，所以只抬第二位）。
 
+## [2.8.3] - 2026-10-16
+
+接入**期货与贵金属**：数据收集能力 **118 → 128** 项（新增 10 项），仍来自 FTShare（非凸科技）免费档。
+宿主要求与 2.8.1 相同（DSH`@0.2.0-rc.2`），**不必换宿主版本**；密钥沿用「插件」页卡片上 2.8.2 补的那一格。
+
+### Added
+
+- **合约与要素两颗**：某交易日全部在册期货合约清单（六家期货交易所 + 银行间债券远期），以及单只合约的
+  交易单位、合约乘数、最小变动价位、保证金说明、上市与摘牌日、交割方式。⛔ 这两张表**每只合约给两份副本**
+  （实测一个交易日 1812 行、其实只有 906 只合约），取数时会点名这件事——按行数报"多少只合约"会正好翻倍。
+- **行情与结算五颗**：单只合约的日/周/月/季 K 线（每手成交额与持仓量都在，成交额经乘数与收盘价交叉核对
+  确定是元）、每日涨跌停价、每日结算参数（结算价与投机/套保四档保证金率）、交易所仓单日报、
+  主要品种交易周报（周成交量、成交额、持仓量与同比环比；成交额经同样方式核对确定是**亿元**）。
+- **指数与持仓排名两颗**：南华商品期货指数日 K（本仓第一次有商品指数序列）、东方财富期货会员成交持仓排名
+  （一只合约 × 一家会员一行，含成交量、多头、空头、净多、净空五组排名与持仓，以及增减仓排名）。
+- **贵金属价格一颗**：AU9999 与 XAUUSD 两条日度序列。这一家实测只有这两个代码有数，且两条都停在
+  2026 年 8 月中旬——问"最近一周的金价"会拿到空，那不是取数失败，说明里写清了。
+- 三处上游口径差异由插件自己填平，使用者不用管：合约代码的交易所后缀**同一所写法不止一种**
+  （清单给 `.CFE` / `.CZC`，涨跌停与结算给 `.CFX` / `.ZCE`，而行情只认全称），会员持仓那一族对大小写
+  敏感且广期所的真名是 `gfe`（照常规写 `GFEX` 会静默拿到零行），周报的同比列上游把键名拼错了。
+- 每一项都按上游真实返回逐列核验后才登记：单位、哪些列可以为空、当日数据要 20:20 之后才开放这类采集时点
+  都写进该项说明；上游文档与实测不符的地方以实测为准并点名。免费档限流（10 QPS / 突发 20）由出口节流守住。
+
+### 迁移说明
+
+- **不需要任何动作**。已有的五把密钥、卡片设置、精选 Skills 勾选、自选股清单与持仓标记全部照旧。
+  没配 FTShare 密钥时，这 10 项仍在能力目录里，但每次取数都会点名 `FTSHARE_API_KEY` 失败，其余来源照常。
+- **仍未覆盖**：期权（这一家的免费档与全量接口表里都没有这个域，不是待办）、中金所的每日结算参数
+  （实测返回零行，同一天同品种的涨跌停价有数）、银行间品种的行情端（清单里有那 64 只，行情取不到）、
+  期货的会员龙虎榜（同一家另一个接口，一次回十二个指标、三种数据形状，需要先给数据层加"一行拆多行"
+  的能力，排在下一批）。
+- 覆盖范围见 [数据收集能力表](docs/data-collector-capabilities.md)。
+
 ## [2.8.2] - 2026-10-16
 
 补 2.8.1 漏掉的一格：FTShare 的密钥当时只能写进宿主的凭据文件，配置卡片上没有输入口——而卡片是

package/README.md

@@ -15,7 +15,7 @@
 <p align="center">
   <a href="https://awesome-dsh-plugin.com"><img src="https://awesome-dsh-plugin.com/badge.svg" alt="awesome · DSH plugin"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green" alt="License"></a>
-  <a href="https://github.com/v587d/capital-generation/releases"><img src="https://img.shields.io/badge/version-2.8.2-9cf" alt="Version"></a>
+  <a href="https://github.com/v587d/capital-generation/releases"><img src="https://img.shields.io/badge/version-2.8.3-9cf" alt="Version"></a>
   <a href="https://www.npmjs.com/package/@v587d/capital-generation"><img src="https://img.shields.io/npm/v/%40v587d%2Fcapital-generation" alt="npm version"></a>
 </p>
 
@@ -72,7 +72,7 @@ https://github.com/v587d/capital-generation
    | [AnySearch](https://www.anysearch.com/docs) | 网页搜索和正文提取 |
    | [Wind Alice](https://market.windalice.com/#/home) | 公告与新闻检索，以及宏观/行业/汇率指标与按日期区间取的历史 K 线 |
    | [PaddleOCR AIStudio](https://aistudio.baidu.com/paddleocr) | 解析 PDF 和图片中的文字 |
-   | [FTShare（非凸科技）](https://market.ft.tech/gateway/doc/p/pb8eizu3) | A 股行情与日 K 截面、主力资金流、涨跌停、龙虎榜席位、股东人数、指数权重、可转债行情与宏观利率等第二家上游口径 |
+   | [FTShare（非凸科技）](https://market.ft.tech/gateway/doc/p/pb8eizu3) | A 股行情与日 K 截面、主力资金流、涨跌停、龙虎榜席位、股东人数、指数权重、可转债行情、宏观利率，以及期货合约与贵金属行情等第二家上游口径 |
 
     这些都是第三方服务的密钥，需分别向服务方申请；额度和条款以各服务方为准。
     保存后**新建 Capital 模式会话**即可生效，无需重启。
@@ -131,7 +131,7 @@ https://github.com/v587d/capital-generation
 
 ## 还能做什么
 
-- **查数据和资料：** 覆盖A股、港股、美股，由 Agents 按需获取行情、财务、指数、基金与宏观行业数据，检索公告、新闻和研报。共计 **118** 个数据收集能力和 **14** 个网页检索能力，部分公开数据源无需额外密钥；具体覆盖范围见 [数据收集能力表](docs/data-collector-capabilities.md) 和 [网页检索能力表](docs/web-retriever-capabilities.md)。
+- **查数据和资料：** 覆盖 A 股、港股、美股与期货等品种，由 Agents 按需获取行情、财务、指数、基金与宏观行业数据，检索公告、新闻和研报。共计 **128** 个数据收集能力和 **14** 个网页检索能力，部分公开数据源无需额外密钥；具体覆盖范围见 [数据收集能力表](docs/data-collector-capabilities.md) 和 [网页检索能力表](docs/web-retriever-capabilities.md)。
 - **数据分析：** 所有 Agents 均不直接接触原始结构数据，Agents 按需读取数据、校验数据，并写脚本挖掘数据背后含义。 
 - **可视化：** Agent 视情况将校验后数据交给可视化专家生成可交互图表。图表会作为本轮交付物出现在会话中，可在侧栏查看或离线打开。了解处理流程可看 [Agent 角色说明](docs/agent-roles.md)。
 

package/chart-ui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v587d/capital-charts",
-  "version": "2.8.2",
+  "version": "2.8.3",
   "description": "Capital 模式的图表前端组件（浏览器半边 + 序列旁路路由）：由 @v587d/capital-generation 随包携带并作为 host 平面行挂载。",
   "license": "MIT",
   "type": "module",

package/config/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v587d/config",
-  "version": "2.8.2",
+  "version": "2.8.3",
   "description": "Capital 模式的取数凭据与偏好配置行：卡片坐在 @v587d/capital-generation 插件主页的「配置」段，点这一行本身没有表单。",
   "license": "MIT",
   "type": "module",

package/lib/sources/ftshare-rest.d.ts

@@ -1,13 +1,16 @@
 /**
  * FTShare（非凸科技 `market.ft.tech/gateway`）REST source —— **资金流 + 行情/日 K 截面 + 快照与日历
- * + 大宗与披露 + 申万行业**。
+ * + 大宗与披露 + 申万行业 + 期货与贵金属**。
  *
- * 为什么接这一族（2026-10-15 逐条真报文实测）：
+ * 为什么接这一族（批次 A–E 逐条真报文实测于 2026-10-15，批次 F 于 2026-10-16）：
  * - 同花顺 `capital-flow/*` 对我们是 `code=2004` 永久关闭，东财 `eastmoney_main_capital_snapshot`
  *   实测**只有查询日一股一行**——个股资金流的历史序列在本仓一直是空的。这一族给到最近约 45 个交易日
  *   （T-45 仍有 5199 行、T-50 起 total=0），主力五档更给到约 187 个交易日。
  * - 板块（行业）资金滚动此前只有 `eastmoney_cashflow_rotation` 一条，上游一抖就没有第二家。
  * - 北交所行情此前是**零**：腾讯那一路在参数层明确拒 BJ，而这一族实测含 349 只北证票。
+ * - 期货与贵金属此前在本仓是**整块空白**（`ticker_search` 只允许消歧到期货交易所，没有一条数据端点），
+ *   所以批次 F 那十颗不是第二家，而是第一家：合约清单与要素、日/周/月/季 K 线、涨跌停价、每日结算参数、
+ *   仓单日报、品种周报、南华商品指数、东财会员持仓排名、贵金属价格。
  * 上游分别是同花顺与同花顺 daec，与现有能力**不是同一条抓取路径**，才够称 plan B。
  *
  * ⛔ 本模块的 description 与注释**只允许写有原始报文可回查的数字**。2026-10-15 曾有一批"实测计数"