资产时光机 / Asset Time Machine

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

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

产品定位

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

它的核心是：

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

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

平台策略

• 同一仓库维护 iPhone、原生 macOS 日常版与 Mac Catalyst 完整版。原生版复用 SwiftData 模型、资产计算、登录与云同步客户端；完整回测按需从原生版的「量化」页打开 Catalyst 版
• Mac 使用独立 Bundle ID com.flyingrtx.AssetTimeMachine.mac，本地数据与 iPhone 分开保存，可通过现有云同步或 JSON 导入导出迁移
• Mac 首页采用侧边栏、资产汇总、走势图、资产构成、财务自由进度与最近记录；其余入口接入现有功能
• Mac 首次打开可通过 Apple 或已有账号密码登录，也可选择仅在本机使用；Apple 首次登录会自动创建云端账号，本机模式仍可稍后从「设置 → 云同步」登录
• 原生 Mac 默认窗口为 1050 × 700，最小 820 × 560；Catalyst 完整版的默认窗口为 920 × 640
• 当前 Mac 为本地开发版本，尚未进行 Mac App Store 发布验证

运行 Mac 开发版

日常浏览推荐打开根目录的 AssetTimeMachine.xcworkspace，选择 AssetTimeMachineNativeMac scheme；也可执行 scripts/run_native_mac.sh 构建并启动原生 Release 应用。脚本会复用当前开发签名和 Mac 应用权限；如果缺少描述文件，只能构建不具备真实账户数据访问及 Apple 登录的预览版。原生版首次接管旧数据库前会备份并核对路径、记录数和金额，失败时停止启动和同步。完整策略回测仍由同仓库的 Catalyst 版按需运行。

需要 Catalyst 完整版时，在仓库根目录执行 scripts/run_mac.sh，或在 Xcode 的 AssetTimeMachine scheme 中选择 My Mac (Mac Catalyst)。本机有 Apple Development 证书时，脚本会使用开发签名并输出 build/AssetTimeMachine-Mac-Signed.app；没有证书时会使用仅供本地预览的临时签名，此时 Apple 登录和云同步不可用。可设置 MAC_SIGNING=adhoc 强制使用预览签名。脚本不会上传应用。

两个脚本均构建优化过的 Release 版本。Mac 时光机按需汇总本机历史，只创建可见日期，并把曲线限制在保留峰谷的 600 个点以内。内存验收使用 vmmap -summary <PID> 的 Physical footprint，测试数据和测量记录见 evidence/performance/mac-low-memory-2026-09-29.md。

构建脚本使用固定 App 路径：原生版为 build/AssetTimeMachine-Native.app，完整版为 build/AssetTimeMachine-Mac-Signed.app；更新前验证签名，各保留一个 -Previous.app 回退版本。设置 MAC_BUILD_ONLY=1 可只构建、不启动。脚本会清理确认停用的旧构建，跳过运行中的应用和构建任务；资产数据库、同步备份、研究证据、正式发布归档均保留。可用 python3 scripts/mac_build_artifacts.py clean 预览清单，加 --apply 执行清理。

仅验证编译时使用 bash scripts/validate_xcode_build.sh ios（或 native / catalyst）。验证使用一次性目录，成功、失败或中断后都会清理构建产物，只保留一份固定名称的验证日志。

要验证同一账号的跨端同步：

1. 在 Apple Developer 的 Identifiers 中注册 Mac App ID com.flyingrtx.AssetTimeMachine.mac，启用 Sign in with Apple，并将它分组到 iPhone App ID com.flyingrtx.AssetTimeMachine（作为 primary）。同时为 Mac App ID 配置 App Groups 中的 group.com.flyingrtx.AssetTimeMachine。
2. 在本机 Xcode → Settings → Accounts 登录该开发团队，给项目的 Mac Catalyst 主应用和小组件启用自动签名，取得开发证书及描述文件。用 Xcode 或 scripts/run_mac.sh 启动带开发团队签名的 Mac 版本，核对生成应用包含 Apple 登录权限。
3. 服务端部署包含 Mac App ID Apple token audience 的版本。手机先在「设置 → 云同步」确认最近备份；Mac 再用同一个 Apple 账号登录，确认显示同一个服务端用户和备份记录后验证双向同步。

正式分发仍需单独验证发布签名与能力配置。

Mac 快捷键：⌘1 至 ⌘5 切换主要页面，⌘N 在首页进入今日记录。

设计和验证材料见 evidence/ui-concepts/mac-home/。

核心功能

1. 每日资产记录

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

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

默认行为：

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

2. 资产走势分析

围绕总财富做长期观察：

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

3. 资产构成分析

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

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

4. 时光机视图

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

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

5. 额外价值锚点分析

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

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

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

6. 数据导入导出

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

7. 量化策略回测

App 与服务器使用 Sources/AssetTimeMachineBacktestCore 中同一份策略、成交结算和指标实现。App 的 BacktestEngine 保留旧调用入口；研究工具使用 AssetTimeMachineResearchSupport，通过显式不可变配置运行。

• 共享计算：Sources/AssetTimeMachineBacktestCore/{Domain,MarketData,Strategies,Execution,Metrics}
• 策略注册与版本：Sources/AssetTimeMachineBacktestCore/API/BacktestRun.swift
• 产品显示顺序：AdvancedBacktestStrategyTemplate.productCatalog；研究目录：.all
• 当前 settlement-v4 公开执行成本：手续费 0.025%、滑点 0.05%；历史冻结 1% 工件保持
• 低噪及 NFCI 内部决策成本：冻结 1.00% / 0.05%，与最终成交成本分开
• 夏普：按日收益计算，无风险利率为 0

架构、配置、历史命令兼容和证据格式见 共享架构说明。

swift test -c release
swift run -c release AssetTimeMachineResearch catalog
swift run -c release AssetTimeMachineMetricDump --engine-version

旧冻结基线仅能用它记录的源版本及成本核对。迁移前的基准和历史研究工件不会被当前引擎重写。

历史精选策略固定基准（2026-08-10 刷新，行情有效至 2026-08-07；交易费 1%、滑点 0.05%）：

精选策略	全历史年化	全历史最大回撤	最近10年年化	最近10年最大回撤	全历史 Sharpe
低噪增强（当前推荐）	14.44%	7.93%	13.42%	7.58%	1.508
进取配置	10.55%	14.09%	6.71%	12.66%	1.020
均衡配置	9.63%	13.02%	5.68%	13.02%	1.010
金纳双趋势	10.20%	16.93%	13.94%	16.93%	0.904
防守配置	8.58%	11.67%	5.55%	11.67%	0.992

上表是冻结 fixture 的历史回归基线，不是当前线上策略成绩，也不能直接用于产品推荐或发布文案。当前线上复跑必须使用生产 API、当前 Swift 引擎和当前成本，并单独记录抓取时间、逐序列末日、输入 SHA-256、代码 HEAD 与结果窗口；禁止以旧 fixture 的漂亮数字覆盖线上复跑。

低噪增强的完整生产逻辑、执行时序、参数、回测切片与风险边界见 docs/strategies/low-noise-enhanced.md。它在最终产品层严格限制总风险资产仓位不超过 100%，不允许融资或负现金。

当前后端序列按价格变化计算，回测引擎不会额外注入股票股息再投资；若未来接入总回报指数，需要建立新的独立基线，不能与当前数字直接混用。

新策略研究只能新增 Swift StrategyTargetProvider/Swift CLI 搜索入口，并必须通过同一个 BacktestDailySimulator 与 pinned fixture baseline 验证后，才能更新 README 或 App 可见指标。

新的研究工作材料统一放在位于相邻 FlyingrtxFast 仓库的 research/asset-time-machine/workspace/ 目录：策略家族与非正式测试在 strategies/，因子工作在 factors/，研究简报在 studies/，通用研究工具在 tools/。正式 ATM-SVP 的 preregistration、数据清单、结果和 Git 提交仍必须保留在本仓库的 tools/research-results/strategy-validation/，以维持可复现和审计边界。

冻结研究、当前线上复跑与点时宏观数据

• 冻结 fixture / 正式历史工件回答“该历史实验当时在那份输入与代码下产生了什么”；它们不可重写，但不自动等于当前 App 成绩。
• 当前线上复跑回答“当前 App 引擎在生产行情库的当前可用输入下如何表现”。它是 POST_HOC_CURRENT_REPLAY，不消耗或替代正式验证预算，也不单独构成策略准入证据。
• 线上复跑使用 https://api.flyingrtx.com/api/v1/money/public/history，默认不得带 refresh=true，除非用户明确授权服务器刷新。美元资产必须同时请求 usd_per_cny，并记录每条序列实际末日，不能只看请求结束日期。
• 涉及 NFCI 的策略必须从 https://api.flyingrtx.com/api/v1/money/public/nfci-asof 取得含 release_date、reference_date、available_at 的首次可见/as-of 记录；不得用当前修订版 FRED/ALFRED 序列或观察期日期替代可用时间。
• 任何线上复跑都须保存原始响应及归一化输入的 SHA-256、接口/环境、抓取时间、代码 HEAD、引擎与成本配置、覆盖末日和全部报告窗口。若与旧工件不同，只能报告差异，不得回头调参“救回”旧结果。
• V11 的旧冻结结果（14.35% CAGR / 7.69% MDD / 1.52 Sharpe）仅为历史 ATM-SVP 工件，且仍有 G3 PARTIAL、G4 INVALID_SOURCE_UNAVAILABLE、G6 RUNNING 等限制。2026-09-04 的服务器当前回放为全史 6.03% CAGR / 15.86% MDD / 0.686 Sharpe；详见研究归档 ../FlyingrtxFast/research/asset-time-machine/workspace/studies/v11-online-replay-2026-09-04/ONLINE_REPLAY.md。V11 不是当前推荐、准入或对外宣传基线。

资产分类设计

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

一级分类

1. 金融资产

例如：

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

2. 实物资产

例如：

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

3. 负债

例如：

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

二级项目

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

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

数据录入设计

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

1. 直接金额

适合：

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

2. 数量 × 单价

适合：

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

设计原则

1. 本地优先

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

2. 先总量，后解释

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

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

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

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

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

技术方案

• SwiftUI + SwiftData
• Apple Charts 走势图
• Xcode iOS 工程，TestFlight 分发

当前进度

项目已进入 持续迭代 / TestFlight 发布阶段，当前 TestFlight 版本为 1.13。

已完成并在线上运行的功能：

• 每日资产快照记录，默认继承前一天数据，自动汇总总资产 / 总负债 / 净资产
• 仪表盘走势图与统计卡片，历史高低点、最大回撤、阶段涨跌
• 时光机视图：查看任意一天的财富状态与构成，并与今天 / 历史高点对比
• 资产构成分析（大类占比、细项占比）
• 价值锚点分析：黄金 / BTC / 纳指 / 房价等值
• 本地 JSON 导入导出，走势视频导出
• 云同步（AssetTimeMachine cloud，经 Flyingrtx 后端）
• 行情数据接入 https://api.flyingrtx.com，含本地缓存
• 量化策略回测模块：内置高级策略模板、单资产 / 多资产 / 轮动策略、回测历史记录与调仓提醒
• 多语言（简中、繁中、英文字符串目录）、通知服务、聚焦资产记录的新手引导

当前迭代重心：

• 回测引擎重构与指标基线固化（golden metrics 固定 fixture 校验）
• 策略模板持续筛选与调优（以 App 引擎实测为准）
• App Store / TestFlight 发布节奏维护

项目信息

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

---

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