金融指标与行情综合检索 Skill

当用户查询金融指标、行情数据或财务估值时，使用此技能获取专业结果。支持多标的的金融指标查询与解读服务。

首次使用 - 获取 API Key

所有子技能都需要 HT_APIKEY 环境变量才能使用。 如果用户首次使用未配置或者缺失该变量，必须展示本引导流程：

步骤 1：获取 API Key

打开华泰证券 AI涨乐 skill平台注册页面：
https://ai.zhangle.com/nzl/skill-manage/skills.html

注册/登录后，在平台的 【API KEY管理】 中即可创建并复制你的 API Key。

步骤 2：配置环境变量或配置文件

获取到 API Key 后，二选一即可：

方式 A：环境变量

# Linux / macOS
export HT_APIKEY=你的API_KEY

# Windows PowerShell
$env:HT_APIKEY = "你的API_KEY"

# Windows CMD
set HT_APIKEY=你的API_KEY

方式 B：配置文件（推荐，跨 shell 持久化）

mkdir -p ~/.htsc-skills
printf "HT_APIKEY=%s\n" "你的API_KEY" > ~/.htsc-skills/config
chmod 600 ~/.htsc-skills/config

脚本读取优先级：os.environ["HT_APIKEY"] → ~/.htsc-skills/config → 空。

触发条件

当用户的问题属于以下任何类别时，应激活此 Skill：

• 实时与历史行情：包含股票、债券、基金、指数、市场、板块的最新价、实时走势、开盘/收盘价、最高/最低价、涨跌幅、成交量、成交额、换手率及振幅等交易数据
• 基础原子指标：查询流通市值、研报目标价、技术面支撑位/压力位、建议止盈止损位等特定数据点
• 资讯与财务估值：获取净利润、营业收入等财务指标，以及市盈率 (PE)、市净率 (PB) 等估值指标
• 聚合与关联查询：涉及"股价走势"（关联多项行情指标）、多只标的数据横向对比，或任何提及"行情"、"表现如何"、"估值高低"等涉及具体金融标的的模糊表述

只要用户意图涉及"查数值"、"看指标"或"对比表现"，且目标对象为金融标的（股票、债券、基金、指数、市场、板块、期货、权证、大宗商品等），均应优先调用。

不应触发的场景

• 纯编程或技术开发问题
• 金融条件选股（如"帮我找PE低于20的股票"）
• 涉及具体交易操作指令（如"帮我买入XX"）
• 非金融类的新闻查询（如天气预报、体育赛事等）
• 个股分析诊断、投资日历等非指标查询类问题（这些由其他 Skill 处理）

响应结构

成功：

{ "ok": true, "data": { "answer": "..." }, "error": null }

失败：

{
  "ok": false,
  "data": null,
  "error": {
    "code": -2,
    "message": "面向用户的中文说明",
    "category": "business",
    "retriable": false,
    "hint": "下一步该怎么做"
  }
}

成功时直接展示 data.answer，已是结构化 Markdown 格式。失败时按 error.category 处理：

工具

queryIndicator

查询金融指标、行情数据或财务估值。

参数：
- query：用户问题，保留原始表述（必填）

执行：python3 query_indicator.py queryIndicator --query <query>

注意事项：
- 不要拆分多次调用："南京中达昨天和前天的最高价"、"领益智造、国轩高科当日收益情况" → 单次传入完整问句，切勿过度拆分问题
- 不要替换参数：禁止将"昨天"改为具体日期，禁止缩写股票名称
- 不要补充解释：query 参数仅包含用户原话，不添加额外说明

调用示例

配置

环境变量：