故障排除

本页按常见症状整理排查步骤。处理数据问题前，建议先到 设置 → 数据备份 创建一份当前账套备份。

排查顺序建议：

1
2
3
4
5

确认账套
  -> 确认刚做过什么操作
  -> 查看页面提示
  -> 核对导入预览或基础数据
  -> 再决定是否修改交易、持仓或数据源

不要在没有定位原因前反复删除、重导或直接改数据库文件。

进入系统后发现数据不见了

优先检查是否切换到了其他账套。

1. 打开右上角用户菜单，查看当前账套名称。
2. 如需切换账套，退出到登录页重新选择。
3. 进入 设置 → 数据备份，确认备份列表是否属于您预期的账套。

如果当前账套正确，但数据仍异常，再回想是否刚执行过还原、导入、手工删除、账套切换或初始化操作。

如果不确定，先不要继续导入或删除数据，先创建备份。

忘记账套密码

账套密码只保存在本地，无法通过授权账户找回。

建议处理方式：

1. 先确认是否选错账套。不同账套可以有不同密码。
2. 如果有近期备份，可考虑在另一个可进入的账套中检查数据是否完整。
3. 如果确实忘记密码，需要通过本地数据维护方式处理；操作前请先备份整个 data 目录。

不要反复尝试不确定的密码或随意修改数据库文件，以免增加恢复难度。

备份还原后数据不是预期状态

还原只作用于当前账套。请先确认还原前选中的账套是否正确。

如果还原错了账套或选错备份：

1. 进入 设置 → 数据备份。
2. 查找 before-restore-*.backup 文件。
3. 选择还原前自动创建的备份进行回退。

如果还原时取消了 “还原前自动备份当前状态”，则只能依赖您之前手动创建或下载保存的备份。

上传备份失败

请检查文件是否符合要求：

• 文件名必须以 backup_ 开头。
• 文件后缀必须是 .zip。
• 文件大小不能超过 5 MB。
• 只能上传到当前账套的备份列表。
• 上传后不会自动还原，需要再手动选择 “还原”。

如果文件来自其他位置，建议先确认它确实是 WealthSight 导出的备份文件。

券商文件无法生成预览

先不要确认导入。预览无法生成时，通常是文件格式、规则或字段识别问题。

排查顺序：

1. 确认您打开的是 交易管理 → 券商文件导入，不是标准 导入/导出交易。
2. 确认文件是成交记录、交易记录、交割单或对账单，而不是截图或 PDF 月结单。
3. 如果有推荐规则或已保存规则，先用 检查文件 或直接生成预览验证。
4. 如果规则不匹配，切换到 首次适配新文件。
5. 在关键字段核对中检查日期、代码、交易类型、数量、金额、费用和币种。
6. 如果预览为空，检查文件是否只有汇总行、说明行、筛选后的空数据，或选择错了工作表。

如果仍无法预览，反馈时请提供券商名称、文件类型、导出入口、卡住步骤和错误截图。不要在公开场合上传原始交易文件。

预览能生成，但交易结果看起来不对

先在预览阶段处理，不要急着确认导入。

重点检查：

• 交易日期是否错列。
• 买入、卖出、分红、入金、出金、费用、现金利息是否识别正确。
• 数量和金额是否有正负号问题。
• 成交金额、净结算金额、费用是否被重复计算或漏算。
• 币种是否正确。
• 平台名称是否和现有持仓一致。
• 唯一识别号是否会导致重复导入或无法更新旧记录。

如果是首次适配，优先修正规则草稿，再重新生成预览。预览确认无明显异常后再正式导入。

导入时提示缺失标的

这是正常情况，不一定是错误。

处理步骤：

1. 按提示进入批量新增标的。
2. 查看每个标的的匹配状态。
3. 如果匹配到报价和历史数据源，确认候选是否正确。
4. 如果只匹配到标的信息，也可以先添加。
5. 如果候选冲突或信息明显不对，先取消该标的或手工修正。
6. 创建标的后回到导入预览继续导入。

缺少报价或历史数据源不应该阻断交易创建。后续可在 标的管理 → 数据维护 → 数据源配置 中集中补充。

导入确认后没有看到持仓变化

先确认导入时是否勾选 “自动调整持仓”。

• 如果没有勾选，本次导入只写入交易，不会修改当前持仓。请点击 “查看交易” 核对记录。
• 如果勾选了，导入完成后应点击 “查看持仓”，检查持仓数量、平台、现金余额和价格状态。

如果已经勾选但持仓仍异常，检查：

• 交易类型是否正确。
• 数量、金额、币种是否正确。
• 买入前是否已有足够现金，卖出前是否已有足够持仓。
• 平台名称是否一致。
• 是否存在重复导入、异常记录或跳过记录。

之后可在 持仓管理 中运行 检查持仓异常，定位负持仓、当前持仓和交易回放结果的差异。

首页提示“已有交易，尚未形成持仓”

这通常表示账套里已经有交易记录，但当前没有可分析的非现金持仓。

常见原因：

• 导入交易时没有勾选自动调整持仓。
• 导入的交易全部是现金类流水。
• 已经清仓，当前没有非现金持仓。
• 当前账套中只有交易记录，还没有建立当前持仓。

建议先进入 交易管理 核对导入记录。如果您希望首页和持仓分析出现当前持仓，需要补齐或调整持仓数据。

持仓显示“缺价格”或市值为空

这通常表示标的没有最新价格。

排查顺序：

1. 在持仓页确认哪些标的显示 “缺价格”。
2. 如果同时显示 “缺数据源”，进入 标的管理 → 数据维护 → 数据源配置。
3. 先补报价数据源和报价识别码。
4. 保存后等待自动刷新最新价格。
5. 如果仍无价格，检查数据源是否覆盖该标的，或手工维护当前价格。

缺价格会影响当前市值、持仓分布和首页数据状态。它不一定影响交易记录本身。

价格、历史数据或标的匹配失败

这类问题通常与数据源、插件配置或数据覆盖范围有关。

排查顺序：

1. 在 标的管理 → 数据维护 → 数据源配置 中查看是否缺报价或历史数据源。
2. 检查报价插件、报价识别码、历史插件、历史识别码是否为空或明显错误。
3. 如果需要插件，先在 插件管理 确认插件已安装、已加载、配置项已填写。
4. 检查网络是否可访问对应数据源。
5. 如果是历史维护失败，尝试缩小历史维护区间，或换一个数据源。
6. 如果是单个标的无数据，确认该标的是否停牌、退市、代码变更，或数据源本身不覆盖。

部分数据源可能有频率限制、地域访问限制或服务波动。遇到偶发失败时，可以稍后重试。

官方渠道之外的社区插件可能覆盖更多市场，但需要自行确认来源可信度、使用权限和数据准确性。

数据源配置保存后价格仍未刷新

保存数据源配置后，系统会自动尝试刷新最新价格。如果没有成功：

1. 查看页面或通知中是否有刷新失败提示。
2. 确认报价插件和报价识别码是否正确。
3. 确认插件是否已配置必填字段。
4. 稍后重试，排除数据源临时波动。
5. 如果急需核对持仓，可先手工维护当前价格。

保存数据源和刷新价格是两件事。刷新失败不代表数据源配置一定没有保存。

历史数据维护一直处理中或没有结果

先确认相关标的是否已经配置历史数据源。

如果标的缺少历史数据源，历史维护无法获取历史价格。请先进入 数据源配置 补充历史插件和历史识别码。

如果已经配置，继续检查：

• 历史维护区间是否过长。
• 数据源是否有频率限制。
• 网络是否可访问数据源。
• 该标的历史数据是否本来就不完整。
• 插件是否返回错误或无数据。

首次补数可以手工执行；日常维护建议开启 自动数据维护。

持仓异常检查提示异常

一致性异常通常表示 当前持仓 和 交易记录回放结果 对不上。

常见原因：

• 初始持仓是手工录入的，但缺少对应的历史买入或入金记录。
• 买入、卖出、分红、入金、出金或现金利息漏记。
• 同一券商平台名称前后不一致。
• 现金持仓没有随交易同步调整。
• 已清仓标的仍有历史交易，这是允许的；只要回放后数量归零，就不应视为异常。

处理时不要急着改结果，先判断您希望以 当前持仓 为准，还是以 历史交易 为准，再补齐对应记录。

页面结果为空或图表看起来不完整

先确认当前账套中是否有足够数据。

常见原因：

• 还没有录入持仓或交易。
• 交易已导入，但没有自动调整持仓。
• 标的没有最新价格或历史价格。
• 当前筛选条件过窄。
• 分析日期范围内没有持仓。
• 现金持仓被过滤后，组合规模看起来偏小。
• 当前打开的是示例账套或其他账套。

建议先清空筛选条件，再从 首页、持仓管理、交易管理、投资标的管理 逐项确认基础数据。

回溯或归因结果异常

回溯和归因比当前持仓需要更多数据。

请按顺序检查：

1. 当前持仓是否已经核对过。
2. 交易记录是否覆盖分析区间。
3. 标的是否有历史价格。
4. 现金流水是否完整，包括入金、出金、分红、费用、现金利息。
5. 拆股、合股、送股、转增、份额折算是否维护了复权规则和数量调整交易。
6. 是否存在负持仓。

如果系统提示校验不通过，优先处理残差最大的日期和标的，不要随机修改多处数据。

插件上传或更新后没有生效

插件更新已安装文件时，可能需要重启应用才能替换正在使用的插件文件。

可以按以下顺序处理：

1. 确认安装的是 .zip 插件包或 .dll 插件文件。
2. 上传后查看页面提示，是否要求重启。
3. 重启应用后再进入 插件管理 检查版本和状态。
4. 如果插件仍无法加载，确认插件是否与当前 WealthSight 版本兼容。

只安装可信来源的插件。插件可以执行代码，风险不同于普通数据文件。

授权状态异常或高级功能不可用

先到 设置 → 激活授权 查看当前状态。

常见情况：

• 未登录授权账户。
• 已登录但未正式激活。
• 试用期已结束。
• 网络暂时不可用，导致远程状态刷新失败。

注意：试用期用户仍按未激活用户处理，账套数量最多 2 个；正式激活或 EarlyAdopter 不受此限制。

需要反馈问题时，应该提供什么信息？

为了更快定位问题，请尽量提供：

• 正在操作的页面和按钮。
• 出现的完整错误提示。
• 当前账套名称。
• 系统环境：Windows 或 macOS，以及 WealthSight 版本。
• 是否刚做过导入、还原、插件更新、账套切换或数据源配置。
• 问题是否可重复出现。

如果涉及券商文件，建议提供：

• 券商名称。
• 文件类型。
• 导出入口。
• 卡住步骤：选文件、检查、适配、预览、确认导入、导入后核对。
• 错误截图或脱敏后的字段截图。

不要在公开场合上传原始交易文件、账户名、交易明细、资产金额或完整截图。确需提供样例文件时，请先脱敏，并确认提交范围。

相关文档

• 常见问题（FAQ）
• 数据备份
• 券商文件导入