> For the complete documentation index, see [llms.txt](https://support.safeheron.com/help-center/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.safeheron.com/help-center/jian-ti-zhong-wen/chan-pin/shen-ru-safeheron/safeheron-insight.md).
# Safeheron Insight
## 1. 产品简介
Safeheron Insight 是内嵌在 Web 控制台中的 AI 数据问答助手。你不再需要手动导出数据、再用表格工具加工分析，只需用自然语言提问，AI 就会查询交易、余额、手续费、策略和白名单数据，以文字结论 + 数据表格的形式直接回答，并支持一键导出 Excel。
{% hint style="warning" %}
Safeheron Insight 仅支持只读查询，不会发起转账、审批或任何写操作。
{% endhint %}
**核心价值：**
* **自然语言查询**：用日常语言替代菜单点击和筛选器配置，直接问"昨天的出账额是多少"
* **零安装开箱即用**：功能开启后在 Web 控制台导航栏即可打开，无需安装任何插件或客户端
* **结果可带走**：表格数据一键导出 Excel，导出在后台异步进行，不打断你继续提问
* **严格遵循权限体系**：你只能查询到自己在 Safeheron 中本来就有权限查看的数据
**可以做什么：**
* 交易聚合统计（出账额、笔数、转入 vs 转出、每日趋势）
* 交易明细查询（按时间、钱包、币种、方向、状态、金额筛选排序）
* 手续费统计（总额、平均、最高，按链 / 币种 / 钱包拆分）
* 当前余额与历史时点余额查询
* 审批策略与白名单查询
***
## 2. 前置条件
在开始之前，请确认以下准备工作已完成：
| 项目 | 说明 |
| ------------ | ---------------------------------------------- |
| Safeheron 团队 | 已开通并配置好的 Safeheron 账户 |
| Insight 功能 | 默认未开启，您可以在" Web 控制台 > 应用 > Safeheron Lab"开启此功能 |
| 开启权限 | 仅团队创建人可开启或关闭 |
| 浏览器 | 现代浏览器（Chrome / Edge / Safari 最新版） |
{% hint style="info" %}
Insight 功能一旦开启，团队中的每个成员都可以使用。每位成员查询到的数据严格限定在各自的权限范围内。
{% endhint %}
***
## 3. 开启与使用
{% stepper %}
{% step %}
### 开启功能（创建人操作）
1. 使用创建人账号登录 Web 控制台
2. 进入 **Web 控制台 > 应用 > Safeheron Lab**
3. 找到 **Insight** 功能卡片（位于 MCP Server 卡片下方），点击开关开启
{% hint style="warning" %}
开启前导航栏不显示 Insight 入口按钮，功能不可用。非创建人成员无法开启此功能。
{% endhint %}
{% endstep %}
{% step %}
### 打开助手
功能开启后，Web 控制台导航栏右侧会显示常驻的 Insight 图标按钮，点击即可打开对话窗口。
Insight 提供两种窗口模式，功能完全一致：
| 模式 | 布局 | 打开方式 |
| ------------ | ----------------------------- | ----------- |
| **悬浮窗口**（默认） | 紧凑布局，会话历史和对话页面通过切换查看 | 点击导航栏图标 |
| **全屏模式** | 左侧为 New Chat + 会话历史列表，右侧为对话区域 | 悬浮窗口内点击展开按钮 |
{% endstep %}
{% step %}
### 发起第一次提问
点击 **新建对话** 进入引导页，引导页预置了交易、资产与余额、手续费三个类别共 12 个示例问题，点击任意问题即可发起查询。你也可以跳过引导页，直接输入自己的问题：
```
查询上个月 TRX 和 ETH 的手续费分布
```
{% endstep %}
{% endstepper %}
***
## 4. 核心功能实战演示
### 4.1 交易聚合统计
**场景**：想要一个数字或一段趋势，快速掌握交易全貌。
**示例提问：**
```
上个月我们总共处理了多少笔交易？转入和转出各占多少？
```
**预期结果**：Insight 将返回上月交易情况分析，并给出按币种 / 方向拆分的笔数和金额。
***
**进阶提问：**
```
统计本月每天的交易笔数和金额趋势
```
**预期结果**：Insight 返回按日分组的笔数和金额表格，超过 10 行时展示前 10 行并在表格上方标注总条数和汇总信息。
***
### 4.2 交易明细查询
**场景**：逐笔查看交易记录，排查异常或核对明细。
**示例提问 1：最大金额出账**
```
显示上周金额最大的 10 笔出账交易
```
**预期结果**：返回交易的创建时间、币种、数量、金额（USD）、方向、来源名称、目的名称、目的地类型、状态、创建人。
***
**示例提问 2：按条件过滤**
```
列出过去 7 天内所有成功的 USDT 出账交易
```
***
**示例提问 3：增减表格字段**
```
再加上链上哈希和审批人两列
```
**预期结果**：Insight 在原查询基础上调整表格字段后重新展示。可按需追加的字段包括：链上哈希、手续费、来源地址、目的地地址、备注、完成时间、交易 ID。
{% hint style="info" %}
交易明细查询的时间范围最大为 3 个月；交易聚合统计最大为 6 个月。超出范围时 Insight 会明确告知并建议调整查询方式。
{% endhint %}
***
### 4.3 手续费查询
**场景**：统计和分析团队的手续费支出。
**示例提问 1：按链拆分**
```
显示过去 30 天内每个区块链支付的手续费明细
```
**预期结果**：Insight 将返回按链分组的手续费总额（USD）和平均单笔（USD）。
***
### 4.4 资产与余额查询
**场景**：了解团队当前资产状况，或回溯历史某个时点的持仓。
**示例提问 1：当前总资产**
```
我的团队总资产（USD 计价）是多少？各币种按 USD 价值排一下名
```
**预期结果**：Insight 将返回团队总资产 USD 估值，以及各币种的钱包名称、币种、余额、余额（USD）和占团队总资产的百分比。
***
**示例提问 2：按余额阈值筛选**
```
哪些钱包的余额低于 1,000 USDT？
```
***
**示例提问 3：历史时点持仓**
```
上周五各钱包的 USDT 持仓分别是多少？
```
**预期结果**：Insight 返回指定时间点各钱包的 USDT 余额切片。
***
### 4.5 策略与白名单查询
**场景**：了解工作空间当前的审批规则和白名单配置。
**示例提问 1：查看审批策略**
```
列出当前生效的审批策略
```
**预期结果**：Insight 将返回策略名称、发起人范围、来源钱包范围、目的地范围、适用资产和单笔限额。
***
**示例提问 2：查看白名单**
```
最近新增了哪些白名单地址？
```
**预期结果**：返回白名单条目的名称、地址和所属网络。
***
### 4.6 表格展示与 Excel 导出
结构化查询结果以表格呈现，展示规则如下：
* **结果 ≤ 10 条**：表格展示全部数据
* **结果 > 10 条**：表格仅展示前 10 条，上方标注总条数和汇总信息（如"共 50 笔，总额 $2,300,000，前 10 条如下"）
* **匹配量非常大（触发返回上限）**：Insight 主动告知数据未完整返回，并建议缩小时间范围、增加筛选条件，或导出 Excel 获取完整数据
每个表格下方都有 **导出 Excel** 按钮。导出为异步操作：点击后按钮进入"导出中…"，完成后浏览器自动下载并弹出「导出成功」提示，期间可继续对话，互不干扰。
{% hint style="warning" %}
当匹配结果未超过返回上限时，导出内容与你提问时刻的数据完全一致；当匹配量超过上限、需要实时翻页导出时，导出内容为**当前最新数据**，若底层交易状态在提问后发生变化，导出数字可能与提问时的汇总略有出入。
{% endhint %}
***
## 5. 最佳实践
### 5.1 提问技巧
**用具体、明确的自然语言描述你的需求：**
| 一般提问 | 更好提问 |
| ----- | ----------------------- |
| 查一下交易 | 显示过去 7 天所有失败的 USDT 出账交易 |
| 手续费多少 | 上个月按链拆分的手续费总额和平均单笔 |
| 余额情况 | 哪些钱包的余额低于 1,000 USDT |
### 5.2 多轮追问
不必每次把条件重说一遍。基于上一轮结果继续追问，Insight 会自动继承之前的查询条件：
```
显示本周金额最大的 10 笔出账交易
（追问）只看 ETH 的
（追问）按时间重新排一下
（追问）这 42 笔的总额是多少？
```
前两个追问在原查询上叠加筛选和排序；最后一个是对全量数据求和，Insight 会切换到聚合口径给出准确结果，而不是对屏幕上的前 10 条做加法。
### 5.3 调整表格字段
各类查询都有一套默认字段，你可以随时用自然语言增减：
```
交易表里再加上链上哈希和完成时间
```
```
余额表只保留钱包名称和余额（USD）
```
### 5.4 大数据量优先导出
当一次查询匹配到成百上千条记录时，对话中只展示前若干条。需要逐笔核对或离线分析时，直接点击 **导出 Excel** 获取完整数据，比在对话里翻页更高效。
***
## 6. 安全须知
1. **只读查询**：Insight 仅支持数据查询，不会发起转账、审批或修改任何配置。
2. **权限隔离**：严格遵循现有权限体系，你只能查询自己有权限的数据。尝试查询无权限的数据时，Insight 会告知缺少权限并建议联系团队管理员。
3. **AI 输出须核实**：对话窗口底部均有提示"AI 生成结果，请核实数据准确性"。涉及资金决策前，请对照 Web 控制台原始数据复核。
4. **全员可用**：功能开启后，团队中所有成员均可使用，请确保团队成员了解相关安全规范。各成员的数据范围仍受各自权限约束。
***
## 7. 常见问题 FAQ
Q1：Insight 功能如何开通？
默认未开启，由团队创建人在" Web 控制台 > 应用 > Safeheron Lab"中开启此功能。开启后本团队所有成员即可在导航栏看到入口。
Q2：非创建人成员能使用吗？
可以使用，但不能开启或关闭功能。创建人开启后，团队内任意成员都能使用，查询范围各自受权限限制。
Q3：Insight 能帮我转账或审批吗？
不能。Insight 是纯只读的数据问答助手，仅支持查询和分析，不执行任何写操作。
Q4：支持哪些语言？
Insight 跟随你的提问语言回复——中文提问则中文回答，英文提问则英文回答。
Q5：查询有时间范围限制吗？
有。交易明细最长可查 3 个月，交易聚合统计和手续费统计最长可查半年。超出范围时 Insight 会明确告知并建议调整查询方式。
Q6：导出的数据和对话里看到的一致吗？
匹配量未超过返回上限时，导出即提问时刻的数据快照，与对话完全一致；匹配量很大需要实时翻页导出时，导出为当前最新数据，若底层状态有变化，可能与提问时的汇总略有出入。
Q7：为什么 Insight 拒绝了我的某些请求？
Insight 只做数据查询和基于查询结果的合理分析（筛选、排序、换维度、汇总对比）。对于无业务意义的数据加工、格式转换或非查询类任务，Insight 会拒绝并引导你回到数据查询场景。需要自定义加工时，建议先导出 Excel 再自行处理。
Q8：导出有频率限制吗？
有。同一用户 1 分钟内最多发起 3 次导出，超限会提示「导出过于频繁，请稍后重试」。导出在后台进行，期间可以继续对话。