用途:在 TRES Finance 中端到端管理成本基础计算,包括检查计算状态、查看与修改成本基础策略、触发重算、按资产查看结果、审查财务问题,以及修复缺失的法币价格。
使用方式:所有调用均经 user-tres-finance MCP 服务器;变量键与嵌套输入字段必须使用 camelCase(如 assetClassId,而非 asset_class_id)。标准流程为先调用 get_viewer 认证并确认组织,再检查是否已定义策略(策略是计算的先决门槛,未定义时需用户在 FIFO、LIFO、AVG、MAX_GAINS、MAX_LOSSES、FIFO_IMPAIRMENT 中选择),然后运行计算并轮询状态,每约 10 秒查询一次,直到 DONE 后再展示结果。
主要能力:查询计算状态(DONE、IN_PROGRESS、ITEM_NOT_FOUND);查看默认策略与按日期覆盖的策略期间;通过 updateCostBasisStrategyByDate 修改策略(注意该变更会替换全部期间,需先取现有期间);通过 triggerCostBasis 触发全量或指定 assetClassIds 的重算;用 assetBalance 查询(非 organizationBalance)查看每个资产-钱包对的总成本、已实现盈亏、短期/长期已实现盈亏、COGS、收入、运行库存等,并按 totalCount 分页;用 financialIssue 查询财务问题(severity 过滤值需小写,类型不在查询中过滤而在展示时分组,类型含 missing_fiat、negative_balance、result_was_rounded、ignored、no_opposite_tx、circular_internal_sbxs);用 getStatelessPricing 与 getBatchStatelessPricingByAssetClass 查历史价格,可用 apiSource 依次尝试 COINMARKETCAP、CRYPTO_COMPARE、REGULAR_FLOW、COINBASE、BINANCE、KRAKEN;用 bulkFiatEdit 在日期范围内覆盖单位价格(执行前需与用户确认)。
适用场景与限制:适用于加密资产成本基础核算、税务相关盈亏分析与缺失法币价格修复。资料未说明收费方式、价格或平台支持范围。执行写操作(改策略、改法币值)前必须用户确认;策略变更后需重算;计算完成前不应展示结果;部分冷门、已下架或 DeFi 封装代币在所有价格源均可能返回空,此时需用户提供手动价格。资料中 bulkFiatEdit 的输入字段止于 updateExistingFiat,后续参数暂未提供,HTML 仪表盘为资料中的建议做法而非强制。