Fava 账本查看（fava-beancount-viewer）

提供基于 Fava/Beancount 的投资组合管理能力，支持税务亏损收割优化、资产配置分析与等价证券分组识别，辅助用户制定最优卖出策略。

Pipeline

data_collection -> data_storage -> factor_computation -> target_selection -> trading_execution -> visualization

主要使用场景（共 5 个）

投资组合管理 CLI 入口点（UC-101）

为投资组合管理操作提供统一的命令行接口，涵盖税务亏损收割、资产配置分析、现金拖累检测等功能。

税务优化型卖出策略（UC-103）

通过分析多笔持仓的成本基础（cost basis）与持有周期（holding periods），确定可最小化已实现资本利得（realized capital gains）的证券卖出顺序。

税务亏损收割机会识别（UC-105）

识别具有未实现亏损（unrealized losses）的证券，以便执行税务亏损收割；通常回溯 30 天以发现符合“洗售规则”（wash sale）豁免条件的头寸。

全部 5 个使用场景详见：references/USE_CASES.md。

执行触发条件: 当用户意图匹配 intent_router.uc_entries[].positive_terms 且用户使用动作动词（run/execute/跑/执行/backtest/fetch/collect）时

我将向您询问的问题

• 目标市场：A 股（默认）、港股或加密货币？（ZVT 中的美股支持尚不完善 — stockus_nasdaq_AAPL 存在但覆盖稀疏）
• 数据源 / 提供方：eastmoney（免费，无需账号）、joinquant（需注册+付费）、baostock（免费，历史数据质量好）、akshare 或 qmt（券商接口）？
• 策略类型：MACD 金叉、均线交叉、成交量突破、基本面筛选，还是自定义因子？
• 时间范围：回测起止时间戳（start_timestamp 和 end_timestamp）
• 目标实体 ID：具体个股（如 stock_sh_600000）或指数成分股（如 SZ1000）？

语义锁（致命级）

完整锁定义详见：references/LOCKS.md

高频反模式（共 15 个）

• AP-ACCOUNTING-001: 对货币金额使用浮点数运算
• AP-ACCOUNTING-002: 在 VM/脚本执行前跳过初始化调用
• AP-ACCOUNTING-003: 在货币类运算中混用不同资产类型

全部 15 条反模式详见：references/ANTI_PATTERNS.md

证据质量说明

[QUALITY NOTICE] 本 crystal 基于蓝图 finance-bp-078 编译。证据验证率 = 21.6%，审计失败总数 = 14。生成结果可能存在未捕获的需求缺口，请对关键决策比对源文件（LATEST.yaml / LATEST.jsonl）进行复核。

参考文件

由 Doramagic crystal-compilation-v6.1 于 2026-04-22T13:00:29.702985+00:00 从蓝图 finance-bp-078 编译生成。 详见 human_summary.md 获取非技术性概览。