# @computesdk/tenki 中文文档

规范地址：https://npmcn.com/package/%40computesdk/tenki/

版本：0\.1\.22
npm 元数据更新时间：2026-11-06T13:41:48.437Z
中文译文更新时间：2026-11-10T14:28:20.587Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40computesdk/tenki
原文对照：https://npmcn.com/package/%40computesdk/tenki/?lang=original
项目主页：https://tenki.cloud/
源码仓库：https://github.com/computesdk/computesdk

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：96.8 kB，9 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：3 个
- 首次发布：2026-07-01T13:41:43.931Z
- 最新版本发布：2026-11-06T13:41:48.042Z
- 近 30 天下载量：9622（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 22 个）

## 中文简介

计算SDK的 Tenki Cloud 供应商 - 有本地文件系统、 预览 URL、快照和 SSH 的微VM 沙盒

## 安装

```sh
npm install @computesdk/tenki
```

也可以使用：`pnpm add @computesdk/tenki`、`yarn add @computesdk/tenki`、`bun add @computesdk/tenki`

## README

# @ computesdk/ tenki (帮助)

[腾基云](https://tenki.cloud/) computeSDK的提供商 - 在有本地文件系统操作的快微VM沙盒中运行代码,公共预览URL,快照,卷,和SSH.

## 安装

```bash
npm install @computesdk/tenki
```

需要Node.js 20或后期(Tenki SDK的gRPC运输依赖于它).

## 设置

1.  报名到 [app.tenki.cloud (英语)](https://app.tenki.cloud/)
2.  在工作空间设置中创建 API 密钥
3.  设定为环境变量:

```bash
export TENKI_API_KEY=tk_your_api_key
```

## 使用量

### 使用计算SDK

```typescript
import { compute } from 'computesdk';
import { tenki } from '@computesdk/tenki';

compute.setConfig({ provider: tenki({ apiKey: process.env.TENKI_API_KEY }) });

const sandbox = await compute.instances.create();

const result = await sandbox.runCommand('echo "Hello from Tenki!"');
console.log(result.stdout);

await sandbox.destroy();
```

### 文件系统操作

Tenki 在其数据平面上暴露出本土文件原始, 因此文件系统操作不会通过 shell 命令( 没有逃脱危险, 使用任何路径或内容的工作) :

```typescript
await sandbox.filesystem.writeFile('/home/tenki/app.py', 'print("hi")');
const content = await sandbox.filesystem.readFile('/home/tenki/app.py');
const entries = await sandbox.filesystem.readdir('/home/tenki');
await sandbox.filesystem.mkdir('/home/tenki/data');
const exists = await sandbox.filesystem.exists('/home/tenki/app.py');
await sandbox.filesystem.remove('/home/tenki/app.py');
```

### 公开预览 URL

```typescript
// Start a server (background commands are detached automatically)
await sandbox.runCommand('python3 -m http.server 3000', { background: true });

// Expose the port at a public URL
const url = await sandbox.getUrl({ port: 3000 });
// => https://<slug>.sb.tenki.sh
```

## 配置

| 选项 | 新闻 var | 默认 | 说明 |
| --- | --- | --- | --- |
| `apiKey` | `TENKI_API_KEY` 编号 : `TENKI_AUTH_TOKEN` | 所需经费 | Tenki API 密钥 (`tk_...`(中文(简体) ) |
| `baseUrl` | `TENKI_API_URL` | `https://api.tenki.cloud` | API 终点 |
| `workspaceId` | `TENKI_WORKSPACE_ID` | 从工作空间 API 密钥推断 | 信任服务证书的明确工作空间 |
| `projectId` | \- 说吧 | 忽略 | 折旧;Tenki不再按项目标出沙箱 |
| `timeout` | \- 说吧 | 无 | 默认 `runCommand` 超时( 毫秒) |
| `cpuCores` 编号 : `memoryMb` 编号 : `diskSizeGb` | \- 说吧 | Tenki 默认 | 默认沙盒资源 |

工作空间 API 键推断他们的工作空间服务器侧. 设定 `workspaceId`,或 `TENKI_WORKSPACE_ID`,只有当使用需要明确范围的可信服务证书时.

单相框资源覆盖被接受于 `create`数字 :

```typescript
await compute.instances.create({ cpuCores: 4, memoryMb: 8192 });
```

## 特性支持

| 特性 | 支助 |
| --- | --- |
| 图标( E)`runCommand`(中文(简体) ) | 是的 - 通过 `sh -lc`所以管子,花纹, 和管道扩展工作 |
| 文件系统 | 是 - 本地数据平面文件 API |
| 公共 URL (英语:`getUrl`(中文(简体) ) | 是 - 每端预览 URL |
| 列表 / 获取ById / 销毁 | 对 |
| 背景命令 | 对.. `{ background: true }` 自动解析 stdio |
| 自定义图像 | Via Tenki 模板(`templateId` 地图到 Tenki 图像参考) |
| 暂停/ 恢复 | 对.. `sandbox.pause()` 编号 : `sandbox.resume()`; 内存、进程和文件(包括 `/tmp`(活下来) |
| 抓图 | 对.. `compute.snapshot.create(id)`,用 `create({ snapshotId })`; 保存 rootf 的内存快照 `/tmp` (源头也空了)源头不停地运行 |

## 页:1

-   `runCommand` 将命令包入 `sh -lc` 因为 Tenki 的执行直接运行 argv(执行,无外壳).
-   一个长期的过程从一个裸体开始 `&` 使执行输出流打开; 使用 `{ background: true }`为你解开口.
-   对于高级特性(SSH,地道,git操作),直接通过基础SDK `sandbox.getInstance()`,返回 `@tenkicloud/sandbox` `Session`。 。 。 .

## 许可证

麻省理工学院

## 常见问题

### @computesdk/tenki 是什么？

计算SDK的 Tenki Cloud 供应商 - 有本地文件系统、 预览 URL、快照和 SSH 的微VM 沙盒

### 如何安装 @computesdk/tenki？

在项目目录运行 npm install @computesdk/tenki，或使用 pnpm add / yarn add / bun add。

### @computesdk/tenki 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @computesdk/tenki 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @computesdk/tenki 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @computesdk/tenki 可以商用吗？

@computesdk/tenki 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @computesdk/tenki 的下载量有多少？

根据 npm 官方下载统计，@computesdk/tenki 在 2026/10/11 – 2026/11/09 这 30 天内被下载 9,622 次，日均约 321 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @computesdk/tenki 还在维护吗？

最新版本 0\.1\.22 发布于 2026/11/06（4 天前）；至今共发布 22 个版本，其中过去 12 个月发布了 22 个；首次发布于 2026/07/01。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。