# @abyssinia-labs/sokie 中文文档

规范地址：https://npmcn.com/package/%40abyssinia-labs/sokie/

版本：0\.10\.1
npm 元数据更新时间：2026-11-11T00:58:54.106Z
中文译文更新时间：2026-11-11T01:00:51.755Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40abyssinia-labs/sokie
原文对照：https://npmcn.com/package/%40abyssinia-labs/sokie/?lang=original
项目主页：https://sokie.sh/docs/cli

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

- 包体积（解压后）：3.5 MB，12 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：1 个
- 首次发布：2026-10-21T17:50:27.104Z
- 最新版本发布：2026-11-11T00:58:53.919Z
- 近 30 天下载量：8495（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：68（近 12 个月 68 个）

## 中文简介

将 OpenAPI 或 Swagger spec 转换成 MCP 服务器,运行在您的机器上,并部署到 Sokie. 苏克命令(别名sok).

## 安装

```sh
npm install @abyssinia-labs/sokie
```

也可以使用：`pnpm add @abyssinia-labs/sokie`、`yarn add @abyssinia-labs/sokie`、`bun add @abyssinia-labs/sokie`

## README

# 苏克

命令行为 [苏琪](https://sokie.sh/)。给它一个 OpenAPI 或 Swagger 光谱和每个端点都成为 MCP 服务器上的打入工具: 在您上运行 然后部署在自己的地址上 `<slug>.sokie.cloud/mcp`时 claude.ai, ChatGPT, Cursor, Claude Code 和 VS Code 都可以称之为.

```bash
npm i -g @abyssinia-labs/sokie
```

你需要22号节点或晚点 此安装 `sokie`,以及 `sok` 作为简短的别名.

## 从 spec 到活服务器

```bash
sokie login
sokie init https://petstore3.swagger.io/api/v3/openapi.json petstore
cd petstore
sokie dev
sokie deploy --create
```

-   `sokie login` 打开浏览器来签名。 同一页 做你的账户。 在SSH的机器上,添加 `--no-browser`。 。 。 .
-   `sokie init` 从文件或 URL 读取 OpenAPI 3 或 Swagger 2 spec,以及 写入服务器 : `sokie.json`中,每个字段的复制件,以及一个Markdown文件 工具输入 `tools/`。这些文件是整个服务器,没有生成代码到 维持。 当API拿钥匙时 它会找你的 `sokie dev`,以及 留着吧 `.sokie/dev.env`却忽略了.
-   `sokie dev` 运行在相同的运行时间 部署用途,有一个检查员 调用每个工具,并重装每个保存.
-   `sokie deploy --create` 现场直播并打印地址 在第一个之后 时间, `sokie deploy` 够了.

这个 [快速启动](https://sokie.sh/docs/quickstart) 穿过它,包括 和连接claude.ai.

## 图标

| 命令 | 它会做什么 |
| --- | --- |
| `init` | 从 OpenAPI 或 Swagger 光谱启动服务器 . |
| `check` | 检查服务器的部署方式 不部署. |
| `tools` | 列出工具,或显示其效果和结果. |
| `skills` | 列出职业技能 `skills/`或安装服务器的. |
| `call` | 调用一个工具作为代理 `sokie dev` 或部署. |
| `test` | 运行案件 `tests/` 打开 `sokie dev` 或部署. |
| `fmt` | 写入 `sokie.json` 索克写它的方法之一. |
| `dev` | 在实时运行时在本地运行服务器, 在每次编辑时重新加载 . |
| `edit` | 在编辑器中打开服务器文件, 使用 `sokie dev` 运行中. |
| `pull` | 把文件夹从 `sokie edit` 最新生产. |
| `login`, (中文(简体) ), `logout`, (中文(简体) ), `whoami` | 签名这台电脑进出, 或显示是谁的签名. |
| `workspace` | 显示、列出或选择工作空间命令. |
| `deploy` | 部署服务器 等它启动. |
| `deploys` | 列出服务器的部署, 比较两个, 或者恢复一个更早的 . |
| `link` | 从其 GitHub 仓库部署服务器 . |
| `secrets` | 列出、设置或删除服务器的秘密 . |
| `keys` | 为CI,脚本和代理制作,列出并撤销API密钥. |
| `domains` | 在您自己的域中服务您的服务器: 一个用于工作空间, 或者每个服务器一个 . |
| `requests` | 问主人或管理者 改变什么是他们的, 或回答成员问什么. |
| `logs` | 显示服务器的电话, 早在你的计划保持它们. |
| `audit` | 显示谁改变了你的工作空间 . |
| `config` | 显示或缩短 CLI 登录时间 . |
| `update` | 安装最新的 `sokie`,这个装置的方式. |

每个命令都用 `--help`,以及 `--json` 当脚本读取其输出时. 跟Sokie说话的指令 `--site <url>` (或 `SOKIE_SITE`用于场地 除了sokie.sh之外,别这样 这个 [CLI 参考](https://sokie.sh/docs/cli) 列表中 选项.

## 工作空间

服务器,密钥,域和审计线索属于工作区. 图标 在默认的操作中工作, 您上次打开的工作空间 。 嘘,除非 您选择另一个:

```bash
sokie workspace list          # the workspaces you're in
sokie workspace use acme      # work in sokie.sh/acme from now on
sokie deploy --create --workspace acme   # or for one command
```

`SOKIE_WORKSPACE=acme` 与 `--workspace` 每次命令运行 与它设定, 这适合CI. `sokie workspace` 显示正在使用的那个,为什么, 财务报告和审定财务报表 `sokie workspace use --clear` 回到默认值.

删除服务器, 公开服务器, 并带走用户的地址 是给业主和管理人员的。 一个成员问, 任何一个人拥有或管理 答案 :

```bash
sokie requests ask delete billing-v2 --reason "Replaced by billing-v3"
sokie requests                    # what waits for your answer, and what you asked
sokie requests approve kd7a3f9c   # or decline, with --note
```

拥有者或管理员也可以让服务器的制作部署等待一个 他们。 必须等待的部署如下: `sokie deploy` 停下来 说为什么,它只服务于团队, 在自己的地址上签字 7天后结束 它的列表 `sokie requests` 由业主或管理人员批准, 让它活下来:

```bash
sokie call getInvoice --held 12   # try held deploy 12 before anyone approves it
sokie deploys                     # held shows as waiting for an admin
```

## 链接

-   [文档](https://sokie.sh/docs)
-   [更改日志](https://sokie.sh/changelog)
-   问题和错误 : [哈啰 @ sokie.sh](mailto:hello@sokie.sh)

## 许可证

阿帕奇-2.0:见 `LICENSE` 财务报告和审定财务报表 `NOTICE` 此软件包中的文件。 国家行动倡议 装有许可证的第三方包裹 `dist/THIRD-PARTY-NOTICES.txt`。 。 。 . 使用sokie.sh的主机服务由它负责 [术语](https://sokie.sh/terms)。 。 。 .

## 常见问题

### @abyssinia-labs/sokie 是什么？

将 OpenAPI 或 Swagger spec 转换成 MCP 服务器,运行在您的机器上,并部署到 Sokie\. 苏克命令\(别名sok\)\.

### 如何安装 @abyssinia-labs/sokie？

在项目目录运行 npm install @abyssinia-labs/sokie，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 sok、sokie，可以用 npx sok 直接运行。

### @abyssinia-labs/sokie 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/abyssinia-labs\_\_sokie 是否存在。

### @abyssinia-labs/sokie 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @abyssinia-labs/sokie 需要什么版本的 Node\.js？

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

### @abyssinia-labs/sokie 可以商用吗？

@abyssinia-labs/sokie 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @abyssinia-labs/sokie 的下载量有多少？

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

### @abyssinia-labs/sokie 还在维护吗？

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