# @calltelemetry/ct-release-mcp 中文文档 规范地址：https://npmcn.com/package/%40calltelemetry/ct-release-mcp/ 版本：0\.3\.24 npm 元数据更新时间：2026-11-07T18:12:25.769Z 中文译文更新时间：2026-11-09T00:20:22.531Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40calltelemetry/ct-release-mcp 原文对照：https://npmcn.com/package/%40calltelemetry/ct-release-mcp/?lang=original 项目主页：https://github.com/calltelemetry/ct-release-mcp#readme 源码仓库：https://github.com/calltelemetry/ct-release-mcp ## 关键信息（来自 npm 元数据） - 包体积（解压后）：468 kB，135 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：\>=22\.0\.0 - 运行依赖：5 个 - 首次发布：2026-08-24T19:18:40.483Z - 最新版本发布：2026-11-07T18:12:25.597Z - 近 30 天下载量：2133（2026-10-09 至 2026-11-07，npm 官方下载统计） - 已发布版本数：34（近 12 个月 34 个） ## 中文简介 管理呼叫 遥测发布规划 MCP 服务器和 CLI ## 安装 ```sh npm install @calltelemetry/ct-release-mcp ``` 也可以使用：`pnpm add @calltelemetry/ct-release-mcp`、`yarn add @calltelemetry/ct-release-mcp`、`bun add @calltelemetry/ct-release-mcp` ## README # ct-释放-mcp 管理,读取"呼叫遥测"代理机和操作器的首发规划. `@calltelemetry/ct-release-mcp` 暴露与stdio MCP工具相同的命令, 由ct-mcp组成,作为结构化的CLI: - `get_release_state` - `get_stable_nightly` - `get_release_train` - `list_versions` - `plan_release` - `show_plan` - `validate_plan` - `get_appliance_build` 软件包不发送统一放出,无法创建标记,放出, 图像、捆绑或频道标记. `plan_release` 是一个突变命令 : 它只发送无副作用释放计划的工作流程。 候选人 身份只来自成功 `calltelemetry/ct-release` 释放计划 工作流程文物. ## 安装 在没有参数的情况下以 stdio MCP 服务器运行被绑定的软件包 : ```json { "command": "npx", "args": ["-y", "@calltelemetry/ct-release-mcp@0.3.24"] } ``` 直接通过同一被绑定的软件包运行任何被规范的命令 : ```sh npx -y @calltelemetry/ct-release-mcp@0.3.24 get_release_state \ --channel stable \ --line 0.8.7 npx -y @calltelemetry/ct-release-mcp@0.3.24 plan_release \ --target-branch 0.8.7-stable ``` 使用 `--input-json` 以不翻译字段的方式传递 MCP 输入对象 名称 : ```sh npx -y @calltelemetry/ct-release-mcp@0.3.24 list_versions \ --input-json '{"line":"0.8.7","limit":20,"includePrereleases":true}' ``` 需要22号节点或更新. ## 软件包发布工作流程恢复 这个 `docker.yml` 工作流程仅用于推动 `main`注册后 但是,在任何版本图像推前,它检查 准确的软件包版本 git 标签和两个GHCR版本的图像别名(`vX.Y.Z` 财务报告和审定财务报表 `X.Y.Z`) (中文(简体) ). 现有 只有当两个别名共享一个文摘和两个平台时,才接受释放 图像将标记的承诺标明为源。 如果选中的话, 它会跳过 建立和npm调度。 向 git 标签的推力不会重建或覆盖该图像 . 该寄存器的图像构建被序列化,包括工作流程再运行. 在主推前使用 GitHub 扩展的通量队列, 从而承认 用于100个等待工作; 超额工作被取消,必须进行调查。 自兹 GitHub 不保证发送命令, 旧版本的构建不保证 移动 `latest` 何时 `main` 有不同的软件包版本. 如果 git 标签或任何一幅图像别名不存在完整的集,则 文摘或来源承诺不同,或任何查询失败,工作流程停止 在推出图像之前。 调查精确的标记、 图像和运行失败 在恢复前; 不根据已存在的图像重运行建构或 移动已存在的标签。 已经出版的软件包不应是 再次发表。 主持MCP的是云花板工人 `ci.yml` 从 `main`。 。 。 . ## 认证 服务器按此顺序解决 GitHub 认证 : 1. 嵌入应用程序提供的明确标志 2. `GH_TOKEN` 3. `GITHUB_TOKEN` 4. 活跃 `gh auth token` 证书必须能够读取 被管理的呼叫遥测存储器, 发布记录,标签,工作流程运行,以及文物. `plan_release` 需求 允许发送 `calltelemetry/ct-release` 发布计划工作流程. 在工具结果或错误上下文中,托肯永远不会返回 . 用户和 PAT 证书与工作流程参与者相关 `GET /user`. GitHub App 安装符号不能称为端点,所以 服务器通过仅安装仓库验证安装身份 列入清单和要求访问 `calltelemetry/ct-release`然后生成 从符号认证的 GraphQL 中的应用机器人身份 `viewer` 并绑住 工作流程 `actor` 财务报告和审定财务报表 `triggering_actor` 登录、数据库ID和节点ID 那个身份 只有先入为出才能互相关联 可选设置 `CT_RELEASE_GITHUB_APP_ACTOR` 用于信任的 App 机器人登录(例如, `ct-pr-agent[bot]`)作为补充许可名单。 工作流程校正默认为 `main` 并可以配置为 `CT_RELEASE_GITHUB_DEFAULT_BRANCH`。 。 。 . 安装电源的发送仍与App的确切身份有关, 存储库、工作流程参考、目标分支非ce、先前运行的快照和定界 调度时间; 通用的403绝不被接受为安装身份. ## 目录来源 `0.3.15` 读取 `scripts/release-storage.json` 从发布存储器通过 已认证的 GitHub 客户端 。 每个操作都会解决其目录 URL 一次来自已配置的 Cloudflare R2 发布源(`https://get.calltelemetry.com`报告 同样的来源。 配置和获取失败在分支之前停止规划 快照或发送。 为下一个操作再次读取配置; a 失败的读取不会成为缓存源 . 配置读取范围为 16 KiB 。 提供方、 计划、 桶、 区域、, 终点和公共来源必须同意。 Catalog 获取界限,列车验证, 计划身份和共享的MCP/CLI指令登记册保留其现有 合同. ## 命令行为 MCP工具名和CLI子命令完全相同. CLI 战地旗帜使用 MCP 骆驼 Case 名称作为cononical 拼写,并接受克巴克语的别名,例如 `--includePrereleases` 或者说 `--include-prereleases`。布尔旗帜需要 明确 `true` 或者说 `false`;整数必须是安全的整数. `--input-json` 不能与战地旗帜结合。 只有适配器,没有价值 `--pretty` 旗帜可能出现在命令之后的任何地方,缩进JSON而不更改 MCP等同输入或结果. - `get_release_state` 阅读公共电器目录、生命周期和 成份分类账, GitHub 发布,和组件标记. 目录和发布 记录是主要权威;组件标记是贴有标签的次要证据. 它暴露了被提升的频道提示(`tip_marker ?? tip`),可下载 `catalogDownloadTip`后退旗 (单位:千美元)`catalogTipFallback`编号 :`catalogTipMarkerDeployable`页:1 头`catalogVersionTip`),以及 变种. 较新的候选人不是晋升权力机构,也不是漂泊。 A 类 受制裁的捆绑后退( e)`tip_fallback: true`, (中文(简体) ), `tip_marker_deployable: false`) 也不是漂移: 标记保持 释放密针时 `catalogDownloadTip` 命名旧的电器。 A 类 其生命周期分类账明确标记未公布的回报的最后通道 `channelStatus: "not_published"` 而不是虚假目录/所有者漂移。 中学 组件标签后缀返回到 `advisories`· ; `drift` 预留用于 权威分歧。 辅助证据是用GitHub的 释放行匹配- ref 端点而不是爬行每个组件标记 页 次 何时 `trains/.yaml` 拥有 `stable-nightly`, (中文(简体) ), `get_release_state` 也包括表面 `stableNightly` 明确无资格 (单位:千美元)`qualifiedForStable: false`),同时保留 `catalogTip` 严格约束 被提升的主线权威(`null` 何时 `channel` 实值 `stable-nightly`) (中文(简体) ). - `get_stable_nightly` (CLI别名: `stable-nightly`)读取选入 `channels/stable-nightly.json` r2释放源的指针 256 KiB 绑定, 拒绝重复的 JSON 密钥和非整数, 验证 警犬 JSON SHA -256号 `admission_id`执行 `qualified_for_stable: false` 财务报告和审定财务报表 `package_origin` 来源, 验证指针线拥有 `stable-nightly` 内 `trains/.yaml`,并评估 `readyForStablePromotion` 反对 `promotion_receipts.stable` (单位:千美元)`security` 财务报告和审定财务报表 `uat` 核查通道). HTTP 404 返回 `status: "uninitialized"` 而不是治疗未公布 夜间频道作为行动坠机. - `get_release_train` 返回单独版本的生命周期和组件 包含精确的Git SHA的构成文件. - `list_versions` 列表目录和 `ct-release` 一个发行行的版本, 包括有明确标签的身份保留草案,包括 `stable-nightly` 预释放记录`qualified_for_stable: false`当 `includePrereleases` 实值 `true` 在一条拥有的线上 `stable-nightly`。 。 。 . - `plan_release` 只发送无副作用的释放计划工作流程, 然后迅速返回精确运行的ID和发送前的授权快照. 它还对所要求的稳定分支进行生命周期验证 组件显示,快照 `calltelemetry/cisco-cdr` 分支 SHA,并发送由此产生的四地释放目标而不添加 调频输入. 这一精确目标合同在下列年份成为强制性合同: `calltelemetry/ct-release` 承诺 `579ff34720cf1a273201f12174b242ec926ebc39` (PR 第1570号); `v0.3.4` 在其信任的-publisher工作流程后被标记但未发布 身份被拒绝. `@calltelemetry/ct-release-mcp@0.3.5` 是第一个 出版了协调呼叫器版本,以及 `0.3.6` 增加严格验证 目标在目前的计划文物和发送投入中持续存在. `0.3.7` 采用直接目录来读取包边规划;其GCS 默认在 `0.3.15`。主机释放计划当局必须独立使用相同的程序 canonical source; 光是这个软件包更改并不能证明计划成功. 现有文物需携带候选R2 `release_bundle` 打开 `https://get.calltelemetry.com`· ; 退休人员 `gcs_bundle` 文物不能对当前放行规划进行限定. `0.3.12` 计划设计过渡阶段:合同版本1仍保留 只可读取它的遗产..`train` 形状,而合同版本 2 需要被管理的顶层 `train`. 确切的释放目标可能确定 cisco-cdr/Web 或 ct-quasar/Vue 分支最新快照; 选中的 寄存器的源代码 SHA必须匹配不可改变的快照. `0.3.13` 支持旋转 GitHub App 安装符号而不削弱 工作流程运行关联或接受无关的 PAT 授权失败. 主机工作流程拒绝一个计划,如果该约束权限在之前更改 文物创作. 使用 `show_plan` 读取不可更改的 艺术品 没有公共频道的明显活跃、未公布的列车 可以计划首次发布 以无效目录提示。 这要求不 矛盾的目录 文物或公布的终局 并保存准确 编目、生命周期和组成快照;它从不借用另一行的 频道或创建公共标记. `0.3.23` 增加合同版本4,用于认证的Quasar图像身份; 版本的Quasar标签需要准确的来源,制作工作流程,配方, 建设投入、平台、候选人和尝试投影。 遗产短 SHA 仍然支持快照,而合同版本3则保留给 分离0.8.6 固定相片形状. - `show_plan` 通过工作流程获取并验证成功的计划文物 身份证. - `get_appliance_build` 读取一个 `calltelemetry/ai-workspace` 由 id 运行的 Build OVA 应用程序,或最新运行,其标题包含版本,图像格式和关联 id. 它返回状态,当前步骤,失败步骤. 它不发送或出版. - `validate_plan` 重新读取当前权威, 但更改后的列车关闭失败 SHA, 无效候选人身份, 丢弃或更改发信针, 或已知 权力漂移。 对于仍然未公布的没有信道的列车,目前状态 报告 `channel: null`, (中文(简体) ), `channelOwner: null`,以及 `channelStatus: "not_published"`。 。 。 . 明确隐藏的信道( E)`customer_visible: false`) 无效晋升 标记可能在 v2 下验证一个更新的,不可再变换的草稿唯一的主线RC 或 v4计划合同. 有效寿命周期列车必须明确不公布,其 `latest_stable` 必须等同上一个决赛公布的同一行。 仅 `CATALOG_LEDGER_MISMATCH` 财务报告和审定财务报表 `CATALOG_RELEASE_MISMATCH` 匹配的条目 拥有者、 请求行、 无效标记和前最后上下文符合条件; 未知 可见度或不完整/相匹配的漂移上下文失败关闭 。 β升级 在计划和发送投入中都必须是虚假的,OVA的发送必须是 假的,没有允许的覆盖。 被接受的计划返回无阻 `DRAFT_RC_WITHOUT_STABLE_MARKER` 在其可选条目中 `advisories` 阵列; 被拒绝的计划省略它, 而当前状态保留了缺失标记漂移 . 此例外从未授权最终的,别名, OVA 调度,自动 晋升,或任何其他当局的不同意见. 命名的变种RC, 如 `0.8.7-i18n-rc17` 保持与正常分离 频道版本. 它们按其数字RC后缀排序,从未满足 普通频道所有权检查。 常规 `-stable` 规划总是有束缚 至主线频道,即使变量预览是唯一可看见的客户 那条线上的频道. `plan_release` 返回精确运行关联,而不是等待 主机工作流程,将其保留在普通MCP请求的最后期限之内. 虽然 运行已排队或活动, `show_plan` 返回可重试 `PLAN_RUN_PENDING`页:1 工作流程返回失败 `PLAN_RUN_FAILED` 及其运行的 URL. 该计划保留了生产者的准备状态候选人和OCI指数/amd64/arm64 证明收据中的文摘。 冻结计划需要完整的文摘集 与准备就绪的候选人有关;遗留的0.8.6固定备用计划可能带去无效的文摘和 一个空位候选人。 遗漏这些地段的历史文物仍可读取. 错误或部分约束和未识别字段仍然是错误. 所有 MCP 和 CLI 命令错误使用结构化 `{ error: { code, message, retryable, context } }` 形状。 CLI 命令结果和 错误是默认情况下在stdout上的一行JSON,或者缩进的JSON与 `--pretty`。帮助和版本是纯文本。 CLI 退出 代码是 `0` 为成功的命令, `2` 用于 CLI 用途或输入-schema 错误,以及 `1` 对于操作失败。 一个成功的 `validate_plan` 电话可以 仍然返回 `valid: false`;这是权威时的规范结果 消息来源不同意. 使用 `release-control dispatch --plan-run ` 仅在 `show_plan` 财务报告和审定财务报表 `validate_plan` 成功 。 那个单独的调度员拥有统一发布系统 这个 软件包在权威的规划和验证中故意停止. ## CLI 参考 ```text ct-release-mcp get_release_state --channel --line ct-release-mcp get_stable_nightly [--line ] ct-release-mcp stable-nightly [--line ] ct-release-mcp get_release_train --line ct-release-mcp list_versions --line [--limit ] [--includePrereleases true|false] ct-release-mcp plan_release --targetBranch [--version ] ct-release-mcp show_plan --planRunId ct-release-mcp validate_plan --planRunId ct-release-mcp get_appliance_build [--runId ] [--version ] [--correlationId ] [--imageFormat qcow2|ova] ``` 运行 `ct-release-mcp --help` 或者说 `ct-release-mcp --help` 现场直播 从共享命令登记册生成的引用. ## 发展 ```sh npm ci npm run validate ``` ## 常见问题 ### @calltelemetry/ct-release-mcp 是什么？ 管理呼叫 遥测发布规划 MCP 服务器和 CLI ### 如何安装 @calltelemetry/ct-release-mcp？ 在项目目录运行 npm install @calltelemetry/ct-release-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ct-release-mcp，可以用 npx ct-release-mcp 直接运行。 ### @calltelemetry/ct-release-mcp 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @calltelemetry/ct-release-mcp 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @calltelemetry/ct-release-mcp 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=22\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @calltelemetry/ct-release-mcp 可以商用吗？ @calltelemetry/ct-release-mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @calltelemetry/ct-release-mcp 的下载量有多少？ 根据 npm 官方下载统计，@calltelemetry/ct-release-mcp 在 2026/10/09 – 2026/11/07 这 30 天内被下载 2,133 次，日均约 71 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @calltelemetry/ct-release-mcp 还在维护吗？ 最新版本 0\.3\.24 发布于 2026/11/08（1 天前）；至今共发布 34 个版本，其中过去 12 个月发布了 34 个；首次发布于 2026/08/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。