# @ankhorage/orchestrator 中文文档

规范地址：https://npmcn.com/package/%40ankhorage/orchestrator/

版本：0\.4\.6
npm 元数据更新时间：2026-10-29T15:05:45.383Z
中文译文更新时间：2026-11-06T05:10:39.402Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：122 kB，99 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- 首次发布：2026-04-22T15:01:08.281Z
- 最新版本发布：2026-10-29T15:05:44.836Z
- 近 30 天下载量：10214（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：20（近 12 个月 20 个）

## 中文简介

用于确定性Ankhorage项目模块的无头生命周期引擎.

## 安装

```sh
npm install @ankhorage/orchestrator
```

也可以使用：`pnpm add @ankhorage/orchestrator`、`yarn add @ankhorage/orchestrator`、`bun add @ankhorage/orchestrator`

## README

# 乐团

用于决定性项目模块的独立无头生命周期引擎.

## 特征

-   依赖意识的安装和清除
-   canonial 分类账后安装的状态和配置
-   已登记/已安装/独立查询
-   明确重组,在失败时恢复原状态
-   无工作室、 ZORA、 React 或平台 UI 依赖

## 安装

```bash
bun add @ankhorage/orchestrator
```

## 使用量

```ts
import { createOrchestrator, defineModule } from '@ankhorage/orchestrator';

const exampleModule = defineModule({
  id: 'example',
  version: '1.0.0',
  plan: ({ config }) => [
    {
      type: 'write-files',
      files: [
        {
          path: 'src/modules/example/config.json',
          content: `${JSON.stringify(config, null, 2)}\n`,
          overwrite: true,
        },
      ],
    },
  ],
});

const orchestrator = createOrchestrator({
  modules: [exampleModule],
  projectRoot: '/path/to/project',
});

await orchestrator.installModule('example', {
  config: { enabled: true },
});

await orchestrator.reconfigureModule('example', {
  config: { enabled: false },
});

const modules = await orchestrator.listModules();
const example = await orchestrator.getModule('example');

await orchestrator.removeModule('example');
```

`listModules()` 包括注册模块和安装的分类账条目,其模块包 目前无法使用。 登记依赖和已安装的依赖状态已返回 因此,主机可以解释寿命周期限制,而不从生成的文件推断出这些限制.

通话 `installModule()` 对于已安装的模块来说,这是一个错误。 配置更改使用 明确 `reconfigureModule()` 操作,更新cononical分类账和模块所有 产出一起。 如果配置失败, 先前安装所触碰的文件会被恢复 从重组前的准确内容 自安装以来进行的编辑.

## 常见问题

### @ankhorage/orchestrator 是什么？

用于确定性Ankhorage项目模块的无头生命周期引擎\.

### 如何安装 @ankhorage/orchestrator？

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

### @ankhorage/orchestrator 支持 TypeScript 吗？

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

### @ankhorage/orchestrator 支持 ESM 还是 CommonJS？

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

### @ankhorage/orchestrator 可以商用吗？

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

### @ankhorage/orchestrator 的下载量有多少？

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

### @ankhorage/orchestrator 还在维护吗？

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