链接长桥证券账户并同步资产

ONEW 支持通过长桥证券授权读取账户资产，并把长桥账户关联到一个 ONEW 账户中。完成绑定后，你可以先查看同步预览，再决定是否把长桥返回的现金、股票、基金等资产写入 ONEW。

开始之前

请先确认：

• 已安装支持长桥资产同步的 ONEW 版本（需 1.7.0 或以上）。
• 已拥有可登录的长桥证券账户。
• ONEW 中已经创建好一个用于承接长桥资产的账户，例如「长桥证券」。
• 网络可以访问长桥开放平台授权页。

1. 打开长桥证券连接入口

进入 ONEW 后，切换到底部「设置」标签页。在「高级设置」中点击「长桥证券」。

2. 发起长桥账户连接

在「长桥证券」页面点击「连接长桥账户」。这里显示的是 ONEW 已保存的长桥连接列表；首次使用时，列表会显示「暂无已连接的长桥账户」。

ONEW 会调用系统登录授权能力。系统弹窗出现后，点击「继续」进入长桥授权页面。

3. 在长桥页面完成授权

长桥授权页会显示 ONEW 请求访问你的长桥账户。确认当前长桥账户无误后，勾选同意条款并继续授权。

授权完成后，页面会回到 ONEW。此时「长桥证券」页面的「已连接账户」列表中会出现刚刚授权的真实长桥账户。

注意：授权代表允许 ONEW 使用长桥开放平台读取账户与持仓等信息，用于资产同步。请只在确认账户正确时继续。ONEW 仅需要「Account & Positions」授权即可，其他权限可以不用勾选。

4. 进入 ONEW 账户的资产同步设置

回到「账户」标签页，打开你准备用来承接长桥资产的 ONEW 账户详情页。点击「资产同步」这一行。

如果还没有完成长桥授权，资产同步页中的「长桥账户」会显示「无连接」，无法加载真实同步预览。

如果当前 ONEW 账号没有 Plus 权限，可以先在「设置」中进入演示模式，再新建一个用于承接同步结果的 Longbridge 演示账户。下面的同步截图使用演示模式里的 ONEW 账户承接数据，但长桥连接和同步预览来自真实长桥授权返回。

5. 绑定长桥账户并加载同步预览

完成真实长桥授权后，在「资产同步」页面按下面顺序操作：

1. 打开「长桥账户」，选择刚刚授权的长桥账户。
2. 「同步脚本」保持为 longbridge_sync.js。
3. 按需保留「自动合并同代码资产」。开启后，ONEW 会尝试把长桥返回的同代码资产和本地已有资产合并。
4. 点击「加载首次同步预览」。

同步预览会把长桥返回的数据分为现金、证券、基金等分组，并标出每个项目将被创建、合并或更新。请逐项检查预览结果，确认无误后再继续。

6. 应用同步预览

确认同步预览无误后，点击「应用同步预览」。ONEW 会把预览中的变更写入当前 ONEW 账户。首次同步预览应用完成后，预览列表会收起，「应用同步预览」按钮会变为不可点击状态。

重要：不要在应用首次同步预览前直接保存「启用资产同步」。如果提前保存，ONEW 会提示「启用资产同步前，请先应用首次同步预览。」

应用预览后，再打开「启用资产同步」，点击「保存绑定」。保存后，这个 ONEW 账户会保留长桥连接、同步脚本和自动合并设置，后续刷新时会继续使用长桥只读数据更新资产。

应用成功后：

• 当前 ONEW 账户会出现从长桥同步来的资产。
• 「资产同步」状态会变为已绑定或已开启。
• 后续刷新时，ONEW 会根据绑定关系继续使用长桥只读数据更新资产。

常见问题

为什么要先看同步预览？

同步预览可以让你在写入 ONEW 前检查长桥返回的数据，以及 ONEW 准备创建、合并或更新哪些资产。这样可以避免把不符合预期的数据直接写入账户。

可以把一个长桥账户绑定到多个 ONEW 账户吗？

建议一个长桥账户只绑定到一个承接证券资产的 ONEW 账户，避免同一批资产被重复统计。

授权后 ONEW 会修改长桥账户吗？

不会。长桥连接用于 ONEW 的只读资产同步，教程中的授权页面也会提示 ONEW 请求访问账户相关信息。