⚙️ 运行环境契约（最高优先级，先于本文其余内容执行）

本技能可能运行在 QuantBot（QwenPaw 容器） 或宿主机/本地 Claude Code。执行前先探测环境（which docker、API 连通性），并遵守以下映射规则：

1. 后端 API 地址：QwenPaw / 容器网络内一律用 http://quantmind:8000（quantmind 是 docker 网络别名）；仅宿主机调试用 http://127.0.0.1:8000。正文中出现的 127.0.0.1:8000、localhost:800x，在 QwenPaw 环境下自动替换为 http://quantmind:8000。
2. 取数脚本执行：凡 import 了 pandas / duckdb / psycopg2 / numpy / sqlalchemy 等重依赖或 backend 包的脚本，必须在 quantmind 容器内执行（QwenPaw 本地 venv 无这些依赖）：

   docker cp <脚本路径> quantmind:/tmp/<脚本名> && docker exec -w /app quantmind python3 /tmp/<脚本名> <参数>
   

   脚本源三选一：宿主机 repo skills/<name>/scripts/、QwenPaw 工作区 /app/working/workspaces/default/skills/<name>/scripts/、挂载目录 /quantmind/skills/<name>/scripts/。纯标准库脚本（无重依赖）可在 QwenPaw 本地直接跑。
3. 报告落盘：股票报告页可见的 MD/PDF 报告，直接写 /data/reports/trading_agents/{市场或类别}/{股票名}/（QwenPaw 对 /app/db 有写权限，直接写文件，不要 docker cp）；过程数据 facts 写 /data/reports/<类别>/（/data 可写）。
4. MD → PDF 转换（按优先级降级）： ① docker exec -w /app quantmind python3 backend/scripts/md_to_pdf_report.py <输入.md> <输出.pdf>（研报级排版，首选）； ② docker 不可用时，改用 QwenPaw 内置 pdf 技能把 MD 转成 PDF； ③ 两者都不可用则只交付 MD，并明确告知用户 PDF 未能生成及原因。
5. 本文中的 ~/.claude、cp -r ... ~/.claude/skills 等说明仅适用于本地 Claude Code 维护者，QuantBot 不要执行。

股票市场深度数据分析与导出

基于 QuantDB 全量数据（K线/财务/估值/技术/315维因子/融资融券/股东户数）的股票市场深度分析 + 数据导出技能。

⚠️ 数据计算零容忍（本技能最高优先级） 所有涉及金额、成交量、比率的计算必须先查 [[quantdb-fields]] 技能核对单位与口径， 并在报告中注明换算步骤。单位/口径错 = 结论全部作废。核心陷阱：

陷阱	正确口径
个股 volume=股、amount=万元	指数 volume=手、amount=万元
close*volume/amount ≈ 1e4（个股自检公式）	指数 ≈ 2e4
technical_indicators 的 close=后复权	valuation/market_sentiment=不复权
valuation dividend_rate 是百分数（0.148=0.148%），20260814 起才切换	之前是小数口径，跨日分析必须 ×10 归一
l1 vol_std_* 是小数（0.0406）	technical_indicators vol_std_* 是 %（4.06），差 100 倍
/research/features API 已换算：市值→亿元、flow*→百万元	parquet 原值：市值=元、flow=元（差 1e8/1e6）
l2_factors 分区停滞 20260227	用前先查最新日期，近期 l2 型字段大量 NaN 是正常的
min1/min5 停更 20260724、hsgt_north 停更 202408	别当实时数据用
财务 parquet 单位=元	instrument_detail J_*=万元、Zsz/Ltsz=亿元
股息：dividend_factors interest=每10股派息	算每股股息要 /10
risk/features 接口的 MA/ATR 是复权口径陷阱（高危）：ma*/ma_gap*/vol_atr_14 曾取自 features_daily（后复权），与 OHLCV（前复权）混用 → 比音勒芬 002832 曾被误判「跌破均线」（ma5=147 vs 实际价 26.08）	20260817 起已修复：stock_daily_latest 的 MA/gap/ATR 改为基于前复权 close 重算（ma_gap_N=(close/maN−1)×100，ATR=Wilder）。引用接口 MA 前必须用 /research/kline 实际数据自算核对（pandas rolling），接口值 ≠ K线算出的值 → 立即按 K 线为准并标注口径

认证

BASE=http://127.0.0.1:8000
TOKEN=$(curl -s -X POST $BASE/api/v1/auth/login -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"admin123","tenant_id":"default"}' \
  | python3 -c "import sys,json; print(json.load(sys.stdin).get('access_token',''))")
AUTH="Authorization: Bearer $TOKEN"
CT="Content-Type: application/json"

1. 全市场信号扫描（选股）

# 全市场扫描：11000+ 信号 → 精简候选
curl -s -H "$AUTH" "$BASE/api/v1/selection/daily"
# 返回: {meta:{trade_date, total_signals, strategy_config}, market_state:{state,should_enter,position_advice}, candidates, industry_signals}
# candidates 每项: {symbol, name, score, industry, trend, buy_reason, warnings}

# 指定策略 / 指定日期 / 忽略 MA20 空仓保护
curl -s -H "$AUTH" "$BASE/api/v1/selection/daily?strategy=aggressive"
curl -s -H "$AUTH" "$BASE/api/v1/selection/daily?date=2026-08-14&ignore_ma20=true"

# 选股历史 / 做空候选（负分分析）
curl -s -H "$AUTH" "$BASE/api/v1/selection/history"
curl -s -H "$AUTH" "$BASE/api/v1/selection/negative"

2. 行业轮动与板块分析

选股响应的 industry_signals 字段包含各行业强度信号（行业 Top1 分数均值、强行业数等）：

板块热度交叉验证（页面版端点，/api/v1/market-analysis/*）：

curl -s -H "$AUTH" "$BASE/api/v1/market-analysis/money-flow/period?period=5d&dimension=sector&category=shenwan&limit=25"
curl -s -H "$AUTH" "$BASE/api/v1/market-analysis/heatmap?trade_date=2026-08-14"
curl -s -H "$AUTH" "$BASE/api/v1/market-analysis/tags/by-tag?tag=半导体"

3. 个股研报级深度分析（核心流程）

用户要求"分析/深度分析"某股票时，按 REFERENCES/quantdb-full-analysis-design.md 的 9 层框架执行（L0 市场 → L1 估值 → L2 财务 → L3 技术 → L4 资金筹码 → L4b 订单微结构截面 → L5 行业 → L6 模型 → L7 新闻七维）。 每层必须有具体数值、必须展示计算公式，不做泛泛之谈。输出格式见第 7 节研报模板。

⚡ 跑全流程先读 REFERENCES/stock-9layer-runbook.md（端到端操作手册）：一键取数 scripts/stock_9layer_fetch.py {code} → 九层判读模板 → 跨层合成 → 报告落盘命令 → 双案例校准（法拉电子/振华科技）→ 红线清单。设计原则看 design doc，执行标准看 runbook。

两个特化子方法（2026-08 集成）：

• L4b 订单微结构：按《L2 微观结构因子系统化分析报告》判 IC 方向 + 计算个股 vs 全市场截面分位。铁律：VPIN 族是正 IC（高位偏多，别当毒性利空）、vol_persistence/toxicity_persistence 是负 IC（高位偏空）、L2 是 T+5/T+10 持续信号（看状态分位而非单日变化）。
• L7 新闻七维：按 [[news-sentiment-research]] + docs/news_sentiment_deep_report.md §13 做三步纵深——①直接消息判定（无则明写）→ ②相关行业归类（禁止冒充个股消息）→ ③21 条规律对照打分（来源/时段/多篇/首日动量/反转/标签/板块）→ 输出明确新闻面结论。

3.1 数据采集（先全量拉取，再按需深挖）

# ① 全维度特征（估值/技术/动量/波动/流动性/资金流/风格/行业/筹码/概念/微观结构/情绪，371 字段）
#    注意：API 已换算单位（市值→亿元、flow*→百万元、totalMv→亿元），引用时注明
curl -s -H "$AUTH" "$BASE/api/v1/research/features/600519.SH"

# ② K线（120 日，不复权价 + adj_factor）
curl -s -H "$AUTH" "$BASE/api/v1/research/kline/600519.SH?days=120"
# 多市场 K 线（A-HK-US，daily；A股 QuantDB 本地 parquet 优先）
curl -s -H "$AUTH" "$BASE/api/v1/market/kline?symbol=600519.SH&market=A&period=daily&days=120"

# ③ 模型信号（按 model_id 逐个拉，多模型共识；详见 3.7）
curl -s -H "$AUTH" "$BASE/api/v1/models"                    # 用户模型列表（items[]，含 id/metadata/is_default）
curl -s -H "$AUTH" "$BASE/api/v1/models/inference/stock/600519.SH/history?days=180"
curl -s -H "$AUTH" "$BASE/api/v1/models/inference/stock/600519.SH/history?days=180&model_id=xxx"

# ④ 风险评分卡（6 维度 + veto 项）
curl -s -H "$AUTH" "$BASE/api/v1/risk/score/600519.SH"

# ⑤ 大盘环境（L0，先于一切）
curl -s -H "$AUTH" "$BASE/api/v1/selection/daily"           # market_state 牛熊+仓位建议
curl -s -H "$AUTH" "$BASE/api/v1/market/index-kline?symbol=000001.SH&days=60"
curl -s -H "$AUTH" "$BASE/api/v1/market/overview"           # 多市场指数概览

# ⑥ 订单微结构截面分位（L4b，2026-08 新增；先确认最新分区）
docker exec quantmind ls /data/quantdb/6_ml_datasets/l2_factors/ | tail -1   # → dt=YYYYMMDD
docker exec quantmind python3 - <<'EOF'
import duckdb, pandas as pd
dt = "YYYYMMDD"   # 上一步最新分区
mkt = duckdb.connect().execute(f"SELECT * FROM read_parquet('/data/quantdb/6_ml_datasets/l2_factors/dt={dt}/data.parquet')").df()
s = mkt[mkt.symbol == "600519.SH"].iloc[0]
for f in ["vol_persistence","micro_vpin_vol_ratio","flow_buy_amount","flow_sell_amount",
          "micro_toxicity_persistence","flow_order_duration_p90","flow_cancel_lifetime",
          "flow_order_arrival_rate","micro_trade_interval_mean","vol_tick_density","vol_realized_jump",
          "micro_vpin_50","micro_vpin_ma_20","vol_realized_rrv"]:
    print(f, round(float(s[f]),4), f"{round(100*(mkt[f].astype(float)<float(s[f])).mean(),1)}%")
# 判读：负IC族(v_persist/toxicity_persist/flow_buy/sell/order_arrival/tick_density/realized_jump)≥70%高位=利空；
#       正IC族(vpin_vol_ratio/order_duration/cancel_lifetime/trade_interval_mean/vpin_50/ma_20)≤40%低位=缺资金
EOF

# ⑦ 新闻三步纵深（L7，方法论见 docs/news_sentiment_deep_report.md §13）
#    ①直接消息：Huntly 库按标题/正文搜 {名称}/{代码}（窗口 T-2~T）；②相关行业归类；③21 条规律对照
curl -s -H "$AUTH" "$BASE/api/v1/news/articles?tickers=600519&industries=白酒&limit=30&strong_only=true"
curl -s -H "$AUTH" "$BASE/api/v1/news/articles?tickers=600519&sort=sentiment_bullish&limit=10"

3.2 财务基本面（三表联动 + 每股指标，parquet 直读）

财务数据在 parquet（单位=元，季频），/research/features 拿不到， 必须 docker exec 直读：

docker exec quantmind python3 - <<'EOF'
import pandas as pd
base = "/data/quantdb/3_financial_data"
code = "600519.SH"
inc  = pd.read_parquet(f"{base}/income/{code}.parquet")        # 利润表（元）
bal  = pd.read_parquet(f"{base}/balance/{code}.parquet")       # 资产负债表（元）
cf   = pd.read_parquet(f"{base}/cashflow/{code}.parquet")      # 现金流量表（元）
ps   = pd.read_parquet(f"{base}/pershare_index/{code}.parquet")# 每股指标（ROE 直接可用）
dv   = pd.read_parquet(f"{base}/dividend_factors/{code}.parquet")
hn   = pd.read_parquet(f"{base}/holder_num/{code}.parquet")
# 最新 8 期趋势（每期 m_timetag=YYYYMMDD）
for df in (inc, bal, cf, ps):
    print(df.tail(8)[["m_timetag"] + [c for c in df.columns if c in (
        "revenue","net_profit_incl_min_int_inc","net_cash_flows_oper_act","s_fa_eps_basic",
        "s_fa_bps","s_fa_ocfps","equity_roe","net_roe","sales_gross_profit",
        "inc_net_profit_rate","inventory_turnover","goodwill","tot_assets","tot_liab",
        "account_receivable","inventories","tot_shrhldr_eqy_excl_min_int")]])
print(hn.tail(4)[["endDate","shareholder"]])   # 股东户数（户）
print(dv.tail(4)[["time","interest"]])         # interest=每10股派息（元），每股股息=interest/10
EOF

指标公式（全部写死在报告里，禁止心算）：

• 单季营收增速 = 本期营收 / 去年同期营收 − 1（找去年同期行：m_timetag - 10000）
• 毛利率 = sales_gross_profit（%）；净利率 = inc_net_profit_rate（%）
• 经营现金流/净利润（利润质量）：cf.net_cash_flows_oper_act / inc.net_profit_incl_min_int_inc，连续 2 期 < 1 → 红牌
• 应收+存货增速 vs 营收增速（压货检测）；商誉/净资产 > 30% → 减值风险
• ROE = equity_roe（%）；股息率 = interest/10/close(不复权)×100，与 valuation.dividend_rate 互验
• 股东户数环比 = (本期−上期)/上期：户数↓筹码集中，↑派发

3.3 估值（三维对照 + 历史分位，parquet 直读）

docker exec quantmind python3 - <<'EOF'
import pandas as pd, glob
# 拉近 5 年 valuation 序列算历史分位（Hive 分区 dt=YYYYMMDD/data.parquet）
files = sorted(glob.glob("/data/quantdb/5_technical_derived/valuation/dt=*/data.parquet"))[-1260:]
rows = []
for f in files:
    df = pd.read_parquet(f, columns=["symbol","time","pe_ttm","pb","ps_ttm","dividend_rate","total_mv","float_mv"])
    r = df[df.symbol == "600519.SH"]
    if len(r): rows.append(r.iloc[0])
v = pd.DataFrame(rows).sort_values("time").dropna(subset=["pe_ttm"])
cur = v.iloc[-1]
print("当前 PE %.2f 处于近5年 %.0f%% 分位（%d 个交易日）" % (cur.pe_ttm, (v.pe_ttm <= cur.pe_ttm).mean()*100, len(v)))
print("PB %.2f 分位 %.0f%%，股息率 %.3f%%" % (cur.pb, (v.pb <= cur.pb).mean()*100, cur.dividend_rate))
print("总市值 %.0f 亿元 / 流通市值 %.0f 亿元" % (cur.total_mv/1e8, cur.float_mv/1e8))
EOF

• 注意：valuation.dividend_rate 20260814 起才是百分数口径，此前为小数——历史分位计算必须先按日期统一口径（×10 归一）
• 负 PE / 无盈利 → 用 PB/PS；行业相对：l1 ind_relative_pe（<1 = 相对行业折价，从 /research/features 的 industry 类取）
• 一句话结论模板：PE 23.1x = 近 5 年 18% 分位，行业相对 0.72 → 估值不构成风险

3.4 技术分析（分层递进 + 关键价位）

• 趋势层：MA5/10/20/60 排列（多头/空头/粘合），收盘价在均线系统的位置
• 动能层：MACD（dif/dea/hist 方向 + 柱状收敛/放大）、RSI 6/14（超买超卖 + 背离）、KDJ
• 波动层：vol_atr_14（元）、vol_std_60（%，technical 口径）、beta_20（高 beta = 大盘放大镜，L0 结论加重）
• 量价层：vol_to_ma5/20（量比）、volume_trend_3d（放量上涨 vs 缩量反弹）
• 支撑/压力：K 线近 20/60 日高低点（注意 /research/kline 是不复权价，与后复权指标对比时要先换算）

3.5 资金与筹码（多口径交叉 + 融资融券）

• 分单口径（l2，API 已换算为百万元）：flowSuperNet（超大单）/flowLargeNet（大单）/flowMediumNet/flowSmallNet——三口径同向才可信；parquet 原值是元（差 1e6）
• 全口径：flowNetAmount + flowNetRatio（净流入占成交比）
• 筹码（l1）：chipProfitRatio20/60（获利盘%）、chipConcentration20、chipPeakDistance、chipProfitDelta5（5日获利盘变化——散户接盘还是主力吸筹）
• ⚠️ l2 分区停滞 20260227：flow/chip/micro 型字段近期大量 NaN。若 l2 全 NaN，明确标注「l2 数据缺失（厂商停更），资金结论降级为不可验证」而不是跳过或编造
• 融资融券（parquet，单位：finance_*=万元、slo_volume=股）：

docker exec quantmind python3 - <<'EOF'
import pandas as pd, glob
files = sorted(glob.glob("/data/quantdb/2_base_sector/margin_trading/dt=*/data.parquet"))[-30:]
rows = []
for f in files:
    df = pd.read_parquet(f, columns=["symbol","time","finance_balance","finance_buy","finance_repay","finance_net","slo_volume","slo_net"])
    r = df[df.symbol == "600519.SH"]
    if len(r): rows.append(r.iloc[0])
m = pd.DataFrame(rows).sort_values("time")
cur = m.iloc[-1]
print("融资余额 %.1f 亿元（近30日 %+.1f%%）" % (cur.finance_balance/1e4, (cur.finance_balance/m.iloc[0].finance_balance-1)*100))
print("近30日融资净买入累计 %.1f 万元，融券净卖出 %.0f 股" % (m.finance_net.tail(20).sum(), m.slo_net.tail(20).sum()))
EOF

• 经典背离：股价涨 + 大单净流出 + 获利盘快速上升 = 散户接盘主力派发

3.6 行业与概念（个股强 ≠ 行业强）

• 行业：indStrength20/60、indRotationSpeed20、indCrowding20（拥挤度——太热警惕）、indBreadthUp20、indNetflowRank20、indRelativePe
• 概念：conceptHotScore、conceptMomentumTop3、conceptLeaderScore、conceptCrowdingMax
• 结论三分类：行业强+个股强（共振，最理想）/ 行业弱+个股强（逆势，持续性存疑）/ 行业强+个股弱（掉队）

3.7 模型信号（多模型共识，不只看一个）

• /api/v1/models 拉用户模型列表（items[]，字段 id + is_default）；/api/v1/inference/models（engine 直连）拉系统模型（字段 model_id）
• 按 model_id 逐个拉 history——不同模型是独立视角（不同训练期/周期 T3/T10/T15/融合）
• 三个观察：① 共识度（多模型同方向=高置信，分歧=单独说明）② 趋势（分数序列上升/回落，看变化方向不看绝对值）③ 极值（分数在该模型历史序列的分位）
• signal_side（BUY/HOLD/SELL）+ score_rank（当天批次内截面排名，越小越靠前）并列引用
• 模型与量价/资金背离是最值钱的信号（基本面好但模型持续 SELL = 边际改善未被确认 → "好公司 ≠ 好买点"）

3.8 新闻舆情（催化剂 vs 印证）

curl -s -H "$AUTH" "$BASE/api/v1/news/articles?tickers=600519&limit=30"
curl -s -H "$AUTH" "$BASE/api/v1/news/articles?tickers=600519&industries=白酒&strong_only=true"
curl -s -H "$AUTH" "$BASE/api/v1/news/articles?tickers=600519&sort=sentiment_bullish&limit=10"

• 个股 + 行业双通道；sentiment=bullish|bearish|neutral 分类统计；event_tags 事件标签（并购/财报/解禁/政策）
• 事件型新闻要找后续数据印证（公告增持 → 查资金流是否真流入）
• 无新闻：明确标 [数据缺失]；禁止编造新闻。价值排序：政策 > 公司重大事件 > 行业动态 > 分析师观点 > 市场情绪文

4. 量化数据挖掘（基于 QuantDB 因子）

curl -s -H "$AUTH" "$BASE/api/v1/admin/data-platform/quantdb/catalog"
curl -s -H "$AUTH" "$BASE/api/v1/admin/data-platform/quantdb/preview?dataset=l1_factors&limit=5"

深度挖掘路径（因子组合分析）

5. 数据导出（CSV / Excel）

5.1 导出选股候选 CSV

curl -s -H "$AUTH" "$BASE/api/v1/selection/daily" -o /tmp/selection.json
python3 <<'EOF'
import json, csv
d = json.load(open('/tmp/selection.json'))
meta = d.get('meta', {}); ms = d.get('market_state', {})
cands = d.get('candidates', [])
with open('/tmp/selection.csv', 'w', newline='', encoding='utf-8-sig') as f:
    w = csv.writer(f)
    w.writerow(['代码','名称','分数','行业','趋势','买入理由'])
    for c in cands:
        w.writerow([c.get('symbol'), c.get('name'), round(c.get('score',0),4), c.get('industry'), c.get('trend'), c.get('buy_reason')])
print(f'导出 {len(cands)} 只选股 → /tmp/selection.csv（交易日 {meta.get("trade_date")}，市场状态 {ms.get("state")}）')
EOF

5.2 导出个股全维度特征 CSV

curl -s -H "$AUTH" "$BASE/api/v1/research/features/600519.SH" -o /tmp/stock_features.json
python3 <<'EOF'
import json
d = json.load(open('/tmp/stock_features.json')).get('data', {})
rows = []
for cat, fields in d.items():
    if isinstance(fields, dict):
        for k, v in fields.items():
            rows.append([cat, k, v])
with open('/tmp/stock_features.csv', 'w', newline='', encoding='utf-8-sig') as f:
    w = csv.writer(f)
    w.writerow(['类别','字段','值'])
    for r in rows: w.writerow(r)
print(f'导出 {len(rows)} 个字段 → /tmp/stock_features.csv（API 已换算：市值=亿元、flow=百万元）')
EOF

5.3 导出批量股票对比 CSV

curl -s -X POST -H "$AUTH" -H "$CT" "$BASE/api/v1/research/batch-features" \
  -d '{"symbols":["600519.SH","000858.SZ","601318.SH"],"fields":["pe","pb","roe","totalMv","momRet20d","volStd20","mainFlow"]}' \
  -o /tmp/batch_features.json
python3 <<'EOF'
import json, csv
d = json.load(open('/tmp/batch_features.json')).get('data', {}).get('items', [])
with open('/tmp/stock_compare.csv', 'w', newline='', encoding='utf-8-sig') as f:
    w = csv.writer(f)
    if d:
        w.writerow(['代码'] + list(d[0].get('values', {}).keys()))
        for it in d:
            w.writerow([it.get('symbol')] + list(it.get('values', {}).values()))
print(f'导出 {len(d)} 只股票对比 → /tmp/stock_compare.csv')
EOF

5.4 导出风险评分卡 CSV

curl -s -X POST -H "$AUTH" -H "$CT" "$BASE/api/v1/risk/scores" \
  -d '{"symbols":["600519.SH","000858.SZ","601318.SH"]}' -o /tmp/risk_batch.json
python3 <<'EOF'
import json, csv
d = json.load(open('/tmp/risk_batch.json')).get('data', {}).get('items', {})
with open('/tmp/risk_scores.csv', 'w', newline='', encoding='utf-8-sig') as f:
    w = csv.writer(f)
    w.writerow(['代码','风险分','等级','否决','否决原因','日期'])
    for sym, v in d.items():
        w.writerow([sym, v.get('risk_score'), v.get('risk_level'), v.get('veto'), ';'.join(v.get('veto_reasons') or []), v.get('trade_date')])
print(f'导出 {len(d)} 只风险评分 → /tmp/risk_scores.csv')
EOF

6. 全市场候选池分析（投研）

# 某次推理批次的候选池（含各股行业/概念/指数/分数）
curl -s -H "$AUTH" "$BASE/api/v1/research/overview?limit=100"
# 指定 run 的全池数据（筛选/排序需要全池）
curl -s -H "$AUTH" "$BASE/api/v1/research/universe?run_id=run_20260805_xxx&limit=2000"

7. 研报输出格式（券商研报级排版）

输出报告时必须采用以下结构。Markdown 表格承载所有数据， 每个表格列名带单位，每个计算指标在下方用小字注明公式与数据来源。

7.1 报告骨架

# {股票名}（{代码}）深度分析报告

> **报告日期**：{YYYY-MM-DD}　**数据截至**：{最新交易日，注明各数据集实际日期}
> **分析框架**：市场环境 → 基本面 → 估值 → 技术 → 资金筹码 → 行业 → 模型 → 舆情
> **免责声明**：本报告由 AI 自动生成，仅供研究参考，不构成投资建议。

## 一、投资要点（3-5 条，每条 ≤ 1 行，多空都写）

## 二、核心结论

| 维度 | 评级 | 核心依据（带数值） |
|---|---|---|
| 市场环境 | 中性/偏多/偏空 | 上证 3927 vs MA20 3890，建议仓位 40% |
| 基本面 | 优秀/良好/一般/恶化 | 单季营收 +12.3%，现金流/净利润 1.15 |
| 估值 | 低估/合理/高估 | PE 23.1x = 近5年 18% 分位 |
| 技术面 | 多头/空头/震荡 | 收盘站上 MA20/60，MACD 金叉后柱状放大 |
| 资金面 | 流入/流出/分歧 | 近5日大单净流入 +2.1 亿元 |
| 综合评级 | 买入/增持/中性/减持 | 好公司 + 好价格 + 时机待确认 |

## 三、公司概况与业务透视
（名称、代码、申万行业、上市日期、总市值/流通市值、两融标的与否）

## 四、财务分析（最近 8 个报告期表格 + 趋势解读）
| 报告期 | 营收(亿元) | 单季同比% | 归母净利(亿元) | 毛利率% | 净利率% | ROE% | EPS(元) | 经营现金流(亿元) |
|---|---|---|---|---|---|---|---|---|
（每个 % 值注明：毛利=利润表 sales_gross_profit，同比=本期/去年同期−1，现金流/净利=利润质量）

## 五、估值分析
| 指标 | 当前值 | 近5年分位 | 行业相对 | 判断 |
|---|---|---|---|---|
| PE(TTM) | 23.1x | 18% | 0.72 | 低估 |
| PB | … | … | — | … |
| 股息率 | 0.39% | … | — | … |

## 六、技术分析
（趋势/动能/波动/量价分层 + 关键支撑压力位 + 各指标当前值与判断依据）

## 七、资金面与筹码
（超大单/大单/散户三口径 + 近5日/20日趋势 + 融资融券 + 获利盘 + 派发/吸筹判断）

## 八、行业与概念
（行业强度/拥挤度/资金流排名 + 共振/逆势/掉队分类 + 概念热度）

## 九、AI 模型信号
| 模型 | 周期 | 最新分数 | 180日趋势 | 信号 | 排名 |
|---|---|---|---|---|---|
（共识度 + 与量价背离说明）

## 十、多空证据对照
| 层 | 多方证据 | 空方证据 |
|---|---|---|
（每格带数值，无证据写「—」）

## 十一、风险提示（按严重度排序）
1. **{风险}**：{触发条件 + 影响 + 监测指标}

## 十二、操作建议
| 持仓状态 | 建议 | 触发条件 |
|---|---|---|
| 未持仓 | 等待回踩 62 元或模型转 BUY | 放量突破 68 元可追 |
| 已持仓 | 持有，止损 58 元 | 跌破 MA60 或大单连续 3 日流出减仓 |

7.2 排版铁律

1. 每个数字带单位：亿元/百万元/万元/元、股/手、%、x（倍）——没有单位的数字禁止出现在报告里
2. 每个计算指标带公式：股息率 = 每10股派息 0.98 ÷ 10 ÷ 不复权收盘 66.19 × 100 = 0.148%
3. 每个时间序列注明口径：前复权/后复权/不复权、单季/累计/同比
4. 数据分层标注：API 数据标 [API]、parquet 直读标 [parquet]、模型信号标 [模型]、新闻标 [新闻]；缺失标 [数据缺失]（注明缺的是哪个数据集）
5. 禁止编造：拿不到的数据写缺失原因，绝不估一个数字
6. 评级统一：综合评级只允许 买入/增持/中性/减持/卖出 五档，且必须由多维证据推导，禁止只凭单一指标

7.3 报告落盘（必做，做完才叫交付）

报告生成后必须写入股票报告目录（前端「股票报告」页展示的就是这里）：

db/trading_agents_results/{市场名}/{股票名}/{股票名}{代码}_{日期}_投研分析报告.{md,pdf}
例：db/trading_agents_results/A股市场/工业富联/工业富联601138_2026-08-16_投研分析报告.md

• 市场名：A股市场（无空格）/ 美股市场 / 港股市场 / 区块链市场 / 期货市场
• 文件名三段下划线格式：{股票名}{代码}_{YYYY-MM-DD}_投研分析报告，前端按此解析股票名/代码/日期
• md → pdf 转换（reportlab 只有容器里有）：

  docker cp /tmp/report.md quantmind:/tmp/report.md
  docker exec quantmind bash -lc "cd /app && python3 backend/scripts/md_to_pdf_report.py /tmp/report.md /tmp/report.pdf"
  docker cp quantmind:/tmp/report.pdf /tmp/report.pdf
  

• 落盘权限陷阱：宿主机上 db/trading_agents_results/ 的目录 owner 是容器内 root，宿主机直接 cp md 会 EACCES——必须走 docker cp（容器内路径 /data/reports/trading_agents/...，宿主机的 ./db 挂载到容器 /app/db）：

  docker cp /tmp/report.md quantmind:/data/reports/trading_agents/A股市场/{股票名}/{股票名}{代码}_{日期}_投研分析报告.md
  docker cp /tmp/report.pdf quantmind:/data/reports/trading_agents/A股市场/{股票名}/{股票名}{代码}_{日期}_投研分析报告.pdf
  

• 交付确认：ls 目标目录确认 md+pdf 都存在；只发 /tmp 路径 = 未交付

7.4 PDF 设计规范（研报级视觉）

backend/scripts/md_to_pdf_report.py 已按券商研报风格输出，报告沿用即可：

1. 配色语义（A股红涨绿跌，自动生效）：报告用词按语义自动着色——涨/买入/增持/偏多/流入→红（#C0392B），跌/卖出/减持/偏空/流出/高估→绿（#1E8449），中性/震荡/观望→琥珀（#B07D00）。表格里纯数值单元格按正负自动染红/绿底
2. 表格：深蓝表头白字 + 金色表头底线 + 斑马纹；列宽按内容自适应（CJK 全宽/ASCII 半宽估算，单列封顶 40%）；表头+数据单元格全部居中
3. 标题层级：H2 章节 = 金色竖线 + 深蓝粗体 + 金色细分隔线；H1 = 居中大标题
4. 封面页：深海军蓝底 + 金色双线 + 白字报告标题 + 报告日期/数据截至（自动取自 > **报告日期**/ **数据截至** blockquote 行）
5. 页眉页脚：金色细线 + 当前章节名（跨页延续上一章节）+「第 X 页 / 共 Y 页」+ 免责声明；封面页无页眉页脚
6. 引用块（>）：米色金边提示框；分隔线（---）：金色细线
7. 数字表达：表格中的数字避免夹杂说明文字（如「+24.9% 后回落」应拆到表格外），数值列保持纯数字才能触发红绿底色

8. 复杂度分级（智能体按需选择深度）

9. 相关技能联动

• [[quantdb-fields]] — 必读：全部数据集单位/口径速查（本技能计算正确性的前提）
• [[quantdb-sdk]] — QuantDB 数据源（Key 配置、28 数据集、字段清单）
• [[smart-strategy-stock-picking]] — 条件选股（183 字段 DSL 筛选）
• [[news-sentiment-research]] — 新闻七维方法论（本技能 L7 层的底座，21 条规律 + 三步纵深）
• [[quantmind-operations]] — 模型训练/推理/RSS 新闻
• [[rd-agent-factor-mining]] — 因子挖掘深化分析维度
• L2 微观结构报告 — scripts/L2_微观结构因子系统化分析报告.md（211 因子 IC 方向 + 截面分位框架，本技能 L4b 层的底座）

10. 常见问题