# @coreplane/switchboard 中文文档

规范地址：https://npmcn.com/package/%40coreplane/switchboard/

版本：1\.310\.0
npm 元数据更新时间：2026-10-27T04:46:22.658Z
中文译文更新时间：2026-11-10T19:03:50.739Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：32.4 MB，1104 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24
- 运行依赖：11 个
- 首次发布：2026-09-10T19:50:18.601Z
- 最新版本发布：2026-10-27T04:46:22.443Z
- 近 30 天下载量：6171（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：222（近 12 个月 222 个）

## 中文简介

在Slack中提及它, 和一个代理审查公关, 运送固定,或者回答问题—— 在你选择的模型上, 它的工具运行在你决定的地方.

## 安装

```sh
npm install @coreplane/switchboard
```

也可以使用：`pnpm add @coreplane/switchboard`、`yarn add @coreplane/switchboard`、`bun add @coreplane/switchboard`

## README

![](https://raw.githubusercontent.com/coreplanelabs/switchboard/HEAD/docs/public/logo-light.svg)

# 交换机

[![CI](https://github.com/coreplanelabs/switchboard/actions/workflows/ci.yml/badge.svg)](https://github.com/coreplanelabs/switchboard/actions/workflows/ci.yml) [![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/coreplanelabs/switchboard/badge)](https://scorecard.dev/viewer/?uri=github.com/coreplanelabs/switchboard) [![Latest release](https://img.shields.io/github/v/release/coreplanelabs/switchboard)](https://github.com/coreplanelabs/switchboard/releases/latest) [![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue)](https://github.com/coreplanelabs/switchboard/blob/HEAD/LICENSE)

在Slack中提及它, 和一个代理审查公关, 运送固定,或者回答问题—— 在你选择的模型上, 它的工具运行在你决定的地方.

![A review in a Slack thread: a plain request to look at a pull request, the card naming the agent it picked and why, then the verdict with its findings.](https://raw.githubusercontent.com/coreplanelabs/switchboard/HEAD/docs/public/slack/run.gif)

![A finished run's page on the dashboard.](https://raw.githubusercontent.com/coreplanelabs/switchboard/HEAD/docs/public/screenshots/run-page-light.png)

## 快开始

已经有团队部署了吗? [连接本地 CLI 和 MCP 客户端](https://github.com/coreplanelabs/switchboard/blob/HEAD/docs/tutorials/use-an-existing-deployment.md#connect-a-local-cli-and-mcp-client) 或用在斯莱克.

运行自己的:节点24和一个Anthropic API密钥;没有Slack.

```bash
npx @coreplane/switchboard init --organization <your GitHub org> --anthropic-key <your key>
npx @coreplane/switchboard ask "what can you do?"
```

`init` 写入 `.env` (模式600)和 `config/config.yaml` 输入 `~/.switchboard`,因此每个命令都从任何目录中运行; `ask` 通过和斯莱克相同的调度器发送请求. `curl -fsSL https://switchboard.space/install.sh | sh` 一样 `init`。要使用您的团队已经运行、运行的部署 `npx -y @coreplane/switchboard connect <host>` 换句话说.

下一个 : [开始吧](https://github.com/coreplanelabs/switchboard/blob/HEAD/docs/tutorials/get-started.md)。 。 。 .

## 如何组合起来

四个接合点:频道,提供方,执行方,特工. 每个系统都与一个以上的执行系统接口。 调度员坐在他们之间:它读取你要求的东西并选择代理,通过配置层解决模型,检查授权并运行代理循环(C[请求是如何流动的](https://github.com/coreplanelabs/switchboard/blob/HEAD/docs/explanation/how-a-request-flows.md)) (中文(简体) ).

## 你需要的东西

|  | 惠璶 | 解锁的东西 |
| --- | --- | --- |
| **需求** | 模型提供者密钥: Anthropic, 或任何可兼容 OpenAI 的端点 | 每个经纪人 |
| **为了Slack** | 一个Slack app (Socket mode: bot sorders + app-level sorders) 应用程序 : | 你工作空间里的机器人 |
| 可选 | GitHub App, 或可重瞄准的标志 | 仓库已读取; 拉动请求 |
| 可选 | 云浮账户 | 生产:机器人加上国家、居民和沙盒工人 |
| 可选 | E2B 账户 | 无 Cloudflare 的每行微频 |
| 可选 | 一个勇敢的搜索密钥( A)`BRAVE_SEARCH_API_KEY`(中文(简体) ) | 搜索研究代理 |

Off意味着机器人从不提供它 仪表板和计划从不显示它([打开和关闭特性](https://github.com/coreplanelabs/switchboard/blob/HEAD/docs/how-to/turn-features-on-and-off.md)) (中文(简体) ). 这个机器人是 `npx @coreplane/switchboard start` 在任何带有节点的机器上,或公布的图像 `ghcr.io/coreplanelabs/switchboard`。 。 。 .

## 学多点

文档 : [https://switchboard.space 页面存档备份,存于互联网档案馆 互联网档案馆](https://switchboard.space/) (单位:千美元)[`docs/`](https://github.com/coreplanelabs/switchboard/blob/HEAD/docs/README.md)· [捐款额](https://github.com/coreplanelabs/switchboard/blob/HEAD/CONTRIBUTING.md) • 妇女 [一般事务人员(其他职等)](https://github.com/coreplanelabs/switchboard/blob/HEAD/AGENTS.md) • 妇女 [警卫](https://github.com/coreplanelabs/switchboard/blob/HEAD/SECURITY.md) • 妇女 [阿帕奇 - 2.0](https://github.com/coreplanelabs/switchboard/blob/HEAD/LICENSE)。 。 。 .

更深入:对想要打字的人,有命令和指令([错误命令](https://github.com/coreplanelabs/switchboard/blob/HEAD/docs/reference/slack-commands.md)),平话不需要.

## 常见问题

### @coreplane/switchboard 是什么？

在Slack中提及它, 和一个代理审查公关, 运送固定,或者回答问题—— 在你选择的模型上, 它的工具运行在你决定的地方\.

### 如何安装 @coreplane/switchboard？

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

### @coreplane/switchboard 支持 TypeScript 吗？

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

### @coreplane/switchboard 支持 ESM 还是 CommonJS？

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

### @coreplane/switchboard 需要什么版本的 Node\.js？

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

### @coreplane/switchboard 可以商用吗？

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

### @coreplane/switchboard 的下载量有多少？

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

### @coreplane/switchboard 还在维护吗？

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