tres-onboarding

TRES Finance — 完整实体入驻

统筹将新实体／客户／账户完整接入 TRES Finance。 此技能不包含自己的底层逻辑，而是通过依次调用对应的专用技能，引导用户完成 8 个步骤。可以把它想象成一位指挥家，在各个子技能处理具体细节的同时，推动入驻流程顺利进行。

---

开始之前

收集输入时不要使用可视化内容。 收集用户的初始背景信息或展示入驻路线图时，切勿使用 show_widget、HTML 小组件、交互式表单、AskUserQuestion 小组件或任何可视化工具。所有问题和路线图都应以纯文本形式在聊天中呈现。这样能让流程快速且响应灵敏——只为询问名称和钱包列表而构建小组件，会增加不必要的延迟。之后，当各个子技能需要可视化内容时（例如余额验证仪表板、对账差异表），可以使用可视化；但入驻启动和步骤切换必须仅使用文本。

1. 确认意图。 用户必须明确请求完整入驻（新实体、新客户或新账户）。如果请求含糊不清，请询问：“您是想为新实体运行完整入驻流程，还是只需要特定步骤方面的帮助（例如上传钱包或验证余额）？”

2. 收集背景信息。 以纯文本形式（不使用小组件或表单）询问用户：

   • 实体／客户／账户名称
   • 已准备好的钱包或交易所账户（文件、列表等）
   • 是否有计划的入驻目标日期

3. 展示路线图。 开始之前，以纯文本形式在聊天中向用户展示路线图（不要使用 HTML 小组件或可视化内容），让他们了解接下来的流程。 可以参考以下内容：

   以下是 [Entity Name] 的入驻路线图：

   1. 上传钱包 — 添加链上钱包和／或交易所账户
   2. 数据收集（提交） — 获取已上传钱包的链上数据
   3. 验证余额 — 将 TRES 余额与链上数据源交叉核对
   4. 对账 — 检查并解决任何余额差异
   5. 成本基础 — 配置并运行成本基础计算
   6. 导出未识别地址 — 从交易中提取第三方地址
   7. 导入联系人 — 为已识别地址添加标签并将其导回 TRES
   8. 汇总规则 — 为高交易量钱包设置交易汇总

   我们会一起完成每个步骤。准备好开始了吗？

---

入驻流程

按顺序完成每个步骤。每完成一个步骤，都要简要总结已完成的内容，并询问用户是否准备好继续。如果某个步骤不相关（例如，没有需要汇总规则的高交易量钱包），用户可以跳过。

重要： 每个步骤都要按名称调用对应技能。阅读其 SKILL.md 并遵循其中的说明。子技能会处理所有细节——你的任务是在步骤之间顺畅衔接，并让用户了解当前进度。

步骤 1：上传钱包

技能： tres-wallets-upload

调用 tres-wallets-upload 技能。该技能将引导用户把链上钱包和／或交易所账户添加到 TRES 中。钱包创建后，确认数量并继续。

过渡语：“钱包已上传。接下来，我们将收集这些钱包的链上数据。”

---

步骤 2：数据收集（提交）

技能： tres-data-collection-commit

调用 tres-data-collection-commit 技能。该技能会为刚刚上传的钱包启动链上数据收集。根据钱包数量及其历史记录，提交可能需要一些时间。

过渡语：“数据收集正在进行／已完成。接下来，我们来验证 TRES 获取的余额是否与链上实际余额一致。”

---

第 3 步：验证余额

技能： tres-asset-balance-validation

调用 tres-asset-balance-validation 技能。该技能会将 TRES 余额与 DeBank（针对 EVM 钱包）进行比较，并生成差异报告。与用户一起检查发现的问题。

过渡语：“余额验证已完成。接下来我们进行对账，解决剩余差异。”

---

第 4 步：对账

技能： tres-recon-gaps

调用 tres-recon-gaps 技能。该技能会获取并显示对账差异数据，并帮助用户解决链上余额与账面余额之间的差异。如果没有差异，就庆祝一下并继续。

过渡语：“对账问题已解决。现在来设置成本基础计算。”

---

第 5 步：成本基础

技能： tres-cost-basis

调用 tres-cost-basis 技能。该技能会根据需要引导用户选择策略，触发成本基础计算，展示各资产的结果和财务问题，并根据需要处理重新评估、spec-ID 规则及相关成本基础操作。检查发现的财务问题（余额为负、缺少法币价格）。

过渡语：“成本基础已配置并开始运行。接下来，我们来找出你的钱包曾交互过的外部地址。”

---

第 6 步：导出未识别地址

技能： tres-export-3rd-party-contacts

调用 tres-export-3rd-party-contacts 技能。该技能会从实体的交易中提取所有未识别的外部地址，并将其导出为 XLSX 工作簿。用户需要检查这些地址并为其标注归属（每个地址属于谁）。

过渡语：“未识别的地址已导出。标注完成后，我们会将它们作为联系人导入。如果你需要时间填写名称，我们可以在这里暂停，稍后再继续下一步；准备好时只需说‘继续入驻’即可。”

**注意：**此步骤会生成需要用户离线检查和填写的文件。可以在这里暂停入驻流程，之后再继续。如果用户想立即继续（也许他们稍后再标注联系人），也没问题——跳到第 8 步。

---

第 7 步：导入联系人

技能： tres-import-contacts

调用 tres-import-contacts 技能。该技能会读取用户已标注的联系人文件，并将地址与名称的映射导入 TRES 地址簿。

过渡语：“联系人已导入！最后一步——为高交易量钱包设置汇总规则。”

---

第 8 步：汇总规则

技能： tres-rollup-rules

调用 tres-rollup-rules 技能。该技能会帮助用户找出交易量较高的钱包，并创建每日或每月汇总规则，将较小的子交易（Gas 费用、质押奖励等）合并为更清晰的汇总条目。

如果没有钱包需要汇总规则，则跳过此步骤。

---

完成

完成所有步骤（或在适当情况下跳过）后，请用以下摘要收尾：

[Entity Name] 的入驻已完成！

以下是我们完成的事项：

• 跨 Y 个网络上传了 X 个钱包
• 收集了链上数据
• 验证了余额（注明任何尚未解决的问题）
• 完成了对账（注明状态）
• 配置了成本基础策略：[strategy]
• 导出并导入了 Z 个联系人
• 设置了 N 条汇总规则

该实体已准备就绪，可以在 TRES Finance 中使用。

---

处理中断与恢复

用户可能需要暂停并稍后继续（尤其是第 6–7 步，因为他们需要离线标注联系人）。请记录最后完成的步骤。如果用户回来后说“继续入驻”或“[entity] 的入驻进行到哪一步了？”之类的话，请从下一个未完成的步骤继续。

跳过步骤

如果某个步骤与用户无关，用户可以跳过。例如：

• 没有 EVM 钱包 → 跳过余额验证（步骤 3）
• 没有缺口 → 对账会很快完成（步骤 4）
• 目前不需要联系人 → 跳过步骤 6-7
• 没有高交易量钱包 → 跳过汇总规则（步骤 8）

始终尊重用户的选择，并继续下一步。