使用教程

三分钟跑通 TerseLink

TerseLink 是一层装在你电脑上的本地网关。AI 工具不再直接连上游厂商，而是先连 TerseLink，由它代理请求、逐笔记账并经九层管道优化。接口完全兼容 OpenAI 协议。

你的 AI 工具IDE 插件 / 聊天客户端 / 脚本

→

TerseLink 本机网关鉴权 · 优化 · 记账

→

上游大模型你自己的服务商渠道

准备：安装客户端并登录

在 下载页 选择对应系统的安装包（下载需登录官网账号，安装包免费）。打开客户端，用官网的邮箱和密码登录，并勾选《隐私政策》《用户协议》。

第一步：完成首次引导

第二步：验证连通

接入你的 AI 工具

你的 AI 工具原来直接连厂商接口，现在只需改两处：把 base_url 指向本机网关，把 api_key 换成 TerseLink 的虚拟 Key。其他一切不变。

第一步：拿到接入信息

第二步：按工具类型配置

curl http://127.0.0.1:8819/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-tl-你的虚拟Key" \
  -d '{"model":"deepseek-chat","messages":[{"role":"user","content":"你好"}]}'

from openai import OpenAI

client = OpenAI(
    base_url="http://127.0.0.1:8819/v1",
    api_key="sk-tl-你的虚拟Key",
)
resp = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

第三步：验证与排错

在工具里发一条消息，再去「请求历史」查看是否出现记录。如果报错，按顺序检查：

• 接口地址是否填到 /v1 这一层；
• 虚拟 Key 是否已停用、过期或超出硬预算；
• 对应的 AI 模型渠道是否测活成功，是否处于「熔断中」。

AI 模型管理

AI 模型（渠道）就是真正提供模型能力的上游服务商。TerseLink 本身不带模型，需要先添加至少一个渠道。

添加与编辑渠道

进入「网关 → AI 模型」，点「添加 AI 模型」，填写以下信息：

连通性测试与熔断

点击「测试」可实时检查渠道连通性与延迟。渠道连续异常时会显示 熔断中，暂时不再分配请求，并按健康熔断策略自动恢复，无需手动干预。

模型别名

把客户端请求的模型名映射到真实模型，例如让工具里的 gpt-4o 实际调用你指定的模型，还可以钉死到某个渠道。这也是「指定模型」管道的配置入口。

免费额度

「网关 → 免费额度」汇总各服务商的免费额度：新用户赠金、每月免费、每日免费、限流免费、限时活动，展示额度金额、适用模型、领取条件（实名 / 绑卡 / 企业认证）与有效期。你可以标记「已领取」、反馈失效或撤销领取状态，方便管理可用额度。

虚拟 Key 与预算控制

虚拟 Key 是 TerseLink 生成的接入凭证（sk-tl- 开头）。给每个项目、每个工具发一把，出问题时停用这一把即可，不会影响其他钥匙，也不会暴露上游真实密钥。

新建钥匙

读懂钥匙列表

列表展示每把钥匙的状态、消耗、请求数与最近使用时间。你可以随时编辑、停用 / 启用或删除；删除后无法恢复，使用该钥匙的工具会立即失效。

免费版数量限制

九层成本优化

请求发往上游之前，会依次经过九层成本优化。每一层只做一件优化的事，所有动作都会在账本留痕，你可以在「请求历史」里看到每笔请求命中了哪些管道、省了多少钱。

九层管道与版本权限

配置与生效

看懂节省构成与 A/B 对照

「节省明细」用比例条、金额与趋势展示各层的节省贡献。节省按 反事实基准成本 − 实际成本 计算。开启 A/B 对照统计 后，系统会按留出比例保留一部分请求不做优化，用来校准真实节省。

用量、请求与价格

用量统计

时间范围支持今日、近 7 天、近 30 天与自定义；选择单日时可按小时查看趋势。页面包含三组指标：

账单对账：导入上游账单 CSV，系统逐日对比账本成本，帮你快速定位差异。

请求历史

逐笔记录时间、虚拟 Key、模型、渠道、状态、耗时、输入 / 输出 Token、花费、节省金额与各管道命中情况；支持搜索、筛选、分页与详情查看。失败请求的详情会显示原因，方便判断是预算超限、渠道熔断还是模型不可用。

模型价格

按渠道 / 模型维护输入价、输出价与缓存命中输入价。支持折扣时段规则，统一按北京时间判定：

系统会做价表审计，对明显异常的价格给出提示，避免账本失真。

数据导出

授权与设备管理

免费版与付费套餐（专业版 / 团队版 / 企业版）

下载与安装始终免费。客户端登录后按账号实时判定档位：免费版可直接使用；专业版、团队版、企业版能力一致，均解锁全部九层管道、不限虚拟 Key 数量、任意时间段导出与不限次数换绑。同一账号可同时持有多档套餐的有效期，客户端按安装包版本启用对应套餐——个人版安装包启用专业版，团队版安装包启用团队版 / 企业版（企业版优先）。完整对比见 套餐方案。

购买套餐

设备绑定与换绑

在客户端「设置 → 设备」可以看到设备名、系统、客户端版本与换绑剩余次数。

换绑额度用尽：申请设备解绑

系统与设置

设置页

通知中心与反馈

顶栏的通知中心汇总版本发布、客服回复、设备解绑审批结果，支持分类查看，官网与客户端同步展示。「系统 → 反馈」是会话式客服：支持文字与图片，左侧是历史会话；客服回复后会以红点提醒。

账号安全

客户端会定期复核登录态。如果账号在另一台设备登录导致当前会话被顶替，会立即提示并退回登录页；在官网修改密码后，所有旧会话也会失效，需要用新密码重新登录。