提供基于Fava/Beancount的投资组合管理，支持税务亏损收割优化、资产配置分析与等价证券分组识别，协助用户制定最优卖出策略。
Fava 账本查看 (fava-beancount-viewer)
功能概述
Fava 账本查看 (fava-beancount-viewer)是一项面向实际任务的技能，主要用于提供基于Fava/Beancount的投资组合管理能力，支持税务亏损收割优化、资产配置分析与等价证券分组识别，辅助用户制定最优卖出策略；Pipeline；
核心要点
- data_collection -> data_storage -> factor_computation -> target_selection -> trad。
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
- 从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
使用与执行
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；
结果检查与注意事项
涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。
Fava 账本查看（fava-beancount-viewer）
提供基于 Fava/Beancount 的投资组合管理能力，支持税务亏损收割优化、资产配置分析与等价证券分组识别，辅助用户制定最优卖出策略。
Pipeline
data_collection -> data_storage -> factor_computation -> target_selection -> trading_execution -> visualization
主要使用场景（共 5 个）
投资组合管理 CLI 入口点（UC-101）
为投资组合管理操作提供统一的命令行接口，涵盖税务亏损收割、资产配置分析、现金拖累检测等功能。
触发条件: portfolio management, CLI, command line税务优化型卖出策略（UC-103）
通过分析多笔持仓的成本基础（cost basis）与持有周期（holding periods），确定可最小化已实现资本利得（realized capital gains）的证券卖出顺序。
触发条件: minimize gains, tax-efficient selling, capital gains optimization税务亏损收割机会识别（UC-105）
识别具有未实现亏损（unrealized losses）的证券，以便执行税务亏损收割；通常回溯 30 天以发现符合“洗售规则”（wash sale）豁免条件的头寸。
触发条件: tax loss harvesting, loss identification, 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）？
语义锁（致命级）
| ID | 规则 | 违规处理 |
|---|---|---|
SL-01 |
每个交易周期内必须先执行卖单，再执行买单 | halt |
SL-02 |
交易信号必须采用下一根 K 线执行（禁止前视） | halt |
SL-03 |
实体 ID 必须遵循格式 entity_type_exchange_code | halt |
SL-04 |
DataFrame 索引必须为 MultiIndex（entity_id, timestamp） | halt |
SL-05 |
TradingSignal 必须且仅能包含以下字段之一：position_pct、order_money、order_amount | halt |
SL-06 |
filter_result 列语义定义：True = BUY，False = SELL，None/NaN = NO ACTION | halt |
SL-07 |
因子 Pipeline 中，Transformer 必须在 Accumulator 之前运行 | halt |
SL-08 |
MACD 参数锁定为：fast=12，slow=26，signal=9 | halt |
完整锁定义详见：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）进行复核。
参考文件
| 文件 | 内容 | 加载时机 |
|---|---|---|
| references/seed.yaml | V6+ 全量权威数据（source-of-truth） | 出现行为/决策争议时必读 |
| references/ANTI_PATTERNS.md | 15 条跨项目反模式 | 开始实现前 |
| references/WISDOM.md | 跨项目精华经验借鉴 | 架构决策时 |
| references/CONSTRAINTS.md | 领域约束 + 致命约束 | 规则冲突时 |
| references/USE_CASES.md | 全部 KUC-* 业务场景 | 需要完整示例时 |
| references/LOCKS.md | SL-* 锁定义 + 前置条件 + 提示 | 生成回测/交易代码前 |
| references/COMPONENTS.md | AST 组件地图（按 module 拆分） | 查询 API 时 |
由 Doramagic crystal-compilation-v6.1 于 2026-04-22T13:00:29.702985+00:00 从蓝图 finance-bp-078 编译生成。
详见 human_summary.md 获取非技术性概览。
热门AI工具
相关专题
本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。
0
2026.10.22
本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。
0
2026.10.22
本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。
0
2026.10.22
本专题介绍Gradle Java项目构建方法，涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查，帮助你理解各阶段的任务关系，逐步完成项目构建。
0
2026.10.22
本专题汇总PHP常见时间戳漏洞，包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等，并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案，帮助开发者快速排查和加固时间相关代码。
0
2026.10.22
本专题聚焦Golangci-lint YAML配置文件，讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置，便于团队统一检查标准。
0
2026.10.22
本专题讲解Golangci-lint的安装、初始化、基础命令和首次代码检查，覆盖本地环境、Docker及多平台用法，帮助Go开发者快速上手。
0
2026.10.22
PHP2Shell漏洞是什么，哪些PHP版本和运行环境会受到影响，服务器应该如何检测与修复？本专题提供版本自查脚本、Linux与Docker升级命令、PHP-FPM和Apache排查步骤，以及修复验证、临时缓解和应急响应方案。
0
2026.10.22
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.5万人学习
共6课时 | 54.7万人学习
最新文章
