# longbridge-chanlun

缠论（Chan Theory）形态识别引擎：基于 OHLCV 日线数据，自动检测顶底分型、笔、线段、中枢，并生成一买/一卖、二买/二卖、三买/三卖信号。

## Requirements

> ⚠️ **额外依赖 / Extra dependency required**
>
> 此 skill 依赖第三方 Python 库 **czsc**，使用前需手动安装：
>
> ```bash
> pip install czsc
> ```
>
> 若环境无法安装，LLM 将回退到手动实现基础分型逻辑（精度较低）。
> This skill requires the **czsc** Python library. Install it before use: `pip install czsc`

> Simplified Chinese / Traditional Chinese / English.

## Workflow

1. 从用户输入提取标的代码，标准化为 `<CODE>.<MARKET>` 格式。
2. 获取日线 OHLCV 数据（300 根 K 线）：
   ```bash
   longbridge kline <SYMBOL> --period day --count 300 --format json
   ```
3. 将 JSON 数据转换为 czsc 所需的 `RawBar` 列表格式（字段：`dt`, `open`, `high`, `low`, `close`, `vol`）。
4. 使用 czsc 库解析缠论结构：
   ```python
   import czsc
   from czsc import CZSC
   # bars: list of czsc.RawBar
   c = CZSC(bars)
   # 分型: c.fx_list
   # 笔: c.bi_list
   # 线段: c.seg_list (if available)
   # 中枢: c.zs_list (if available)
   ```
5. 读取最近的笔序列和中枢，匹配买卖点逻辑：
   - **一买**：下降笔触及中枢下沿后出现底分型
   - **二买**：中枢震荡后上升笔回撤不破中枢低点出现底分型
   - **三买**：突破中枢上沿后回调不破中枢高点出现底分型
   - 卖点逻辑对称（一卖/二卖/三卖）
6. 输出分析结论：当前所处买卖点、最近中枢区间、最近分型位置。

> 若环境未安装 czsc，提示用户先运行 `pip install czsc`，然后重试。
> 若不确定 CLI 参数，先运行 `longbridge kline --help` 查看最新参数。

## CLI

```bash
# 获取日线数据（主要数据源）
longbridge kline AAPL.US --period day --count 300 --format json

# 若需更短周期辅助判断（可选）
longbridge kline 700.HK --period week --count 100 --format json
```

## Output

以自然语言呈现，包含：

- **当前买卖点**：一买 / 二买 / 三买 / 一卖 / 二卖 / 三卖（或"暂无明确信号"）
- **最近中枢区间**：[中枢低点, 中枢高点]（含价格）
- **最近分型**：类型（顶/底）+ 价格 + 日期
- **最近笔**：方向（上升/下降）+ 起止价格
- **数据来源**：Longbridge Securities / 数据来源：长桥证券 / 數據來源：長橋證券

## Error handling

| 情形                            | 简体回复                                          | 繁體回覆 / English                                                                                          |
| ------------------------------- | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `command not found: longbridge` | 尝试 MCP fallback；否则请安装 longbridge-terminal | 嘗試 MCP fallback；否則請安裝 longbridge-terminal / Try MCP fallback; otherwise install longbridge-terminal |
| stderr 含 `not logged in`       | 请运行 `longbridge auth login`                    | 請運行 `longbridge auth login` / Run `longbridge auth login`                                                |
| Python 环境缺少 czsc            | 请运行 `pip install czsc` 后重试                  | 請運行 `pip install czsc` 後重試 / Run `pip install czsc` then retry                                        |
| czsc 版本不兼容                 | 请运行 `pip install --upgrade czsc`               | 請運行 `pip install --upgrade czsc` / Run `pip install --upgrade czsc`                                      |
| 其他 stderr                     | 原样返回错误，不静默重试                          | 原樣返回錯誤，不靜默重試 / Surface verbatim, never retry silently                                           |