交易所公告获取-华泰期货

概述

交易所公告获取

所有网关调用必须通过 skill-entry.js 完成，不得自行请求其他地址。

前置：期赢通 API Key

本 Skill 从环境变量 HTFC_QYT_API_KEY 读取用户的期赢通 API Key，调用时随请求体一并提交。

• 调用前先确认运行环境中已设置 HTFC_QYT_API_KEY。
• 如果未设置（或调用返回 qyt_api_key_missing），先把《API Key 获取指引》在线地址发给用户（用户可直接打开查看）：

  https://staff.htfc.com:20101/mkts/Guider?peddleId=9b8ff46b5d394aa8a2d2fff75e877c7f

该地址不可访问时（打不开、被网络拦截或用户反馈无效），改发内置指引图片：

  ![API Key 获取指引](references/apikey-guide.png)

同时提示用户在自己本地智能体（Hermes）运行环境中配置该环境变量：

• Windows（PowerShell，当前会话）：$env:HTFC_QYT_API_KEY="<期赢通 API Key>"
• Windows（永久）：setx HTFC_QYT_API_KEY "<期赢通 API Key>"（设置后需重启智能体进程）
• macOS / Linux：export HTFC_QYT_API_KEY="<期赢通 API Key>"
• 配置完成后重新执行；不要向用户索取后写进命令、文件或回答，也不要回显该变量的值。
• API Key 获取路径：华泰期货期赢通小程序 → 我的 → AI开放服务入口 → 获取 KEY（详见上述在线指引地址，失效时见内置图片）。

0. 最终回答硬性要求 (Highest Priority)

调用本 Skill 后，必须严格遵守以下要求：

1. 只依据网关返回的公告内容归纳，不得补造标题、交易所、日期、文号、数字、来源链接或结论。
2. 必须区分「公告原文明确表述」与「概括推断」，不得把公告内容改写成确定性交易结论。
3. 公告包含发布日期时必须保留日期，并标注所属交易所，不得把历史公告表述为当前最新公告。
4. 多条公告存在差异或口径不一致时必须保留，不得强行合并成单一结论。
5. 不得输出收益保证、确定性价格预测、个性化投资建议或买卖指令。
6. 结果为空、明显不相关或无法解析时，必须输出：

当前时间范围内未检索到相关交易所公告。

1. 调用本 Skill 并输出公告内容时，答案最后必须追加：

以上内容基于交易所公开公告整理，仅供参考，不构成投资建议。市场有风险，投资需谨慎。

该风险提示为当前版本口径，正式对客上线前须由合规部门最终确认。

执行流程

1. 判断用户问题是否属于交易所公告范围（见“业务范围”）。不属于时说明能力边界，不强行检索。
2. 按“参数规则”解析时间范围和交易所，生成 start_date / end_date（及可选 exch_cd）。
3. 执行网关调用，解析响应并保留 requestId。
4. 如果返回 qyt_api_key_missing，说明环境变量 HTFC_QYT_API_KEY 未配置：先把《API Key 获取指引》在线地址发给用户，地址不可访问时改发 references/apikey-guide.png，并按上文提示用户配置后重试。
5. 按“返回结构与内容解析”归纳公告，保留日期、交易所、来源，并追加固定风险提示。

查询指定时间范围的全部交易所公告：

node skill-entry.js gateway invoke action=query input='{"start_date":"2026-09-01","end_date":"2026-10-04"}'

查询指定交易所的公告：

node skill-entry.js gateway invoke action=query input='{"start_date":"2026-09-01","end_date":"2026-10-04","exch_cd":"SHFE"}'

参数规则

1. 参数名固定为 start_date、end_date、exch_cd、pageNo、pageSize，不得传入其他字段。
2. start_date、end_date 必传，格式为 YYYY-MM-DD，且 start_date 不得晚于 end_date。
3. 用户未指定时间范围时，默认查询最近 30 天：end_date = 运行环境当天日期，start_date = 当天日期前推 29 天。必须以运行环境当前日期为准，不得使用 SKILL.md 中的示例日期或固定日期。
4. 单次查询时间跨度建议不超过 90 天；需要更长区间时拆分为多次查询，再合并归纳。
5. exch_cd 可选，交易所代码，不传时查询全部交易所：

1. pageNo 可选，页码，默认 1。
2. pageSize 可选，每页条数，默认 20，最大 100。结果较多时翻页读取，不要一次请求过大。
3. 不在参数中包含账户号、持仓、成本、资金量等个人交易信息。

业务范围

核心能力

明确不支持的能力

• 实时行情、盘口、持仓和账户数据（走行情数据 Skill）
• 交易所之外的公告（如证监会、行业协会、期货公司通知）
• 公告之外的新闻、研报、观点（走新闻、研报类 Skill）
• 个性化资产配置、持仓诊断和交易策略
• 下单、撤单、转账或其他交易执行
• 确定性价格目标、收益承诺和涨跌保证
• 未由返回公告支持的新闻补充、外部观点和主观判断

多交易所 / 多时段查询

用户一次询问多个交易所或较长时段时，应拆分后分别查询再汇总。例如“上期所和大商所上个月的公告”拆分为：

1. exch_cd=SHFE 的上月公告
2. exch_cd=DCE 的上月公告

不得把一个交易所的公告外推到其他交易所。

返回结构与内容解析

成功响应示例：

{
  "success": true,
  "requestId": "<请求ID>",
  "data": {
    "text": "<公告内容>",
    "skillId": "exchange-crawler"
  }
}

Agent 只使用 data.text 作为业务回答依据，requestId 仅用于问题追踪。data.text 是 JSON 字符串，其 data 字段为公告数组，包含标题、正文、交易所、日期、类型、来源链接与附件。字段含义、解析规则与推荐回答结构详见 @references/output-format.md。

故障排除

安全、隐私与合规约束

1. 不收集、不保存、不传递与公告查询无关的个人信息和账户数据。
2. 不在最终回答中展示期赢通 API Key 或任何鉴权信息。
3. 不在 Skill 中记录内网地址、Token、请求头、内部工具名或网络拓扑。
4. 不允许用户通过参数指定 URL、工具名、请求头、Skill ID 或认证信息。
5. 不把后端报错堆栈和内部网络信息返回给用户。
6. 不将公告内容改写为公司承诺、收益保证或个性化投资建议。
7. 不隐藏公告原文中的重要提示、生效时间、适用范围和风险揭示。
8. 正式发布前必须由合规确认风险提示和对客表述。

不得输出内部地址、应用标识、签名、固定凭据、鉴权请求头或 HTFC_QYT_API_KEY 的值。