docs: 完善参数说明,增加中文名称和通俗解释

- 表格增加"中文名称"列
- 新增"参数详解(通俗版)"章节
- 用通俗语言逐个解释 9 个参数的含义

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
褚宏光 2026-03-04 15:50:53 +08:00
parent 31ae9538cc
commit 6f7bdcc9c1

View File

@ -126,17 +126,80 @@ def make_extended_aline(line_pts, pivot_point, color):
### 5.2 默认参数(来自 config.py ### 5.2 默认参数(来自 config.py
| 参数 | 日K (D) | 周K (W) | 月K (M) | | 参数 | 中文名称 | 日K (D) | 周K (W) | 月K (M) |
|------|---------|---------|---------| |------|----------|---------|---------|---------|
| window | 240 | 104 | 60 | | window | 检测窗口 | 240 | 104 | 60 |
| pivot_k | 15 | 5 | 3 | | pivot_k | 枢轴点左右窗口 | 15 | 5 | 3 |
| breakout_threshold | 0.005 | 0.010 | 0.020 | | breakout_threshold | 突破阈值 | 0.005 | 0.010 | 0.020 |
| vol_window | 20 | 8 | 4 | | vol_window | 成交量均线周期 | 20 | 8 | 4 |
| volume_multiplier | 1.5 | 1.5 | 1.3 | | volume_multiplier | 放量倍数 | 1.5 | 1.5 | 1.3 |
| min_convergence | 0.45 | 0.45 | 0.50 | | min_convergence | 最小收敛比例 | 0.45 | 0.45 | 0.50 |
| false_break_m | 5 | 2 | 1 | | false_break_m | 假突破回看天数 | 5 | 2 | 1 |
| flexible_zone | 15 | 5 | 2 | | flexible_zone | 实时模式灵活区域 | 15 | 5 | 2 |
| display_bars | 300 | 130 | 72 | | display_bars | 图表显示 K 线数 | 300 | 130 | 72 |
#### 参数详解(通俗版)
**1. window检测窗口**
- **含义**:往回看多少根 K 线来寻找三角形形态
- **日K 240 根** ≈ 1 年的交易日
- **周K 104 根** ≈ 2 年的周数
- **月K 60 根** ≈ 5 年的月数
- **通俗理解**:就像你用多长的"尺子"去量历史数据,尺子越长,能看到的形态越大
**2. pivot_k枢轴点左右窗口**
- **含义**:判断一个点是不是"高点"或"低点"时,往左往右看多少个点
- **日K 15**:左右各看 15 天
- **周K 5**:左右各看 5 周
- **月K 3**:左右各看 3 个月
- **通俗理解**:就像选班长,要看看这个人是不是比左右同学都高(或都矮),看的人越多越准确
**3. breakout_threshold突破阈值**
- **含义**:价格突破趋势线多少才算"真突破"
- **日K 0.005** = 0.5%
- **周K 0.010** = 1%
- **月K 0.020** = 2%
- **通俗理解**就像跳高杆子是趋势线你要跳过去还要超出一定高度才算成功周K/月K波动大所以阈值更高
**4. vol_window成交量均线周期**
- **含义**:计算成交量均线时用多少天的数据
- **日K 20**20 日成交量均线
- **周K 8**8 周成交量均线
- **月K 4**4 月成交量均线
- **通俗理解**:用过去一段时间的平均成交量作为"正常水平"的参考
**5. volume_multiplier放量倍数**
- **含义**:成交量要是均线的多少倍才算"放量"
- **日K/周K 1.5**:成交量要比平均高 50%
- **月K 1.3**:成交量要比平均高 30%
- **通俗理解**:突破时成交量要"热闹"一点,比平时多人才算有效
**6. min_convergence最小收敛比例**
- **含义**:三角形的开口要缩小到什么程度才算"收敛"
- **日K/周K 0.45**:结束时宽度要小于开始时的 45%
- **月K 0.50**:结束时宽度要小于开始时的 50%
- **通俗理解**:三角形要足够"尖",太扁平的就不算了
**7. false_break_m假突破回看天数**
- **含义**:判断是不是假突破时,往后看多少天
- **日K 5**:往后看 5 天
- **周K 2**:往后看 2 周
- **月K 1**:往后看 1 个月
- **通俗理解**:突破后如果很快又跌回来,就是"假突破",要看几天才能确定
**8. flexible_zone实时模式灵活区域**
- **含义**:在最新数据附近,允许一定的灵活度
- **日K 15**:最近 15 天可以灵活处理
- **周K 5**:最近 5 周可以灵活处理
- **月K 2**:最近 2 个月可以灵活处理
- **通俗理解**:最新数据可能还在变化,给一点容错空间
**9. display_bars图表显示 K 线数)**
- **含义**:生成的图表显示多少根 K 线
- **日K 300**:显示约 300 天
- **周K 130**:显示约 130 周
- **月K 72**:显示约 72 个月6 年)
- **通俗理解**:图表的"视野"有多大,让形态看起来更完整
### 5.3 形态有效性判定条件 ### 5.3 形态有效性判定条件