用途
OpenScript 是 OpenAlgo 平台的一种脚本语言,编译为程序后可在编辑器中打开、在 /trading 回测并部署到交易品种上。本技能用于编写 OpenScript 研究(study)或策略(strategy),并在编译通过后安装到 strategies/openscript/ 目录。
需要区分仓库中三个同被称作 indicator 的对象:OpenScript(本技能)是语言,文件后缀为 .oscript,既能绘图也能下单;chart-indicator 是运行于 openalgo-charts 的纯 JavaScript 描述符,仅绘图;openalgo.ta 是供 Python 策略宿主、扫描器和回测使用的 Python 库。若请求涉及 .oscript 文件、OpenScript 编辑器或部署到 /trading 的策略,则属于本技能。
主要能力
- 编写 .oscript 研究或策略,编译后安装为可运行程序。
- 提供 350 个名称的库参考,含每个名称的语义和预热期。
- 提供陷阱清单,附带实际会遇到的诊断码。
- 提供策略结构范式及对应示例说明。
- 提供从 JavaScript 图表指标移植到研究脚本的指南。
- 提供六个可编译的示例文件。
- 支持导入以 //@version=5 或 //@version=6 开头的常见图表语言脚本。
使用方式
不得手工写入 strategies/openscript/。该目录每个脚本对应两个文件:<name>.oscript 与 <name>.oscript.program.json,运行器只读取 program.json,不读取源码。因此必须由一次编译同时产出两个文件:
- 先草稿写入临时文件,不要写入 openscript 目录。
- 使用 node .claude/skills/openscript/validate.mjs <scratch>/my_strategy.oscript 编译。
- 仅在输出 PASSED 后执行 node .claude/skills/openscript/validate.mjs <scratch>/my_strategy.oscript --install 安装;可用 --as 指定安装名。
--install 仅在零错误时写入两个文件,否则退出码为 1。写入前会检查编译程序记录的哈希是否与将要写入的源码匹配,不匹配则拒绝且不写入。
从其他图表语言移植时,编译器自带导入器,处理 //@version=5 或 //@version=6 开头的脚本,差异以 OS9001 至 OS9012 范围内的警告或注释呈现,输出需人工逐条复核,再按上述流程校验。从 JavaScript 图表指标移植没有导入器,需先阅读 reference/porting-from-javascript.md。
适用场景
创建新的 OpenScript 研究或策略、将现有脚本移植到 OpenScript、调试 OpenScript 编译与运行问题,以及需要在 /trading 上回测或部署脚本的场合。
限制与注意事项
- 编译通过只表示编译器接受了文本(名称可解析、类型一致、调用存在、限制满足),不代表策略有效、数值正确或能盈利。部分错误只有在运行到某根 K 线时才会出现,例如 OS4008、OS6025,编译通过不能排除它们。
- 350 个名称中有 95 个是规划但未实现的,名称可解析并不意味着能编译,使用会报 OS2020;reference/library.md 中有标记,order.qtyForRisk 以及 leg.、book. 等整个系列均属规划中。
- buy 和 sell 按数量增减持仓,而非设定方向;例如持有一手多单时执行 sell(qty = lots) 会变为空仓而非空头,且不会被拒绝。参见 examples/stop-and-reverse.oscript。
- 缺失值不等于零,有状态调用的预热期内算术结果为缺失值;用 orElse 或 otherwise 在预热期填入数字会导致前段 K 线结果错误。
- 技能描述的是 openalgo-script 0.8.1 及同版本的服务端引擎 openscript;0.9.0 版本即将发布,届时需查看其变更日志。
- 升级 openalgo-script 时需同步更新本技能:运行生成器、两项检查,并手动更新文字说明。