# @eyeauras/teamcity-cli 中文文档 规范地址：https://npmcn.com/package/%40eyeauras/teamcity-cli/ 版本：0\.11\.1 npm 元数据更新时间：2026-11-11T19:38:22.227Z 中文译文更新时间：2026-11-14T06:29:02.311Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40eyeauras/teamcity-cli 原文对照：https://npmcn.com/package/%40eyeauras/teamcity-cli/?lang=original 项目主页：https://github.com/iXab3r/teamcity-cli 源码仓库：https://github.com/iXab3r/teamcity-cli ## 关键信息（来自 npm 元数据） - 包体积（解压后）：1 MB，135 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：\>=22 - 运行依赖：1 个 - 首次发布：2026-09-12T11:41:41.580Z - 最新版本发布：2026-11-11T19:38:22.081Z - 近 30 天下载量：3530（2026-10-14 至 2026-11-12，npm 官方下载统计） - 已发布版本数：24（近 12 个月 24 个） ## 中文简介 AI友好型TeamCity CLI与AI CLI工厂相建. ## 安装 ```sh npm install @eyeauras/teamcity-cli ``` 也可以使用：`pnpm add @eyeauras/teamcity-cli`、`yarn add @eyeauras/teamcity-cli`、`bun add @eyeauras/teamcity-cli` ## README # 团队- cli **整个"TeamCity REST API"作为命令行工具,可以安全地交给AI代理.** ```sh npm install --global @eyeauras/teamcity-cli teamcity-cli profile configure # server URL + access token, asked once teamcity-cli builds list --job Demo_Tests --branch main --limit 20 ``` ## 为什么 | | | | --- | --- | | **完成** | REST描述 TeamCity 2026.1发布的所有449个操作都可以达到:构建,队列,构建配置,项目,VCS,代理,云,用户,服务器管理. | | **默认只读** | 新的简介只能读取 。 写作需要 `permissions grant Update` 该配置文件; 账户和服务器管理需要 `Admin`,符号和秘密工作流程需要 `Credentials`,每个分别授予. | | **为建造分解而制造** | `builds diagnose` 在一个电话中回答"为什么它失败":最多10个问题和20个失败测试. `jobs run --wait` 财务报告和审定财务报表 `builds wait` 0出站成功,1出站失败,124出站超时,130出站Ctrl+C. | | **经纪人便宜** | `--json` 在每一个命令中,页式列表(`--limit`, (中文(简体) ), `--start`返回时 `hasMore` 财务报告和审定财务报表 `nextStart`,稳定的出错代码,以及持续的 `--json-rpc` 会话不重新启动节点 . | | **简介证书** | Profile sidents活在平台秘密商店,从未在Profile JSON中. 写入前置呼叫器输入; 密用别名是可选的 。 密码/ 安全参数返回为 `redacted: true`,而HTTP出错包括了前4个带有配置证书的服务器文本 KiB. | | **可预见** | 没有写作被重试或重放 。 当队列请求的答案丢失时, `jobs run` 报告 `run.unknownOutcome` 和检查的命令,而不是再次张贴. | ![People, AI agents and Node.js code use one teamcity-cli command tree, which applies profiles, the secret store, a permission gate and redaction before calling the TeamCity REST API](https://npmcn.com/package/%40eyeauras/teamcity-cli/docs/images/how-it-works-light.svg) 请求发送调用器值和包含文件的列表默认值 。 TeamCity 验证服务值并应用省略字段 默认值。 本地 JSON DTOs 与紧凑选项一起工作;许可门、确认和本地 文档/证书的安全性继续得到执行。 没有过滤器的列表请求其页面中的所有项目 限制:建筑物包括所有分支和州,代理人包括未经授权的代理人. 构建/队列标签列表只包含公共标签和当前用户的私人标签. 使用 `builds list --branch @default` 或者说 `--branch @this` 以缩小分支;模板仍分开 从工作。 见 [列表默认值](https://npmcn.com/package/%40eyeauras/teamcity-cli/docs/reference.md#list-defaults) 用于扫描界限和范围例外. ## 覆盖范围 这些操作的每个记录查询参数都由调用者控制;参见 [目前REST的覆盖范围](https://npmcn.com/package/%40eyeauras/teamcity-cli/docs/rest-api-coverage/current/README.md)。 。 。 . 在449个已公布的REST操作中,每个工具可以通过自己的命令调用,按API区域. 行动覆盖面仍为449/449;0.9.0改进了返回的配置数据,包括完整 0.8.0所隐藏的脚本和平面设置. 矩阵不衡量响应域的完整性. ![Coverage matrix: teamcity-cli 0.9.0 reaches 449 of 449 operations (100%); the JetBrains teamcity 1.6.3 reaches 75 (17%) through dedicated commands, bbox 1.1.0 reaches 9 (2%) and tctest 1.3.5 reaches 6 (1%)](https://npmcn.com/package/%40eyeauras/teamcity-cli/docs/images/coverage-matrix-light.svg) JetBrains CLI 还有一个原始的 `teamcity api` 请求此 API 以外的命令和特性 (建立日志,管道,代理终端) 本工具没有. `bbox` 财务报告和审定财务报表 `tctest` 为: 小型单用途工具:构建触发和清理,并进行拉取请求的测试运行. 数字、方法和说明: [覆盖面比较](https://npmcn.com/package/%40eyeauras/teamcity-cli/docs/coverage-comparison.md)。 。 。 . ## 用这个 ```sh # read: why did build 101 fail, as JSON teamcity-cli builds diagnose 101 --json # write: allow it for this profile once, then queue a build and wait for the result teamcity-cli permissions grant Update --profile uat teamcity-cli jobs run Demo_Tests --profile uat --branch main --wait --timeout 10m # discover: every level has help teamcity-cli --help teamcity-cli builds --help ``` 读取命令返回配置值 TeamCity 提供给您符号, 包括 完整的脚本、 Docker 选项、 要求操作符和 VCS 连接设置。 只有密码类型 参数, `secure:` teamCity扣留的属性和值保持隐藏. 普通数值,例如 `*` (圆通配符)和 `*****` 仍可读;其拼写不 决定秘密。 编写前传呼叫器提供的名称和值,以供TeamCity验证,包括 密码类型参数和类似证书的值。 读取调度属性 `jobs triggers show `。 。 。 . 使用 `jobs configuration show --json` 用于构建设置和内容, `projects templates show --json` 用于模板,以及 `agents parameters list --json` 用于系统、环境和配置参数. 共享时将真实输出作为私有配置处理 . 使用 `--fields ` 用于本地TeamCity输出的响应命令。 JSON的终点 接受 `fields` 接收到它不变; 其他端点返回他们的原生身体而无需额外查询 参数。 名单保留其呼号信封。 默认保留现有摘要和人类观点; 密码/`secure:`/ 持有的值保持隐藏 。 下载保存本地字节,以及 `--store-as` 保留 在秘密店里只有秘密回应 REST插件外的 XML 汇总子集返回为文本; 状态 SVG 文件在不解释其内容的情况下被保存. 需要节点.js 22+. 您的服务器版本和您的账户权利仍然决定一个呼叫是什么 允许这样做; 本地许可门并不取代TeamCity自己的授权. ## 再来 - [命令参考](https://npmcn.com/package/%40eyeauras/teamcity-cli/docs/reference.md):每个命令家族,呼号,运行和等待,文件,登录,出错代码. - [覆盖面比较](https://npmcn.com/package/%40eyeauras/teamcity-cli/docs/coverage-comparison.md):矩阵后面的数字和如何衡量数字. - [设计](https://npmcn.com/package/%40eyeauras/teamcity-cli/docs/DESIGN.md) 共享运行时间和 [发布指南](https://npmcn.com/package/%40eyeauras/teamcity-cli/docs/release.md)。 。 。 . - 建于AI CLI工厂上`@eyeauras/cli-factory`) (中文(简体) ). [麻省理工学院执照](https://npmcn.com/package/%40eyeauras/teamcity-cli/LICENSE)。 。 。 . ## 常见问题 ### @eyeauras/teamcity-cli 是什么？ AI友好型TeamCity CLI与AI CLI工厂相建\. ### 如何安装 @eyeauras/teamcity-cli？ 在项目目录运行 npm install @eyeauras/teamcity-cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 teamcity-cli，可以用 npx teamcity-cli 直接运行。 ### @eyeauras/teamcity-cli 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @eyeauras/teamcity-cli 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @eyeauras/teamcity-cli 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @eyeauras/teamcity-cli 可以商用吗？ @eyeauras/teamcity-cli 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @eyeauras/teamcity-cli 的下载量有多少？ 根据 npm 官方下载统计，@eyeauras/teamcity-cli 在 2026/10/14 – 2026/11/12 这 30 天内被下载 3,530 次，日均约 118 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @eyeauras/teamcity-cli 还在维护吗？ 最新版本 0\.11\.1 发布于 2026/11/12（2 天前）；至今共发布 24 个版本，其中过去 12 个月发布了 24 个；首次发布于 2026/09/12。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。