# @ai-agent-forge/plugin-alignment 中文文档

规范地址：https://npmcn.com/package/%40ai-agent-forge/plugin-alignment/

版本：0\.88\.28
npm 元数据更新时间：2026-11-02T00:58:11.345Z
中文译文更新时间：2026-11-06T07:02:53.883Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：711 kB，40 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.19\.0
- 运行依赖：2 个
- 首次发布：2026-10-04T07:34:21.958Z
- 最新版本发布：2026-11-02T00:58:11.148Z
- 近 30 天下载量：4230（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：27（近 12 个月 27 个）

## 中文简介

Agent Forge 的对齐能力插件( 三步要求与 HTML 确认页对齐的漏斗)

## 安装

```sh
npm install @ai-agent-forge/plugin-alignment
```

也可以使用：`pnpm add @ai-agent-forge/plugin-alignment`、`yarn add @ai-agent-forge/plugin-alignment`、`bun add @ai-agent-forge/plugin-alignment`

## README

# @ agent-forge/ 插件对齐

Agent Forge 的要求校正能力插件: 三步 对齐漏斗( e)**目标-细节-设计**) 有块级 在本地 HTML 页面上确认双向反馈, 输入图层 附有用户核准的基线.

-   设计合同(授权): `docs/design/需求对齐插件设计.md`
-   位置: 上游质量门 `plan` - 不是替补 这个 目标/计划/待办事项层未受影响;完成的基准被消耗 通过共享会话录入协议.

## 工具

| 工具 | 目的 |
| --- | --- |
| `alignment_set` | 创建/ 更新活动步骤的完整块集 。 未更改的块通过内容指纹继承用户批准;注释仅为附加(用户文本活后再逐字更新). |
| `alignment_round` | 打开本地确认页( N)`127.0.0.1`,随机符号路径)并返回其URL加进度事实。 非阻断:反馈稍后作为 `alignment.feedback` 会议信息. |
| `alignment_advance` | `inspect` (状况/出入口/基线), `retreat` (倒回更早的一步,重置下游确认), `cancel`。 。 。 . |

命令 : `/alignment` • 妇女 `/alignment why` • 妇女 `/alignment log [N]`。 。 。 .

## 持久性协议

结构上与目标/计划/待办/工作流程插件完全相同:仅附件 `alignment.state` 完整快照加一张 `alignment.transition` 审计条目 每个转换,宣布为 `alignment.changed`。 。 。 .

## 页:1

-   需要一个显示 `SessionAPI.sendMessage` (反馈) 注射;没有 `alignment_round` 失败——其余 表面仍然可以使用.
-   完成后, 引擎会写一个只读基线快照给 `<workspace>/alignments/<id>.md` (图像生成工作空间产品) 页:1.
-   只决定测试( 假能力API + 真实) `node:http` 一个 OS指定端口;没有真正的模型调用.

## 常见问题

### @ai-agent-forge/plugin-alignment 是什么？

Agent Forge 的对齐能力插件\( 三步要求与 HTML 确认页对齐的漏斗\)

### 如何安装 @ai-agent-forge/plugin-alignment？

在项目目录运行 npm install @ai-agent-forge/plugin-alignment，或使用 pnpm add / yarn add / bun add。

### @ai-agent-forge/plugin-alignment 支持 TypeScript 吗？

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

### @ai-agent-forge/plugin-alignment 支持 ESM 还是 CommonJS？

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

### @ai-agent-forge/plugin-alignment 需要什么版本的 Node\.js？

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

### @ai-agent-forge/plugin-alignment 可以商用吗？

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

### @ai-agent-forge/plugin-alignment 的下载量有多少？

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

### @ai-agent-forge/plugin-alignment 还在维护吗？

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