国投证券智能选股

要解决的问题

手动筛选股票通常要在行情软件里逐项设置条件，或者把需求拆成 SQL 式的字段再交给数据终端执行。当你脑子里想的是「市值超过 1000 亿、ROE 大于 15%、最近一季度净利润增长超 30%」，表达出来却要转换成一堆输入框和选项卡。这个技能要消除的正是自然语言与查询条件之间的这道手工转换层——你直接用中文说条件，剩下的解析、校验、请求由它完成。

核心能力

技能的后端是一个国投证券的智能选股 API，接口为 GET https://skills.sdicsc.com.cn/skill/condition-select-stock/api/stockSelectSkill，唯一必填参数 query 是经过 URL 编码的自然语言选股条件，认证通过请求头 X-API-Key 完成。

关键步骤包括：

• API Key 前置配置：调用前必须先检查 sdicsc-smart-stock-selection/memory.md 中是否已写入 API Key，并据此设置环境变量 GT_ZXNG_KEY；脚本只从该环境变量读取凭证，每次调用都要重新设置。
• 意图解析：从中文描述中提取数值、指标、比较符，支持价格、涨跌幅、市值、行业、技术指标（MACD、KDJ、RSI、均线）、财务指标（PE、PB、ROE、净利润、营收）、资金与行情指标（换手率、成交量、振幅）以及组合条件和时间限定。
• 模糊条件追问：当输入只有数值、指标不明确时——例如「大于 100 的股票」——必须追问指的是股价、市值、股本还是市盈率，而不是猜一个直接查。
• 条件合理性校验：调用 API 前做本地校验，拦截数值异常（市盈率大于 10000）、逻辑矛盾（市盈率同时低于 10 且大于 50）、条件过宽或过严的情况，校验不通过不发起请求。
• 异常处理：500 与超时自动重试最多 3 次（间隔 ≥2 秒）；401 提示未配置 Key，403 提示 Key 无效，429 与 503 提示服务限流，这些都不重试。
• 结果解析：返回是 JSON 数组，每个元素含市场代码、简称、证券代码；直接用 len(data) 得数量，无需二次统计；输出时必须标注数据截止日期。
• 连续追问：支持在历史条件上追加（「再增加 ROE 大于 15%」）或修正（「把市盈率改为低于 30」），合并成完整条件后重新请求。

适用边界与注意点

• 查询条件需用中文自然语言描述，API 侧负责语义理解，复杂或歧义表述可能解析不准确。
• query 必须做 URL 编码；返回空数组时需要放宽或调整条件。
• 结果默认不排序，如需排序需在条件里显式指定（如「按市值从大到小」）。
• 数据来自公开数据源，准确性与完整性不做保证，过往业绩不代表未来表现。
• 所有输出仅供学习参考，不构成投资建议或决策依据，市场有风险。