# Ontoify

**Repository Path**: jonas218/ontoify

## Basic Information

- **Project Name**: Ontoify
- **Description**: Ontify 是一款基于 Tauri 2 的桌面端 OWL 2 本体编辑器，提供本体编辑、多引擎推理、知识图谱可视化和 AI Copilot 辅助编辑能力。纯 Rust 后端，本地优先，无需云端。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-06-30
- **Last Updated**: 2026-08-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Ontoify — 本体编辑器 / Ontology Editor

基于 Tauri 2 + React + Rust 的桌面端本体（OWL）编辑器。

## 快速开始

### 前置要求

| 工具 | 版本 | 用途 |
|------|------|------|
| Node.js | ≥ 18 | 前端构建 |
| Rust | stable (≥ 1.75) | Tauri + oxigraph |
| Java **JDK** ≥ 17 | **可选** | HermiT 推理（不装不影响基本功能） |
| Maven | **可选** | HermiT JAR 构建 |

### 安装与运行

```bash
# 1. 安装前端依赖
npm install

# 2. 开发模式启动
npm run tauri dev
```

首次启动会编译 Rust 后端（约 2-5 分钟），之后增量编译很快。

### 生产构建

```bash
# 构建当前平台的安装包
npm run tauri build
```

产物在 `src-tauri/target/release/bundle/` 目录。

---

## HermiT OWL DL 推理（可选功能）

项目支持三种推理模式：

- **RDFS 推理**（默认）— 纯 Rust 实现，开箱即用
- **HermiT 完整推理**（OWL DL）— 需要 Java + JRE 环境
- **Strix 推理**（OWL 2 DL）— 纯 Rust 实现，实验性

### 启用 HermiT 推理

```bash
# 需要: JDK 17+ + Maven

# 构建 JAR
cd hermit-sidecar
mvn clean package -DskipTests

# JAR 会自动复制到 src-tauri/binaries/
cp target/hermit-sidecar.jar ../src-tauri/binaries/
```

或者直接执行 `build.sh`（macOS/Linux）一键完成。

完成后重启应用，状态栏选择 "HermiT 完整" 即可。

> HermiT 需要 Java 运行时环境，用户需自行安装 JDK 17+ 并确保 `java` 在 PATH 上。

---

## 在 Windows 上构建

推荐直接在 Windows 机器或虚拟机上本地编译（交叉编译不可靠，Tauri 原生插件对 Windows API 有依赖）。

### 前置条件

- [Visual Studio 2022 Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022)（勾选「使用 C++ 的桌面开发」+ Windows SDK）
- [Rust](https://rustup.rs/)（`rustup` 安装）
- [Node.js](https://nodejs.org/) ≥ 18
- [JDK 17+](https://adoptium.net/) + Maven（如需 HermiT 推理，可选）

### 构建

```powershell
# 构建 HermiT JAR（可选）
cd hermit-sidecar
mvn clean package -DskipTests
cp target/hermit-sidecar.jar ..\src-tauri\binaries\
cd ..

# 开发模式
npm install
npm run tauri dev

# 生产构建（生成 NSIS 安装包）
npm run tauri build
```

产物路径：`src-tauri\target\release\bundle\nsis\`

---

## 项目结构

```
ontify/
├── src/                          # React 前端
│   ├── components/               # UI 组件
│   ├── stores/                   # Zustand 状态管理
│   └── services/                 # API 调用（Tauri commands）
├── src-tauri/                    # Tauri + Rust 后端
│   ├── src/
│   │   ├── commands/             # Tauri 命令（IPC）
│   │   ├── model/                # 数据模型（serde）
│   │   ├── reason/               # 推理引擎（RDFS + HermiT + Strix）
│   │   └── store/                # oxigraph 存储层（RDF/OWL）
│   ├── binaries/
│   │   └── hermit-sidecar.jar    # HermiT JAR（需手动构建）
│   └── builtin-ontologies/       # 内置本体库
├── hermit-sidecar/               # HermiT 侧车（Java）
│   └── pom.xml                   # Maven 配置
└── package.json
```

## 技术栈

| 层 | 技术 |
|----|------|
| 前端框架 | React 19 + TypeScript |
| 构建工具 | Vite 6 |
| 桌面框架 | Tauri 2 |
| 后端语言 | Rust |
| RDF/OWL 存储 | oxigraph (纯 Rust) |
| OWL 推理 | RDFS 内置 + HermiT (Java sidecar) + Strix (Rust) |
| 图可视化 | Three.js / Cytoscape |
| 状态管理 | Zustand 5 |