ETF多周期体检官（技术面）

用途

用户通常在日线级别先发现某只标的可能有机会（ETF 或个股均可），希望快速确认：从更细的 15/30/60 分钟看择时、从周/月看趋势是否共振，这只标的当前技术面"能不能关注"。

本技能只做纯技术面分析，依赖均线、量价关系、KDJ、MACD 等主流指标， 最终以 HTML 报告呈现六周期快照 + 综合关注等级，不构成任何投资建议。

为什么老年人也能直接用（核心设计）

本技能面向不想、也不会配置任何环境的用户（老年用户）。设计原则：使用者零配置。

• 不开浏览器、不起服务、不填表单：用户只需在对话里说一句"分析 589720"， 由本助手（agent）在本机后台完成全部工作，最后把 HTML 报告弹出来给他看。
• 不用装 Python / 不用 pip：运行依赖由本助手自动确保（首次一次性安装， 之后复用），用户完全无感。
• 不用填 API Key：使用者完全不需要任何 key，全部行情源免 Key 即开即用。
• 数据稳准还快：腾讯/新浪/东方财富等公开接口优先直连，并逐源做新鲜度检测； 某一路连不上会自动换下一路且记住坏源不再撞，六个周期并行抓，整个分析几秒到十几秒。

一句话：用户要做的只有一件事——在对话里给出 6 位代码（ETF 或股票均可）。 其余（装依赖、抓数据、算指标、出报告）全部由助手代劳。

适用范围

• 技能名叫"ETF多周期体检官（技术面）"，但引擎对 ETF 和 A股个股一视同仁：输入任意 6 位 A股代码（5/6 开头上交所、0/3 开头深交所）都能正常分析。
• 脚本会自动核实真实证券名（五路行情渠道逐个试：腾讯→东方财富→新浪→通达信→Baostock（新浪简称是老口径，故取名排在腾讯东财之后），全部查不到才放弃），不会把个股错标成 ETF；都查不到时只报代码，不猜名字。

何时使用

• 用户给出 6 位代码（如 ETF 510300、159915，或个股 000001、300750）并想判断技术面强弱 / 可否关注。
• 用户要求"从多周期 / 15分30分60分日周月 分析这只标的"。
• 用户想看均线、量价、KDJ、MACD 的多周期共振结论。
• 与 etf-grid-screener（网格筛选）配合：本技能用于"下单前的技术面体检"。

工作流（对话触发，唯一主流程）

当用户给出 6 位代码（记为 CODE）时说"分析 / 判断 / 看看 这只 ETF"等意图， 严格按以下步骤执行：

Step 1 · 校验代码

确认 CODE 是 6 位纯数字。不是则礼貌询问正确代码，不要继续。

Step 2 · 准备数据工具（使用者无感，首次几秒）

用托管 Python 一次性确保数据工具就位（已装则秒过）：

python <skill>/scripts/analyze_etf.py --check-deps

只装 baostock 和 pytdx 两个免 Key 小包（合计几秒到半分钟，之后不再装）。 若环境无外网装不上，脚本会自行降级到公开接口，无需报错中断。 等待时可以先用大白话跟用户说一句"正在准备数据，几秒钟就好"。

Step 3 · 运行分析引擎，生成 HTML 报告

python <skill>/scripts/analyze_etf.py CODE --out <workspace>/etf_report.html

• 脚本根据代码自动推断 secid（5/6 开头→上交所 1.，其余→深交所 0.）。
• 拉取 6 个周期 K 线，六个周期并行抓取（总耗时≈最慢一路，不是六路相加）， 每个周期按 腾讯 → 新浪 → 东方财富 → 通达信 → AKShare → Baostock 逐源尝试 + 新鲜度检测：谁的数据最新就用谁，只有全都不新鲜时才退回落后数据兜底。
• 坏源记忆：某路一次取不到，本次运行内自动跳过它一段时间，不反复撞墙—— 单路故障不会拖慢整体。
• 计算每个周期的 MA / MACD / KDJ / 量价 / 结构，做 7 维打分（-100~+100）。
• 合成大级别(月周) / 中级别(日) / 小级别(15/30/60分) 得分与综合结论。
• 生成自包含中文 HTML 报告（内联 CSS，红涨绿跌），并打印 JSON 摘要到 stdout。

Step 4 · 呈现结果

用 present_files 打开生成的 HTML 报告给用户预览，并口头补一句综合结论要点 （关注等级 + 一句话逻辑 + 失效条件）。报告已内置"教育研究用途、不构成投资建议"声明。

若 Step 3 所有数据源均失败，脚本会以退出码 3 结束并给出一句话提示； 此时按下方「运行纪律硬规则」处理，不要自行改用演示数据冒充真实行情。

运行纪律硬规则（防排查马拉松，最高优先级）

用户在等结果，任何排查动作都是在消耗用户的等待时间。铁律如下：

1. 整个流程只允许两条命令：--check-deps 一条、主分析命令一条。 主分析命令一口气跑完，中间严禁穿插任何网络诊断命令 （curl / ping / 代理检查 / 抓包 / 逐个试接口等）。
2. 脚本正常几秒到两分钟内出结果。若一次运行失败（退出码 3 或无数据）， 最多原样重试 1 次；仍失败就收尾：用大白话告诉用户 "当前网络环境暂时取不到行情数据，请过一会儿再试一次"，任务到此结束。
3. 严禁为了找原因开始排查网络 / 代理 / 防火墙 / URL 编码 / 脚本源码—— 那是无底洞（十几分钟都出不来），用户等不起。 也严禁修改脚本来"绕过"。收尾后等用户反馈即可。
4. 唯一例外：命令本身写错（路径不对、参数拼错）可以改正后重跑，这不算排查网络。

全程大白话硬规则（最高优先级）

面向的用户是不懂任何技术名词的普通人，向用户输出的每一句话都必须是大白话：

• 禁用技术词：API、接口、依赖、安装、pip、token、fallback、降级、前复权、不复权、 数据源、端点、请求、超时、JSON——一个都不许出现在对用户说的话里。
• 换成大白话：数据源→"行情渠道"；fallback/降级→"自动换一路"；前复权→"已按最新价格校准"； 依赖安装→"正在准备数据，几秒钟就好"；限流/超时→"刚才那路信号不好，换一路"。
• 脚本输出的进度提示已经是大白话（如"正在准备数据工具……"），可以原样转述； 但不要向用户转述脚本的英文报错或堆栈，翻译成一句人话即可。
• 需要用户做的事只有一件：给 6 位代码。任何需要用户做别的事（装软件、填参数、 改配置）都说明流程错了，回 SKILL.md 找自动化路径。

名称播报硬规则（防张冠李戴，最高优先级）

• 向用户播报证券名称时，只能引用脚本 JSON 输出的 name 字段，一个字都不要改。
• 若 name_verified 为 false（或 name 与 6 位代码相同），说明未能核实到官方简称： 此时必须直接用代码称呼（如"510210"），严禁凭记忆/知识自行猜测或补全证券名称， 也严禁自行添加"XX行业""XX主题"等定语——报错一个名称都是事故。
• 可顺带提示用户："未能核实到该代码的官方简称，请确认代码是否输对。"

解读要点（给用户的话术）

• 综合评分 / 关注等级：由大(20%)中(35%)小(45%)加权。小级别(择时)权重大，大级别偏空但小级别转强时会明确提示"可做短线波段"，而非一刀切空仓。
• 大级别：月×0.35+周×0.65，决定牛熊格局，决定"该不该做大趋势"。
• 中级别（日线）：波段结构，用户最初发现机会的级别。
• 小级别：60分×0.4+30分×0.3+15分×0.3，决定"何时动手"。
• 典型场景：大强+中多+小弱 = 上升趋势中的回踩，宜等小级别重新金叉企稳再关注； 大弱+小强 = 仅超跌反弹，小仓严止损，报告会给出"短线波段"提示框。

数据来源与权威性

| 优先级 | 数据源 | 需要 Key | 说明 | |--------|--------|----------|------| | ① | 腾讯财经 | 免 Key | 公开接口直连，前复权；日/周/月与 15/30/60 分钟全覆盖，双网关互备，实测最快最稳 | | ② | 新浪财经 | 免 Key | 公开接口直连，前复权；可用但有长尾抖动 | | ③ | 东方财富 | 免 Key | 公开接口直连，前复权，分钟线含当日 | | ④ | 通达信直连 | 免 Key | 盘中实时，日/周/月线含当日进行中的 K 线，取前复权 | | ⑤ | AKShare | 免 Key | 数据源广（可选安装） | | ⑥ | Baostock | 免 Key | 最后兜底（分钟线只取近 45 天，避免查询超时） |

新鲜度检测：按上表顺序逐源尝试，谁的最后一根 K 线最接近当前交易日就用谁； 若某源数据不是最新的就跳到下一源；只有所有源都不新鲜时才用落后数据兜底， 并在报告中如实标注。这解决了"盘中日线还是昨天那根"的老问题。

使用者完全不需要关心上面这些——依赖由助手自动装，全部免 Key。

无需配置任何 Key

使用者视角：你什么都不用做，在对话里发 6 位代码即可。

本版本的行情源全部免 Key（腾讯/新浪/东财/通达信/AKShare/Baostock）， 不需要 token、不需要注册、不需要填写任何密钥。

指标与打分模型

详见 references/indicators_api.md（数据源、致命坑、指标口径、7 维权重、 决策矩阵）。脚本逻辑与该文档一致，二者以脚本 analyze_etf.py 为准。

合规红线（务必遵守）

• 输出为教育 / 研究用途，所有结论均为技术面"关注等级"描述。
• 不得出现"推荐 / 买入建议 / 卖出"等话术，用"可关注 / 等待 / 回避"等中性表述。
• 报告顶部与底部均保留"不构成投资建议"声明（脚本已内置，勿删）。

分析严谨性（用户硬性要求）

• 每个级别必须分析主图 + 副图指标后才下结论：主图看均线排列(多头/空头/纠缠)与价格相对 MA20 位置；副图看 KDJ(金叉/死叉/超买/超卖)、MACD(金叉红柱/死叉绿柱)、量价配合。脚本已在每个周期卡片用「主图：… ｜ 副图：…」两行摊开呈现，用户能直接看到分析过哪些指标。
• 结论需多指标共振：评分偏多(≥20)仍不算买入信号，必须 ≥3/5 个主副图指标同向看多（MA 多头 + 价在 MA20 上 + MACD 金叉 + KDJ 金叉非超买 + 量价配合）才给"关注"信号；否则降级为"等共振明确"的等待信号，并在理由中列出各指标实际状态。这避免单指标误导。

资源

• scripts/analyze_etf.py —— 唯一主引擎：依赖自检 + 行情获取 + 指标 + 打分 + HTML 渲染。
• references/indicators_api.md —— 接口、坑、指标口径与打分模型参考。