# @flexkit/studio 中文文档

规范地址：https://npmcn.com/package/%40flexkit/studio/

版本：0\.2\.44
npm 元数据更新时间：2026-11-14T23:40:23.962Z
中文译文更新时间：2026-11-14T22:39:35.071Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40flexkit/studio
原文对照：https://npmcn.com/package/%40flexkit/studio/?lang=original
项目主页：https://github.com/flexkit-io/flexkit#readme
源码仓库：https://github.com/flexkit-io/flexkit

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

- 包体积（解压后）：4.6 MB，159 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.9\.0
- 运行依赖：91 个
- peer 依赖：react ^19\.0\.0，react-dom ^19\.0\.0
- 首次发布：2025-11-28T10:15:46.926Z
- 最新版本发布：2026-11-14T23:40:23.622Z
- 近 30 天下载量：7041（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：82（近 12 个月 82 个）

## 中文简介

Flexkit Studio - Flexkit的回放工作空间,电子商务的AI操作系统:连接的商业数据,上下文,自动化和代理

## 安装

```sh
npm install @flexkit/studio
```

也可以使用：`pnpm add @flexkit/studio`、`yarn add @flexkit/studio`、`bun add @flexkit/studio`

## README

[![Flexkit logo](https://flexkit.io/public/logos/icon-light-background.png)](https://flexkit.io/)

# 缩写

[![NPM version](https://img.shields.io/npm/v/%40flexkit%2Fstudio?style=for-the-badge&labelColor=%23000000&color=%232563eb)](https://www.npmjs.com/package/@flexkit/studio) [![License](https://img.shields.io/npm/l/%40flexkit%2Fstudio?style=for-the-badge&labelColor=%23000000&color=%230ccf6a)](https://github.com/flexkit-io/flexkit/blob/main/LICENSE) [![Join the community on GitHub](https://img.shields.io/badge/Join%20the%20comunity-blue.svg?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyBmaWxsPSJub25lIiB2aWV3Qm94PSIwIDAgNDggNDgiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+PHBhdGggZD0iTTcgOEg0MVY0MEg3VjhaIiBmaWxsPSIjMDIwODE3Ij48L3BhdGg+PHBhdGggZD0iTTI0IDBDNDIgMCA0OCA2IDQ4IDI0QzQ4IDQyIDQyIDQ4IDI0IDQ4QzYgNDggMCA0MiAwIDI0QzAgNiA2IDAgMjQgMFpNMTcuNzQ5NCA5LjUyMzgxSDguNzYxOUwxOS4yODMzIDIzLjgzMTNMOC43NjE5IDM4LjcwNzhIMTcuNzQ5NEwyMS4wNDk5IDMzLjY2MzlWMTQuMjU0OUwxNy43NDk0IDkuNTIzODFaTTM4Ljk1NzcgOS41MjM4MUgyOS45NTQyTDI2LjI4NTcgMTQuODIyOVYzMy4wNDA2TDI5Ljk1NDIgMzguNzA3OEgzOC45NTc3TDI4LjM5MDggMjMuODMxM0wzOC45NTc3IDkuNTIzODFaIiBmaWxsPSJ3aGl0ZSI+PC9wYXRoPjwvc3ZnPg==&labelColor=%23000000)](https://github.com/orgs/flexkit-io/discussions)

**电子商务AI操作系统.**

您的数据,上下文,工作流程和代理在一个系统中。 Flexkit连接了您已经使用的工具,学习了您的商店是如何工作的,全天候运行,并随着每个结果变得更聪明.

此寄存器持有 Flexkit 的开源部分: **工作室** (在自己的应用程序内可以挂载) **国 际** 编辑 **SDK 软件** 用于定义您的数据模型和您自己的代理工具。 他们是麻省理工的执照。 数据后端和代理机由Flexkit托管.

[网站](https://flexkit.io/) • 妇女 [文档](https://flexkit.io/docs) • 妇女 [讨论情况](https://github.com/orgs/flexkit-io/discussions)

## 一个系统,六层

Flexkit持有你的商业数据 和周围的背景。 它为每一项任务选择了正确的模型,并跨出你已经使用的工具进行代理. 你的团队设定了极限.

| 层 | 它会做什么 |
| --- | --- |
| **数据** | 你的产品,订单,客户和供应商 作为链接记录, 所以代理商看到 一切联系. |
| **A. 背景情况** | 你的文件,书面规则和过去的决定, 所以特工们引用他们的消息来源 和你的团队一样工作. |
| **模型** | 来自OpenAI,Anthropic,Google和xAI的模型. Flexkit为每项任务选择一个,或者你自己选择一个. |
| **探员** | 在时间表或触发器上运行的自动化, 在更改您不允许的内容之前先询问 . |
| **连接** | 从Shopify和Frede到Slack和Google工作空间的插件,加上克劳德,ChatGPT和任何MCP客户端的访问. |
| **控制权** | 角色设定了每个人所能做的事情,空格设定了他们所能看到的,每跑一跑都会留下一份笔录来阅读. |

## 你得到的东西

-   **你的业务,连接.** Flexkit将您的业务作为您所选择的记录(产品,订单,客户,供应商等)的图表存储,它们之间的关系作为一等数据. 一个特工通过走那个图表来回答,从低库存的警报到它影响到可以再充电的供应商的开放订单.
-   **保持你的系统,连接他们的数据.** 你的店,ERP和CRM都留在原地 通过其 GraphQL API 或插件同步 Flexkit 的要紧事项, Flexkit 将其链接到一个记录中 .
-   **它学习你的生意如何运作.** 投放供应商PDF,退货政策和价格清单,代理商读取并引用了段落. 把你的规则写成技能 每一次聊天和自动化都遵循 团队一直达成一致 成为共享记忆.
-   **问什么,得到一个真正的答案.** 代理从您自己的记录中回答,每次查询直播数据. 它绘制结果图,将其导出为文件,并在批准后更改记录. 当它需要一个决定时, 它问而不是猜测.
-   **昼夜经营你的生意.** 任何你两次要求的都可以自己运行:每天早晨,当订单到来,当股票下降,或者当另一个系统发出信号时. 结果归Slack或Teams, 改变你不允许等待是.
-   **每份工作都有合适的模式.** 一个快速的模型来寻找, 一个更强大的一个长期。 自己选择一个模型来进行任何聊天或自动化,然后把一天换成更好的一艘船.
-   **你的团队继续掌控.** 5个内置角色表示某人可以做什么. 空间说出他们可能看到的东西,下到一个单字段,同样的规则在表格,聊天,自动化,API和AI客户端中都有.

周围的一切:

-   **描述你的生意,获得一个数据模型.** 代理商提出记录类型和它们之间的联系;除非您批准,否则不会改变.
-   **每个市场都有记录.** 保留每个市场或语言的价格,名称或描述,默认后退.
-   **一一一一一一千记录.** 重定价一个收藏或重置一个季节。 Flexkit 计算什么会先改变, 一旦你批准,在背景中运行.
-   **你可以发送报告.** 询问报告并获得一个页面或一个PDF,并带有一个持续工作的链接.
-   **输入,说或附.** 写出一个问题,或者写入照片,电子表格或供应商的PDF,并询问里面有什么.

## 在你已经工作的地方工作

Flexkit在浏览器中运行,作为macOS和Windows的桌面应用,在您自己的React应用中运行,在Claude,ChatGPT,Cursor或任何MCP客户端内部运行(与您Flexkit账户签约,并应用您的角色和空间).

插件连接到 **Shopify, Slack, 微软团队, 名称, 条纹** (审查), **谷歌工作空间** (审查), **轴** 财务报告和审定财务报表 **小鸟**,因此代理可以读取和在您的团队已经使用的工具中行动. 开发者可以从代码中添加自己的工具.

## 对于开发者

-   **代码中的数据模型.** 定义它 `flexkit.config.ts` 并把它从终端.
-   **一个图表QL API的一切,** 从您的数据模型中生成.
-   **你自己的工具在探员后面.** 从您的应用程序中曝光服务器侧功能作为工具和代码技能.
-   **国家行动倡议** 用于记录,查询,自动化,技能,知识,插件,日志,符等. 见 [CLI 读取](https://github.com/flexkit-io/flexkit/tree/main/packages/cli)。 。 。 .

### 软件包

| 软件包 | 说明 |
| --- | --- |
| [`@flexkit/studio`](https://github.com/flexkit-io/flexkit/tree/main/packages/flexkit-studio) | 工作室:表格,记录编辑,聊天,自动化和其余的工作空间作为反应组件. |
| [`@flexkit/schema`](https://github.com/flexkit-io/flexkit/tree/main/packages/schema) | `defineConfig` 编号 : `defineEntity` 和转动的序列器 `flexkit.config.ts` 进入可部署计划. |
| [`@flexkit/tools`](https://github.com/flexkit-io/flexkit/tree/main/packages/tools) | 从自己的服务器定义、服务和运行自定义工具和代码技能. |
| [`@flexkit/cli`](https://github.com/flexkit-io/flexkit/tree/main/packages/cli) | 这个 `flexkit` 命令行界面. |
| [`@flexkit/agent-protocol`](https://github.com/flexkit-io/flexkit/tree/main/packages/agent-protocol) | 代理平台和工作室UI共享的Schemas和类型. |

这个 [`apps`](https://github.com/flexkit-io/flexkit/tree/main/apps) 文件夹有桌面应用程序、主机工作室和Next.js、Astro和TanStack Start等主机应用程序.

## 开始

访问 [flexkit.io/ 文档](https://flexkit.io/docs) 用于完整文件.

```shell
npm install --global @flexkit/cli
flexkit login
flexkit link      # link this folder to a project
flexkit deploy    # deploy the schema from flexkit.config.ts
```

### 定义您的方案

`flexkit.config.ts` 是纯数据:没有反应,没有JSX. 图标是 [卢西德](https://lucide.dev/) pascalCase和校验中的图标名称是接收Zod的函数.

```ts
// flexkit.config.ts
import { defineConfig, defineEntity } from '@flexkit/schema';

const products = defineEntity({
  name: 'product',
  plural: 'products',
  display: 'name',
  menu: { label: 'Products', group: 'catalog', icon: 'Tag' },
  attributes: [
    {
      name: 'name',
      label: 'Name',
      scope: 'local',
      dataType: 'string',
      inputType: 'text',
      searchable: true,
      validation: (z) => z.string().min(1, { error: 'Name is required' }),
      defaultValue: '',
    },
    {
      name: 'stock',
      label: 'Stock',
      scope: 'global',
      dataType: 'int',
      inputType: 'number',
      validation: (z) => z.number().int().min(0),
      defaultValue: 0,
    },
  ],
});

export default defineConfig({
  projectId: 'your-project-id',
  title: 'Atlas Commerce',
  menuGroups: [{ name: 'catalog', title: 'Catalog' }],
  scopes: [{ name: 'default', label: 'Default', isDefault: true }],
  spaces: [{ code: 'mkt', label: 'Marketing' }],
  schema: [products],
});
```

### 挂载工作室

工作室使部署的策略; 运行 `flexkit deploy` 编辑后 `flexkit.config.ts`。主机应用程序从不导入配置,只通过工程代号:

```tsx
import { FlexkitStudio } from '@flexkit/studio';
import '@flexkit/studio/styles.css';

export default function Studio() {
  return <FlexkitStudio projectIds={['your-project-id']} basename="/studio" />;
}
```

`basename` 是工作室挂载的路径; 当工作室在 `/`。 。 。 .

### 添加自定义工具( 可选)

工具和代码技能让Flexkit代理称您自己的服务器端代码. 定义它们 `flexkit.tools.ts` 与 `@flexkit/tools`,从 HTTPS 路线中提供 `createToolsHandler`运行 `flexkit dev` 在发展过程中。 见 [自定义工具指南](https://flexkit.io/docs/automations/custom-tools)。 。 。 .

```ts
import { defineTool, defineTools } from '@flexkit/tools';
import { z } from 'zod';

export default defineTools({
  tools: [
    defineTool({
      name: 'ping',
      description: 'Echo a message from the app runtime.',
      input: z.object({ message: z.string() }),
      execute: async ({ message }) => ({ echo: message }),
    }),
  ],
});
```

## 安全和数据

-   商业数据由欧盟托管,从未用于培训模型.
-   连接工具的证书由AES-256-GCM加密.
-   每个拟议更改都留下批准记录,每个自动化运行一个记录,每个计划部署一个历史条目.
-   将整个项目,记录和文件导出,作为一个重新清洁输入的档案.

## 捐款

欢迎并高度赞赏对Flexkit的贡献。 然而,在你跳进它之前, 我们希望你回顾一下我们 [贡献准则](https://npmcn.com/CONTRIBUTING.md) 确保你有一个平滑的经验 帮助Flexkit.

## 报告问题

找到窃听器了吗? 有特别请求吗?

打开一个问题: • 重新确定步骤 • 预期与实际行为 • 有帮助的截图 • Schema片段(如果相关)

## 许可证

本项目根据以下规定获得许可证: **麻省理工学院许可证**。 。 。 .

见 [自由主义](https://github.com/flexkit-io/flexkit/blob/main/LICENSE) 更多信息.

* * *

## 警卫

如果你相信你在Flexkit发现了安全漏洞 我们鼓励你 **_负责地披露此事,不公开问题_**。 。 。 .

见 [警卫](https://npmcn.com/SECURITY.md) 如何报告.

## 常见问题

### @flexkit/studio 是什么？

Flexkit Studio - Flexkit的回放工作空间,电子商务的AI操作系统:连接的商业数据,上下文,自动化和代理

### 如何安装 @flexkit/studio？

在项目目录运行 npm install @flexkit/studio，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^19\.0\.0）、react-dom（^19\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @flexkit/studio 支持 TypeScript 吗？

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

### @flexkit/studio 支持 ESM 还是 CommonJS？

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

### @flexkit/studio 需要什么版本的 Node\.js？

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

### @flexkit/studio 可以商用吗？

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

### @flexkit/studio 的下载量有多少？

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

### @flexkit/studio 还在维护吗？

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