JavaScript SDK工具

JavaScript/TypeScript SDK for inference.sh to run AI apps, build agents, and integrate 150+ models with flexible automation and workflow support.

天轰穿@thcjp

Install

openclaw skills install @thcjp/javascript-sdk

核心功能: 本技能提供化工作流场景等能力。

Javascript Sdk

专业版专属特性

能力	免费版	付费版
基础功能	支持	支持
代码静态分析与质量评分	不支持	支持
依赖漏洞检测与升级建议	不支持	支持
批量代码审查与报告生成	不支持	支持
CI/CD流水线集成	不支持	支持
代码复杂度可视化与重构建议	不支持	支持

能力矩阵

JavaScript/TypeScript SDK for inference
sh - run AI apps, build agents, integrate 150+ models

快速掌握

确认运行环境满足依赖说明中的要求
在AI Agent对话中调用本技能,提供必要的输入参数
检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

适用范围

场景	输入	输出
模型调用	输入文本与模型参数	模型输出与用量统计
inference.	目标数据与配置参数	处理结果与执行状态
TS SDK	目标数据与配置参数	处理结果与执行状态

不适用于：需要人工判断的复杂决策场景

操作步骤

bash

npm install @inferencesh/sdk

typescript

import { inference } from '@inferencesh/sdk';
// ...
const client = inference({ apiKey: 'inf_your_key' });
// ...
// Run an AI app
const result = await client.run({
  app: 'infsh/flux-schnell',
  input: { prompt: 'A sunset over mountains' }
});
console.log(result.output);

使用步骤:

阅读依赖说明章节,确认运行环境已就绪
根据任务需求,参考核心能力章节选择对应能力
按照能力描述提供输入参数,执行操作
查看输出结果,确认任务完成状态

输入参数

参数名	类型	必填	说明
content	string	否	javascript-sdk处理的内容输入
mode	string	否	处理模式, 可选: json/text/markdown,
max_retries	integer	否	单步最大重试次数, 默认: 2
skip_steps	array	否	跳过的步骤编号(用于断点续传), 默认: []

输出规范

json

{
  "success": true,
  "data": {
    "final_result": {
      "sdk_result": "sdk_result_value",
      "sdk_metadata": "sdk_metadata_value",
      "sdk_status": "sdk_status_value"
    },
    "execution_log": [
      {
        "step": 1,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 1200,
        "output_summary": "按流程执行"
      },
      {
        "step": 2,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 3500,
        "output_summary": "按流程执行"
      },
      {
        "step": 3,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 2100,
        "output_summary": "按流程执行"
      },
      {
        "step": 4,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 800,
        "output_summary": "按流程执行"
      }
    ],
    "total_duration_ms": 7600,
    "gates_passed": 3,
    "gates_total": 3
  },
  "error": null
}

中间产物模板参考: assets/javascript-sdk_template

异常应对

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达

前置条件

运行环境

Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
操作系统: Windows / macOS / Linux

依赖说明(补充)

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

可用性分类

分类: MD+execute()
说明: 基于Markdown的AI Skill,

API Key配置方式:

bash

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

案例展示

示例1：基础用法

text

# 请参考上方使用说明进行配置和调用
result = "ready"
```bash
npm install @inferencesh/sdk

请参考上方使用说明进行配置和调用

result = "ready"

typescript

import { inference } from '@inferencesh/sdk';

const client = inference({ apiKey: 'inf_your_key' });

// Run an AI app
  app: 'infsh/flux-schnell',
  input: { prompt: 'A sunset over mountains' }
});
console.log(result.output);

请参考上方使用说明进行配置和调用

result = "ready"

text


## 热门问题
### Q1: 如何开始使用Javascript Sdk？
A: 请参考使用流程和依赖说明章节，确保运行环境满足要求后调用本技能。
## 异常处理架构
| 错误场景(续)| 原因 | 处理方式 |
|----:|:----|----:|
| LLM响应超时或无响应 | 网络延迟或模型负载过高 | 请求重试；确认Agent平台LLM服务正常 |
| 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求，参考示例章节 |
| 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述，补充必要的上下文信息 |
| 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求；检查命令权限设置 |

## 差异化分析
### 效率提升量化分析
| 操作步骤 | 手动耗时 | 自动化耗时 | 时间节约 | 准确率提升 |
| --- | --- | --- | --- | --- |
| 模型调用 | 10分钟 | 1分钟 | 9分钟 | 5% |
| Agent编排 | 30分钟 | 5分钟 | 25分钟 | 10% |
| 模型集成 | 2小时 | 20分钟 | 1小时40分钟 | 7% |
| AI应用部署 | 4小时 | 1小时 | 3小时 | 8% |
| 代码审查 | 8小时 | 2小时 | 6小时 | 12% |

### 差异化对比
| 对比维度 | 本技能 | 手动操作 | Python脚本 | 专业软件 |
| --- | --- | --- | --- | --- |
| 功能丰富度 | 集成150+模型，支持多种AI应用 | 功能单一，需手动集成 | 功能有限，需编写额外脚本 | 功能全面，但成本高 |

### 核心痛点解决
| 痛点 | 描述 | 影响范围 | 解决方案 | 量化效果 |
| --- | --- | --- | --- | --- |
| 模型调用复杂 | 模型调用过程复杂，需要编写大量代码 | 开发效率低，易出错 | 提供简单易用的SDK，简化调用过程 | 开发效率提升30% |
| Agent编排困难 | Agent编排过程繁琐，需要专业知识 | 难以快速搭建智能系统 | 提供可视化编排工具，降低门槛 | 编排效率提升50% |
| 模型集成耗时 | 模型集成过程耗时，需要手动操作 | 开发周期长，成本高 | 提供自动化集成工具，简化流程 | 开发周期缩短20% |

## 常见问题FAQ

### Q1: 如何获取JavaScript SDK工具的API密钥？
A: 您可以在inference.sh平台注册账号，并在个人中心找到API密钥，用于调用SDK服务。

### Q2: JavaScript SDK工具支持哪些AI模型？
A: JavaScript SDK工具支持超过150种AI模型，包括自然语言处理、图像识别、语音识别等领域的模型。

### Q3: 如何在项目中集成JavaScript SDK工具？
A: 您可以通过npm安装SDK，然后在项目中按照文档提供的示例代码进行集成。

### Q4: JavaScript SDK工具的调用限制是什么？
A: 免费版SDK每月有免费调用次数限制，付费版则无限制。具体限制请参考官方文档。

### Q5: 如何处理JavaScript SDK工具返回的错误？
A: SDK返回的错误信息包含了详细的错误描述，您可以根据错误描述进行相应的处理。

## 诊断与修复
| 错误现象 | 可能原因 | 诊断步骤 | 解决方案 |
| --- | --- | --- | --- |
| 调用失败 | API密钥错误 | 检查API密钥是否正确 | 重新获取API密钥 |
| 处理结果错误 | 模型参数错误 | 检查模型参数是否正确 | 修正模型参数 |
| 请求超时 | 网络问题 | 检查网络连接是否正常 | 确保网络连接正常 |
| 服务器错误 | 服务器问题 | 检查服务器状态 | 联系客服或等待服务器恢复 |

## 安全要求
1. 使用安全的API密钥，避免泄露。
2. 对输入数据进行验证，防止注入攻击。
3. 定期更新SDK，以修复已知的安全漏洞。
4. 使用HTTPS协议进行数据传输，确保数据安全。
5. 限制API调用频率，防止滥用。

### 安全风险防范

| 风险项 | 等级 | 防护措施 | 验证方法 |
| --- | --- | --- | --- |
| API密钥泄露 | 高 | 通过环境变量配置，禁止硬编码 | 定期检查代码和配置文件 |
| 命令执行风险 | 高 | 仅执行白名单命令，避免拼接用户输入 | 使用沙箱环境测试 |
| 网络通信安全 | 中 | 使用HTTPS协议，验证SSL证书 | 定期检查证书有效期 |
| 敏感数据暴露 | 高 | 输出结果中不包含密钥、令牌等敏感信息 | 日志脱敏审查 |
| 未授权访问 | 中 | 限制访问权限，实施认证机制 | 定期审计访问日志 |

## 功能清单
- **自动化执行**: inference.sh的JS/TS SDK,跑AI应用/建Agent/集成150+模型。JavaScript/Type
- **文件处理**: 支持多种文件格式的读取、解析和写入操作
- **API集成**: 通过标准化接口调用外部服务并处理响应
- **命令执行**: 在安全沙箱中执行系统命令并收集结果

JavaScript SDK工具

Install

Javascript Sdk

专业版专属特性

能力矩阵

快速掌握

适用范围

操作步骤

输入参数

输出规范

异常应对

前置条件

运行环境

依赖说明(补充)

API Key 配置

可用性分类

案例展示

示例1：基础用法

请参考上方使用说明进行配置和调用

请参考上方使用说明进行配置和调用

Related skills