# 极客伴侣

**Repository Path**: tianyeHome/WinDevMate

## Basic Information

- **Project Name**: 极客伴侣
- **Description**: 极客伴侣（WinDevMate）：一款专为 Windows 开发者打造的跨端开发与效率管家。全本地、零收费、开源免费。包含证书管家、TestFlight直传、云端编译调度、免App投屏、局域网快传与App备案助手。让 iOS 开发彻底告别对 Mac 的依赖！
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-10-21
- **Last Updated**: 2026-10-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WinDevMate (极客伴侣)

> **Windows 开发者的全能跨端工具箱：全本地、零收费、开源免费。**
> 打破 Mac 硬件垄断，告别黑心代办收费，让跨端开发回归极简！

<p align="center">
  <a href="https://gitee.com/tianyeHome/WinDevMate/stargazers"><img src="https://gitee.com/tianyeHome/WinDevMate/badge/star.svg?theme=dark" alt="star"></a>
  <a href="https://gitee.com/tianyeHome/WinDevMate/members"><img src="https://gitee.com/tianyeHome/WinDevMate/badge/fork.svg?theme=dark" alt="fork"></a>
  <img src="https://img.shields.io/badge/Flutter-3.x-blue?logo=flutter" alt="Flutter">
  <img src="https://img.shields.io/badge/License-Apache--2.0-green" alt="License">
  <img src="https://img.shields.io/badge/Platform-Windows-0078D6?logo=windows" alt="Platform">
</p>

---

## 🚀 核心功能 (V0.2.0)

### 🛡️ 证书管家 —— 全平台本地生成，隐私零泄露
*   **iOS**：一键生成 CSR、合成 P12、解析描述文件（自动提取 UDID 与过期时间）。
*   **Android**：一键生成 `.p12` / `.keystore` 签名密钥（纯 OpenSSL 实现，**彻底告别 Java 环境**）。
*   **HarmonyOS**：一键生成 `.p12` 与 `.csr`，无缝对接华为 AGC 后台，内置四步换证教程弹窗与深色模式自适应。

### 🚀 上架直通车 —— 免 Mac 直传 TestFlight
*   纯 Windows 环境，无需安装 Java，无需 Mac。
*   一键调用 App Store Connect API（JWT 鉴权）。
*   自动解析 IPA 包内 `Info.plist` 获取真实版本号与构建号。
*   大文件分块上传，直传 TestFlight 与 App Store。

### 📺 ShowCase 投屏演示 —— 开会演示、多端测试神器
*   **Android**：基于 Scrcpy 协议，免安装 App，USB 连接极速投屏，**支持鼠标反向控制**。
*   **iOS**：基于 UxPlay 与 BLE 信标，**免配置**，支持 iPhone 屏幕镜像投射。
*   **组件导入**：支持本地一键导入 ZIP 压缩包，自动解压、MD5 校验、缓存复用，按需加载避免安装包膨胀。
*   **组件缺失引导**：自动检测投屏组件，缺失时弹出精美引导弹窗，一键跳转浏览器下载。

### 📡 隔空快传 —— 局域网文件互传，手机扫码即用
*   纯 Dart HttpServer 实现，零第三方依赖。
*   内嵌 HTML 上传页面（暗黑主题），支持拖拽上传、多文件上传、实时进度、超时容错。
*   手机扫码即可在浏览器中上传文件到电脑，免装 App。
*   三层级联接收目录：用户自定义 → 系统下载目录 → 文档目录兜底，重启不丢失。
*   GetStorage 持久化传输记录，最多保留 50 条，自动清理幽灵文件。
*   网页端图标与电脑端侧边栏 `wifi_tethering` 图标 100% 统一。

### 📋 App 备案助手 —— 工信部合规材料一键生成
*   支持从 `.p12` / `.jks` 证书提取签名公钥。
*   自动生成标准格式工信部承诺书模板，内嵌备案提交实操提示（格式转换、签字扫描、公钥脱壳、信息一致性）。
*   图标规格化（512x512 圆角 PNG）与截图尺寸校验。
*   按阿里云/腾讯云标准目录结构打包合规材料 ZIP。

### ⚙️ 自动化打包 —— CI/CD 配置文件生成器
*   支持 GitHub Actions、Gitee Go、Fastlane 三种 CI/CD 模板。
*   多平台构建选择（iOS/Android/Windows/鸿蒙）。
*   证书路径自动填充，配置实时预览。
*   一键导出 YAML/Fastfile 到项目目录。

---

## 📦 下载与安装

由于核心投屏组件体积较大，Gitee 无法直接托管，请按以下步骤下载并配置：

1.  **下载核心组件**（请复制链接到浏览器打开）：
    *   **Scrcpy (Android 投屏组件)**：https://cloud.189.cn/t/JvIVfiv6Zfei （访问码：rkb6）
    *   **UxPlay (iOS 投屏组件)**：https://cloud.189.cn/t/uQrUfayYVbQ3 （访问码：vx1d）

2.  **放置组件**：
    *   将下载的两个 `.zip` 压缩包解压。
    *   把解压出来的所有文件（`.exe`、`.dll` 等），统一放入项目的 `WinDevMate/assets/bin/` 目录下。

3.  **编译运行**：
    ```bash
    flutter pub get
    flutter run -d windows
    ```

---

## 💻 本地开发

### 环境要求
*   Flutter SDK (3.x 或更高)
*   Visual Studio 2022 (包含“使用 C++ 的桌面开发”工作负载)

### 快速开始
```bash
# 1. 克隆代码
git clone https://gitee.com/tianyeHome/WinDevMate.git

# 2. 进入项目目录
cd WinDevMate

# 3. 拉取依赖
flutter pub get

# 4. 运行
flutter run -d windows
```

### 常用命令
```bash
# 清理构建缓存
flutter clean

# 构建 Windows 发布版
flutter build windows
```

---

## 📂 项目结构

```text
WinDevMate/
├── lib/
│   ├── app/
│   │   ├── core/          # 路由、主题、常量
│   │   ├── data/
│   │   │   ├── models/    # 数据实体
│   │   │   └── services/  # 核心服务（OpenSSL、App Store API、Scrcpy、UxPlay）
│   │   └── features/
│   │       ├── cert/      # 证书管家
│   │       ├── upload/    # 上架直通车
│   │       ├── showcase/  # ShowCase 投屏
│   │       └── home/      # 主框架与侧边栏
│   └── main.dart
├── assets/
│   └── bin/               # 存放 scrcpy / uxplay 等核心组件
├── windows/               # Windows 原生工程
├── pubspec.yaml
└── README.md
```

---

## 🗺️ 路线图 (Roadmap)

- [x] **V0.1.0**：证书管家（iOS/Android/鸿蒙）、上架直通车、ShowCase 投屏
- [x] **V0.2.0**：隔空快传、App 备案助手、自动化打包配置生成器、投屏组件缺失引导
- [ ] **V0.3.0**：
  - 🚀 **CI/CD 一键触发**：安全存储 Token、云端触发打包、实时进度轮询、产物下载与二维码、SSH 远程调度
  - 📸 **极速截图与标注**：Win32 API 重写、Ctrl+Alt+Q 唤起、标注系统、截图贴图 (Pin) 悬浮
  - 🌐 **模块体验补齐**：隔空快传双向化、证书生命周期管理、组件自动更新引擎

---

## ❤️ 支持与赞助

如果这个工具帮你省下了买 Mac 的钱，或者帮你省下了几百块的代办费，欢迎在软件内的“支持与公告”中请开发者喝杯咖啡。

**你的每一份鼓励都是前进的动力！**

---

## 📄 开源协议

本项目采用 [Apache-2.0](LICENSE) 协议开源。

---

## ⭐ Star History

如果觉得项目对你有帮助，欢迎点个 Star 支持一下！

[![Star History Chart](https://api.star-history.com/svg?repos=tianyeHome/WinDevMate&type=Date)](https://star-history.com/#tianyeHome/WinDevMate&Date)

---

> **免责声明**：本工具仅供学习与开发辅助使用。使用本工具生成的证书、上传的 App 等行为，请遵守 Apple、Google、华为等平台的相关开发者协议。