TradingView 轻量图表技能
让 AI 助手掌握 TradingView Lightweight Charts v5 的 API 约定与常见坑点，直接生成可用的金融图表代码。
该技能是纯知识型文档，不含脚本、网络调用或任何副作用，天然最小权限；内置'先验证后回答'的命令（读本地 typings/package.），明确要求无法验证时如实说明、禁止编造 API 名称，并能区分第三方 Python 包装器，数据流透明。扣分项：静态审阅无法确认运行时行为，无回滚/确认机制的概念（对文档型技能基本不适用），发布者未经注册表验证，故不给满分。
内部自洽：给定版本探测顺序、v4→v5 对照矩阵、triage 表和失败提示（文件不可用时明确说明），可控性良好。静态审阅下不超过 10 分的锚线；仓库确有 CI 工作流（deploy.yml、pkg-pr-new.yml）和单元/e2e 测试套件，但它们覆盖的是库本身而非该技能的关键路径，故仅小幅上浮至 11。
description 与正文高度匹配：明确的受众（lightweight-charts 使用者）、触发场景（系列、刻度、标记、插件、包装器）、非适用边界（Python 包装器、非时间横轴需先判断）、消费方/上游两种环境判断。扣分项：无中文语言支持说明，部分资源依赖 unpkg/GitHub/官方站点，中国大陆可达性未声明；未给出明确的误触发防护之外的负面清单。
文档分层清晰：速查表、心智模型、foot-gun、路由图、菜谱逐级递进；许可（Apache-2.0）与版本锚定（v5，package. 5.2.1）明确，上游 README 提供安装路径（npx skills add）与维护归属（TradingView 官方仓库）。扣分项：技能自身无 changelog/版本记录，无 FAQ 与已知局限的独立章节，部分路由指向的 repo 路径未在本证据中核实存在。
针对高频痛点（UTCTimestamp 秒级、setMarkers 迁移、timezone 不存在、per-bar 颜色、SSR）给出可直接复制的正确代码，边际价值明显高于手动查文档或依赖过时片段。静态审阅下上限 7 分：示例未被执行验证，输出可直接可用性未经代表性结果证实。
技能自身要求以本地 typings 为准并给出可复制的 rg/node 验证命令，属于可审计的主材料路径；仓库有 CI 与测试套件佐证库的维护质量。但无第三方对技能本身的独立复现，路由表中大量文档路径未被本证据直接证实，故不超过 5。
- 本评估为静态源码审阅，未执行任何命令或示例代码，示例的正确性未经运行验证。
- 技能未声明中文支持；plain HTML 与部分文档资源依赖 unpkg、GitHub 等境外服务，中国大陆网络下可达性需自行确认。
- 技能文档引用的 website/docs、plugin-examples 等仓库路径未在本证据中逐一核实，消费方项目中应优先依赖本地 node_modules 内的 typings。
- 发布者为 TradingView 官方仓库但未经 FollowSkills 注册表验证；技能本身无独立版本号或 changelog，升级 v5 后续版本时需复核内容时效性。
这个 Skill 能做什么，适合哪些场景？
这是 TradingView 官方 lightweight-charts 仓库自带的 Agent Skill，教导 AI 编码助手正确使用 v5 API。它涵盖图表与系列的创建、时间与价格刻度、实时数据更新、窗格（pane）、标记、水印、插件/原语扩展，以及 React/Vue/Web Components 封装的用法。技能的核心价值在于避免复制过时的 v4 片段——例如 addLineSeries、series.setMarkers 等已被移除的调用。它还内置了时间戳秒 vs 毫秒、时区显示、setData 与 update 的差异等常见陷阱的具体修正方案。
技能指示助手首先检测当前环境是消费者应用还是上游源码检出：前者读取 node_modules/lightweight-charts/package. 与 dist/typings.d.ts 确认版本和 API 表面，后者读取仓库的 dist/typings.d.ts 与 src/。它提供 v5 心智模型（图表/系列/刻度/数据/交互/布局/扩展/封装八层）、v4 到 v5 替换矩阵、按问题路由到官方文档路径的映射表，以及实时更新、双价格刻度、成交量窗格、逐柱着色、标记、时区格式化、坐标转换、Next.js 客户端组件、插件脚手架等可直接复制的代码配方。回答时要求指明所用 v5 API、给出最小代码片段、点出主要陷阱，并说明已验证的本地来源。
- 前端开发者在 React/Next.js 项目中第一次集成 K 线或折线图，需要正确的 v5 初始化与销毁生命周期
- 开发者接入了过时的 v4 代码片段（如 series.setMarkers、addLineSeries），需要迁移到 v5 等价 API
- 交易工具开发者需要 WebSocket 实时推送逐笔更新最后一根 K 线，避免 setData 导致可视范围重置
- 量化/行情界面需要双价格刻度、独立成交量窗格或逐柱红绿着色
- 插件作者想用 series/pane primitive 或自定义系列实现绘图工具、水印等扩展
- 需要展示期权链等非时间横轴数据，或用 Intl.DateTimeFormat 做 DST 安全的时区显示
这个 Skill 有哪些优点和局限？
- 来自 TradingView 官方仓库，与库本身一同维护，API 信息可信
- 针对最高频的失败模式（v4 过时片段、秒 vs 毫秒时间戳、setData vs update）给出明确的断言式修正
- 强调用本地 typings 验证 API 名称，禁止编造不存在的选项和方法
- 覆盖从 vanilla JS 到 React/Vue/Web Components 及 SSR 的多种运行环境
- Apache-2.0 许可，可自由使用
- 仅覆盖 lightweight-charts 这一个库，对其他图表库（如 ECharts、Highcharts）无帮助
- 主要为 v5 设计，若用户锁死在 v3/v4，只能提供迁移说明而非深度旧版支持
- 技能正文假设 Node.js 环境（需要读取 node_modules 中的 typings），纯浏览器沙箱环境价值有限
- 未包含独立的自动化测试套件；效果依赖宿主助手是否真正加载并遵循该技能
- 第三方 Python 封装（lightweight_charts）明确不在范围内，只做识别与提示
如何安装这个 Skill？
在项目根目录运行：npx skills add https://github.com/tradingview/lightweight-charts —— 这是 README 中官方给出的安装方式，会将 .github/skills/lightweight-charts/SKILL.md 注册给兼容助手（如 Claude Code、Codex）。
如何使用这个 Skill？
安装后，当你在对话中提问 lightweight-charts 相关问题时助手会自动应用该技能，例如：「用 v5 创建一个带成交量窗格的 K 线图」「为什么每次新数据到达图表都会跳到右边缘」。技能要求回答时先检查已安装包的 typings 确认版本，因此项目中应已通过 npm install lightweight-charts 安装该包，否则助手会声明无法验证。
这个 Skill 与同类方案有什么区别？
与泛用的前端图表技能相比，本技能是库专属的深度知识库：它不泛谈可视化最佳实践，而是精确对齐 lightweight-charts v5 的 API 与官方文档路径。若你的项目使用其他图表库，应选择对应库的技能或依赖通用文档。