18种TRES报表怎么选？report-advisor决策树完全指南
【免费下载链接】claude-plugins-communityCommunity plugin marketplace for Claude Cowork and Claude Code. Read-only mirror — submit plugins at clau.de/plugin-directory-submission.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-plugins-community
TRES报表让区块链会计人员常常无所适从：月末结账用哪个？审计要什么？报税看哪张？在 claude-plugins-community 社区插件市场里，TRES 官方插件内置的 tres-report-advisor 技能正是为解决这个痛点而生——你只需用大白话描述目标（"我要报税"、"审计师要资产变动证明"），它就会从 18 种报表中推荐最匹配的那一个，并告诉你该看哪些工作表和列。本文带你走读它的决策树，5 分钟选对报表。
一、report-advisor 是什么？
report-advisor 是 tres-finance-plugin 中的一个 AI 技能，定位非常聚焦：只回答"该用哪张报表"这类问题。
它的工作方式遵循三条原则（见 SKILL.md 的 "How to respond" 章节）：
- 理解目标，而非字面——"我需要余额"可能是当前快照、历史时点或趋势对比，它会先从上下文推断意图；
- 只推荐一张主报表——并指出应聚焦的具体 Excel 工作表（Tab）和列；
- 附带 API Type——例如
EXTENDED_RAW_TRANSACTIONS，方便你用 API 或自动化批量生成报表。
回答风格被刻意约束在 3~6 句话，避免长篇大论，适合日常快速查询。
二、决策树：先问自己 6 类问题
技能的灵魂是一张六分支决策树（源自 report-catalog.md 完整目录 + SKILL.md 快速表）。18 种报表被归入 6 大需求类别，你只要对号入座：
1️⃣ 我要交易明细（Transaction Reports，4种）
| 需求 | 推荐报表 | API Type |
|---|---|---|
| 基础交易列表（收发地址、数量、链） | Transaction Ledger | BASIC_RAW_TRANSACTIONS |
| 交易 + 成本基础 + 已实现盈亏 | Realized Gains & Losses | EXTENDED_RAW_TRANSACTIONS |
| 交易 + 每批次（lot）COGS 明细 | Cost Breakdown | COST_BREAKDOWN_RAW_TRANSACTIONS |
| 汇总条目的逐笔交易 | Rollup Breakdown | ROLLUP_BREAKDOWN |
一句话区分：越往右，数据越深。日常监控用最轻量的 Transaction Ledger；报税找 Realized Gains & Losses；审计师追问"卖的是哪一批"时，上 Cost Breakdown。
2️⃣ 我要余额数据（Balance Reports，5种）
| 需求 | 推荐报表 | API Type |
|---|---|---|
| 当前余额（数量+法币+成本基础） | Asset Balances | RAW_BALANCES |
| 当前余额，排版更适合外发 | Asset Balances V2 | RAW_BALANCES_V2 |
| 某历史日期的余额（无需当时快照） | Asset Balances + Time Capsule | HISTORICAL_BALANCE |
| 来自某次采集（commit）快照的余额 | Asset Balances - Archives | ARCHIVED_BALANCES |
| 当前 vs 上一期（变化检测） | Balance Trends | BALANCE_TRENDS |
这里最容易混淆：Time Capsule 是"重建"历史余额，Archives 依赖真实采集快照。默认推荐前者；只有审计要求"当时实际采集到的数据"时才用后者。另外注意 Asset Balances V2不支持Time Capsule。
3️⃣ 我要成本基础数据（Cost Basis Reports，3种）
| 需求 | 推荐报表 | API Type |
|---|---|---|
| 每笔收购如何堆叠成成本基础 | Cost Basis Inventory | COST_BASIS_INVENTORY |
| 逐笔税务批次（lot）与未实现盈亏 | Cost Basis Stack Per Wallet | COST_BASIS_STACK_PER_ACCOUNT |
| 期初到期末成本基础变动 | Cost Basis Roll Forward | COST_BAIS_ROLL_FORWARD对应的正确值：COST_BASIS_ROLL_FORWARD |
小提醒：Cost Basis Stack 显示的是批次级库存，数量与 Assets 界面不同属正常现象；当前余额的"事实来源"永远是 Asset Balances。
4️⃣ 我要对账 / 期末（Reconciliation Reports，3种）
| 需求 | 推荐报表 | API Type |
|---|---|---|
| 资产数量期初期末 + 安全检查 | Asset Roll Forward | ASSET_ROLL_FORWARD |
| 链上 vs 账内全量对账（5 层校验） | Ledger Reconciliation | RECONCILIATION_LEDGER |
| 未实现盈亏 / 按市值计价 / 减值 | Revaluation | REEVALUATION |
Ledger Reconciliation 是最重的一份：7 个工作表、57 列、5 层检查。技巧是从 Summary 表看"通过/失败"，只有检查项失败才向下钻取；如果只需要数量滚转，Asset Roll Forward 更轻量。
5️⃣ 我要 ERP / 凭证数据（ERP Reports，2种）
| 需求 | 推荐报表 | API Type |
|---|---|---|
| 同步前预览日记账分录 | ERP Pre-Sync | PRE_SYNC_JOURNAL |
| 同步后审计轨迹 | ERP Post-Sync | POST_SYNC_JOURNAL |
铁律：先 Pre-Sync 后同步——用它抓出缺少科目映射、借贷错误的交易；同步完再用 Post-Sync 核对实际发出内容和失败状态。
6️⃣ 我要参考 / 元数据（Reference Reports，2种）
| 需求 | 推荐报表 | API Type |
|---|---|---|
| 某日按小时粒度的资产价格 | Asset Fiat Values | DAILY_ASSET_PRICING |
| 钱包 / 账户清单 | Organization Wallets | INTERNAL_ACCOUNTS |
注意 Asset Fiat Values只覆盖单个 24 小时窗口，多日定价需多次导出。若Price Source = manual，说明有人手动改过价格。
三、高频场景速查表
SKILL.md 内置了 10 个常见场景的捷径答案，摘录最常用的：
| 场景 | 推荐组合 |
|---|---|
| 月末结账 | 首选 Ledger Reconciliation（Summary 表一眼看通过与否）；只看数量用 Asset Roll Forward；要成本基础加 Cost Basis Roll Forward |
| 审计师要材料 | Asset Roll Forward（数量变动）+ Cost Basis Roll Forward（成本基础变动）+ Ledger Reconciliation（全套对账）+ Organization Wallets（钱包登记册），按审计具体所求组合 |
| 报税 / 资本利得 | Realized Gains & Losses，看 Summary Per Year 表拿年度合计；要批次级明细再加 Cost Breakdown |
| 发现余额对不上 | UI 与报表不符 → Asset Balances；链上与账内不符 → Ledger Reconciliation 的 Historical 表；本期与上期不符 → Balance Trends |
| 价格看着不对 | Asset Fiat Values，查当天逐小时价格；Price Source = manual 即被人工覆盖 |
| 税务亏损收割 | Cost Basis Stack Per Wallet，筛选 Unrealized Gain ($) 为负的批次 |
| FIFO/LIFO 验证 | Cost Breakdown，它显示每笔处置消耗了哪个收购批次 |
| 质押奖励 | 单笔明细用 Rollup Breakdown；当前仓位用 Asset Balances 过滤 Balance State = Locked/Claimable |
| 某历史日期余额 | 默认 Asset Balances + Time Capsule（重建，无需当时 commit）；审计要原始采集数据才用 Archives |
四、上手：安装与使用技巧
插件随 claude-plugins-community 市场分发，安装只需两行命令（Claude Code 中执行）：
claude plugin marketplace add anthropics/claude-plugins-community claude plugin install tres-finance-plugin@claude-community之后直接自然语言提问即可触发，例如：
- "我的审计师要 Q1 全部资产变动证明，该给哪张报表？"
- "我要报 2025 年的税，哪个报表有逐笔已实现盈亏？"
- "UI 和链上余额差了一笔，怎么排查？"
这些正是插件自带的评测样例（见 evals/evals.json），可以直接拿来体验。
进阶提示：拿到报表后，插件里还有一个"好搭档" tres-report-analyzer——把导出的 XLSX 文件交给它，它会自动识别报表类型，运行 analyze_report.py 并输出异常、关键指标与行动项摘要。advisor 负责选对报表，analyzer 负责看懂报表，二者配合可覆盖"选表 → 取数 → 分析"的完整闭环。
五、容易踩的 6 个坑 ⚠️
- Asset Balances V2 无 Time Capsule——查历史请换 Asset Balances + Time Capsule 或 Archives；
- Asset Roll Forward 是汇总级——不含单笔交易日期，需要交易明细时请同时导出 Transaction Ledger；
- Rollup Breakdown 只对用了汇总规则的组织有意义——没配置 rollup 时它就是空的或等同于 Transaction Ledger；
- Archives 依赖真实 commit——目标日期没有采集快照就拿不到数据，Time Capsule 则可以重建；
- Cost Basis Stack ≠ 当前余额——它是批次库存视图，数量与 Assets 界面不一致是预期行为；
- Asset Fiat Values 只有 24 小时——跨天定价请分多次导出。
结语
18 种 TRES 报表看似庞大，其实只是 6 类需求的细分。把 report-catalog.md 当字典、把 report-advisor 当向导，月末对账、审计送审、报税取数都能一次选对报表——这正是 claude-plugins-community 社区插件市场"用 AI 消除重复决策"的价值所在。
【免费下载链接】claude-plugins-communityCommunity plugin marketplace for Claude Cowork and Claude Code. Read-only mirror — submit plugins at clau.de/plugin-directory-submission.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-plugins-community
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
