智能体 SDK · Agent Harness SDK · @tansr/sdk

智能产品的
最后一公里 SDK

助力千万企业 | 个人快速发展

全平台智能化最短路径

智能体SDK商业化标准领导者

我们为开发者提供智能产品的最后一公里快速开发解决方案,让企业/个人开发者充分释放对产品的想法。不必投入大量精力在智能体 Harness 上

开始集成 SDK

更喜欢终端?同一套内核的命令行形态:tansr CLI 快速开始 →

MIT 开源承诺
app.ts
import { createSession } from '@tansr/sdk';

// 令牌从你的服务端换发(appkey 恒在服务端;终端只持短期令牌)
const session = await createSession({ token, baseUrl: 'https://api.example.com' });
session.send('帮我总结这份合同');
for await (const event of session.events) {
  if (event.type === 'msg.text.delta') process.stdout.write(event.text);
}

仅适用于 SDK 应用

SDK 应用定价

面向集成 SDK 的智能体应用,按运行规模选择套餐。裁决人、记忆、上下文、工具与媒体能力贯穿各档;个人与组织各自持有套餐和钱包。

独立使用 CLI、serve、ACP 或 headless 无需购买此套餐。通过平台应用提供服务时,适用所属个人或组织的应用额度。模型与媒体调用仍按用量计费

测试体验

限时五折!全额返还!

原价 ¥98.00 / 年5 折

¥49.00/ 年

年度订阅

包含以下运行额度:

  • 10 并发额度
  • 最多 5 个应用
  • 3 个开发者席位
  • 每月最多 100 位不同终端用户
  • 每次购买赠送 ¥49.00 模型余额(CNY,不可提现)
选择 SDK 套餐

个人开发者

限时五折!全额返还!

原价 ¥198.00 / 年5 折

¥99.00/ 年

年度订阅

包含以下运行额度:

  • 1,000 并发额度
  • 最多 10 个应用
  • 10 个开发者席位
  • 不设月度不同终端用户上限
  • 每次购买赠送 ¥99.00 模型余额(CNY,不可提现)
选择 SDK 套餐

团队开发者

限时五折!全额返还!

原价 ¥1980.00 / 年5 折

¥990.00/ 年

也可 ¥99.00 / 月

包含以下运行额度:

  • 10,000 并发额度
  • 最多 32 个应用
  • 100 个开发者席位
  • 不设月度不同终端用户上限
  • 每次购买赠送 ¥990.00 模型余额(CNY,不可提现)
选择 SDK 套餐

旗舰

限时五折!全额返还!

原价 ¥19800.00 / 年5 折

¥9900.00/ 年

也可 ¥990.00 / 月

选择 SDK 应用规模

包含以下运行额度:

  • 100,000 并发额度
  • 最多 100 个应用
  • 1,000 个开发者席位
  • 不设月度不同终端用户上限
  • 每次购买赠送 ¥9900.00 模型余额(CNY,不可提现)
选择 SDK 套餐

可免费创建前 5 个应用;超过 5 个需个人开发者(小规模)及以上套餐。购买时请先选择个人或组织归属。

赠送 Token 按已结算用量抵扣,不折现。仅抵扣平台代付、以人民币(CNY)结算的 LLM 用量:输入、输出、缓存读取、缓存写入四类 Token 不重复计算。图片、视频、语音识别(ASR)、语音合成(TTS)、搜索、自带密钥(BYOK)及客户端上报用量不适用。

查看完整资费与计费说明 →

MIT · OPEN SOURCE COMMITMENT

放心构建,未来握在自己手中。

我们承诺于 ,以 MIT 许可证开放 Tansr 智能体 SDK 源码。

源码可审查

看清 SDK 的运行逻辑、数据处理与权限边界,让技术选型有据可依。

产品可自主定制

按 MIT 许可修改和集成届时发布的源码,支持商业产品使用与再分发。

长期维护有主动权

保留并维护自己的源码副本,让开发者与企业掌握产品的持续演进。

本承诺针对届时发布的 SDK 源码。MIT 允许使用、修改与再分发,需保留版权及许可声明;平台托管服务与模型用量仍遵循各自的服务条款。

Agent Harness SDK

让智能体 SDK 接上真实业务

从桌面 AI 助手、本地文件流程到服务端智能体,将模型、工具、会话与权限连成可集成的运行链条。

智能体循环与多模型接入

Agent Harness SDK 将模型调用、工具执行与结果回传接成多步循环。接入平台已配置、已授权的模型,通过别名与会话切模适配任务。

查看集成方式 →

Electron、TypeScript 与 Node.js 集成

通过 npm 包和类型定义集成智能体。Electron 在主进程运行 SDK,通过 IPC 连接界面;Node.js 服务端也可接入同一套运行能力。

查看集成方式 →

AI 工具调用、MCP 与 Agent Skills

defineTool 连接你提供的业务函数;MCP 接入已有服务;defineSkill 与技能目录装载领域知识。文件读写与检索仍受应用能力及运行时权限约束。

查看集成方式 →

多轮对话、会话恢复与流式输出

用历史快照、可注入存储与 resume 恢复会话。增量文本和工具状态从事件流送往界面,SessionView 提供可渲染数据;持久化位置由应用决定。

查看集成方式 →

权限审批与客户端密钥保护

将能力开关、运行时规则和确认回调接入应用。令牌模式下 appkey 保留在服务端,终端使用短期令牌,平台管理上游凭据。

查看集成方式 →

Token 用量统计与按用户计量

用实时用量事件、按用户查询和开发者金额对账建立成本视图。SDK 提供计量数据,面向终端用户的收费策略和支付流程由开发者实现。

查看集成方式 →

一套内核,两种交付

SDK 把智能体嵌进你的产品;CLI 让同一套内核在终端开箱即用。

主打 · SDK@tansr/sdk

嵌进你的产品

智能体循环归 SDK,交互体验归你——查询环、工具调度、权限引擎、上下文 压缩全部来自内核,prompt 进、事件流出,零 UI 依赖。

  • defineTool 业务函数
  • defineSkill 技能
  • MCP 外接
  • SessionView + Narrator 渲染
  • askUser 权限桥
  • onHistoryCommit 持久化
  • imageGen / videoGen / webSearch
  • setModel 切模
补充 · CLI@tansr/cli

终端开箱即用

同一套内核的终端形态:TUI / headless / serve / ACP 四种运行,注册即用,零集成成本。

terminal
npm i -g @tansr/cli
tansr
0+
内置工具
覆盖文件、命令、网络、任务等场景
0
运行形态
TUI / Headless / Serve / ACP
0
协议支持
Anthropic + OpenAI 双协议
0%
类型安全
TypeScript 全栈类型覆盖

为商业组织而生

Tansr SDK 是由杭州云联慧算科技有限公司为开发者提供的智能体嵌入式解决方案,帮助开发者快速集成 AI 能力。

同一内核,四种形态

TUI 交互、headless 单次执行、serve 常驻服务、ACP 编辑器集成——一份内核投资,多场景复用。

🔄

双协议中立

Anthropic Messages 与 OpenAI Chat Completions 同为一等公民,统一 IR 模型,企业可自由切换或混用。

🛡️

企业级治理

权限引擎、审计事件流、成本归因从第一天进入内核数据结构,而非事后补丁。

🧩

可扩展体系

命令、技能、钩子、子代理、插件五件套,兼容 Claude Code 生态,叠加企业私有 registry 与签名。

📊

成本可核算

每次 API 调用的 tokens 与费用归因到会话、轮次、工具、子代理,企业可精准计费。

🚀

编排就绪

事件总线一份数据三用:UI 渲染、审计、编排回放。二期编排系统直接复用内核事件协议。

四种运行形态

同一个内核,多种使用场景。从交互式开发到自动化生产,灵活适配你的工作流。

💬

TUI

终端界面

交互式终端体验,支持多轮对话、工具调用可视化、实时流式输出

$tansr
多轮对话工具调用卡片实时流式输出会话历史

Headless

无头模式

单次执行模式,适合脚本集成和自动化工作流

$tansr -p "你的提示词"
单次执行JSON 输出退出码控制管道集成
🌐

Serve

服务模式

常驻 HTTP 服务,提供 REST API 和 SSE 实时事件流

$tansr serve --port 8080
REST APISSE 事件流多会话并发认证鉴权
🔌

ACP

代理客户端协议

标准化协议,支持编辑器插件和第三方集成

$tansr acp
JSON-RPC编辑器集成协议标准第三方扩展

双协议网关

同时支持 Anthropic 和 OpenAI 协议,统一接口抽象,智能路由调度

🟠

Anthropic

Claude 3.5 Sonnet
Claude 3 Opus
Claude 3 Haiku
🟢

OpenAI

GPT-4o
GPT-4 Turbo
GPT-3.5 Turbo

协议网关层

统一抽象 · 智能路由 · 故障转移

🔗
统一中间表示
IR 抽象层屏蔽协议差异
🎯
智能路由
基于成本和性能自动选择
🔄
故障转移
主备链路自动切换
💰
成本追踪
实时计算每次调用费用
⚙️

智能体内核

查询环状态机 · 工具调用编排 · 上下文管理 · 成本核算

分层单向依赖

严格单向依赖,工具只产出结构化数据,渲染由表面层按事件类型注册渲染器。

L4cli
装配层
commander 入口命令路由装配 kernel+tui/server
L3tui / server
表面层
React/Ink TUIREST+SSE 服务ACP stdio
L2kernel
智能体内核
查询环状态机工具系统权限引擎上下文工程会话存储
L1providers
双协议网关
Anthropic 适配器OpenAI 适配器统一 IR 模型计价表
L0.5i18n
国际化
t() 运行时locale 解析zh-CN / en
L0protocol
纯类型与 schema
IR 消息模型事件协议配置 schema
↑ 依赖方向:表面层 → 内核 → 协议(严格单向,禁止反向引用)

内置工具集

丰富的内置工具,覆盖文件、命令、网络、多媒体、任务、智能体等场景

Read

读取文件内容

示例
Read file_path="/src/main.ts"

Write

写入文件内容

示例
Write file_path="/output.txt" contents="..."

Edit

精确替换文件片段

示例
Edit file_path="/code.ts" old_string="..." new_string="..."

Glob

文件模式匹配

示例
Glob pattern="**/*.ts"

Grep

内容搜索

示例
Grep pattern="function" path="/src"

五类扩展构件

命令、技能、钩子、子代理、插件,构建企业专属的智能体生态。

自定义命令

快捷指令

定义团队专属的斜杠命令,一键触发复杂工作流,支持参数化模板和上下文注入。

参数化模板上下文注入别名系统权限控制
.tansr/commands.yaml
/review-pr 123
/deploy staging
/security-scan ./src

兼容 Claude Code 生态,无缝迁移现有扩展

查看扩展开发指南
企业级

治理即内核

权限、审计、成本从第一天进入内核数据结构,而非事后补丁。

50+
权限策略
100% 覆盖
审计事件
Token
成本精度
SOC 2
合规标准
🔐

权限引擎

细粒度访问控制

从内核层面实现 RBAC 权限模型,工具调用、文件访问、网络请求均可按策略精细化授权。

基于角色的权限矩阵
工具调用白名单/黑名单
文件路径访问控制
网络域名过滤
📋

审计追踪

完整操作日志

每一次会话、每一个工具调用、每一笔 API 请求都被完整记录,满足企业合规审计要求。

结构化事件流
不可篡改日志链
多维度检索查询
SIEM 系统集成
💰

成本核算

实时费用追踪

Token 消耗与费用实时归因到会话、用户、项目维度,支持预算告警与成本分摊。

Token 粒度计费
多维度成本归因
预算阈值告警
月度成本报表
🛡️
私有化部署就绪
支持本地模型、离线环境、专有云,数据完全自主可控

应用场景

从个人开发到企业级应用,Tansr 适配各种使用场景

$ tansr
❯ 帮我重构这个函数,提高可读性
已读取 src/utils/parser.ts
正在重构函数...
完成!减少了 30% 代码行数

为什么选择 Tansr?

专为开发者和企业打造的智能体 CLI,对比传统方案的显著优势

特性
Tansr
传统方案
运行形态
TUI / Headless / Serve / ACP 四种形态
通常只有一种界面
协议支持
OpenAI + Anthropic 双协议中立
绑定单一供应商
扩展机制
Commands / Skills / Hooks / Subagents / MCP
有限的插件系统
企业治理
内置权限引擎 + 审计日志 + 成本核算
无或需额外集成
成本追踪
实时 token 和费用追踪,支持预算管理
无成本追踪或仅基础统计
编排能力
多智能体协作,任务编排(二期)
单智能体,无编排
部署方式
本地 / 云端 / 私有化 / Sea 单文件
通常仅云端 API
配置管理
多层级配置继承,支持团队共享
单一配置文件

三分钟上手

从安装到首次运行,只需三步。

01

安装

npm 全局安装,或下载 SEA 单文件可执行包,无需 Node 运行时。

npm i -g @tansr/cli
02

配置模型

声明 provider 端点与凭据,支持 Anthropic、OpenAI 及兼容端点。

// .tansr/settings.json
{
  "providers": {
    "anthropic": {
      "baseUrl": "https://api.anthropic.com",
      "auth": { "type": "header", "name": "x-api-key" }
    }
  }
}
03

启动

四种运行形态,同一内核,按需选择。

# 交互式 TUI
tansr

# 无头单次执行
tansr -p "重构这个函数"

# 常驻服务(REST + SSE)
tansr serve --token <值>

# 编辑器集成(ACP stdio)
tansr acp

产品路线图

从 CLI 工具到企业级平台,三期演进,逐步构建完整生态

进行中
🚀
一期 · 2026 Q1 - Q2

CLI 智能助手

16+
工具数量
4 种
运行形态
2 个
协议支持
单智能体交互模式
16+ 内置工具
双协议网关
TUI / Headless / Serve / ACP
权限引擎
成本追踪
规划中
🤝
二期 · 2026 Q3 - Q4

多智能体协作

图结构
编排模式
多智能体
并发支持
智能
调度策略
编排引擎
任务依赖图
并行/串行执行
条件分支
智能体池化
资源调度
未来
🏢
三期 · 2027 Q1+

企业级平台

多租户
租户隔离
RBAC
权限控制
私有化
部署方式
多租户架构
RBAC 权限模型
审计日志
成本核算
插件市场
私有化部署

常见问题

关于 Tansr 的常见问题解答

Tansr 专注于终端体验和开发者工作流,提供 TUI、Headless、Serve、ACP 四种运行形态。相比图形界面工具,Tansr 更适合脚本集成、自动化流水线和高级用户。同时,Tansr 支持双协议网关(OpenAI + Anthropic),不绑定特定供应商。

还有其他问题?

准备好了吗?

把 Claude Code 级别的执行力,经 SDK 装进你的产品,或经 CLI 装进你的终端——可治理、可编排、可核算。