# Gitee.VisualStudio

**Repository Path**: GitGroup/Gitee.VisualStudio

## Basic Information

- **Project Name**: Gitee.VisualStudio
- **Description**: 码云 Visual Studio 扩展
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://marketplace.visualstudio.com/items?itemName=GiteeInc.GiteeExtension
- **GVP Project**: No

## Statistics

- **Stars**: 312
- **Forks**: 84
- **Created**: 2017-11-11
- **Last Updated**: 2026-05-26

## Categories & Tags

**Categories**: vcs

**Tags**: None

## README

# Gitee Extension for Visual Studio

[![Nuget Version](https://img.shields.io/nuget/v/Gitee.Api.svg)](https://www.nuget.org/packages/Gitee.Api/)
![Visual Studio Marketplace Version](https://img.shields.io/visual-studio-marketplace/v/GiteeInc.GiteeExtension.svg)
![Visual Studio Marketplace Installs](https://img.shields.io/visual-studio-marketplace/i/GiteeInc.GiteeExtension.svg)
![Visual Studio Marketplace Downloads](https://img.shields.io/visual-studio-marketplace/d/GiteeInc.GiteeExtension.svg)
![Visual Studio Marketplace Rating](https://img.shields.io/visual-studio-marketplace/r/GiteeInc.GiteeExtension.svg)

把 Gitee 工作流带进 Visual Studio 2026：登录、克隆、创建、发布、Pull Request、Issues、代码链接、Copilot 上下文和 MCP 配置，都在 IDE 内完成。

> 当前版本仅支持 Visual Studio 2026（18.x）Community / Professional / Enterprise。
> 测试反馈 QQ 群：**1020509603**

## ✨ 功能一览

| 场景 | 功能 |
| --- | --- |
| 🔐 登录 | 使用系统浏览器完成 Gitee OAuth；通过 SonnetDB Connect 交换 token，VSIX 不保存 app secret。 |
| 📦 仓库 | 查看已克隆仓库、克隆远程仓库、创建 Gitee 仓库、退出登录。 |
| 🚀 发布 | 在 Visual Studio Create Git Repository / Team Explorer 发布本地 Git 仓库到 Gitee。 |
| 🧩 模板 | 新建仓库可选择 Git ignore、License，并自动生成 Copilot/Agent 工作流模板。 |
| 🔀 Pull Request | 查看 PR、创建 PR、查看详情、刷新/新增评论、复制 PR 链接。 |
| ✅ Issues | 查看 Issues、选择 Issue 引用、复制 Issue/评论链接。 |
| 🔗 代码链接 | 打开分支、提交、Blame、Commits；复制文件链接和永久链接；从 Gitee URL 打开本地位置。 |
| 📝 代码片段 | 从当前文件或选区创建 Gitee 代码片段。 |
| 📚 项目入口 | 快速打开 Attachments、Wiki、Statistics 等 Gitee 页面。 |
| 🤖 Copilot | 一键复制 PR、Issue、文件/选区、提交、Release Notes 上下文给 Copilot。 |
| 🛠️ MCP | 生成 `.mcp.json`，接入 Gitee 官方远程 MCP 服务 `https://api.gitee.com/mcp`。 |

## 📥 安装

- 当前发布版本：[Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=GiteeInc.GiteeExtension)
- 最新构建版本：[Open VSIX Gallery](http://vsixgallery.com/extension/B1077C66-1666-4F60-BDFA-BA078FDABCCE/)
- 测试版说明：[docs/test-release.md](./docs/test-release.md)

测试反馈 QQ 群：**1020509603**

## 🚦 快速开始

1. 安装扩展并重启 Visual Studio 2026。
2. 打开 Team Explorer 的 Connect 页。
3. 在 Gitee 区点击登录，浏览器会打开授权页。
4. 授权完成后回到 Visual Studio，即可克隆、创建、发布仓库。
5. 打开 Gitee 菜单，可使用 PR、Issues、链接复制、Copilot 和 MCP 功能。

## 🔐 OAuth 安全说明

Gitee.VisualStudio 作为 Gitee 第三方应用使用 OAuth 登录，但客户端不保存 `client_secret`。

为避免 Gitee app `client_secret` 泄露，当前测试版暂时使用 `https://connect.sonnetdb.com/` 作为 token broker，由服务端代持 secret 并完成 token 交换。后续会根据 Gitee 平台能力和安全要求调整实现方式。

```text
VSIX -> 系统浏览器授权 -> VSIX 接收 code/state
     -> connect.sonnetdb.com token broker
     -> broker 使用服务端保存的 app secret 换 token
     -> VSIX 保存 access/refresh token
```

默认地址：

- 授权入口：`https://connect.sonnetdb.com/connect/oauth`
- Token broker：`https://connect.sonnetdb.com/oauth/token`

## 🤖 Copilot / MCP

Gitee 菜单提供面向 Copilot 和 coding agent 的上下文复制能力：

- 复制 PR / Issue / 文件 / 提交 / Release Notes 上下文。
- 打开或创建 `.github/copilot-instructions.md`、`.github/prompts/`。
- 打开或创建 `.agents/skills/gitee-workflow/SKILL.md`。
- 配置 Gitee MCP for Copilot，写入不含明文 token 的 `.mcp.json`。

更多说明见 [docs/copilot-mcp.md](./docs/copilot-mcp.md)。

## 🧪 测试版

当前测试版重点验证：

- Gitee OAuth 登录和 token 刷新。
- SonnetDB Connect broker 对接。
- 克隆、创建、发布、PR、Issues 基础工作流。
- Copilot 上下文复制和 MCP 配置。

测试说明见 [docs/test-release.md](./docs/test-release.md)，反馈请加入 QQ 群：**1020509603**。

## 🏗️ 开发构建

要求：

- Visual Studio 2026 18.x。
- Team Explorer 和扩展构建组件。
- .NET Framework 4.7.2 targeting pack。

常用命令见 [docs/build.md](./docs/build.md)。

## 🎬 演示

![Gitee Visual Studio demo](./docs/images/option.gif)

## 🙏 致谢

本软件最初采用悬赏方式由 @dilly 开发，代码借鉴了 GitHub for Visual Studio 源码。感谢所有参与过设计、实现、测试和反馈的贡献者。