@agent-teams/docs-protocol-agent-teams

中文文档
0.6.1发布于 2026/11/02Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 6781

代理团队管理便携式Docs协议的集成适配器.

中文使用文档

@agent-teams/docs-protocol-agent-teams

团队管理便携式设备的整合 @agent-teams/docs-protocol 软件包.

这个包裹完全拥有Cohort权威, 管理下的消费状态, 过渡投影仪、管理下的工作流程、管理下的资格和历史 管理的资产。 这取决于便携式包 通过该包的公开 节点合同;便携式包件从未发现或导入此适配器.

保留合同保留了3号线 / Cohort 2号线 / State 2号线 / 收发3号线 同一公开同步超载增加了4号线 / Cohort 3号线 / State 3号线 / docs-protocol-cohort-v3-qualification-receipt/v1 收发单 / 包装单 3, A 串装正五 npm

  • @agent-teams/repository-mutation· ;
  • @agent-teams/document-authoring· ;
  • @agent-teams/docs-protocol· ;
  • @agent-teams/docs-protocol-agent-teams; 和 :
  • @agent-teams/engineering-foundation。 。 。 .

消费者只宣布Docs协议,Docs协议代理团队,以及 工程学基金会作为根发展依赖. 仓库突变 准确的中转坐标 锁文件。 独立浮动软件包更新不是Cohort权威.

目前运行时间政策是政策3.0.0,并有保护文物的支持 索赔。 它将第26.11.1号节点记录为生产默认,第24.21.0号节点记录为 兼容道. 这种名义违约和截取元数据不主张 体育节点 26 个资格,它不使受管理的候选人 QUALIFIED 或者说 CANARY。 。 。 .

管理下的运行时间预测保留下来 node-24-production-default 财务报告和审定财务报表 node-26-managed-qualified 作为名义上的历史道ID. 保留节点24 身份证有 default: false 而不声称节点24是当前默认值. 节点26道 default: true 并记录实际26.11.1 / pnpm 11.2.0 / Linux / x64 资格运行时间拖累,但 Cohort v3 候选人 未选定身份 candidate-unqualified 在真正登记之前 资格。 业务概况 3 / Cohort 2 / 收件 3 合同仍保留 明确为节点24,没有变化.

管理的业务使用不同的可执行文件:

agent-teams-docs-managed check --consumer .
agent-teams-docs-managed plan --consumer . --to COHORT
agent-teams-docs-managed apply --consumer . --expect sha256:DIGEST
agent-teams-docs-managed upgrade --consumer . --to COHORT --target-generation 2
agent-teams-docs-managed recover --consumer .
agent-teams-docs-managed qualify --consumer .

便携 agent-teams-docs 财务报告和审定财务报表 docs-protocol 仅包含可执行文件 通用文档命令。 没有遗产 agent-teams-docs consumer 路由、运行时兼容桥、可选适配器查询或动态 版本检测。 V1记录是不可改变的历史迁移和回滚 证据。 现有V1消费者保留准确的检查、恢复和同代 升级命令,但这些命令从未推断或合成V2,也不是 交叉生成兼容模式.

明确 --target-generation 2 路由实现受约束的、可逆的, 一次性配置 v1/Cohort v1 到配置 v3/Cohort v2 迁移. 阶段和 以一次性副本证明继任者,公布一次,并恢复准确 如果启动失败, 则来源证据 。 这不是一座桥梁,别名,双重作家,或 允许发送新的 v1 记录.

可移植配置 v4 是一个单独的,可选的消费者变化. 管理所有者 出口 projectManagedPortableProfileV4(v3Bytes) 生产可审查的 UTF-8 JSON(同样有效的YAML)从一个严格的可移植配置 v3. 它保存着 消费者的作者路径,技能路径和语义验证器ID,并明确 设置屏蔽器类型 open-decision,目标状态 deferred 编号 : open,以及 不兼容的主题状态 accepted 编号 : active。未知的密钥,重复, 别名、标签、同v4不相容的混合代和路径都被拒绝. 投影只返回字节;它不读取或写入消费者文件.

在选择 v4: v3- 仅限阅读器之前, 对后续的 Docs 协议阅读器进行认证 拒绝 审查返回的字节并使用已有的已知文件交易 Plan/Apply工作流程与精确被保存的v3预告. 完成或保存任何 正在处理的交易,通过准确记录的回收文物。 组合 升级命令不会自动引用此迁移。 概况 4 / Cohort 3 / State 3 使用同步超载、准确的命名空间和包装的策略 3,以及实际的节点 26.11.1 / pnpm 11.2.0/Linux/x64观测; selected: false 直到真正发表 QUALIFIED 证明收据不是 CANARY。 。 。 .

资格固定式明确选择可移植 v4 ,并对照 经审查的便携式生产商候选人。 二. 现有峡谷资产的产生 和Cohort资格机制 仍然计算自己的摘要。 恢复 保存的 v3 配置文件仅在路径和文档中明确回滚 词汇满足 v3 , 没有不兼容的交易待处理; 降级 a 软件包本身不是恢复。 出版的版本仍然不可改变.

对于明确可重置的1至2个制备,请选择精确的目标锁定 --target-lockfile /absolute/external/pnpm-lock.yaml --target-lockfile-sha256 sha256:HEX 并行 upgrade --source-generation 1 --target-generation 2 --prepare --restoration-proof /absolute/external/proof.json --to COHORT。两个目标锁定 需要一起悬挂旗帜。 文摘使用64个小写十六进制数字.

输入必须是一个非空的正则文件,最多为32个 MiB , 并带有 Cononical 在消费者、控制器和内核之外 树根。 准备保留已验证的字节, 检查选中组的 严格运行时间关闭并保存原锁的评论,设置, 进口商和外国图表。 冲突被拒绝;没有发生依赖性合并. 只有可支配的相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相. 选定模式的安装方式 --prefer-offline --frozen-lockfile,保留 复制导入, 忽略脚本/ pnpmfile 和存储集成检查 。 筹备 拒绝安装和目标后的任何锁定字节或严格关闭更改.

暗示这些旗帜保留了正常的准备行为. 激活和恢复 保持离线和冻结。 现有准备/防伪办法和确定性 控制器构建身份记录不变. 新的准备必须是 用自己的文摘和保留控制器审查;旧的证明不重写. 源头测试没有确定公共包装生命周期的资格或释放.

过渡目录保留精确的合格目录 docs-2026-09-10-stable18, (中文(简体) ), docs-2026-09-10-stable19, (中文(简体) ), docs-2026-09-11-stable20 财务报告和审定财务报表 docs-2026-09-12-stable21 技术/调用字节 作为后继者升级出源和倒转证据. 继任者本身是 发表后合格,所以 它从来没有嵌入到自己的包。 历史世代2 捆绑是 严格验证但被排除在1 生成器之外;其存在 不允许跨代执行或限定后续释放.

候选人生成3 执行

未释放源添加了明确的保留生成2至3转换及其 选择原回滚 。 发布0.5.5并不包含此路径. 还是这样 待处理 ADR-0070 (英语), (中文(简体) ), 经审查的API/决定推广、公布的控制器保留和实物 消费者资格. 源测试不授予激活权.

保留一个单独核实的后继控制器安装 消费者通过修复保持其准确的包/内核结构. 以实际节点24.21.0运行. 供应绝对数 AGENT_TEAMS_DOCS_UPGRADE_NODE24_EXECUTABLE, (中文(简体) ), AGENT_TEAMS_DOCS_UPGRADE_NODE26_EXECUTABLE 财务报告和审定财务报表 AGENT_TEAMS_DOCS_UPGRADE_COREPACK_ENTRYPOINT 路径。 观察到的来源/目标探测器 linux/x64上的真节点24.21.0/26.11.1 和精确的根 pnpm pin;目标 pnpm 11.20.0. 目标激活和源恢复安装被冻结和下线. 不提供运行时间或引擎倒计时 .

现有的 CLI 路由是明确的(下面的可变是操作员选择的精确线) 路径、代码和单独保留的准备摘要:

"$NODE24" "$CONTROLLER/dist/cli.js" consumer upgrade --consumer "$CONSUMER" \
  --to "$TARGET_COHORT" --source-generation 2 --target-generation 3 \
  --prepare --restoration-proof "$PROOF" --json
"$NODE24" "$CONTROLLER/dist/cli.js" consumer finalize --consumer "$CONSUMER" \
  --from "$SOURCE_COHORT" --to "$TARGET_COHORT" \
  --source-generation 2 --target-generation 3 \
  --preparation "$PROOF.prepared" --expect "$PREPARATION_DIGEST" --proof "$PROOF" --json
"$NODE24" "$CONTROLLER/dist/cli.js" consumer restore --consumer "$CONSUMER" \
  --from "$TARGET_COHORT" --to "$SOURCE_COHORT" \
  --source-generation 3 --target-generation 2 \
  --preparation "$PROOF.prepared" --expect "$PREPARATION_DIGEST" --json

准备只写选中的外部意图 。 完成检查准确的基特, 消费者/控制者/内核身份、当前完整图像和新保护 授权在RM发布之前。 它重新观察所选物理运行时间和 cAS 之前已禁用网络管理器;恢复原产地。 a 之后重新使用相同的选定准备 崩溃; 一个新控制器观察到诚实的一元收款, 激活 目标并记录在检查后才完成。 自动失败补偿 需要这个现场尝试的全重置收据。 否则使用明确恢复; 外国或混合图像拒绝覆盖。 已完成的选项无法重印 在那之后, 通过 已存在的精确内核 consumer recover 在最后敲定/恢复之前的路径.

对于承诺/合并的消费者,逆向重叠的Host Stack/scripts/质量 更改其所有者 未合并回滚PR分支 先说 选择 其目前的清洁头/树并使用单独的承诺目标路线:

"$NODE24" "$CONTROLLER/dist/cli.js" consumer restore --consumer "$CONSUMER" \
  --from "$TARGET_COHORT" --to "$SOURCE_COHORT" \
  --source-generation 3 --target-generation 2 \
  --preparation "$PROOF.prepared" --expect "$PREPARATION_DIGEST" \
  --current-revision "$CURRENT_HEAD" --current-tree "$CURRENT_TREE" \
  --selection "$CURRENT_SELECTION" --json

此路径可以证明源的祖先, 承诺的 Cohort3 和精确的管理 图像,然后独立绑定当前根和一个新的反向计划. 无关的主机文件被保存. 外国完整文件包/锁/工作空间或 配置更改拒绝; 管理的所有者不补全主机字段 。 公众 proofDigest 现在确定保留当前选择。 如果该文件已经存在 中,用 --selection-expect 恢复; a 不确定的写入永远不会自动重复 。 冷的履历是诚实的 一元收条并运行了节点24下的旧源安装/检查. 移动头部,更改无关文件或进行回滚 使旧的 选择 Stale。 在两个所有者倒置后仍需要完全消费CI.

普通配置 4 检查/ 计划/ 应用 直接选择 Cohort3 规划器 。 公众 upgradeConsumerIntegration API 要求 targetGeneration: 1 | 2 | 3; 保留 准备/定稿/恢复是明确的CLI操作。 旧的一至二旗和 证明家人遵守合同 便携式简介4 迁移仍然分开. 实际发布和资格选择后继坐标;无 npm 版本在此预测 .

版本与发布记录

@agent-teams/docs-protocol-agent-teams 共发布 30 个版本,首次发布于 2026/09/04;过去 12 个月发布了 30 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.6.1latest2026/11/026 天前
0.6.02026/10/2910 天前
0.5.52026/10/2513 天前
0.5.42026/10/2315 天前
0.5.32026/10/2117 天前
0.5.22026/10/2118 天前

其他发布通道:bootstrap → 0.0.0。

关于 @agent-teams/docs-protocol-agent-teams 的常见问题

@agent-teams/docs-protocol-agent-teams 是什么?

代理团队管理便携式Docs协议的集成适配器.

如何安装 @agent-teams/docs-protocol-agent-teams?

在项目目录运行 npm install @agent-teams/docs-protocol-agent-teams,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 agent-teams-docs-managed,可以用 npx agent-teams-docs-managed 直接运行。

@agent-teams/docs-protocol-agent-teams 支持 TypeScript 吗?

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

@agent-teams/docs-protocol-agent-teams 支持 ESM 还是 CommonJS?

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

@agent-teams/docs-protocol-agent-teams 需要什么版本的 Node.js?

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

@agent-teams/docs-protocol-agent-teams 可以商用吗?

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

@agent-teams/docs-protocol-agent-teams 的下载量有多少?

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

@agent-teams/docs-protocol-agent-teams 还在维护吗?

最新版本 0.6.1 发布于 2026/11/02(6 天前);至今共发布 30 个版本,其中过去 12 个月发布了 30 个;首次发布于 2026/09/04。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。