# MITK-doc

**Repository Path**: noCH3COOH/mitk-doc

## Basic Information

- **Project Name**: MITK-doc
- **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-04-28
- **Last Updated**: 2026-04-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Plant Analysis Platform — SDK 文档总览

## 1. SDK 概要

**Plant Analysis Platform**（原名 PlantView）是一套基于 MITK（Medical Imaging Interaction Toolkit）的**植物领域专业医学影像分析平台**，由西安电子科技大学 MISA 实验室开发。

本 SDK 包含以下主要组件：

| 组件 | 说明 |
|------|------|
| **MISA-PlantView** | MISA-PlantView 源码及插件框架（含 AI 分割插件）|
| **MISA-LicenseManager** | 正版化许可证管理与激活服务 |
| **installer** | Windows 安装包制作配置 |
| **doc** | 项目文档集 |

---

## 2. SDK 文件结构

```bash
${YOUR_SDK_PATH}\               # SDK 根目录
│
├── MISA-PlantView/             # ★ Git 工程 — MITK 源码及插件
│   ├── CMakeLists.txt          # 超级构建入口
│   ├── SuperBuild.cmake        # 超级构建定义
│   ├── CMake/                  # MITK CMake 宏/模块
│   ├── CMakeExternals/         # 第三方依赖 CMake 配置
│   ├── Modules/               # MITK 功能模块（Core、QtWidgets、Segmentation 等）
│   ├── Plugins/                # MITK 插件（gui.qt.application、aisegement 等）
│   ├── Applications/           # 应用入口（MITK Workbench）
│   └── scan_translation.bat    # Qt 翻译扫描脚本
│
├── MISA-LicenseManager/        # ★ Git 工程 — 正版化管理系统
│   ├── backend/               # Docker Compose 部署配置（Nginx + MySQL + Redis）
│   ├── backend_app/           # Go 后端 API 服务
│   ├── backend_manager/       # Python 自动化运维程序
│   ├── frontend/             # PySide6 许可证管理界面
│   ├── toolkit/              # 许可证生成/校验工具集
│   ├── document/             # 许可证系统详细文档
│   └── readme.md            # LicenseManager 自述文件
│
├── installer/                   # ★ Git 工程 — 安装包制作
│   ├── config/               # CPack / NSIS 配置
│   └── packages/            # 安装包组件定义
│
├── doc/                       # ★ Git 工程 — 项目文档集
│   ├── readme.md            # ★ 文档总览（本文档）
│   ├── project_overview.md   # MITK 总工程说明
│   ├── directory_structure.md # 目录结构详细说明
│   ├── code_style.md        # 代码风格规范
│   ├── used_mitk_api.md     # 已使用 MITK API 清单
│   ├── plugin_aisegment.md   # AI Segment 插件逻辑说明
│   ├── i18n_switch_logic.md  # 多语言切换逻辑说明
│   ├── mitk_build_guide.md   # MITK 构建指南
│   ├── plugin_framework.md   # BlueBerry 插件框架说明
│   ├── MITK编译过程.md       # MITK 编译详细步骤
│   ├── MITK.diff.md         # MITK.diff 分类总结
│   └── MITK.diff            # MITK 所有改动的完整 diff
│
├── build/                     # 构建输出目录（无需下载，CMake 自动生成）
│
└── resources/                # ★ 单独下载 — 应用资源（百度云）
    ├── icon_*.png            # 各尺寸应用图标
    ├── icon_*.ico            # Windows .ico 格式图标
    ├── theme_icons/          # 主题图标集
    ├── lang_zh_CN.ts/.qm     # 中文翻译文件
    ├── lang_en_US.ts/.qm     # 英文翻译文件
    └── svg_output/           # SVG 中间格式图标
```

---

## 3. SDK 下载教程

本 SDK 分为两部分：

### 3.1 Git 工程下载

MISA-PlantView、MISA-LicenseManager、installer、doc 为四个**独立的 Git 工程**，需分别克隆到同一目录下：

```bash
# 创建 SDK 根目录
mkdir ${YOUR_SDK_PATH}
cd ${YOUR_SDK_PATH}

# 1. 克隆 MISA-PlantView（含 .gitmodules 子模块配置）
git clone https://${GIT_URL}/${YOUR_ORG}/MISA-PlantView.git MISA-PlantView
cd MISA-PlantView && git submodule update --init --recursive && cd ..
# 子模块会拉取 Plugins/org.mitk.gui.qt.aisegement 插件

# 2. 克隆 MISA-LicenseManager（许可证管理系统）
git clone https://${GIT_URL}/${YOUR_ORG}/MISA-LicenseManager.git MISA-LicenseManager

# 3. 克隆 installer（安装包制作配置）
git clone https://${GIT_URL}/${YOUR_ORG}/installer.git installer

# 4. 克隆 doc（项目文档集）
git clone https://${GIT_URL}/${YOUR_ORG}/doc.git doc
```

> **说明**：MISA-PlantView 的 `.gitmodules` 中已配置 `Plugins/org.mitk.gui.qt.aisegement` 为子模块，`git submodule update --init --recursive` 会自动将其克隆到正确路径，无需手动下载。

### 3.2 resources 资源包下载

应用图标、主题图标、多语言翻译文件等大型二进制资源**不存入 Git**，需单独下载：

> **TODO：百度云链接待补充**
>
> ```text
> 链接：https://pan.baidu.com/s/xxxxxx
> 提取码：xxxx
> ```

下载后，将 `resources/` 文件夹解压到 SDK 根目录 `D:\MITK-noch3cooh\resources\`，覆盖（如有）。

### 3.3 目录对应关系

| 文件夹 | 来源 | 大小 |
|--------|------|------|
| `MISA-PlantView/` | Git 克隆 | ~数百 MB（含子模块）|
| `MISA-LicenseManager/` | Git 克隆 | ~数十 MB |
| `installer/` | Git 克隆 | ~数 MB |
| `doc/` | Git 克隆 | ~数 MB |
| `resources/` | 百度云下载 | ~数十 MB |
| `build/` | 本地 CMake 生成 | 视构建配置而定 |

---

## 4. 快速开始

### 4.1 环境要求

| 项目 | 版本 |
|------|------|
| 操作系统 | Windows 10 Pro 64-bit |
| CMake | 3.18+ |
| Visual Studio | VS 2022（MSVC）|
| Qt | 5.12.9（msvc2017_64）|
| Python | 3.10+（用于 LicenseManager 前端和 toolkit）|
| Docker | 20.10+（用于 LicenseManager 部署）|

### 4.2 构建 MISA-PlantView

详细步骤见 [MITK编译过程.md](MITK编译过程.md) 或 [mitk_build_guide.md](mitk_build_guide.md)。

### 4.3 部署许可证服务

```bash
cd MISA-LicenseManager/backend
docker-compose up --scale app=3 -d --build
```

详细说明见 `MISA-LicenseManager/readme.md`。

---

## 5. 文档索引

| 文档 | 内容 |
|------|------|
| [project_overview.md](project_overview.md) | MISA-PlantView 总工程说明、架构、依赖 |
| [directory_structure.md](directory_structure.md) | 完整目录结构说明 |
| [code_style.md](code_style.md) | C++/Qt 代码风格规范 |
| [used_mitk_api.md](used_mitk_api.md) | 已使用的 MITK API 清单 |
| [plugin_aisegment.md](plugin_aisegment.md) | AI 分割插件逻辑与流程图 |
| [i18n_switch_logic.md](i18n_switch_logic.md) | 多语言切换逻辑与流程图 |
| [mitk_build_guide.md](mitk_build_guide.md) | MITK 构建指南 |
| [plugin_framework.md](plugin_framework.md) | BlueBerry 插件框架说明 |
| [MITK编译过程.md](MITK编译过程.md) | 编译详细步骤 |