# github2gitee

**Repository Path**: shellpub/github2gitee

## Basic Information

- **Project Name**: github2gitee
- **Description**: github同步gitee浏览器插件插件，一键克隆仓库到gitee，同步代码到gitee
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-01
- **Last Updated**: 2026-10-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# github2gitee

[English](./README.md) | 中文

浏览器扩展（Chrome / Edge / Firefox），借助 **Gitee 官方导入 / 同步能力**，帮助你把 **GitHub 仓库导入并同步到 Gitee**。

扩展只做**流程编排**：真正的仓库传输由 Gitee 服务端完成，无需自建同步后端。

## 安装

### 应用商店

- [Chrome 应用商店](https://chromewebstore.google.com/detail/github-to-gitee-sync/nnagmegpcpccmjamkalldepoojpiadfb)
- [Firefox 附加组件 (AMO)](https://addons.mozilla.org/zh-CN/firefox/addon/github-to-gitee-sync/)
- [Microsoft Edge 扩展](https://microsoftedge.microsoft.com/addons/detail/hfcfhlcddnfeghcblknfkiimplfgbjli)

### 本地加载（开发）

```bash
cd extension
npm install
npm run build
```

加载未打包扩展：

- Chrome / Edge：`extension/dist/chrome`
- Firefox（临时）：`about:debugging` → 临时载入附加组件 → `extension/dist/firefox/manifest.json`

然后打开**设置**，粘贴 Gitee 访问令牌，在 GitHub 仓库页使用右下角浮层操作。

### 发布用 zip（测试 / 商店上传）

```bash
cd extension
npm run pack
```

压缩包输出到 `extension/release/`（`*-chrome.zip`、`*-firefox.zip`），不包含 source map。

## 使用

1. 设置：填写 **Gitee access token**（可选：语言、轮询间隔）
2. 打开 GitHub 仓库 → 展开浮层按钮 → **导入到 Gitee**
3. 在 Gitee 完成导入 → 在面板 / 弹窗中确认（或等待自动识别）
4. 之后：**立即同步**（优先尝试 mirror pull，否则打开 Gitee「同步更新」）
5. 扩展弹窗：管理映射；设置页：仅令牌与语言等全局配置

## 文档

| 文档 | 路径 |
|------|------|
| 产品需求 | [`doc/prd-github2gitee-extension.md`](./doc/prd-github2gitee-extension.md) |
| 发布检查清单 | [`doc/release-checklist.md`](./doc/release-checklist.md) |
| 商店文案草稿 | [`doc/store-listing.md`](./doc/store-listing.md) |
| 商店截图与粘贴文案 | [`doc/store-assets/`](./doc/store-assets/) |
| 隐私政策 | [`doc/privacy-policy.md`](./doc/privacy-policy.md) |
| 设计说明 | [`doc/design-github2gitee-extension.md`](./doc/design-github2gitee-extension.md) |

## 组件

| 路径 | 作用 |
|------|------|
| `extension/` | 浏览器扩展（交付物） |
| `doc/` | 需求、设计与发布材料 |

## 产品决策

- 优先使用 Gitee 官方 **导入** + **同步更新** / Pull mirror
- 纯扩展方案
- MVP 面向公开仓库；支持 Chrome / Edge / Firefox
- 先支持本地加载；正式上架商店另见发布检查清单

## 许可证

[MIT](./LICENSE)