Update project

神奇九转功能说明.md

@@ -0,0 +1,221 @@
+# 神奇九转功能说明
+
+## 1. 功能定位
+
+神奇九转用于识别短线节奏是否已经连续推进到一个容易出现停顿、衰减或转折的位置。
+
+它在系统中的定位不是直接给出买卖点，而是给出：
+
+- 节奏是否连续
+- 当前已经运行到第几个计数
+- 是否接近一个短线容易出现变化的位置
+
+## 2. 当前实现范围
+
+当前神奇九转已接入分析页图表区，作为独立 `Tab` 展示。
+
+位置：
+
+- `黄金分割`
+- `MACD`
+- `RSI`
+- `神奇九转`
+- `时间序列`
+
+当前主要服务于：
+
+- `15m`
+- `30m`
+- `60m`
+- `90m`
+- `120m`
+- 以及日线、周线图中的基础节奏观察
+
+## 3. 当前计数规则
+
+### 3.1 核心逻辑
+
+当前实现采用“与前 4 根 K 线比较”的连续计数规则。
+
+对任意一根 K 线：
+
+- 若当前收盘价 `close > 4 根前 close`
+  则记为上涨序列推进
+- 若当前收盘价 `close < 4 根前 close`
+  则记为下跌序列推进
+- 若相等或不满足
+  则当前序列中断
+
+### 3.2 上涨序列
+
+若连续满足：
+
+```text
+当前 close > 4 根前 close
+```
+
+则上涨计数依次为：
+
+```text
+1 2 3 4 5 6 7 8 9
+```
+
+### 3.3 下跌序列
+
+若连续满足：
+
+```text
+当前 close < 4 根前 close
+```
+
+则下跌计数依次为：
+
+```text
+1 2 3 4 5 6 7 8 9
+```
+
+## 4. 当前已修复的关键 bug
+
+用户之前确认的问题是：
+
+- 到 `9` 后如果后面仍然满足条件，不应该一直停在 `9`
+- 应该重新从 `1` 开始
+
+当前系统已按这个口径修正。
+
+### 4.1 修复前
+
+错误表现：
+
+- `7 8 9 9 9 9`
+
+这会让图上一直显示 `9`，失去节奏意义。
+
+### 4.2 修复后
+
+当前逻辑为：
+
+- 达到 `9` 后
+- 若后续仍满足同方向条件
+- 重新从 `1` 开始计数
+
+正确表现为：
+
+- `7 8 9 1 2 3`
+
+### 4.3 修复意义
+
+这样更符合“神奇九转是节奏计数，不是固定封顶标签”的使用方式。
+
+## 5. 前端展示方式
+
+### 5.1 图上标注
+
+当前点击 `神奇九转` Tab 后：
+
+- K 线上会直接标注当前可见序列数字
+- 上涨序列显示在相对高位上方
+- 下跌序列显示在相对低位下方
+
+颜色区分：
+
+- 上涨序列：金色
+- 下跌序列：青色
+
+### 5.2 右侧结论卡片
+
+当前右侧会同步给出对应级别的结论话术，例如：
+
+- 当前为上涨序列第 6 个
+- 当前为下跌序列第 3 个
+- 达到 9 后若继续满足条件，将重新从 1 开始
+
+## 6. 结果解释方式
+
+### 6.1 上涨九转
+
+上涨九转更适合提示：
+
+- 短线连续推进较多
+- 节奏可能接近高点或进入震荡
+- 后续要看是否配合量价和压力位变化
+
+### 6.2 下跌九转
+
+下跌九转更适合提示：
+
+- 短线连续走弱较多
+- 节奏可能接近低点或进入反抽窗口
+- 后续要看是否出现支撑确认
+
+## 7. 神奇九转与其他指标的关系
+
+神奇九转在系统中不单独构成操作信号，必须与其他模块联合使用。
+
+推荐搭配：
+
+- 黄金分割空间位
+- ABC 结构
+- MACD
+- RSI
+- 时间序列
+
+### 7.1 与黄金分割联动
+
+示例：
+
+- 若下跌九转接近 `0.618` 或 `0.809`
+  则更值得观察是否形成支撑反抽
+- 若上涨九转接近 `0.191` 或压力区
+  则更值得观察是否出现冲高回落
+
+### 7.2 与 MACD 联动
+
+- 九转出现，但 MACD 仍然单边扩张
+  说明节奏提示有效，但趋势还没真正扭转
+- 九转出现，同时 MACD 柱体缩短或背离
+  说明节奏变化可信度更高
+
+### 7.3 与 RSI 联动
+
+- 下跌九转 + RSI 低位
+  更容易形成短线反抽观察点
+- 上涨九转 + RSI 高位
+  更容易形成短线节奏放缓观察点
+
+## 8. 当前使用建议
+
+### 8.1 适合作为节奏辅助
+
+神奇九转更适合做：
+
+- 节奏观察
+- 短线高低点预警
+- 配合结构与空间做确认
+
+### 8.2 不适合单独使用
+
+以下场景不建议只看九转：
+
+- 单边强趋势行情
+- 放量突破刚开始
+- 大周期方向与小周期冲突明显时
+
+## 9. 当前成果总结
+
+当前神奇九转模块已具备：
+
+- 已接入分析页图表 `Tab`
+- 已支持图上直接标注当前计数
+- 已区分上涨与下跌序列
+- 已修复 `9` 后不重置的 bug
+- 已支持右侧结论话术
+- 已可与黄金分割、MACD、RSI、时间序列并列使用
+
+## 10. 后续可继续增强的方向
+
+- 增加九转完成后的高低点确认逻辑
+- 增加“九转失败”与“九转延续”的区分
+- 增加与黄金位共振时的自动提示
+- 增加与 MACD 背离、RSI 超买超卖的联合结论
+- 增加不同周期九转共振时的风险提示