mcpField
T
tres-ledger-link

tres-ledger-link

github.com/anthropics数据与数据库4.8k49 次安装2 周前更新
代码仓库

关于 tres-ledger-link

tres-ledger-link 是用于生成 TRES Finance 交易账本筛选链接的技能，面向需要分享或复用特定交易视图的用户。它指导 Agent 查询组织子域名、收集明确筛选条件并校验 URL。

主要功能

  1. 01生成交易账本筛选链接
  2. 02通过 MCP 查询组织子域名
  3. 03支持日期、账户及资产筛选
  4. 04按规则编码并校验 URL

适用场景

  1. 01分享指定日期范围的交易视图
  2. 02筛选特定钱包、资产或交易状态
  3. 03生成单笔交易或已保存筛选的链接

MCP 相关

要求通过 MCP 查询 get_viewer 获取组织名称；未知的筛选 ID 可通过 execute 工具查询。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/anthropics/claude-plugins-community --skill tres-ledger-link

安装后在 Claude Code 中输入/tres-ledger-link确认已加载。

详细介绍

生成 Dashboard Ledger 链接

你的任务是生成一个可用的 TRES Finance Dashboard URL，打开已应用精确筛选条件的 Ledger 的 Transactions 选项卡，供用户分享给客户（或自己使用）。

此技能仅适用于 Transactions 选项卡。如果用户要求链接指向 Accounting、Roll Forward、Pivot Tables、Cost Basis 或 Trial Balances，请停止并告知用户此技能不涵盖这些选项卡。

第 1 步 — 确定组织子域名

Dashboard URL 为 https://<org-subdomain>.tres.finance/ledger。

通过 MCP get_viewer 查询确定 <org-subdomain>（使用返回的 orgName）。不要询问用户。

query { viewer { orgName } }

在最终消息中说明你使用的子域名，以便用户发现有误时能一次性更正。

第 2 步 — 收集用户需要的筛选条件

从用户的自然语言请求中提取筛选条件（日期范围、钱包、资产、标签、状态等）。如果筛选条件含糊不清（例如，组织中有多个 USDC 变体，但用户只说“USDC”；或只说“Q1”而未指定年份），请先询问再生成。错误的值会悄无声息地生成无效或空白视图。

只包含用户明确要求的筛选条件。Dashboard 会为其他所有条件填入默认值——添加额外参数只会徒增干扰。

第 3 步 — 构建 URL

基础路径始终为：

https://<org-subdomain>.tres.finance/ledger

/ledger 后不要添加路径段（这对应 Transactions 选项卡）。

添加 ? 和根据以下规则构建的查询字符串。对每个值进行 URL 编码（空格 → %20）。单个值内部的逗号需要编码；不同数组项之间的逗号则作为分隔符保留。

3.1 日期与分页
参数格式 / 值备注
fromDateYYYY-MM-DDUTC 日期
toDateYYYY-MM-DDUTC 日期
dateTypeMonth to date、Year to date、Last 30 days、Last month、Before this month、Custom date、All time、Year、Quarters对空格进行 URL 编码。如果为 Last 30 days（默认值），则省略。对于任意 fromDate / toDate 范围，使用 Custom date。
page整数若为 1，则省略。
pageSize整数若为 20（默认值），则省略。

如果 dateType=All%20time，则会忽略 fromDate / toDate——不要包含它们。

3.2 多选数组筛选条件（以逗号连接的 ID）
参数填入的内容
internalAccounts组织自有钱包的数据库数字 ID
tags钱包组 ID，或表示未加标签的 no-label
thirdPartyAccounts外部账户的原始地址字符串（子交易中的发送方 / 接收方标识符，不一定是系统中的已命名联系人）
customNameLabelTags联系人组 ID
addresses未识别地址的原始字符串
assetClasses资产类别枚举 ID（例如 CRYPTO、FIAT、NFT）
assets资产 ID
activities大写的标签 ID（例如 SPAM、STAKING），或 no-label
automations自动化 ID
platforms小写的平台名称（例如 ethereum、bitcoin——不是大写枚举值）
actions财务操作枚举名称（例如 SEND、RECEIVE）
functions解码后的函数名称
applications应用 ID
protocols协议 ID
methodIds4 字节十六进制方法 ID（0xa9059cbb）
transactionHash交易哈希值
transactionViewreadyPending（默认值）、onlyReady、onlyPending、onlyDeleted
transactionTypeisManual、onlyPlug 中的任意值
filterByBookmark小写的书签类型
missingCounterMatchedTransfersall（默认值）、false（有对应转账）、true（无对应转账）
balanceFactor1（流入）、-1（流出）。通常为单个值。
amountAsset单个资产 ID（与 amountBetween 搭配使用）

如果不知道多选值的确切 ID，请先通过 execute MCP 工具查询 BFF 获取。不要猜测。

3.3 范围筛选器
参数格式说明
amountBetween<min>,<max>任一侧都可以留空：100,500（范围）、100,（≥100）、,500（≤500）。必须包含一个逗号。
3.4 布尔筛选器（仅在值为 true 时包含）

showSpam、missingFiat、failedTransactions、nonTaxableType、missingCostBasis、 internalTransactions、ignoreFee

示例：?showSpam=true&missingFiat=true。绝不要输出 =false——false 是默认值。

3.5 备注／带输入框的单选项
参数值
commentContains1 = 有备注，-1 = 无备注，0 = 显示全部（省略），或用于搜索备注内容的任意文本字符串
3.6 其他单值参数
参数格式
savedFilters已保存筛选器 ID（单个值）
description单个字符串
globalSearch单个字符串

第 4 步——发送前验证

根据此清单检查 URL。如果有任何规则不符合，先修正再交付。

  1. 路径必须严格为 /ledger。不能有标签页后缀，也不能有 ?id=...。
  2. fromDate／toDate 必须与 dateType=Custom%20date 配对（也可以省略 dateType），绝不能与 Last%2030%20days 或 All%20time 配对。
  3. 任何布尔值都不能设置为 =false。
  4. 多选值必须用逗号连接，绝不能重复键（?platforms=ethereum,bsc，不能写成 ?platforms=ethereum&platforms=bsc）。
  5. platforms 的值必须为小写（ethereum，而不是 ETHEREUM）。其他所有枚举 ID 必须与 架构一致（SPAM，而不是 Spam；CRYPTO，而不是 crypto）。
  6. amountBetween 必须始终包含且仅包含一个逗号，即使一侧为空也一样。
  7. 如果 activities 包含 SPAM，还要设置 showSpam=true，确保链接包含所有必要信息。
  8. 如果设置了 transactionHash，仪表板会忽略任何日期筛选器——如果用户的请求中也提到了日期，请提醒用户。
  9. 空格必须进行 URL 编码（Custom date → Custom%20date）。
  10. 只包含用户要求的筛选器。

第 5 步——交付

单独一行发送 URL，以便于复制。简要说明编码了哪些筛选条件（以及使用的子域名），方便用户在转发给客户前核对。

交付示例：

为组织 <subdomain> 构建：筛选条件为 platform=ethereum、activities=SPAM、fromDate/toDate 为 2026 年 4 月（Custom date）、showSpam=true。

https://.tres.finance/ledger?fromDate=2026-04-01&toDate=2026-04-30&dateType=Custom%20date&platforms=ethereum&activities=SPAM&showSpam=true

示例

上个月的 Ethereum SPAM 交易：

https://<subdomain>.tres.finance/ledger?fromDate=2026-04-01&toDate=2026-04-30&dateType=Custom%20date&platforms=ethereum&activities=SPAM&showSpam=true

查看两个指定钱包的全部历史记录：

https://<subdomain>.tres.finance/ledger?dateType=All%20time&internalAccounts=12345,67890

仅 USD 计价、金额 ≥ 50k 的大额转账：

https://<subdomain>.tres.finance/ledger?assetClasses=FIAT&amountBetween=50000,&amountAsset=USD

2026 年第 1 季度缺少法币金额的失败交易：

https://<subdomain>.tres.finance/ledger?fromDate=2026-01-01&toDate=2026-03-31&dateType=Custom%20date&failedTransactions=true&missingFiat=true

指定的已保存筛选器：

https://<subdomain>.tres.finance/ledger?savedFilters=12345

规则

  • **此技能用于用户用普通语言描述的常规临时筛选视图。**若要固定一笔刚创建的交易，以便立即显示待处理／回溯日期的行，请设置 transactionHash 和 dateType=All%20time。
  • 绝不要在此技能之外手动构造账本 URL——用户要求账本／仪表板／筛选链接时，务必使用此技能。
  • 布尔筛选器绝不要包含 =false。
  • 绝不要重复键（?x=a&x=b）——将多个值用逗号连接为一个值。
  • 仪表板需要枚举 ID 时，绝不要使用显示名称。
  • 回复前务必根据第 4 步的清单完成验证。
  • 交付消息中务必说明使用的子域名和筛选条件。

评论

支持 Markdown