For the complete documentation index, see llms.txt. This page is also available as Markdown.

Safeheron Insight

1. 产品简介

Safeheron Insight 是内嵌在 Web 控制台中的 AI 数据问答助手。你不再需要手动导出数据、再用表格工具加工分析,只需用自然语言提问,AI 就会查询交易、余额、手续费、策略和白名单数据,以文字结论 + 数据表格的形式直接回答,并支持一键导出 Excel。

核心价值:

  • 自然语言查询:用日常语言替代菜单点击和筛选器配置,直接问"昨天的出账额是多少"

  • 零安装开箱即用:功能开启后在 Web 控制台导航栏即可打开,无需安装任何插件或客户端

  • 结果可带走:表格数据一键导出 Excel,导出在后台异步进行,不打断你继续提问

  • 严格遵循权限体系:你只能查询到自己在 Safeheron 中本来就有权限查看的数据

可以做什么:

  • 交易聚合统计(出账额、笔数、转入 vs 转出、每日趋势)

  • 交易明细查询(按时间、钱包、币种、方向、状态、金额筛选排序)

  • 手续费统计(总额、平均、最高,按链 / 币种 / 钱包拆分)

  • 当前余额与历史时点余额查询

  • 审批策略与白名单查询


2. 前置条件

在开始之前,请确认以下准备工作已完成:

项目
说明

Safeheron 团队

已开通并配置好的 Safeheron 账户

Insight 功能

默认未开启,您可以在" Web 控制台 > 应用 > Safeheron Lab"开启此功能

开启权限

仅团队创建人可开启或关闭

浏览器

现代浏览器(Chrome / Edge / Safari 最新版)

Insight 功能一旦开启,团队中的每个成员都可以使用。每位成员查询到的数据严格限定在各自的权限范围内。


3. 开启与使用

1

开启功能(创建人操作)

  1. 使用创建人账号登录 Web 控制台

  2. 进入 Web 控制台 > 应用 > Safeheron Lab

  3. 找到 Insight 功能卡片(位于 MCP Server 卡片下方),点击开关开启

2

打开助手

功能开启后,Web 控制台导航栏右侧会显示常驻的 Insight 图标按钮,点击即可打开对话窗口。

Insight 提供两种窗口模式,功能完全一致:

模式
布局
打开方式

悬浮窗口(默认)

紧凑布局,会话历史和对话页面通过切换查看

点击导航栏图标

全屏模式

左侧为 New Chat + 会话历史列表,右侧为对话区域

悬浮窗口内点击展开按钮

3

发起第一次提问

点击 新建对话 进入引导页,引导页预置了交易、资产与余额、手续费三个类别共 12 个示例问题,点击任意问题即可发起查询。你也可以跳过引导页,直接输入自己的问题:


4. 核心功能实战演示

4.1 交易聚合统计

场景:想要一个数字或一段趋势,快速掌握交易全貌。

示例提问:

预期结果:Insight 将返回上月交易情况分析,并给出按币种 / 方向拆分的笔数和金额。


进阶提问:

预期结果:Insight 返回按日分组的笔数和金额表格,超过 10 行时展示前 10 行并在表格上方标注总条数和汇总信息。


4.2 交易明细查询

场景:逐笔查看交易记录,排查异常或核对明细。

示例提问 1:最大金额出账

预期结果:返回交易的创建时间、币种、数量、金额(USD)、方向、来源名称、目的名称、目的地类型、状态、创建人。


示例提问 2:按条件过滤


示例提问 3:增减表格字段

预期结果:Insight 在原查询基础上调整表格字段后重新展示。可按需追加的字段包括:链上哈希、手续费、来源地址、目的地地址、备注、完成时间、交易 ID。

交易明细查询的时间范围最大为 3 个月;交易聚合统计最大为 6 个月。超出范围时 Insight 会明确告知并建议调整查询方式。


4.3 手续费查询

场景:统计和分析团队的手续费支出。

示例提问 1:按链拆分

预期结果:Insight 将返回按链分组的手续费总额(USD)和平均单笔(USD)。


4.4 资产与余额查询

场景:了解团队当前资产状况,或回溯历史某个时点的持仓。

示例提问 1:当前总资产

预期结果:Insight 将返回团队总资产 USD 估值,以及各币种的钱包名称、币种、余额、余额(USD)和占团队总资产的百分比。


示例提问 2:按余额阈值筛选


示例提问 3:历史时点持仓

预期结果:Insight 返回指定时间点各钱包的 USDT 余额切片。


4.5 策略与白名单查询

场景:了解工作空间当前的审批规则和白名单配置。

示例提问 1:查看审批策略

预期结果:Insight 将返回策略名称、发起人范围、来源钱包范围、目的地范围、适用资产和单笔限额。


示例提问 2:查看白名单

预期结果:返回白名单条目的名称、地址和所属网络。


4.6 表格展示与 Excel 导出

结构化查询结果以表格呈现,展示规则如下:

  • 结果 ≤ 10 条:表格展示全部数据

  • 结果 > 10 条:表格仅展示前 10 条,上方标注总条数和汇总信息(如"共 50 笔,总额 $2,300,000,前 10 条如下")

  • 匹配量非常大(触发返回上限):Insight 主动告知数据未完整返回,并建议缩小时间范围、增加筛选条件,或导出 Excel 获取完整数据

每个表格下方都有 导出 Excel 按钮。导出为异步操作:点击后按钮进入"导出中…",完成后浏览器自动下载并弹出「导出成功」提示,期间可继续对话,互不干扰。


5. 最佳实践

5.1 提问技巧

用具体、明确的自然语言描述你的需求:

一般提问
更好提问

查一下交易

显示过去 7 天所有失败的 USDT 出账交易

手续费多少

上个月按链拆分的手续费总额和平均单笔

余额情况

哪些钱包的余额低于 1,000 USDT

5.2 多轮追问

不必每次把条件重说一遍。基于上一轮结果继续追问,Insight 会自动继承之前的查询条件:

前两个追问在原查询上叠加筛选和排序;最后一个是对全量数据求和,Insight 会切换到聚合口径给出准确结果,而不是对屏幕上的前 10 条做加法。

5.3 调整表格字段

各类查询都有一套默认字段,你可以随时用自然语言增减:

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 次导出,超限会提示「导出过于频繁,请稍后重试」。导出在后台进行,期间可以继续对话。

Last updated