# @agent-teams/repository-mutation 中文文档

规范地址：https://npmcn.com/package/%40agent-teams/repository-mutation/

版本：0\.4\.2
npm 元数据更新时间：2026-10-25T11:29:37.747Z
中文译文更新时间：2026-11-05T19:29:17.819Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：837 kB，341 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：^24\.18\.0 \|\| ^26\.0\.0
- 运行依赖：0 个
- 首次发布：2026-09-03T23:56:34.983Z
- 最新版本发布：2026-10-25T11:29:37.389Z
- 近 30 天下载量：37231（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

封闭的,可携带的寄存器突变和精确的恢复原始.

## 安装

```sh
npm install @agent-teams/repository-mutation
```

也可以使用：`pnpm add @agent-teams/repository-mutation`、`yarn add @agent-teams/repository-mutation`、`bun add @agent-teams/repository-mutation`

## README

# 仓库突变

`@agent-teams/repository-mutation` 是该物质的零莫诺雷波依赖叶 合作寄存器操作锁定、 边框状态证据、 已关闭的已知文件 交易、准确收据和精确的人工回收.

独立的呼叫者保护共享锁和共同交易证据. 他们 不将无陪伴的工程基金会本地模式备份分类; 完整 基金会的当地模式接纳仍然是基金会的责任 组合包装.

已知文件 计划汇编 拒绝便携式案例/NC碰撞和每次碰撞 祖先/后人关系 计划文摘,日记,或文件系统效果. 路径字母表仅保留ASCII; 混合和分解的非ASCII路径都被拒绝。 有效操作命令和摘要 语义学仍为v1相容. Persisted v1 证据永远不会被重写: 正确的日记只使用准确的拥有者和内核构建恢复路径. 外国建筑不能接管、不可能、腐败或未知的历史字节 仍然是仅手工操作的变异障碍。 已知文件应用程序和回收仍未得到支持 在 Windows 上,在生效前失败;纯计划编译仍可移植.

对于有效的中断日记, 使用 `recoverKnownFileTransaction` 从 记录的拥有者和内核文物,匹配每个名称、版本和 `buildIdentity`数字 : `APPLYING` 滚回去 `COMMITTED` 完成清理。 A 类 无法接管同一版本的重建软件包。 保存记录 用于支持回收窗口的文物。 无法实现的历史计划和 未知的证据需要人工解析;没有自动桥接,重写计划, 或经授权进行清理。 失败的回收保留了日记和突变障碍.

目前 JSON Schema 的进口使用软件包 `./schemas/repository-mutation/known-file-transaction-plan/v1.schema.json` 财务报告和审定财务报表 `./schemas/repository-mutation/known-file-transaction-receipt/v1.schema.json` 出口。 他们的身份证一样 `repository-mutation/` 前缀。 两个都留着电线 版本1和协议 `agent-teams.repository-mutation.known-file/v1`; 编译器, 收件文摘,而当前交易信封(有线6版)不变. 未固定的计划和收款计划出口保留准确的基础值0.21.0 字节和协议 `foundation.replace-known-file/v1`。它们描述历史 数据,并且不能使当前编译器或日记阅读器恢复它.

只能通过 `./mutation` 内 保留准确 `@agent-teams/engineering-foundation@0.21.0` 艺术品, 相配 记录的建筑。 不可能的计划或模棱两可的部分影响仍然是手工的. 目前的公共申报和可执行出口保持不变。 计划 更正要求作者、基金会和管理下的参考资料在 协调软件包可以发布.

节点适配器也会导出 `retainMutationBarrierOnEvidence(lease)` 页:1 在常见情况下必须保留回收屏障的封闭式自有包装成分 存在或无法安全检查突变证据。 帮助者返回是否 隔离墙被保留。 它不授权变异或重新确认 物理寄存器根; 组分使用 `observeMutationState(lease)` 因为 身份检查,并保持入境政策与自己的业务.

`observeAtomicFileReplacement({ root, candidate })` 返回 a `NodeAtomicFileReplacement` 拥有物理根、母体和 临时观测,而不暴露观测特性原始。 内容 调用者获得寄存器-root租赁,创建和验证安全的父母, 并进行初步的录入. `bindParent`, (中文(简体) ), `prepare`, (中文(简体) ), `assertCurrent`, (中文(简体) ), `replace` 财务报告和审定财务报表 `cleanup` 用这个节点适配器保持物理观测. 准备创建一个拥有独有所有权的兄弟姐妹,并保存写作,同步 和接近失败。 清理使用现有的身份匹配退休 \* 保留外国替代物。 替换用品 仅能见度;合同不授予租赁、初步图像比较和扫描、日记 恢复或丧失动力耐用性保证.

只有节点 `inspectRetiredTemporaryDuplicates(root, filePaths)` 观察 只有在身体状况稳定时,才承认原生的退休临时假 身份和字节匹配一个犬科兄弟 与完全两个硬链接. Cononical文件保留了普通的源治理. 未知几何, 额外 文件、 符号链接、 缺失的对应方和替换的inodes 不允许豁免. 这种只读结果证明在观察时重复保管;它没有 认证历史执行或者授权清理,变异或者恢复.

## 常见问题

### @agent-teams/repository-mutation 是什么？

封闭的,可携带的寄存器突变和精确的恢复原始\.

### 如何安装 @agent-teams/repository-mutation？

在项目目录运行 npm install @agent-teams/repository-mutation，或使用 pnpm add / yarn add / bun add。

### @agent-teams/repository-mutation 支持 TypeScript 吗？

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

### @agent-teams/repository-mutation 支持 ESM 还是 CommonJS？

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

### @agent-teams/repository-mutation 需要什么版本的 Node\.js？

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

### @agent-teams/repository-mutation 可以商用吗？

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

### @agent-teams/repository-mutation 的下载量有多少？

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

### @agent-teams/repository-mutation 还在维护吗？

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