# kkhost

**Repository Path**: kk-karl/kkhost

## Basic Information

- **Project Name**: kkhost
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MPL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-03
- **Last Updated**: 2026-09-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# kkhost Chrome V3 代理管理扩展

kkhost 是一款现代化的 Chrome V3 代理管理扩展，继承自经典的 Proxy SwitchyOmega，提供直观的界面和强大的代理配置管理能力。

## 功能特性

- **多协议支持**：HTTP、HTTPS、SOCKS4、SOCKS5
- **情景模式**：固定代理、PAC 代理、自动切换、虚情景模式
- **规则系统**：域名匹配、URL 模式、IP 范围、正则表达式
- **快速切换**：一键切换代理配置
- **导入导出**：支持配置文件导入导出和 SwitchyOmega 迁移

## 项目结构

```
kkhost/
├── public/                    # 静态资源
│   ├── manifest.json         # Chrome 扩展配置
│   └── icons/                # 扩展图标
├── src/
│   ├── background/           # 后台脚本（Service Worker）
│   │   ├── index.ts         # 消息处理入口
│   │   ├── storage-manager.ts  # 存储管理
│   │   ├── proxy-engine.ts    # 代理引擎
│   │   └── rule-matcher.ts   # 规则匹配器
│   ├── popup/                # 弹出窗口
│   │   ├── App.vue           # 主组件
│   │   ├── main.ts           # 入口
│   │   └── index.html        # HTML 模板
│   ├── options/              # 选项页面
│   │   ├── App.vue           # 主组件
│   │   ├── main.ts           # 入口
│   │   └── index.html        # HTML 模板
│   ├── stores/               # Pinia 状态管理
│   ├── types/                # TypeScript 类型定义
│   └── styles/               # 全局样式
├── package.json              # 项目配置
├── vite.config.ts           # Vite 构建配置
└── tsconfig.json            # TypeScript 配置
```

## 开发指南

### 环境要求

- Node.js >= 18
- npm >= 9

### 安装依赖

```bash
npm install
```

### 开发模式

```bash
npm run dev
```

### 构建生产版本

```bash
npm run build
```

构建产物将输出到 `dist` 目录。

### 加载扩展到 Chrome

1. 打开 Chrome，进入 `chrome://extensions/`
2. 开启右上角的"开发者模式"
3. 点击"加载已解压的扩展程序"
4. 选择项目的 `dist` 目录

## 技术栈

- **前端框架**：Vue 3.4+ + TypeScript
- **状态管理**：Pinia
- **样式框架**：TailwindCSS
- **构建工具**：Vite 5
- **Chrome API**：Manifest V3

## 功能模块

### 1. 代理服务器管理

添加、编辑、删除代理服务器配置，支持多种代理协议。

### 2. 情景模式

- **直接连接**：不使用代理
- **固定代理**：使用单个代理服务器
- **PAC 代理**：使用 PAC 脚本自动选择代理
- **自动切换**：基于规则列表自动切换代理
- **虚情景模式**：组合多个情景模式

### 3. 规则系统

支持多种规则类型：
- 域名匹配（精确和通配符）
- URL 模式匹配
- IP 范围匹配（CIDR）
- 正则表达式

### 4. 订阅规则

支持从 URL 订阅在线规则列表（如 GeoProxy、gfwlist）。

## 数据模型

- `ProxyServer`：代理服务器配置
- `Profile`：情景模式配置
- `Rule`：自动切换规则
- `RuleSubscription`：规则订阅
- `Settings`：用户设置

## License

MIT License