金融分析与资讯查询工具 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：

• 个股分析：综合分析、投资价值、基本面、财报解读、事件分析、股价走势、机构观点、估值分析、建仓/出货时机、投资逻辑制定
• 大盘分析（A股/港美股）：走势预测、走势分析、资金流向、涨跌归因、事件催化、热门板块、事件影响、估值、大盘复盘
• 概念/板块/行业/ETF 分析：综合分析、投资价值、增长前景、生命周期、事件影响、走势分析与预测、资金面、机构观点、估值
• 股票多标的对比：同行业/跨行业综合对比、基本面对比、财务/财报对比、走势对比、指标对比
• 金融资讯查询：个股/多股相关新闻资讯检索、利好利空消息分类整理、指定时间范围内的资讯汇总、板块/行业/市场新闻聚合
• 宏观事件与选股/荐股：基于宏观经济、地缘政治、政策变化等事件分析其对金融市场的影响
• 分析诊断：个股分析诊断

详细的问题分类和示例请参阅 references/CATEGORIES.md

不应触发的场景

• 纯编程或技术开发问题
• 金融条件选股（如"帮我找PE低于20的股票"）
• 涉及具体交易操作指令（如"帮我买入XX"）
• 非金融类的新闻查询（如天气预报、体育赛事等）

响应结构

成功：

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

失败：

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

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

工具

diagnosisStock

对个股、ETF、板块等进行分析诊断。

何时调用：用户要求对个股、ETF、板块等进行分析诊断、诊断报告。

参数：
- query：用户问题（必填）

执行：python3 financial_analysis.py diagnosisStock --query <query>

marketInsight

市场洞察，覆盖个股分析、大盘分析、板块/行业分析、多标的对比、金融资讯、宏观事件与选股等。

何时调用：不属于分析诊断的其他金融问题。

参数：
- query：用户问题（必填）

执行：python3 financial_analysis.py marketInsight --query <query>

调用模式速查

配置

环境变量：