用途
china-stock-analysis 是一个面向低频交易普通投资者的 A 股分析工具，基于价值投资理论，通过 akshare 获取公开财务数据，用于股票筛选、个股分析、行业对比与估值测算。
主要能力
工具包含四个核心模块：
- 股票筛选器：按估值（PE、PB、PS）、盈利能力（ROE、ROA、毛利率、净利率）、成长性（营收增长率、净利润增长率、连续增长年数）、股息（股息率、连续分红年数）和财务安全（资产负债率、流动比率、速动比率）等条件筛选股票，范围可选全 A 股、沪深 300、中证 500、创业板/科创板或自定义列表。
- 财务分析器：对个股做深度财务分析，支持摘要、标准、深度三种级别。
- 行业对比：对多只股票或同行业股票做横向对比，输出指标对比表与评分。
- 估值计算器：支持 DCF、DDM 和相对估值方法，计算内在价值与安全边际。
分析过程中还会自动检测财务异常信号，包括应收账款异常、现金流背离、存货异常、毛利率异常、关联交易占比过高和股东减持等，并按低、中、高风险分级。同时提供 A 股特色分析，如行业政策敏感度提示和股东结构分析（控股股东类型、股权集中度、增减持、质押比例）。
使用方式
需要 Python 环境并安装依赖：
pip install akshare pandas numpy
执行分析前先检查 akshare 是否已安装：
python -c "import akshare; print(akshare.__version__)"
四个工作流分别对应筛选、个股分析、行业对比和估值计算。以筛选为例：
python scripts/stock_screener.py \
--scope "hs300" \
--pe-max 15 \
--roe-min 15 \
--debt-ratio-max 60 \
--dividend-min 2 \
--output screening_result.json
个股分析流程为：先用 data_fetcher.py 抓取数据，再用 financial_analyzer.py 做财务分析，然后用 valuation_calculator.py 计算估值，最后参考 templates/analysis_report.md 模板生成中文报告。脚本统一输出 JSON，便于后续处理。
适用场景
适合普通投资者对 A 股做低频的价值投资研究，例如按财务指标初筛股票、对单只股票做财务健康与估值分析、在同行业公司之间做横向比较，以及用 DCF/DDM/相对估值法测算内在价值与安全边际。
限制
所有分析基于公开财务数据，不涉及内幕信息；估值模型参数假设对结果影响较大，需向用户说明；A 股受政策影响较大，定量分析需结合定性判断。财务数据以最新季报/年报为准，价格数据为当日收盘价。所有分析仅供参考，不构成投资建议。若 akshare 数据获取失败，可能是网络问题或接口限流，需稍后重试；股票代码无效或数据不完整时，应说明数据限制并基于可用数据分析。