钉钉命令

您可以在群组中@机器人或者直接与机器人创建一对一的聊天框发送消息。当您未将钉钉账户和极狐GitLab 账户进行绑定时，机器人会提示您还未进行绑定，并会在与您的一对一聊天框中发送一个绑定链接，您需要点击链接完成绑定。

您需要在命令中通过添加项目路径、项目 ID 或项目别名指定您要进行操作的项目。下表中的命令以 project-path 为例，且默认对此项目有操作权限。

在群组中@机器人发送消息和与机器人进行一对一私聊时，会出现返回消息不一致的情况。下表中默认为返回消息一致的描述，如有不一致会另作说明。

命令	效果
`help`	显示所有可用命令。
`(project-path) issue new (title) (shift+return) (description)`	使用标题 `(title)` 和描述 `(description)` 创建一个新议题。创建成功后，会显示 “I created an issue on xx’s behalf: #`(id)` in `(project-path)`“。您可以点击消息中的议题 ID 查看议题的详细信息。内容书写需遵循 markdown 语法。您也可以在命令中添加指派人和标记等。
`(project-path) issue show (id)`	使用 ID `(id)` 显示指定议题。如果您有所请求显示的议题（非私密）的权限，会显示议题标题、作者、指派人、里程碑和标记。如果您没有所请求显示的议题的权限或请求显示一个不存在的议题，会显示 “I cannot find the issue #`(id)`“。如果您请求显示一个私密议题： - 群组中：议题信息如标题、作者、指派人、里程碑和标记不会显示，仅显示议题 ID 链接，拥有对应议题权限的人员可以点击链接查看详细信息，没有权限的人员则无法查看。 - 私聊中：如果您有该私密议题的权限，则会显示议题信息如标题、作者、指派人、里程碑和标记；如果您没有该私密议题的权限，会显示 “I cannot find the issue #`(id)`” 。如果您查询一个不存在或您没有权限的项目中的议题，会显示 “You are not allowed to perform bot commands”。
`(project-path) issue close (id)`	使用 ID `(id)` 关闭指定议题。关闭议题（非私密）成功后，会显示 “I closed an issue on xx’s behalf: #`(id)` in `(project-path)`“，并显示议题信息如标题、作者、指派人、里程碑和标记。如果您请求关闭一个私密议题： - 群组中：仅显示关闭成功消息，不显示议题详细信息。 - 私聊中：显示议题详细信息。如果您请求关闭一个已关闭的议题，会显示 “Issue #`(id)` is already closed.”。如果您请求关闭一个不存在或您没有权限的议题，会显示 “I cannot find the issue #`(id)`“。
`(project-path) issue search (query)`	最多显示五个您权限范围内匹配搜索内容 `(query)` 的议题，按照议题的创建时间从新到旧进行排列。如果您请求查询议题： - 群组中：私密议题显示为 “Confidential Issue”，非私密议题显示议题 ID、标题及状态。 - 私聊中：全部议题都显示议题ID、标题及状态。如果没有找到匹配您查询条件的议题，会显示 “I cannot find any issue related to `(query)`“。如果您输入的关键字大于或等于 3 个字符，则会进行模糊匹配搜索，即返回所有标题中包含此关键字的议题；如果您输入的关键字小于 3 个字符，则会进行精确匹配搜索，即仅会返回标题与此关键字相同的议题。
`(project-path) issue move (id) to (project)`	使用 ID `(id)` 移动指定议题到 `(project)`。移动成功后，会显示 “Moved issue #`(old_link)` to #`(new_link)`“。如果所要移动的议题已关闭，会显示 “I cannot move closed issue”。如果无法找到目标项目，会显示 “I cannot find target project `(project)`“。
`(project-path) issue comment (id) (shift+return) (comment)`	向 ID 为 `(id)` 的议题添加评论正文为 `(comment)` 的新评论。评论成功后，会显示 “I commented on an issue on xx’s behalf: #`(id)` in `(project-path)`” 和评论内容。评论内容需遵循 markdown 语法，详情请参见 Markdown 渲染。您也可以使用极狐GitLab 快速操作对议题进行高级操作。如果您请求评论一个不存在的议题，会显示 “I cannot find the issue #`(id)`“。如果您请求评论一个您没有权限的议题，会显示 “You are not allowed to perform the given bot command”。
`(project-path) deploy (from) to (to)`	从 `(from)` 环境部署到 `(to)` 环境。您请求部署后，会显示 “Deployment started from `(from)` to `(to)`. Follow its progress.”。您可以点击消息中的链接查看部署进度，详情请参见环境和部署。
`(project-path) run (job name) (arguments)`	在默认分支上执行作业 `(job name)`。运行成功后，会显示 “ChatOps job #`(id)` started by xx completed successfully” 和具体的作业 ID 及名称。您可以点击消息中的链接查看具体的作业内容。