Company Git Plugin

企业私服项目拉取插件使用说明。

1. 安装插件

方式 A：通过 VSIX 文件安装（推荐）

1. 打开 VS Code。
2. 进入扩展面板。
3. 点击右上角 ...。
4. 选择 Install from VSIX...。
5. 选择插件安装包 .vsix 文件。
6. 安装完成后重载窗口。

方式 B：命令行安装

code --install-extension company-git-pull-1.0.0.vsix

2. 生成私服 Token

以下以常见 Gitea 私服为例：

1. 登录私服网页。
2. 打开右上角头像菜单，进入 Settings。
3. 找到 Applications 或 Access Tokens 页面。
4. 新建 Personal Access Token。
5. 勾选仓库读取相关权限（如repository-Read,organization-Read）（至少需要读取仓库与分支权限）。
6. 生成后立即复制并保存 Token（页面通常只显示一次）。

注意：

• Token 为敏感信息，请勿提交到代码仓库或发到群聊。
• 如果 Token 过期或权限不足，会导致项目/分支加载失败或克隆失败。

3. 配置并使用插件

安装后，在 VS Code 左侧活动栏打开 企业私服 -> 项目拉取。

3.1 首次配置（必填项）

请完整填写以下字段：

• 私服地址目前http://10.2.3.10:3000/
• 访问令牌 Token（上面gitee生成）
• Git 用户名
• Git 邮箱
• 本地路径（必须是已存在的空目录）

然后点击 保存并同步。

说明：

• Token 输入框右侧有“眼睛”按钮，可显示/隐藏内容，便于核对。
• 本地路径支持手动输入，也支持点击选择路径。

3.2 拉取项目

1. 在项目搜索框输入关键字（支持仓库名、owner/repo、完整仓库 URL）。
2. 在项目下拉框选择目标仓库。
3. 在分支下拉框选择目标分支。
4. 按需选择：
   • 自动安装依赖
   • 自动运行
5. 点击 开始克隆。

3.3 克隆后的行为

• 插件会将仓库克隆到你填写的空目录。
• 插件会对当前仓库写入本地 Git 身份：
  • git config user.name
  • git config user.email
• 上述配置为仓库级配置，不会修改全局 Git。

4. 常见提示

• 提示请完整填写后再克隆：有必填项为空，请补全后重试。
• 提示目标路径必须是空文件夹：请更换到空目录。
• 提示认证失败：请检查私服地址、Git 用户名与 Token 是否匹配。