AlertaScript

Ngôn ngữ kịch bản biểu đồ độc lập cho AlertaChart

Tổng quan về ngôn ngữ

Sổ tay tham khảo AlertaScript

AlertaScript là tầng ngôn ngữ kịch bản riêng của chúng tôi cho phân tích biểu đồ và phát triển chiến lược trong AlertaChart. Nó được xây dựng và duy trì bởi đội ngũ của chúng tôi, chạy trên runtime của chúng tôi và được tài liệu hóa như một giao diện sản phẩm hạng nhất. Trang này mô tả AlertaScript là gì, cách nó thực thi, cách xử lý tương thích và hiện có những hỗ trợ tham khảo nào trên nền tảng.

AlertaScript là gì

AlertaScript là một môi trường kịch bản biểu đồ độc lập được thiết kế cho phân tích kỹ thuật, lớp phủ trực quan và quy trình hướng chiến lược. Người dùng có thể viết logic kịch bản hoạt động trên dữ liệu biểu đồ, tạo đầu ra trực quan và xác định các quy tắc có thể phân tích trong ngữ cảnh runtime nhất quán.

Từ góc độ sản phẩm, AlertaScript không phải là một wrapper mỏng xung quanh một backend thực thi bên ngoài. Trình phân tích cú pháp, hành vi runtime, xử lý trạng thái và tạo lệnh biểu đồ đều được kiểm soát trong codebase của AlertaChart.

Nguyên tắc thiết kế

Ngôn ngữ được xây dựng quanh bốn nguyên tắc: khả năng đọc cho người viết kịch bản, ngữ nghĩa runtime ổn định, tài liệu minh bạch và sự phát triển có nhận thức về tương thích.

Một nguyên tắc quan trọng khác là an toàn vận hành. Chúng tôi ưu tiên thực thi có giới hạn và kiểm tra runtime mạnh mẽ để các kịch bản vẫn có thể sử dụng được ở quy mô lớn.

Mô hình thực thi

AlertaScript thực thi trong một runtime tập trung vào biểu đồ, chú trọng vào xử lý nến xác định, hành vi chuỗi đáng tin cậy và chuyển đổi trạng thái rõ ràng.

Ngôn ngữ hỗ trợ phân tích theo phong cách chỉ báo, các lệnh đầu ra trực quan và các hành vi liên quan đến chiến lược thông qua các hàm tích hợp được tài liệu hóa và kỳ vọng đối số có kiểu.

Tương thích Pine

AlertaScript bao gồm các khu vực bề mặt tương thích với Pine khi áp dụng, với ánh xạ rõ ràng và phân loại tương đương.

Tóm lại: chúng tôi hỗ trợ tương thích như một mục tiêu sản phẩm, đồng thời duy trì bản sắc ngôn ngữ/runtime độc lập. Tương thích Pine được cung cấp trên cơ sở phiên bản cho cú pháp và bề mặt có thể gọi được hỗ trợ; nó không hàm ý sự tương đương một-một cho tất cả các hàm/hành vi.

Để dễ dàng chuyển đổi từ các kịch bản Pine cũ, input(defval, title=..., type=...), iff(), tr như một biến chuỗi và các bí danh kiểu vẽ không có namespace như histogram/cross cũng được hỗ trợ. Đối với mã AlertaScript mới, input.bool/input.int, biểu thức ba ngôi và style.histogram/style.cross được ưu tiên.

AlertaScript là một ngôn ngữ và runtime độc lập. Thuật ngữ tương thích Pine được cung cấp như một lớp tham chiếu để giúp người dùng chuyển đổi với các tên hàm quen thuộc, mẫu cú pháp và quy trình chỉ báo có hỗ trợ AI. Nó không có nghĩa là tương đương một-một với Pine trong mọi tình huống. Vì AlertaScript là một hệ thống mới và đang phát triển tích cực, việc xác thực cuối cùng cho các trường hợp nâng cao hoặc biên luôn nên dựa vào tài liệu tham khảo AlertaScript mới nhất.

Hỗ trợ tham khảo

Danh mục tham khảo của chúng tôi được phiên bản hóa và có cấu trúc để các tác giả kịch bản có thể nhanh chóng khám phá những gì hiện được hỗ trợ.

Tra cứu tham khảo trong trình chỉnh sửa vẫn có sẵn cho các chữ ký và ví dụ chính xác. Trang sổ tay này bổ sung điều đó bằng cách giải thích bề mặt ngôn ngữ theo định dạng tường thuật dài.

Phạm vi & An toàn

Sổ tay này cố ý mô tả các khả năng, nguyên tắc hành vi và phạm vi hỗ trợ ở mức tín hiệu trên nhiễu cao. Chúng tôi không tiết lộ các chi tiết triển khai nội bộ không liên quan đến kết quả viết kịch bản.

Khi AlertaScript phát triển, trang này sẽ tiếp tục mô tả hướng đi của ngôn ngữ và phạm vi hỗ trợ, trong khi các tham chiếu có thể gọi chi tiết vẫn được liên kết với kho tài liệu phiên bản hóa.

Liên kết nhanh

Trên màn hình biểu đồ, mở menu ƒχ ở thanh trên cùng, sau đó sử dụng Docs (Cmd+K) bên trong Script Editor để truy cập nhanh vào bề mặt tham chiếu này.

Mở màn hình biểu đồ (ƒχ)