VortGit 插件

VortGit 代码仓库插件——8 个 AI 工具的详细参数和配置。

VortGit 插件

VortGit 是 OpenVort 的代码仓库管理插件，为 AI 员工提供 Git 操作能力。通过 8 个工具，AI 可以查询仓库、提交代码、创建 PR 等。

工具列表

git_list_repos — 列出仓库

列出已配置的 Git Provider 下的所有仓库。

参数	类型	必填	说明
provider_id	int	否	Git Provider ID，不传则列出所有

git_repo_info — 仓库详情

获取指定仓库的详细信息（分支列表、最近提交等）。

参数	类型	必填	说明
repo_name	string	是	仓库全名（如 org/repo）

git_query_commits — 查询提交记录

查询指定仓库的提交历史。

参数	类型	必填	说明
repo_name	string	是	仓库全名
branch	string	否	分支名，默认为主分支
author	string	否	按作者过滤
since	string	否	起始时间（ISO 格式）
until	string	否	截止时间（ISO 格式）

git_work_summary — 工作汇总

生成指定时间段内的代码工作汇总报告。

参数	类型	必填	说明
repo_name	string	是	仓库全名
period	string	否	时间段：today / week / month，默认 week

git_manage_provider — 管理 Git Provider

添加、修改或删除 Git Provider 配置。

参数	类型	必填	说明
action	string	是	操作：add / update / delete
platform	string	条件必填	平台：gitee / github / gitlab
url	string	条件必填	Git 平台 URL
access_token	string	条件必填	访问令牌

git_code_task — 代码任务

在 AI 员工的工作电脑中克隆仓库并执行编码任务。

参数	类型	必填	说明
repo_name	string	是	仓库全名
branch	string	否	工作分支，默认创建新分支
task_description	string	是	任务描述

git_commit_push — 提交并推送

将工作电脑中的代码变更提交并推送到远程仓库。

参数	类型	必填	说明
repo_name	string	是	仓库全名
commit_message	string	是	提交信息
branch	string	否	目标分支

git_create_pr — 创建 Pull Request

创建 Pull Request / Merge Request。

参数	类型	必填	说明
repo_name	string	是	仓库全名
title	string	是	PR 标题
description	string	否	PR 描述
source_branch	string	是	源分支
target_branch	string	否	目标分支，默认为主分支

Git Provider 配置

在使用 VortGit 之前，需要配置至少一个 Git Provider。可通过 Web 管理面板或 git_manage_provider 工具添加。

配置项：

平台 URL：Git 平台的 API 地址
Access Token：具有仓库读写权限的访问令牌

Token 获取方式

Gitee

登录 Gitee -> 设置 -> 私人令牌
创建令牌，勾选 projects、pull_requests、hook 权限
复制生成的令牌

GitHub

登录 GitHub -> Settings -> Developer settings -> Personal access tokens
创建 Fine-grained token 或 Classic token
授予 repo 权限
复制生成的令牌

GitLab

登录 GitLab -> Preferences -> Access Tokens
创建 Personal Access Token
勾选 api、read_repository、write_repository 权限
复制生成的令牌

Token 安全

Access Token 使用 Fernet 对称加密存储在数据库中，不以明文保存
Token 不会传入 AI 员工的 Docker 容器，Git 操作通过宿主机代理完成
建议为 AI 专门创建独立的 Git 账号，限制仓库访问范围