Skip to content

yzsp-studio/mediakit-shared-suite / ppt

飞书幻灯片:创建和编辑幻灯片。创建演示文稿、读取幻灯片内容、管理幻灯片页面(创建、删除、读取、局部替换)。当用户需要创建或编辑幻灯片、读取或修改单个页面时使用。

FileKindSize
SKILL.mdskill md40.1 KB
references/cli/lark-slides-add-slide.mdmarkdown7.3 KB
references/cli/lark-slides-create.mdmarkdown10.5 KB
references/cli/lark-slides-delete-slide.mdmarkdown2.7 KB
references/cli/lark-slides-history.mdmarkdown6.9 KB
references/cli/lark-slides-media-upload.mdmarkdown5.5 KB
references/cli/lark-slides-replace-slide.mdmarkdown14.8 KB
references/cli/lark-slides-screenshot.mdmarkdown5.4 KB
references/cli/lark-slides-update-slide.mdmarkdown11.6 KB
references/cli/lark-slides-xml-presentation-slide-get.mdmarkdown3.6 KB
references/cli/lark-slides-xml-presentation-slide-replace.mdmarkdown7.3 KB
references/cli/lark-slides-xml-presentations-get.mdmarkdown9.4 KB
references/refine/academic-research.mdmarkdown7.3 KB
references/refine/brand-storytelling.mdmarkdown8.3 KB
references/refine/business-pitch.mdmarkdown8.0 KB
references/refine/business-review.mdmarkdown8.3 KB
references/refine/fallback.mdmarkdown7.8 KB
references/refine/learning-and-training.mdmarkdown8.5 KB
references/refine/strategy-and-analysis.mdmarkdown8.1 KB
references/refine/technical-presentation.mdmarkdown8.1 KB
references/style/academic-research.mdmarkdown18.5 KB
references/style/brand-storytelling.mdmarkdown34.1 KB
references/style/business-pitch.mdmarkdown12.2 KB
references/style/business-review.mdmarkdown19.6 KB
references/style/fallback.mdmarkdown8.7 KB
references/style/learning-and-training.mdmarkdown20.8 KB
references/style/slide-taxonomy.mdmarkdown13.6 KB
references/style/strategy-and-analysis.mdmarkdown8.4 KB
references/style/technical-presentation.mdmarkdown15.6 KB
references/workflow/error-handling.mdmarkdown9.6 KB
references/workflow/local-compat.mdmarkdown5.3 KB
references/workflow/slides-editing.mdmarkdown34.6 KB
references/workflow/template-editing-main.mdmarkdown36.6 KB
references/workflow/template-editing-organizer.mdmarkdown24.4 KB
references/workflow/validation-visual.mdmarkdown7.1 KB
references/workflow/validation-xml.mdmarkdown31.9 KB
references/workflow/windows-compat.mdmarkdown6.3 KB
references/xml/fonts.mdmarkdown7.6 KB
references/xml/iconpark-index.jsonconfig729.4 KB
references/xml/iconpark.mdmarkdown2.1 KB
references/xml/slides_chart_demo.xmlconfig69.2 KB
references/xml/slides_xml_schema_definition.xmlconfig228.6 KB
references/xml/xml-schema-quick-ref.mdmarkdown34.7 KB
scripts/atomize_svg_to_slide.pyscript80.2 KB
scripts/atomize_svg_to_slide_test.pyscript5.5 KB
scripts/color_contrast_check.pyscript36.4 KB
scripts/color_contrast_check_test.pyscript28.9 KB
scripts/embed_svg_validator.pyscript56.7 KB
scripts/embed_svg_validator_test.pyscript18.2 KB
scripts/gen_svg_charts.pyscript48.8 KB
scripts/gen_svg_relations.pyscript42.6 KB
scripts/iconpark_tool.pyscript12.1 KB
scripts/iconpark_tool_test.pyscript7.7 KB
scripts/lint_inspect.pyscript23.3 KB
scripts/lint_inspect_test.pyscript13.2 KB
scripts/parse_template.pyscript114.0 KB
scripts/purge_deck.pyscript11.4 KB
scripts/safe_update_slide.pyscript21.0 KB
scripts/svg_lib/_baseline.pyscript50.9 KB
scripts/svg_lib/_boxplot_skin.pyscript21.5 KB
scripts/svg_lib/_common.pyscript46.6 KB
scripts/svg_lib/charts/__init__.pyscript853 B
scripts/svg_lib/charts/_shared.pyscript8.6 KB
scripts/svg_lib/charts/boxplot.pyscript26.9 KB
scripts/svg_lib/charts/calheat.pyscript45.7 KB
scripts/svg_lib/charts/candle.pyscript39.1 KB
scripts/svg_lib/charts/event_timeline.pyscript66.6 KB
scripts/svg_lib/charts/funnel.pyscript54.6 KB
scripts/svg_lib/charts/gantt.pyscript53.6 KB
scripts/svg_lib/charts/marimekko.pyscript26.9 KB
scripts/svg_lib/charts/matrix_heat.pyscript52.3 KB
scripts/svg_lib/charts/nested_donut.pyscript61.2 KB
scripts/svg_lib/charts/percent_grid.pyscript38.6 KB
scripts/svg_lib/charts/pyramid.pyscript44.8 KB
scripts/svg_lib/charts/quadrant.pyscript76.8 KB
scripts/svg_lib/charts/ridge.pyscript28.7 KB
scripts/svg_lib/charts/sankey.pyscript48.9 KB
scripts/svg_lib/charts/violin.pyscript37.2 KB
scripts/svg_lib/charts/waterfall.pyscript52.3 KB
scripts/svg_lib/svg_palettes.pyscript52.7 KB
scripts/svg_relation_lib/__init__.pyscript2.0 KB
scripts/svg_relation_lib/_viewbox.pyscript10.5 KB
scripts/svg_relation_lib/attributes/__init__.pyscript1.4 KB
scripts/svg_relation_lib/attributes/_resolver.pyscript1.3 KB
scripts/svg_relation_lib/attributes/_test_attrs.pyscript11.8 KB
scripts/svg_relation_lib/attributes/_test_pipeline.pyscript12.5 KB
scripts/svg_relation_lib/attributes/apply.pyscript5.3 KB
scripts/svg_relation_lib/attributes/category.pyscript1.5 KB
scripts/svg_relation_lib/attributes/confidence.pyscript1.5 KB
scripts/svg_relation_lib/attributes/directional.pyscript1.4 KB
scripts/svg_relation_lib/attributes/highlight.pyscript1.6 KB
scripts/svg_relation_lib/attributes/signed.pyscript1.7 KB
scripts/svg_relation_lib/attributes/size.pyscript1.3 KB
scripts/svg_relation_lib/attributes/status.pyscript2.1 KB
scripts/svg_relation_lib/attributes/temporal.pyscript2.5 KB
scripts/svg_relation_lib/attributes/typed.pyscript1.6 KB
scripts/svg_relation_lib/attributes/weighted.pyscript1.4 KB
scripts/svg_relation_lib/chrome.pyscript9.1 KB
scripts/svg_relation_lib/engine.pyscript11.5 KB
scripts/svg_relation_lib/layouts/__init__.pyscript383 B
scripts/svg_relation_lib/layouts/bloom_v2.pyscript37.9 KB
scripts/svg_relation_lib/layouts/c4_container_v2.pyscript35.1 KB
scripts/svg_relation_lib/layouts/column_stack.pyscript5.3 KB
scripts/svg_relation_lib/layouts/fishbone_v2.pyscript38.1 KB
scripts/svg_relation_lib/layouts/hub_fanout.pyscript15.5 KB
scripts/svg_relation_lib/layouts/osi_stack_v2.pyscript32.8 KB
scripts/svg_relation_lib/layouts/vertical_chain.pyscript4.5 KB
scripts/svg_relation_lib/palettes.pyscript8.9 KB
scripts/svg_relation_lib/palettes_ext.pyscript17.2 KB
scripts/svg_relation_lib/presets/__init__.pyscript297 B
scripts/svg_relation_lib/presets/_chrome.pyscript1.6 KB
scripts/svg_relation_lib/presets/hero_embed_01_AL_fishbone_v2.pyscript21.7 KB
scripts/svg_relation_lib/presets/hero_embed_02_PY_pmf_v2.pyscript16.5 KB
scripts/svg_relation_lib/presets/hero_embed_03_BL_bloom_v2.pyscript44.0 KB
scripts/svg_relation_lib/presets/hero_embed_04_J1_osi_v2.pyscript46.2 KB
scripts/svg_relation_lib/presets/hero_embed_05_MP_mindmap_v2.pyscript28.6 KB
scripts/svg_relation_lib/presets/hero_embed_07_TX_taxonomy_v2.pyscript64.7 KB
scripts/svg_relation_lib/presets/hero_embed_08_KP_kpi_v2.pyscript79.5 KB
scripts/svg_relation_lib/presets/hero_embed_09_E2_5why_v2.pyscript39.4 KB
scripts/svg_relation_lib/presets/hero_embed_10_CS_c4_v2.pyscript173.5 KB
scripts/svg_relation_lib/presets/hero_embed_32_CU2_curriculum_v2.pyscript66.1 KB
scripts/svg_relation_lib/presets/hero_embed_49_FT_faulttree_v2.pyscript69.4 KB
scripts/svg_relation_lib/render.pyscript28.0 KB
scripts/svg_relation_lib/render/render_bl_bloom_tests.pyscript8.2 KB
scripts/svg_relation_lib/render/render_cu2_curriculum_variants.pyscript19.6 KB
scripts/svg_relation_lib/render/render_e2_5why_variants.pyscript8.9 KB
scripts/svg_relation_lib/render/render_ft_faulttree_variants.pyscript12.8 KB
scripts/svg_relation_lib/render/render_j1_osi_tests.pyscript12.0 KB
scripts/svg_relation_lib/render/render_py_pmf_variants.pyscript13.0 KB
scripts/svg_relation_lib/render/render_tx_taxonomy_variants.pyscript17.6 KB
scripts/svg_relation_lib/schemas/__init__.pyscript280 B
scripts/svg_relation_lib/schemas/graph.pyscript1.5 KB
scripts/svg_relation_lib/schemas/tree.pyscript11.2 KB
scripts/svg_relation_lib/skeletons.pyscript15.3 KB
scripts/svg_relation_lib/skins/__init__.pyscript1.3 KB
scripts/svg_relation_lib/skins/_base.pyscript10.0 KB
scripts/svg_relation_lib/skins/annual_report_ivory.pyscript9.1 KB
scripts/svg_relation_lib/skins/art_deco.pyscript27.1 KB
scripts/svg_relation_lib/skins/arxiv_clean.pyscript9.1 KB
scripts/svg_relation_lib/skins/arxiv_pastel.pyscript9.0 KB
scripts/svg_relation_lib/skins/bain_scarlet.pyscript9.0 KB
scripts/svg_relation_lib/skins/bauhaus_primary.pyscript9.2 KB
scripts/svg_relation_lib/skins/bcg_forest.pyscript9.0 KB
scripts/svg_relation_lib/skins/bloomberg_amber.pyscript9.2 KB
scripts/svg_relation_lib/skins/blueprint_grid.pyscript9.6 KB
scripts/svg_relation_lib/skins/boardroom_navy.pyscript29.9 KB
scripts/svg_relation_lib/skins/chalkboard_slate.pyscript9.0 KB
scripts/svg_relation_lib/skins/coursera_indigo.pyscript9.0 KB
scripts/svg_relation_lib/skins/couture_noir.pyscript33.0 KB
scripts/svg_relation_lib/skins/deloitte_lime.pyscript8.9 KB
scripts/svg_relation_lib/skins/duolingo_cream.pyscript20.4 KB
scripts/svg_relation_lib/skins/editorial.pyscript6.4 KB
scripts/svg_relation_lib/skins/editorial_atelier.pyscript60.7 KB
scripts/svg_relation_lib/skins/editorial_atelier_lark.pyscript19.6 KB
scripts/svg_relation_lib/skins/editorial_atelier_tokens.mdmarkdown13.6 KB
scripts/svg_relation_lib/skins/engineering_kraft.pyscript9.0 KB
scripts/svg_relation_lib/skins/goldman_slate.pyscript9.1 KB
scripts/svg_relation_lib/skins/hermes_orange.pyscript9.0 KB
scripts/svg_relation_lib/skins/ib_editorial.pyscript28.9 KB
scripts/svg_relation_lib/skins/journal_ivory.pyscript29.7 KB
scripts/svg_relation_lib/skins/khan_teal.pyscript9.0 KB
scripts/svg_relation_lib/skins/luxury_manual.pyscript20.4 KB
scripts/svg_relation_lib/skins/manuscript_sepia.pyscript9.1 KB
scripts/svg_relation_lib/skins/mbb_consulting.pyscript32.8 KB
scripts/svg_relation_lib/skins/medical_chart.pyscript22.6 KB
scripts/svg_relation_lib/skins/monocle_ecru.pyscript9.1 KB
scripts/svg_relation_lib/skins/napkin.pyscript6.3 KB
scripts/svg_relation_lib/skins/notebook_grid.pyscript9.2 KB
scripts/svg_relation_lib/skins/oxford_indigo.pyscript9.1 KB
scripts/svg_relation_lib/skins/pitch_bauhaus.pyscript9.1 KB
scripts/svg_relation_lib/skins/pitch_ivory.pyscript18.7 KB
scripts/svg_relation_lib/skins/pitch_midnight.pyscript9.1 KB
scripts/svg_relation_lib/skins/pitch_neon.pyscript32.2 KB
scripts/svg_relation_lib/skins/pitch_sunset.pyscript9.1 KB
scripts/svg_relation_lib/skins/registry.pyscript8.5 KB
scripts/svg_relation_lib/skins/riso_duotone.pyscript9.0 KB
scripts/svg_relation_lib/skins/roland_terracotta.pyscript9.0 KB
scripts/svg_relation_lib/skins/saas_product.pyscript38.6 KB
scripts/svg_relation_lib/skins/strategic_briefing.pyscript31.3 KB
scripts/svg_relation_lib/skins/swiss_grid.pyscript8.9 KB
scripts/svg_relation_lib/skins/symposium_ash.pyscript9.2 KB
scripts/svg_relation_lib/skins/technical_whitepaper.pyscript23.7 KB
scripts/svg_relation_lib/skins/terminal_matrix.pyscript9.2 KB
scripts/svg_relation_lib/skins/wabi_sabi.pyscript9.3 KB
scripts/svg_relation_lib/skins/wsj_broadsheet.pyscript9.1 KB
scripts/sxsd_validator.pyscript38.4 KB
scripts/template_lint_all.pyscript48.1 KB
scripts/xml_inspect.pyscript19.8 KB
scripts/xml_inspect_test.pyscript17.7 KB
scripts/xml_lint.pyscript226.8 KB
scripts/xml_lint_test.pyscript346.9 KB

scripts/svg_lib/charts/candle.py

View on GitHub
"""svg_lib/charts/candle.py

统一 API: draw_candle(data, variant, palette, ...) -> str (SVG)

Data schema:
    data = {
        "ohlc": [(open, high, low, close), ...],   # 每天一条
        "date_labels": [str, ...],                  # 与 ohlc 等长
        "unit": str | None,                          # 价格单位 (可选)
    }

Variants (5 共享 ohlc + date_labels):
    - candle_american_filled   实心涨跌柱(默认)
    - candle_japanese_hollow   日式:涨柱空心 + 描边,跌柱实心
    - ohlc_american            美式竖线 + open/close ticks
    - heikin_ashi              平均足平滑(内部重算 OHLC)
    - line_close               只画收盘价折线 + 面积
"""

from __future__ import annotations
import math

from ._shared import (
    resolve_palette,
    xesc,
    auto_font_size,
    viewbox_fs,
    svg_open,
    svg_close,
    _rgba_with_alpha,
    rgb_tuple,
    is_dark_palette,
)


from .._common import (
    _ACC,
    _INK,
    _INK1,
    _INK2,
    _INK4,
    _INK6,
    _prepend_bg_if_dark,
    _resolve_font,
    _resolve_palette,
    _rgba_with_alpha,
    _xesc,
    _variant_is_classic,
    _dispatch_to_svg_lib,
)

BODY_FONT = "Inter, sans-serif"
HEAD_FONT = "Georgia, serif"


def draw_candle(
    data: dict,
    variant: str = "candle_american_filled",
    palette: str = "archive_ink",
    width: float = 900,
    height: float = 540,
    title: str = None,
    subtitle: str = None,
) -> str:
    ohlc = data.get("ohlc") or []
    if len(ohlc) < 2:
        raise ValueError("draw_candle: need at least 2 ohlc rows")
    date_labels = data.get("date_labels") or [""] * len(ohlc)
    if len(date_labels) != len(ohlc):
        raise ValueError("draw_candle: date_labels length != ohlc length")
    unit = data.get("unit") or ""

    pal = resolve_palette(palette)

    # heikin_ashi: 重算 OHLC
    if variant == "heikin_ashi":
        ohlc = _make_heikin_ashi(ohlc)

    ctx = _Ctx(ohlc, date_labels, unit, pal, float(width), float(height), title, subtitle, variant)

    if variant in ("candle_american_filled", "heikin_ashi"):
        body = _draw_candle_filled(ctx)
    elif variant == "candle_japanese_hollow":
        body = _draw_candle_hollow(ctx)
    elif variant == "ohlc_american":
        body = _draw_ohlc_american(ctx)
    elif variant == "line_close":
        body = _draw_line_close(ctx)
    else:
        raise ValueError(
            f"unknown variant {variant!r}. Supported: candle_american_filled, "
            "candle_japanese_hollow, ohlc_american, heikin_ashi, line_close"
        )

    header = _header(ctx)
    axes = _axes(ctx)
    return svg_open(0, 0, ctx.W, ctx.H, bg=pal["bg"]) + header + axes + body + svg_close()


class _Ctx:
    def __init__(self, ohlc, date_labels, unit, pal, W, H, title, subtitle, variant):
        self.ohlc = ohlc
        self.date_labels = date_labels
        self.unit = unit
        self.pal = pal
        self.W = W
        self.H = H
        self.title = title
        self.subtitle = subtitle
        self.variant = variant
        self.n = len(ohlc)

        # 布局
        self.ML = 60
        self.MR = 30
        self.header_h = 20
        if title:
            self.header_h = 44
        if subtitle:
            self.header_h += 18
        self.plot_top = self.header_h + 14
        self.plot_bot = H - 34
        self.plot_w = W - self.ML - self.MR
        self.plot_h = self.plot_bot - self.plot_top

        # price range
        highs = [row[1] for row in ohlc]
        lows = [row[2] for row in ohlc]
        pmax = max(highs)
        pmin = min(lows)
        pad = (pmax - pmin) * 0.08 or 1.0
        self.pmax = pmax + pad
        self.pmin = pmin - pad

        # up/down colors
        # UP = accent (常为红/暖色),DOWN = secondary
        self.up_col = pal.get("accent", "rgba(163,88,50,1)")
        self.down_col = pal.get("secondary", "rgba(94,80,62,1)")

        self.fs_axis = viewbox_fs(W, H, self.n, role_mult=0.95)
        self.fs_label = viewbox_fs(W, H, self.n, role_mult=0.85)

    def x_of(self, i):
        # center x for day i
        if self.n == 1:
            return self.ML + self.plot_w / 2
        return self.ML + (i + 0.5) * (self.plot_w / self.n)

    def y_of(self, p):
        span = self.pmax - self.pmin
        if span <= 0:
            return self.plot_top + self.plot_h / 2
        return self.plot_bot - (p - self.pmin) / span * self.plot_h

    def bar_w(self):
        step = self.plot_w / max(1, self.n)
        return max(1.5, step * 0.62)


def _header(ctx: _Ctx) -> str:
    ink = ctx.pal["ink"]
    mut = ctx.pal["muted"]
    parts = []
    ML = ctx.ML
    if ctx.title:
        parts.append(
            f'<text x="{ML}" y="30" font-family="{HEAD_FONT}" font-size="20" '
            f'font-weight="600" fill="{ink}" letter-spacing=".03em">{xesc(ctx.title)}</text>'
        )
    if ctx.subtitle:
        y = 48 if ctx.title else 30
        parts.append(
            f'<text x="{ML}" y="{y}" font-family="{BODY_FONT}" font-size="11" '
            f'fill="{mut}" letter-spacing=".14em">{xesc(ctx.subtitle)}</text>'
        )
    if ctx.title:
        parts.append(
            f'<line x1="{ML}" y1="{ctx.header_h}" x2="{ctx.W - ctx.MR}" y2="{ctx.header_h}" '
            f'stroke="{ink}" stroke-width="0.6" opacity="0.4"/>'
        )
    return "".join(parts)


def _fmt_tick(v: float) -> str:
    """Y 轴刻度格式:|v| >= 100 → 整数;10 <= |v| < 100 → 1 位小数;|v| < 10 → 2 位小数。"""
    av = abs(v)
    if av >= 100:
        return f"{int(round(v))}"
    if av >= 10:
        return f"{v:.1f}"
    return f"{v:.2f}"


def _axes(ctx: _Ctx) -> str:
    ink = ctx.pal["ink"]
    mut = ctx.pal["muted"]
    parts = []

    # y ticks (5 ticks)
    # Bug 1 修复:当 pmax-pmin > 50(|v| 大范围)时,把步长强制为整数,
    # 避免 tick 出现 .5(此时 _fmt_tick 会 round 到 int,丢精度)。
    span = ctx.pmax - ctx.pmin
    if span > 50:
        raw_step = span / 4.0
        y_step = max(1, int(math.ceil(raw_step)))
        y_start = math.ceil(ctx.pmin / y_step) * y_step
    else:
        y_step = None  # fall back to even division
    for i in range(5):
        t = i / 4
        y = ctx.plot_bot - t * ctx.plot_h
        if y_step is not None:
            p = y_start + i * y_step
            y = ctx.y_of(p)
        else:
            p = ctx.pmin + t * (ctx.pmax - ctx.pmin)
        # Bug 1 fix: y_step 模式下 y_start + 4*y_step 可能 > pmax_padded,
        # 导致最顶 tick 的 y 坐标 < plot_top(甚至越过 viewBox 上边)。
        # 只保留落在绘图区内的 tick,其它跳过。
        if y < ctx.plot_top or y > ctx.plot_bot:
            continue
        parts.append(
            f'<line x1="{ctx.ML}" y1="{y:.1f}" x2="{ctx.W - ctx.MR}" y2="{y:.1f}" '
            f'stroke="{ink}" stroke-width="0.4" opacity="0.12"/>'
        )
        parts.append(
            f'<text x="{ctx.ML - 6}" y="{y + 3:.1f}" text-anchor="end" font-family="{BODY_FONT}" '
            f'font-size="{ctx.fs_axis}" fill="{mut}">{_fmt_tick(p)}{xesc(ctx.unit)}</text>'
        )

    # bottom axis
    parts.append(
        f'<line x1="{ctx.ML}" y1="{ctx.plot_bot}" x2="{ctx.W - ctx.MR}" y2="{ctx.plot_bot}" '
        f'stroke="{ink}" stroke-width="0.6"/>'
    )
    # date labels (only 5-8 evenly spaced)
    n = ctx.n
    n_show = min(8, n)
    step = max(1, n // n_show)
    for i in range(0, n, step):
        x = ctx.x_of(i)
        parts.append(
            f'<text x="{x:.1f}" y="{ctx.plot_bot + 16:.1f}" text-anchor="middle" '
            f'font-family="{BODY_FONT}" font-size="{ctx.fs_label}" fill="{mut}">'
            f"{xesc(ctx.date_labels[i])}</text>"
        )
    return "".join(parts)


def _draw_candle_filled(ctx: _Ctx) -> str:
    parts = []
    bw = ctx.bar_w()
    for i, row in enumerate(ctx.ohlc):
        o, h, l, c = row[0], row[1], row[2], row[3]
        x = ctx.x_of(i)
        y_o = ctx.y_of(o)
        y_h = ctx.y_of(h)
        y_l = ctx.y_of(l)
        y_c = ctx.y_of(c)
        is_up = c >= o
        col = ctx.up_col if is_up else ctx.down_col
        # wick
        parts.append(f'<line x1="{x:.1f}" y1="{y_h:.1f}" x2="{x:.1f}" y2="{y_l:.1f}" stroke="{col}" stroke-width="1"/>')
        # body
        y_top = min(y_o, y_c)
        y_bot = max(y_o, y_c)
        h_body = max(1.0, y_bot - y_top)
        parts.append(
            f'<rect x="{x - bw / 2:.1f}" y="{y_top:.1f}" width="{bw:.1f}" height="{h_body:.1f}" '
            f'fill="{_rgba_with_alpha(col, 0.92)}"/>'
        )
    return "".join(parts)


def _draw_candle_hollow(ctx: _Ctx) -> str:
    parts = []
    bw = ctx.bar_w()
    paper = ctx.pal["bg"]
    for i, row in enumerate(ctx.ohlc):
        o, h, l, c = row[0], row[1], row[2], row[3]
        x = ctx.x_of(i)
        y_o = ctx.y_of(o)
        y_h = ctx.y_of(h)
        y_l = ctx.y_of(l)
        y_c = ctx.y_of(c)
        is_up = c >= o
        col = ctx.up_col if is_up else ctx.down_col
        parts.append(f'<line x1="{x:.1f}" y1="{y_h:.1f}" x2="{x:.1f}" y2="{y_l:.1f}" stroke="{col}" stroke-width="1"/>')
        y_top = min(y_o, y_c)
        y_bot = max(y_o, y_c)
        h_body = max(1.0, y_bot - y_top)
        if is_up:
            # hollow (paper fill + stroke)
            parts.append(
                f'<rect x="{x - bw / 2:.1f}" y="{y_top:.1f}" width="{bw:.1f}" height="{h_body:.1f}" '
                f'fill="{paper}" stroke="{col}" stroke-width="1.2"/>'
            )
        else:
            parts.append(
                f'<rect x="{x - bw / 2:.1f}" y="{y_top:.1f}" width="{bw:.1f}" height="{h_body:.1f}" '
                f'fill="{_rgba_with_alpha(col, 0.92)}"/>'
            )
    return "".join(parts)


def _draw_ohlc_american(ctx: _Ctx) -> str:
    parts = []
    bw = ctx.bar_w()
    tick = max(2.5, bw * 0.55)
    for i, row in enumerate(ctx.ohlc):
        o, h, l, c = row[0], row[1], row[2], row[3]
        x = ctx.x_of(i)
        y_o = ctx.y_of(o)
        y_h = ctx.y_of(h)
        y_l = ctx.y_of(l)
        y_c = ctx.y_of(c)
        is_up = c >= o
        col = ctx.up_col if is_up else ctx.down_col
        # vertical high-low line
        parts.append(
            f'<line x1="{x:.1f}" y1="{y_h:.1f}" x2="{x:.1f}" y2="{y_l:.1f}" stroke="{col}" stroke-width="1.4"/>'
        )
        # open tick (left)
        parts.append(
            f'<line x1="{x - tick:.1f}" y1="{y_o:.1f}" x2="{x:.1f}" y2="{y_o:.1f}" stroke="{col}" stroke-width="1.4"/>'
        )
        # close tick (right)
        parts.append(
            f'<line x1="{x:.1f}" y1="{y_c:.1f}" x2="{x + tick:.1f}" y2="{y_c:.1f}" stroke="{col}" stroke-width="1.4"/>'
        )
    return "".join(parts)


def _draw_line_close(ctx: _Ctx) -> str:
    parts = []
    accent = ctx.pal["accent"]
    accent_soft = _rgba_with_alpha(accent, 0.16)
    pts = [(ctx.x_of(i), ctx.y_of(row[3])) for i, row in enumerate(ctx.ohlc)]
    # area
    area = f"M {pts[0][0]:.1f} {ctx.plot_bot:.1f} "
    area += " ".join(f"L {x:.1f} {y:.1f}" for x, y in pts)
    area += f" L {pts[-1][0]:.1f} {ctx.plot_bot:.1f} Z"
    parts.append(f'<path d="{area}" fill="{accent_soft}"/>')
    # line
    line = " ".join(f"{x:.1f},{y:.1f}" for x, y in pts)
    parts.append(f'<polyline points="{line}" fill="none" stroke="{accent}" stroke-width="2" stroke-linejoin="round"/>')
    # small dots
    if ctx.n <= 30:
        for x, y in pts:
            parts.append(f'<circle cx="{x:.1f}" cy="{y:.1f}" r="2" fill="{accent}"/>')
    return "".join(parts)


def _make_heikin_ashi(ohlc):
    """Heikin-Ashi transform:
    HA_c = (o+h+l+c)/4
    HA_o = (prev_HA_o + prev_HA_c)/2  (first day: (o+c)/2)
    HA_h = max(h, HA_o, HA_c)
    HA_l = min(l, HA_o, HA_c)
    """
    out = []
    for i, row in enumerate(ohlc):
        o, h, l, c = row[0], row[1], row[2], row[3]
        ha_c = (o + h + l + c) / 4.0
        if i == 0:
            ha_o = (o + c) / 2.0
        else:
            ha_o = (out[-1][0] + out[-1][3]) / 2.0
        ha_h = max(h, ha_o, ha_c)
        ha_l = min(l, ha_o, ha_c)
        out.append((ha_o, ha_h, ha_l, ha_c))
    return out


def make_candle(
    ohlc,
    date_labels=None,
    events=None,
    volumes=None,
    y_unit: str = "$",
    show_ma=True,
    ma_windows=(20, 60),
    show_bollinger=True,
    bollinger_window=20,
    bollinger_k=2,
    show_volume=True,
    show_side_panel=True,
    show_kpi=True,
    title=None,
    subtitle=None,
    figure_label=None,
    note=None,
    source: str = None,
    width=1500,
    height=None,
    color_convention: str = "cn",
    font_family: str = None,
    palette=None,
    variant: str = None,
) -> str:
    """
    K 线图 · dandelion academic 风格。

    ohlc: 列表,每项 (open, high, low, close) 或含 volume 的 5 元组
    date_labels: N 个日期标签(可选,自动按等距切月份刻度)
    events: [(idx, title, kind), ...] kind ∈ {"positive","warning","neutral"}
            在指定 bar 上加竖虚线 + 顶部标签
    volumes: N 个成交量(可选;若 ohlc 已含第 5 项 volume,此参数忽略)
    y_unit: 价格前缀("$", "¥" 等)

    show_ma / ma_windows: 是否叠加移动均线(可传 (20, 60) 两条)
    show_bollinger / bollinger_window / bollinger_k: 布林带
    show_volume: 底部成交量子图
    show_side_panel: 右侧 LEGEND + KEY EVENTS 面板
    show_kpi: 顶部 4 个 KPI 卡片(LAST PRICE / CHANGE / RANGE / VOLUME)

    title/subtitle/figure_label/note: 学术风顶/底文字
    palette: 用 accent → up 色 · secondary → down 色,或用户在 palette 指定 up_color/down_color
    """
    if not _variant_is_classic("candle", variant):
        _data = {"ohlc": list(ohlc), "date_labels": date_labels or []}
        return _dispatch_to_svg_lib(
            "candle",
            variant,
            _data,
            title=title,
            subtitle=subtitle,
            figure_label=figure_label,
            palette=palette,
            font_family=font_family,
        )
    if not ohlc:
        raise ValueError("candle: ohlc empty")
    N = len(ohlc)
    # 归一化 ohlc → 5-tuple with volume
    norm = []
    for i, row in enumerate(ohlc):
        if len(row) < 4:
            raise ValueError(f"candle: ohlc[{i}] must have (o,h,l,c[,v]): {row}")
        o, h, l, c = float(row[0]), float(row[1]), float(row[2]), float(row[3])
        if h < max(o, c) - 1e-6 or l > min(o, c) + 1e-6:
            raise ValueError(f"candle: ohlc[{i}] high/low invalid: h={h} l={l} o={o} c={c}")
        v = None
        if len(row) >= 5 and row[4] is not None:
            v = float(row[4])
        elif volumes is not None and i < len(volumes):
            v = float(volumes[i])
        norm.append((o, h, l, c, v))

    _pal = _resolve_palette(palette)
    _body_font, _head_font = _resolve_font(font_family)
    _INK, _INK6, _INK4, _INK2, _INK1, _ACC = (
        _pal["ink"],
        _pal["ink6"],
        _pal["ink4"],
        _pal["ink2"],
        _pal["ink1"],
        _pal["accent"],
    )
    c_muted = _pal.get("muted", _rgba_with_alpha(_INK, 0.6))
    c_secondary = _pal.get("secondary", _rgba_with_alpha(_INK, 0.5))
    c_bg = _pal.get("bg")
    PAPER = c_bg if c_bg else "rgba(247,240,226,1)"
    PANEL = _pal.get("panel", _rgba_with_alpha(_INK, 0.04) if not c_bg else _rgba_with_alpha(_INK, 0.08))

    # up/down 颜色:由 color_convention 决定
    #   "cn"(中国大陆惯例,默认):红涨 · 绿跌(红火吉利)
    #   "us"(欧美惯例):绿涨 · 红跌(红色警示)
    # 用户在 palette 里显式指定 up_color / down_color 时以 palette 为准
    _RED_COL = "rgba(152,42,55,1)"  # 波尔多酒红(印刷体)
    _GREEN_COL = "rgba(16,106,82,1)"  # 祖母绿(印刷体)
    if color_convention == "us":
        _default_up, _default_down = _GREEN_COL, _RED_COL
    else:
        _default_up, _default_down = _RED_COL, _GREEN_COL
    UP_COL = _pal.get("up_color", _default_up)
    DOWN_COL = _pal.get("down_color", _default_down)
    MA_SHORT_COL = _pal.get("ma_short_color", _ACC)
    MA_LONG_COL = _pal.get("ma_long_color", c_secondary)
    BOLL_COL = _pal.get("bollinger_color", c_secondary)

    # 派生指标
    closes = [c[3] for c in norm]

    def sma(series, n):
        """动态窗口 SMA:不足 n 时用截至当前的所有数据。"""
        out = []
        for i in range(len(series)):
            w = min(i + 1, n)
            out.append(sum(series[i - w + 1 : i + 1]) / w)
        return out

    ma_series = [sma(closes, w) for w in ma_windows] if show_ma else []

    boll_up = boll_dn = None
    if show_bollinger and N >= 2:
        bu = [None] * N
        bd = [None] * N
        # 从第一根开始就有值:不足 bollinger_window 时用截至当前的所有数据(动态窗口)
        for i in range(N):
            w = min(i + 1, bollinger_window)
            if w < 2:
                # 只有一个点,无法算 std;用一个极小对称范围避免视觉跳跃
                bu[i] = closes[i]
                bd[i] = closes[i]
                continue
            window = closes[i - w + 1 : i + 1]
            m_ = sum(window) / w
            var = sum((x - m_) ** 2 for x in window) / w
            sd = math.sqrt(var)
            bu[i] = m_ + bollinger_k * sd
            bd[i] = m_ - bollinger_k * sd
        boll_up, boll_dn = bu, bd

    # KPIs
    first = norm[0][0]
    last = norm[-1][3]
    chg = last - first
    chg_pct = chg / first * 100 if first != 0 else 0
    period_high = max(c[1] for c in norm)
    period_low = min(c[2] for c in norm)
    all_vols = [c[4] for c in norm if c[4] is not None]
    avg_vol = sum(all_vols) / len(all_vols) if all_vols else None

    # 若用户开了 show_volume 但没提供 volumes 数据,自动关闭(避免底部大片留白)
    if show_volume and not all_vols:
        show_volume = False

    # ---------- 画布 ----------
    MARGIN_L = 90
    MARGIN_R = 260 if show_side_panel else 60
    # MARGIN_T:title 存在时留 title/subtitle/figure/KPI 区(KPI 高约 70);无 title 时压缩
    MARGIN_T = 210 if (title and show_kpi) else (160 if title else (110 if show_kpi else 40))
    MARGIN_B = 90 if note else 40
    if source:
        MARGIN_B += 16

    # height 自适应:有 volume 时 820(含底部成交量子图);无 volume 时 620(只有价格区)
    if height is None:
        height = 820 if show_volume else 620

    plot_x = MARGIN_L
    plot_w = width - MARGIN_L - MARGIN_R
    GAP_MID = 22
    plot_h_total = height - MARGIN_T - MARGIN_B
    price_h_ratio = 0.72 if show_volume else 1.0
    if show_volume:
        price_h = int(plot_h_total * 0.72)
        vol_h = plot_h_total - price_h - GAP_MID
    else:
        price_h = plot_h_total
        vol_h = 0
    price_y = MARGIN_T
    vol_y = price_y + price_h + GAP_MID

    # candle 宽度
    cand_gap = max(1, min(4, plot_w / N * 0.15))
    cand_w = max(1, (plot_w - cand_gap * (N - 1)) / N)

    def x_of(i):
        return plot_x + i * (cand_w + cand_gap) + cand_w / 2

    # ---------- 字号 scale ----------
    # 基准:默认 N=60 天、plot_w ≈ 1150 → cand_w ≈ 17px
    # N 少(10-20)时 cand_w 变大 → 字号放大;N 多(100+)时收缩
    _fs_scale = max(0.85, min(1.5, cand_w / 17.0))
    fs_title = round(min(30.0, 26 * _fs_scale), 1)
    fs_subtitle = round(min(14.0, 12 * _fs_scale), 1)
    fs_figure = round(min(12.0, 10 * _fs_scale), 1)
    fs_kpi_hdr = round(min(11.0, 9 * _fs_scale), 1)
    fs_kpi_big = round(min(20.0, 15 * _fs_scale), 1)
    fs_kpi_sub = round(min(12.0, 10 * _fs_scale), 1)
    fs_yaxis = round(min(13.0, 11 * _fs_scale), 1)
    fs_xaxis = round(min(12.0, 10 * _fs_scale), 1)
    fs_vol_hdr = round(min(11.0, 9.5 * _fs_scale), 1)
    fs_evline = round(min(11.0, 9.5 * _fs_scale), 1)
    fs_side_hdr = 11
    fs_side_lg = 12
    fs_ev_date = 10
    fs_ev_ttl = 12
    fs_foot = 11

    # 价格 Y 范围(含 MA、Boll 影响的 padding)
    all_hi = max(c[1] for c in norm)
    all_lo = min(c[2] for c in norm)
    if boll_up:
        vals = [v for v in boll_up if v is not None]
        if vals:
            all_hi = max(all_hi, max(vals))
    if boll_dn:
        vals = [v for v in boll_dn if v is not None]
        if vals:
            all_lo = min(all_lo, min(vals))
    padding = (all_hi - all_lo) * 0.08
    Y_MAX = all_hi + padding
    Y_MIN = all_lo - padding

    def py_of(v):
        return price_y + (Y_MAX - v) / max(Y_MAX - Y_MIN, 1e-6) * price_h

    # 成交量 Y
    max_vol = max(all_vols) if all_vols else 1

    def vy_of(v):
        return vol_y + (1 - v / max_vol) * vol_h if vol_h > 0 else vol_y

    parts = []
    if c_bg:
        parts.append(f'<rect width="{width}" height="{height}" fill="{PAPER}"/>')

    # ---------- 标题 ----------
    if title:
        parts.append(
            f'<text x="{MARGIN_L}" y="52" '
            f'font-family="{_head_font}" '
            f'font-size="{fs_title}" font-weight="600" fill="{_INK}" letter-spacing=".05em">'
            f"{_xesc(title)}</text>"
        )
    if subtitle:
        parts.append(
            f'<text x="{MARGIN_L}" y="76" '
            f'font-family="{_body_font}" font-size="{fs_subtitle}" fill="{c_muted}" '
            f'letter-spacing=".16em">{_xesc(subtitle)}</text>'
        )
        parts.append(f'<line x1="{MARGIN_L}" y1="92" x2="{width - 40}" y2="92" stroke="{_INK}" stroke-width="0.8"/>')
    if figure_label:
        parts.append(
            f'<text x="{MARGIN_L}" y="112" font-family="{_body_font}" font-size="{fs_figure}" '
            f'fill="{c_muted}" font-weight="600" letter-spacing=".15em">{_xesc(figure_label)}</text>'
        )
        lbl_w = max(72, len(figure_label) * 8 + 20)
        parts.append(
            f'<text x="{MARGIN_L + lbl_w}" y="112" font-family="{_body_font}" font-size="{fs_figure}" '
            f'fill="{c_muted}" letter-spacing=".04em">{_xesc(f"Candlestick · {N} bars · OHLC + volume")}</text>'
        )

    # ---------- 顶部 KPI 卡片 ----------
    if show_kpi:
        chg_color = UP_COL if chg > 0 else DOWN_COL
        chg_arrow = "▲" if chg > 0 else "▼"
        kpis = [
            ("LAST PRICE", f"{y_unit}{last:.2f}", "period end"),
            ("PERIOD CHANGE", f"{chg_arrow} {chg_pct:+.1f}%", f"{y_unit}{chg:+.2f} absolute"),
            (
                "RANGE",
                f"{y_unit}{period_low:.2f} — {y_unit}{period_high:.2f}",
                f"span {y_unit}{period_high - period_low:.2f}",
            ),
        ]
        if avg_vol is not None:
            if avg_vol >= 1e6:
                kpis.append(("AVG VOLUME", f"{avg_vol / 1e6:.2f}M", "per bar"))
            elif avg_vol >= 1e3:
                kpis.append(("AVG VOLUME", f"{avg_vol / 1e3:.1f}K", "per bar"))
            else:
                kpis.append(("AVG VOLUME", f"{avg_vol:,.0f}", "per bar"))
        kpi_y = 128
        # 4 卡片均分可用宽
        n_kpi = len(kpis)
        avail_w = width - MARGIN_R - MARGIN_L
        kpi_w = min(220, (avail_w - 22 * (n_kpi - 1)) / n_kpi)
        kpi_gap = 22
        # rect 高度跟字号联动:header + big + sub + padding
        _pad_top = 8
        _pad_mid = 6
        _pad_bot = 8
        _kpi_h = _pad_top + fs_kpi_hdr + _pad_mid + fs_kpi_big + _pad_mid + fs_kpi_sub + _pad_bot
        _kpi_h = round(_kpi_h)
        _y_hdr = kpi_y + _pad_top + fs_kpi_hdr
        _y_big = _y_hdr + _pad_mid + fs_kpi_big
        _y_sub = _y_big + _pad_mid + fs_kpi_sub
        for i, (label, big, sub) in enumerate(kpis):
            kx = MARGIN_L + i * (kpi_w + kpi_gap)
            accent_c = chg_color if i == 1 else _ACC
            parts.append(
                f'<rect x="{kx:.1f}" y="{kpi_y}" width="{kpi_w:.1f}" height="{_kpi_h}" fill="{PANEL}" '
                f'stroke="{_INK4}" stroke-width="0.6"/>'
            )
            parts.append(f'<rect x="{kx:.1f}" y="{kpi_y}" width="4" height="{_kpi_h}" fill="{accent_c}"/>')
            parts.append(
                f'<text x="{kx + 12:.1f}" y="{_y_hdr:.1f}" font-family="{_body_font}" '
                f'font-size="{fs_kpi_hdr}" fill="{c_muted}" font-weight="600" letter-spacing=".14em">{_xesc(label)}</text>'
            )
            big_col = chg_color if i == 1 else _INK
            parts.append(
                f'<text x="{kx + 12:.1f}" y="{_y_big:.1f}" font-family="{_head_font}" '
                f'font-size="{fs_kpi_big}" fill="{big_col}" font-weight="700">{_xesc(big)}</text>'
            )
            # sub 放在 big 下方(原来是跟 big 同一行右对齐会跟大数字重叠)
            parts.append(
                f'<text x="{kx + 12:.1f}" y="{_y_sub:.1f}" '
                f'font-family="{_body_font}" font-size="{fs_kpi_sub}" fill="{c_muted}">{_xesc(sub)}</text>'
            )

    # ---------- Y 网格 + 价格刻度 ----------
    # nice-number tick
    def _nice_step(span, target=8):
        raw = span / target
        mag = 10 ** math.floor(math.log10(max(raw, 1e-9)))
        for nice in (1, 2, 2.5, 5, 10):
            if raw / mag <= nice:
                return nice * mag
        return 10 * mag

    step = _nice_step(Y_MAX - Y_MIN)
    # Bug 1 修复:当价格跨度 > 50 时,step 必须是整数(避免出现 .5 刻度);
    # 当 step >= 1 时也上取整为整数,防止 nice=2.5 与 mag=1 相乘出现 .5。
    if (Y_MAX - Y_MIN) > 50 or step >= 1:
        step = max(1, int(math.ceil(step)))
    y_ticks = []
    t = math.ceil(Y_MIN / step) * step
    while t <= Y_MAX + 1e-9:
        y_ticks.append(t)
        t += step

    for yv in y_ticks:
        py = py_of(yv)
        parts.append(
            f'<line x1="{plot_x}" y1="{py:.1f}" x2="{plot_x + plot_w}" y2="{py:.1f}" '
            f'stroke="{_rgba_with_alpha(_INK, 0.08)}" stroke-width="0.6"/>'
        )
        parts.append(
            f'<text x="{plot_x - 8}" y="{py + 3.5:.1f}" text-anchor="end" '
            f'font-family="{_body_font}" font-size="{fs_yaxis}" fill="{_INK}">'
            f"{_xesc(f'{y_unit}{yv:g}')}</text>"
        )
        # 右侧
        if not show_side_panel:
            parts.append(
                f'<text x="{plot_x + plot_w + 6}" y="{py + 3.5:.1f}" text-anchor="start" '
                f'font-family="{_body_font}" font-size="{fs_yaxis}" fill="{_INK}">{yv:g}</text>'
            )

    # ---------- Bollinger 阴影带 ----------
    if boll_up and boll_dn:
        band_up = [(x_of(i), py_of(boll_up[i])) for i in range(N) if boll_up[i] is not None]
        band_dn = [(x_of(i), py_of(boll_dn[i])) for i in range(N) if boll_dn[i] is not None]
        if band_up and band_dn:
            up_path = " ".join(f"{'L' if k else 'M'} {x:.1f} {y:.1f}" for k, (x, y) in enumerate(band_up))
            dn_path_rev = " ".join(f"L {x:.1f} {y:.1f}" for x, y in reversed(band_dn))
            parts.append(f'<path d="{up_path} {dn_path_rev} Z" fill="{_rgba_with_alpha(BOLL_COL, 0.06)}"/>')
            # 上下轨虚线
            parts.append(
                f'<path d="{up_path}" fill="none" stroke="{_rgba_with_alpha(BOLL_COL, 0.35)}" '
                f'stroke-width="0.8" stroke-dasharray="2 2"/>'
            )
            dn_path = " ".join(f"{'L' if k else 'M'} {x:.1f} {y:.1f}" for k, (x, y) in enumerate(band_dn))
            parts.append(
                f'<path d="{dn_path}" fill="none" stroke="{_rgba_with_alpha(BOLL_COL, 0.35)}" '
                f'stroke-width="0.8" stroke-dasharray="2 2"/>'
            )

    # ---------- 蜡烛 ----------
    for i, (o, h, l, c, v) in enumerate(norm):
        cx = x_of(i)
        is_up = c >= o
        col = UP_COL if is_up else DOWN_COL
        parts.append(
            f'<line x1="{cx:.1f}" y1="{py_of(h):.1f}" '
            f'x2="{cx:.1f}" y2="{py_of(l):.1f}" '
            f'stroke="{col}" stroke-width="1"/>'
        )
        top_v = max(o, c)
        bot_v = min(o, c)
        body_h = max(1.2, py_of(bot_v) - py_of(top_v))
        parts.append(
            f'<rect x="{cx - cand_w / 2:.1f}" y="{py_of(top_v):.1f}" '
            f'width="{cand_w:.1f}" height="{body_h:.1f}" '
            f'fill="{_rgba_with_alpha(col, 0.92)}"/>'
        )

    # ---------- MA 均线 ----------
    ma_cols = [MA_SHORT_COL, MA_LONG_COL]
    for mi, ma in enumerate(ma_series):
        pts = [(x_of(i), py_of(v)) for i, v in enumerate(ma) if v is not None]
        if not pts:
            continue
        d = " ".join(f"{'L' if k else 'M'} {x:.1f} {y:.1f}" for k, (x, y) in enumerate(pts))
        col = ma_cols[mi] if mi < len(ma_cols) else _ACC
        alpha = 1.0 if mi == 0 else 0.9
        parts.append(f'<path d="{d}" fill="none" stroke="{_rgba_with_alpha(col, alpha)}" stroke-width="1.6"/>')

    # ---------- 事件注释 ----------
    if events:
        for ev in events:
            if len(ev) < 2:
                continue
            idx = ev[0]
            ev_title = ev[1]
            kind = ev[2] if len(ev) > 2 else "neutral"
            if idx < 0 or idx >= N:
                continue
            ex = x_of(idx)
            bottom_y = (vol_y + vol_h) if show_volume else (price_y + price_h)
            parts.append(
                f'<line x1="{ex:.1f}" y1="{price_y + 8}" x2="{ex:.1f}" y2="{bottom_y:.1f}" '
                f'stroke="{c_muted}" stroke-width="0.6" stroke-dasharray="3 3"/>'
            )
            ann_col = UP_COL if kind == "positive" else (DOWN_COL if kind == "warning" else _ACC)
            # 标签宽度按文字估算
            lab_w = max(90, len(str(ev_title)) * 6 + 30)
            parts.append(
                f'<rect x="{ex - lab_w / 2:.1f}" y="{price_y + 2}" width="{lab_w:.1f}" height="18" rx="2" '
                f'fill="{PANEL}" stroke="{_rgba_with_alpha(ann_col, 0.6)}" stroke-width="0.8"/>'
            )
            parts.append(f'<circle cx="{ex - lab_w / 2 + 12:.1f}" cy="{price_y + 11}" r="2.5" fill="{ann_col}"/>')
            parts.append(
                f'<text x="{ex - lab_w / 2 + 20:.1f}" y="{price_y + 15}" font-family="{_body_font}" '
                f'font-size="{fs_evline}" fill="{_INK}" font-weight="600">{_xesc(str(ev_title))}</text>'
            )

    # ---------- Volume 子图 ----------
    if show_volume and all_vols:
        # 网格
        for f in [0.5, 1.0]:
            yv = max_vol * f
            py = vy_of(yv)
            parts.append(
                f'<line x1="{plot_x}" y1="{py:.1f}" x2="{plot_x + plot_w}" y2="{py:.1f}" '
                f'stroke="{_rgba_with_alpha(_INK, 0.05)}" stroke-width="0.5"/>'
            )
            if yv >= 1e6:
                lbl = f"{yv / 1e6:.1f}M"
            elif yv >= 1e3:
                lbl = f"{yv / 1e3:.0f}K"
            else:
                lbl = f"{yv:.0f}"
            parts.append(
                f'<text x="{plot_x - 8}" y="{py + 3.5:.1f}" text-anchor="end" '
                f'font-family="{_body_font}" font-size="{fs_yaxis - 1}" fill="{c_muted}">{_xesc(lbl)}</text>'
            )
        for i, (o, h, l, c, v) in enumerate(norm):
            if v is None:
                continue
            cx = x_of(i)
            col = UP_COL if c >= o else DOWN_COL
            top = vy_of(v)
            bot = vy_of(0)
            parts.append(
                f'<rect x="{cx - cand_w / 2:.1f}" y="{top:.1f}" '
                f'width="{cand_w:.1f}" height="{bot - top:.1f}" '
                f'fill="{_rgba_with_alpha(col, 0.55)}"/>'
            )
        # 标题
        parts.append(
            f'<text x="{plot_x}" y="{vol_y - 6}" font-family="{_body_font}" '
            f'font-size="{fs_vol_hdr}" fill="{c_muted}" font-weight="600" letter-spacing=".14em">VOLUME</text>'
        )

    # ---------- X 轴刻度(日期) ----------
    bottom_axis_y = (vol_y + vol_h) if show_volume else (price_y + price_h)
    # 若 date_labels 存在:等距抽 6-10 个 tick
    if date_labels:
        n_show = min(len(date_labels), 10)
        step_lab = max(1, len(date_labels) // n_show)
        tick_positions = list(range(0, len(date_labels), step_lab))
        if tick_positions[-1] != len(date_labels) - 1:
            tick_positions.append(len(date_labels) - 1)
        for pi in tick_positions:
            xv = x_of(pi)
            lbl = str(date_labels[pi])
            parts.append(
                f'<line x1="{xv:.1f}" y1="{bottom_axis_y}" x2="{xv:.1f}" y2="{bottom_axis_y + 4}" '
                f'stroke="{c_muted}" stroke-width="0.8"/>'
            )
            parts.append(
                f'<text x="{xv:.1f}" y="{bottom_axis_y + 18}" text-anchor="middle" '
                f'font-family="{_body_font}" font-size="{fs_xaxis}" font-weight="600" '
                f'fill="{_INK}">{_xesc(lbl)}</text>'
            )
    else:
        # 默认在 5 等分位置
        for k in range(6):
            i = int(k * (N - 1) / 5) if N > 1 else 0
            xv = x_of(i)
            parts.append(
                f'<line x1="{xv:.1f}" y1="{bottom_axis_y}" x2="{xv:.1f}" y2="{bottom_axis_y + 4}" '
                f'stroke="{c_muted}" stroke-width="0.8"/>'
            )
            parts.append(
                f'<text x="{xv:.1f}" y="{bottom_axis_y + 18}" text-anchor="middle" '
                f'font-family="{_body_font}" font-size="{fs_xaxis}" font-weight="600" '
                f'fill="{_INK}">{i + 1}</text>'
            )

    # 时间轴基线
    parts.append(
        f'<line x1="{plot_x}" y1="{bottom_axis_y}" x2="{plot_x + plot_w}" y2="{bottom_axis_y}" '
        f'stroke="{_INK}" stroke-width="0.9"/>'
    )

    # ---------- 右侧侧栏 ----------
    if show_side_panel:
        side_x = width - MARGIN_R + 30
        side_w = MARGIN_R - 30 - 30

        # LEGEND
        parts.append(
            f'<text x="{side_x}" y="{MARGIN_T + 10}" font-family="{_body_font}" '
            f'font-size="{fs_side_hdr}" fill="{c_muted}" font-weight="600" letter-spacing=".14em">LEGEND</text>'
        )
        parts.append(
            f'<line x1="{side_x}" y1="{MARGIN_T + 18}" x2="{side_x + side_w}" y2="{MARGIN_T + 18}" '
            f'stroke="{_INK}" stroke-width="0.6"/>'
        )

        # 涨蜡烛示例
        lg_y = MARGIN_T + 40

        def _sample_candle(sx, sy, color):
            parts.append(f'<line x1="{sx}" y1="{sy - 14}" x2="{sx}" y2="{sy + 14}" stroke="{color}" stroke-width="1"/>')
            parts.append(
                f'<rect x="{sx - 4}" y="{sy - 8}" width="8" height="16" fill="{_rgba_with_alpha(color, 0.92)}"/>'
            )

        _sample_candle(side_x + 8, lg_y, UP_COL)
        parts.append(
            f'<text x="{side_x + 24}" y="{lg_y + 4}" font-family="{_body_font}" '
            f'font-size="{fs_side_lg}" font-weight="600" fill="{_INK}">Up day (close ≥ open)</text>'
        )

        _sample_candle(side_x + 8, lg_y + 32, DOWN_COL)
        parts.append(
            f'<text x="{side_x + 24}" y="{lg_y + 36}" font-family="{_body_font}" '
            f'font-size="{fs_side_lg}" font-weight="600" fill="{_INK}">Down day (close &lt; open)</text>'
        )

        row_i = 2
        if show_ma:
            for mi, w in enumerate(ma_windows):
                col = ma_cols[mi] if mi < len(ma_cols) else _ACC
                y_line = lg_y + 62 + mi * 20
                parts.append(
                    f'<line x1="{side_x + 2}" y1="{y_line}" x2="{side_x + 18}" y2="{y_line}" '
                    f'stroke="{col}" stroke-width="1.8"/>'
                )
                short_long = "short-term" if mi == 0 else "long-term"
                parts.append(
                    f'<text x="{side_x + 24}" y="{y_line + 4}" font-family="{_body_font}" '
                    f'font-size="{fs_side_lg}" font-weight="600" fill="{_INK}">MA {w} ({short_long})</text>'
                )
            row_i += len(ma_windows)
        if show_bollinger:
            y_line = lg_y + 62 + (len(ma_windows) if show_ma else 0) * 20
            parts.append(
                f'<line x1="{side_x + 2}" y1="{y_line}" x2="{side_x + 18}" y2="{y_line}" '
                f'stroke="{_rgba_with_alpha(BOLL_COL, 0.5)}" stroke-width="0.8" stroke-dasharray="2 2"/>'
            )
            parts.append(
                f'<text x="{side_x + 24}" y="{y_line + 4}" font-family="{_body_font}" '
                f'font-size="{fs_side_lg}" font-weight="600" fill="{_INK}">Bollinger ({bollinger_window}, {bollinger_k}σ)</text>'
            )

        # KEY EVENTS
        if events:
            ev_start = lg_y + 62 + ((len(ma_windows) if show_ma else 0) + (1 if show_bollinger else 0)) * 20 + 30
            parts.append(
                f'<text x="{side_x}" y="{ev_start}" font-family="{_body_font}" '
                f'font-size="{fs_side_hdr}" fill="{c_muted}" font-weight="600" letter-spacing=".14em">KEY EVENTS</text>'
            )
            parts.append(
                f'<line x1="{side_x}" y1="{ev_start + 8}" x2="{side_x + side_w}" y2="{ev_start + 8}" '
                f'stroke="{_INK4}" stroke-width="0.5"/>'
            )
            for i, ev in enumerate(events):
                if len(ev) < 2:
                    continue
                idx = ev[0]
                ev_title = ev[1]
                kind = ev[2] if len(ev) > 2 else "neutral"
                col = UP_COL if kind == "positive" else (DOWN_COL if kind == "warning" else _ACC)
                ey = ev_start + 28 + i * 42
                if idx < 0 or idx >= N:
                    continue
                o_i = norm[idx][0]
                c_i = norm[idx][3]
                day_ret = (c_i - o_i) / o_i * 100 if o_i else 0
                parts.append(
                    f'<rect x="{side_x}" y="{ey}" width="{side_w}" height="32" fill="{PANEL}" '
                    f'stroke="{_INK4}" stroke-width="0.5"/>'
                )
                parts.append(f'<rect x="{side_x}" y="{ey}" width="3" height="32" fill="{col}"/>')
                date_str = date_labels[idx] if (date_labels and idx < len(date_labels)) else f"bar {idx + 1}"
                parts.append(
                    f'<text x="{side_x + 10}" y="{ey + 12}" font-family="{_body_font}" '
                    f'font-size="{fs_ev_date}" fill="{c_muted}" font-weight="600" letter-spacing=".1em">'
                    f"{_xesc(str(date_str))}</text>"
                )
                parts.append(
                    f'<text x="{side_x + 10}" y="{ey + 25}" font-family="{_body_font}" '
                    f'font-size="{fs_ev_ttl}" fill="{_INK}" font-weight="700">{_xesc(str(ev_title))}</text>'
                )
                parts.append(
                    f'<text x="{side_x + side_w - 10}" y="{ey + 25}" text-anchor="end" '
                    f'font-family="{_head_font}" font-size="{fs_ev_ttl + 2}" font-weight="700" '
                    f'fill="{col}">{day_ret:+.1f}%</text>'
                )

    # ---------- 底部脚注 ----------
    if note or source:
        foot_y = height - 32
        parts.append(
            f'<line x1="{MARGIN_L}" y1="{foot_y - 14}" x2="{width - 40}" y2="{foot_y - 14}" '
            f'stroke="{_INK4}" stroke-width="0.5"/>'
        )
        if note:
            parts.append(
                f'<text x="{MARGIN_L}" y="{foot_y}" font-family="{_body_font}" '
                f'font-size="9.5" fill="{c_muted}">'
                f'<tspan font-weight="600">Notes.</tspan> {_xesc(note)}</text>'
            )
        if source:
            src_y = foot_y + 14 if note else foot_y
            parts.append(
                f'<text x="{MARGIN_L}" y="{src_y}" font-family="{_body_font}" '
                f'font-size="9.5" fill="{c_muted}">'
                f'<tspan font-weight="600">Source.</tspan> {_xesc(source)}</text>'
            )

    body = "".join(parts)
    _svg_result = f'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 {int(width)} {int(height)}">{body}</svg>'
    return _prepend_bg_if_dark(_svg_result, _pal)


# ==============================================================
# 6) Boxplot 箱线图(多组四分位分布)
# ==============================================================
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall