# @dexto/agent-config 中文文档

规范地址：https://npmcn.com/package/%40dexto/agent-config/

版本：1\.17\.0
npm 元数据更新时间：2026-11-09T21:21:42.645Z
中文译文更新时间：2026-11-12T05:00:47.932Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40dexto/agent-config
原文对照：https://npmcn.com/package/%40dexto/agent-config/?lang=original

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

- 包体积（解压后）：131 kB，55 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：3 个
- peer 依赖：zod ^4\.3\.6
- 首次发布：2026-02-18T11:03:47.847Z
- 最新版本发布：2026-11-09T21:21:42.470Z
- 近 30 天下载量：18246（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：85（近 12 个月 85 个）

## 中文简介

Schema + 解析器工具,用于利用图像将一个代理 YAML 配置变成混凝土 DI 表面.

## 安装

```sh
npm install @dexto/agent-config
```

也可以使用：`pnpm add @dexto/agent-config`、`yarn add @dexto/agent-config`、`bun add @dexto/agent-config`

## README

# `@dexto/agent-config`

Schema + 解析器工具,用于利用图像将一个代理 YAML 配置变成混凝土 DI 表面.

这个软件包是 **产品级胶水**页:1`@dexto/core`保持对DI的友好,以及主机(CLI/服务器/应用程序) 使用情况 `@dexto/agent-config` 改为:

-   验证代理配置( v)`AgentConfigSchema`(中文(简体) )
-   装入图像模块( e)`loadImage()`(中文(简体) )
-   将图像默认值合并为原始配置( n)`applyImageDefaults()`(中文(简体) )
-   将图像工厂溶入混凝土仓库、工作空间把手、技能、工具、钩子和记录器 实例`resolveServicesFromConfig()`(中文(简体) )
-   将结果转换为 `DextoAgentOptions` (单位:千美元)`toDextoAgentOptions()`(中文(简体) )

## 快速实例( apps)

```ts
import { DextoAgent } from '@dexto/core';
import { loadAgentConfig } from '@dexto/agent-management';
import {
  AgentConfigSchema,
  applyImageDefaults,
  loadImage,
  resolveServicesFromConfig,
  setImageImporter,
  toDextoAgentOptions,
} from '@dexto/agent-config';

// Under pnpm (strict dependency boundaries), configure image importing at the host entrypoint.
setImageImporter((specifier) => import(specifier));

const raw = await loadAgentConfig('./agents/my-agent.yml');
const image = await loadImage(raw.image ?? '@dexto/image-local');
const merged = applyImageDefaults(raw, image.defaults);

const config = AgentConfigSchema.parse(merged);
const services = await resolveServicesFromConfig(config, image);

const agent = new DextoAgent(toDextoAgentOptions({ config, services }));
await agent.start();
```

## 输入的主机上下文

主机运行时间可以通过图像解析对一个被键入的主机上下文进行线程,而无需烘焙 平台特定字段进入上游软件包.

```ts
import type { DextoHostContext, DextoImage } from '@dexto/agent-config';

type CloudHostContext = DextoHostContext<
  {
    dextoCloudflare: {
      runtimeContext: {
        sessionId: string;
      };
    };
  },
  {
    workspace: boolean;
  }
>;

declare const image: DextoImage<CloudHostContext>;
declare const hostContext: CloudHostContext;

const services = await resolveServicesFromConfig(config, image, hostContext);
const options = toDextoAgentOptions({ config, services, image, hostContext });
```

## 图像( 无登记册)

图像是打入的模块(`DextoImage`出口平地工厂表面. 工具/ hook/compaction 解析仍然使用配置属性访问 `type` (例如, `image.tools[entry.type]`) (中文(简体) ). 存储由图像作为一体解决 `createStores(config.storage, ...)` 调用, 这样图像可以编译或直接执行 `DextoStores` 而不暴露下层后端构造细节. 没有全球 登记或副作用.

图像还可提供:

-   `workspace.create(...)`: 返回 a `WorkspaceHandleProvider`。本地图像通常返回本地 文件系统控件; 主机图像可以返回由自身工作空间运行时间支持的控件.
-   `skills.create(...)`: 返回一个 `Skills` 执行费用 `DextoAgent`技能停留 出自即时配置; 仍只使用即时配置 .

## 常见问题

### @dexto/agent-config 是什么？

Schema \+ 解析器工具,用于利用图像将一个代理 YAML 配置变成混凝土 DI 表面\.

### 如何安装 @dexto/agent-config？

在项目目录运行 npm install @dexto/agent-config，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：zod（^4\.3\.6）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @dexto/agent-config 支持 TypeScript 吗？

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

### @dexto/agent-config 支持 ESM 还是 CommonJS？

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

### @dexto/agent-config 可以商用吗？

@dexto/agent-config 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @dexto/agent-config 的下载量有多少？

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

### @dexto/agent-config 还在维护吗？

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