财信证券-财务诊断

概述

财信证券股票财务分析

使用 scripts/finance_query.py 调用 code_finance_analysis。不要手写 HTTP 请求；先查询数据，再按明确口径解释。

核心流程

1. 确认沪深京 6 位股票代码；不能从名称唯一解析时要求用户确认。
2. 判断用户只需要单项指标、单张报表、指定维度，还是完整财务诊断。
3. 运行所需子命令并检查退出码；失败时不要把错误解释为空数据。
4. 对历史比较使用相同报告期的年度同期，不混合一季报、半年报、三季报和年报。
5. 仅依据返回字段给出结论，并注明报告期、单位、数据不足和适用限制。

仅支持沪深A股和北交所。银行、保险、券商等金融企业可以查询报表，但不要套用本 Skill 的通用六维诊断框架；应说明金融行业需要专门监管与资本充足性指标。

查询路由

普通营收、净利润、毛利率、ROE 和资产负债率问题优先使用本 Skill。只有用户明确要求“证券详情/info/公司资料中的字段”时，才改用行情 Skill 的 info。

服务与凭证

调用前先做前置检查：确认 ~/.config/caixin/config.json 中已配置非空 CXZQ_API_KEY（鉴权 API Key）。未配置时不要调用接口，直接提示用户：

未检测到鉴权用的 API Key（CXZQ_API_KEY）。请登录财信证券 Skills 获取：

https://lz.cfzq.com/ai-skill-client/home?opentype=newpage&fullscreen=1&navcolor=2B313D&darkbar=1

• 接口地址：https://lz.cfzq.com/technologyshare/client/api/skill/common_bus
• 请求命令：code_finance_analysis
• 凭证文件：~/.config/caixin/config.json
• 凭证字段：CXZQ_API_KEY
• 请求头：apiKey

默认地址为生产环境；如需接入测试等其他环境，使用 CAIXIN_API_URL 覆盖，不要直接改写脚本。

{
  "CXZQ_API_KEY": "your_api_key_here"
}

只从配置文件读取密钥，不要在提示词、日志或输出中暴露密钥。脚本默认执行标准 TLS 证书校验。匿名使用事件上报默认关闭；仅在用户明确允许时设置 CAIXIN_ENABLE_REPORTING=1，且上报内容不得包含 API Key 或设备指纹。

调用方式

将 {baseDir} 替换为本 Skill 目录 caixin-stock-finance-analysis，使用可用的 Python 3 解释器。

# 单项指标和单张报表，默认返回最近 5 期
python3 {baseDir}/scripts/finance_query.py indicators --code 600519 --re-type 1
python3 {baseDir}/scripts/finance_query.py income --code 600519 --re-type 1
python3 {baseDir}/scripts/finance_query.py cashflow --code 300750 --re-type 1
python3 {baseDir}/scripts/finance_query.py balance --code 300750 --re-type 1

# 完整诊断：每张表选择最新报告期及前两年同月日记录
python3 {baseDir}/scripts/finance_query.py indicators --code 600519 --re-type 1 --same-period-years 3 --limit 0
python3 {baseDir}/scripts/finance_query.py income --code 600519 --re-type 1 --same-period-years 3 --limit 0
python3 {baseDir}/scripts/finance_query.py cashflow --code 600519 --re-type 1 --same-period-years 3 --limit 0
python3 {baseDir}/scripts/finance_query.py balance --code 600519 --re-type 1 --same-period-years 3 --limit 0

# 排查接口原始返回
python3 {baseDir}/scripts/finance_query.py indicators --code 600519 --raw

参数规则：

单项指标规则

空字符串和缺失字段不等于 0。用户问一个指标时只回答该指标、报告期、单位和必要口径；不要无故扩展成完整诊断。

历史比较口径

• 使用脚本按 endDate 从新到旧排序后的结果。
• 使用 --same-period-years 3 选择最新期及前两年相同月日的记录。
• 数据不足三年时明确写明实际可比期数，不补算缺失年份。
• 利润表和现金流量表必须比较相同累计期间；资产负债表比较同一报告日的期末余额。
• 分母为 0、负数或字段缺失时，不计算需要正分母的比率；说明该指标不可比。
• 金额字段以元返回；面向用户可转换为亿元并保留两位小数。百分比字段直接添加 %，不要再次乘以 100。

完整财务诊断

执行完整诊断前必须读取 [references/diagnosis_framework.md](references/diagnosis_framework.md)。核对字段名和单位时按需读取 [references/field_dictionary.md](references/field_dictionary.md)。

按以下顺序输出：综合概括 → 盈利能力 → 财务指标稳定性 → 成长能力 → 经营效率 → 现金流 → 债务风险。每个实际有数据的指标包含“指标数据、解读”，并在每条解读之后以“（AI解读，仅供参考）”作为合规附注。

完整诊断不得只输出维度总结；每个维度必须逐项覆盖诊断框架中列出的指标。

遵守以下限制：

• 只使用四张报表返回的数据，不引用未提供的行业均值、外部估值或事件事实。
• 只有用户或接口明确提供研发投入期、重大并购等事实时才讨论特殊事项；不得自动识别或自动豁免。
• 经验阈值只作为风险提示，不作为确定结论。
• 正负信号并存时同时呈现，避免单边判断。
• 严格按诊断框架列出的维度和指标输出，不得自行新增分析模块，不得跨模块跳跃；每个指标依据框架对应字段和口径执行。
• 输出前做一遍质检：核对维度齐全、指标按框架覆盖、口径一致、解读附注与末尾免责声明到位、用词符合下述合规要求。
• 证券合规口径：基于报表事实客观描述，不做买卖/持仓建议，不预测股价走势，不给出“买入/卖出/增持/减持”等投资评级，避免主观褒贬和单边推荐。
• 禁用极端偏好词：不得使用绝对化、极端化或最高级措辞，举例词表包括「最、极、极度、极端、第一、唯一、首届、首个、最佳、最优、最强、最高、最低、最大、最小、领先、领军、龙头、顶级、卓越、完美、无可比拟、独占、独霸」等；需要比较时改用相对/区间/历史对比的客观表述，并给出示例（“近三年同报告期内处于相对高位”“同比改善”）。
• 报告末尾注明“本分析系模型基于公开财务数据作出，仅作参考，不构成任何投资建议”。

输出与失败处理

成功的标准化输出包含 ok、code、statement、statement_name、reType、limit、same_period_years、total 和 items。items 已按报告期从新到旧排列。

脚本在网络错误、无效 JSON、业务返回码非 0、参数错误或凭证错误时输出 ok: false 并以非零状态退出。

凭证类错误（80002、80009）的处理提示统一附带获取入口：https://lz.cfzq.com/ai-skill-client/home?opentype=newpage&fullscreen=1&navcolor=2B313D&darkbar=1

接口成功但 items 为空时说明“接口未返回该报表数据”。不要把请求失败、参数错误和空数据混为一谈。