痛点引出
国内开发者使用Gitee进行代码协作时，多数操作需要切换到浏览器完成。从创建Issue到合并Pull Request，从查看Release版本到管理仓库协作者，每一次界面切换都会打断开发思路，降低整体工作效率。
随着AI编码 Agent的普及，越来越多代码开发工作由AI完成。现有工具大多只面向人类使用者设计，输出格式混乱，参数不固定，无法满足AI Agent对结构化输出、明确参数约定的要求，AI需要额外的适配工作才能完成平台操作，增加了开发成本。
项目概述
该项目是Gitee官方推出的命令行工具，核心定位对标GitHub官方CLI工具gh，支持在终端环境下完成所有Gitee日常操作。该项目是全球首个同时适配人类使用者与AI Agent的CLI工具，所有操作流程都针对终端使用场景做了优化，不需要打开浏览器即可完成全流程开发协作。
目前该项目已经完成22个命令组开发，包含150+个子命令，覆盖了从基础仓库操作到高级协作管理的全部需求，核心功能全部开发完成，处于持续迭代维护状态。
技术架构深度分析
该项目整体采用模块化分层设计，底层对接Gitee官方开放API，通过统一的请求封装层处理认证、签名、错误重试等通用逻辑，避免上层业务模块重复处理底层细节。中间层为命令抽象层，将不同业务域的操作封装为独立的命令组，每个命令组统一定义参数解析规则、输出格式规则，保证所有命令的使用体验一致。上层为交互层，分别处理交互式终端场景与非自动化场景的输出渲染，满足不同使用环境的需求。
技术选型上，整体采用Go语言开发，编译后生成单二进制可执行文件，不需要额外依赖环境，用户下载后即可直接使用，适配不同操作系统的发行版本。命令行交互部分使用成熟的CLI框架处理参数解析与帮助文档生成，保证参数解析的可靠性与帮助信息的规范性。
针对AI Agent的设计是该项目架构的核心特色。整个设计围绕"AI Ready"的目标展开，所有命令都支持固定格式的JSON输出，所有必填参数都支持通过命令行参数显式传入，不需要交互式输入，AI Agent可以直接通过解析输出结果判断操作结果，不需要处理复杂的自然语言文本提取。架构中还预留了专门的Agent技能入口，支持第三方AI平台直接集成工具能力，不需要额外适配。
这种架构设计的优势在于，分层结构保证了后续功能扩展的灵活性，新增命令只需要在对应业务域新增模块，不需要修改底层核心逻辑。统一的规则约束保证了所有命令使用体验一致，人类用户学会一个命令的用法就可以复用经验到其他命令。对AI的原生支持抓住了当前AI编码普及的趋势，提前完成了架构适配，避免后续大规模重构。
核心功能详解
认证管理
该模块支持登录、登出、令牌管理与账号切换功能，支持多账号同时配置，随时切换不同账号操作不同仓库。令牌信息统一加密存储在本地，不会泄露账号敏感信息，支持手动更新与轮换令牌，满足企业安全管理要求。该模块支持非交互式登录，适合在CI服务器或者无头服务器上配置认证信息，不需要人工交互即可完成授权。
仓库管理
该模块支持仓库创建、查看、克隆、编辑、删除与Fork操作，支持设置默认仓库，后续操作不需要重复传入仓库参数。支持从当前目录初始化仓库，直接关联远程Gitee仓库，一步完成从本地项目到远程仓库的创建流程。终端内支持分页查看仓库列表，支持按条件过滤，适合快速查找多个仓库。
Issue管理
支持创建、查看、编辑、关闭、重开Issue，支持添加评论与修改状态，支持批量筛选列出符合条件的Issue。所有参数都可以通过命令行传入，支持从文件读取Issue描述，适合批量处理Issue任务。交互式模式下支持通过表格浏览Issue列表，快捷键快速操作，人类用户可以快速筛选处理日常Issue。
Pull Request管理
完整支持PR的创建、查看、评审、合并与差异查看操作，支持合并时选择 squash 压缩提交，支持合并后自动删除源分支。支持直接从当前分支创建PR，自动识别源分支与目标仓库，不需要手动填写大量参数。支持查看PR的diff差异，支持在终端内直接展示代码变更，不需要切换到编辑器查看。
发布管理
支持创建、编辑、删除Release版本，支持上传与下载附件，支持批量列出仓库所有版本。支持从标签创建Release，自动提取标签对应的提交信息生成发布说明，减少手动编写内容的工作量。支持直接在终端下载对应版本的二进制文件，适合脚本中自动获取最新版本进行更新。
Gist代码片段管理
支持创建、查看、编辑、克隆Gist代码片段，支持收藏与取消收藏片段，支持批量列出个人收藏的片段。支持直接从终端读取文件内容创建Gist，一步完成分享流程，适合快速分享临时代码片段。克隆功能支持直接把Gist克隆到本地修改，修改后可以直接推送更新，流程简单流畅。
AI Agent适配
所有命令都支持结构化JSON输出，操作结果包含明确的状态码与错误信息，AI Agent可以直接解析结果判断执行情况。所有参数支持显式传入，不需要交互式输入，支持指定仓库地址与主机地址，适配不同部署环境的Gitee实例。提供原始API调用入口，AI可以直接通过工具调用Gitee官方接口，扩展自定义能力。
项目地址：https://gitee.com/oschina/gitee-cli
🔍 来源：Gitee
Skills，则把「如何正确、安全地使用它」这份知识，直接喂进你的 AI 助手。Gitee CLI 现已正式开源，欢迎共建：https: //
微信扫一扫，打赏作者吧～
