DevOps 平台自动化
零依赖 Python CLI 操作 Coding.net Open API。覆盖合并请求生命周期、CI 构建管理、制品库查询、跨项目枚举和远程文件审计——所有标准 Git 无法完成的平台操作。
FEATURES
创建、合并、关闭合并请求。查看 MR diff、发表评论、列出评论。所有标准 Git 无法完成的 MR 操作。
触发构建、查看构建日志、停止运行中的构建、查看构建阶段。与 Coding CI/CD 深度集成。
查看 Docker/npm/Maven 制品仓库。浏览包版本列表，获取下载 URL。
枚举团队所有项目和仓库，按名称搜索项目，查看项目成员。无需逐个 clone。
不 clone 整个仓库即可读取任意远程文件。轻量级远程代码审计和单文件修复。
内置分支规范检测：Agent 自动识别 dev/develop/test/staging 分支，MR 始终指向最低级别集成分支。
REFERENCE
auth — 凭证管理
| 命令 | 说明 | 示例 |
|---|---|---|
init | 非交互式初始化 | ./coding auth init --team my-team --token tok_xxx |
status | 检查连接状态 | ./coding auth status |
clean | 清除凭证 | ./coding auth clean |
depot — Git 仓库操作
| 命令 | 说明 | 示例 |
|---|---|---|
list | 列出仓库 | ./coding depot list --project myproject |
branches | 查看分支 | ./coding depot branches --depot-id 123 |
file | 远程读文件 | ./coding depot file --depot-id 123 --path README.md |
mr-create | 创建 MR | ./coding depot mr-create --depot-id 123 --title "feat" --src feature/x |
mr-merge | 合并 MR | ./coding depot mr-merge --depot-id 123 --merge-id 1 |
mr-diff | 查看 MR diff | ./coding depot mr-diff --depot-id 123 --merge-id 1 |
ci — 构建管理
| 命令 | 说明 | 示例 |
|---|---|---|
jobs | 构建任务列表 | ./coding ci jobs --project 456 |
trigger | 触发构建 | ./coding ci trigger --project 456 --job 789 --ref main |
log | 查看构建日志 | ./coding ci log --project 456 --id 100 |
stop | 停止构建 | ./coding ci stop --project 456 --id 100 |
artifact — 制品管理
| 命令 | 说明 | 示例 |
|---|---|---|
repos | 制品仓库列表 | ./coding artifact repos --project 456 --type docker |
packages | 包列表 | ./coding artifact packages --project 456 --repo my-docker |
versions | 版本列表 | ./coding artifact versions --project 456 --repo r --pkg p |
download-url | 下载地址 | ./coding artifact download-url --project 456 --repo r --pkg p --version v1.0 |
| 场景 | 用什么 |
|---|---|
| MR 创建/合并/关闭 | ✅ 本技能（git 做不到） |
| CI 触发/查看日志/停止 | ✅ 本技能（git 做不到） |
| 制品库查版本/下载 | ✅ 本技能（git 做不到） |
| 远程读文件（不 clone） | ✅ 本技能（更高效） |
| 跨项目查询 | ✅ 本技能（git 做不到） |
| 多文件代码开发 | ❌ 标准 git |
| 本地已 clone 的仓库 | ❌ 直接读文件 |
对 Agent 说：
"帮我在 my-project 仓库创建一个 MR，从 feature/auth 合到 dev"
Agent 自动：
Agent 执行 MR 操作时必须遵守：
检测分支 → 优先级: dev > develop > test > staging > main
MR 目标 → 始终指向最低级别的集成分支
禁止行为 → 直接向 master/main 建 MR（除非它是唯一分支）| 分支类型 | 命名规范 | 示例 |
|---|---|---|
| Feature | feature/<name> | feature/add-auth |
| Bugfix | fix/<name> | fix/null-pointer |
| Probe | probe/<name> | probe/api-test |
Coding.net 使用统一 POST 端点 + Action 路由：
POST https://{team}.coding.net/open-api?Action={ActionName}
Authorization: Bearer {personal_access_token}
Content-Type: application/json
Body: { "DepotId": 123, ... }ProjectName, DepotId, MergeId{"Response": {...data}} 或 {"Response": {"Error": {...}}}INSTALL