资产时光机 / Asset Time Machine

一个面向个人的 iPhone 本地资产记录与走势分析应用。

核心目标不是做复杂记账，而是按天记录自己的总财富状态，长期观察总资产、净资产和资产构成如何变化。

产品定位

资产时光机是一款 本地优先（local-first） 的个人财富记录工具。

它的核心是：

• 每天记录自己的总资产状态
• 默认继承前一天数据，只改变化项
• 自动计算总资产、总负债、净资产
• 观察财富随时间的走势与结构变化

黄金等值、BTC 等值、纳指等值、房价等值等，属于 额外分析视角，不是产品主功能。

平台策略

• 当前仅维护 iOS / iPhone 版本
• SwiftUI + SwiftData 单端 iOS 工程
• 优先优化 iPhone 的录入、查看、分析、导入导出体验
• 暂不维护 macOS 目标

核心功能

1. 每日资产记录

按天记录个人资产快照，自动汇总：

• 总资产
• 总负债
• 净资产

默认行为：

• 第一天手动录入
• 后续日期默认继承前一天数据
• 用户只修改当天发生变化的项目
• 若某天未更新，则资产状态默认保持不变

2. 资产走势分析

围绕总财富做长期观察：

• 今日总资产 / 净资产
• 较昨日、上周、上月变化
• 历史走势曲线
• 历史高点 / 低点
• 最大回撤
• 阶段涨跌幅

3. 资产构成分析

查看自己的财富结构如何变化：

• 金融资产占比
• 实物资产占比
• 负债占比
• 各资产小类占比

4. 时光机视图

查看任意一天的财富状态：

• 当天总资产 / 净资产
• 当天资产构成
• 与今天对比
• 与历史高点对比
• 历史关键变化回顾

5. 额外价值锚点分析

在核心资产记录之外，提供附加分析视角：

• 黄金等值
• BTC 等值
• 纳指等值
• 房价等值

这些功能用于帮助理解财富变化，不替代总资产主视图。

6. 数据导入导出

• 本地 JSON 导出
• 本地 JSON 导入
• 便于备份、迁移、后续同步扩展

7. 量化策略回测

App 内策略指标必须以当前 Swift BacktestEngine 的实际运行为准，不能直接使用 research/spike 脚本结果作为产品展示或对外结论。

当前准口径：

• 回测引擎：AssetTimeMachine/Backtest/BacktestEngine.swift
• 策略模板：AssetTimeMachine/Backtest/BacktestModels.swift 中的 AdvancedBacktestStrategyTemplate.all
• 行情数据：https://api.flyingrtx.com/api/v1/money/public/history
• 回测区间：全历史，按各策略可用数据起点自动决定
• 初始资金：100,000 CNY
• 手续费：1%
• 滑点：0.05%

实际验证命令：

cd ~/Desktop/AllProjects/AssetTimeMachine

xcrun swiftc \
  -parse-as-library \
  -module-cache-path /private/tmp/atm-swift-module-cache \
  AssetTimeMachine/Backtest/BacktestModels.swift \
  AssetTimeMachine/Backtest/BacktestEngine.swift \
  tools/strategy_metric_dump.swift \
  -o /private/tmp/strategy_metric_dump

/private/tmp/strategy_metric_dump

最近一次 App 引擎实测结果（2026-06-26，当前线上历史数据）：

策略	年化	最大回撤	夏普
权益曲线状态机	11.00%	10.24%	1.10
单向控波元策略	10.61%	11.23%	1.04
动态袖套夏普策略	10.05%	11.65%	1.03
增强热度上限元	9.65%	12.04%	0.93
热度上限元策略	9.44%	12.04%	0.93
黄金交接保护	9.39%	11.38%	0.92
月度热度上限元	8.82%	16.57%	0.85
全球修复传染控制	3.45%	23.43%	0.43
双金丝雀动量防守	1.86%	31.89%	0.28
美元现金修复策略	1.24%	24.44%	0.20
黄金恐慌锁盈策略	1.14%	25.29%	0.19
风险效率增强策略	1.01%	25.76%	0.17
MA金叉死叉	0.75%	43.40%	0.12
BOLL下轨反弹	-5.89%	80.30%	-0.76
MA60趋势	-6.41%	87.05%	-0.46
MA20趋势	-18.78%	99.60%	-1.48

如果新策略来自 spikes/ 或 Python 搜索脚本，必须先通过上面的 Swift App 引擎验证，再更新 README 或 App 可见指标。

资产分类设计

一级分类固定，二级项目由用户自定义。

一级分类

1. 金融资产

例如：

• 现金
• 银行存款
• 股票
• 基金
• 数字货币
• 理财
• 黄金
• 外币资产

2. 实物资产

例如：

• 房产
• 车产
• 手机
• 电脑
• 收藏品
• 其他大件资产

3. 负债

例如：

• 花呗
• 白条
• 美团月付
• 信用卡欠款
• 房贷
• 车贷
• 消费贷
• 其他借款

二级项目

用户可以自由增加自己的细项，例如：

• 招行活期
• 建行定存
• 微信零钱
• 币安 BTC
• 家庭房产
• 房贷 A

数据录入设计

每个资产项目支持两种计价方式：

1. 直接金额

适合：

• 现金
• 银行存款
• 理财市值
• 房产估值
• 各类负债

2. 数量 × 单价

适合：

• 黄金
• BTC
• 外币
• 某些股票/基金
• 房产面积 × 单价（后续可扩展）

设计原则

1. 本地优先

所有核心数据默认保存在本地，优先保证隐私与可控性。

2. 先总量，后解释

先解决“我一共有多少资产、怎么变了”，再解决“用什么尺度理解这些变化”。

3. 尽量减少用户重复录入

默认继承前一天数据，让记录动作更像“确认今天的财富状态”，而不是每天重填一张表。

4. 固定大类，可配置小类

保证分析维度稳定，同时保留用户个性化资产结构。

技术方案

当前技术栈

• SwiftUI
• SwiftData
• Xcode iOS 工程

计划引入

• Apple Charts，用于走势图
• JSON 导入导出
• 更细的共享层与平台适配层拆分

当前开发阶段

当前项目处于 初始化阶段：

• 创建 Xcode 工程
• 确定中文产品名：资产时光机
• 确定英文项目名：Asset Time Machine
• 确定当前路线：iOS-only，暂不维护 macOS
• 设计 SwiftData 数据模型
• 移除默认模板代码
• 搭建首页 / 记录页 / 时光机页基础骨架
• 实现资产分类与可配置项目
• 实现每日继承前一日逻辑
• 实现走势图与统计卡片
• 实现价值锚点附加分析

近期路线图

Phase 1: 跑通基础资产记录

• 资产分类模型
• 自定义资产项
• 每日快照
• 默认继承前一天
• 总资产 / 净资产计算

Phase 2: 跑通时光机与趋势

• 历史曲线
• 历史快照查看
• 资产构成变化
• 阶段涨跌和高低点

Phase 3: 跑通附加分析

• 黄金等值
• BTC 等值
• 纳指等值
• 房价等值
• 数据导出导入

项目信息

• 中文名：资产时光机
• 英文名：Asset Time Machine
• Xcode Project：AssetTimeMachine
• Bundle ID：com.flyingrtx.AssetTimeMachine

---

如果后续产品定义更新，请优先同步本 README，避免文档和实现方向再次跑偏。