# model-packaging-tool

**Repository Path**: openkylin/model-packaging-tool

## Basic Information

- **Project Name**: model-packaging-tool
- **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-11
- **Last Updated**: 2026-08-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Kylin 模型打包工具

这是 `add-model-packaging-tool` OpenSpec 变更的首阶段实现代码，位于独立目录 `model-packaging-tool/`。

首阶段范围：

- Tauri 桌面端应用骨架。
- 本地模型文件/目录导入，包括拖拽路径处理。
- 本地模型包目录生成：`<model_name>/1`、`config.pbtxt`、`model_description.yaml`。
- 允许编辑的模型元数据字段校验和模板渲染。
- 云端仓库接入真实接口：从 `default.json` 拉取模型清单并断点续传下载，下载产物可直接打包。

运行依赖：

- Node.js（建议 18 及以上）及其包管理器（npm 等）
- Rust 工具链（`cargo`、`rustc`，建议通过 rustup 安装，需 1.77.2 及以上；openKylin apt 源中的 1.75.0 版本低于 Tauri 2 的 MSRV，请勿使用）
- Linux 系统依赖（openKylin/Ubuntu/Debian）：`libwebkit2gtk-4.1-dev`、`libjavascriptcoregtk-4.1-dev`、`libsoup-3.0-dev`、`libgtk-3-dev`（提供 `gdk-3.0`）、`libayatana-appindicator3-dev`、`librsvg2-dev`、`libxdo-dev`、`libssl-dev`、`pkg-config`、`build-essential`、`curl`、`wget`、`file`

一键安装：

```bash
# 1. 安装 Linux 系统依赖
sudo apt update
sudo apt install -y libwebkit2gtk-4.1-dev libjavascriptcoregtk-4.1-dev libsoup-3.0-dev \
  libgtk-3-dev libayatana-appindicator3-dev \
  librsvg2-dev libxdo-dev libssl-dev pkg-config build-essential curl wget file

# 2. 安装 Rust 工具链（rustup，官方推荐方式）
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y

# 3. 在当前 shell 加载 cargo 环境变量（新开终端会自动生效）
source "$HOME/.cargo/env"

# 4. 校验安装
cargo --version
rustc --version
```

常用命令：

```bash
npm install
npm run dev
npm run tauri dev
npm test
cd src-tauri && cargo test
```

云端真实下载已接入：在“云端仓库”步骤选择模型后点击“开始下载模型”，系统会从 `https://archive2.kylinos.cn/LLM/KYLIN/branches/default.json` 获取模型的文件清单，并按 `https://archive2.kylinos.cn/LLM/KYLIN/models/<subPath>/<文件名>` 下载清单中的全部文件（权重 + config.pbtxt + model_description.yaml 等），支持断点续传与 SHA-256 校验；下载进度按所有文件的整体大小计算。下载完成自动流转到“确认信息”并执行打包。

UI 对齐设计图后的增强功能：

- **原生文件选择器**：本地模型选择页提供“选择本地文件或目录”按钮，调用操作系统原生文件对话框选择模型文件，拖拽路径输入仍保留。
- **模型能力下拉多选**：确认信息页的“模型能力”字段使用预定义下拉多选（text/vision/tools/embedding/code/rewrite），已选项以 tag 展示，支持自定义输入。
- **保存目录浏览按钮**：确认信息页的“保存目录”字段提供“浏览”按钮，调用原生目录选择对话框。
- **已选模型只读信息**：确认信息页表单上方展示已选模型的只读信息卡片（来源、厂商、参数量、能力标签、文件清单）。
- **终端风格日志区**：云端下载与打包执行期间展示终端风格日志区（深色背景、等宽字体、自动滚动），实时输出进度日志。
- **下载速度展示**：云端下载进度区展示当前下载速度（如 MB/s）。
- **云端下载取消**：下载中可点击“取消下载”按钮，弹出确认弹窗，确认后中止下载并保留已下载分片。
- **无网络空状态**：云端仓库在无网络时展示整页空状态（网络中断图标 + 提示 + 重试按钮）。
- **模型搜索**：云端模型清单页提供搜索输入框，按模型名称实时筛选。
- **打包执行进度页**：执行打包时进入独立进度页，展示整体进度条、打包步骤终端日志和取消按钮。
- **取消打包确认弹窗**：执行打包页的“取消”按钮弹出模态确认弹窗，不直接取消。
- **打包成功页**：展示绿色横幅、包根目录、生成文件列表和“打开目录”按钮（调用系统文件管理器）。
- **打包失败页**：展示红色错误横幅、错误详情、“重试”和“返回”按钮。
- **打包取消页**：展示取消提示和“返回首页”按钮。