核心概念

WealthSight 是一个面向个人投资者的本地投资档案工具。它通过聚合跨平台资产、深度归因和模拟复盘，帮助您看清每一笔盈亏的真实来源。要有效使用 WealthSight，您需要理解以下核心概念。

1. 投资标的（Security）

投资标的是您投资的具体对象，如股票、基金、债券、货币、加密货币等。每个标的在系统中由唯一的标的编码标识。

标的编码：各市场官方交易代码（A股6位数字，港股5位数字，美股字母代码）。
标的名称：标的的正式名称。
标的别名：用于将同一实质资产的不同代码合并统计，例如港股“阿里巴巴-W”与美股“BABA”可统一别名为“阿里巴巴”。
币种代码：标的的计价货币（如 CNY、HKD、USD）。

2. 数据源与插件

系统通过插件化的方式从外部获取价格和历史数据，每个标的可独立配置数据源。

报价插件：负责获取标的实时价格的模块。
报价识别码：插件内部用于定位该标的的代码（可能与标的编码不同）。
历史数据插件：负责获取标的完整历史价格序列的模块。
历史识别码：插件内部用于请求历史数据的代码。
标的信息：用于识别标的编码、名称和币种，不等同于报价或历史价格数据。
匹配状态：
- 完全匹配：同时成功匹配报价和历史插件，可获取完整数据。
- 仅标的信息：可先创建标的，后续再补充数据源。
- 仅匹配报价：只能获取实时价格，无法进行历史分析。
- 待选择：同一编码匹配到多个候选，需要人工确认。
- 无法匹配：无法通过任何插件获取价格信息。

3. 交易与持仓

交易（Trade）

交易记录是构建持仓和计算收益的基础。系统支持多种交易类型：

买入/卖出：影响标的持仓和现金余额。
入金/出金：仅影响现金持仓，不计入收益。
分红派息：分红派息增加现金持仓，标的数量不变。
现金利息：记录现金利息收入或融资、贷款、透支利息支出，会影响现金持仓并计入收益。
数量调整：用于记录拆股、送股、转增、合股等零金额数量调整；正数增加持仓，负数减少持仓。

持仓调整：系统根据交易自动计算并更新持仓数量，免去手动维护的繁琐。

持仓（Holding）

指您当前持有的标的数量及相关信息。

持有数量：当前持有量。
最新市值 = 数量 × 最新价格 × 最新汇率（转换为本位币）。
交易平台：区分同一标的在不同券商或平台的持仓。

4. 货币与汇率

本位币（Base Currency）：系统用于统一核算所有资产的基准货币。所有外币资产都会按汇率转换为本位币计价。
汇率参考标的编码：指定一个投资标的，其最新价格即作为该货币相对于本位币的汇率（例如 HKDCNH 的价格即为 1 港元兑离岸人民币的汇率）。非本位币必须配置有效的参考标的，否则无法获取汇率数据。

5. 维度管理

维度是您自定义的分类标签（最多10个），用于从不同角度分析持仓结构。例如：

品类：股票、债券、黄金、REIT、加密货币、大宗商品、现金等
特性：进攻、均衡、防守
行业：科技、消费、医疗、金融等
交易市场：A股、港股、美股等
地域：中国内地、香港本地、美国、全球等

每个维度可设置具体的维度值，在标的管理中为标的分配对应的标签，系统即可按维度分组统计持仓分布。

6. 安全资产规则

通过规则定义哪些标的属于安全资产（如现金、债券）。规则由“交易平台 + 维度 + 维度值”组合而成，规则之间是“或”关系，满足任意一条即视为安全资产。系统据此计算风险仓位占比，帮助您监控组合的整体风险水平。

7. 资产管理

资产管理整合了您的投资类资产（系统自动汇总）和手工记录的其他资产/负债，提供完整的财务状况。

总资产 = 手动非投资类资产 + 投资类资产总市值
总负债 = 所有手动录入的负债项总和
净资产 = 总资产 – 总负债

资产事件：记录影响财务状况但与投资无关的外部事件（如借款还款等），仅作为备忘，不参与自动计算。

8. 投资分析核心概念

盈亏分解（归因分析）

系统将总盈亏精确拆解为四个独立来源，并确保它们之和等于总盈亏：

价格波动盈亏：由市场价格变动引起。
收入影响：持有期间获得的现金分红，以及平台现金利息收入或利息支出。
交易执行影响：实际成交价与当日收盘价的差异带来的损益，反映交易时机优劣。
汇率波动影响：外币资产因汇率变动产生的损益。

对于拆股、送股、转增、合股等数量口径变化，归因分析会优先使用前复权分析口径；对应的数量变化需要通过 数量调整（AdjustQuantity） 交易补齐，才能保证结果闭合且语义正确。

原始价格与前复权价格

原始价格：保留市场当时的真实收盘价，适合和券商原始价格对账。
前复权价格：在原始价格基础上消除拆股、送股、转增、合股带来的价格跳空，更适合看长期趋势、交易执行分析和归因分析。

如果您发现某个标的历史价格在某天突然“腰斩”或“翻倍”，不一定代表真实涨跌异常，也可能是拆股或送股造成的口径变化。此时应先检查是否需要登记复权规则。

如果某个标的尚未登记复权规则，系统中的 前复权 与 原始价格 实际没有差异；这类场景下，界面中可能不会显示两者之间的切换。

风险与收益指标

波动率：日收益率的标准差，衡量波动程度。
最大回撤：从历史最高点到随后最低点的最大损失幅度。
夏普比率 / 索提诺比率 / 卡玛比率：风险调整后的收益指标，分别从总波动、下行波动和最大回撤角度衡量收益质量。

持仓分布与回溯

持仓分布：按维度、平台、标的别名等分组展示资产占比。
持仓回溯：基于交易记录重建任意历史日期的持仓快照，用于对比分析和归因。

持仓回溯和持仓分布强调的是“当时真实持有了多少”，因此仍使用原始事实快照口径；它与归因分析的前复权分析口径不同，属于刻意保留的两套视角。

复权规则与巡检

复权规则：用来登记拆股、送股、转增、合股等数量口径变化。
复权规则巡检：系统基于本地历史价格，自动找出需要复核的显著价格跳空，并给出参考因子，帮助您快速定位问题标的。跳空不一定代表需要复权，仍需结合公告、券商记录和持仓数量变化确认。

建议的处理顺序通常是：

先确保历史数据是新的。日常可依赖 “自动数据维护”，首次建档或需要立即补齐时再手工执行一次历史维护。
再执行复权规则巡检，找到需要复核的显著跳空。
确认属于拆股、送股、转增、合股等数量口径变化后，在标的详情中登记复权规则。
按平台补录或校验对应的**数量调整（AdjustQuantity）**交易。

模拟投资

支持固定权重、定投、网格三种策略的回测，可在相同市场环境下对比不同策略的表现。模拟结果包含每日持仓序列、交易记录和结构化日志。

9. 系统通用配置

金额单位：可自定义显示单位（如 W 代表万）及其基数。
小数位数：控制金额和百分比的显示精度。
无风险利率：用于计算夏普比率等风险调整指标。
历史数据起始日期：限制系统加载的历史数据范围，优化性能。
数值变化颜色方案：选择正负值的显示颜色（绿正红负 / 红正绿负）。

10. 账套与数据隔离

账套：一组独立的本地数据空间，适合用来区分个人资产、家庭成员、客户组合或不同投资实验。不同账套之间的投资标的、交易、持仓、资产事件、设置和账套密码彼此独立。
账套密码：可为当前账套设置本地密码。不同账套的密码彼此独立，备份还原不会改变当前账套密码。

登录页可以选择、创建和管理账套；切换账套需要回到登录页。
每个账套有独立的备份目录，备份和恢复只作用于当前账套。
激活授权属于全局信息，同一设备上的多个账套共享同一份授权状态。
删除账套会先移入“已删除账套”，可恢复；彻底删除后才会释放名称并移除目录。

以上概念构成了 WealthSight 的基础框架，理解它们将帮助您快速上手并深入利用系统的各项功能。如需更详细的说明，请参考各功能模块的专门文档。