# TakeLink

**Repository Path**: ph2017_admin/TakeLink

## Basic Information

- **Project Name**: TakeLink
- **Description**: No description available
- **Primary Language**: HTML
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-05
- **Last Updated**: 2026-04-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TakeLink - 局域网远程控制 Claude Code

> 手机端直接控制电脑上的 Claude Code，无需云端服务器，零延迟，完全私密。

[English](README.md)

## 架构

```
┌─────────────────┐              ┌─────────────────────┐
│   手机 App      │  ←─ WebSocket ──→ │      电脑 CLI       │
│  (Capacitor)    │              │                     │
│                 │              │  HTTP Server :8080  │
│  扫码连接       │              │  WebSocket Server   │
│  发送/接收消息   │              │  Claude 进程管理    │
└─────────────────┘              └─────────────────────┘
                                        │
                                        ▼
                              ┌─────────────────────┐
                              │   Claude Code CLI   │
                              └─────────────────────┘
```

## 快速开始

### 1. 电脑端 (CLI)

**Windows:**
```bash
cd TakeLink\cli
start.bat          # 双击运行，自动安装依赖并启动
```

**Mac/Linux:**
```bash
cd TakeLink/cli
./start.sh         # 自动安装依赖并启动
```

**或手动运行:**
```bash
cd cli
pnpm install
pnpm dev
```

运行后会显示 QR 码：

```
🚀 TakeLink - 局域网远程终端
────────────────────────────────────────

📱 手机扫描二维码连接:

████████████████
████████████████
███ ██ ███ █ ███
...

   手机端: http://192.168.1.100:8080/app
   桌面端: http://192.168.1.100:8080

────────────────────────────────────────
```

### 2. 手机端

**方式一：浏览器直接打开 (推荐)**

1. 确保手机和电脑在同一 WiFi
2. 手机浏览器打开 `http://192.168.1.100:8080/app`
3. 开始对话！

**方式二：Capacitor App (Android)**

```bash
cd cli
pnpm run cap:build
# 在 Android Studio 中构建 APK
```

### 3. 桌面浏览器测试

电脑或其他设备打开 `http://192.168.1.100:8080` 即可测试。

## 项目结构

```
TakeLink/
├── cli/                    # 电脑端
│   ├── src/
│   │   └── index.ts       # 主程序
│   ├── public/            # Web 资源
│   ├── package.json
│   └── tsconfig.json
├── android/                # Android App (生成)
└── README.md
```

## 功能特性

- ✅ 局域网直连，无需云端
- ✅ QR 码扫描连接
- ✅ 实时消息收发
- ✅ 支持多手机同时连接
- ✅ 浏览器直接测试
- ✅ 本地终端也可输入
- ✅ 零延迟 (<10ms)
- ✅ 完全私密（数据不离开局域网）
- ✅ 终端彩色输出（ANSI 支持）
- ✅ 多终端管理（启动/选择/切换）

## 配置

默认启动命令为 `claude`，可通过环境变量自定义：

```bash
# Windows
set CLAUDE_COMMAND=g:\my-script.bat
pnpm dev

# Mac/Linux
CLAUDE_COMMAND=/path/to/script pnpm dev
```

## 扩展方向

1. **端到端加密**: 添加 TweetNaCl 加密
2. **文件传输**: 支持发送文件
3. **会话历史**: 本地保存对话记录
4. **多代理支持**: 支持 Codex、Gemini
5. **推送通知**: 后台时接收通知
6. **语音输入**: 语音转文字

## 致谢

本项目借鉴了 Happy Code、Claude TUI 等优秀项目的设计思路。

## 版本

v1.1.9

## 许可证

MIT