SuperAPI AI 工具集

gitlab-wiki

编程与开发

查看项目

更新于 10-15 21:55

技能介绍

用途:该技能用于通过 glab api 原始端点调用 GitLab Wiki API,管理项目 Wiki 页面,包括列出页面、读取内容、创建、更新、删除页面以及上传附件。

主要能力:支持列出全部 Wiki 页面(可分页)、按 slug 获取页面(支持嵌套页面、指定版本、渲染 HTML)、创建页面(可指定标题、slug、内容、格式)、更新页面(内容、标题、格式)、删除页面,以及上传图片等附件并返回可用的 Markdown 链接。内容格式支持 markdown(默认)、rdoc、asciidoc、org。

使用方式:需使用 glab 命令行工具,令牌需具备 api 作用域。读取私有仓库 Wiki 需 Reporter 及以上权限,写入需 Developer 及以上权限,且项目必须启用 Wiki。常用命令模式包括:glab api projects/:id/wikis 列出页面;glab api projects/:id/wikis/:slug 获取页面;创建用 -X POST -f title=... -f content=...;更新用 -X PUT;删除用 -X DELETE;上传附件用 -X POST -F "file=@..."。slug 含空格或嵌套路径时需 URL 编码。

适用场景:在 GitLab 中创建和维护项目文档、搭建 Wiki 结构、备份或迁移 Wiki 内容、为 Wiki 页面添加图片。

限制:不适用于 README 文件(应使用 gitlab-file)、Wiki 内容搜索(应使用 gitlab-search 的 wiki_blobs 范围)或 GitLab 之外的文档。创建、更新、删除和上传操作具有风险,删除风险最高。常见问题包括 404(Wiki 未启用或页面不存在)、403(无写权限)、slug 不匹配、上传失败等。具体权限与项目设置以实际环境为准。