# HypetHL

**Repository Path**: supergren/hypet-hl

## Basic Information

- **Project Name**: HypetHL
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-13
- **Last Updated**: 2026-08-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HaiLin · 海灵智能体

基于 **Tauri 2 + React + Vite + TypeScript + Rust** 构建的桌面智能体应用，
采用**前后端分离**目录结构：前端 `frontend/`，后端（Tauri 核心）`backend/`。

> 说明：项目**对外名称**为 **HaiLin（海灵智能体）**；仓库目录与内部技术标识符
> （Rust crate 名 `hypethl`、后端命令 `chat_with_hailing`、前端 store key `hypethl_*` 等）
> 为保持编译兼容暂不重命名。

## 目录结构

```
HaiLin/  (仓库目录名仍为 HypetHL/)
├── frontend/                 # 前端：React 18 + Vite 5 + TypeScript
│   ├── src/
│   │   ├── components/Chat.tsx   # 聊天界面
│   │   ├── App.tsx                # 主界面 + 内核连接
│   │   ├── main.tsx               # 入口
│   │   └── styles.css             # 样式
│   ├── index.html
│   ├── package.json               # 前端依赖与 dev/build 脚本
│   ├── vite.config.ts             # 运行在 localhost:1420
│   └── tsconfig*.json
├── backend/                  # 后端：Rust + Tauri 2（桌面核心）
│   ├── src/
│   │   ├── main.rs                # 入口
│   │   └── lib.rs                 # 应用构建 + Tauri 命令
│   ├── capabilities/default.json # 权限声明（Tauri 2 安全模型）
│   ├── icons/                     # 应用图标
│   ├── Cargo.toml                 # Rust 依赖
│   ├── tauri.conf.json            # 窗口/打包配置（frontendDist 指向 ../frontend/dist）
│   ├── build.rs
│   └── package.json               # 仅承载 tauri CLI 脚本
└── README.md
```

## 前后端通信

前端通过 `@tauri-apps/api` 调用后端 Rust 命令（`#[tauri::command]`）：

- `greet(name)` —— 前后端桥接自检
- `chat_with_hailing(prompt)` —— 转发到本地 Ollama `deepseek-r1:8b`

```ts
import { invoke } from "@tauri-apps/api/core";
const reply = await invoke("chat_with_hailing", { prompt: "你好" });
```

## 环境前置（macOS）

```bash
# 1. Rust 工具链（Tauri 编译后端必须）
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
# 2. Xcode 命令行工具
xcode-select --install
# 3. Node ≥ 18（当前 v26）
```

## 开发与运行

```bash
# 安装前端依赖
cd frontend && npm install

# 安装后端 tauri cli（只需一次）
cd ../backend && npm install

# 启动应用（会自动拉起前端 dev server 并编译 Rust 后端）
cd backend && npm run tauri dev
```

## 构建产物

```bash
cd backend && npm run tauri build
# 输出 .app / .dmg 到 backend/target/release/bundle
# 安装：打开 backend/target/release/bundle/dmg/ 下的 HaiLin.dmg，将 HaiLin.app 拖入 /Applications
```

## 模型依赖

对话功能依赖本地 Ollama：

```bash
ollama pull deepseek-r1:8b
ollama serve   # 默认 http://localhost:11434
```