从第一次回测开始。

安装与启动

从下载页选择系统和架构。便携包包含运行环境，无需安装 Rust、Cargo 或 Node.js。完整解压后再启动。

• Windows: 双击 Start XPine.cmd。
• Linux: ./start.sh
• macOS: 打开 Start XPine.command。M 系列芯片选择 Apple Silicon，Intel 芯片选择 Intel。

启动窗口会显示本地地址并打开浏览器。默认地址为 http://127.0.0.1:8765；保持启动窗口开启，按 Ctrl+C 停止服务。

第一次回测

1. 在 Pine 编辑器点击“载入”，选择“示例”中的 EMA Cross，或导入自己的 Pine 文件。
2. 选择交易对、周期和历史区间，等待完整行情加载完成。
3. 打开“策略属性”，核对本金、订单大小、手续费、滑点和保证金。
4. 点击“运行回测”，查看概览、交易明细、详细数据和运行记录。
5. 需要保留代码时，保存为自己的策略副本；需要分析明细时，导出交易 CSV 或完整结果。

示例用于了解工作流程，结果可能为亏损。软件不会因完成回测而自动提交交易。

历史数据与交易成本

首次使用或切换区间需要连接历史行情服务。软件优先读取本地缓存，补充缺失及近期数据；首次加载、长区间和短周期可能耗时较久。没有缓存的行情无法离线获取。

核对界面显示的数据来源、实际回测区间和行情警告。资金费率、市场精度与成交假设存在适用限制。不同来源和成本设置会改变结果，不能直接当作 TradingView 的一致性证明。

“检查历史修正”会单独核对历史数据，可能耗时；刷新页面不会自动执行这项检查。

自动参数优化

点击“自动优化”，选择受支持的输入参数、范围、步长或候选项。设置网格或 TPE 搜索、评估预算、目标和最少交易数，然后开始。首次体验建议只搜索几组。

预算之外还会评估一组原始参数基准。优化固定开始时的代码、成本与行情快照，结果不会自动覆盖策略。可查看报告、下载 Pine，或应用到草稿后重新回测。

当前搜索适用于受支持的常量默认值输入，不支持的参数会显示原因。排名只针对本次已评估组合；请使用独立区间继续检验，避免把训练结果当作未来表现。

精选策略

在编辑器点击“精选策略”。卡片提供策略副本、行情、成本和验证记录，可按名称、币对及周期筛选。“一键加载”会应用对应代码、参数及区间，不会自动回测、保存到个人库或提交交易。

卡片的验证期与包含训练期的全年结果是不同口径。部分案例使用放大仓位，部分历史窗口被多轮研究复用，且未计资金费率。检查详情，保留成本设置，并用新数据继续验证。

自动参数优化和精选策略属于计划中的 Pro 订阅功能，预览期间暂时开放。

服务器运行

在 Linux 服务器上解压对应版本，以普通用户启动：

./start.sh --no-open --port 8765

软件只监听服务器的 127.0.0.1。在自己的电脑建立 SSH 隧道，再访问 http://127.0.0.1:8765：

ssh -N -L 8765:127.0.0.1:8765 user@your-server

如果本机端口占用，可把隧道左侧端口改为 8766，再访问本机 8766。不要把工作区直接暴露到公网；官网与本地软件是独立服务。

兼容范围

XPine 支持已经实现的 Pine 语法、指标和策略行为，支持范围仍在完善。它与 TradingView 无隶属关系，不承诺完整支持所有脚本或结果完全一致。

遇到不支持的函数、数据请求或订单行为，请查看诊断与实际生效属性。跨品种请求、成交路径、行情来源和市场精度需要单独核验。实盘功能尚未完成真实交易所验收，不作为官网首版的已验证能力。

数据与升级

用户数据默认保存在以下位置，与软件安装文件分离：

• Windows: %LOCALAPPDATA%\XPine
• macOS: ~/Library/Application Support/XPine
• Linux: ~/.local/share/xpine （设置 XDG_DATA_HOME 时使用其下的 xpine）

升级前停止服务，备份数据目录，把新版解压到新的软件目录再启动。发布包不会覆盖个人策略、运行记录和配置。旧版本数据格式的迁移会在相应更新日志中注明。

可以通过 --data-dir 指定绝对路径，但必须位于软件目录之外。

常见问题