案例：lightweight_charts 缠论可视化
输入“/”快速插入内容
案例：lightweight_charts 缠论可视化
案例：lightweight_charts 缠论可视化
用户7395用户73955月18日修改
5月16日创建
557
873
0
7
🎯
本案例把 缠论分型 / 笔 / 多周期结构 用 TradingView 的 lightweight_charts 引擎画成 K 线 + SMA + 成交量 + MACD 的完整看盘界面，提供两种使用形态：
1.
离线 HTML：单文件可分享、可嵌入研报，双击即可在浏览器打开
2.
Streamlit 在线版：开浏览器看图、改参数即时刷新
两种形态视觉与交互完全一致（共用同一份 JS 渲染逻辑）。
一、能看到什么
每个周期展开成三张子图：
子图 | 内容 | 视觉 |
主图 | K 线 + SMA5 + SMA20 + 分型 + 笔 | 红涨绿跌蜡烛；橙色 SMA5、青色 SMA20；卡其虚线连接所有分型；深蓝实线连接笔的端点 |
副图 1 | 成交量 | 柱状图，红涨绿跌（与对应 K 线方向一致） |
副图 2 | MACD（12 / 26 / 9） | DIFF 蓝线 + DEA 黄线 + 柱（红 / 绿按零轴），自带 0 基准线 |
下图是用 mock 数据（000001、30 分钟、5 个月）打开后的实际效果：
实际效果（单周期 · 默认 light 主题）· 鼠标悬停时浮现 OHLC + Chg% + Vol + DIFF/DEA/MACD
二、准备工作
czsc 是开源库，已发布到 PyPI。本案例需要 Python ≥ 3.10，建议在虚拟环境里安装。
2.1 用 PyPI 安装（推荐）
标准 pip 路径
# 1) 新建虚拟环境（任选其一）
python3 -m venv .venv && source .venv/bin/activate # macOS / Linux
# python -m venv .venv && .venv\Scripts\activate # Windows
# 2) 安装 czsc
pip install -U czsc
或使用 uv（更快，推荐熟悉 uv 的用户）
uv venv && source .venv/bin/activate
uv pip install -U czsc
2.2 验证安装
代码块
python -c "import czsc; print(czsc.__version__)"
# 输出版本号即代表安装成功
2.3 取得本案例的示例脚本
本文档涉及的两个示例脚本（13_lightweight_charts_html.py 与 14_streamlit_lightweight_charts.py）没有随 PyPI 包发布，需要从 GitHub 仓库拿到本地。两种方式任选其一：
方式 A：克隆整个仓库（适合想看更多案例的同学）
代码块
git clone https://github.com/waditu/czsc.git
cd czsc/docs/examples
方式 B：只下载两个示例文件
代码块
mkdir -p docs/examples && cd docs/examples
curl -O https://raw.githubusercontent.com/waditu/czsc/master/docs/examples/13_lightweight_charts_html.py
curl -O https://raw.githubusercontent.com/waditu/czsc/master/docs/examples/14_streamlit_lightweight_charts.py
2.4 可选依赖：Streamlit