chan-lun-core 0.1.4__tar.gz

chan_lun_core-0.1.4/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chan Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

chan_lun_core-0.1.4/PKG-INFO

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: chan-lun-core
+Version: 0.1.4
+Summary: 缠论(缠中说禅理论)量化核心库: 分型/笔/线段/中枢/背驰/买卖点 + 30 分钟跨级别共振确认, 纯 Python 实现, 仅依赖 numpy/pandas
+Author: Chan Contributors
+License: MIT License
+        
+        Copyright (c) 2026 Chan Contributors
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/lushi78778/chan-lun
+Project-URL: Repository, https://github.com/lushi78778/chan-lun
+Keywords: chan,chanlun,缠论,缠中说禅,technical-analysis,quant,stock,kline,trading
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.14
+Requires-Dist: pandas>=0.23
+Dynamic: license-file
+
+# chan-lun
+
+缠论(缠中说禅理论)量化核心库 —— 分型 / 笔 / 线段 / 中枢 / 背驰 / 三类买卖点,
+外加日线信号 → 30 分钟级别的跨级别共振确认(区间套)。
+
+纯 Python 实现,**不依赖任何行情接口**:输入标准化 bar 序列,输出结构对象与信号。
+只依赖 numpy(背驰计算)与 pandas(bars 归一化辅助)。
+
+- 发行名:**chan-lun-core**(PyPI 上 `chan` 已被占用, `chan-lun` 与现有 `chanlun` 冲突, 故加 `-core` 后缀)
+- import 名:`chan`
+- 许可证:MIT
+
+## 安装
+
+从 PyPI 安装(打 `v*` tag 后 CI 自动发布):
+
+```bash
+pip install chan-lun-core
+```
+
+从 GitHub Release 安装(同样由 CI 自动构建):
+
+```bash
+pip install https://github.com/lushi78778/chan-lun/releases/download/v0.1.4/chan_lun_core-0.1.4-py3-none-any.whl
+```
+
+或源码安装:
+
+```bash
+pip install git+https://github.com/lushi78778/chan-lun.git
+```
+
+要求 Python >= 3.6、numpy >= 1.14、pandas >= 0.23
+(与聚宽研究环境 3.6.7 / numpy 1.14.6 / pandas 0.23.4 对齐,新版同样兼容)。
+
+## 数据约定
+
+所有模块的输入/输出都是**纯 Python 结构**(list of dict / 简单对象),
+与数据来源无关:
+
+```python
+# 标准 bar: 按时间升序的 dict 列表
+bars = [
+    {"dt": ..., "open": ..., "high": ..., "low": ..., "close": ..., "volume": ...},
+    ...
+]
+```
+
+`chan.bars.normalize_bars` 负责把聚宽 `get_price`/`get_bars` 等返回的
+DataFrame 转成标准 bar 序列(列名可配置)。
+
+## 模块与流水线
+
+| 模块 | 功能 | 主要入口 |
+|---|---|---|
+| `chan.bars` | 行情归一化 | `normalize_bars`, `bars_to_df` |
+| `chan.fx` | 包含处理 + 分型 | `remove_includes`, `find_fxs` |
+| `chan.bi` | 笔识别 | `find_bis`, `chan_fx_bi` |
+| `chan.xd` | 线段(特征序列两种标准) | `find_xds`, `chan_bis_xds` |
+| `chan.zs` | 中枢与走势类型 | `find_zs`, `classify_trend` |
+| `chan.bc` | 背驰(MACD 辅助) | `macd_series`, `find_trend_bc`, `find_pan_bc` |
+| `chan.bs` | 三类买卖点 | `find_buy_points`, `find_sell_points` |
+| `chan.cross30` | 30m 跨级别共振确认 | `confirm_buy3_30m`, `confirm_sell3_30m` |
+
+最小示例(完整管线):
+
+```python
+from chan.bars import normalize_bars
+from chan.bi import chan_fx_bi
+from chan.xd import chan_bis_xds
+from chan.zs import find_zs
+from chan.bc import macd_series, find_trend_bc
+from chan.bs import find_buy_points
+
+bars = normalize_bars(df)          # df -> 标准 bar 列表
+bis = chan_fx_bi(bars)             # 分型 -> 笔
+xds = chan_bis_xds(bars)           # 笔 -> 线段
+zss = find_zs(xds)                 # 线段 -> 中枢
+dif, dea, hist = macd_series(bars) # MACD
+bc = find_trend_bc(bis, zss, bars) # 趋势背驰
+buys = find_buy_points(bis, zss)   # 三类买点
+```
+
+跨级别确认(日线三买 → 30 分钟底背驰 + 守中枢上沿):
+
+```python
+from chan.cross30 import confirm_buy3_30m
+
+r = confirm_buy3_30m(bars30, zd=zg_of_day_zs, zg=zg_of_day_zs, signal_dt=...)
+# r["status"] in {"confirmed", "weak", "no_exhaustion", "broke", "stale", "no_data"}
+```
+
+## 兼容性
+
+- Python 3.6+ 语法(无 walrus / dataclasses / f-string 自描述等 3.7+ 特性)
+- pandas 0.23+ API(无 to_numpy / to_markdown 等新 API)
+
+## 免责声明
+
+本库仅用于研究与学习,输出不构成任何投资建议。
+
+## 许可证
+
+MIT,见 [LICENSE](LICENSE)。

chan_lun_core-0.1.4/README.md

@@ -0,0 +1,104 @@
+# chan-lun
+
+缠论(缠中说禅理论)量化核心库 —— 分型 / 笔 / 线段 / 中枢 / 背驰 / 三类买卖点,
+外加日线信号 → 30 分钟级别的跨级别共振确认(区间套)。
+
+纯 Python 实现,**不依赖任何行情接口**:输入标准化 bar 序列,输出结构对象与信号。
+只依赖 numpy(背驰计算)与 pandas(bars 归一化辅助)。
+
+- 发行名:**chan-lun-core**(PyPI 上 `chan` 已被占用, `chan-lun` 与现有 `chanlun` 冲突, 故加 `-core` 后缀)
+- import 名:`chan`
+- 许可证:MIT
+
+## 安装
+
+从 PyPI 安装(打 `v*` tag 后 CI 自动发布):
+
+```bash
+pip install chan-lun-core
+```
+
+从 GitHub Release 安装(同样由 CI 自动构建):
+
+```bash
+pip install https://github.com/lushi78778/chan-lun/releases/download/v0.1.4/chan_lun_core-0.1.4-py3-none-any.whl
+```
+
+或源码安装:
+
+```bash
+pip install git+https://github.com/lushi78778/chan-lun.git
+```
+
+要求 Python >= 3.6、numpy >= 1.14、pandas >= 0.23
+(与聚宽研究环境 3.6.7 / numpy 1.14.6 / pandas 0.23.4 对齐,新版同样兼容)。
+
+## 数据约定
+
+所有模块的输入/输出都是**纯 Python 结构**(list of dict / 简单对象),
+与数据来源无关:
+
+```python
+# 标准 bar: 按时间升序的 dict 列表
+bars = [
+    {"dt": ..., "open": ..., "high": ..., "low": ..., "close": ..., "volume": ...},
+    ...
+]
+```
+
+`chan.bars.normalize_bars` 负责把聚宽 `get_price`/`get_bars` 等返回的
+DataFrame 转成标准 bar 序列(列名可配置)。
+
+## 模块与流水线
+
+| 模块 | 功能 | 主要入口 |
+|---|---|---|
+| `chan.bars` | 行情归一化 | `normalize_bars`, `bars_to_df` |
+| `chan.fx` | 包含处理 + 分型 | `remove_includes`, `find_fxs` |
+| `chan.bi` | 笔识别 | `find_bis`, `chan_fx_bi` |
+| `chan.xd` | 线段(特征序列两种标准) | `find_xds`, `chan_bis_xds` |
+| `chan.zs` | 中枢与走势类型 | `find_zs`, `classify_trend` |
+| `chan.bc` | 背驰(MACD 辅助) | `macd_series`, `find_trend_bc`, `find_pan_bc` |
+| `chan.bs` | 三类买卖点 | `find_buy_points`, `find_sell_points` |
+| `chan.cross30` | 30m 跨级别共振确认 | `confirm_buy3_30m`, `confirm_sell3_30m` |
+
+最小示例(完整管线):
+
+```python
+from chan.bars import normalize_bars
+from chan.bi import chan_fx_bi
+from chan.xd import chan_bis_xds
+from chan.zs import find_zs
+from chan.bc import macd_series, find_trend_bc
+from chan.bs import find_buy_points
+
+bars = normalize_bars(df)          # df -> 标准 bar 列表
+bis = chan_fx_bi(bars)             # 分型 -> 笔
+xds = chan_bis_xds(bars)           # 笔 -> 线段
+zss = find_zs(xds)                 # 线段 -> 中枢
+dif, dea, hist = macd_series(bars) # MACD
+bc = find_trend_bc(bis, zss, bars) # 趋势背驰
+buys = find_buy_points(bis, zss)   # 三类买点
+```
+
+跨级别确认(日线三买 → 30 分钟底背驰 + 守中枢上沿):
+
+```python
+from chan.cross30 import confirm_buy3_30m
+
+r = confirm_buy3_30m(bars30, zd=zg_of_day_zs, zg=zg_of_day_zs, signal_dt=...)
+# r["status"] in {"confirmed", "weak", "no_exhaustion", "broke", "stale", "no_data"}
+```
+
+## 兼容性
+
+- Python 3.6+ 语法(无 walrus / dataclasses / f-string 自描述等 3.7+ 特性)
+- pandas 0.23+ API(无 to_numpy / to_markdown 等新 API)
+
+## 免责声明
+
+本库仅用于研究与学习,输出不构成任何投资建议。
+
+## 许可证
+
+MIT,见 [LICENSE](LICENSE)。

chan_lun_core-0.1.4/pyproject.toml

@@ -0,0 +1,55 @@
+# chan-lun-core 发布配置(仓库根 = src/chan, 标准 src-layout, 见 PyPA 官方教程)
+# 发行名 chan-lun-core(import 名仍是 chan): PyPI 拒绝 `chan-lun`(与现有
+# `chanlun` 过于相似); chan-lun-core 已按 PyPI ultranormalize 规则
+# (去 ._- / l,i->1 / o->0)逐变体验证无冲突。
+# 注意: version 与 src/chan/__init__.py 的 __version__ 需保持一致。
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "chan-lun-core"
+version = "0.1.4"
+description = "缠论(缠中说禅理论)量化核心库: 分型/笔/线段/中枢/背驰/买卖点 + 30 分钟跨级别共振确认, 纯 Python 实现, 仅依赖 numpy/pandas"
+readme = "README.md"
+requires-python = ">=3.6"
+license = {file = "LICENSE"}
+authors = [{name = "Chan Contributors"}]
+keywords = [
+    "chan", "chanlun", "缠论", "缠中说禅",
+    "technical-analysis", "quant", "stock", "kline", "trading",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Financial and Insurance Industry",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Natural Language :: Chinese (Simplified)",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.6",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Office/Business :: Financial :: Investment",
+]
+dependencies = [
+    # 与聚宽研究环境(3.6.7 / numpy 1.14.6 / pandas 0.23.4)对齐的下限;
+    # 新版 numpy/pandas 同样兼容。
+    "numpy>=1.14",
+    "pandas>=0.23",
+]
+
+[project.urls]
+Homepage = "https://github.com/lushi78778/chan-lun"
+Repository = "https://github.com/lushi78778/chan-lun"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

chan_lun_core-0.1.4/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

chan_lun_core-0.1.4/src/chan/__init__.py

@@ -0,0 +1,19 @@
+# -*- coding: utf-8 -*-
+"""chan 缠论量化核心包(纯 Python 3.6 兼容)
+
+模块:
+    bars    - 行情数据归一化
+    fx      - 包含处理 + 分型识别
+    bi      - 笔识别
+    xd      - 线段识别(特征序列两种标准)
+    zs      - 中枢识别与走势类型
+    bc      - 背驰识别(MACD 辅助: 趋势背驰/盘整背驰)
+    bs      - 三类买卖点信号
+    cross30 - 日线买卖点 -> 30 分钟跨级别共振确认(区间套)
+
+发布: 发行名 chan-lun-core(import 名 chan), 仓库根 = src/chan(标准
+      src-layout, 本包位于仓库根的 src/chan/ 子目录, 见仓库根 pyproject.toml)。
+     注意: __version__ 与 pyproject.toml 的 [project] version 需保持一致。
+"""
+
+__version__ = "0.1.4"

chan_lun_core-0.1.4/src/chan/bars.py

@@ -0,0 +1,65 @@
+# -*- coding: utf-8 -*-
+"""
+chan.bars —— 行情数据归一化
+
+把聚宽 get_price / get_bars 返回的 DataFrame 转成标准的 bar 序列
+(list of dict), 供缠论管线(分型/笔/线段)使用。
+
+兼容: Python 3.6, pandas 0.23
+"""
+
+from __future__ import print_function
+
+# 标准 bar 字段
+BAR_KEYS = ["dt", "open", "high", "low", "close", "volume"]
+
+
+def normalize_bars(df, dt_col="date", open_col="open", high_col="high",
+                   low_col="low", close_col="close", volume_col="volume",
+                   drop_paused=True):
+    """DataFrame -> 按时间升序的标准 bar 列表
+
+    参数:
+        df: get_price/get_bars 返回的 DataFrame(单标的)
+        dt_col 等: 列名映射(聚宽默认列名即默认参数)
+        drop_paused: 丢弃停牌(成交量=0 且高低价持平)的 bar
+
+    返回:
+        list of dict, 每项含 dt/open/high/low/close/volume;
+        dt 为原类型(datetime/Timestamp), 排序后保证时间递增。
+    """
+    if df is None or df.shape[0] == 0:
+        return []
+
+    # 时间列: get_bars 返回 date 列; get_price 返回时间为 index
+    use_index_dt = (dt_col not in df.columns)
+
+    price_cols = [open_col, high_col, low_col, close_col, volume_col]
+    for c in price_cols:
+        if c not in df.columns:
+            raise ValueError("缺少列: {}".format(c))
+
+    cols = price_cols
+    if use_index_dt:
+        out = df[cols].copy()
+        out.insert(0, "dt", df.index)
+    else:
+        out = df[[dt_col] + cols].copy()
+        out.columns = ["dt"] + price_cols
+    out.columns = BAR_KEYS
+    out = out.sort_values("dt")
+    # 数值化
+    for c in ["open", "high", "low", "close", "volume"]:
+        out[c] = out[c].astype(float)
+
+    bars = out.to_dict(orient="records")
+    if drop_paused:
+        bars = [b for b in bars
+                if not (b["volume"] == 0 and b["high"] == b["low"])]
+    return bars
+
+
+def bars_to_df(bars):
+    """bar 列表 -> DataFrame(测试与展示用)"""
+    import pandas as pd
+    return pd.DataFrame(bars)

chan_lun_core-0.1.4/src/chan/bc.py

@@ -0,0 +1,193 @@
+# -*- coding: utf-8 -*-
+"""
+chan.bc —— 背驰识别(动力学, MACD 辅助)
+
+理论依据: doc/缠论知识库/04-背驰与区间套.md
+
+  标准背驰(趋势背驰): 趋势(至少两个同向不重叠中枢)中, 最后中枢
+    之后的离开段力度比前一连接段弱(MACD 柱面积), 且价格创新高/新低。
+  盘整背驰: 中枢震荡中, 两段同向波动力度比较(用于中枢震荡短差)。
+
+  力度度量(课24 MACD 辅助): 段对应的 MACD 柱(hist=(DIF-DEA)*2)面积,
+  上涨段看红柱面积, 下跌段看绿柱面积; 简化: sum(hist) 的绝对值。
+
+兼容: Python 3.6, numpy。
+"""
+
+from __future__ import print_function
+
+import numpy as np
+
+
+def ema(values, n):
+    """指数移动平均(纯 numpy 实现, 兼容老版本)"""
+    values = np.asarray(values, dtype=float)
+    out = np.empty(len(values))
+    k = 2.0 / (n + 1)
+    out[0] = values[0]
+    for i in range(1, len(values)):
+        out[i] = values[i] * k + out[i - 1] * (1 - k)
+    return out
+
+
+def macd_series(bars, fast=12, slow=26, signal=9):
+    """MACD 指标序列
+
+    返回: (dif, dea, hist) numpy 数组, hist = (dif - dea) * 2
+    """
+    closes = np.array([b["close"] for b in bars], dtype=float)
+    ema_fast = ema(closes, fast)
+    ema_slow = ema(closes, slow)
+    dif = ema_fast - ema_slow
+    dea = ema(dif, signal)
+    hist = (dif - dea) * 2.0
+    return dif, dea, hist
+
+
+def _dt_index(bars):
+    """bars 的 dt -> 索引 映射(用最后一个匹配)"""
+    idx = {}
+    for i, b in enumerate(bars):
+        idx[str(b["dt"])] = i
+    return idx
+
+
+def segment_area(hist, bars_index, dt_map, start_dt, end_dt):
+    """某段 [start_dt, end_dt] 的 MACD 柱面积(带符号 sum)
+
+    返回: float(正=红柱主导/上涨, 负=绿柱主导/下跌)
+    """
+    i0 = dt_map.get(str(start_dt))
+    i1 = dt_map.get(str(end_dt))
+    if i0 is None or i1 is None:
+        return 0.0
+    if i0 > i1:
+        i0, i1 = i1, i0
+    i1 = min(i1 + 1, len(hist))
+    return float(np.sum(hist[i0:i1]))
+
+
+def find_trend_bc(bis, zss, bars, hist=None):
+    """趋势背驰识别(基于笔级中枢)
+
+    参数:
+        bis: 笔列表
+        zss: 中枢列表(通常由 find_zs(bis) 生成)
+        bars: 原始 bars(list of dict)
+        hist: MACD 柱序列(默认计算)
+
+    返回: list of dict
+        {direction: 'up'/'down', dt, price, zs_idx, area_prev, area_last,
+         note}
+    规则(向上趋势):
+        - 相邻两中枢后 DD > 前 GG(向上);
+        - 最后中枢之后离开段创新高;
+        - 离开段 MACD 面积 < 前一连接段面积 -> 顶背驰。
+      向下趋势镜像 -> 底背驰。
+    """
+    if hist is None:
+        _, _, hist = macd_series(bars)
+    dt_map = _dt_index(bars)
+    out = []
+    if len(zss) < 2:
+        return out
+
+    for k in range(1, len(zss)):
+        prev, zs = zss[k - 1], zss[k]
+        up_trend = (zs.dd > prev.gg)
+        down_trend = (zs.gg < prev.dd)
+        if not (up_trend or down_trend):
+            continue
+        # 最后中枢(第 k 个)之后的离开段: 中枢 end_dt 之后的第一段同向笔
+        # 简化: 用最后一个中枢 end_dt 到最后一笔终点的区间
+        last_dt = bis[-1].end_dt
+        # 前一连接段: prev 中枢 end_dt -> zs 中枢 start_dt 之间
+        area_prev = segment_area(hist, bars, dt_map, prev.end_dt, zs.start_dt)
+        area_last = segment_area(hist, bars, dt_map, zs.end_dt, last_dt)
+        if up_trend:
+            # 离开段创新高
+            last_high = bis[-1].end_value if bis[-1].direction == "up" else bis[-1].start_value
+            prev_high = prev.gg
+            if last_high > prev_high and abs(area_last) < abs(area_prev) and area_last > 0:
+                out.append({"direction": "up", "dt": str(bis[-1].end_dt),
+                            "price": last_high, "zs_idx": k,
+                            "area_prev": abs(area_prev), "area_last": abs(area_last),
+                            "note": "趋势顶背驰候选"})
+        else:
+            last_low = bis[-1].end_value if bis[-1].direction == "down" else bis[-1].start_value
+            prev_low = prev.dd
+            if last_low < prev_low and abs(area_last) < abs(area_prev) and area_last < 0:
+                out.append({"direction": "down", "dt": str(bis[-1].end_dt),
+                            "price": last_low, "zs_idx": k,
+                            "area_prev": abs(area_prev), "area_last": abs(area_last),
+                            "note": "趋势底背驰候选"})
+    return out
+
+
+def find_pan_bc(bis, zss, bars, hist=None, max_dev=0.15):
+    """盘整背驰识别(中枢震荡内两段同向波动力度比较)
+
+    对每个中枢: 比较围绕中枢的相邻两段同向波动(向上离开 vs 进入)
+    简化: 中枢区间内, 取笔序列中相邻两段同向笔(方向向上/向下),
+    后段创新高/新低但面积更小 -> 盘整背驰。
+
+    v2 增强(位置过滤): 盘整背驰是"围绕中枢的波动"比较, 信号点必须
+    距中枢不远; 创新高/新低后远离中枢(超过 max_dev 比例)的信号
+    多为趋势延伸而非中枢震荡, 予以剔除。
+
+    返回: list of dict
+    """
+    if hist is None:
+        _, _, hist = macd_series(bars)
+    dt_map = _dt_index(bars)
+    out = []
+    if not zss:
+        return out
+
+    for zi, zs in enumerate(zss):
+        # 找出中枢区间内的笔(起点或终点在中枢区间内)
+        segs = []
+        i = 0
+        n = len(bis)
+        while i < n:
+            bi = bis[i]
+            # 同向笔合并成"段"
+            seg = [bi]
+            j = i + 1
+            while j < n and bis[j].direction == bi.direction:
+                seg.append(bis[j])
+                j += 1
+            i = j
+            segs.append(seg)
+        # 同向段比较(A/B/C 模式: 隔一个反向段): 方向同为 up 或同为 down
+        for s in range(2, len(segs)):
+            a, b = segs[s - 2], segs[s]
+            if a[0].direction != b[0].direction:
+                continue
+            area_a = segment_area(hist, bars, dt_map,
+                                  a[0].start_dt, a[-1].end_dt)
+            area_b = segment_area(hist, bars, dt_map,
+                                  b[0].start_dt, b[-1].end_dt)
+            if abs(area_b) >= abs(area_a):
+                continue
+            if b[0].direction == "up":
+                if b[-1].end_value > a[-1].end_value:
+                    price = b[-1].end_value
+                    # 位置过滤: 信号价距中枢 GG 不超过 max_dev
+                    if price <= zs.gg * (1 + max_dev):
+                        out.append({"zs_idx": zi, "direction": "up",
+                                    "dt": str(b[-1].end_dt),
+                                    "price": price,
+                                    "area_prev": abs(area_a), "area_last": abs(area_b),
+                                    "note": "盘整顶背驰候选"})
+            else:
+                if b[-1].end_value < a[-1].end_value:
+                    price = b[-1].end_value
+                    # 位置过滤: 信号价距中枢 DD 不低于 max_dev
+                    if price >= zs.dd * (1 - max_dev):
+                        out.append({"zs_idx": zi, "direction": "down",
+                                    "dt": str(b[-1].end_dt),
+                                    "price": price,
+                                    "area_prev": abs(area_a), "area_last": abs(area_b),
+                                    "note": "盘整底背驰候选"})
+    return out