diff --git a/plugins/link-relay/.gitignore b/plugins/link-relay/.gitignore
new file mode 100644
index 000000000..05388a57f
--- /dev/null
+++ b/plugins/link-relay/.gitignore
@@ -0,0 +1,32 @@
+# Dependencies
+node_modules/
+*/node_modules/
+
+# Build output (regenerated by build, but included in plugin package under src-ztools/dist)
+dist/
+!src-ztools/dist/
+
+# Logs
+*.log
+npm-debug.log*
+pnpm-debug.log*
+
+# Editor
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Temporary
+*.tmp
+*.bak
+.cache/
diff --git a/plugins/link-relay/AGENTS.md b/plugins/link-relay/AGENTS.md
new file mode 100644
index 000000000..987e851f8
--- /dev/null
+++ b/plugins/link-relay/AGENTS.md
@@ -0,0 +1,118 @@
+# 目录迁移助手 (link-relay)
+
+在 ZTools 中将任意目录（IDE 扩展/配置、缓存、用户数据等）从系统盘迁移到其他磁盘，通过 Junction/符号链接保持程序无感知运行。出厂 IDE 目录**预设**外置在 `preload/config/presets.json`（仅模板，可整组停用，无图标字段），自定义目录与预设使用同一套「源→目标+链接」模型，统一在单页表格中管理。**不做**多 IDE 插件共享。
+
+## 技术栈
+
+- **语言**: TypeScript 5.3+（strict，禁 `any`，仅 `<script setup>`）
+- **前端框架**: Vue 3.5 + Vite 6
+- **构建工具**: vue-tsc 2.2
+- **包管理**: pnpm
+- **后端能力**: Node.js (preload, CommonJS，保持可读、禁压缩混淆)
+- **宿主 API**: window.ztools / window.services
+- **核心依赖**: @ztools-center/ztools-api-types ^1.0.1
+
+## 常用命令
+
+```bash
+pnpm install
+pnpm run dev                       # 开发服务器（API 层纯内存 mock，虚拟测试目录，不触盘）
+pnpm run build                     # = vue-tsc && vite build，产物到 src-ztools/dist/
+pnpm exec vue-tsc --noEmit         # 仅做 TS 类型检查（无独立 typecheck 脚本）
+```
+
+## 五层分层与单向数据流（硬约束）
+
+```
+services/api（API 层）→ business（业务层）→ store（存储层）→ views/components（视图层）
+utils（工具层：枚举常量/纯函数，任意层可复用）；types（纯类型）
+```
+
+- **视图层**：`App.vue` 只挂载 `views/Home.vue`；Home 内联页头/KPI/工具栏（这些不单独抽组件），只把**表格**与**弹窗**做成组件；组件纯渲染——只接收 props、emit 事件，不调 api、不推导状态。
+- **数据存储层**：唯一 store `stores/migrationStore.ts`，只做 state + get(computed 转发) + actions(取数/写数/迁移编排)；复杂统计/筛选/组装**不写在 store**，下沉 business。
+- **业务方法层** `business/`：`dashboard.ts`(配置→VO/KPI 组装)、`selectors.ts`(筛选/计数/分组聚合)，全部纯函数。
+- **方法工具层** `utils/`：`enums.ts`(状态/视图/筛选枚举与状态元数据，仿后端 enum 集中复用)、`format.ts`(formatBytes/parseLineList 等)。
+- **API 调用层** `services/api.ts`：唯一访问 `window.services` 的出口；dev 无宿主时走纯内存 mock。
+
+## 禁止事项
+
+- **不要直接调用 shell 创建链接** → 使用 `fs.symlinkSync(target, path, process.platform==='win32'?'junction':'dir')`
+- **不要在 IDE 进程运行时迁移** → 迁移前强制进程检测，运行中拒绝执行
+- **不要直接删除源目录** → 先改名 `.backup-{timestamp}`，验证链接成功后才清理；失败自动回滚
+- **不要硬编码路径** → 路径全部来自 `presets.json`/配置，支持 `%ENV%`、`~` 展开
+- **不要在代码里另写一份预设** → 预设唯一数据源是 `src-ztools/preload/config/presets.json`（后端 require、前端 mock import 同一份）；预设与 VO **不含** shortName/color 等图标字段，界面不显示品牌图标
+- **不要让 dev mock 触碰真实 IDE** → mock 只用虚拟目录 `C:\RelocatorTest\source`、`D:\RelocatorTest\target`，纯内存、零磁盘 IO，禁止出现/读写真实 `.vscode`、`AppData` 等路径
+- **表格组件不写业务** → `MappingTable.vue` 只渲染 props、emit 事件；CRUD/状态推导收敛到 store + business
+- **不要过度封装组件** → KPI/工具栏/页头直接写在 Home；只有表格与对话框弹窗独立成组件
+- **不要跨项目修改文件**，不要改动无故障的 `link-manager/migration-engine/process-checker`
+
+## 目录结构与职责
+
+| 路径 | 职责 |
+|------|------|
+| `src/App.vue` | 根组件，只 import 并渲染 `views/Home.vue` |
+| `src/views/Home.vue` | 唯一页面：内联页头/KPI/工具栏，组装表格+弹窗，负责宿主窗口高度自适应（ResizeObserver→setExpendHeight，clamp 480~900） |
+| `src/types/` | 纯类型：`migration.ts`(状态/迁移)、`preset.ts`(L1 预设)、`mapping.ts`(L2 配置+L3 VO)、`ztools.d.ts`、`index.ts`(barrel) |
+| `src/utils/enums.ts` | 链接状态/视图/筛选枚举 + STATUS_META(文案/色调/严重度/行操作)，前端唯一事实源（与后端 status-enum.js 同构） |
+| `src/utils/format.ts` | formatBytes / parseLineList 通用纯函数 |
+| `src/business/dashboard.ts` | 配置+StatusReader → DashboardVO（组装/KPI 纯函数，mock 同构复用） |
+| `src/business/selectors.ts` | 筛选匹配 matchFilter、计数 countByFilter、分组/平铺派生 |
+| `src/services/api.ts` | window.services 唯一出口 + 纯内存 mock（虚拟测试目录） |
+| `src/stores/migrationStore.ts` | 唯一 store：state/get/actions，含迁移状态机编排 |
+| `src/components/MappingTable.vue` | 唯一表格（组头+行内聚，纯渲染） |
+| `src/components/*Dialog.vue` | Preset/Settings/Mapping/Migrate/Progress 五个对话框弹窗 |
+| `src-ztools/preload/config/presets.json` | ★ 出厂预设唯一数据源（外置 JSON） |
+| `src-ztools/preload/services.js` | Node 能力入口，注入 window.services |
+| `src-ztools/preload/core/` | `status-enum.js`(状态枚举)、`preset-library.js`(读 json+展开+实例化)、`config-store.js`(V2+V1 迁移)、`entry-resolver.js`(配置→VO 唯一出口)、`link-manager.js`、`process-checker.js`、`migration-engine.js` |
+
+## 核心业务规则
+
+### 1. 链接状态分类（枚举集中管理）
+
+| 状态 | 含义 | 行主操作 |
+|------|------|---------|
+| `linked` | 已链接且指向正确 | 已迁移（禁用，不可勾选） |
+| `not-linked` | 未迁移，源为实体目录 | 迁移 |
+| `broken` | 链接断裂或指向错误 | 修复 |
+| `conflict` | 源与目标都有实体目录 | 修复（用户选 prefer-source/prefer-target） |
+| `target-only` | 源不存在、目标有数据 | 重建链接（重装场景） |
+| `not-installed` | 预设源目录本机不存在 | 预设行不显示（自定义行始终显示） |
+| `unknown` | 无法判定 | — |
+
+停用的预设/行灰显保留（不隐藏、不可勾选、动作置为「已停用」）。
+
+### 2. 迁移前置检查
+
+1. 关联进程未运行（Windows `tasklist`，*nix `ps -A`），运行中拒绝
+2. 目标盘可用空间 > 源大小 × 1.1
+3. 状态不为 `linked`
+4. `conflict` 必须由用户明确选择策略
+
+### 3. 迁移流程
+
+```
+前置检查 → 数据复制 → 备份原目录(.backup) → 创建 Junction → 验证链接 → 清理备份
+```
+进度通过 onProgress(type,data) 两参回调推送；任何步骤失败 → 删链接、恢复备份名、记日志返回错误。
+
+## 编码规范
+
+- TS strict、禁 `any`、显式接口；仅 `<script setup>` Composition API
+- IO 异步化避免阻塞 UI；关键操作 try-catch，错误信息含上下文与修复建议
+- window.ztools/window.services 必须有类型声明（types/ztools.d.ts）
+- 布局自适应：KPI 用 `repeat(auto-fit,minmax(...))`、工具栏 flex-wrap、表格横向滚动、断点 479/767
+- 界面文案统一英文首字母大写（如 "Visual Studio Code"）
+
+## 提交前检查清单
+
+- [ ] `pnpm exec vue-tsc --noEmit` 通过
+- [ ] `pnpm run build` 通过并刷新 src-ztools/dist
+- [ ] 新增宿主调用只出现在 `src/services/api.ts`
+- [ ] 类型只放 `src/types/`；枚举/常量只放 `src/utils/enums.ts`；复杂统计只放 `src/business/`
+- [ ] 预设改动只改 `presets.json`，且无图标字段回归
+- [ ] dev mock 路径全部位于 RelocatorTest 虚拟目录，无真实 IDE 路径、无磁盘写
+- [ ] 组件保持纯渲染，KPI/工具栏未被重新拆成多余组件
+
+## 入口文件引用
+
+- CLAUDE.md / GEMINI.md / Cursor 规则：引用本文件，仅追加各自工具链约束
diff --git a/plugins/link-relay/CHANGELOG.md b/plugins/link-relay/CHANGELOG.md
new file mode 100644
index 000000000..f2d39d46b
--- /dev/null
+++ b/plugins/link-relay/CHANGELOG.md
@@ -0,0 +1,40 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-09-03
+
+### Added
+
+- 初始版本发布
+- **通用目录迁移** — 不绑定具体软件，任何「源目录 → 目标目录 + 链接」的需求都可配置
+- **预设外置配置** — 出厂预设集中在 `preload/config/presets.json`，增删改预设只改 JSON，不写逻辑；界面不展示任何品牌图标
+- **Junction 无感知链接** — Windows Junction / 符号链接，程序完全感知不到数据已迁移
+- **自定义目录** — 与预设同一套数据模型，统一在一张表格管理（.npm、.m2、.gradle、浏览器缓存等）
+- **系统重装恢复** — `target-only` 状态一键重建链接，重装后无需重新下载
+- **冲突处理** — 源与目标都存在实体目录时支持 prefer-source / prefer-target 两种策略
+- **安全回滚** — 任何步骤失败自动回滚，源目录先备份为 `.backup-{timestamp}` 再操作
+- **进程检测** — 迁移前强制检测关联进程，运行中拒绝执行
+- **纯内存 dev mock** — 开发模式使用虚拟测试目录，零磁盘 IO，不触碰真实 IDE 数据
+
+### 内置预设
+
+- Visual Studio Code (`vscode`)
+- Cursor (`cursor`)
+- Qoder IDE (`qoder`)
+- Qoder CN (`qoder-cn`)
+- Windsurf (`windsurf`)
+- VSCodium (`vscodium`)
+- Trae (`trae`)
+
+### 技术栈
+
+- Vue 3.5 + TypeScript strict + Vite 6
+- Pinia 状态管理
+- Node.js CommonJS preload
+- ZTools 宿主（`window.ztools` / `window.services`）
+
+[1.0.0]: https://github.com/00001x/link-relay/releases/tag/v1.0.0
diff --git a/plugins/link-relay/CLAUDE.md b/plugins/link-relay/CLAUDE.md
new file mode 100644
index 000000000..be0eebbc6
--- /dev/null
+++ b/plugins/link-relay/CLAUDE.md
@@ -0,0 +1,14 @@
+# CLAUDE.md
+
+@AGENTS.md
+
+`AGENTS.md` 是最高优先级协作规范，开始任何任务前必须先读取并遵守。
+未覆盖的场景优先询问用户，不假设不猜测。
+
+## 工具链专属约束
+
+- **开发服务器**: `pnpm run dev` 启动的 Vite 服务器运行在 `http://localhost:5173`，ZTools 会自动加载开发版本
+- **插件调试**: 通过 ZTools 插件头像图标 → "打开开发者工具" 进行前端调试
+- **窗口控制**: 使用 `ztools.setExpendHeight()` 根据 IDE 数量动态调整窗口高度
+- **构建输出**: 仅 `dist/` 目录需打包发布，不要修改其他目录
+- **类型定义**: `src/types/ztools.d.ts` 必须保持与 `@ztools-center/ztools-api-types` 一致
diff --git a/plugins/link-relay/README.md b/plugins/link-relay/README.md
new file mode 100644
index 000000000..237eceade
--- /dev/null
+++ b/plugins/link-relay/README.md
@@ -0,0 +1,132 @@
+# 目录迁移助手 (link-relay)
+
+> ZTools 插件：把任意目录（IDE 扩展/配置、缓存、用户数据等）从系统盘迁移到其他磁盘，通过 Junction/符号链接保持程序无感知运行。内置常见 IDE 目录**预设**（外置 config.json，仅模板，可整组停用），自定义目录与预设使用同一套「源 → 目标 + 链接」模型，统一在单页表格中管理。**不做**多 IDE 插件共享。
+
+## 功能特性
+
+- **通用目录迁移** — 不绑定具体软件，任何「源目录 → 目标目录 + 链接」的需求都可配置
+- **预设外置配置** — 出厂预设集中在 `preload/config/presets.json`，增删改预设只改 JSON，不写逻辑；界面不展示任何品牌图标
+- **Junction 无感知链接** — Windows Junction / 符号链接，程序完全感知不到数据已迁移
+- **自定义目录** — 与预设同一套数据模型，统一在一张表格管理（.npm、.m2、.gradle、浏览器缓存等）
+- **系统重装恢复** — `target-only` 状态一键重建链接，重装后无需重新下载
+- **冲突处理** — 源与目标都存在实体目录时支持 prefer-source / prefer-target 两种策略
+- **安全回滚** — 任何步骤失败自动回滚，源目录先备份为 `.backup-{timestamp}` 再操作
+
+## 架构分层（单一职责 + 单向数据流）
+
+```
+services/api（API 调用层） → business（业务方法层） → store（数据存储层） → views/components（视图层）
+        ↑ 唯一访问 window.services        ↑ 统计/筛选/组装纯函数    ↑ 只做 state/get/action 编排
+utils（方法工具层：枚举常量、格式化纯函数，被任意层复用）
+types（纯类型，无逻辑）
+```
+
+| 层 | 位置 | 职责 |
+|----|------|------|
+| 视图层 | `App.vue` / `views/Home.vue` / `components` | App 只挂载 Home；Home 内联页头/KPI/工具栏，表格与弹窗为组件；组件纯渲染、只 emit 事件 |
+| 数据存储层 | `stores/migrationStore.ts` | 唯一 store：state + get(computed 转发) + actions(取数/写数/迁移编排)，不写复杂规则 |
+| 业务方法层 | `business/dashboard.ts`、`business/selectors.ts` | 配置→VO 组装、KPI 统计、筛选匹配、分组聚合等纯函数 |
+| 方法工具层 | `utils/enums.ts`、`utils/format.ts` | 状态枚举与元数据（仿后端 enum，集中复用）、字节/列表解析等通用纯函数 |
+| API 调用层 | `services/api.ts` | 唯一访问 `window.services` 的出口；无宿主时用**纯内存 mock**（专用虚拟测试目录，不触盘） |
+
+领域模型仍分三层：L1 预设（`presets.json` 只读模板）→ L2 配置（`MappingConfig`/`GroupConfig`，dbStorage 持久化、表格唯一数据源）→ L3 视图 VO（`MappingRowVO`/`GroupVO`/`DashboardVO`，实时检测生成、不持久化）。
+
+### 链接状态（枚举集中管理）
+
+| 状态 | 含义 | 主操作 |
+|------|------|--------|
+| `linked` | 已链接且指向正确 | 已迁移（禁用） |
+| `not-linked` | 未迁移，源为实体目录 | 迁移 |
+| `broken` | 链接断裂或指向错误 | 修复 |
+| `conflict` | 源与目标都有实体目录 | 修复 |
+| `target-only` | 仅目标有数据 | 重建链接 |
+| `not-installed` | 预设目录不存在 | 预设行不显示（自定义行始终显示） |
+| `unknown` | 无法判定 | — |
+
+状态的文案/色调/严重度/行操作统一在 `src/utils/enums.ts`（前端）与 `src-ztools/preload/core/status-enum.js`（后端）两处同构维护。
+
+## 技术栈
+
+- **前端**: Vue 3.5（`<script setup>`）+ TypeScript strict + Vite 6
+- **后端**: Node.js CommonJS preload
+- **宿主**: ZTools（`window.ztools` / `window.services`）
+- **包管理**: pnpm
+
+## 快速开始
+
+```bash
+pnpm install
+pnpm run dev      # 开发模式（API 层内置纯内存 mock，使用虚拟测试目录，不触碰真实 IDE）
+pnpm run build    # 类型检查 + 生产构建到 src-ztools/dist/
+```
+
+## 项目结构
+
+```
+├── src/
+│   ├── App.vue                      # 根组件：只挂载 Home
+│   ├── views/Home.vue               # 唯一页面：内联页头/KPI/工具栏，组装表格与弹窗 + 窗口高度自适应
+│   ├── types/                       # 纯类型：migration / preset / mapping / ztools
+│   ├── utils/
+│   │   ├── enums.ts                 # 状态/视图/筛选枚举与状态元数据（集中复用）
+│   │   └── format.ts                # formatBytes / parseLineList 等纯函数
+│   ├── business/
+│   │   ├── dashboard.ts             # 配置 → DashboardVO（组装/KPI 纯函数，mock 同构复用）
+│   │   └── selectors.ts             # 筛选匹配、计数、分组/平铺派生
+│   ├── services/
+│   │   └── api.ts                   # window.services 唯一出口 + 纯内存 mock（虚拟测试目录）
+│   ├── stores/
+│   │   └── migrationStore.ts        # 唯一 store：state/get/actions
+│   └── components/                  # 只封装表格与弹窗
+│       ├── MappingTable.vue         # 唯一表格（组头/行内聚，纯渲染，只 emit）
+│       ├── PresetDialog.vue         # 预设开关
+│       ├── SettingsDialog.vue       # 全局设置
+│       ├── MappingDialog.vue        # 添加/编辑映射
+│       ├── MigrateDialog.vue        # 迁移预览与选项
+│       └── ProgressDialog.vue       # 迁移进度/日志
+├── src-ztools/
+│   ├── plugin.json
+│   ├── preload/
+│   │   ├── config/presets.json      # ★ 出厂预设唯一数据源（外置 JSON，无图标字段）
+│   │   ├── services.js              # 服务入口，注入 window.services
+│   │   └── core/
+│   │       ├── status-enum.js       # 状态枚举与语义（后端唯一事实源）
+│   │       ├── preset-library.js    # 读取 presets.json + 环境变量展开 + 实例化
+│   │       ├── config-store.js      # 配置持久化（V2 + V1 迁移）
+│   │       ├── entry-resolver.js    # 配置 → VO 唯一出口
+│   │       ├── link-manager.js      # Junction/链接管理
+│   │       ├── process-checker.js   # 进程检测
+│   │       └── migration-engine.js  # 迁移引擎（复制/备份/建链/回滚）
+│   └── dist/
+└── package.json
+```
+
+## 内置预设（presets.json）
+
+| 预设 | id | 典型目录 |
+|------|----|---------|
+| Visual Studio Code | `vscode` | `~/.vscode`、`%APPDATA%\Code` |
+| Cursor | `cursor` | `~/.cursor`、`%APPDATA%\Cursor` |
+| Qoder IDE | `qoder` | `~/.qoder`、`%APPDATA%\Qoder` |
+| Qoder CN | `qoder-cn` | `~/.qoder-cn`、`%APPDATA%\QoderCN` |
+| Windsurf | `windsurf` | `~/.codeium/windsurf`、`%APPDATA%\Windsurf` |
+| VSCodium | `vscodium` | `~/.vscode-oss`、`%APPDATA%\VSCodium` |
+| Trae | `trae` | `~/.trae`、`%APPDATA%\Trae` |
+
+预设只是模板：不勾选不会产生配置行；任意目录都可通过「添加映射」手动配置。
+
+## 开发与测试隔离
+
+- `pnpm dev` 下不存在 `window.services`，`services/api.ts` 走**纯内存 mock**：所有路径都落在虚拟目录 `C:\RelocatorTest\source` 与 `D:\RelocatorTest\target`，**不进行任何磁盘 IO，绝不读取/修改真实 IDE 数据**。
+- 真实迁移只在 ZTools 宿主内、由 preload 引擎执行，并强制进程检测、备份与回滚。
+
+## 安全规范
+
+- 使用 `fs.symlinkSync(target, path, process.platform === 'win32' ? 'junction' : 'dir')` 原生 API，Windows 无需管理员权限
+- 迁移前强制检测关联进程，运行中拒绝执行
+- 源目录先重命名为 `.backup-{timestamp}`，验证链接成功后才清理
+- 路径全部来自配置/预设，支持 `%ENV%` 与 `~` 展开，不在代码中硬编码
+
+## 开源协议
+
+MIT License
diff --git a/plugins/link-relay/agents/.mcp.json b/plugins/link-relay/agents/.mcp.json
new file mode 100644
index 000000000..e69de29bb
diff --git a/plugins/link-relay/agents/skills/ztools-plugin-dev/SKILL.md b/plugins/link-relay/agents/skills/ztools-plugin-dev/SKILL.md
new file mode 100644
index 000000000..32c871cea
--- /dev/null
+++ b/plugins/link-relay/agents/skills/ztools-plugin-dev/SKILL.md
@@ -0,0 +1,571 @@
+# ZTools 插件开发技能
+
+> **适用场景**：为 ZTools 桌面效率工具开发插件应用，涵盖创建、开发、构建、发布的完整流程。
+> **技术栈**：HTML/CSS/JS + Node.js + Electron，支持 Vue/React 框架。
+> **跨平台**：Windows / macOS / Linux
+
+---
+
+## 1. 概述
+
+ZTools 插件 = **Web 前端 UI + Node.js 本地原生能力**。通过 `plugin.json` 配置入口，`preload.js` 桥接 Node.js/Electron API，前端通过 `window.ztools` 全局对象调用系统能力。
+
+### 核心组成
+
+| 文件 | 作用 |
+|---|---|
+| `plugin.json` | 插件元数据 + 功能配置（必填） |
+| `preload.js` | 预加载脚本，调用 Node.js/Electron API（必填） |
+| `index.html` | 插件 UI 入口（或在线 URL） |
+| `logo.png` | 插件图标（必填，png/jpg） |
+
+---
+
+## 2. 环境准备
+
+- **ZTools** 客户端：https://github.com/ZToolsCenter/ZTools/releases
+- **Node.js** >= 16.0.0
+- **Git**
+- **CLI 工具**：`npm install -g @ztools-center/plugin-cli`
+
+### 可选模板
+
+| 模板 | 说明 |
+|---|---|
+| Vue + TypeScript + Vite | Vue 3 前端 UI |
+| React + TypeScript + Vite | React 前端 UI |
+| Preload Only (TypeScript) | 无 UI，仅 Preload 脚本 |
+
+---
+
+## 3. 创建插件
+
+```bash
+# 创建项目（交互式选择模板、输入信息）
+ztools create my-plugin
+
+# 进入目录、安装依赖
+cd my-plugin
+npm install
+
+# 开发模式
+npm run dev
+
+# 构建（输出到 dist/）
+npm run build
+```
+
+---
+
+## 4. 目录结构
+
+### 最终打包结构（dist/ 目录）
+
+```
+my-plugin/
+├── plugin.json        # 必填：插件配置
+├── preload.js         # 必填：预加载脚本（CommonJS）
+├── index.html         # 必填：UI 入口
+├── index.js           # 前端逻辑
+├── index.css          # 样式
+├── logo.png           # 必填：图标
+└── node_modules/      # Node.js 第三方依赖（如有）
+```
+
+### 开发目录结构
+
+```
+my-plugin/
+├── plugin.json
+├── package.json       # 项目依赖（type: commonjs）
+├── src/
+│   ├── preload.ts     # Preload 源码
+│   └── ...            # 前端源码
+├── public/
+│   └── logo.png
+├── dist/              # 构建输出（打包此目录）
+└── vite.config.js     # 构建配置
+```
+
+**关键规则**：
+- 框架代码（Vue/React）必须编译为普通 HTML/CSS/JS 后打包
+- Node.js 第三方依赖放在 `preload.js` 同级，**不要编译**
+- 只打包 `dist/` 目录，不打包项目根目录
+
+---
+
+## 5. plugin.json 配置详解
+
+```json
+{
+  "name": "my-plugin",
+  "title": "我的插件",
+  "description": "插件描述",
+  "version": "1.0.0",
+  "main": "index.html",
+  "logo": "logo.png",
+  "preload": "preload.js",
+  "features": [
+    {
+      "code": "hello",
+      "explain": "打招呼",
+      "cmds": ["hello", "你好"]
+    }
+  ]
+}
+```
+
+### 基础字段
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `name` | string | ✅ | 插件唯一标识 ID |
+| `title` | string | ✅ | 显示名称 |
+| `description` | string | ❌ | 描述 |
+| `version` | string | ❌ | 版本号 |
+| `main` | string | ✅ | UI 入口（.html 相对路径或在线 URL） |
+| `logo` | string | ✅ | 图标文件（png/jpg） |
+| `preload` | string | ✅ | 预加载 JS 文件路径 |
+
+### 开发模式覆盖
+
+```json
+{
+  "development": {
+    "main": "http://localhost:5173"
+  }
+}
+```
+
+### features 字段
+
+| 字段 | 说明 |
+|---|---|
+| `code` | 功能唯一标识 |
+| `explain` | 功能说明（搜索结果中显示） |
+| `cmds` | 触发指令数组 |
+| `platform` | 可选，限制平台 `['win32','darwin','linux']` |
+
+---
+
+## 6. 指令类型（cmds）
+
+### 6.1 文本指令（精确匹配）
+
+```json
+"cmds": ["hello", "你好"]
+```
+
+### 6.2 正则指令（RegexCmd）
+
+```json
+{
+  "type": "regex",
+  "label": "颜色预览",
+  "match": "/^#([0-9a-fA-F]{6}|[0-9a-fA-F]{3})$/i",
+  "minLength": 4
+}
+```
+
+### 6.3 全局匹配（OverCmd）
+
+匹配任意文本，适用于翻译、搜索类插件。
+
+```json
+{
+  "type": "over",
+  "label": "翻译",
+  "exclude": "/^exclude/i",
+  "minLength": 1,
+  "maxLength": 1000
+}
+```
+
+### 6.4 图片匹配（ImgCmd）
+
+粘贴图片时触发（OCR、压缩、格式转换等）。
+
+```json
+{ "type": "img", "label": "图片处理" }
+```
+
+### 6.5 文件匹配（FilesCmd）
+
+粘贴文件/文件夹时触发。
+
+```json
+{
+  "type": "files",
+  "label": "批量重命名",
+  "fileType": "file",
+  "extensions": ["txt", "md", "json"],
+  "match": "/^test/i",
+  "minLength": 1,
+  "maxLength": 100
+}
+```
+
+| 参数 | 说明 |
+|---|---|
+| `fileType` | `"file"` 或 `"directory"`，不填则都匹配 |
+| `extensions` | 文件扩展名过滤数组 |
+| `match` | 文件名正则匹配 |
+| `minLength` / `maxLength` | 文件数量范围 |
+
+---
+
+## 7. Preload.js 规范
+
+**Preload 是连接前端与 Node.js/Electron 的桥梁**，遵循 CommonJS 规范。
+
+### 基本模式
+
+```javascript
+// preload.js
+const fs = require("node:fs");
+const path = require("node:path");
+
+window.customApis = {
+  readFile: (filePath) => fs.readFileSync(filePath, "utf8"),
+  writeFile: (filePath, content) => fs.writeFileSync(filePath, content),
+};
+```
+
+### 引入第三方模块
+
+```bash
+# 在 preload.js 同级目录安装
+npm install colord
+```
+
+```javascript
+const { colord } = require("colord");
+window.services = { colord };
+```
+
+### 引入 Electron API
+
+```javascript
+const { clipboard, nativeImage } = require("electron");
+
+window.services = {
+  copyImage: (imageFilePath) => {
+    clipboard.writeImage(nativeImage.createFromPath(imageFilePath));
+  },
+};
+```
+
+### ⚠️ 代码规范
+
+- **禁止压缩/混淆**，每一行代码必须清晰可读
+- 第三方模块源码也必须一同提交，不允许压缩
+- 模块放在 `preload.js` 同级目录，不要编译
+
+---
+
+## 8. 插件 API 参考（window.ztools）
+
+### 8.1 基础 API
+
+| API | 说明 |
+|---|---|
+| `ztools.getAppName()` | 返回 `'ZTools'` |
+| `ztools.getAppVersion()` | 获取应用版本 |
+| `ztools.isMacOs()` / `isWindows()` / `isLinux()` | 平台检测 |
+| `ztools.isDarkColors()` | 深色主题检测 |
+| `ztools.isDev()` | 开发模式检测 |
+| `ztools.getNativeId()` | 设备唯一 ID（32位） |
+| `ztools.getWindowType()` | 窗口类型 |
+| `ztools.getPathForFile(file)` | 拖放文件的真实路径 |
+
+### 8.2 窗口控制
+
+| API | 说明 |
+|---|---|
+| `ztools.setExpendHeight(height)` | 设置插件视图高度（px） |
+| `ztools.showMainWindow()` | 显示主窗口 → `Promise<boolean>` |
+| `ztools.hideMainWindow(isRestore?)` | 隐藏主窗口 → `Promise<boolean>` |
+| `ztools.outPlugin(isKill?)` | 退出插件（默认隐藏后台，`isKill=true` 杀进程） |
+| `ztools.createBrowserWindow(url, options, cb?)` | 创建独立窗口 → `Proxy<BrowserWindow>` |
+
+### 8.3 事件 API
+
+```javascript
+// 插件进入（用户打开时触发）
+ztools.onPluginEnter((param) => {
+  // param: { payload, type: 'text'|'regex'|'over', code }
+});
+
+// 插件退出
+ztools.onPluginOut((isKill) => { });
+
+// 插件被分离为独立窗口
+ztools.onPluginDetach(() => { });
+
+// 主搜索框推送（在主界面提供搜索结果）
+ztools.onMainPush(
+  (queryData) => { return results; },  // 查询回调
+  (selectData) => { return true; }     // 选中回调（返回 true 进入插件）
+);
+```
+
+### 8.4 搜索框 API
+
+```javascript
+// 设置子输入框（插件活动时替换主搜索框）
+ztools.setSubInput((text) => { }, "占位符", true);
+
+// 操作子输入框
+ztools.setSubInputValue("文本");
+ztools.subInputFocus();    // 聚焦
+ztools.subInputBlur();     // 失焦
+ztools.subInputSelect();   // 聚焦并全选
+ztools.removeSubInput();   // 移除
+```
+
+### 8.5 数据库 API（持久化存储）
+
+每个插件拥有独立的数据库空间（以 name 隔离）。
+
+```javascript
+// 同步版
+const doc = ztools.db.put({ _id: "key1", data: "value" });
+const result = ztools.db.get("key1");
+ztools.db.remove(doc);
+const all = ztools.db.allDocs();         // 获取所有
+const filtered = ztools.db.allDocs("prefix_"); // 前缀过滤
+ztools.db.bulkDocs([doc1, doc2]);        // 批量操作
+
+// Promise 版
+const doc = await ztools.db.promises.put({ _id: "key1", data: "value" });
+
+// 简化版（类似 localStorage）
+ztools.dbStorage.setItem("key", value);
+const val = ztools.dbStorage.getItem("key");
+ztools.dbStorage.removeItem("key");
+```
+
+### 8.6 剪贴板 API
+
+```javascript
+// 获取历史
+const history = await ztools.clipboard.getHistory(1, 20, "text");
+
+// 搜索
+const results = await ztools.clipboard.search("关键词");
+
+// 写入
+await ztools.clipboard.write(id, true);  // true = 同时粘贴
+await ztools.clipboard.writeContent({ type: "text", content: "内容" });
+
+// 快捷方法
+ztools.copyText("文本");
+ztools.copyImage("base64或文件路径");
+ztools.copyFile("/path/to/file");
+
+// 监听变化
+ztools.clipboard.onChange((item) => { });
+```
+
+### 8.7 模拟输入
+
+```javascript
+// 模拟键盘按键
+ztools.simulateKeyboardTap("c", "control");  // Ctrl+C
+ztools.simulateKeyboardTap("v", "command");   // Cmd+V (macOS)
+
+// 发送原始输入事件
+ztools.sendInputEvent({
+  type: "keyDown",
+  keyCode: "A",
+  modifiers: ["shift"]
+});
+
+// 鼠标事件
+ztools.sendInputEvent({
+  type: "mouseDown",
+  x: 100, y: 200,
+  button: "left",
+  clickCount: 1
+});
+```
+
+### 8.8 文件/Shell API
+
+```javascript
+// 系统路径
+const home = ztools.getPath("home");
+const desktop = ztools.getPath("desktop");
+
+// 对话框
+const savePath = ztools.showSaveDialog({ defaultPath: "file.txt" });
+const files = ztools.showOpenDialog({ properties: ["openFile", "multiSelections"] });
+
+// 截图
+ztools.screenCapture((base64Image) => { });
+
+// Shell
+ztools.shellOpenExternal("https://example.com");  // 浏览器打开
+ztools.shellOpenPath("/path/to/file");             // 系统默认程序打开
+ztools.shellShowItemInFolder("/path/to/file");     // 文件管理器显示
+```
+
+### 8.9 显示器 API
+
+```javascript
+const primary = ztools.getPrimaryDisplay();
+const all = ztools.getAllDisplays();
+const cursor = ztools.getCursorScreenPoint();  // { x, y }
+const nearest = ztools.getDisplayNearestPoint({ x: 100, y: 100 });
+
+// 坐标转换
+const screen = ztools.dipToScreenPoint({ x, y });
+const dip = ztools.screenToDipPoint({ x, y });
+```
+
+### 8.10 AI API
+
+```javascript
+// 非流式
+const result = await ztools.ai({ prompt: "你好" });
+
+// 流式
+const request = ztools.ai({ prompt: "你好" }, (chunk) => {
+  console.log("收到:", chunk);
+});
+await request;
+
+// 中断
+request.abort();
+
+// 获取可用模型
+const models = await ztools.allAiModels();
+```
+
+### 8.11 其他 API
+
+```javascript
+// 插件跳转
+ztools.redirect("target-label", { data: "payload" });
+
+// HTTP 请求头
+ztools.http.setHeaders({ "Authorization": "Bearer xxx" });
+ztools.http.getHeaders();
+ztools.http.clearHeaders();
+
+// 通知
+ztools.showNotification("通知内容");
+
+// 动态 Feature
+ztools.setFeature({ code: "new", explain: "新功能", cmds: ["触发词"] });
+ztools.removeFeature("code");
+ztools.getFeatures(["code1", "code2"]);
+```
+
+---
+
+## 9. 开发最佳实践
+
+### 前端 + Preload 通信模式
+
+```javascript
+// === preload.js ===
+const { execSync } = require("child_process");
+window.nodeAPI = {
+  runCommand: (cmd) => execSync(cmd, { encoding: "utf8" }),
+};
+
+// === 前端 (index.js / Vue / React) ===
+const result = window.nodeAPI.runCommand("ls -la");
+```
+
+### 使用 Vue/React 框架
+
+1. 用 CLI 选择模板创建项目
+2. 在 `src/` 开发组件
+3. `npm run build` 编译到 `dist/`
+4. `dist/` 即为可打包的插件目录
+
+### 数据持久化
+
+- 简单键值对 → `ztools.dbStorage`
+- 复杂文档 → `ztools.db`
+- 附件 → `ztools.db.postAttachment()`
+
+---
+
+## 10. 发布插件
+
+### 前置条件
+
+- `plugin.json` 存在且字段完整
+- Git 仓库已初始化，至少一次提交
+- 工作区干净（无未提交改动）
+
+### 发布命令
+
+```bash
+ztools publish
+```
+
+### 首次发布自动完成
+
+1. GitHub OAuth 认证（浏览器授权，含 `workflow` scope）
+2. Fork 中心仓库 `ZToolsCenter/ZTools-plugins`
+3. 同步 fork main 到上游
+4. 判定 Add/Update
+5. 复制工作目录到 fork 的 `plugins/<插件ID>/`
+6. 生成 commit + 推送分支
+7. 创建 Draft Pull Request
+
+### 后续发布（增量）
+
+- 每次只 fast-forward 追加一个 commit（不 force-push）
+- 同一 PR 自动复用，链接不变
+- PR 标题自动取自你的 commit subject
+
+### 发布后必须手动完成
+
+1. 📸 上传截图/演示 GIF 到 PR description
+2. ✅ 勾选自检清单（5项 checkbox）
+3. 🚦 把 PR 从 Draft 切到 "Ready for review"
+
+### 拉取审核者改动
+
+```bash
+ztools pull-contributions   # 三方合并审核者的改动
+ztools publish               # 重新发布
+```
+
+### CHANGELOG.md 支持
+
+- 自动抽取当前版本的变更说明注入 PR description
+- 未找到时交互式录入（非交互环境自动跳过）
+- 支持格式：`## 0.1.0`、`## v0.1.0`、`## [0.1.0]` 等
+
+---
+
+## 11. 故障排查
+
+| 问题 | 解决 |
+|---|---|
+| OAuth token 缺少 workflow scope | `rm ~/.config/ztools/cli-config.json` 重新授权 |
+| merge-upstream 422 | `rm -rf ~/.config/ztools/ZTools-plugins` 重新 clone |
+| 工作区未提交 | `git commit` 或 `git restore` 处理 |
+| 发布被拒（远端有新 commit） | 先 `ztools pull-contributions` |
+| 看本地 fork 缓存 | `cd ~/.config/ztools/ZTools-plugins && git log` |
+| 完全重置 | `rm -rf ~/.config/ztools/ && git tag -d ztools-last-publish` |
+
+---
+
+## 12. 相关资源
+
+- **ZTools 客户端**：https://github.com/ZToolsCenter/ZTools
+- **插件中心仓库**：https://github.com/ZToolsCenter/ZTools-plugins
+- **CLI 工具**：https://www.npmjs.com/package/@ztools-center/plugin-cli
+- **API 类型定义**：https://www.npmjs.com/package/@ztools-center/ztools-api-types
+- **官方文档源码**：https://github.com/ZToolsCenter/ZTools-doc
+
+---
+
+*基于 ZTools-doc 仓库文档提炼，版本日期：2026-08-27*
diff --git a/plugins/link-relay/index.html b/plugins/link-relay/index.html
new file mode 100644
index 000000000..a8825346e
--- /dev/null
+++ b/plugins/link-relay/index.html
@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>目录迁移助手</title>
+  </head>
+  <body>
+    <div id="app"></div>
+      <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>
diff --git a/plugins/link-relay/package.json b/plugins/link-relay/package.json
new file mode 100644
index 000000000..918d57ef3
--- /dev/null
+++ b/plugins/link-relay/package.json
@@ -0,0 +1,23 @@
+{
+  "name": "link-relay",
+  "version": "1.0.0",
+  "description": "ZTools 插件：将任意目录（IDE 扩展/配置、缓存、用户数据等）从系统盘迁移到其他磁盘，通过 Junction/符号链接保持程序无感知运行；内置常见 IDE 目录预设，支持自定义目录迁移与链接重建。",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vue-tsc && vite build"
+  },
+  "dependencies": {
+    "pinia": "^4.0.3",
+    "uuid": "^14.0.2",
+    "vue": "^3.5.13"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-vue": "^5.2.1",
+    "@ztools-center/ztools-api-types": "^1.0.1",
+    "sass": "^1.103.1",
+    "typescript": "^5.3.0",
+    "vite": "^6.0.11",
+    "vue-tsc": "^2.2.12"
+  }
+}
diff --git a/plugins/link-relay/pnpm-lock.yaml b/plugins/link-relay/pnpm-lock.yaml
new file mode 100644
index 000000000..24868e309
--- /dev/null
+++ b/plugins/link-relay/pnpm-lock.yaml
@@ -0,0 +1,1241 @@
+lockfileVersion: '9.0'
+
+settings:
+  autoInstallPeers: true
+  excludeLinksFromLockfile: false
+
+importers:
+
+  .:
+    dependencies:
+      pinia:
+        specifier: ^4.0.3
+        version: 4.0.3(@vue/devtools-api@8.2.1)(typescript@5.3.2)(vue@3.5.42(typescript@5.3.2))
+      uuid:
+        specifier: ^14.0.2
+        version: 14.0.2
+      vue:
+        specifier: ^3.5.13
+        version: 3.5.42(typescript@5.3.2)
+    devDependencies:
+      '@vitejs/plugin-vue':
+        specifier: ^5.2.1
+        version: 5.2.1(vite@6.4.3(sass@1.103.1))(vue@3.5.42(typescript@5.3.2))
+      '@ztools-center/ztools-api-types':
+        specifier: ^1.0.1
+        version: 1.0.3
+      sass:
+        specifier: ^1.103.1
+        version: 1.103.1
+      typescript:
+        specifier: ^5.3.0
+        version: 5.3.2
+      vite:
+        specifier: ^6.0.11
+        version: 6.4.3(sass@1.103.1)
+      vue-tsc:
+        specifier: ^2.2.12
+        version: 2.2.12(typescript@5.3.2)
+
+packages:
+
+  '@babel/helper-string-parser@7.29.7':
+    resolution: {integrity: sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw==}
+    engines: {node: '>=6.9.0'}
+
+  '@babel/helper-validator-identifier@7.29.7':
+    resolution: {integrity: sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==}
+    engines: {node: '>=6.9.0'}
+
+  '@babel/parser@7.29.8':
+    resolution: {integrity: sha512-E8lTAYNB1KW+FH+VGJuZM1ioAx2E6oVlvQFRrf5P8ZZmsiJXYAD9vTFV7yyEURNzgh1dFqMZuO6tUwcARbqFCA==}
+    engines: {node: '>=6.0.0'}
+    hasBin: true
+
+  '@babel/types@7.29.8':
+    resolution: {integrity: sha512-Vj1jF3cPfxg7OAfoI7QnVKLoILlm2JF9pnVHrX8qx7AHMiYWT+NDAA7jChlNgRS4WTLc/fD1lXLmPixluj+3Gg==}
+    engines: {node: '>=6.9.0'}
+
+  '@esbuild/aix-ppc64@0.25.0':
+    resolution: {integrity: sha512-O7vun9Sf8DFjH2UtqK8Ku3LkquL9SZL8OLY1T5NZkA34+wG3OQF7cl4Ql8vdNzM6fzBbYfLaiRLIOZ+2FOCgBQ==}
+    engines: {node: '>=18'}
+    cpu: [ppc64]
+    os: [aix]
+
+  '@esbuild/android-arm64@0.25.0':
+    resolution: {integrity: sha512-grvv8WncGjDSyUBjN9yHXNt+cq0snxXbDxy5pJtzMKGmmpPxeAmAhWxXI+01lU5rwZomDgD3kJwulEnhTRUd6g==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [android]
+
+  '@esbuild/android-arm@0.25.0':
+    resolution: {integrity: sha512-PTyWCYYiU0+1eJKmw21lWtC+d08JDZPQ5g+kFyxP0V+es6VPPSUhM6zk8iImp2jbV6GwjX4pap0JFbUQN65X1g==}
+    engines: {node: '>=18'}
+    cpu: [arm]
+    os: [android]
+
+  '@esbuild/android-x64@0.25.0':
+    resolution: {integrity: sha512-m/ix7SfKG5buCnxasr52+LI78SQ+wgdENi9CqyCXwjVR2X4Jkz+BpC3le3AoBPYTC9NHklwngVXvbJ9/Akhrfg==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [android]
+
+  '@esbuild/darwin-arm64@0.25.0':
+    resolution: {integrity: sha512-mVwdUb5SRkPayVadIOI78K7aAnPamoeFR2bT5nszFUZ9P8UpK4ratOdYbZZXYSqPKMHfS1wdHCJk1P1EZpRdvw==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@esbuild/darwin-x64@0.25.0':
+    resolution: {integrity: sha512-DgDaYsPWFTS4S3nWpFcMn/33ZZwAAeAFKNHNa1QN0rI4pUjgqf0f7ONmXf6d22tqTY+H9FNdgeaAa+YIFUn2Rg==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [darwin]
+
+  '@esbuild/freebsd-arm64@0.25.0':
+    resolution: {integrity: sha512-VN4ocxy6dxefN1MepBx/iD1dH5K8qNtNe227I0mnTRjry8tj5MRk4zprLEdG8WPyAPb93/e4pSgi1SoHdgOa4w==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [freebsd]
+
+  '@esbuild/freebsd-x64@0.25.0':
+    resolution: {integrity: sha512-mrSgt7lCh07FY+hDD1TxiTyIHyttn6vnjesnPoVDNmDfOmggTLXRv8Id5fNZey1gl/V2dyVK1VXXqVsQIiAk+A==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [freebsd]
+
+  '@esbuild/linux-arm64@0.25.0':
+    resolution: {integrity: sha512-9QAQjTWNDM/Vk2bgBl17yWuZxZNQIF0OUUuPZRKoDtqF2k4EtYbpyiG5/Dk7nqeK6kIJWPYldkOcBqjXjrUlmg==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [linux]
+
+  '@esbuild/linux-arm@0.25.0':
+    resolution: {integrity: sha512-vkB3IYj2IDo3g9xX7HqhPYxVkNQe8qTK55fraQyTzTX/fxaDtXiEnavv9geOsonh2Fd2RMB+i5cbhu2zMNWJwg==}
+    engines: {node: '>=18'}
+    cpu: [arm]
+    os: [linux]
+
+  '@esbuild/linux-ia32@0.25.0':
+    resolution: {integrity: sha512-43ET5bHbphBegyeqLb7I1eYn2P/JYGNmzzdidq/w0T8E2SsYL1U6un2NFROFRg1JZLTzdCoRomg8Rvf9M6W6Gg==}
+    engines: {node: '>=18'}
+    cpu: [ia32]
+    os: [linux]
+
+  '@esbuild/linux-loong64@0.25.0':
+    resolution: {integrity: sha512-fC95c/xyNFueMhClxJmeRIj2yrSMdDfmqJnyOY4ZqsALkDrrKJfIg5NTMSzVBr5YW1jf+l7/cndBfP3MSDpoHw==}
+    engines: {node: '>=18'}
+    cpu: [loong64]
+    os: [linux]
+
+  '@esbuild/linux-mips64el@0.25.0':
+    resolution: {integrity: sha512-nkAMFju7KDW73T1DdH7glcyIptm95a7Le8irTQNO/qtkoyypZAnjchQgooFUDQhNAy4iu08N79W4T4pMBwhPwQ==}
+    engines: {node: '>=18'}
+    cpu: [mips64el]
+    os: [linux]
+
+  '@esbuild/linux-ppc64@0.25.0':
+    resolution: {integrity: sha512-NhyOejdhRGS8Iwv+KKR2zTq2PpysF9XqY+Zk77vQHqNbo/PwZCzB5/h7VGuREZm1fixhs4Q/qWRSi5zmAiO4Fw==}
+    engines: {node: '>=18'}
+    cpu: [ppc64]
+    os: [linux]
+
+  '@esbuild/linux-riscv64@0.25.0':
+    resolution: {integrity: sha512-5S/rbP5OY+GHLC5qXp1y/Mx//e92L1YDqkiBbO9TQOvuFXM+iDqUNG5XopAnXoRH3FjIUDkeGcY1cgNvnXp/kA==}
+    engines: {node: '>=18'}
+    cpu: [riscv64]
+    os: [linux]
+
+  '@esbuild/linux-s390x@0.25.0':
+    resolution: {integrity: sha512-XM2BFsEBz0Fw37V0zU4CXfcfuACMrppsMFKdYY2WuTS3yi8O1nFOhil/xhKTmE1nPmVyvQJjJivgDT+xh8pXJA==}
+    engines: {node: '>=18'}
+    cpu: [s390x]
+    os: [linux]
+
+  '@esbuild/linux-x64@0.25.0':
+    resolution: {integrity: sha512-9yl91rHw/cpwMCNytUDxwj2XjFpxML0y9HAOH9pNVQDpQrBxHy01Dx+vaMu0N1CKa/RzBD2hB4u//nfc+Sd3Cw==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [linux]
+
+  '@esbuild/netbsd-arm64@0.25.0':
+    resolution: {integrity: sha512-RuG4PSMPFfrkH6UwCAqBzauBWTygTvb1nxWasEJooGSJ/NwRw7b2HOwyRTQIU97Hq37l3npXoZGYMy3b3xYvPw==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [netbsd]
+
+  '@esbuild/netbsd-x64@0.25.0':
+    resolution: {integrity: sha512-jl+qisSB5jk01N5f7sPCsBENCOlPiS/xptD5yxOx2oqQfyourJwIKLRA2yqWdifj3owQZCL2sn6o08dBzZGQzA==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [netbsd]
+
+  '@esbuild/openbsd-arm64@0.25.0':
+    resolution: {integrity: sha512-21sUNbq2r84YE+SJDfaQRvdgznTD8Xc0oc3p3iW/a1EVWeNj/SdUCbm5U0itZPQYRuRTW20fPMWMpcrciH2EJw==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [openbsd]
+
+  '@esbuild/openbsd-x64@0.25.0':
+    resolution: {integrity: sha512-2gwwriSMPcCFRlPlKx3zLQhfN/2WjJ2NSlg5TKLQOJdV0mSxIcYNTMhk3H3ulL/cak+Xj0lY1Ym9ysDV1igceg==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [openbsd]
+
+  '@esbuild/sunos-x64@0.25.0':
+    resolution: {integrity: sha512-bxI7ThgLzPrPz484/S9jLlvUAHYMzy6I0XiU1ZMeAEOBcS0VePBFxh1JjTQt3Xiat5b6Oh4x7UC7IwKQKIJRIg==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [sunos]
+
+  '@esbuild/win32-arm64@0.25.0':
+    resolution: {integrity: sha512-ZUAc2YK6JW89xTbXvftxdnYy3m4iHIkDtK3CLce8wg8M2L+YZhIvO1DKpxrd0Yr59AeNNkTiic9YLf6FTtXWMw==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [win32]
+
+  '@esbuild/win32-ia32@0.25.0':
+    resolution: {integrity: sha512-eSNxISBu8XweVEWG31/JzjkIGbGIJN/TrRoiSVZwZ6pkC6VX4Im/WV2cz559/TXLcYbcrDN8JtKgd9DJVIo8GA==}
+    engines: {node: '>=18'}
+    cpu: [ia32]
+    os: [win32]
+
+  '@esbuild/win32-x64@0.25.0':
+    resolution: {integrity: sha512-ZENoHJBxA20C2zFzh6AI4fT6RraMzjYw4xKWemRTRmRVtN9c5DcH9r/f2ihEkMjOW5eGgrwCslG/+Y/3bL+DHQ==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [win32]
+
+  '@jridgewell/sourcemap-codec@1.5.5':
+    resolution: {integrity: sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==}
+
+  '@napi-rs/lzma-linux-x64-gnu@1.5.1':
+    resolution: {integrity: sha512-oTXEIha4SsuXdTA4Iyskj0kpdx2yVXdhd75c2v3xGrHFfVMsbhTPZU/nMPL4sWKo4pBHm3aucLaqGlF696dTyQ==}
+    engines: {node: ^22.20 || ^24.12 || >=25}
+    cpu: [x64]
+    os: [linux]
+    libc: [glibc]
+
+  '@parcel/watcher-android-arm64@2.6.0':
+    resolution: {integrity: sha512-trgpLSCKRC/huFjXX/Smh+0sWe4+YtKfktIToiMl59ghz7z+qkH6kMvNnUbLyRs9N11t8l4svSCs1+5B3rOAhA==}
+    engines: {node: '>= 10.0.0'}
+    cpu: [arm64]
+    os: [android]
+
+  '@parcel/watcher-darwin-arm64@2.6.0':
+    resolution: {integrity: sha512-Y3QV0gl7Q1zbfueunkWIERICbEojQFCgpyG7YqOGNFLsckXyI1xu9mAIUpKY9QBYzBtSkN8dBPwd3yiAO9ovMw==}
+    engines: {node: '>= 10.0.0'}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@parcel/watcher-darwin-x64@2.6.0':
+    resolution: {integrity: sha512-Ohv6OpzhUfKYD7Beb8kDvG0jbIxORCYY1JRdZnaBtnjjkJxgD7ZVL0nw2sCYd0yTMKTvz3nnTnOF3cDifK+kvw==}
+    engines: {node: '>= 10.0.0'}
+    cpu: [x64]
+    os: [darwin]
+
+  '@parcel/watcher-freebsd-x64@2.6.0':
+    resolution: {integrity: sha512-5HmXvDgs8VK+74jF9y9/2FE3/OnlcKmc56tjmSrEuZjpSZOGL+fvAu+HKJBdPs9uwoP2hE6TlSUpXZ/C5jUFmQ==}
+    engines: {node: '>= 10.0.0'}
+    cpu: [x64]
+    os: [freebsd]
+
+  '@parcel/watcher-linux-arm-glibc@2.6.0':
+    resolution: {integrity: sha512-Ps/hui3A+vMbjdqlqAowK2ZL8+BO8dBjxeWXj6npTBs3jx4wWmbPpaLuqwrQrSqIVMCnpWo238bJ1U37GhQOYg==}
+    engines: {node: '>= 10.0.0'}
+    cpu: [arm]
+    os: [linux]
+    libc: [glibc]
+
+  '@parcel/watcher-linux-arm-musl@2.6.0':
+    resolution: {integrity: sha512-9c6AUHgHoG+IY88MRIHupztQiQnrbqHYQjkM2btA+Bf/wQnQMuiD0Wfk1EVv3TlNT3x41uU71rn6E4xh/+zvkw==}
+    engines: {node: '>= 10.0.0'}
+    cpu: [arm]
+    os: [linux]
+    libc: [musl]
+
+  '@parcel/watcher-linux-arm64-glibc@2.6.0':
+    resolution: {integrity: sha512-yHRqS2owEXe6Hic9z6Mh1ECsCd+ODVOGvZDyciqRd21+v+o+DnXMOrw50DSpIG2sb8GPEaPPmfeCAWKPJdq46g==}
+    engines: {node: '>= 10.0.0'}
+    cpu: [arm64]
+    os: [linux]
+    libc: [glibc]
+
+  '@parcel/watcher-linux-arm64-musl@2.6.0':
+    resolution: {integrity: sha512-WhB2e/V7rqdHHWZusBSPuy5Ei8S6lSz6FE5TKKQz5h3a0O+C+mhY7vxU9b/stqvMb8beLnPY82ZrFTLKs+SrKA==}
+    engines: {node: '>= 10.0.0'}
+    cpu: [arm64]
+    os: [linux]
+    libc: [musl]
+
+  '@parcel/watcher-linux-x64-glibc@2.6.0':
+    resolution: {integrity: sha512-ulGE6x6Oz6iAwg75T8YQSoguBWasniIbX+QWpaYPcCnDOpdWX3k+4xbEYPZVLxOuoJI+svJJPD3sEj8G7lrQ3A==}
+    engines: {node: '>= 10.0.0'}
+    cpu: [x64]
+    os: [linux]
+    libc: [glibc]
+
+  '@parcel/watcher-linux-x64-musl@2.6.0':
+    resolution: {integrity: sha512-tkBYKt7YQrjIJWYDnto2YgO8MRkjlMTSNoRHzsXinBqbLdeOM3L32wPZJvIZxqaLMfSlS/4sUjH/6STVP/XDLw==}
+    engines: {node: '>= 10.0.0'}
+    cpu: [x64]
+    os: [linux]
+    libc: [musl]
+
+  '@parcel/watcher-win32-arm64@2.6.0':
+    resolution: {integrity: sha512-gIZAP23jaHjGWasY/TY6yL7NHFClf0Ga7FN+iINvk+KN94rhm94lYZhFsbYFNcA04/onvGD9kKmiJLJB2HbNwQ==}
+    engines: {node: '>= 10.0.0'}
+    cpu: [arm64]
+    os: [win32]
+
+  '@parcel/watcher-win32-x64@2.6.0':
+    resolution: {integrity: sha512-cA+/pXV2YkfxlIcXOQ5fSWqAzzPyD78/x5qbK/I0vUkrlYHA8TIz+MXjAbGouguKVSI4bOmkTSJ1/poVSsgt+A==}
+    engines: {node: '>= 10.0.0'}
+    cpu: [x64]
+    os: [win32]
+
+  '@parcel/watcher@2.6.0':
+    resolution: {integrity: sha512-7FNeNl8NCE7aINx7WXiKQrPYZWC/hvrTsmk6zmxbI7LTXE7hVek/n8AfVgpe2y82zl3w0HvCHN0bVKMBoJcC0w==}
+    engines: {node: '>= 10.0.0'}
+
+  '@rollup/rollup-android-arm-eabi@4.63.0':
+    resolution: {integrity: sha512-70TeIFezKKy65LgAVyQh+w94/gjWhvPWaLaGGeMEgVrPkQhuj/M5bAYYZzIFUj9Y69oHyTm5Um/R6gcLh4A8JA==}
+    cpu: [arm]
+    os: [android]
+
+  '@rollup/rollup-android-arm64@4.63.0':
+    resolution: {integrity: sha512-YC86tYIHK6M1IV+wbzO+Bxk8RCBr6ZyWYgWxUCzaZD8mc8rrFoIJDNzDrkHBYRc/wKdrsIXmm6/F7NzrAO+OrA==}
+    cpu: [arm64]
+    os: [android]
+
+  '@rollup/rollup-darwin-arm64@4.63.0':
+    resolution: {integrity: sha512-oI+ECtUcli0y0fi4xpW82GdPIXdTkI8G8DSjG2LRuw09fPAGykaWYH/hXxiKuTxiAjiPSTIIuYUqof5Z2hShWw==}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@rollup/rollup-darwin-x64@4.63.0':
+    resolution: {integrity: sha512-NwV+1s7TiKrMe4owHyKB/dTLD7ZJD0YEBEhIz+hvav1Cu1GReJjF+rsdNwjzENQeIAbE/CoNiaAc5Vz2h5DPAA==}
+    cpu: [x64]
+    os: [darwin]
+
+  '@rollup/rollup-freebsd-arm64@4.63.0':
+    resolution: {integrity: sha512-tWtHBTu5gOPK4u4Urtk4qAHW3zZ9rQAmbssO8gp7ELvGTGI3aCiq6NqyTQ0PCIg7KbHJF2UkGDDs77YZGxfjCA==}
+    cpu: [arm64]
+    os: [freebsd]
+
+  '@rollup/rollup-freebsd-x64@4.63.0':
+    resolution: {integrity: sha512-2qPoJiwTvtHQ27NnYvTnsgk8laXWYuVmNESG8WFZBcEPKLfZ3I27qBJarjVRQtwGeYyRfq5ZowHXih9lm2BItw==}
+    cpu: [x64]
+    os: [freebsd]
+
+  '@rollup/rollup-linux-arm-gnueabihf@4.63.0':
+    resolution: {integrity: sha512-FQwsTRvLNuHoTdICABJQfbPUSEueISGmnpT06tXTMpfprf5NiKLSXKA0A+w45wJnCmZAnzgqBwbt6ARFuyOi5w==}
+    cpu: [arm]
+    os: [linux]
+    libc: [glibc]
+
+  '@rollup/rollup-linux-arm-musleabihf@4.63.0':
+    resolution: {integrity: sha512-BBVTXziw8mY1a4ZbWME9tZyfzqXCDPqaC7Z3heQ29p5dkvXzwL0NwelO8zLa8c3RBKvl3YTuSnBgsBhYBtwjIw==}
+    cpu: [arm]
+    os: [linux]
+    libc: [musl]
+
+  '@rollup/rollup-linux-arm64-gnu@4.63.0':
+    resolution: {integrity: sha512-w2Iyy9+RqKwx3d9qWMKsJg0FfRBsY0/pXNv0mCQ3ueRvJI6+QAScfD4nrMlzFLs2HNVW6Ew+mtZfDl9b7Ew5/Q==}
+    cpu: [arm64]
+    os: [linux]
+    libc: [glibc]
+
+  '@rollup/rollup-linux-arm64-musl@4.63.0':
+    resolution: {integrity: sha512-YK++KtrFRHYE0P6/RtYEAy9t8F37znP+K03RrIuLPYOL6SVlObRumf/0OE4V/h63xL9DwkWbNssZfmA9hawuDA==}
+    cpu: [arm64]
+    os: [linux]
+    libc: [musl]
+
+  '@rollup/rollup-linux-loong64-gnu@4.63.0':
+    resolution: {integrity: sha512-aBfOG6fP7YkkPmTqPwufRJeFyz7WPpECv9XNbnsk9+vg7rxdih0lbtEel7jcRng4LZrrmU3FfitCFyEj4BWDWg==}
+    cpu: [loong64]
+    os: [linux]
+    libc: [glibc]
+
+  '@rollup/rollup-linux-loong64-musl@4.63.0':
+    resolution: {integrity: sha512-LGaHEOeHNAag9VuS1Crs5DFg4RrU9MPi2nVnNJk9DTePx/B6RRYKVmrIXt2h7YOJlwjaFJ6lwtFDliZxScTLrQ==}
+    cpu: [loong64]
+    os: [linux]
+    libc: [musl]
+
+  '@rollup/rollup-linux-ppc64-gnu@4.63.0':
+    resolution: {integrity: sha512-jClvk+J0FC3b7Udvegiw5/4hErbHtmsNsQgENnKXDWtNCJXsJYZH5WURvu7imDOO38xYml24eeh5x3A04ppwCw==}
+    cpu: [ppc64]
+    os: [linux]
+    libc: [glibc]
+
+  '@rollup/rollup-linux-ppc64-musl@4.63.0':
+    resolution: {integrity: sha512-0OJlaGK+8+B777Ql5okIpD7ua5Ro9+VB9Ve0OKa28OQJZ1RbuUBVNHK/e3pr4BROqsyPl1JrPO1ZxJseCNffcA==}
+    cpu: [ppc64]
+    os: [linux]
+    libc: [musl]
+
+  '@rollup/rollup-linux-riscv64-gnu@4.63.0':
+    resolution: {integrity: sha512-Ygsx+HoNH7afwi1bTIXbnTvVnsO+zurPLSYxybV1hHFVU72OWOCl6v05ql/z0hkpAPx+DK7Kn9Bi7MayCcjLTA==}
+    cpu: [riscv64]
+    os: [linux]
+    libc: [glibc]
+
+  '@rollup/rollup-linux-riscv64-musl@4.63.0':
+    resolution: {integrity: sha512-pDQxtMGb+OvG3fLwR2OkZlSd47hW+kWg4BYMG/++sR6RqorQccwPTDsxda5hPwiIeIErAnCF9ma3SAU06bdQtQ==}
+    cpu: [riscv64]
+    os: [linux]
+    libc: [musl]
+
+  '@rollup/rollup-linux-s390x-gnu@4.63.0':
+    resolution: {integrity: sha512-0BnUG9mS8I4SSHr3XsxVhuCMEiu+rX61xxZF5vujso4LaiAGFZFxvDjg6Xn6tLPNTUAfuCvQYas4LMQMVsKRSQ==}
+    cpu: [s390x]
+    os: [linux]
+    libc: [glibc]
+
+  '@rollup/rollup-linux-x64-gnu@4.63.0':
+    resolution: {integrity: sha512-Adu/VttB1dpPNW+FEacrZ+xVm9tFty84+RrFzsqlFaPxoJB+9XXyDGtp5dCOoBwGBIEVH0To7lExFXEx0BIF4A==}
+    cpu: [x64]
+    os: [linux]
+    libc: [glibc]
+
+  '@rollup/rollup-linux-x64-musl@4.63.0':
+    resolution: {integrity: sha512-NQ3bDvjUbFKmP23671xUlXtKmqVsUBd6M4PQCvbmNtOy06hnQIdKHy8oG/6S3R/S6He1JgPk6A5VT+prAJMYEw==}
+    cpu: [x64]
+    os: [linux]
+    libc: [musl]
+
+  '@rollup/rollup-openbsd-x64@4.63.0':
+    resolution: {integrity: sha512-u2eDAl4+0aFvA13GxlGBtTI3SS3sdgwgtV0HyjZ0QaQVCgNE+jqNGey+GtxWiq+wxr/UycAx/OnfJzApCFamvA==}
+    cpu: [x64]
+    os: [openbsd]
+
+  '@rollup/rollup-openharmony-arm64@4.63.0':
+    resolution: {integrity: sha512-XvRb5vfW3wAZQ+ZUG21AnHHDKtNcw99eigzEhjr//NZ3u7SoBaPP0seSc7FgP7p1epAEdAoZckMW9WY/+4w70w==}
+    cpu: [arm64]
+    os: [openharmony]
+
+  '@rollup/rollup-win32-arm64-msvc@4.63.0':
+    resolution: {integrity: sha512-iZPmniy4kNBf5yo2RezbkYNNK5HPbXE9+g+twnbqSng7dtLEJy1SKoxiE/ni4FDacjyuZpEeb9U054N4EoKHYw==}
+    cpu: [arm64]
+    os: [win32]
+
+  '@rollup/rollup-win32-ia32-msvc@4.63.0':
+    resolution: {integrity: sha512-mFBBd+LF37fnE8JnYUOH+imj0aPFPK30vpar4ehJkgnLj9sZn8ZxiRENmLtgIwxK7TC8klF6N57fxdNBwQoqOA==}
+    cpu: [ia32]
+    os: [win32]
+
+  '@rollup/rollup-win32-x64-gnu@4.63.0':
+    resolution: {integrity: sha512-ujeqEY3B+zbGn3Z4Q03cUBG/LGWnBJncVT36WER31LcOsQk9+1dmINKKtvmmfChUvRbK1G0R8OhMWFgHgaZtAw==}
+    cpu: [x64]
+    os: [win32]
+
+  '@rollup/rollup-win32-x64-msvc@4.63.0':
+    resolution: {integrity: sha512-hncn90N4sOky0L2LKE5oESKLbxCPeVo4eLA2LSMoDzM+879ml4WSr+Rr4DWknNIVVvS1Hirkc9hx02W6YxS8rQ==}
+    cpu: [x64]
+    os: [win32]
+
+  '@types/estree@1.0.9':
+    resolution: {integrity: sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==}
+
+  '@vitejs/plugin-vue@5.2.1':
+    resolution: {integrity: sha512-cxh314tzaWwOLqVes2gnnCtvBDcM1UMdn+iFR+UjAn411dPT3tOmqrJjbMd7koZpMAmBM/GqeV4n9ge7JSiJJQ==}
+    engines: {node: ^18.0.0 || >=20.0.0}
+    peerDependencies:
+      vite: ^5.0.0 || ^6.0.0
+      vue: ^3.2.25
+
+  '@volar/language-core@2.4.15':
+    resolution: {integrity: sha512-3VHw+QZU0ZG9IuQmzT68IyN4hZNd9GchGPhbD9+pa8CVv7rnoOZwo7T8weIbrRmihqy3ATpdfXFnqRrfPVK6CA==}
+
+  '@volar/source-map@2.4.15':
+    resolution: {integrity: sha512-CPbMWlUN6hVZJYGcU/GSoHu4EnCHiLaXI9n8c9la6RaI9W5JHX+NqG+GSQcB0JdC2FIBLdZJwGsfKyBB71VlTg==}
+
+  '@volar/typescript@2.4.15':
+    resolution: {integrity: sha512-2aZ8i0cqPGjXb4BhkMsPYDkkuc2ZQ6yOpqwAuNwUoncELqoy5fRgOQtLR9gB0g902iS0NAkvpIzs27geVyVdPg==}
+
+  '@vue/compiler-core@3.5.42':
+    resolution: {integrity: sha512-2Ye1ilMtKXxl8qZUrQ5j0CdgenFp/HFQmta6rfRyfEsTG69L6Wk+tWuNoHYHMx9E8tF2Slvdg1FuwDvAXdy1LQ==}
+
+  '@vue/compiler-dom@3.5.42':
+    resolution: {integrity: sha512-qbhQZEFmycr+ni/qyuccS4sucNN7VAbDfbkvNxWOX2VfgFm90MNs3/UhRNKoPMEIVn0F8gdlYjLPvqxHwHeQOA==}
+
+  '@vue/compiler-sfc@3.5.42':
+    resolution: {integrity: sha512-fkCAFB4okcAANGMThboWnScp/gzWjU0ZSkVnjTIiplmMDq2uq0tIB3j+xVu4rhv5rvOgBySCysudmbMd6xRRqw==}
+
+  '@vue/compiler-ssr@3.5.42':
+    resolution: {integrity: sha512-xmLk3wLkbizPAiLyomjgFFosf2ys9b5Ghb+oh/k2tnvipNz8OFrQOiTcWCzyK7MpBp9KkyGtfvgfLUivbmuGYA==}
+
+  '@vue/compiler-vue2@2.7.16':
+    resolution: {integrity: sha512-qYC3Psj9S/mfu9uVi5WvNZIzq+xnXMhOwbTFKKDD7b1lhpnn71jXSFdTQ+WsIEk0ONCd7VV2IMm7ONl6tbQ86A==}
+
+  '@vue/devtools-api@8.2.1':
+    resolution: {integrity: sha512-6u4vXBlIBAC1wMplIZgpyPn7uh/s4Bf6F5bMzvLv+EdJ0aHs/+4B7Ygv864EStQSjRbsRzTko/kUG1A1IejQ3A==}
+
+  '@vue/devtools-kit@8.2.1':
+    resolution: {integrity: sha512-FIGIuq3AWReEpbAHY/cRGeHDfI0qOb8OCQ3YjbEAX04uaxIDbGc9rhkbVcG7rnfHPXE3RsU5KrWOu9V/okd8AQ==}
+
+  '@vue/devtools-shared@8.2.1':
+    resolution: {integrity: sha512-Fkac7lUdGReh6pVOi3AYPRGe82LQqRmAfThW7RRligOAP0ZA/Z1z9XLHDM9dv34pV2HRc79DK8uKPeG2fLnA/g==}
+
+  '@vue/language-core@2.2.12':
+    resolution: {integrity: sha512-IsGljWbKGU1MZpBPN+BvPAdr55YPkj2nB/TBNGNC32Vy2qLG25DYu/NBN2vNtZqdRbTRjaoYrahLrToim2NanA==}
+    peerDependencies:
+      typescript: '*'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@vue/reactivity@3.5.42':
+    resolution: {integrity: sha512-TzNNfKpb7hDxbQltwAut8VDQA5YP+BuRlxntHUuRjyKwlMvmAPbs3unhCvieijifY6vFfVBwsS7wG/C7uq+bEQ==}
+
+  '@vue/runtime-core@3.5.42':
+    resolution: {integrity: sha512-9uACtuHs7vJGkm5Bp3xu4xRDLFTIYy5DgxpToVjqGIAhAEKwQfsaLvKINhM6nFVp6bZPRFGdDqd1g52MqKsotA==}
+
+  '@vue/runtime-dom@3.5.42':
+    resolution: {integrity: sha512-rsCmhiWLaRxGltLwhlCWyYkFn7WAbKRh0q17eZ1A6Dq6eqc2ACQ61IIryxz0LrsvCzHSilLA9JHovVwM8CNE2g==}
+
+  '@vue/server-renderer@3.5.42':
+    resolution: {integrity: sha512-2++5dUyYS4gvo7xQXSECUDhB7TS0aOl5SeVfC5qSq1Jgfhjvegw1zqhwTIR3imZ+QYPJQw9gfcFvXGAjGZ7ajQ==}
+
+  '@vue/shared@3.5.42':
+    resolution: {integrity: sha512-2rPxex1jQf4jvl9MOHl6YaXCPcrNqz/FstMOEh3QWY+/OME9nQTvl9WYeCwhW7AFjaR0SnngZGlp/wkR6rkI6g==}
+
+  '@ztools-center/ztools-api-types@1.0.3':
+    resolution: {integrity: sha512-dv1eOAIasAupqKaQL/gESk1i2+RebdM/1gvZhrvH2D/bo3enCUsAGJ8nrHnlCLBSOGB81eC/SU0IH8BNsUlmvA==}
+
+  alien-signals@1.0.3:
+    resolution: {integrity: sha512-zQOh3wAYK5ujENxvBBR3CFGF/b6afaSzZ/c9yNhJ1ENrGHETvpUuKQsa93Qrclp0+PzTF93MaZ7scVp1uUozhA==}
+
+  balanced-match@1.0.0:
+    resolution: {integrity: sha512-9Y0g0Q8rmSt+H33DfKv7FOc3v+iRI+o1lbzt8jGcIosYW37IIW/2XVYq5NPdmaD5NQ59Nk26Kl/vZbwW9Fr8vg==}
+
+  birpc@2.6.1:
+    resolution: {integrity: sha512-LPnFhlDpdSH6FJhJyn4M0kFO7vtQ5iPw24FnG0y21q09xC7e8+1LeR31S1MAIrDAHp4m7aas4bEkTDTvMAtebQ==}
+
+  brace-expansion@2.1.4:
+    resolution: {integrity: sha512-hGfVzPxthbf3+2yjg/RBs60cB0FhqBS/zvdV/4wn4/BmN0bNMMHPc4V/BbFieqf1TKAGGAHnY4eSjajCl0f2Xg==}
+
+  chokidar@5.0.0:
+    resolution: {integrity: sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw==}
+    engines: {node: '>= 20.19.0'}
+
+  csstype@3.2.3:
+    resolution: {integrity: sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==}
+
+  de-indent@1.0.2:
+    resolution: {integrity: sha512-e/1zu3xH5MQryN2zdVaF0OrdNLUbvWxzMbi+iNA6Bky7l1RoP8a2fIbRocyHclXt/arDrrR6lL3TqFD9pMQTsg==}
+
+  detect-libc@2.1.2:
+    resolution: {integrity: sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==}
+    engines: {node: '>=8'}
+
+  entities@7.0.1:
+    resolution: {integrity: sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA==}
+    engines: {node: '>=0.12'}
+
+  esbuild@0.25.0:
+    resolution: {integrity: sha512-BXq5mqc8ltbaN34cDqWuYKyNhX8D/Z0J1xdtdQ8UcIIIyJyz+ZMKUt58tF3SrZ85jcfN/PZYhjR5uDQAYNVbuw==}
+    engines: {node: '>=18'}
+    hasBin: true
+
+  estree-walker@2.0.2:
+    resolution: {integrity: sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==}
+
+  fdir@6.5.0:
+    resolution: {integrity: sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==}
+    engines: {node: '>=12.0.0'}
+    peerDependencies:
+      picomatch: ^3 || ^4
+    peerDependenciesMeta:
+      picomatch:
+        optional: true
+
+  fsevents@2.3.3:
+    resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==}
+    engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
+    os: [darwin]
+
+  he@1.2.0:
+    resolution: {integrity: sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw==}
+    hasBin: true
+
+  hookable@5.5.3:
+    resolution: {integrity: sha512-Yc+BQe8SvoXH1643Qez1zqLRmbA5rCL+sSmk6TVos0LWVfNIB7PGncdlId77WzLGSIB5KaWgTaNTs2lNVEI6VQ==}
+
+  immutable@5.1.9:
+    resolution: {integrity: sha512-m8nVez3rwrgmWxtLMt1ZYXB2Lv7OKYn/disyxAlSDYAlKSlFoPPfIAmAM/M5xqL4m4C/wAPw7S2/CNaUii1Hxg==}
+
+  is-extglob@2.1.1:
+    resolution: {integrity: sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==}
+    engines: {node: '>=0.10.0'}
+
+  is-glob@4.0.3:
+    resolution: {integrity: sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==}
+    engines: {node: '>=0.10.0'}
+
+  magic-string@0.30.21:
+    resolution: {integrity: sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==}
+
+  minimatch@9.0.9:
+    resolution: {integrity: sha512-OBwBN9AL4dqmETlpS2zasx+vTeWclWzkblfZk7KTA5j3jeOONz/tRCnZomUyvNg83wL5Zv9Ss6HMJXAgL8R2Yg==}
+    engines: {node: '>=16 || 14 >=14.17'}
+
+  muggle-string@0.4.1:
+    resolution: {integrity: sha512-VNTrAak/KhO2i8dqqnqnAHOa3cYBwXEZe9h+D5h/1ZqFSTEFHdM65lR7RoIqq3tBBYavsOXV84NoHXZ0AkPyqQ==}
+
+  nanoid@3.3.18:
+    resolution: {integrity: sha512-DTg4MJbGMWkfi6VZFdNt2/caMbQy4Ou+Op/hJQvGEWcnVfoA1QA+xzRKAzw9jD6+GVOOeYr/mIcuDSdug6F6+w==}
+    engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1}
+    hasBin: true
+
+  node-addon-api@7.1.1:
+    resolution: {integrity: sha512-5m3bsyrjFWE1xf7nz7YXdN4udnVtXK6/Yfgn5qnahL6bCkf2yKt4k3nuTKAtT4r3IG8JNR2ncsIMdZuAzJjHQQ==}
+
+  nostics@1.2.0:
+    resolution: {integrity: sha512-FGqEfhQjrvo1lL8KFifdTQiNwwQHJxC1jtYE1Rc54qF/jxONUNL+kC9gS1krX8Q65PgrQ5fCqH/I4NhWBvdSqg==}
+
+  path-browserify@1.0.1:
+    resolution: {integrity: sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==}
+
+  perfect-debounce@2.1.0:
+    resolution: {integrity: sha512-LjgdTytVFXeUgtHZr9WYViYSM/g8MkcTPYDlPa3cDqMirHjKiSZPYd6DoL7pK8AJQr+uWkQvCjHNdiMqsrJs+g==}
+
+  picocolors@1.1.1:
+    resolution: {integrity: sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==}
+
+  picomatch@4.0.7:
+    resolution: {integrity: sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==}
+    engines: {node: '>=12'}
+
+  pinia@4.0.3:
+    resolution: {integrity: sha512-XMQqpvjgG7LMqVhhFUzKLT4KEbsYbfZZ0CZU9PgdFm1O2VKBmIkykL8+SfNhOaT7sR0wT6BEgKT0YNDYWgmVRA==}
+    peerDependencies:
+      '@vue/devtools-api': ^8.1.5
+      typescript: '>=5.6.0'
+      vue: ^3.5.11
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  postcss@8.5.26:
+    resolution: {integrity: sha512-u82N74LFzG8ca+dD8puPnplTXoGH4fTPpVGuIbt36G3qvNlkvfD0lEAZSxaly3KX8TS/L1A1gsCEmvKmBcVbkQ==}
+    engines: {node: ^10 || ^12 || >=14}
+
+  readdirp@5.1.1:
+    resolution: {integrity: sha512-Kko+Y5XQ6fM+Ce3dq3m9YGxnacYZYl9cA1wZjaF3Vbry2L3i1qVg8+CAgNPsXRArPMUMCaOR7oa9Nqntc43JKA==}
+    engines: {node: '>= 20.19.0'}
+
+  rollup@4.63.0:
+    resolution: {integrity: sha512-T5vnZ2y4QqC3/4P+w2+JO+Q/OVdnPsv4XcSYJYMEn0R9/jjl5AgLwO9LAZMzP2lN71O6pypn91rB7lDstUkfrQ==}
+    engines: {node: '>=18.0.0', npm: '>=8.0.0'}
+    hasBin: true
+
+  sass@1.103.1:
+    resolution: {integrity: sha512-9icZURbP51S6S0QGoyaeqk9uB06GNWxsFYWfH5RgpFgqK5FA8tJcM3AdVxrZEVJ7dz+L87nG95gBKf4VuaMHGw==}
+    engines: {node: '>=20.19.0'}
+    hasBin: true
+
+  source-map-js@1.2.1:
+    resolution: {integrity: sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==}
+    engines: {node: '>=0.10.0'}
+
+  tinyglobby@0.2.17:
+    resolution: {integrity: sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==}
+    engines: {node: '>=12.0.0'}
+
+  typescript@5.3.2:
+    resolution: {integrity: sha512-6l+RyNy7oAHDfxC4FzSJcz9vnjTKxrLpDG5M2Vu4SHRVNg6xzqZp6LYSR9zjqQTu8DU/f5xwxUdADOkbrIX2gQ==}
+    engines: {node: '>=14.17'}
+    hasBin: true
+
+  uuid@14.0.2:
+    resolution: {integrity: sha512-xZe/16rV4aa+HGSOCiY2YeLT1OybRLrrkL/Rqaq7p7GMVXjFh+6wN4oMYgjFmnSnhY8t6Xpdl2l9qmnHYuMHwQ==}
+    hasBin: true
+
+  vite@6.4.3:
+    resolution: {integrity: sha512-NTKlcQjlAK7MlQoyb6LgaqHc8sso/pVyUJYWMws3jg21uTJw/LddqIFPcPqP6PzpgbIcZyKI85sFE4HBrQDA8A==}
+    engines: {node: ^18.0.0 || ^20.0.0 || >=22.0.0}
+    hasBin: true
+    peerDependencies:
+      '@types/node': ^18.0.0 || ^20.0.0 || >=22.0.0
+      jiti: '>=1.21.0'
+      less: '*'
+      lightningcss: ^1.21.0
+      sass: '*'
+      sass-embedded: '*'
+      stylus: '*'
+      sugarss: '*'
+      terser: ^5.16.0
+      tsx: ^4.8.1
+      yaml: ^2.4.2
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+      jiti:
+        optional: true
+      less:
+        optional: true
+      lightningcss:
+        optional: true
+      sass:
+        optional: true
+      sass-embedded:
+        optional: true
+      stylus:
+        optional: true
+      sugarss:
+        optional: true
+      terser:
+        optional: true
+      tsx:
+        optional: true
+      yaml:
+        optional: true
+
+  vscode-uri@3.2.0:
+    resolution: {integrity: sha512-m2gXo3bn0G1kT9InzMf07fTbqMbGtyckj3bH5ktLO+1Ssv+yiATZ4dhwaQv9UZWxJh6E9IFGnQyjgWVDWVBDrg==}
+
+  vue-tsc@2.2.12:
+    resolution: {integrity: sha512-P7OP77b2h/Pmk+lZdJ0YWs+5tJ6J2+uOQPo7tlBnY44QqQSPYvS0qVT4wqDJgwrZaLe47etJLLQRFia71GYITw==}
+    hasBin: true
+    peerDependencies:
+      typescript: '>=5.0.0'
+
+  vue@3.5.42:
+    resolution: {integrity: sha512-4RyHQTbQvOPs3MfvUO1Sg0YRrKNnA0mAVtvpd12Tg1fKDN7OHBUl1IqSn8zGJjK9nI3NkNp8cgTpVrSZC5TTcA==}
+    peerDependencies:
+      typescript: '*'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+snapshots:
+
+  '@babel/helper-string-parser@7.29.7': {}
+
+  '@babel/helper-validator-identifier@7.29.7': {}
+
+  '@babel/parser@7.29.8':
+    dependencies:
+      '@babel/types': 7.29.8
+
+  '@babel/types@7.29.8':
+    dependencies:
+      '@babel/helper-string-parser': 7.29.7
+      '@babel/helper-validator-identifier': 7.29.7
+
+  '@esbuild/aix-ppc64@0.25.0':
+    optional: true
+
+  '@esbuild/android-arm64@0.25.0':
+    optional: true
+
+  '@esbuild/android-arm@0.25.0':
+    optional: true
+
+  '@esbuild/android-x64@0.25.0':
+    optional: true
+
+  '@esbuild/darwin-arm64@0.25.0':
+    optional: true
+
+  '@esbuild/darwin-x64@0.25.0':
+    optional: true
+
+  '@esbuild/freebsd-arm64@0.25.0':
+    optional: true
+
+  '@esbuild/freebsd-x64@0.25.0':
+    optional: true
+
+  '@esbuild/linux-arm64@0.25.0':
+    optional: true
+
+  '@esbuild/linux-arm@0.25.0':
+    optional: true
+
+  '@esbuild/linux-ia32@0.25.0':
+    optional: true
+
+  '@esbuild/linux-loong64@0.25.0':
+    optional: true
+
+  '@esbuild/linux-mips64el@0.25.0':
+    optional: true
+
+  '@esbuild/linux-ppc64@0.25.0':
+    optional: true
+
+  '@esbuild/linux-riscv64@0.25.0':
+    optional: true
+
+  '@esbuild/linux-s390x@0.25.0':
+    optional: true
+
+  '@esbuild/linux-x64@0.25.0':
+    optional: true
+
+  '@esbuild/netbsd-arm64@0.25.0':
+    optional: true
+
+  '@esbuild/netbsd-x64@0.25.0':
+    optional: true
+
+  '@esbuild/openbsd-arm64@0.25.0':
+    optional: true
+
+  '@esbuild/openbsd-x64@0.25.0':
+    optional: true
+
+  '@esbuild/sunos-x64@0.25.0':
+    optional: true
+
+  '@esbuild/win32-arm64@0.25.0':
+    optional: true
+
+  '@esbuild/win32-ia32@0.25.0':
+    optional: true
+
+  '@esbuild/win32-x64@0.25.0':
+    optional: true
+
+  '@jridgewell/sourcemap-codec@1.5.5': {}
+
+  '@napi-rs/lzma-linux-x64-gnu@1.5.1':
+    optional: true
+
+  '@parcel/watcher-android-arm64@2.6.0':
+    optional: true
+
+  '@parcel/watcher-darwin-arm64@2.6.0':
+    optional: true
+
+  '@parcel/watcher-darwin-x64@2.6.0':
+    optional: true
+
+  '@parcel/watcher-freebsd-x64@2.6.0':
+    optional: true
+
+  '@parcel/watcher-linux-arm-glibc@2.6.0':
+    optional: true
+
+  '@parcel/watcher-linux-arm-musl@2.6.0':
+    optional: true
+
+  '@parcel/watcher-linux-arm64-glibc@2.6.0':
+    optional: true
+
+  '@parcel/watcher-linux-arm64-musl@2.6.0':
+    optional: true
+
+  '@parcel/watcher-linux-x64-glibc@2.6.0':
+    optional: true
+
+  '@parcel/watcher-linux-x64-musl@2.6.0':
+    optional: true
+
+  '@parcel/watcher-win32-arm64@2.6.0':
+    optional: true
+
+  '@parcel/watcher-win32-x64@2.6.0':
+    optional: true
+
+  '@parcel/watcher@2.6.0':
+    dependencies:
+      detect-libc: 2.1.2
+      is-glob: 4.0.3
+      node-addon-api: 7.1.1
+      picomatch: 4.0.7
+    optionalDependencies:
+      '@parcel/watcher-android-arm64': 2.6.0
+      '@parcel/watcher-darwin-arm64': 2.6.0
+      '@parcel/watcher-darwin-x64': 2.6.0
+      '@parcel/watcher-freebsd-x64': 2.6.0
+      '@parcel/watcher-linux-arm-glibc': 2.6.0
+      '@parcel/watcher-linux-arm-musl': 2.6.0
+      '@parcel/watcher-linux-arm64-glibc': 2.6.0
+      '@parcel/watcher-linux-arm64-musl': 2.6.0
+      '@parcel/watcher-linux-x64-glibc': 2.6.0
+      '@parcel/watcher-linux-x64-musl': 2.6.0
+      '@parcel/watcher-win32-arm64': 2.6.0
+      '@parcel/watcher-win32-x64': 2.6.0
+    optional: true
+
+  '@rollup/rollup-android-arm-eabi@4.63.0':
+    optional: true
+
+  '@rollup/rollup-android-arm64@4.63.0':
+    optional: true
+
+  '@rollup/rollup-darwin-arm64@4.63.0':
+    optional: true
+
+  '@rollup/rollup-darwin-x64@4.63.0':
+    optional: true
+
+  '@rollup/rollup-freebsd-arm64@4.63.0':
+    optional: true
+
+  '@rollup/rollup-freebsd-x64@4.63.0':
+    optional: true
+
+  '@rollup/rollup-linux-arm-gnueabihf@4.63.0':
+    optional: true
+
+  '@rollup/rollup-linux-arm-musleabihf@4.63.0':
+    optional: true
+
+  '@rollup/rollup-linux-arm64-gnu@4.63.0':
+    optional: true
+
+  '@rollup/rollup-linux-arm64-musl@4.63.0':
+    optional: true
+
+  '@rollup/rollup-linux-loong64-gnu@4.63.0':
+    optional: true
+
+  '@rollup/rollup-linux-loong64-musl@4.63.0':
+    optional: true
+
+  '@rollup/rollup-linux-ppc64-gnu@4.63.0':
+    optional: true
+
+  '@rollup/rollup-linux-ppc64-musl@4.63.0':
+    optional: true
+
+  '@rollup/rollup-linux-riscv64-gnu@4.63.0':
+    optional: true
+
+  '@rollup/rollup-linux-riscv64-musl@4.63.0':
+    optional: true
+
+  '@rollup/rollup-linux-s390x-gnu@4.63.0':
+    optional: true
+
+  '@rollup/rollup-linux-x64-gnu@4.63.0':
+    optional: true
+
+  '@rollup/rollup-linux-x64-musl@4.63.0':
+    optional: true
+
+  '@rollup/rollup-openbsd-x64@4.63.0':
+    optional: true
+
+  '@rollup/rollup-openharmony-arm64@4.63.0':
+    optional: true
+
+  '@rollup/rollup-win32-arm64-msvc@4.63.0':
+    optional: true
+
+  '@rollup/rollup-win32-ia32-msvc@4.63.0':
+    optional: true
+
+  '@rollup/rollup-win32-x64-gnu@4.63.0':
+    optional: true
+
+  '@rollup/rollup-win32-x64-msvc@4.63.0':
+    optional: true
+
+  '@types/estree@1.0.9': {}
+
+  '@vitejs/plugin-vue@5.2.1(vite@6.4.3(sass@1.103.1))(vue@3.5.42(typescript@5.3.2))':
+    dependencies:
+      vite: 6.4.3(sass@1.103.1)
+      vue: 3.5.42(typescript@5.3.2)
+
+  '@volar/language-core@2.4.15':
+    dependencies:
+      '@volar/source-map': 2.4.15
+
+  '@volar/source-map@2.4.15': {}
+
+  '@volar/typescript@2.4.15':
+    dependencies:
+      '@volar/language-core': 2.4.15
+      path-browserify: 1.0.1
+      vscode-uri: 3.2.0
+
+  '@vue/compiler-core@3.5.42':
+    dependencies:
+      '@babel/parser': 7.29.8
+      '@vue/shared': 3.5.42
+      entities: 7.0.1
+      estree-walker: 2.0.2
+      source-map-js: 1.2.1
+
+  '@vue/compiler-dom@3.5.42':
+    dependencies:
+      '@vue/compiler-core': 3.5.42
+      '@vue/shared': 3.5.42
+
+  '@vue/compiler-sfc@3.5.42':
+    dependencies:
+      '@babel/parser': 7.29.8
+      '@vue/compiler-core': 3.5.42
+      '@vue/compiler-dom': 3.5.42
+      '@vue/compiler-ssr': 3.5.42
+      '@vue/shared': 3.5.42
+      estree-walker: 2.0.2
+      magic-string: 0.30.21
+      postcss: 8.5.26
+      source-map-js: 1.2.1
+
+  '@vue/compiler-ssr@3.5.42':
+    dependencies:
+      '@vue/compiler-dom': 3.5.42
+      '@vue/shared': 3.5.42
+
+  '@vue/compiler-vue2@2.7.16':
+    dependencies:
+      de-indent: 1.0.2
+      he: 1.2.0
+
+  '@vue/devtools-api@8.2.1':
+    dependencies:
+      '@vue/devtools-kit': 8.2.1
+
+  '@vue/devtools-kit@8.2.1':
+    dependencies:
+      '@vue/devtools-shared': 8.2.1
+      birpc: 2.6.1
+      hookable: 5.5.3
+      perfect-debounce: 2.1.0
+
+  '@vue/devtools-shared@8.2.1': {}
+
+  '@vue/language-core@2.2.12(typescript@5.3.2)':
+    dependencies:
+      '@volar/language-core': 2.4.15
+      '@vue/compiler-dom': 3.5.42
+      '@vue/compiler-vue2': 2.7.16
+      '@vue/shared': 3.5.42
+      alien-signals: 1.0.3
+      minimatch: 9.0.9
+      muggle-string: 0.4.1
+      path-browserify: 1.0.1
+    optionalDependencies:
+      typescript: 5.3.2
+
+  '@vue/reactivity@3.5.42':
+    dependencies:
+      '@vue/shared': 3.5.42
+
+  '@vue/runtime-core@3.5.42':
+    dependencies:
+      '@vue/reactivity': 3.5.42
+      '@vue/shared': 3.5.42
+
+  '@vue/runtime-dom@3.5.42':
+    dependencies:
+      '@vue/reactivity': 3.5.42
+      '@vue/runtime-core': 3.5.42
+      '@vue/shared': 3.5.42
+      csstype: 3.2.3
+
+  '@vue/server-renderer@3.5.42':
+    dependencies:
+      '@vue/compiler-ssr': 3.5.42
+      '@vue/runtime-dom': 3.5.42
+      '@vue/shared': 3.5.42
+
+  '@vue/shared@3.5.42': {}
+
+  '@ztools-center/ztools-api-types@1.0.3': {}
+
+  alien-signals@1.0.3: {}
+
+  balanced-match@1.0.0: {}
+
+  birpc@2.6.1: {}
+
+  brace-expansion@2.1.4:
+    dependencies:
+      balanced-match: 1.0.0
+
+  chokidar@5.0.0:
+    dependencies:
+      readdirp: 5.1.1
+
+  csstype@3.2.3: {}
+
+  de-indent@1.0.2: {}
+
+  detect-libc@2.1.2:
+    optional: true
+
+  entities@7.0.1: {}
+
+  esbuild@0.25.0:
+    optionalDependencies:
+      '@esbuild/aix-ppc64': 0.25.0
+      '@esbuild/android-arm': 0.25.0
+      '@esbuild/android-arm64': 0.25.0
+      '@esbuild/android-x64': 0.25.0
+      '@esbuild/darwin-arm64': 0.25.0
+      '@esbuild/darwin-x64': 0.25.0
+      '@esbuild/freebsd-arm64': 0.25.0
+      '@esbuild/freebsd-x64': 0.25.0
+      '@esbuild/linux-arm': 0.25.0
+      '@esbuild/linux-arm64': 0.25.0
+      '@esbuild/linux-ia32': 0.25.0
+      '@esbuild/linux-loong64': 0.25.0
+      '@esbuild/linux-mips64el': 0.25.0
+      '@esbuild/linux-ppc64': 0.25.0
+      '@esbuild/linux-riscv64': 0.25.0
+      '@esbuild/linux-s390x': 0.25.0
+      '@esbuild/linux-x64': 0.25.0
+      '@esbuild/netbsd-arm64': 0.25.0
+      '@esbuild/netbsd-x64': 0.25.0
+      '@esbuild/openbsd-arm64': 0.25.0
+      '@esbuild/openbsd-x64': 0.25.0
+      '@esbuild/sunos-x64': 0.25.0
+      '@esbuild/win32-arm64': 0.25.0
+      '@esbuild/win32-ia32': 0.25.0
+      '@esbuild/win32-x64': 0.25.0
+
+  estree-walker@2.0.2: {}
+
+  fdir@6.5.0(picomatch@4.0.7):
+    optionalDependencies:
+      picomatch: 4.0.7
+
+  fsevents@2.3.3:
+    optional: true
+
+  he@1.2.0: {}
+
+  hookable@5.5.3: {}
+
+  immutable@5.1.9: {}
+
+  is-extglob@2.1.1:
+    optional: true
+
+  is-glob@4.0.3:
+    dependencies:
+      is-extglob: 2.1.1
+    optional: true
+
+  magic-string@0.30.21:
+    dependencies:
+      '@jridgewell/sourcemap-codec': 1.5.5
+
+  minimatch@9.0.9:
+    dependencies:
+      brace-expansion: 2.1.4
+
+  muggle-string@0.4.1: {}
+
+  nanoid@3.3.18: {}
+
+  node-addon-api@7.1.1:
+    optional: true
+
+  nostics@1.2.0: {}
+
+  path-browserify@1.0.1: {}
+
+  perfect-debounce@2.1.0: {}
+
+  picocolors@1.1.1: {}
+
+  picomatch@4.0.7: {}
+
+  pinia@4.0.3(@vue/devtools-api@8.2.1)(typescript@5.3.2)(vue@3.5.42(typescript@5.3.2)):
+    dependencies:
+      '@vue/devtools-api': 8.2.1
+      nostics: 1.2.0
+      vue: 3.5.42(typescript@5.3.2)
+    optionalDependencies:
+      typescript: 5.3.2
+
+  postcss@8.5.26:
+    dependencies:
+      nanoid: 3.3.18
+      picocolors: 1.1.1
+      source-map-js: 1.2.1
+
+  readdirp@5.1.1: {}
+
+  rollup@4.63.0:
+    dependencies:
+      '@types/estree': 1.0.9
+    optionalDependencies:
+      '@napi-rs/lzma-linux-x64-gnu': 1.5.1
+      '@rollup/rollup-android-arm-eabi': 4.63.0
+      '@rollup/rollup-android-arm64': 4.63.0
+      '@rollup/rollup-darwin-arm64': 4.63.0
+      '@rollup/rollup-darwin-x64': 4.63.0
+      '@rollup/rollup-freebsd-arm64': 4.63.0
+      '@rollup/rollup-freebsd-x64': 4.63.0
+      '@rollup/rollup-linux-arm-gnueabihf': 4.63.0
+      '@rollup/rollup-linux-arm-musleabihf': 4.63.0
+      '@rollup/rollup-linux-arm64-gnu': 4.63.0
+      '@rollup/rollup-linux-arm64-musl': 4.63.0
+      '@rollup/rollup-linux-loong64-gnu': 4.63.0
+      '@rollup/rollup-linux-loong64-musl': 4.63.0
+      '@rollup/rollup-linux-ppc64-gnu': 4.63.0
+      '@rollup/rollup-linux-ppc64-musl': 4.63.0
+      '@rollup/rollup-linux-riscv64-gnu': 4.63.0
+      '@rollup/rollup-linux-riscv64-musl': 4.63.0
+      '@rollup/rollup-linux-s390x-gnu': 4.63.0
+      '@rollup/rollup-linux-x64-gnu': 4.63.0
+      '@rollup/rollup-linux-x64-musl': 4.63.0
+      '@rollup/rollup-openbsd-x64': 4.63.0
+      '@rollup/rollup-openharmony-arm64': 4.63.0
+      '@rollup/rollup-win32-arm64-msvc': 4.63.0
+      '@rollup/rollup-win32-ia32-msvc': 4.63.0
+      '@rollup/rollup-win32-x64-gnu': 4.63.0
+      '@rollup/rollup-win32-x64-msvc': 4.63.0
+      fsevents: 2.3.3
+
+  sass@1.103.1:
+    dependencies:
+      chokidar: 5.0.0
+      immutable: 5.1.9
+      source-map-js: 1.2.1
+    optionalDependencies:
+      '@parcel/watcher': 2.6.0
+
+  source-map-js@1.2.1: {}
+
+  tinyglobby@0.2.17:
+    dependencies:
+      fdir: 6.5.0(picomatch@4.0.7)
+      picomatch: 4.0.7
+
+  typescript@5.3.2: {}
+
+  uuid@14.0.2: {}
+
+  vite@6.4.3(sass@1.103.1):
+    dependencies:
+      esbuild: 0.25.0
+      fdir: 6.5.0(picomatch@4.0.7)
+      picomatch: 4.0.7
+      postcss: 8.5.26
+      rollup: 4.63.0
+      tinyglobby: 0.2.17
+    optionalDependencies:
+      fsevents: 2.3.3
+      sass: 1.103.1
+
+  vscode-uri@3.2.0: {}
+
+  vue-tsc@2.2.12(typescript@5.3.2):
+    dependencies:
+      '@volar/typescript': 2.4.15
+      '@vue/language-core': 2.2.12(typescript@5.3.2)
+      typescript: 5.3.2
+
+  vue@3.5.42(typescript@5.3.2):
+    dependencies:
+      '@vue/compiler-dom': 3.5.42
+      '@vue/compiler-sfc': 3.5.42
+      '@vue/runtime-dom': 3.5.42
+      '@vue/server-renderer': 3.5.42
+      '@vue/shared': 3.5.42
+    optionalDependencies:
+      typescript: 5.3.2
diff --git a/plugins/link-relay/pnpm-workspace.yaml b/plugins/link-relay/pnpm-workspace.yaml
new file mode 100644
index 000000000..06c115425
--- /dev/null
+++ b/plugins/link-relay/pnpm-workspace.yaml
@@ -0,0 +1,3 @@
+allowBuilds:
+  '@parcel/watcher': false
+  esbuild: true
diff --git a/plugins/link-relay/public/logo.png b/plugins/link-relay/public/logo.png
new file mode 100644
index 000000000..f195f8779
Binary files /dev/null and b/plugins/link-relay/public/logo.png differ
diff --git a/plugins/link-relay/public/plugin.json b/plugins/link-relay/public/plugin.json
new file mode 100644
index 000000000..5e3a5e3df
--- /dev/null
+++ b/plugins/link-relay/public/plugin.json
@@ -0,0 +1,39 @@
+{
+  "$schema": "node_modules/@ztools-center/ztools-api-types/resource/ztools.schema.json",
+  "name": "link-relay",
+  "title": "目录迁移助手",
+  "description": "将任意目录（IDE 扩展/配置、缓存、用户数据等）从系统盘迁移到其他磁盘，通过 Junction/符号链接保持程序无感知运行。内置常见 IDE 目录预设，支持自定义任意目录、系统重装一键重建链接、冲突处理与失败自动回滚。",
+  "author": "2029364173@qq.com",
+  "license": "MIT",
+  "version": "1.0.0",
+  "main": "dist/index.html",
+  "preload": "preload/services.js",
+  "logo": "logo.png",
+  "development": {
+    "main": "http://localhost:5173"
+  },
+  "features": [
+    {
+      "code": "dashboard",
+      "explain": "目录迁移助手：把系统盘目录迁移到其他磁盘并建立 Junction 链接，内置 IDE 预设，支持自定义任意目录迁移与链接重建",
+      "icon": "logo.png",
+      "cmds": [
+        "目录迁移",
+        "ide迁移",
+        "vscode迁移",
+        "c盘清理",
+        "junction",
+        "符号链接",
+        "目录搬家",
+        "扩展迁移",
+        "设置迁移",
+        "缓存迁移"
+      ]
+    }
+  ],
+  "platform": [
+    "darwin",
+    "win32",
+    "linux"
+  ]
+}
diff --git a/plugins/link-relay/public/preload/core/link-manager.js b/plugins/link-relay/public/preload/core/link-manager.js
new file mode 100644
index 000000000..b75ebba01
--- /dev/null
+++ b/plugins/link-relay/public/preload/core/link-manager.js
@@ -0,0 +1,217 @@
+/**
+ * 链接管理模块 —— 检测目录链接状态、创建/删除 Junction/Symlink。
+ *
+ * 状态检测逻辑：
+ * - not-installed: 源和目标都不存在
+ * - target-only:   源不存在，目标存在（重装后场景）
+ * - not-linked:    源是实体目录，目标不存在
+ * - linked:        源是链接且指向目标
+ * - broken:        源是链接但指向错误，或目标是链接
+ * - conflict:      源和目标都是实体目录
+ */
+
+const fs = require('node:fs')
+const path = require('node:path')
+
+/** 检测目录是否存在 */
+function dirExists(dirPath) {
+  try {
+    return fs.existsSync(dirPath)
+  } catch {
+    return false
+  }
+}
+
+/** 检测路径是否为符号链接/Junction */
+function isLink(dirPath) {
+  try {
+    const stat = fs.lstatSync(dirPath)
+    return stat.isSymbolicLink()
+  } catch {
+    return false
+  }
+}
+
+/** 获取链接的真实目标路径 */
+function getRealTarget(dirPath) {
+  try {
+    return fs.realpathSync(dirPath)
+  } catch {
+    return null
+  }
+}
+
+/** 规范化路径用于比较（解析大小写、分隔符差异） */
+function normalizePath(p) {
+  if (!p) return ''
+  try {
+    return path.resolve(p).toLowerCase().replace(/[\\/]+$/, '')
+  } catch {
+    return p.toLowerCase().replace(/[\\/]+$/, '')
+  }
+}
+
+/**
+ * 检测单个目录的链接状态。
+ * @param {string} sourcePath 源路径
+ * @param {string} targetPath 目标路径
+ * @returns {{ path: string, target: string, status: string, size: number, realTarget?: string, sourceMtime?: string, targetMtime?: string }}
+ */
+function checkDirStatus(sourcePath, targetPath) {
+  const sourceExists = dirExists(sourcePath)
+  const targetExists = dirExists(targetPath)
+
+  const result = {
+    path: sourcePath,
+    target: targetPath,
+    status: 'unknown',
+    size: 0,
+  }
+
+  // 两侧都不存在
+  if (!sourceExists && !targetExists) {
+    result.status = 'not-installed'
+    return result
+  }
+
+  // 源不存在，目标存在 → 重装后场景
+  if (!sourceExists && targetExists) {
+    result.status = 'target-only'
+    result.size = getDirSizeSync(targetPath)
+    result.targetMtime = getMtime(targetPath)
+    return result
+  }
+
+  // 源存在
+  const sourceIsLink = isLink(sourcePath)
+
+  if (sourceIsLink) {
+    const realTarget = getRealTarget(sourcePath)
+    result.realTarget = realTarget
+    const expectedReal = targetExists ? normalizePath(targetPath) : null
+
+    if (realTarget && expectedReal && normalizePath(realTarget) === expectedReal) {
+      result.status = 'linked'
+      result.size = 0 // 链接本身不占源盘空间
+    } else {
+      result.status = 'broken'
+      result.size = getDirSizeSync(sourcePath)
+    }
+    return result
+  }
+
+  // 源是实体目录
+  if (targetExists) {
+    const targetIsLink = isLink(targetPath)
+    if (targetIsLink) {
+      result.status = 'broken' // 目标是链接，异常
+    } else {
+      result.status = 'conflict' // 两侧都是实体目录
+    }
+    result.size = getDirSizeSync(sourcePath)
+    result.sourceMtime = getMtime(sourcePath)
+    result.targetMtime = getMtime(targetPath)
+    return result
+  }
+
+  // 源是实体目录，目标不存在 → 未迁移
+  result.status = 'not-linked'
+  result.size = getDirSizeSync(sourcePath)
+  result.sourceMtime = getMtime(sourcePath)
+  return result
+}
+
+/** 获取目录大小（递归，同步） */
+function getDirSizeSync(dirPath) {
+  try {
+    if (!fs.existsSync(dirPath)) return 0
+    let total = 0
+    const entries = fs.readdirSync(dirPath, { withFileTypes: true })
+    for (const entry of entries) {
+      const fullPath = path.join(dirPath, entry.name)
+      if (entry.isDirectory()) {
+        // 跳过链接目录，避免循环
+        if (isLink(fullPath)) continue
+        total += getDirSizeSync(fullPath)
+      } else {
+        try {
+          total += fs.statSync(fullPath).size
+        } catch {
+          // 忽略无法读取的文件
+        }
+      }
+    }
+    return total
+  } catch {
+    return 0
+  }
+}
+
+/** 获取目录最后修改时间 */
+function getMtime(dirPath) {
+  try {
+    return fs.statSync(dirPath).mtime.toISOString()
+  } catch {
+    return undefined
+  }
+}
+
+/**
+ * 创建 Junction（Windows）或 Symlink（macOS/Linux）。
+ * Windows 使用 junction 类型，无需管理员权限。
+ */
+function createLink(targetPath, sourcePath) {
+  const platform = process.platform
+  const linkType = platform === 'win32' ? 'junction' : 'dir'
+
+  // 确保源路径的父目录存在
+  const parentDir = path.dirname(sourcePath)
+  if (!fs.existsSync(parentDir)) {
+    fs.mkdirSync(parentDir, { recursive: true })
+  }
+
+  fs.symlinkSync(targetPath, sourcePath, linkType)
+}
+
+/** 删除链接（不删除链接指向的真实数据） */
+function removeLink(linkPath) {
+  if (!isLink(linkPath)) return false
+  try {
+    fs.unlinkSync(linkPath)
+    return true
+  } catch {
+    return false
+  }
+}
+
+/** 验证链接是否正常工作（写入测试文件） */
+function verifyLink(sourcePath, targetPath) {
+  try {
+    const testFile = path.join(sourcePath, `.link-test-${Date.now()}.tmp`)
+    fs.writeFileSync(testFile, 'verify', { encoding: 'utf-8' })
+
+    // 检查目标端是否可见
+    const targetTestFile = path.join(targetPath, path.basename(testFile))
+    const visible = fs.existsSync(targetTestFile)
+
+    // 清理测试文件
+    try { fs.unlinkSync(testFile) } catch { /* ignore */ }
+
+    return visible
+  } catch {
+    return false
+  }
+}
+
+module.exports = {
+  dirExists,
+  isLink,
+  getRealTarget,
+  normalizePath,
+  checkDirStatus,
+  getDirSizeSync,
+  getMtime,
+  createLink,
+  removeLink,
+  verifyLink,
+}
diff --git a/plugins/link-relay/public/preload/core/migration-engine.js b/plugins/link-relay/public/preload/core/migration-engine.js
new file mode 100644
index 000000000..87436b5f2
--- /dev/null
+++ b/plugins/link-relay/public/preload/core/migration-engine.js
@@ -0,0 +1,615 @@
+/**
+ * 迁移引擎 —— 核心迁移逻辑，支持 dry-run 预览、执行、回滚、进度推送。
+ *
+ * 迁移流程：
+ * 前置检查 → 数据复制 → 备份原目录 → 创建链接 → 验证链接 → 清理备份
+ *
+ * 任何步骤失败时自动回滚：删除链接 → 恢复备份目录名。
+ */
+
+const fs = require('node:fs')
+const path = require('node:path')
+const { execSync } = require('node:child_process')
+const { EventEmitter } = require('node:events')
+const {
+  createLink,
+  removeLink,
+  verifyLink,
+  isLink,
+  getDirSizeSync,
+} = require('./link-manager')
+const { isRunning } = require('./process-checker')
+
+const progressEmitter = new EventEmitter()
+let abortRequested = false
+
+/** 格式化字节大小 */
+function formatSize(bytes) {
+  if (bytes === 0) return '0 B'
+  const units = ['B', 'KB', 'MB', 'GB', 'TB']
+  const i = Math.floor(Math.log(bytes) / Math.log(1024))
+  return `${(bytes / Math.pow(1024, i)).toFixed(i >= 2 ? 1 : 0)} ${units[i]}`
+}
+
+/** 生成时间戳 */
+function timestamp() {
+  const d = new Date()
+  const pad = (n) => String(n).padStart(2, '0')
+  return `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}-${pad(d.getHours())}${pad(d.getMinutes())}${pad(d.getSeconds())}`
+}
+
+/** 发射进度事件 */
+function emit(type, data) {
+  progressEmitter.emit('progress', type, data)
+}
+
+/** 订阅进度事件，返回取消订阅函数 */
+function onProgress(cb) {
+  const listener = (type, data) => {
+    try { cb(type, data) } catch { /* ignore listener errors */ }
+  }
+  progressEmitter.on('progress', listener)
+  return () => progressEmitter.off('progress', listener)
+}
+
+/** 请求中止迁移 */
+function abortMigration() {
+  abortRequested = true
+}
+
+/** 获取磁盘可用空间（字节） */
+function getDiskFreeSpace(dirPath) {
+  try {
+    // Windows: 尝试使用 wmic 或 fsutil
+    if (process.platform === 'win32') {
+      const drive = path.parse(dirPath).root || 'C:\\'
+      try {
+        const output = execSync(`fsutil volume diskfree ${drive}`, {
+          encoding: 'utf-8',
+          windowsHide: true,
+          timeout: 3000,
+        })
+        const match = output.match(/总可用字节数[^\d]*(\d+)/) || output.match(/free bytes[^\d]*(\d+)/i)
+        if (match) return parseInt(match[1], 10)
+      } catch { /* fallback below */ }
+    }
+    // 简单估算：返回一个较大值表示空间充足（实际环境应使用 statfs）
+    return 100 * 1024 * 1024 * 1024 // 100GB 估算
+  } catch {
+    return 0
+  }
+}
+
+/**
+ * Dry-run 预览：生成迁移操作计划，不修改文件系统。
+ * @param {Array} items 可迁移项列表
+ * @param {Object} options 迁移选项
+ * @returns {Object} PreviewResult
+ */
+function dryRun(items, options = {}) {
+  const itemIds = options.itemIds
+  const scoped = itemIds && itemIds.length > 0
+    ? items.filter((item) => itemIds.includes(item.id))
+    : items.filter((item) => item.enabled)
+
+  const operations = []
+  const conflicts = []
+  let totalSize = 0
+
+  for (const item of scoped) {
+    const { dir } = item
+    let action = 'skip'
+    let reason = ''
+
+    switch (dir.status) {
+      case 'linked':
+        action = 'skip'
+        reason = '已正确链接，无需操作'
+        break
+      case 'not-linked':
+        action = 'migrate'
+        reason = '实体目录，需迁移并创建链接'
+        totalSize += dir.size
+        break
+      case 'target-only':
+        action = 'relink'
+        reason = '源不存在，目标有数据，直接创建链接（重装恢复）'
+        break
+      case 'broken':
+        action = 'repair'
+        reason = '链接断裂或指向错误，需修复重建'
+        break
+      case 'conflict':
+        action = 'migrate'
+        reason = `冲突：以${options.conflictStrategy === 'prefer-target' ? '目标盘' : '源盘'}数据为准，另一侧移入备份`
+        totalSize += dir.size
+        conflicts.push({
+          itemId: item.id,
+          groupDisplayName: item.groupDisplayName,
+          dirLabel: item.label,
+          source: dir.path,
+          target: dir.target,
+        })
+        break
+      default:
+        action = 'skip'
+        reason = '状态未知，跳过'
+    }
+
+    operations.push({
+      itemId: item.id,
+      groupDisplayName: item.groupDisplayName,
+      dirLabel: item.label,
+      action,
+      source: dir.path,
+      target: dir.target,
+      size: dir.size,
+      reason,
+    })
+  }
+
+  // 估算目标盘可用空间（取第一个操作的目标路径所在盘）
+  const firstTarget = operations.find((o) => o.action !== 'skip')?.target
+  const targetFree = firstTarget ? getDiskFreeSpace(firstTarget) : 0
+
+  return {
+    operations,
+    totalSize,
+    totalSizeFormatted: formatSize(totalSize),
+    targetFree,
+    targetFreeFormatted: formatSize(targetFree),
+    conflicts,
+    hasConflicts: conflicts.length > 0,
+  }
+}
+
+/**
+ * 执行迁移。
+ * @param {Array} items 可迁移项列表
+ * @param {Object} options 迁移选项
+ * @returns {Promise<Array>} 迁移结果列表
+ */
+async function migrate(items, options = {}) {
+  abortRequested = false
+  const plan = dryRun(items, options)
+  const toExecute = plan.operations.filter((o) => o.action !== 'skip')
+  const results = []
+
+  emit('log', { level: 'info', message: `开始迁移，共 ${toExecute.length} 项待处理` })
+
+  for (const op of toExecute) {
+    // 每项之间让出事件循环，让前端能收到进度事件并更新 UI
+    await new Promise((resolve) => setImmediate(resolve))
+
+    if (abortRequested) {
+      emit('log', { level: 'warn', message: '用户请求中止，剩余任务跳过' })
+      break
+    }
+
+    const item = items.find((i) => i.id === op.itemId)
+    if (!item) {
+      results.push({ success: false, itemId: op.itemId, action: op.action, error: '未找到可迁移项' })
+      continue
+    }
+
+    try {
+      const result = await migrateOne(item, op, options)
+      results.push(result)
+      emit('item-done', { itemId: item.id, success: result.success })
+    } catch (err) {
+      const result = {
+        success: false,
+        itemId: item.id,
+        action: op.action,
+        error: err.message || '迁移失败',
+        rolledBack: true,
+      }
+      results.push(result)
+      emit('item-done', { itemId: item.id, success: false })
+      emit('log', { level: 'error', message: `[${item.groupDisplayName} - ${item.label}] 失败: ${err.message}` })
+    }
+  }
+
+  emit('done', { results })
+  return results
+}
+
+/**
+ * 迁移单个可迁移项。
+ */
+async function migrateOne(item, op, options) {
+  const { dir } = item
+  const source = dir.path
+  const target = dir.target
+  const backupPath = `${source}.backup-${timestamp()}`
+
+  emit('phase', {
+    phase: 'precheck',
+    itemId: item.id,
+    groupDisplayName: item.groupDisplayName,
+    dirLabel: item.label,
+    message: `前置检查：${item.groupDisplayName} - ${item.label}`,
+  })
+
+  // 1. 进程检测
+  if (item.exeNames && item.exeNames.length > 0 && isRunning(item.exeNames)) {
+    throw new Error(`检测到相关进程正在运行，请先关闭 ${item.exeNames.join(', ')}`)
+  }
+
+  // 2. 空间检查（仅 migrate 操作需要复制数据）
+  if (op.action === 'migrate' && dir.size > 0) {
+    const free = getDiskFreeSpace(target)
+    if (free > 0 && free < dir.size * 1.1) {
+      throw new Error(`目标盘空间不足，需要 ${formatSize(dir.size * 1.1)}，可用 ${formatSize(free)}`)
+    }
+  }
+
+  // 根据操作类型执行不同流程
+  if (op.action === 'relink') {
+    return await relinkOne(item, op)
+  }
+
+  if (op.action === 'repair') {
+    return await repairOne(item, op)
+  }
+
+  // migrate 操作
+  return await doMigrate(item, op, source, target, backupPath, options)
+}
+
+/**
+ * 执行标准迁移流程（migrate）。
+ */
+async function doMigrate(item, op, source, target, backupPath, options) {
+  // 3. 数据复制
+  emit('phase', {
+    phase: 'copy',
+    itemId: item.id,
+    groupDisplayName: item.groupDisplayName,
+    dirLabel: item.label,
+    message: `复制数据到 ${target}…`,
+  })
+
+  // 冲突处理：如果目标已存在，先处理
+  if (op.action === 'migrate' && fs.existsSync(target) && !isLink(target)) {
+    if (options.conflictStrategy === 'prefer-target') {
+      // 以目标为准：源数据移入备份，直接创建链接
+      emit('log', { level: 'info', message: '冲突策略：以目标盘为准，源数据移入备份' })
+      fs.renameSync(source, backupPath)
+      createLink(target, source)
+      const verified = verifyLink(source, target)
+      if (!verified) throw new Error('链接验证失败')
+      return {
+        success: true,
+        itemId: item.id,
+        action: 'migrate',
+        filesCopied: 0,
+        bytesCopied: 0,
+        backupPath: options.keepBackup ? backupPath : null,
+      }
+    } else {
+      // 以源为准（默认）：目标旧数据移入备份
+      const targetBackup = `${target}.backup-${timestamp()}`
+      emit('log', { level: 'info', message: `冲突策略：以源盘为准，目标旧数据移入 ${targetBackup}` })
+      fs.renameSync(target, targetBackup)
+    }
+  }
+
+  const copyResult = copyDirectory(source, target, item, options)
+
+  // 4. 备份原目录（重命名）
+  emit('phase', {
+    phase: 'backup',
+    itemId: item.id,
+    groupDisplayName: item.groupDisplayName,
+    dirLabel: item.label,
+    message: '备份原目录…',
+  })
+
+  try {
+    fs.renameSync(source, backupPath)
+  } catch (err) {
+    throw new Error(`备份原目录失败: ${err.message}`)
+  }
+
+  // 5. 创建链接
+  emit('phase', {
+    phase: 'link',
+    itemId: item.id,
+    groupDisplayName: item.groupDisplayName,
+    dirLabel: item.label,
+    message: '创建 Junction 链接…',
+  })
+
+  try {
+    createLink(target, source)
+  } catch (err) {
+    // 回滚：恢复备份
+    try { fs.renameSync(backupPath, source) } catch { /* ignore */ }
+    throw new Error(`创建链接失败，已回滚: ${err.message}`)
+  }
+
+  // 6. 验证链接
+  emit('phase', {
+    phase: 'verify',
+    itemId: item.id,
+    groupDisplayName: item.groupDisplayName,
+    dirLabel: item.label,
+    message: '验证链接…',
+  })
+
+  const verified = verifyLink(source, target)
+  if (!verified) {
+    // 回滚
+    removeLink(source)
+    try { fs.renameSync(backupPath, source) } catch { /* ignore */ }
+    throw new Error('链接验证失败，已回滚')
+  }
+
+  // 7. 清理备份
+  if (!options.keepBackup) {
+    emit('phase', {
+      phase: 'cleanup',
+      itemId: item.id,
+      groupDisplayName: item.groupDisplayName,
+      dirLabel: item.label,
+      message: '清理备份…',
+    })
+    try {
+      fs.rmSync(backupPath, { recursive: true, force: true })
+    } catch {
+      emit('log', { level: 'warn', message: `备份清理失败，可手动删除: ${backupPath}` })
+    }
+  }
+
+  emit('log', {
+    level: 'ok',
+    message: `[${item.groupDisplayName} - ${item.label}] 迁移完成`,
+  })
+
+  return {
+    success: true,
+    itemId: item.id,
+    action: 'migrate',
+    filesCopied: copyResult.filesCopied,
+    bytesCopied: copyResult.bytesCopied,
+    backupPath: options.keepBackup ? backupPath : null,
+  }
+}
+
+/**
+ * 重建链接（relink）—— 源不存在，目标有数据。
+ */
+async function relinkOne(item, op) {
+  const { dir } = item
+  emit('phase', {
+    phase: 'link',
+    itemId: item.id,
+    groupDisplayName: item.groupDisplayName,
+    dirLabel: item.label,
+    message: '重建链接…',
+  })
+
+  if (!fs.existsSync(dir.target)) {
+    throw new Error('目标目录不存在，无法重建链接')
+  }
+
+  createLink(dir.target, dir.path)
+  const verified = verifyLink(dir.path, dir.target)
+  if (!verified) {
+    removeLink(dir.path)
+    throw new Error('链接验证失败')
+  }
+
+  emit('log', { level: 'ok', message: `[${item.groupDisplayName} - ${item.label}] 链接重建完成` })
+  return { success: true, itemId: item.id, action: 'relink', filesCopied: 0, bytesCopied: 0 }
+}
+
+/**
+ * 修复链接（repair）—— 链接断裂或指向错误。
+ */
+async function repairOne(item, op) {
+  const { dir } = item
+  emit('phase', {
+    phase: 'repair',
+    itemId: item.id,
+    groupDisplayName: item.groupDisplayName,
+    dirLabel: item.label,
+    message: '修复链接…',
+  })
+
+  // 删除错误链接
+  if (isLink(dir.path)) {
+    removeLink(dir.path)
+  }
+
+  // 如果目标不存在但源是实体目录，执行标准迁移
+  if (!fs.existsSync(dir.target) && fs.existsSync(dir.path) && !isLink(dir.path)) {
+    const backupPath = `${dir.path}.backup-${timestamp()}`
+    return doMigrate(item, op, dir.path, dir.target, backupPath, {})
+  }
+
+  // 目标存在，直接创建链接
+  if (!fs.existsSync(dir.target)) {
+    throw new Error('目标目录不存在，无法修复')
+  }
+
+  createLink(dir.target, dir.path)
+  const verified = verifyLink(dir.path, dir.target)
+  if (!verified) {
+    removeLink(dir.path)
+    throw new Error('链接验证失败')
+  }
+
+  emit('log', { level: 'ok', message: `[${item.groupDisplayName} - ${item.label}] 链接修复完成` })
+  return { success: true, itemId: item.id, action: 'repair', filesCopied: 0, bytesCopied: 0 }
+}
+
+/**
+ * 复制目录（优先使用 robocopy，降级为 Node.js 递归复制）。
+ * 返回 { filesCopied, bytesCopied }
+ */
+function copyDirectory(source, target, item, options) {
+  // 确保目标父目录存在
+  const parentDir = path.dirname(target)
+  if (!fs.existsSync(parentDir)) {
+    fs.mkdirSync(parentDir, { recursive: true })
+  }
+
+  // Windows: 优先使用 robocopy
+  if (process.platform === 'win32') {
+    try {
+      const args = [
+        `"${source}"`,
+        `"${target}"`,
+        '/E',           // 复制子目录，包括空目录
+        '/MT:8',        // 8 线程多线程
+        '/R:1',         // 失败重试 1 次
+        '/W:1',         // 重试等待 1 秒
+        '/NFL',         // 不列出文件
+        '/NDL',         // 不列出目录
+        '/NP',          // 不显示进度
+      ]
+
+      // 排除缓存目录
+      if (options.excludeCache && item.cachePatterns && item.cachePatterns.length > 0) {
+        for (const pattern of item.cachePatterns) {
+          args.push(`/XD "${pattern}"`)
+        }
+      }
+
+      const cmd = `robocopy ${args.join(' ')}`
+      execSync(cmd, { encoding: 'utf-8', windowsHide: true, timeout: 600000 })
+
+      // robocopy 返回码 0-7 表示成功，8+ 表示错误
+      // 但 execSync 在非零返回码时会抛异常，所以这里需要特殊处理
+      // 实际上 robocopy 的返回码 1 表示成功复制了文件，也是非零
+      // 所以我们用 spawnSync 来获取返回码
+    } catch (err) {
+      // robocopy 返回码 1-7 是正常的（表示有文件被复制等）
+      // 只有 >=8 才是真正的错误
+      if (err.status !== undefined && err.status >= 8) {
+        // 降级为 Node.js 复制
+        return copyDirectoryNode(source, target, item, options)
+      }
+      // 返回码 < 8 视为成功
+    }
+
+    // 估算复制结果
+    const filesCopied = countFiles(target)
+    const bytesCopied = getDirSizeSync(target)
+    emit('progress', {
+      filesCopied,
+      bytesCopied,
+      currentFile: '',
+      itemId: item.id,
+      groupDisplayName: item.groupDisplayName,
+      dirLabel: item.label,
+    })
+    return { filesCopied, bytesCopied }
+  }
+
+  // macOS/Linux: 优先使用 rsync
+  if (process.platform !== 'win32') {
+    try {
+      const rsyncArgs = ['-a']
+      if (options.excludeCache && item.cachePatterns) {
+        for (const pattern of item.cachePatterns) {
+          rsyncArgs.push(`--exclude=${pattern}`)
+        }
+      }
+      execSync(`rsync ${rsyncArgs.join(' ')} "${source}/" "${target}/"`, {
+        encoding: 'utf-8',
+        timeout: 600000,
+      })
+      const filesCopied = countFiles(target)
+      const bytesCopied = getDirSizeSync(target)
+      return { filesCopied, bytesCopied }
+    } catch {
+      // 降级为 Node.js 复制
+    }
+  }
+
+  // 降级：Node.js 递归复制
+  return copyDirectoryNode(source, target, item, options)
+}
+
+/** Node.js 递归复制目录 */
+function copyDirectoryNode(source, target, item, options) {
+  let filesCopied = 0
+  let bytesCopied = 0
+
+  function copyRecursive(src, dst) {
+    if (!fs.existsSync(dst)) {
+      fs.mkdirSync(dst, { recursive: true })
+    }
+
+    const entries = fs.readdirSync(src, { withFileTypes: true })
+    for (const entry of entries) {
+      const srcPath = path.join(src, entry.name)
+      const dstPath = path.join(dst, entry.name)
+
+      // 排除缓存目录
+      if (entry.isDirectory() && options.excludeCache && item.cachePatterns?.includes(entry.name)) {
+        continue
+      }
+
+      if (entry.isDirectory()) {
+        if (isLink(srcPath)) continue // 跳过链接目录
+        copyRecursive(srcPath, dstPath)
+      } else {
+        try {
+          fs.copyFileSync(srcPath, dstPath)
+          filesCopied++
+          bytesCopied += fs.statSync(srcPath).size
+
+          // 每 50 个文件推送一次进度
+          if (filesCopied % 50 === 0) {
+            emit('progress', {
+              filesCopied,
+              bytesCopied,
+              currentFile: srcPath,
+              itemId: item.id,
+              groupDisplayName: item.groupDisplayName,
+              dirLabel: item.label,
+            })
+          }
+        } catch {
+          // 忽略无法复制的文件
+        }
+      }
+    }
+  }
+
+  copyRecursive(source, target)
+  return { filesCopied, bytesCopied }
+}
+
+/** 统计目录下文件数 */
+function countFiles(dirPath) {
+  try {
+    let count = 0
+    const entries = fs.readdirSync(dirPath, { withFileTypes: true })
+    for (const entry of entries) {
+      const fullPath = path.join(dirPath, entry.name)
+      if (entry.isDirectory()) {
+        if (isLink(fullPath)) continue
+        count += countFiles(fullPath)
+      } else {
+        count++
+      }
+    }
+    return count
+  } catch {
+    return 0
+  }
+}
+
+module.exports = {
+  formatSize,
+  getDiskFreeSpace,
+  dryRun,
+  migrate,
+  abortMigration,
+  onProgress,
+}
diff --git a/plugins/link-relay/public/preload/core/path-util.js b/plugins/link-relay/public/preload/core/path-util.js
new file mode 100644
index 000000000..bee801f9f
--- /dev/null
+++ b/plugins/link-relay/public/preload/core/path-util.js
@@ -0,0 +1,46 @@
+/**
+ * 路径工具 —— 通用的环境变量 / 主目录 / 跨平台路径展开（无状态、纯函数）。
+ *
+ * 新架构不再有预设库：分组与映射全部由前端维护并以绝对路径传入，
+ * 这里仅保留 expandEnv 供 window.services 暴露，以及内部复用的 resolve* 辅助。
+ */
+
+const path = require('node:path')
+const os = require('node:os')
+
+/** 展开环境变量（Windows %VAR% / Unix ${VAR}、$VAR） */
+function expandEnv(p) {
+  if (!p) return p
+  let result = p
+  result = result.replace(/%([^%]+)%/g, (_, key) => process.env[key] || '')
+  result = result.replace(/\$\{([^}]+)\}/g, (_, key) => process.env[key] || '')
+  result = result.replace(/\$([A-Za-z_][A-Za-z0-9_]*)/g, (_, key) => process.env[key] || '')
+  return result
+}
+
+/** 解析 ~ 为用户主目录 */
+function resolveHome(p) {
+  if (!p) return p
+  if (p.startsWith('~')) return path.join(os.homedir(), p.slice(1))
+  return p
+}
+
+/** 展开环境变量 + ~ */
+function resolvePath(p) {
+  if (!p) return ''
+  return resolveHome(expandEnv(p))
+}
+
+/** 按当前平台取模板路径（字符串或 {win32,darwin,linux}）并展开 */
+function resolvePlatformPath(template) {
+  if (!template) return ''
+  if (typeof template === 'string') return resolvePath(template)
+  return resolvePath(template[process.platform] || template.win32 || '')
+}
+
+module.exports = {
+  expandEnv,
+  resolvePath,
+  resolveHome,
+  resolvePlatformPath,
+}
diff --git a/plugins/link-relay/public/preload/core/process-checker.js b/plugins/link-relay/public/preload/core/process-checker.js
new file mode 100644
index 000000000..5fda4a1dd
--- /dev/null
+++ b/plugins/link-relay/public/preload/core/process-checker.js
@@ -0,0 +1,40 @@
+/**
+ * 进程检测模块 —— 检测指定可执行文件是否正在运行。
+ * 迁移前必须确认 IDE 进程已关闭，防止数据损坏。
+ */
+
+const { execSync } = require('node:child_process')
+
+/**
+ * 检测指定可执行文件是否正在运行。
+ * @param {string[]} exeNames 可执行文件名列表
+ * @returns {boolean}
+ */
+function isRunning(exeNames) {
+  if (!exeNames || exeNames.length === 0) return false
+
+  try {
+    if (process.platform === 'win32') {
+      // Windows: 使用 tasklist 批量获取，然后在结果中查找
+      const output = execSync('tasklist /FO CSV /NH', {
+        encoding: 'utf-8',
+        windowsHide: true,
+        timeout: 5000,
+      })
+      const lowerOutput = output.toLowerCase()
+      return exeNames.some((name) => lowerOutput.includes(name.toLowerCase()))
+    } else {
+      // macOS/Linux: 使用 ps
+      const output = execSync('ps -A -o comm=', {
+        encoding: 'utf-8',
+        timeout: 5000,
+      })
+      const lowerOutput = output.toLowerCase()
+      return exeNames.some((name) => lowerOutput.includes(name.toLowerCase()))
+    }
+  } catch {
+    return false
+  }
+}
+
+module.exports = { isRunning }
diff --git a/plugins/link-relay/public/preload/core/status-enum.js b/plugins/link-relay/public/preload/core/status-enum.js
new file mode 100644
index 000000000..9b97025c0
--- /dev/null
+++ b/plugins/link-relay/public/preload/core/status-enum.js
@@ -0,0 +1,77 @@
+/**
+ * 链接状态枚举与状态语义（后端唯一事实源）。
+ * 前端 src/utils/enums.ts 保持同构；新增状态时两处同步。
+ */
+
+/** 链接状态 */
+const LinkStatus = Object.freeze({
+  LINKED: 'linked',             // 已正确链接
+  NOT_LINKED: 'not-linked',     // 未迁移，源为实体目录
+  BROKEN: 'broken',             // 链接断裂或指向错误
+  CONFLICT: 'conflict',         // 源与目标都有实体目录
+  TARGET_ONLY: 'target-only',   // 源不存在、目标有数据（重装场景）
+  NOT_INSTALLED: 'not-installed', // 源与目标都不存在
+  UNKNOWN: 'unknown',           // 检测失败
+})
+
+/** 行操作类型 */
+const RowActionType = Object.freeze({
+  MIGRATE: 'migrate',
+  RELINK: 'relink',
+  REPAIR: 'repair',
+  NONE: 'none',
+})
+
+/** 状态严重度（数字越大越紧急，组聚合取最严重） */
+const STATUS_SEVERITY = Object.freeze({
+  [LinkStatus.CONFLICT]: 5,
+  [LinkStatus.BROKEN]: 4,
+  [LinkStatus.NOT_LINKED]: 3,
+  [LinkStatus.TARGET_ONLY]: 2,
+  [LinkStatus.LINKED]: 1,
+  [LinkStatus.NOT_INSTALLED]: 0,
+  [LinkStatus.UNKNOWN]: 0,
+})
+
+/** 状态 → 行主操作 */
+const STATUS_ACTION = Object.freeze({
+  [LinkStatus.NOT_LINKED]: { type: RowActionType.MIGRATE, label: '迁移', disabled: false },
+  [LinkStatus.TARGET_ONLY]: { type: RowActionType.RELINK, label: '重建链接', disabled: false },
+  [LinkStatus.BROKEN]: { type: RowActionType.REPAIR, label: '修复', disabled: false },
+  [LinkStatus.CONFLICT]: { type: RowActionType.REPAIR, label: '修复', disabled: false },
+  [LinkStatus.LINKED]: { type: RowActionType.NONE, label: '已迁移', disabled: true },
+  [LinkStatus.NOT_INSTALLED]: { type: RowActionType.NONE, label: '—', disabled: true },
+  [LinkStatus.UNKNOWN]: { type: RowActionType.NONE, label: '—', disabled: true },
+})
+
+function rowAction(status) {
+  return STATUS_ACTION[status] || STATUS_ACTION[LinkStatus.UNKNOWN]
+}
+
+function aggregateStatus(statuses) {
+  return statuses.reduce(
+    (acc, s) => ((STATUS_SEVERITY[s] ?? 0) > (STATUS_SEVERITY[acc] ?? 0) ? s : acc),
+    LinkStatus.UNKNOWN
+  )
+}
+
+/** 是否为待处理（需要迁移/重建） */
+function isPending(status) {
+  return status === LinkStatus.NOT_LINKED || status === LinkStatus.TARGET_ONLY
+}
+
+/** 是否为异常（冲突/断裂） */
+function isAbnormal(status) {
+  return status === LinkStatus.CONFLICT || status === LinkStatus.BROKEN
+}
+
+module.exports = {
+  LinkStatus,
+  RowActionType,
+  STATUS_SEVERITY,
+  STATUS_ACTION,
+  rowAction,
+  aggregateStatus,
+  isPending,
+  isAbnormal,
+}
diff --git a/plugins/link-relay/public/preload/package.json b/plugins/link-relay/public/preload/package.json
new file mode 100644
index 000000000..5bbefffba
--- /dev/null
+++ b/plugins/link-relay/public/preload/package.json
@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}
diff --git a/plugins/link-relay/public/preload/services.js b/plugins/link-relay/public/preload/services.js
new file mode 100644
index 000000000..61dbdbeea
--- /dev/null
+++ b/plugins/link-relay/public/preload/services.js
@@ -0,0 +1,85 @@
+/**
+ * 目录迁移助手 —— preload 服务入口（Node 能力桥）。
+ *
+ * 新架构职责边界：
+ * - 数据（分组 / 映射 / 日志）全部由前端三张 pinia 表持有并持久化，preload 不再保存任何配置，
+ *   因此这里没有 config-store / preset-library / entry-resolver，也没有仪表盘缓存；
+ * - 本文件只把前端传入的「迁移项」原样转交给执行层，是无状态的能力提供者：
+ *   link-manager（状态检测）/ migration-engine（迁移执行）/ process-checker（进程检测）/ path-util（路径展开）。
+ *
+ * 迁移项形态由前端 api/migrate.toEngineItem 组装：
+ *   { id, enabled, groupDisplayName, label, exeNames, cachePatterns,
+ *     dir: { path, target, status(kebab), size } }
+ */
+
+const linkManager = require('./core/link-manager')
+const processChecker = require('./core/process-checker')
+const migrationEngine = require('./core/migration-engine')
+const { expandEnv } = require('./core/path-util')
+
+// 让出一帧，避免在 IPC 同步回调里阻塞渲染
+function nextTick() {
+  return new Promise((resolve) => setImmediate(resolve))
+}
+
+window.services = {
+  // === 目录 / 链接 / 进程（无状态能力） ===
+
+  checkDirStatus(source, target) {
+    return linkManager.checkDirStatus(source, target)
+  },
+
+  expandEnv(p) {
+    return expandEnv(p)
+  },
+
+  getDiskFreeSpace(dirPath) {
+    return migrationEngine.getDiskFreeSpace(dirPath)
+  },
+
+  formatSize(bytes) {
+    return migrationEngine.formatSize(bytes)
+  },
+
+  isProcessRunning(exeNames) {
+    return processChecker.isAnyRunning(exeNames || [])
+  },
+
+  // === 迁移流程（items 由前端组装传入） ===
+
+  dryRun(items, options = {}) {
+    return migrationEngine.dryRun(items || [], options)
+  },
+
+  async migrate(items, options = {}) {
+    await nextTick()
+    return migrationEngine.migrate(items || [], options)
+  },
+
+  /** 单行重建链接：引擎依据 item.dir.status 自行判定为 relink */
+  async relink(item) {
+    await nextTick()
+    if (!item) throw new Error('relink 缺少迁移项')
+    const results = await migrationEngine.migrate([item], { itemIds: [item.id] })
+    return results[0]
+  },
+
+  /** 单行修复：broken 直接重建；conflict 使用传入或默认的冲突策略 */
+  async repair(item, strategy) {
+    await nextTick()
+    if (!item) throw new Error('repair 缺少迁移项')
+    const results = await migrationEngine.migrate([item], {
+      itemIds: [item.id],
+      conflictStrategy: strategy || 'prefer-source',
+    })
+    return results[0]
+  },
+
+  abortMigration() {
+    migrationEngine.abortMigration()
+  },
+
+  onProgress(cb) {
+    return migrationEngine.onProgress(cb)
+  },
+}
diff --git a/plugins/link-relay/src/App.vue b/plugins/link-relay/src/App.vue
new file mode 100644
index 000000000..0debc85f3
--- /dev/null
+++ b/plugins/link-relay/src/App.vue
@@ -0,0 +1,23 @@
+<script setup lang="ts">
+/** 应用根组件：只负责挂载唯一页面 Home，不写任何界面业务。 */
+import Home from './views/Home.vue';
+</script>
+
+<template>
+  <Home />
+</template>
+
+<style>
+/* ── 应用根挂载点容器初始化（全局，非 scoped） ── */
+#app {
+  width: 100%;
+  min-height: 100vh;
+  background: var(--page);
+  color: var(--ink-2);
+  font-family: var(--font-sans);
+  font-size: var(--fs-base);
+  line-height: 1.55;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+</style>
diff --git a/plugins/link-relay/src/api/db.ts b/plugins/link-relay/src/api/db.ts
new file mode 100644
index 000000000..77508b57a
--- /dev/null
+++ b/plugins/link-relay/src/api/db.ts
@@ -0,0 +1,142 @@
+/**
+ * 持久化底座 —— 封装宿主 ztools.db（每个插件独立文档库）。
+ *
+ * 文档 _id 约定：'{collection}:{业务主键}'，用 allDocs(prefix) 即按表取数，三张表天然隔离。
+ * 全部方法异步：优先走 db.promises，避免同步 IO 阻塞 UI。
+ * 无宿主（pnpm dev 跑在浏览器）时退化为内存 Map：纯内存、零磁盘 IO，不触碰任何真实目录。
+ */
+
+/** 宿主文档的元字段（业务侧不需要，取出后剥离） */
+interface DocMeta {
+  _id: string;
+  _rev?: string;
+}
+
+/** 宿主文档：元字段 + 业务字段 */
+type Doc = DocMeta & Record<string, unknown>;
+
+/** dev 内存兜底库，key = 完整文档 id */
+const memory = new Map<string, Record<string, unknown>>();
+
+/** 取宿主文档库，无宿主返回 null */
+function hostDb() {
+  return typeof ztools !== 'undefined' && ztools.db ? ztools.db : null;
+}
+
+/** 拼文档 id */
+export function docKey(collection: string, id: string): string {
+  return `${collection}:${id}`;
+}
+
+/** 深拷贝，避免内存兜底库与 store state 共享引用 */
+function clone<T>(value: T): T {
+  return JSON.parse(JSON.stringify(value)) as T;
+}
+
+/** 剥离 _id/_rev，还原业务实体 */
+function toEntity<T>(doc: Doc): T {
+  const entity: Record<string, unknown> = { ...doc };
+  delete entity._id;
+  delete entity._rev;
+  return entity as T;
+}
+
+/** R：列出集合内全部实体 */
+export async function listCollection<T>(collection: string): Promise<T[]> {
+  const db = hostDb();
+  const prefix = `${collection}:`;
+  if (!db) {
+    return [...memory.entries()].filter(([key]) => key.startsWith(prefix)).map(([, doc]) => clone(doc) as T);
+  }
+  const docs = (await db.promises.allDocs(prefix)) as Doc[];
+  return docs.map((doc) => toEntity<T>(doc));
+}
+
+/** R：按主键取单个实体 */
+export async function getDoc<T>(collection: string, id: string): Promise<T | null> {
+  const db = hostDb();
+  const key = docKey(collection, id);
+  if (!db) {
+    const hit = memory.get(key);
+    return hit ? (clone(hit) as T) : null;
+  }
+  const doc = (await db.promises.get(key)) as Doc | null;
+  return doc ? toEntity<T>(doc) : null;
+}
+
+/** R：同步按主键取实体（store 水合用，换取首帧不出现空表） */
+export function getDocSync<T>(collection: string, id: string): T | null {
+  const db = hostDb();
+  const key = docKey(collection, id);
+  if (!db) {
+    const hit = memory.get(key);
+    return hit ? (clone(hit) as T) : null;
+  }
+  try {
+    const doc = db.get<Record<string, unknown>>(key) as Doc | null;
+    return doc ? toEntity<T>(doc) : null;
+  } catch {
+    // 宿主库异常时降级为空数据，不阻塞 store 创建
+    return null;
+  }
+}
+
+/** C/U：写入实体（已存在则带 _rev 更新） */
+export async function putDoc<T>(collection: string, id: string, entity: T): Promise<void> {
+  const db = hostDb();
+  const key = docKey(collection, id);
+  if (!db) {
+    memory.set(key, clone(entity) as Record<string, unknown>);
+    return;
+  }
+  const existing = (await db.promises.get(key)) as Doc | null;
+  const payload = { ...(entity as Record<string, unknown>) };
+  await db.promises.put(existing?._rev ? { _id: key, _rev: existing._rev, ...payload } : { _id: key, ...payload });
+}
+
+/** C/U：同步写入（退出兜底用：进程被杀时异步写入可能来不及落地） */
+export function putDocSync<T>(collection: string, id: string, entity: T): void {
+  const db = hostDb();
+  const key = docKey(collection, id);
+  if (!db) {
+    memory.set(key, clone(entity) as Record<string, unknown>);
+    return;
+  }
+  try {
+    const existing = db.get(key) as Doc | null;
+    const payload = { ...(entity as Record<string, unknown>) };
+    db.put(existing?._rev ? { _id: key, _rev: existing._rev, ...payload } : { _id: key, ...payload });
+  } catch {
+    // 退出路径上不抛出，避免中断宿主流程
+  }
+}
+
+/** D：删除单个实体 */
+export async function removeDoc(collection: string, id: string): Promise<void> {
+  const db = hostDb();
+  const key = docKey(collection, id);
+  if (!db) {
+    memory.delete(key);
+    return;
+  }
+  await db.promises.remove(key);
+}
+
+/** D：清空整个集合 */
+export async function clearCollection(collection: string): Promise<void> {
+  const db = hostDb();
+  const prefix = `${collection}:`;
+  if (!db) {
+    for (const key of [...memory.keys()]) {
+      if (key.startsWith(prefix)) memory.delete(key);
+    }
+    return;
+  }
+  const docs = (await db.promises.allDocs(prefix)) as Doc[];
+  await Promise.all(docs.map((doc) => db.promises.remove(doc)));
+}
+
+/** 当前是否落在宿主文档库（false 表示 dev 内存态，重启即丢） */
+export function isPersisted(): boolean {
+  return hostDb() !== null;
+}
diff --git a/plugins/link-relay/src/api/dev.ts b/plugins/link-relay/src/api/dev.ts
new file mode 100644
index 000000000..06918c6ae
--- /dev/null
+++ b/plugins/link-relay/src/api/dev.ts
@@ -0,0 +1,93 @@
+/**
+ * DEV 内存虚拟世界 —— 仅在「无宿主（pnpm dev 跑浏览器）」时使用。
+ *
+ * 约束（硬要求）：
+ * - 纯内存、零磁盘 IO，绝不读取/修改真实 IDE（.vscode / AppData 等）目录；
+ * - 界面与日志中出现的路径全部落在 RelocatorTest 虚拟根下；
+ * - 仅用于开发态跑通「扫描 → 预览 → 迁移 → 状态翻转」闭环，生产构建中这些数据不会被触达。
+ */
+import type { MappingCreateDTO } from '../store/types/mapping';
+import type { NativeDirStatus, NativeLinkStatus } from './dir';
+
+/** 虚拟测试根：源在 C 盘、目标在 D 盘，与真实用户目录完全隔离 */
+export const DEV_SOURCE_ROOT = 'C:\\RelocatorTest\\source';
+export const DEV_TARGET_ROOT = 'D:\\RelocatorTest\\target';
+
+/** 一条样例记录（同时驱动：首帧种子数据 + 虚拟状态检测） */
+interface DevRecord {
+  /** 所属样例分组名（空串表示未分组） */
+  group: string;
+  /** 行显示名 */
+  name: string;
+  /** 目录叶子名（拼出虚拟源/目标路径） */
+  leaf: string;
+  /** 初始链接状态（kebab，与 preload 同形） */
+  status: NativeLinkStatus;
+  /** 源体积（字节），linked 为 0 */
+  size: number;
+  /** 关联进程名（可空） */
+  exeNames?: string[];
+}
+
+/** 固定样例：覆盖全部主要状态，便于开发态看到不同 UI 分支 */
+const RECORDS: DevRecord[] = [
+  { group: '开发工具 A', name: '扩展目录', leaf: 'tool-a/home', status: 'not-linked', size: 361_000_000, exeNames: ['Code.exe'] },
+  { group: '开发工具 A', name: '配置目录', leaf: 'tool-a/roaming', status: 'conflict', size: 198_000_000, exeNames: ['Code.exe'] },
+  { group: '开发工具 B', name: '扩展目录', leaf: 'tool-b/home', status: 'linked', size: 0 },
+  { group: '开发工具 B', name: '配置目录', leaf: 'tool-b/roaming', status: 'target-only', size: 74_000_000 },
+  { group: '', name: 'npm 缓存', leaf: 'npm-cache', status: 'not-linked', size: 200_000_000 },
+  { group: '', name: 'Maven 仓库', leaf: 'm2', status: 'broken', size: 150_000_000 },
+];
+
+/** 迁移后被改写为 linked 的状态覆盖表，key = 源路径 */
+const overrides = new Map<string, NativeLinkStatus>();
+
+function sourceOf(leaf: string): string {
+  return `${DEV_SOURCE_ROOT}\\${leaf.replace(/\//g, '\\')}`;
+}
+function targetOf(leaf: string): string {
+  return `${DEV_TARGET_ROOT}\\${leaf.replace(/\//g, '\\')}`;
+}
+
+function findBySource(source: string): DevRecord | undefined {
+  return RECORDS.find((r) => sourceOf(r.leaf) === source);
+}
+
+/** 虚拟状态检测：按源路径查样例表，叠加迁移后的 linked 覆盖 */
+export function devDirStatus(source: string, target: string): NativeDirStatus {
+  const record = findBySource(source);
+  const status = overrides.get(source) ?? record?.status ?? 'not-linked';
+  const size = status === 'linked' ? 0 : (record?.size ?? 12_000_000);
+  return {
+    path: source,
+    target,
+    status,
+    size,
+    ...(status === 'linked' ? { realTarget: target } : {}),
+  };
+}
+
+/** dev 模拟迁移成功后把该源标记为已链接 */
+export function devMarkLinked(source: string): void {
+  overrides.set(source, 'linked');
+}
+
+/** 样例分组名（去重、保序，空串代表的未分组不建组） */
+export function devSeedGroupNames(): string[] {
+  return [...new Set(RECORDS.map((r) => r.group).filter(Boolean))];
+}
+
+/**
+ * 样例映射行 DTO；groupNameToId 把样例分组名映射为建组后生成的 uuid，未分组传 ''。
+ * 状态/体积不在 DTO 中，由首次 refresh 经 devDirStatus 检测后写回，模拟真实扫描。
+ */
+export function devSeedMappings(groupNameToId: (name: string) => string): MappingCreateDTO[] {
+  return RECORDS.map((r) => ({
+    name: r.name,
+    groupId: r.group ? groupNameToId(r.group) : '',
+    sourcePath: sourceOf(r.leaf),
+    targetPath: targetOf(r.leaf),
+    exeNames: r.exeNames ?? [],
+    cachePatterns: [],
+  }));
+}
diff --git a/plugins/link-relay/src/api/dir.ts b/plugins/link-relay/src/api/dir.ts
new file mode 100644
index 000000000..eaedbbe5d
--- /dev/null
+++ b/plugins/link-relay/src/api/dir.ts
@@ -0,0 +1,106 @@
+/**
+ * 目录 / 链接 / 进程能力 —— 需要 Node 侧（preload）支撑的能力集中在此。
+ *
+ * 宿主内：读取 preload 注入的 window.services，并把返回字段与状态值归一化到 store 模型
+ * （preload 用 kebab-case 状态，store 用 camelCase，映射在本文件收敛）；
+ * dev 无宿主：全部退化为内存虚拟实现（api/dev），零磁盘 IO，不触碰任何真实 IDE 目录。
+ * 目录选择走宿主对话框，不依赖 preload。
+ */
+import type { LinkStatus } from '../store/types/mapping';
+import { devDirStatus } from './dev';
+
+/** preload 侧（kebab-case）链接状态，与 preload/core/status-enum.js 同构 */
+export type NativeLinkStatus =
+  | 'linked'
+  | 'not-linked'
+  | 'broken'
+  | 'conflict'
+  | 'target-only'
+  | 'not-installed'
+  | 'unknown';
+
+/** preload checkDirStatus 的原始返回 */
+export interface NativeDirStatus {
+  path: string;
+  target: string;
+  status: NativeLinkStatus;
+  size: number;
+  realTarget?: string;
+}
+
+/** 目录链接状态检测结果（已归一化到 store 模型） */
+export interface DirStatus {
+  /** 链接状态 */
+  status: LinkStatus;
+  /** 源目录体积（字节），已链接为 0 */
+  sizeBytes: number;
+  /** 链接真实指向，非链接为空串 */
+  realTarget: string;
+}
+
+/** preload 的 kebab-case 状态 → store 的 camelCase 状态 */
+const STATUS_MAP: Record<NativeLinkStatus, LinkStatus> = {
+  linked: 'linked',
+  'not-linked': 'notLinked',
+  broken: 'broken',
+  conflict: 'conflict',
+  'target-only': 'targetOnly',
+  'not-installed': 'notInstalled',
+  unknown: 'unknown',
+};
+
+/** dev 兜底的假可用空间（仅用于开发态不报错，不代表真实磁盘） */
+const DEV_FREE_SPACE = 100_000_000_000;
+
+/** 取 preload 注入的 Node 能力，无宿主返回 null */
+function native() {
+  return typeof window !== 'undefined' && window.services ? window.services : null;
+}
+
+/** 展开路径中的 %ENV% 与 ~（无宿主原样返回） */
+export function expandPath(path: string): string {
+  if (!path) return '';
+  return native()?.expandEnv(path) ?? path;
+}
+
+/** 目标盘可用空间（字节） */
+export function freeSpace(path: string): number {
+  if (!path) return 0;
+  return native()?.getDiskFreeSpace(path) ?? DEV_FREE_SPACE;
+}
+
+/** 检测「源 → 目标」的链接状态与体积 */
+export function checkLink(source: string, target: string): DirStatus {
+  const services = native();
+  if (!services) {
+    const virtual = devDirStatus(source, target);
+    return {
+      status: STATUS_MAP[virtual.status] ?? 'unknown',
+      sizeBytes: virtual.size,
+      realTarget: virtual.realTarget ?? '',
+    };
+  }
+  const info = services.checkDirStatus(source, target);
+  return {
+    status: STATUS_MAP[info.status] ?? 'unknown',
+    sizeBytes: info.size || 0,
+    realTarget: info.realTarget ?? '',
+  };
+}
+
+/** 关联进程是否运行中（迁移前置检查用，运行中应拒绝执行） */
+export function isProcessRunning(exeNames: string[]): boolean {
+  if (exeNames.length === 0) return false;
+  return native()?.isProcessRunning(exeNames) ?? false;
+}
+
+/** 选择目录：宿主对话框，取消或无宿主返回空串 */
+export function pickDirectory(title = '选择目录', defaultPath = ''): string {
+  if (typeof ztools === 'undefined') return '';
+  const picked = ztools.showOpenDialog({
+    title,
+    defaultPath,
+    properties: ['openDirectory', 'createDirectory'],
+  });
+  return picked?.[0] ?? '';
+}
diff --git a/plugins/link-relay/src/api/env.ts b/plugins/link-relay/src/api/env.ts
new file mode 100644
index 000000000..acd138cb0
--- /dev/null
+++ b/plugins/link-relay/src/api/env.ts
@@ -0,0 +1,80 @@
+/**
+ * 宿主环境与 UI 交互能力 —— 封装 ztools 基础 API（平台 / 主题 / 通知 / 窗口 / 系统路径 / Shell）。
+ * 无宿主（pnpm dev 浏览器）时全部退化为安全默认值，保证开发态可直接跑通。
+ */
+
+/** 运行平台 */
+export type Platform = 'win32' | 'darwin' | 'linux' | 'unknown';
+
+/** 可读取的系统路径名（宿主 getPath 支持的常用子集） */
+export type SystemPathName = 'home' | 'appData' | 'userData' | 'cache' | 'temp' | 'desktop' | 'documents' | 'downloads' | 'logs';
+
+/** 取宿主对象，无宿主返回 null */
+function host() {
+  return typeof ztools !== 'undefined' ? ztools : null;
+}
+
+/** 是否运行在 ZTools 宿主内 */
+export function isHost(): boolean {
+  return host() !== null;
+}
+
+/** 是否开发模式（vite dev 或宿主 isDev） */
+export function isDev(): boolean {
+  return import.meta.env.DEV || (host()?.isDev() ?? false);
+}
+
+/** 当前平台（决定 junction / symlink 等链接策略） */
+export function platform(): Platform {
+  const api = host();
+  if (!api) return 'unknown';
+  if (api.isWindows()) return 'win32';
+  if (api.isMacOS()) return 'darwin';
+  if (api.isLinux()) return 'linux';
+  return 'unknown';
+}
+
+/** 是否深色主题 */
+export function isDark(): boolean {
+  return host()?.isDarkColors() ?? false;
+}
+
+/** 宿主版本号 */
+export function appVersion(): string {
+  return host()?.getAppVersion() ?? '';
+}
+
+/** 读取系统路径（home / appData / userData / cache / temp / desktop…），无宿主返回空串 */
+export function systemPath(name: SystemPathName): string {
+  return host()?.getPath(name) ?? '';
+}
+
+/** 系统通知 */
+export function notify(message: string): void {
+  host()?.showNotification(message);
+}
+
+/** 设置插件视图高度（首页高度自适应用） */
+export function setViewHeight(height: number): void {
+  host()?.setExpendHeight(height);
+}
+
+/** 插件进入事件：首屏取数的触发点 */
+export function onEnter(callback: (code: string) => void): void {
+  host()?.onPluginEnter((action) => callback(action.code));
+}
+
+/** 插件退出事件（isKill=true 为杀进程）：退出前 flush 待写快照的触发点 */
+export function onOut(callback: (isKill: boolean) => void): void {
+  host()?.onPluginOut(callback);
+}
+
+/** 用系统默认程序打开目录或文件 */
+export function openPath(fullPath: string): void {
+  if (fullPath) host()?.shellOpenPath(fullPath);
+}
+
+/** 在文件管理器中定位目录或文件 */
+export function showInFolder(fullPath: string): void {
+  if (fullPath) host()?.shellShowItemInFolder(fullPath);
+}
diff --git a/plugins/link-relay/src/api/index.ts b/plugins/link-relay/src/api/index.ts
new file mode 100644
index 000000000..94b769b8b
--- /dev/null
+++ b/plugins/link-relay/src/api/index.ts
@@ -0,0 +1,13 @@
+/**
+ * api 层出口 —— 按作用/功能分模块封装，命名空间导出避免同名冲突。
+ *
+ * envApi     宿主环境与 UI 交互（平台 / 主题 / 通知 / 窗口高度 / 系统路径 / Shell / 插件进入）
+ * dbApi      持久化底座（宿主文档库 collection 读写，dev 内存兜底）；
+ *            三张表的落库由 store/plugins/ztoolsPersist 插件以快照方式自动完成，不再各表一套 CRUD
+ * dirApi     目录 / 链接 / 进程能力（preload Node 桥接 + 宿主目录选择对话框）
+ * migrateApi 迁移引擎能力（dry-run / 迁移 / 重建 / 修复 / 进度，preload Node 桥接 + dev 模拟）
+ */
+export * as envApi from './env';
+export * as dbApi from './db';
+export * as dirApi from './dir';
+export * as migrateApi from './migrate';
diff --git a/plugins/link-relay/src/api/migrate.ts b/plugins/link-relay/src/api/migrate.ts
new file mode 100644
index 000000000..d03c83c65
--- /dev/null
+++ b/plugins/link-relay/src/api/migrate.ts
@@ -0,0 +1,283 @@
+/**
+ * 迁移能力 —— 对接 preload 迁移引擎（window.services）的唯一出口。
+ *
+ * - 契约类型（计划 / 结果 / 进度）集中在本文件，引擎只认 kebab-case 状态与 EngineItem；
+ * - toEngineItem 负责把 store 的 camelCase MappingVO 归一化为引擎入参（api 是唯一状态翻译边界）；
+ * - dev 无宿主时走纯内存模拟（api/dev），推进虚拟状态、不触盘。
+ */
+import type { LinkStatus, MappingVO } from '../store/types/mapping';
+import { devMarkLinked } from './dev';
+import { expandPath, type NativeLinkStatus } from './dir';
+import { formatBytes } from '../utils/format';
+
+// ────────────── 契约类型 ──────────────
+
+/** 冲突策略（UI 仅提供两种） */
+export type ConflictStrategy = 'prefer-source' | 'prefer-target';
+
+/** 引擎单步动作 */
+export type EngineAction = 'migrate' | 'skip' | 'relink' | 'repair';
+
+/** 引擎可迁移项（preload migration-engine 的入参形态，状态为 kebab） */
+export interface EngineItem {
+  id: string;
+  enabled: boolean;
+  groupDisplayName: string;
+  label: string;
+  exeNames: string[];
+  cachePatterns: string[];
+  dir: { path: string; target: string; status: NativeLinkStatus; size: number };
+}
+
+/** 单步操作计划 */
+export interface OperationPlan {
+  itemId: string;
+  groupDisplayName: string;
+  dirLabel: string;
+  action: EngineAction;
+  source: string;
+  target: string;
+  size: number;
+  reason: string;
+}
+
+/** dry-run 预览结果 */
+export interface PreviewResult {
+  operations: OperationPlan[];
+  totalSize: number;
+  totalSizeFormatted: string;
+  targetFree: number;
+  targetFreeFormatted: string;
+  conflicts: Array<{ itemId: string; groupDisplayName: string; dirLabel: string; source: string; target: string }>;
+  hasConflicts: boolean;
+}
+
+/** 迁移选项 */
+export interface MigrationOptions {
+  /** 限定迁移的行 id；不传则迁移全部启用且可迁移的行 */
+  itemIds?: string[];
+  excludeCache?: boolean;
+  keepBackup?: boolean;
+  conflictStrategy?: ConflictStrategy;
+}
+
+/** 单步迁移结果 */
+export interface MigrationResult {
+  success: boolean;
+  itemId: string;
+  action: string;
+  error?: string;
+  filesCopied?: number;
+  bytesCopied?: number;
+  backupPath?: string | null;
+  rolledBack?: boolean;
+}
+
+/** 进度事件（引擎以 (type, data) 两参推送） */
+export type ProgressEvent =
+  | { type: 'phase'; phase: string; itemId: string; groupDisplayName: string; dirLabel: string; message: string }
+  | { type: 'progress'; filesCopied: number; bytesCopied: number; currentFile: string; itemId: string; groupDisplayName: string; dirLabel: string }
+  | { type: 'log'; level: 'info' | 'ok' | 'warn' | 'error'; message: string }
+  | { type: 'item-done'; itemId: string; success: boolean }
+  | { type: 'done'; results: MigrationResult[] };
+
+export type ProgressCallback = (type: ProgressEvent['type'], data: unknown) => void;
+
+/** preload 暴露的迁移类原生方法集合（供 env.d.ts 组合 ServicesApi） */
+export interface NativeMigrateApi {
+  dryRun(items: EngineItem[], options?: MigrationOptions): PreviewResult;
+  migrate(items: EngineItem[], options?: MigrationOptions): Promise<MigrationResult[]>;
+  relink(item: EngineItem): Promise<MigrationResult>;
+  repair(item: EngineItem, strategy?: ConflictStrategy): Promise<MigrationResult>;
+  abortMigration(): void;
+  onProgress(cb: ProgressCallback): () => void;
+}
+
+// ────────────── store 行 → 引擎项（camel → kebab） ──────────────
+
+const TO_NATIVE: Record<LinkStatus, NativeLinkStatus> = {
+  linked: 'linked',
+  notLinked: 'not-linked',
+  broken: 'broken',
+  conflict: 'conflict',
+  targetOnly: 'target-only',
+  notInstalled: 'not-installed',
+  unknown: 'unknown',
+};
+
+/** 单行配置 + 组名 → 引擎项 */
+export function toEngineItem(row: MappingVO, groupName: string): EngineItem {
+  return {
+    id: row.id,
+    enabled: row.enabled,
+    groupDisplayName: groupName,
+    label: row.name,
+    exeNames: row.exeNames,
+    cachePatterns: row.cachePatterns,
+    dir: {
+      path: expandPath(row.sourcePath),
+      target: row.targetPath,
+      status: TO_NATIVE[row.status],
+      size: row.sizeBytes,
+    },
+  };
+}
+
+// ────────────── 宿主 / dev 分流 ──────────────
+
+function native(): NativeMigrateApi | null {
+  return typeof window !== 'undefined' && window.services ? window.services : null;
+}
+
+const delay = (ms: number): Promise<void> => new Promise((resolve) => setTimeout(resolve, ms));
+
+// ── dev 内存模拟（与 preload migration-engine.dryRun 同形，零磁盘 IO） ──
+
+const devListeners = new Set<ProgressCallback>();
+function devEmit(type: ProgressEvent['type'], data: unknown): void {
+  devListeners.forEach((fn) => {
+    try {
+      fn(type, data);
+    } catch {
+      /* 监听器异常不影响流程 */
+    }
+  });
+}
+
+function devDryRun(items: EngineItem[], options: MigrationOptions = {}): PreviewResult {
+  const scoped = options.itemIds?.length
+    ? items.filter((i) => options.itemIds!.includes(i.id))
+    : items.filter((i) => i.enabled);
+
+  const operations: OperationPlan[] = [];
+  const conflicts: PreviewResult['conflicts'] = [];
+  let totalSize = 0;
+
+  for (const item of scoped) {
+    const { dir } = item;
+    let action: EngineAction = 'skip';
+    let reason = '状态未知，跳过';
+    switch (dir.status) {
+      case 'linked':
+        reason = '已正确链接，无需操作';
+        break;
+      case 'not-linked':
+        action = 'migrate';
+        reason = '实体目录，需迁移并创建链接';
+        totalSize += dir.size;
+        break;
+      case 'target-only':
+        action = 'relink';
+        reason = '源不存在，目标有数据，直接创建链接';
+        break;
+      case 'broken':
+        action = 'repair';
+        reason = '链接断裂，需修复重建';
+        break;
+      case 'conflict':
+        action = 'migrate';
+        reason = `冲突：以${options.conflictStrategy === 'prefer-target' ? '目标盘' : '源盘'}数据为准，另一侧移入备份`;
+        totalSize += dir.size;
+        conflicts.push({ itemId: item.id, groupDisplayName: item.groupDisplayName, dirLabel: item.label, source: dir.path, target: dir.target });
+        break;
+      default:
+        break;
+    }
+    operations.push({
+      itemId: item.id,
+      groupDisplayName: item.groupDisplayName,
+      dirLabel: item.label,
+      action,
+      source: dir.path,
+      target: dir.target,
+      size: dir.size,
+      reason,
+    });
+  }
+
+  const targetFree = 100_000_000_000;
+  return {
+    operations,
+    totalSize,
+    totalSizeFormatted: formatBytes(totalSize),
+    targetFree,
+    targetFreeFormatted: '~100 GB',
+    conflicts,
+    hasConflicts: conflicts.length > 0,
+  };
+}
+
+async function devMigrate(items: EngineItem[], options: MigrationOptions = {}): Promise<MigrationResult[]> {
+  const plan = devDryRun(items, options);
+  const results: MigrationResult[] = [];
+  for (const op of plan.operations.filter((o) => o.action !== 'skip')) {
+    const item = items.find((i) => i.id === op.itemId);
+    if (!item) continue;
+    devEmit('phase', { phase: 'copy', itemId: op.itemId, groupDisplayName: op.groupDisplayName, dirLabel: op.dirLabel, message: `复制数据到 ${op.target}…` });
+    await delay(180);
+    for (let i = 1; i <= 3; i++) {
+      devEmit('progress', {
+        filesCopied: i * 8,
+        bytesCopied: Math.floor((op.size * i) / 3),
+        currentFile: op.source,
+        itemId: op.itemId,
+        groupDisplayName: op.groupDisplayName,
+        dirLabel: op.dirLabel,
+      });
+      await delay(90);
+    }
+    devMarkLinked(item.dir.path);
+    const result: MigrationResult = { success: true, itemId: op.itemId, action: op.action, filesCopied: 24, bytesCopied: op.size, backupPath: null };
+    results.push(result);
+    devEmit('log', { level: 'ok', message: `[${op.groupDisplayName} - ${op.dirLabel}] 迁移完成` });
+    devEmit('item-done', { itemId: op.itemId, success: true });
+  }
+  devEmit('done', { results });
+  return results;
+}
+
+// ────────────── 对外 API ──────────────
+
+/** dry-run 预览（不触盘） */
+export function dryRun(items: EngineItem[], options?: MigrationOptions): PreviewResult {
+  return native()?.dryRun(items, options) ?? devDryRun(items, options);
+}
+
+/** 执行迁移 */
+export async function migrate(items: EngineItem[], options?: MigrationOptions): Promise<MigrationResult[]> {
+  const host = native();
+  return host ? host.migrate(items, options) : devMigrate(items, options);
+}
+
+/** 单行重建链接 */
+export async function relink(item: EngineItem): Promise<MigrationResult> {
+  const host = native();
+  if (host) return host.relink(item);
+  await delay(240);
+  devMarkLinked(item.dir.path);
+  devEmit('done', { results: [] });
+  return { success: true, itemId: item.id, action: 'relink' };
+}
+
+/** 单行修复 */
+export async function repair(item: EngineItem, strategy?: ConflictStrategy): Promise<MigrationResult> {
+  const host = native();
+  if (host) return host.repair(item, strategy);
+  await delay(240);
+  devMarkLinked(item.dir.path);
+  devEmit('done', { results: [] });
+  return { success: true, itemId: item.id, action: 'repair' };
+}
+
+/** 请求中止 */
+export function abortMigration(): void {
+  native()?.abortMigration();
+}
+
+/** 订阅进度，返回取消订阅函数 */
+export function onProgress(cb: ProgressCallback): () => void {
+  const host = native();
+  if (host) return host.onProgress(cb);
+  devListeners.add(cb);
+  return () => devListeners.delete(cb);
+}
diff --git a/plugins/link-relay/src/assets/config.json b/plugins/link-relay/src/assets/config.json
new file mode 100644
index 000000000..a18512319
--- /dev/null
+++ b/plugins/link-relay/src/assets/config.json
@@ -0,0 +1,42 @@
+{
+  "$comment": "出厂预设模板（只读）。结构与 store 三张表的 CreateDTO 对齐：groups[i] 对应 GroupCreateDTO（name），mappings[i] 对应 MappingCreateDTO（name/sourcePath/targetPath/exeNames/cachePatterns）。key/groupKey 仅用于首启实例化时把映射挂到新建分组（store 中分组 id 由 uuid 生成，故模板不写 id）。sourcePath 支持 %ENV%/~，实例化时由 api/dir.expandPath 展开为绝对路径；targetPath 为迁移目标绝对路径，可按需整体改盘符根目录。仅在宿主内、且 group/mapping 两表均为空的首次启动时实例化一次，之后以 store 持久化数据为准。",
+  "version": 1,
+  "groups": [
+    { "key": "vscode", "name": "Visual Studio Code" },
+    { "key": "qoder", "name": "Qoder IDE" }
+  ],
+  "mappings": [
+    {
+      "groupKey": "vscode",
+      "name": "扩展目录",
+      "sourcePath": "%USERPROFILE%\\.vscode",
+      "targetPath": "D:\\DevTools\\AppData\\Visual Studio Code\\.vscode",
+      "exeNames": ["Code.exe", "Visual Studio Code.exe"],
+      "cachePatterns": ["Cache", "CachedData", "GPUCache", "Code Cache", "log"]
+    },
+    {
+      "groupKey": "vscode",
+      "name": "配置目录",
+      "sourcePath": "%APPDATA%\\Code",
+      "targetPath": "D:\\DevTools\\AppData\\Visual Studio Code\\Code",
+      "exeNames": ["Code.exe", "Visual Studio Code.exe"],
+      "cachePatterns": ["Cache", "CachedData", "GPUCache", "Code Cache", "log"]
+    },
+    {
+      "groupKey": "qoder",
+      "name": "扩展目录",
+      "sourcePath": "%USERPROFILE%\\.qoder",
+      "targetPath": "D:\\DevTools\\AppData\\Qoder IDE\\.qoder",
+      "exeNames": ["Qoder IDE.exe"],
+      "cachePatterns": ["Cache", "GPUCache", "Code Cache", "log"]
+    },
+    {
+      "groupKey": "qoder",
+      "name": "配置目录",
+      "sourcePath": "%APPDATA%\\Qoder",
+      "targetPath": "D:\\DevTools\\AppData\\Qoder IDE\\Qoder",
+      "exeNames": ["Qoder IDE.exe"],
+      "cachePatterns": ["Cache", "GPUCache", "Code Cache", "log"]
+    }
+  ]
+}
diff --git a/plugins/link-relay/src/components/GroupDialog.vue b/plugins/link-relay/src/components/GroupDialog.vue
new file mode 100644
index 000000000..a01175265
--- /dev/null
+++ b/plugins/link-relay/src/components/GroupDialog.vue
@@ -0,0 +1,126 @@
+<script setup lang="ts">
+/**
+ * 分组管理弹窗（取代旧的出厂预设弹窗：新架构无预设库，分组全部由用户自建）。
+ * 纯渲染：分组数据走 props，增删改/启停向父级 emit。
+ */
+import { ref } from 'vue';
+import type { GroupVO } from '../store/types';
+
+defineProps<{ open: boolean; groups: GroupVO[] }>();
+const emit = defineEmits<{
+  close: [];
+  create: [name: string];
+  rename: [id: string, name: string];
+  toggle: [id: string, enabled: boolean];
+  remove: [id: string];
+}>();
+
+const newName = ref('');
+const editingId = ref<string | null>(null);
+const editingName = ref('');
+const error = ref('');
+
+function addGroup(): void {
+  const name = newName.value.trim();
+  if (!name) {
+    error.value = '请输入分组名称';
+    return;
+  }
+  emit('create', name);
+  newName.value = '';
+  error.value = '';
+}
+
+function startRename(group: GroupVO): void {
+  editingId.value = group.id;
+  editingName.value = group.name;
+}
+function commitRename(): void {
+  if (editingId.value && editingName.value.trim()) {
+    emit('rename', editingId.value, editingName.value.trim());
+  }
+  editingId.value = null;
+}
+</script>
+
+<template>
+  <div v-if="open" class="scrim on" @click.self="emit('close')">
+    <div class="modal on">
+      <header>
+        <h3>分组管理</h3>
+        <button class="btn ghost sm close" @click="emit('close')">✕</button>
+      </header>
+
+      <div class="body">
+        <!-- 新建分组 -->
+        <div class="add-row">
+          <input
+            v-model="newName"
+            placeholder="新建分组名称，例如：JetBrains 全家桶"
+            @keydown.enter="addGroup"
+          />
+          <button class="btn primary" @click="addGroup">新建</button>
+        </div>
+        <p v-if="error" class="form-error">{{ error }}</p>
+
+        <!-- 分组列表 -->
+        <ul v-if="groups.length" class="group-list">
+          <li v-for="g in groups" :key="g.id" class="group-item" :class="{ off: !g.enabled }">
+            <template v-if="editingId === g.id">
+              <input v-model="editingName" class="rename-input" @keydown.enter="commitRename" @blur="commitRename" />
+            </template>
+            <template v-else>
+              <span class="g-name" @dblclick="startRename(g)">{{ g.name }}</span>
+              <span v-if="!g.enabled" class="off-tag">已停用</span>
+            </template>
+
+            <span class="g-spacer" />
+            <div class="g-ops">
+              <button class="mini" title="重命名" @click="startRename(g)">✎</button>
+              <button class="mini" @click="emit('toggle', g.id, !g.enabled)">
+                {{ g.enabled ? '停用' : '启用' }}
+              </button>
+              <button class="mini danger" title="删除分组（其映射转入未分组）" @click="emit('remove', g.id)">✕</button>
+            </div>
+          </li>
+        </ul>
+        <p v-else class="empty-tip">还没有分组，可在上方新建；不建组的映射会归入「未分组」。</p>
+      </div>
+
+      <footer>
+        <span class="left">分组仅用于归类，删除分组不会删除其映射</span>
+        <div class="right">
+          <button class="btn primary" @click="emit('close')">完成</button>
+        </div>
+      </footer>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.modal { width: 480px; max-width: calc(100vw - 32px); }
+.add-row { display: flex; gap: 8px; }
+.add-row input { flex: 1; min-width: 0; }
+.form-error { color: var(--bad-ink); font-size: var(--fs-xs); margin-top: 6px; }
+.group-list { margin-top: 14px; display: flex; flex-direction: column; gap: 6px; max-height: 320px; overflow-y: auto; }
+.group-item {
+  display: flex; align-items: center; gap: 8px;
+  padding: 8px 10px; border: 1px solid var(--border); border-radius: var(--r-control);
+  background: var(--panel-2);
+}
+.group-item.off { opacity: 0.55; }
+.g-name { font-size: var(--fs-sm); font-weight: 600; color: var(--ink-1); cursor: text; }
+.off-tag {
+  font-size: 10.5px; padding: 1px 8px; border-radius: var(--r-pill);
+  background: var(--bg); color: var(--ink-3); border: 1px solid var(--border);
+}
+.g-spacer { flex: 1; }
+.g-ops { display: inline-flex; gap: 4px; }
+.mini {
+  min-height: 24px; padding: 2px 9px; font-size: 11px; border-radius: var(--r-control);
+  border: 1px solid var(--border-strong); background: var(--bg); color: var(--ink-2);
+}
+.mini.danger:hover { color: var(--bad-ink); border-color: rgba(192, 69, 60, 0.3); background: var(--bad-soft); }
+.rename-input { flex: 1; min-width: 0; }
+.empty-tip { margin-top: 14px; font-size: var(--fs-xs); color: var(--ink-3); }
+</style>
diff --git a/plugins/link-relay/src/components/MappingDialog.vue b/plugins/link-relay/src/components/MappingDialog.vue
new file mode 100644
index 000000000..cc2640b39
--- /dev/null
+++ b/plugins/link-relay/src/components/MappingDialog.vue
@@ -0,0 +1,158 @@
+<script setup lang="ts">
+/**
+ * 添加 / 编辑映射弹窗。
+ * 表单草稿为组件局部状态；分组选项、编辑回填、提交、目录选择全部走 useDashboard（业务收敛在 hook）。
+ */
+import { reactive, ref, watch } from 'vue';
+import { useDashboard, type MappingDraft } from '../hooks/useDashboard';
+import { UNGROUPED_ID } from '../utils/enums';
+
+const props = defineProps<{ open: boolean }>();
+const emit = defineEmits<{ close: [] }>();
+
+const dashboard = useDashboard();
+
+const form = reactive({
+  name: '',
+  groupId: UNGROUPED_ID,
+  sourcePath: '',
+  targetPath: '',
+  exeNamesText: '',
+  cachePatternsText: '',
+});
+const formError = ref('');
+
+// 打开时回填：编辑用已有行，新增用组标题传入的预选分组
+watch(
+  () => props.open,
+  (open) => {
+    if (!open) return;
+    formError.value = '';
+    const editing = dashboard.editingRow.value;
+    if (editing) {
+      form.name = editing.name;
+      form.groupId = editing.groupId;
+      form.sourcePath = editing.sourcePath;
+      form.targetPath = editing.targetPath;
+      form.exeNamesText = editing.exeNames.join('\n');
+      form.cachePatternsText = editing.cachePatterns.join('\n');
+    } else {
+      form.name = '';
+      form.groupId = dashboard.pendingGroup.value;
+      form.sourcePath = '';
+      form.targetPath = '';
+      form.exeNamesText = '';
+      form.cachePatternsText = '';
+    }
+  }
+);
+
+function pick(field: 'sourcePath' | 'targetPath'): void {
+  const picked = dashboard.browseDirectory(field === 'sourcePath' ? '选择源目录' : '选择目标目录');
+  if (picked) form[field] = picked;
+}
+
+function submit(): void {
+  if (!form.name.trim()) {
+    formError.value = '请填写映射名称';
+    return;
+  }
+  if (!form.sourcePath.trim()) {
+    formError.value = '请选择源目录';
+    return;
+  }
+  if (!form.targetPath.trim()) {
+    formError.value = '请选择目标目录';
+    return;
+  }
+  const draft: MappingDraft = {
+    id: dashboard.editingId.value ?? undefined,
+    ...form,
+  };
+  dashboard.submitMapping(draft);
+  emit('close');
+}
+
+function close(): void {
+  dashboard.closeEditor();
+  emit('close');
+}
+</script>
+
+<template>
+  <div v-if="open" class="scrim on" @click.self="close">
+    <div class="modal on">
+      <header>
+        <h3>{{ dashboard.editingId.value ? '编辑映射' : '添加映射' }}</h3>
+        <button class="btn ghost sm close" @click="close">✕</button>
+      </header>
+
+      <div class="body">
+        <div class="field">
+          <label>映射名称 <span class="req">*</span></label>
+          <input v-model="form.name" placeholder="例如：扩展目录" />
+        </div>
+
+        <div class="field">
+          <label>所属分组</label>
+          <select v-model="form.groupId">
+            <option :value="UNGROUPED_ID">未分组</option>
+            <option v-for="g in dashboard.groups.value" :key="g.id" :value="g.id">{{ g.name }}</option>
+          </select>
+        </div>
+
+        <div class="field">
+          <label>源目录（系统盘，将被迁移） <span class="req">*</span></label>
+          <div class="path-row">
+            <input v-model="form.sourcePath" placeholder="例如 C:\Users\you\.vscode\extensions" spellcheck="false" />
+            <button class="btn ghost" @click="pick('sourcePath')">浏览</button>
+          </div>
+        </div>
+
+        <div class="field">
+          <label>目标目录（其他盘，数据实际存放处） <span class="req">*</span></label>
+          <div class="path-row">
+            <input v-model="form.targetPath" placeholder="例如 D:\Data\vscode\extensions" spellcheck="false" />
+            <button class="btn ghost" @click="pick('targetPath')">浏览</button>
+          </div>
+        </div>
+
+        <div class="field">
+          <label>关联进程（每行一个，迁移前检测，运行中拒绝执行）</label>
+          <textarea v-model="form.exeNamesText" rows="2" placeholder="Code.exe&#10;Cursor.exe" spellcheck="false" />
+        </div>
+
+        <div class="field">
+          <label>缓存排除规则（每行一个 glob，迁移时跳过）</label>
+          <textarea v-model="form.cachePatternsText" rows="2" placeholder="**/Cache/**&#10;**/GPUCache/**" spellcheck="false" />
+        </div>
+
+        <p v-if="formError" class="form-error">{{ formError }}</p>
+      </div>
+
+      <footer>
+        <div class="left">迁移仅移动目录数据并建立链接，不影响程序运行</div>
+        <div class="right">
+          <button class="btn" @click="close">取消</button>
+          <button class="btn primary" @click="submit">保存</button>
+        </div>
+      </footer>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.modal { width: 540px; max-width: calc(100vw - 32px); }
+.field { margin-bottom: 14px; }
+.field label { display: block; font-size: var(--fs-xs); font-weight: 600; color: var(--ink-2); margin-bottom: 5px; }
+.req { color: var(--bad-ink); }
+.path-row { display: flex; gap: 8px; }
+.path-row input { flex: 1; min-width: 0; }
+textarea {
+  width: 100%; resize: vertical; font-family: inherit; font-size: var(--fs-sm);
+  padding: 8px 10px; border: 1px solid var(--border-strong); border-radius: var(--r-control);
+  background: var(--input-bg); color: var(--ink-1); line-height: 1.5;
+}
+textarea:focus { outline: none; border-color: var(--accent); box-shadow: 0 0 0 3px var(--accent-ring); }
+.form-error { color: var(--bad-ink); font-size: var(--fs-xs); margin-top: 4px; }
+</style>
diff --git a/plugins/link-relay/src/components/MappingTable.vue b/plugins/link-relay/src/components/MappingTable.vue
new file mode 100644
index 000000000..28d176e74
--- /dev/null
+++ b/plugins/link-relay/src/components/MappingTable.vue
@@ -0,0 +1,294 @@
+<script setup lang="ts">
+/**
+ * 映射表格（唯一表格组件，纯渲染）：只接收 props 列出数据、向父级 emit 交互。
+ * 组头与行内聚在本文件，不拆子组件；状态文案/色调、字节格式化全部取自 utils。
+ */
+import type { ViewMode } from '../utils/enums';
+import { statusLabel, statusTone } from '../utils/enums';
+import { formatBytes } from '../utils/format';
+import type { GroupVM, MappingRowVM } from '../hooks/useDashboard';
+
+defineProps<{
+  groups: GroupVM[];
+  flatRows: MappingRowVM[];
+  viewMode: ViewMode;
+  collapsed: Set<string>;
+  selected: Set<string>;
+  loading: boolean;
+  error: string | null;
+  allChecked: boolean;
+  indeterminate: boolean;
+}>();
+
+const emit = defineEmits<{
+  select: [id: string, checked: boolean];
+  selectAll: [checked: boolean];
+  toggleGroup: [groupId: string];
+  groupAdd: [groupId: string];
+  rowAction: [row: MappingRowVM];
+  edit: [id: string];
+  remove: [id: string];
+  retry: [];
+}>();
+
+function linkedCount(rows: MappingRowVM[]): number {
+  return rows.filter((r) => r.status === 'linked').length;
+}
+function sizeText(bytes: number): string {
+  return bytes > 0 ? formatBytes(bytes) : '—';
+}
+</script>
+
+<template>
+  <section class="table-wrap">
+    <div class="table-scroll">
+      <table v-if="!loading">
+        <thead>
+          <tr>
+            <th class="col-check">
+              <input
+                type="checkbox"
+                :checked="allChecked"
+                :indeterminate="indeterminate"
+                @change="emit('selectAll', ($event.target as HTMLInputElement).checked)"
+              />
+            </th>
+            <th>映射（源目录 → 目标目录）</th>
+            <th class="col-status">状态</th>
+            <th class="col-size">大小</th>
+            <th class="col-action">操作</th>
+          </tr>
+        </thead>
+        <tbody>
+          <!-- 分组视图 -->
+          <template v-if="viewMode === 'grouped'">
+            <template v-for="g in groups" :key="g.id || 'ungrouped'">
+              <tr class="group-head">
+                <td colspan="5">
+                  <div class="gh">
+                    <button
+                      class="gh-caret"
+                      :class="{ collapsed: collapsed.has(g.id) }"
+                      :title="collapsed.has(g.id) ? '展开' : '折叠'"
+                      @click="emit('toggleGroup', g.id)"
+                    >
+                      <svg width="12" height="12" viewBox="0 0 256 256" fill="currentColor">
+                        <path d="M213.66,101.66l-80,80a8,8,0,0,1-11.32,0l-80-80A8,8,0,0,1,53.66,90.34L128,164.69l74.34-74.35a8,8,0,0,1,11.32,11.32Z" />
+                      </svg>
+                    </button>
+                    <span class="gh-name">{{ g.name }}</span>
+                    <span v-if="!g.enabled" class="gh-origin">已停用</span>
+                    <span class="gh-spacer" />
+                    <span class="gh-count num">{{ linkedCount(g.rows) }}/{{ g.rows.length }} 已链接</span>
+                    <span class="gh-actions">
+                      <button class="btn ghost sm" @click="emit('groupAdd', g.id)">＋ 添加</button>
+                    </span>
+                  </div>
+                </td>
+              </tr>
+
+              <tr
+                v-for="r in (collapsed.has(g.id) ? [] : g.rows)"
+                :key="r.id"
+                class="map-row"
+                :class="{ selected: selected.has(r.id), disabled: !r.enabled }"
+              >
+                <td class="col-check">
+                  <input
+                    type="checkbox"
+                    :checked="selected.has(r.id)"
+                    :disabled="!r.selectable"
+                    @change="emit('select', r.id, ($event.target as HTMLInputElement).checked)"
+                  />
+                </td>
+                <td>
+                  <div class="map-cell">
+                    <div class="map-label"><span>{{ r.name }}</span></div>
+                    <div class="map-path mono" :title="`${r.sourcePath} → ${r.targetPath}`">
+                      <span class="path-src">{{ r.sourcePath }}</span>
+                      <svg class="path-arrow" width="12" height="12" viewBox="0 0 256 256" fill="currentColor">
+                        <path d="M224,128a8,8,0,0,1-8,8H59.31l58.35,58.34a8,8,0,0,1-11.32,11.32l-72-72a8,8,0,0,1,0-11.32l72-72a8,8,0,0,1,11.32,11.32L59.31,120H216A8,8,0,0,1,224,128Z" />
+                      </svg>
+                      <span class="path-dst">{{ r.targetPath }}</span>
+                    </div>
+                  </div>
+                </td>
+                <td><span class="tag" :class="statusTone(r.status)">{{ statusLabel(r.status) }}</span></td>
+                <td class="col-size num">{{ sizeText(r.sizeBytes) }}</td>
+                <td class="col-action">
+                  <button
+                    class="btn sm"
+                    :class="{ primary: !r.action.disabled }"
+                    :disabled="r.action.disabled"
+                    @click="emit('rowAction', r)"
+                  >{{ r.action.label }}</button>
+                  <span class="row-manage">
+                    <button class="mini" title="编辑" @click="emit('edit', r.id)">✎</button>
+                    <button class="mini danger" title="删除（仅删配置，不动磁盘数据）" @click="emit('remove', r.id)">✕</button>
+                  </span>
+                </td>
+              </tr>
+            </template>
+          </template>
+
+          <!-- 平铺视图 -->
+          <template v-else>
+          <tr
+            v-for="r in flatRows"
+            :key="r.id"
+            class="map-row"
+            :class="{ selected: selected.has(r.id), disabled: !r.enabled }"
+          >
+            <td class="col-check">
+              <input
+                type="checkbox"
+                :checked="selected.has(r.id)"
+                :disabled="!r.selectable"
+                @change="emit('select', r.id, ($event.target as HTMLInputElement).checked)"
+              />
+            </td>
+            <td>
+              <div class="map-cell">
+                <div class="map-label">
+                  <span>{{ r.name }}</span>
+                  <span class="flat-group">{{ r.groupName }}</span>
+                </div>
+                <div class="map-path mono" :title="`${r.sourcePath} → ${r.targetPath}`">
+                  <span class="path-src">{{ r.sourcePath }}</span>
+                  <svg class="path-arrow" width="12" height="12" viewBox="0 0 256 256" fill="currentColor">
+                    <path d="M224,128a8,8,0,0,1-8,8H59.31l58.35,58.34a8,8,0,0,1-11.32,11.32l-72-72a8,8,0,0,1,0-11.32l72-72a8,8,0,0,1,11.32,11.32L59.31,120H216A8,8,0,0,1,224,128Z" />
+                  </svg>
+                  <span class="path-dst">{{ r.targetPath }}</span>
+                </div>
+              </div>
+            </td>
+            <td><span class="tag" :class="statusTone(r.status)">{{ statusLabel(r.status) }}</span></td>
+            <td class="col-size num">{{ sizeText(r.sizeBytes) }}</td>
+            <td class="col-action">
+              <button
+                class="btn sm"
+                :class="{ primary: !r.action.disabled }"
+                :disabled="r.action.disabled"
+                @click="emit('rowAction', r)"
+              >{{ r.action.label }}</button>
+              <span class="row-manage">
+                <button class="mini" title="编辑" @click="emit('edit', r.id)">✎</button>
+                <button class="mini danger" title="删除（仅删配置，不动磁盘数据）" @click="emit('remove', r.id)">✕</button>
+              </span>
+            </td>
+          </tr>
+          </template>
+        </tbody>
+      </table>
+
+      <!-- 加载骨架 -->
+      <div v-if="loading" class="state">
+        <div class="skel" style="width: 60%" />
+        <div class="skel" style="width: 90%" />
+        <div class="skel" style="width: 75%" />
+        <div class="skel" style="width: 85%" />
+      </div>
+
+      <!-- 错误态 -->
+      <div v-else-if="error" class="state error-state">
+        <p>{{ error }}</p>
+        <button class="btn sm" @click="emit('retry')">重试</button>
+      </div>
+
+      <!-- 空态 -->
+      <div v-else-if="groups.length === 0 && flatRows.length === 0" class="state empty-state">
+        <svg width="40" height="40" viewBox="0 0 256 256" fill="currentColor" style="color: var(--ink-3); opacity: 0.4">
+          <path d="M216,40H72A16,16,0,0,0,56,56V72H40A16,16,0,0,0,24,88V200a16,16,0,0,0,16,16H184a16,16,0,0,0,16-16V184h16a16,16,0,0,0,16-16V56A16,16,0,0,0,216,40ZM184,88v16H40V88Zm0,112H40V120H184v80Zm32-32H200V88a16,16,0,0,0-16-16H72V56H216Z" />
+        </svg>
+        <p>还没有任何映射</p>
+        <p class="empty-hint">点击上方「添加映射」选择源目录与目标目录，即可迁移任意文件夹</p>
+      </div>
+    </div>
+  </section>
+</template>
+
+<style scoped>
+.table-wrap {
+  background: var(--bg);
+  border: 1px solid var(--border);
+  border-radius: var(--r);
+  overflow: hidden;
+  box-shadow: var(--shadow-card);
+}
+.table-scroll { overflow-x: auto; -webkit-overflow-scrolling: touch; }
+.table-scroll table { min-width: 720px; }
+thead th {
+  text-align: left;
+  font-size: var(--fs-xs);
+  font-weight: 600;
+  color: var(--ink-3);
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  padding: clamp(7px, 1vw, 9px) clamp(10px, 1.6vw, 14px);
+  border-bottom: 1px solid var(--border);
+  background: var(--panel-2);
+  white-space: nowrap;
+}
+.col-check { width: 36px; }
+.col-status { width: 92px; }
+.col-size { text-align: right; width: 84px; }
+.col-action { text-align: right; width: 150px; }
+
+/* 组头 */
+.group-head td {
+  background: linear-gradient(180deg, #f6f9f8, #f1f5f4);
+  padding: clamp(6px, 0.9vw, 7px) clamp(8px, 1.2vw, 10px);
+  border-bottom: 1px solid var(--border);
+}
+.gh { display: flex; align-items: center; gap: 9px; width: 100%; }
+.gh-caret {
+  display: inline-flex; align-items: center; justify-content: center;
+  min-height: 24px; padding: 2px; color: var(--ink-3); transition: transform 0.15s ease;
+}
+.gh-caret.collapsed { transform: rotate(-90deg); }
+.gh-name { font-size: var(--fs-sm); font-weight: 650; color: var(--ink-1); }
+.gh-origin {
+  font-size: 10.5px; padding: 1px 8px; border-radius: var(--r-pill);
+  background: var(--panel-2); color: var(--ink-3); border: 1px solid var(--border);
+}
+.gh-spacer { flex: 1; }
+.gh-count { font-size: var(--fs-xs); color: var(--ink-3); white-space: nowrap; }
+.gh-actions { display: flex; gap: 4px; }
+
+/* 行 */
+.map-row { transition: background 0.12s ease; }
+.map-row:hover { background: var(--panel-2); }
+.map-row.selected { background: var(--accent-soft); }
+.map-row.disabled { opacity: 0.5; }
+.map-row td { padding: clamp(7px, 1vw, 9px) clamp(10px, 1.6vw, 14px); border-bottom: 1px solid var(--border); vertical-align: middle; }
+.col-check { text-align: center; }
+.col-check input { accent-color: var(--accent); width: 15px; height: 15px; cursor: pointer; }
+.col-size { text-align: right; font-weight: 600; color: var(--ink-1); white-space: nowrap; }
+.col-action { text-align: right; white-space: nowrap; }
+.map-cell { display: flex; flex-direction: column; gap: 2px; min-width: 0; }
+.map-label {
+  font-size: var(--fs-sm); font-weight: 600; color: var(--ink-1);
+  display: flex; align-items: center; gap: 7px; flex-wrap: wrap;
+}
+.flat-group {
+  display: inline-flex; font-size: var(--fs-xs); font-weight: 400; color: var(--ink-3);
+  background: var(--panel-2); border-radius: var(--r-pill); padding: 1px 9px;
+}
+.map-path { display: flex; align-items: center; gap: 6px; color: var(--ink-3); font-size: var(--fs-xs); overflow: hidden; }
+.map-path span { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.path-src { color: var(--bad-ink); }
+.path-dst { color: var(--ok-ink); }
+.path-arrow { color: var(--ink-3); flex-shrink: 0; }
+.row-manage { display: inline-flex; gap: 2px; margin-left: 4px; }
+.mini {
+  min-height: 24px; padding: 2px 7px; font-size: 11px; border-radius: var(--r-control);
+  border: 1px solid var(--border-strong); background: var(--bg); color: var(--ink-2);
+}
+.mini.danger:hover { color: var(--bad-ink); border-color: rgba(192, 69, 60, 0.3); background: var(--bad-soft); }
+
+.state { padding: 40px 20px; text-align: center; }
+.empty-state p, .error-state p { color: var(--ink-3); font-size: var(--fs-sm); margin-top: 10px; }
+.empty-hint { font-size: var(--fs-xs) !important; opacity: 0.7; }
+.error-state { color: var(--bad-ink); }
+.error-state .btn { margin-top: 10px; }
+</style>
diff --git a/plugins/link-relay/src/components/MigrateDialog.vue b/plugins/link-relay/src/components/MigrateDialog.vue
new file mode 100644
index 000000000..7837676a4
--- /dev/null
+++ b/plugins/link-relay/src/components/MigrateDialog.vue
@@ -0,0 +1,152 @@
+<script setup lang="ts">
+/**
+ * 迁移预览 / 确认弹窗（纯渲染）：展示 dry-run 计划与目标盘空间，收集执行选项。
+ */
+import { ref, watch } from 'vue';
+import type { ConflictStrategy, MigrationOptions, PreviewResult } from '../api/migrate';
+import { formatBytes } from '../utils/format';
+
+const props = defineProps<{ open: boolean; preview: PreviewResult | null }>();
+const emit = defineEmits<{ close: []; confirm: [options: MigrationOptions] }>();
+
+const excludeCache = ref(true);
+const keepBackup = ref(true);
+const conflictStrategy = ref<ConflictStrategy>('prefer-source');
+
+function actionLabel(action: string): string {
+  switch (action) {
+    case 'migrate': return '迁移';
+    case 'relink': return '重建链接';
+    case 'repair': return '修复';
+    default: return '跳过';
+  }
+}
+
+watch(
+  () => props.open,
+  (open) => {
+    if (open) {
+      excludeCache.value = true;
+      keepBackup.value = true;
+      conflictStrategy.value = 'prefer-source';
+    }
+  }
+);
+
+function confirm(): void {
+  emit('confirm', {
+    excludeCache: excludeCache.value,
+    keepBackup: keepBackup.value,
+    conflictStrategy: conflictStrategy.value,
+  });
+}
+</script>
+
+<template>
+  <div v-if="open && preview" class="scrim on" @click.self="emit('close')">
+    <div class="modal on">
+      <header>
+        <h3>迁移预览</h3>
+        <button class="btn ghost sm close" @click="emit('close')">✕</button>
+      </header>
+
+      <div class="body">
+        <!-- 空间概览 -->
+        <div class="preview-summary">
+          <div class="ps-item">
+            <span class="ps-label">待迁移总大小</span>
+            <span class="ps-value num">{{ preview.totalSizeFormatted }}</span>
+          </div>
+          <div class="ps-item">
+            <span class="ps-label">目标盘可用</span>
+            <span class="ps-value num">{{ preview.targetFreeFormatted }}</span>
+          </div>
+          <div class="ps-item">
+            <span class="ps-label">操作条目</span>
+            <span class="ps-value num">{{ preview.operations.length }}</span>
+          </div>
+        </div>
+
+        <!-- 冲突提示 -->
+        <div v-if="preview.hasConflicts" class="conflict-tip">
+          <p class="ct-title">检测到 {{ preview.conflicts.length }} 处「源与目标都有数据」冲突</p>
+          <label class="ct-option">
+            <input type="radio" value="prefer-source" v-model="conflictStrategy" />
+            <span>以源盘为准（目标盘同名数据移入 .backup 备份，推荐）</span>
+          </label>
+          <label class="ct-option">
+            <input type="radio" value="prefer-target" v-model="conflictStrategy" />
+            <span>以目标盘为准（源盘数据移入 .backup 备份）</span>
+          </label>
+        </div>
+
+        <!-- 操作清单 -->
+        <div class="plan-list">
+          <div v-for="op in preview.operations" :key="op.itemId" class="plan-item" :class="op.action">
+            <div class="pi-head">
+              <span class="pi-group">{{ op.groupDisplayName }} · {{ op.dirLabel }}</span>
+              <span class="pi-action" :class="op.action">{{ actionLabel(op.action) }}</span>
+            </div>
+            <div class="pi-reason">{{ op.reason }}</div>
+            <div class="pi-paths mono">
+              <span>{{ op.source }}</span> → <span>{{ op.target }}</span>
+            </div>
+            <div v-if="op.size > 0" class="pi-size num">{{ formatBytes(op.size) }}</div>
+          </div>
+        </div>
+
+        <!-- 选项 -->
+        <div class="migrate-options">
+          <label class="opt-line">
+            <input type="checkbox" v-model="excludeCache" />
+            <span>排除缓存目录（Cache / GPUCache / Code Cache 等）</span>
+          </label>
+          <label class="opt-line">
+            <input type="checkbox" v-model="keepBackup" />
+            <span>保留原目录备份（验证链接成功后再清理，更安全）</span>
+          </label>
+        </div>
+      </div>
+
+      <footer>
+        <div class="right" style="margin-left:auto; display:flex; gap:8px;">
+        <button class="btn" @click="emit('close')">取消</button>
+        <button class="btn primary" @click="confirm">
+          开始迁移（{{ preview.operations.filter((o) => o.action !== 'skip').length }} 项）
+        </button>
+        </div>
+      </footer>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.modal { width: 600px; max-width: calc(100vw - 32px); max-height: 86vh; display: flex; flex-direction: column; }
+.modal > .body { overflow-y: auto; }
+.preview-summary { display: grid; grid-template-columns: repeat(3, 1fr); gap: 10px; margin-bottom: 14px; }
+.ps-item { background: var(--panel-2); border-radius: var(--r-control); padding: 10px 12px; display: flex; flex-direction: column; gap: 3px; }
+.ps-label { font-size: var(--fs-xs); color: var(--ink-3); }
+.ps-value { font-size: var(--fs-lg); font-weight: 700; color: var(--ink-1); }
+.conflict-tip {
+  border: 1px solid rgba(196, 142, 64, 0.3); background: var(--warn-soft);
+  border-radius: var(--r-control); padding: 10px 12px; margin-bottom: 14px;
+}
+.ct-title { font-size: var(--fs-sm); font-weight: 600; color: var(--warn-ink); margin-bottom: 6px; }
+.ct-option { display: flex; align-items: flex-start; gap: 7px; font-size: var(--fs-xs); padding: 3px 0; cursor: pointer; }
+.plan-list { display: flex; flex-direction: column; gap: 7px; margin-bottom: 14px; max-height: 280px; overflow-y: auto; }
+.plan-item { border: 1px solid var(--border); border-radius: var(--r-control); padding: 8px 11px; background: var(--panel-2); }
+.plan-item.skip { opacity: 0.55; }
+.pi-head { display: flex; align-items: center; justify-content: space-between; gap: 8px; }
+.pi-group { font-size: var(--fs-sm); font-weight: 600; color: var(--ink-1); }
+.pi-action { font-size: 10.5px; font-weight: 700; padding: 1px 9px; border-radius: var(--r-pill); }
+.pi-action.migrate { background: var(--accent-soft); color: var(--accent-ink); }
+.pi-action.relink { background: var(--info-soft); color: var(--info-ink); }
+.pi-action.repair { background: var(--bad-soft); color: var(--bad-ink); }
+.pi-action.skip { background: var(--panel); color: var(--ink-3); }
+.pi-reason { font-size: var(--fs-xs); color: var(--ink-2); margin: 3px 0; }
+.pi-paths { font-size: 11px; color: var(--ink-3); display: flex; gap: 4px; flex-wrap: wrap; }
+.pi-size { font-size: var(--fs-xs); color: var(--ink-2); margin-top: 2px; }
+.migrate-options { display: flex; flex-direction: column; gap: 7px; border-top: 1px solid var(--border); padding-top: 12px; }
+.opt-line { display: flex; align-items: center; gap: 8px; font-size: var(--fs-sm); cursor: pointer; }
+.opt-line input { accent-color: var(--accent); }
+</style>
diff --git a/plugins/link-relay/src/components/ProgressDialog.vue b/plugins/link-relay/src/components/ProgressDialog.vue
new file mode 100644
index 000000000..8c49654bd
--- /dev/null
+++ b/plugins/link-relay/src/components/ProgressDialog.vue
@@ -0,0 +1,97 @@
+<script setup lang="ts">
+/**
+ * 迁移进度弹窗（纯渲染）：进度条、当前阶段、实时日志流，运行中禁止关闭。
+ */
+import { computed } from 'vue';
+import type { PreviewResult } from '../api/migrate';
+import type { ProgressInfo, RunLog } from '../hooks/useMigration';
+import { formatBytes } from '../utils/format';
+
+const props = defineProps<{
+  open: boolean;
+  running: boolean;
+  preview: PreviewResult | null;
+  logs: RunLog[];
+  currentPhase: string;
+  currentItem: string;
+  progressInfo: ProgressInfo;
+}>();
+
+const emit = defineEmits<{ close: []; cancel: [] }>();
+
+const totalOps = computed(() => props.preview?.operations.filter((o) => o.action !== 'skip').length ?? 0);
+const doneOps = computed(() => props.logs.filter((l) => l.level === 'ok').length);
+const percent = computed(() => {
+  if (totalOps.value === 0) return props.running ? 30 : 100;
+  return Math.min(100, Math.round((doneOps.value / totalOps.value) * 100));
+});
+</script>
+
+<template>
+  <div v-if="open" class="scrim on">
+    <div class="modal on progress-modal">
+      <header>
+        <h3>{{ running ? '正在迁移…' : '迁移完成' }}</h3>
+        <button v-if="!running" class="btn ghost sm close" @click="emit('close')">✕</button>
+      </header>
+
+      <div class="body">
+        <!-- 进度条 -->
+        <div class="progress-bar">
+          <div class="pb-fill" :style="{ width: percent + '%' }" :class="{ done: !running }" />
+        </div>
+        <div class="progress-meta">
+          <span class="num">{{ percent }}%</span>
+          <span v-if="currentItem" class="pm-item">{{ currentItem }}</span>
+          <span v-if="progressInfo.filesCopied" class="num">
+            已复制 {{ progressInfo.filesCopied }} 个文件 / {{ formatBytes(progressInfo.bytesCopied) }}
+          </span>
+        </div>
+        <p v-if="running && currentPhase" class="phase">{{ currentPhase }}</p>
+
+        <!-- 日志流 -->
+        <div class="log-box">
+          <div v-for="(line, i) in logs" :key="i" class="log-line" :class="line.level">
+            <span class="log-time num">{{ line.time }}</span>
+            <span class="log-msg">{{ line.message }}</span>
+          </div>
+          <div v-if="logs.length === 0" class="log-empty">准备中…</div>
+        </div>
+      </div>
+
+      <footer>
+        <div class="right" style="margin-left:auto; display:flex; gap:8px;">
+          <button v-if="running" class="btn ghost danger" @click="emit('cancel')">中止迁移</button>
+          <button v-else class="btn primary" @click="emit('close')">完成</button>
+        </div>
+      </footer>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.progress-modal { width: 560px; max-width: calc(100vw - 32px); }
+.progress-bar { height: 8px; border-radius: var(--r-pill); background: var(--panel-2); overflow: hidden; }
+.pb-fill {
+  height: 100%; border-radius: var(--r-pill);
+  background: linear-gradient(90deg, var(--accent), var(--ok-ink));
+  transition: width 0.3s ease;
+}
+.pb-fill.done { background: var(--ok-ink); }
+.progress-meta { display: flex; align-items: center; gap: 12px; margin-top: 8px; font-size: var(--fs-xs); color: var(--ink-2); }
+.pm-item { font-weight: 600; color: var(--ink-1); }
+.phase { font-size: var(--fs-xs); color: var(--ink-3); margin-top: 6px; }
+.log-box {
+  margin-top: 12px; background: #1e2421; border-radius: var(--r-control);
+  padding: 10px 12px; height: 220px; overflow-y: auto;
+  font-family: var(--mono); font-size: 11.5px; line-height: 1.7;
+}
+.log-line { display: flex; gap: 9px; }
+.log-time { color: rgba(255,255,255,0.35); flex-shrink: 0; }
+.log-msg { color: rgba(255,255,255,0.85); word-break: break-all; }
+.log-line.ok .log-msg { color: #7fd6a0; }
+.log-line.warn .log-msg { color: #e8c07a; }
+.log-line.error .log-msg { color: #f08a82; }
+.log-empty { color: rgba(255,255,255,0.4); }
+.btn.danger { color: var(--bad-ink); }
+</style>
diff --git a/plugins/link-relay/src/env.d.ts b/plugins/link-relay/src/env.d.ts
new file mode 100644
index 000000000..47c42c2ed
--- /dev/null
+++ b/plugins/link-relay/src/env.d.ts
@@ -0,0 +1,36 @@
+/// <reference types="vite/client" />
+/// <reference types="@ztools-center/ztools-api-types" />
+import type { NativeDirStatus } from './api/dir';
+import type { NativeMigrateApi } from './api/migrate';
+
+declare module '*.vue' {
+  import type { DefineComponent } from 'vue';
+  const component: DefineComponent<Record<string, never>, Record<string, never>, unknown>;
+  export default component;
+}
+
+/**
+ * window.services —— preload（Node 侧）注入的能力契约。
+ * 前端只允许通过 src/api 层访问，视图/store/hooks 不直接触碰 window.services。
+ * 数据（分组/映射/日志）全部在前端三张 pinia 表中，preload 不再持有配置，故此处只有「无状态能力」。
+ */
+export interface ServicesApi extends NativeMigrateApi {
+  /** 检测「源 → 目标」链接状态（kebab-case 状态，api/dir 负责归一化为 store 的 camelCase） */
+  checkDirStatus(source: string, target: string): NativeDirStatus;
+  /** 展开路径中的 %ENV% / ~ */
+  expandEnv(path: string): string;
+  /** 目标盘可用空间（字节） */
+  getDiskFreeSpace(path: string): number;
+  /** 字节数格式化 */
+  formatSize(bytes: number): string;
+  /** 关联进程是否运行中 */
+  isProcessRunning(exeNames: string[]): boolean;
+}
+
+declare global {
+  interface Window {
+    services?: ServicesApi;
+  }
+}
+
+export {};
diff --git a/plugins/link-relay/src/hooks/seedPresets.ts b/plugins/link-relay/src/hooks/seedPresets.ts
new file mode 100644
index 000000000..993ababd1
--- /dev/null
+++ b/plugins/link-relay/src/hooks/seedPresets.ts
@@ -0,0 +1,58 @@
+/**
+ * 出厂预设首启实例化：把 src/assets/config.json 的模板转成 store 的 CreateDTO。
+ * - 模板字段与 store 三张表的 CreateDTO 对齐；模板不写 id/createdAt（由 store 生成）。
+ * - groupKey 仅用于把映射挂到本次新建的分组：调用方先 create 分组拿到 id，
+ *   再用 idOf(groupKey) 解析出每行 groupId。
+ * - sourcePath 的 %ENV%/~ 在实例化时经 api/dir.expandPath 展开为绝对路径；
+ *   宿主调用仍只允许出现在 api 层，这里只调用 dirApi，不直接碰 window.services。
+ */
+import type { GroupCreateDTO } from '../store/types/group';
+import type { MappingCreateDTO } from '../store/types/mapping';
+import { expandPath } from '../api/dir';
+import presetConfig from '../assets/config.json';
+
+/** config.json 中分组模板（key 为实例化期的临时关联键） */
+export interface PresetGroupTpl {
+  key: string;
+  name: string;
+}
+
+/** config.json 中映射模板：MappingCreateDTO 字段 + groupKey 关联键 */
+export interface PresetMappingTpl extends MappingCreateDTO {
+  groupKey: string;
+}
+
+interface PresetConfig {
+  version: number;
+  groups: PresetGroupTpl[];
+  mappings: PresetMappingTpl[];
+}
+
+const config = presetConfig as PresetConfig;
+
+/** 分组 CreateDTO 列表（仅 name，enabled/id/createdAt 由 groupStore 生成） */
+export function presetGroupDTOs(): GroupCreateDTO[] {
+  return config.groups.map((g) => ({ name: g.name }));
+}
+
+/** 保留 key 的分组模板，供调用方建立 groupKey -> 新建分组 id 的映射 */
+export function presetGroupKeys(): PresetGroupTpl[] {
+  return config.groups.map((g) => ({ key: g.key, name: g.name }));
+}
+
+/**
+ * 映射 CreateDTO 列表。
+ * @param idOf 由 groupKey 解析出已创建分组的真实 id（未匹配则归入未分组 ''）
+ */
+export function presetMappingDTOs(idOf: (groupKey: string) => string): MappingCreateDTO[] {
+  return config.mappings.map((m) => {
+    const { groupKey, ...dto } = m;
+    return {
+      ...dto,
+      groupId: idOf(groupKey),
+      sourcePath: expandPath(m.sourcePath),
+      exeNames: m.exeNames ?? [],
+      cachePatterns: m.cachePatterns ?? [],
+    };
+  });
+}
diff --git a/plugins/link-relay/src/hooks/useDashboard.ts b/plugins/link-relay/src/hooks/useDashboard.ts
new file mode 100644
index 000000000..e03125fd2
--- /dev/null
+++ b/plugins/link-relay/src/hooks/useDashboard.ts
@@ -0,0 +1,465 @@
+/**
+ * useDashboard —— 首页业务编排 hook（模块级单例，Home 与各弹窗共享同一份状态）。
+ *
+ * 定位（新架构）：
+ * - store 三张表（group/mapping/log）只做纯数据 CRUD + 自动持久化；
+ * - 本 hook 负责「读模型组装 + 交互/业务编排」：实时扫描状态、拼组名、KPI、筛选、选择、折叠、
+ *   增删改、并把每个操作写入 log 表；
+ * - 所有宿主能力只经 api 层（dirApi/envApi），本 hook 不直接碰 window.services / ztools。
+ */
+import { computed, reactive, ref, type ComputedRef, type Ref } from 'vue';
+import { useGroupStore, useLogStore, useMappingStore } from '../store';
+import * as dirApi from '../api/dir';
+import * as envApi from '../api/env';
+import { devSeedGroupNames, devSeedMappings } from '../api/dev';
+import { presetGroupKeys, presetMappingDTOs } from './seedPresets';
+import { formatBytes, parseLineList } from '../utils/format';
+import {
+  FilterEnum,
+  type FilterKey,
+  isAbnormalStatus,
+  isPendingStatus,
+  statusAction,
+  statusSeverity,
+  UNGROUPED_ID,
+  UNGROUPED_NAME,
+  ViewModeEnum,
+  type ViewMode,
+} from '../utils/enums';
+import type { GroupVO, LogAction, LogLevel, LogResource } from '../store/types';
+import type { LinkStatus, MappingCreateDTO, MappingVO } from '../store/types/mapping';
+
+// ────────────── 视图模型类型（供组件 props 使用） ──────────────
+
+/** 表格行视图模型：映射实体 + 组名 + 派生的可勾选/主操作 */
+export interface MappingRowVM {
+  id: string;
+  name: string;
+  groupId: string;
+  groupName: string;
+  sourcePath: string;
+  targetPath: string;
+  exeNames: string[];
+  cachePatterns: string[];
+  /** 行自身开关与组开关叠加后的有效启用态 */
+  enabled: boolean;
+  status: LinkStatus;
+  sizeBytes: number;
+  lastMigratedAt: string;
+  lastError: string;
+  /** linked 行不可勾选 */
+  selectable: boolean;
+  /** 由状态推导的主操作（停用行置空） */
+  action: ReturnType<typeof statusAction>;
+}
+
+/** 分组视图模型 */
+export interface GroupVM {
+  id: string;
+  name: string;
+  enabled: boolean;
+  rows: MappingRowVM[];
+  /** 组内最严重状态 */
+  aggregatedStatus: LinkStatus;
+}
+
+export interface KpiSummary {
+  total: number;
+  linked: number;
+  pending: number;
+  conflict: number;
+  saveSize: number;
+  saveSizeFormatted: string;
+}
+
+/** 添加/编辑弹窗表单（文本域在提交时由本 hook 解析为数组） */
+export interface MappingDraft {
+  id?: string;
+  name: string;
+  groupId: string;
+  sourcePath: string;
+  targetPath: string;
+  exeNamesText: string;
+  cachePatternsText: string;
+}
+
+// ────────────── 模块级单例 UI / 交互状态（非持久化） ──────────────
+
+const loading = ref(false);
+const error = ref<string | null>(null);
+const lastScan = ref<Date | null>(null);
+const filter = ref<FilterKey>(FilterEnum.All);
+const viewMode = ref<ViewMode>(ViewModeEnum.Grouped);
+const selectedIds = reactive(new Set<string>());
+const collapsed = reactive(new Set<string>());
+const editingId = ref<string | null>(null);
+/** 新增/编辑弹窗可见（新增时 editingId 为 null，故可见态独立维护） */
+const editorVisible = ref(false);
+/** 新增时预选的分组（组标题「＋添加」传入） */
+const pendingGroup = ref<string>(UNGROUPED_ID);
+
+let cache: DashboardApi | null = null;
+
+/** 单行实体 → 行视图模型 */
+function toRowVM(row: MappingVO, groupName: string, groupEnabled: boolean): MappingRowVM {
+  const enabled = row.enabled && groupEnabled;
+  return {
+    id: row.id,
+    name: row.name,
+    groupId: row.groupId,
+    groupName,
+    sourcePath: row.sourcePath,
+    targetPath: row.targetPath,
+    exeNames: row.exeNames,
+    cachePatterns: row.cachePatterns,
+    enabled,
+    status: row.status,
+    sizeBytes: row.sizeBytes,
+    lastMigratedAt: row.lastMigratedAt,
+    lastError: row.lastError,
+    selectable: enabled && row.status !== 'linked',
+    action: enabled ? statusAction(row.status) : { type: 'none', label: '已停用', disabled: true },
+  };
+}
+
+function matchStatus(status: LinkStatus, key: FilterKey): boolean {
+  switch (key) {
+    case FilterEnum.Pending:
+      return isPendingStatus(status);
+    case FilterEnum.Linked:
+      return status === 'linked';
+    case FilterEnum.Conflict:
+      return isAbnormalStatus(status);
+    case FilterEnum.All:
+    default:
+      return true;
+  }
+}
+
+export interface DashboardApi {
+  // state
+  loading: Ref<boolean>;
+  error: Ref<string | null>;
+  lastScan: Ref<Date | null>;
+  filter: Ref<FilterKey>;
+  viewMode: Ref<ViewMode>;
+  selectedIds: Set<string>;
+  collapsed: Set<string>;
+  editingId: Ref<string | null>;
+  editorVisible: Ref<boolean>;
+  pendingGroup: Ref<string>;
+  // derived
+  groups: ComputedRef<GroupVO[]>;
+  allRows: ComputedRef<MappingRowVM[]>;
+  flatRows: ComputedRef<MappingRowVM[]>;
+  visibleGroups: ComputedRef<GroupVM[]>;
+  kpi: ComputedRef<KpiSummary>;
+  filterCounts: ComputedRef<Record<FilterKey, number>>;
+  checkedCount: ComputedRef<number>;
+  selectedItemIds: ComputedRef<string[]>;
+  allVisibleChecked: ComputedRef<boolean>;
+  visibleIndeterminate: ComputedRef<boolean>;
+  hasSelection: ComputedRef<boolean>;
+  editingRow: ComputedRef<MappingRowVM | null>;
+  // lifecycle
+  init: () => Promise<void>;
+  refresh: () => Promise<void>;
+  // view actions
+  setFilter: (f: FilterKey) => void;
+  setView: (v: ViewMode) => void;
+  toggleRow: (id: string, checked: boolean) => void;
+  toggleAllVisible: (checked: boolean) => void;
+  clearSelection: () => void;
+  toggleCollapse: (groupId: string) => void;
+  // editor
+  openAdd: (groupId?: string) => void;
+  openEdit: (id: string) => void;
+  closeEditor: () => void;
+  submitMapping: (draft: MappingDraft) => void;
+  browseDirectory: (title?: string) => string;
+  // mapping CRUD
+  removeMapping: (id: string) => void;
+  // group CRUD
+  createGroup: (name: string) => string | null;
+  renameGroup: (id: string, name: string) => void;
+  toggleGroup: (id: string, enabled: boolean) => void;
+  removeGroup: (id: string) => void;
+}
+
+export function useDashboard(): DashboardApi {
+  if (cache) return cache;
+
+  const groupStore = useGroupStore();
+  const mappingStore = useMappingStore();
+  const logStore = useLogStore();
+
+  /** 组 id → 组（缺失组的行归入未分组） */
+  function groupNameOf(groupId: string): string {
+    if (!groupId) return UNGROUPED_NAME;
+    return groupStore.findById(groupId)?.name ?? UNGROUPED_NAME;
+  }
+  function groupEnabledOf(groupId: string): boolean {
+    if (!groupId) return true;
+    return groupStore.findById(groupId)?.enabled ?? true;
+  }
+
+  // ── 读模型 ──
+  const groups = computed<GroupVO[]>(() => groupStore.groups);
+  const allRows = computed<MappingRowVM[]>(() =>
+    mappingStore.rows.map((row) => toRowVM(row, groupNameOf(row.groupId), groupEnabledOf(row.groupId)))
+  );
+
+  const flatRows = computed<MappingRowVM[]>(() => allRows.value.filter((r) => matchStatus(r.status, filter.value)));
+
+  const visibleGroups = computed<GroupVM[]>(() => {
+    const result: GroupVM[] = [];
+    const pushGroup = (id: string, name: string, enabled: boolean, members: MappingRowVM[]) => {
+      const rows = members.filter((r) => matchStatus(r.status, filter.value));
+      if (rows.length === 0) return;
+      const aggregatedStatus = rows.reduce<LinkStatus>(
+        (acc, r) => (statusSeverity(r.status) > statusSeverity(acc) ? r.status : acc),
+        'unknown'
+      );
+      result.push({ id, name, enabled, rows, aggregatedStatus });
+    };
+
+    // 已建组按 groupStore 顺序
+    for (const group of groupStore.groups) {
+      pushGroup(group.id, group.name, group.enabled, allRows.value.filter((r) => r.groupId === group.id));
+    }
+    // 未分组（含引用了已删除组的行）固定置尾
+    pushGroup(UNGROUPED_ID, UNGROUPED_NAME, true, allRows.value.filter((r) => !r.groupId || !groupStore.findById(r.groupId)));
+    return result;
+  });
+
+  const kpi = computed<KpiSummary>(() => {
+    const rows = allRows.value;
+    const saveSize = rows.reduce((sum, r) => sum + r.sizeBytes, 0);
+    return {
+      total: rows.length,
+      linked: rows.filter((r) => r.status === 'linked').length,
+      pending: rows.filter((r) => isPendingStatus(r.status)).length,
+      conflict: rows.filter((r) => isAbnormalStatus(r.status)).length,
+      saveSize,
+      saveSizeFormatted: formatBytes(saveSize),
+    };
+  });
+
+  const filterCounts = computed<Record<FilterKey, number>>(() => {
+    const rows = allRows.value;
+    return {
+      [FilterEnum.All]: rows.length,
+      [FilterEnum.Pending]: rows.filter((r) => isPendingStatus(r.status)).length,
+      [FilterEnum.Linked]: rows.filter((r) => r.status === 'linked').length,
+      [FilterEnum.Conflict]: rows.filter((r) => isAbnormalStatus(r.status)).length,
+    };
+  });
+
+  const checkedCount = computed(() => selectedIds.size);
+  const selectedItemIds = computed(() =>
+    allRows.value.filter((r) => selectedIds.has(r.id)).map((r) => r.id)
+  );
+  /** 当前视图下可见的行：平铺=flatRows；分组=所有未折叠组内的行 */
+  const visibleRows = computed<MappingRowVM[]>(() => {
+    if (viewMode.value === ViewModeEnum.Flat) return flatRows.value;
+    const rows: MappingRowVM[] = [];
+    for (const g of visibleGroups.value) {
+      if (!collapsed.has(g.id)) rows.push(...g.rows);
+    }
+    return rows;
+  });
+  const allVisibleChecked = computed(() => {
+    const selectable = visibleRows.value.filter((r) => r.selectable);
+    return selectable.length > 0 && selectable.every((r) => selectedIds.has(r.id));
+  });
+  const visibleIndeterminate = computed(() => {
+    const selectable = visibleRows.value.filter((r) => r.selectable);
+    const checked = selectable.filter((r) => selectedIds.has(r.id));
+    return checked.length > 0 && checked.length < selectable.length;
+  });
+  const hasSelection = computed(() => selectedIds.size > 0);
+  const editingRow = computed(() => (editingId.value ? allRows.value.find((r) => r.id === editingId.value) ?? null : null));
+
+  // ── 日志辅助 ──
+  function writeLog(
+    resource: LogResource,
+    action: LogAction,
+    level: LogLevel,
+    message: string,
+    resourceId = '',
+    resourceName = ''
+  ): void {
+    logStore.create({ resource, action, level, message, resourceId, resourceName });
+  }
+
+  // ── 扫描 ──
+  /** preload 文件系统检测为同步，先让出一帧避免阻塞首屏绘制 */
+  function nextPaint(): Promise<void> {
+    return new Promise((resolve) => setTimeout(resolve, 0));
+  }
+
+  async function refresh(): Promise<void> {
+    loading.value = true;
+    error.value = null;
+    try {
+      await nextPaint();
+      for (const row of mappingStore.rows) {
+        const dir = dirApi.checkLink(row.sourcePath, row.targetPath);
+        mappingStore.update(row.id, { status: dir.status, sizeBytes: dir.sizeBytes });
+      }
+      lastScan.value = new Date();
+      pruneSelection();
+    } catch (e) {
+      error.value = e instanceof Error ? e.message : '扫描失败';
+    } finally {
+      loading.value = false;
+    }
+  }
+
+  /** 清理已不可勾选行的选中态 */
+  function pruneSelection(): void {
+    const valid = new Set(allRows.value.filter((r) => r.selectable).map((r) => r.id));
+    for (const id of [...selectedIds]) {
+      if (!valid.has(id)) selectedIds.delete(id);
+    }
+  }
+
+  /** dev 首帧种子数据（仅无宿主且两表为空时执行一次，纯内存） */
+  /**
+   * 两表皆空的首次启动播种（只执行一次）：
+   * - 宿主环境：从 src/assets/config.json 实例化出厂预设（vscode / qoder），%ENV% 已展开为绝对路径；
+   * - dev 浏览器：播纯内存虚拟数据（RelocatorTest，零真实 IDE 路径、零磁盘 IO）。
+   */
+  function seedIfEmpty(): void {
+    if (mappingStore.count > 0 || groupStore.count > 0) return;
+    if (envApi.isHost()) {
+      const idByKey = new Map<string, string>();
+      for (const g of presetGroupKeys()) idByKey.set(g.key, groupStore.create({ name: g.name }).id);
+      for (const dto of presetMappingDTOs((key) => idByKey.get(key) ?? UNGROUPED_ID)) mappingStore.create(dto);
+      return;
+    }
+    const idByName = new Map<string, string>();
+    for (const name of devSeedGroupNames()) idByName.set(name, groupStore.create({ name }).id);
+    for (const dto of devSeedMappings((name) => idByName.get(name) ?? UNGROUPED_ID)) mappingStore.create(dto);
+  }
+
+  let initialized = false;
+  async function init(): Promise<void> {
+    if (initialized) {
+      await refresh();
+      return;
+    }
+    initialized = true;
+    seedIfEmpty();
+    await refresh();
+  }
+
+  // ── 视图 / 选择 / 折叠 ──
+  function setFilter(f: FilterKey): void { filter.value = f; }
+  function setView(v: ViewMode): void { viewMode.value = v; }
+  function toggleRow(id: string, checked: boolean): void {
+    if (checked) selectedIds.add(id);
+    else selectedIds.delete(id);
+  }
+  function toggleAllVisible(checked: boolean): void {
+    visibleRows.value.filter((r) => r.selectable).forEach((r) => {
+      if (checked) selectedIds.add(r.id);
+      else selectedIds.delete(r.id);
+    });
+  }
+  function clearSelection(): void { selectedIds.clear(); }
+  function toggleCollapse(groupId: string): void {
+    if (collapsed.has(groupId)) collapsed.delete(groupId);
+    else collapsed.add(groupId);
+  }
+
+  // ── 编辑器 ──
+  function openAdd(groupId?: string): void {
+    editingId.value = null;
+    pendingGroup.value = groupId ?? UNGROUPED_ID;
+    editorVisible.value = true;
+  }
+  function openEdit(id: string): void {
+    editingId.value = id;
+    editorVisible.value = true;
+  }
+  function closeEditor(): void {
+    editingId.value = null;
+    editorVisible.value = false;
+  }
+
+  function browseDirectory(title?: string): string {
+    return dirApi.pickDirectory(title);
+  }
+
+  function submitMapping(draft: MappingDraft): void {
+    const payload: MappingCreateDTO = {
+      name: draft.name.trim(),
+      sourcePath: draft.sourcePath.trim(),
+      targetPath: draft.targetPath.trim(),
+      groupId: draft.groupId || UNGROUPED_ID,
+      exeNames: parseLineList(draft.exeNamesText),
+      cachePatterns: parseLineList(draft.cachePatternsText),
+    };
+    if (editingId.value) {
+      mappingStore.update(editingId.value, payload);
+      writeLog('mapping', 'update', 'info', `修改映射「${payload.name}」`, editingId.value, payload.name);
+    } else {
+      const created = mappingStore.create(payload);
+      writeLog('mapping', 'create', 'info', `新增映射「${payload.name}」`, created.id, payload.name);
+    }
+    closeEditor();
+    void refresh();
+  }
+
+  function removeMapping(id: string): void {
+    const target = mappingStore.findById(id);
+    mappingStore.remove(id);
+    selectedIds.delete(id);
+    writeLog('mapping', 'delete', 'warn', `删除映射「${target?.name ?? id}」`, id, target?.name ?? '');
+    void refresh();
+  }
+
+  // ── 分组 CRUD ──
+  function createGroup(name: string): string | null {
+    const trimmed = name.trim();
+    if (!trimmed) return null;
+    const created = groupStore.create({ name: trimmed });
+    writeLog('group', 'create', 'info', `新增分组「${trimmed}」`, created.id, trimmed);
+    return created.id;
+  }
+
+  function renameGroup(id: string, name: string): void {
+    const trimmed = name.trim();
+    if (!trimmed) return;
+    groupStore.update(id, { name: trimmed });
+    writeLog('group', 'update', 'info', `分组重命名为「${trimmed}」`, id, trimmed);
+  }
+
+  function toggleGroup(id: string, enabled: boolean): void {
+    groupStore.update(id, { enabled });
+    const name = groupStore.findById(id)?.name ?? id;
+    writeLog('group', 'toggle', enabled ? 'success' : 'warn', `${enabled ? '启用' : '停用'}分组「${name}」`, id, name);
+  }
+
+  function removeGroup(id: string): void {
+    const name = groupStore.findById(id)?.name ?? id;
+    // 组删除后其下行落入未分组（不级联删行，避免误删配置）
+    for (const row of mappingStore.query({ groupId: id })) mappingStore.update(row.id, { groupId: UNGROUPED_ID });
+    groupStore.remove(id);
+    collapsed.delete(id);
+    writeLog('group', 'delete', 'warn', `删除分组「${name}」（其映射转入未分组）`, id, name);
+  }
+
+  const api: DashboardApi = {
+    loading, error, lastScan, filter, viewMode, selectedIds, collapsed, editingId, editorVisible, pendingGroup,
+    groups, allRows, flatRows, visibleGroups, kpi, filterCounts, checkedCount, selectedItemIds,
+    allVisibleChecked, visibleIndeterminate, hasSelection, editingRow,
+    init, refresh,
+    setFilter, setView, toggleRow, toggleAllVisible, clearSelection, toggleCollapse,
+    openAdd, openEdit, closeEditor, submitMapping, browseDirectory, removeMapping,
+    createGroup, renameGroup, toggleGroup, removeGroup,
+  };
+  cache = api;
+  return api;
+}
diff --git a/plugins/link-relay/src/hooks/useDialog.ts b/plugins/link-relay/src/hooks/useDialog.ts
new file mode 100644
index 000000000..cd2a7b75a
--- /dev/null
+++ b/plugins/link-relay/src/hooks/useDialog.ts
@@ -0,0 +1,117 @@
+import { ref, watch } from 'vue'
+import type { Ref } from 'vue'
+
+export interface UseDialogOptions {
+  /** 弹窗初始标题 */
+  title?: string
+  /** 是否默认打开（默认 false） */
+  initialVisible?: boolean
+  /** 弹窗宽度，可在模板上用 :width 覆盖 */
+  width?: string | number
+  /** 打开时回调（openDialog 或直接改 visible 都会触发） */
+  onOpen?: () => void
+  /** 关闭时回调（含右上角 ×、遮罩关闭等所有路径） */
+  onClose?: () => void
+}
+
+export interface UseDialogReturn {
+  /** 弹窗根元素引用，可用于聚焦、滚动 */
+  dialogRef: Ref<HTMLElement | null>
+  /** 是否显示，直接绑定 v-model */
+  visible: Ref<boolean>
+  /** 弹窗内加载状态 */
+  loading: Ref<boolean>
+  /** 弹窗标题 */
+  title: Ref<string>
+  /** 弹窗宽度 */
+  width: Ref<string | number | undefined>
+  /** 每次 openDialog 自增，作为子组件 :key 强制重建，避免数据残留 */
+  refreshKey: Ref<number>
+  /** 打开弹窗，可传入新标题覆盖默认标题 */
+  openDialog: (title?: string) => void
+  /** 关闭弹窗 */
+  closeDialog: () => void
+  /** 按当前状态切换开关 */
+  toggleDialog: () => void
+  /** 动态修改标题 */
+  setTitle: (title: string) => void
+  /** 设置加载状态 */
+  setLoading: (loading: boolean) => void
+  openLoading: () => void
+  closeLoading: () => void
+  /** 重置 loading 与标题，并重建子组件 */
+  reset: () => void
+}
+
+/**
+ * 弹窗状态管理：统一维护 visible / title / loading 及开关方法，
+ * 并通过 watch 捕获所有关闭路径（含 el-dialog 右上角 ×）分发回调。
+ */
+export default function useDialog(options: UseDialogOptions = {}): UseDialogReturn {
+  const dialogRef = ref<HTMLElement | null>(null)
+  const visible = ref(options.initialVisible ?? false)
+  const loading = ref(false)
+  const title = ref(options.title ?? '')
+  const width = ref(options.width)
+  const refreshKey = ref(0)
+
+  // 单一状态源：无论 closeDialog 还是 × 按钮关闭，回调都从 visible 变化统一分发
+  watch(visible, (val) => {
+    if (val) {
+      options.onOpen?.()
+    } else {
+      options.onClose?.()
+    }
+  })
+
+  const openDialog = (newTitle?: string) => {
+    if (newTitle !== undefined) {
+      title.value = newTitle
+    }
+    // 每次打开自增，模板上 :key="refreshKey" 即可强制重建子组件
+    refreshKey.value += 1
+    visible.value = true
+  }
+
+  const closeDialog = () => {
+    visible.value = false
+  }
+
+  const toggleDialog = () => {
+    visible.value ? closeDialog() : openDialog()
+  }
+
+  const setTitle = (t: string) => {
+    title.value = t
+  }
+
+  const setLoading = (l: boolean) => {
+    loading.value = l
+  }
+
+  const openLoading = () => setLoading(true)
+  const closeLoading = () => setLoading(false)
+
+  const reset = () => {
+    loading.value = false
+    title.value = options.title ?? ''
+    refreshKey.value += 1
+  }
+
+  return {
+    dialogRef,
+    visible,
+    loading,
+    title,
+    width,
+    refreshKey,
+    openDialog,
+    closeDialog,
+    toggleDialog,
+    setTitle,
+    setLoading,
+    openLoading,
+    closeLoading,
+    reset,
+  }
+}
diff --git a/plugins/link-relay/src/hooks/useMigration.ts b/plugins/link-relay/src/hooks/useMigration.ts
new file mode 100644
index 000000000..3f28d4a39
--- /dev/null
+++ b/plugins/link-relay/src/hooks/useMigration.ts
@@ -0,0 +1,223 @@
+/**
+ * useMigration —— 迁移流程编排 hook（模块级单例）。
+ *
+ * 负责：dry-run 预览、确认、执行迁移、单行重建/修复、进度事件订阅、结果回写与操作日志。
+ * - 引擎能力全部走 migrateApi（api 层负责与 preload 对接及状态翻译），本 hook 只做编排；
+ * - 确认/进度两个弹窗的开关用通用 useDialog 管理；
+ * - 执行结果回写 mapping 表（状态 / 上次迁移时间 / 错误）并追加 log 表，随后重新扫描。
+ */
+import { computed, ref, type ComputedRef, type Ref } from 'vue';
+import { useGroupStore, useLogStore, useMappingStore } from '../store';
+import * as migrateApi from '../api/migrate';
+import type { ConflictStrategy, MigrationOptions, MigrationResult, PreviewResult } from '../api/migrate';
+import useDialog from './useDialog';
+import { UNGROUPED_NAME } from '../utils/enums';
+import { useDashboard, type MappingRowVM } from './useDashboard';
+
+/** 进度弹窗中的一行运行日志（瞬时，不持久化；持久化审计走 log 表） */
+export interface RunLog {
+  level: string;
+  message: string;
+  time: string;
+}
+
+export interface ProgressInfo {
+  filesCopied: number;
+  bytesCopied: number;
+  currentFile: string;
+}
+
+let cache: MigrationApi | null = null;
+
+export interface MigrationApi {
+  preview: Ref<PreviewResult | null>;
+  running: Ref<boolean>;
+  runLogs: Ref<RunLog[]>;
+  currentPhase: Ref<string>;
+  currentItem: Ref<string>;
+  progressInfo: Ref<ProgressInfo>;
+  confirmVisible: Ref<boolean>;
+  progressVisible: Ref<boolean>;
+  actionableCount: ComputedRef<number>;
+  openConfirm: (itemIds?: string[]) => void;
+  closeConfirm: () => void;
+  confirmMigrate: (options: MigrationOptions) => Promise<void>;
+  runRowAction: (row: MappingRowVM) => Promise<void>;
+  cancelMigration: () => void;
+  closeProgress: () => void;
+}
+
+function nowTime(): string {
+  return new Date().toLocaleTimeString('zh-CN', { hour12: false });
+}
+
+export function useMigration(): MigrationApi {
+  if (cache) return cache;
+
+  const dashboard = useDashboard();
+  const groupStore = useGroupStore();
+  const mappingStore = useMappingStore();
+  const logStore = useLogStore();
+
+  const confirmDialog = useDialog({ title: '迁移预览' });
+  const progressDialog = useDialog({ title: '正在迁移' });
+
+  const preview = ref<PreviewResult | null>(null);
+  const running = ref(false);
+  const runLogs = ref<RunLog[]>([]);
+  const currentPhase = ref('');
+  const currentItem = ref('');
+  const progressInfo = ref<ProgressInfo>({ filesCopied: 0, bytesCopied: 0, currentFile: '' });
+
+  const actionableCount = computed(
+    () => preview.value?.operations.filter((o) => o.action !== 'skip').length ?? 0
+  );
+
+  /** 组 id → 显示名 */
+  function groupNameOf(groupId: string): string {
+    if (!groupId) return UNGROUPED_NAME;
+    return groupStore.findById(groupId)?.name ?? UNGROUPED_NAME;
+  }
+
+  /** 用最新 mapping 表构造引擎项 */
+  function buildItems(ids?: string[]) {
+    const rows = ids?.length ? mappingStore.query().filter((r) => ids.includes(r.id)) : mappingStore.query();
+    return rows.map((row) => migrateApi.toEngineItem(row, groupNameOf(row.groupId)));
+  }
+
+  // ── 进度订阅（只订一次） ──
+  let subscribed = false;
+  function subscribeProgress(): void {
+    if (subscribed) return;
+    subscribed = true;
+    migrateApi.onProgress((type, data) => {
+      const evt = { type, ...((data ?? {}) as Record<string, unknown>) } as { type: string } & Record<string, unknown>;
+      if (evt.type === 'phase') {
+        currentPhase.value = String(evt.message ?? '');
+        currentItem.value = String(evt.groupDisplayName ?? '');
+      } else if (evt.type === 'progress') {
+        progressInfo.value = {
+          filesCopied: Number(evt.filesCopied ?? 0),
+          bytesCopied: Number(evt.bytesCopied ?? 0),
+          currentFile: String(evt.currentFile ?? ''),
+        };
+      } else if (evt.type === 'log') {
+        runLogs.value = [...runLogs.value, { level: String(evt.level ?? 'info'), message: String(evt.message ?? ''), time: nowTime() }];
+      }
+    });
+  }
+
+  function resetRuntime(): void {
+    runLogs.value = [];
+    currentPhase.value = '';
+    currentItem.value = '';
+    progressInfo.value = { filesCopied: 0, bytesCopied: 0, currentFile: '' };
+  }
+
+  // ── 预览 ──
+  function openConfirm(itemIds?: string[]): void {
+    subscribeProgress();
+    const items = buildItems(itemIds);
+    preview.value = migrateApi.dryRun(items, { itemIds });
+    confirmDialog.openDialog();
+  }
+  function closeConfirm(): void {
+    confirmDialog.closeDialog();
+    preview.value = null;
+  }
+
+  // ── 结果回写 + 审计日志 ──
+  function applyResults(results: MigrationResult[]): void {
+    for (const result of results) {
+      const row = mappingStore.findById(result.itemId);
+      if (result.success) {
+        mappingStore.update(result.itemId, {
+          status: 'linked',
+          sizeBytes: 0,
+          lastMigratedAt: new Date().toISOString(),
+          lastError: '',
+        });
+        logStore.create({
+          resource: 'mapping', action: result.action === 'relink' ? 'relink' : result.action === 'repair' ? 'repair' : 'migrate',
+          level: 'success', message: `「${row?.name ?? result.itemId}」${result.action === 'relink' ? '重建' : result.action === 'repair' ? '修复' : '迁移'}完成`,
+          resourceId: result.itemId, resourceName: row?.name ?? '',
+        });
+      } else {
+        mappingStore.update(result.itemId, { lastError: result.error ?? '迁移失败' });
+        logStore.create({
+          resource: 'mapping', action: 'migrate', level: 'error',
+          message: `「${row?.name ?? result.itemId}」失败：${result.error ?? '迁移失败'}`,
+          resourceId: result.itemId, resourceName: row?.name ?? '',
+        });
+      }
+    }
+  }
+
+  // ── 确认执行 ──
+  async function confirmMigrate(options: MigrationOptions): Promise<void> {
+    if (!preview.value) return;
+    const itemIds = preview.value.operations.filter((o) => o.action !== 'skip').map((o) => o.itemId);
+    const merged: MigrationOptions = { itemIds, ...options };
+    confirmDialog.closeDialog();
+    progressDialog.openDialog();
+    running.value = true;
+    resetRuntime();
+    try {
+      const items = buildItems(itemIds);
+      const results = await migrateApi.migrate(items, merged);
+      applyResults(results);
+    } catch (e) {
+      runLogs.value = [...runLogs.value, { level: 'error', message: e instanceof Error ? e.message : '迁移失败', time: nowTime() }];
+    } finally {
+      running.value = false;
+      dashboard.clearSelection();
+      await dashboard.refresh();
+    }
+  }
+
+  // ── 行内主操作：迁移走确认弹窗；重建/修复直接执行单行 ──
+  async function runRowAction(row: MappingRowVM): Promise<void> {
+    subscribeProgress();
+    if (row.action.type === 'migrate') {
+      openConfirm([row.id]);
+      return;
+    }
+    if (row.action.type === 'none') return;
+
+    const item = migrateApi.toEngineItem(mappingStore.findById(row.id)!, row.groupName);
+    progressDialog.openDialog();
+    running.value = true;
+    resetRuntime();
+    try {
+      const strategy: ConflictStrategy | undefined = undefined;
+      const result = row.action.type === 'relink'
+        ? await migrateApi.relink(item)
+        : await migrateApi.repair(item, strategy);
+      applyResults([result]);
+    } catch (e) {
+      applyResults([{ success: false, itemId: row.id, action: row.action.type, error: e instanceof Error ? e.message : '操作失败' }]);
+    } finally {
+      running.value = false;
+      await dashboard.refresh();
+    }
+  }
+
+  function cancelMigration(): void {
+    migrateApi.abortMigration();
+    running.value = false;
+  }
+
+  function closeProgress(): void {
+    progressDialog.closeDialog();
+    closeConfirm();
+  }
+
+  const api: MigrationApi = {
+    preview, running, runLogs, currentPhase, currentItem, progressInfo,
+    confirmVisible: confirmDialog.visible, progressVisible: progressDialog.visible,
+    actionableCount,
+    openConfirm, closeConfirm, confirmMigrate, runRowAction, cancelMigration, closeProgress,
+  };
+  cache = api;
+  return api;
+}
diff --git a/plugins/link-relay/src/main.ts b/plugins/link-relay/src/main.ts
new file mode 100644
index 000000000..85e8f3af6
--- /dev/null
+++ b/plugins/link-relay/src/main.ts
@@ -0,0 +1,7 @@
+import { createApp } from 'vue'
+import './styles/main.scss'
+import App from './App.vue'
+// pinia 实例与持久化插件在 store 层出口组装，入口只负责挂载
+import { pinia } from './store'
+
+createApp(App).use(pinia).mount('#app');
diff --git a/plugins/link-relay/src/store/groupStore.ts b/plugins/link-relay/src/store/groupStore.ts
new file mode 100644
index 000000000..ded0bfde5
--- /dev/null
+++ b/plugins/link-relay/src/store/groupStore.ts
@@ -0,0 +1,70 @@
+/**
+ * 分组表 store（pinia Setup Store，1:1 对应 types/group.ts）。
+ * ref = 实体表，computed = 只读派生，函数 = CRUD 动作（create / update / remove）。
+ * 分组可为空：不预置任何固定组，主键 uuid v4。
+ *
+ * 持久化由 ztoolsPersist 插件自动完成（快照文档 store:group）：
+ * 创建时自动水合，state 变更后防抖写库；需要手动刷新/落盘用 $hydrate() / $persist()。
+ */
+import { computed, ref } from 'vue';
+import { defineStore } from 'pinia';
+import { v4 as uuidv4 } from 'uuid';
+import type { GroupCreateDTO, GroupQueryDTO, GroupUpdateDTO, GroupVO } from './types/group';
+
+export const useGroupStore = defineStore(
+  'group',
+  () => {
+    // ────────────── state ──────────────
+
+    /** 分组表（可为空） */
+    const groups = ref<GroupVO[]>([]);
+
+    // ────────────── getters（只读派生） ──────────────
+
+    /** 分组数 */
+    const count = computed<number>(() => groups.value.length);
+
+    /** 启用中的分组（停用组灰显保留，不隐藏） */
+    const enabledGroups = computed<GroupVO[]>(() => groups.value.filter((group) => group.enabled));
+
+    /** 条件查询（带参，不做缓存） */
+    function query(dto: GroupQueryDTO = {}): GroupVO[] {
+      return groups.value.filter(
+        (group) => (!dto.name || group.name.includes(dto.name)) && (dto.enabled === undefined || group.enabled === dto.enabled)
+      );
+    }
+
+    /** 主键查询 */
+    function findById(id: string): GroupVO | null {
+      return groups.value.find((group) => group.id === id) ?? null;
+    }
+
+    // ────────────── actions（只改 state，落库由插件负责） ──────────────
+
+    /** C：新增分组 */
+    function create(dto: GroupCreateDTO): GroupVO {
+      const created: GroupVO = {
+        id: uuidv4(),
+        enabled: true,
+        createdAt: new Date().toISOString(),
+        ...dto,
+      };
+      groups.value = [...groups.value, created];
+      return created;
+    }
+
+    /** U：改名 / 整组启停（停用只灰显，不删数据） */
+    function update(id: string, dto: GroupUpdateDTO): void {
+      const index = groups.value.findIndex((group) => group.id === id);
+      if (index >= 0) groups.value[index] = { ...groups.value[index], ...dto };
+    }
+
+    /** D：删除分组（组下行的 groupId 会悬空，需上层先置为未分组或级联删行） */
+    function remove(id: string): void {
+      groups.value = groups.value.filter((group) => group.id !== id);
+    }
+
+    return { groups, count, enabledGroups, query, findById, create, update, remove };
+  },
+  { persist: { pick: ['groups'] } }
+);
diff --git a/plugins/link-relay/src/store/index.ts b/plugins/link-relay/src/store/index.ts
new file mode 100644
index 000000000..050ad13f6
--- /dev/null
+++ b/plugins/link-relay/src/store/index.ts
@@ -0,0 +1,28 @@
+/**
+ * store 层出口 —— 在此组装 pinia、插件与宿主生命周期钩子，main.ts 只需 `use(pinia)`。
+ *
+ * 导出：
+ * - pinia：全应用唯一实例，已注册 ztoolsPersist（自动持久化到宿主文档库）
+ * - flushPersistedStores：退出前同步 flush 待写快照
+ * - useMappingStore / useGroupStore / useLogStore：三张表的 store
+ * - types：三张表的实体与 CRUD 入参（VO / CreateDTO / UpdateDTO / QueryDTO / 枚举）
+ */
+import { createPinia, type Pinia } from 'pinia';
+import * as envApi from '../api/env';
+import { createZtoolsPersist, flushPersistedStores } from './plugins/ztoolsPersist';
+
+/** 全应用唯一 pinia 实例：插件集中在此组装 */
+export const pinia: Pinia = createPinia();
+
+// 自动持久化：store 声明 { persist: {...} } 即接入 ztools.db（dev 无宿主时退化为内存）
+pinia.use(createZtoolsPersist());
+
+// 退出插件（含进程被杀）前同步 flush，避免丢掉防抖窗口（200ms）内的最后一次改动
+envApi.onOut(() => flushPersistedStores());
+
+export { useMappingStore } from './mappingStore';
+export { useGroupStore } from './groupStore';
+export { useLogStore } from './logStore';
+export { createZtoolsPersist, flushPersistedStores } from './plugins/ztoolsPersist';
+export type { PersistOptions, ZtoolsPersistOptions } from './plugins/ztoolsPersist';
+export * from './types';
diff --git a/plugins/link-relay/src/store/logStore.ts b/plugins/link-relay/src/store/logStore.ts
new file mode 100644
index 000000000..e6a8d662e
--- /dev/null
+++ b/plugins/link-relay/src/store/logStore.ts
@@ -0,0 +1,74 @@
+/**
+ * 操作日志表 store（pinia Setup Store，1:1 对应 types/log.ts）。
+ * ref = 实体表，computed = 只读派生，函数 = CRUD 动作（create / clear）。
+ *
+ * 持久化由 ztoolsPersist 插件自动完成（快照文档 store:log）：
+ * 创建时自动水合，state 变更后防抖写库；需要手动刷新/落盘用 $hydrate() / $persist()。
+ */
+import { computed, ref } from 'vue';
+import { defineStore } from 'pinia';
+import { v4 as uuidv4 } from 'uuid';
+import type { LogCreateDTO, LogQueryDTO, LogVO } from './types/log';
+
+/** 日志容量上限，超出丢最旧 */
+const LOG_LIMIT = 200;
+
+export const useLogStore = defineStore(
+  'log',
+  () => {
+    // ────────────── state ──────────────
+
+    /** 全部日志（新在前） */
+    const items = ref<LogVO[]>([]);
+
+    // ────────────── getters（只读派生） ──────────────
+
+    /** 条数 */
+    const count = computed<number>(() => items.value.length);
+
+    /** 最新一条 */
+    const latest = computed<LogVO | null>(() => items.value[0] ?? null);
+
+    /** 错误条数 */
+    const errorCount = computed<number>(() => items.value.filter((item) => item.level === 'error').length);
+
+    /** 条件查询（带参，不做缓存） */
+    function query(dto: LogQueryDTO = {}): LogVO[] {
+      return items.value
+        .filter(
+          (item) =>
+            (!dto.resource || item.resource === dto.resource) &&
+            (!dto.resourceId || item.resourceId === dto.resourceId) &&
+            (!dto.action || item.action === dto.action) &&
+            (!dto.level || item.level === dto.level)
+        )
+        .slice(0, dto.limit ?? LOG_LIMIT);
+    }
+
+    // ────────────── actions（只改 state，落库由插件负责） ──────────────
+
+    /** C：追加一条，置顶并裁剪到上限 */
+    function create(dto: LogCreateDTO): LogVO {
+      // createdAt（展示/落库）与 timestamp（排序/耗时）同源，避免两字段不一致
+      const now = new Date();
+      const created: LogVO = {
+        id: uuidv4(),
+        resourceId: '',
+        resourceName: '',
+        createdAt: now.toISOString(),
+        timestamp: now.getTime(),
+        ...dto,
+      };
+      items.value = [created, ...items.value].slice(0, LOG_LIMIT);
+      return created;
+    }
+
+    /** D：清空整表 */
+    function clear(): void {
+      items.value = [];
+    }
+
+    return { items, count, latest, errorCount, query, create, clear };
+  },
+  { persist: { pick: ['items'] } }
+);
diff --git a/plugins/link-relay/src/store/mappingStore.ts b/plugins/link-relay/src/store/mappingStore.ts
new file mode 100644
index 000000000..8958a0f31
--- /dev/null
+++ b/plugins/link-relay/src/store/mappingStore.ts
@@ -0,0 +1,80 @@
+/**
+ * 迁移目录配置表 store（pinia Setup Store，1:1 对应 types/mapping.ts）。
+ * ref = 实体表，computed = 只读派生，函数 = CRUD 动作（create / update / remove）。
+ *
+ * 持久化由 ztoolsPersist 插件自动完成（快照文档 store:mapping）：
+ * 创建时自动水合，state 变更后防抖写库；需要手动刷新/落盘用 $hydrate() / $persist()。
+ */
+import { computed, ref } from 'vue';
+import { defineStore } from 'pinia';
+import { v4 as uuidv4 } from 'uuid';
+import type { MappingCreateDTO, MappingQueryDTO, MappingUpdateDTO, MappingVO } from './types/mapping';
+
+export const useMappingStore = defineStore(
+  'mapping',
+  () => {
+    // ────────────── state ──────────────
+
+    /** 配置表全部行 */
+    const rows = ref<MappingVO[]>([]);
+
+    // ────────────── getters（只读派生） ──────────────
+
+    /** 行数 */
+    const count = computed<number>(() => rows.value.length);
+
+    /** 可释放空间合计（字节） */
+    const totalSize = computed<number>(() => rows.value.reduce((sum, row) => sum + row.sizeBytes, 0));
+
+    /** 条件查询（带参，不做缓存） */
+    function query(dto: MappingQueryDTO = {}): MappingVO[] {
+      return rows.value.filter(
+        (row) =>
+          (!dto.groupId || row.groupId === dto.groupId) &&
+          (!dto.status || row.status === dto.status) &&
+          (dto.enabled === undefined || row.enabled === dto.enabled) &&
+          (!dto.keyword || row.name.includes(dto.keyword))
+      );
+    }
+
+    /** 主键查询 */
+    function findById(id: string): MappingVO | null {
+      return rows.value.find((row) => row.id === id) ?? null;
+    }
+
+    // ────────────── actions（只改 state，落库由插件负责） ──────────────
+
+    /** C：新增一行，主键 uuid v4，默认列在此补齐 */
+    function create(dto: MappingCreateDTO): MappingVO {
+      const created: MappingVO = {
+        id: uuidv4(),
+        groupId: '',
+        exeNames: [],
+        cachePatterns: [],
+        enabled: true,
+        status: 'unknown',
+        sizeBytes: 0,
+        lastMigratedAt: '',
+        lastError: '',
+        createdAt: new Date().toISOString(),
+        ...dto,
+      };
+      rows.value = [...rows.value, created];
+      return created;
+    }
+
+    /** U：按可写白名单列更新 */
+    function update(id: string, dto: MappingUpdateDTO): void {
+      const index = rows.value.findIndex((row) => row.id === id);
+      if (index >= 0) rows.value[index] = { ...rows.value[index], ...dto };
+    }
+
+    /** D：删除一行（仅删配置，不动磁盘数据） */
+    function remove(id: string): void {
+      rows.value = rows.value.filter((row) => row.id !== id);
+    }
+
+    return { rows, count, totalSize, query, findById, create, update, remove };
+  },
+  { persist: { pick: ['rows'] } }
+);
diff --git a/plugins/link-relay/src/store/plugins/ztoolsPersist.ts b/plugins/link-relay/src/store/plugins/ztoolsPersist.ts
new file mode 100644
index 000000000..141eae4dc
--- /dev/null
+++ b/plugins/link-relay/src/store/plugins/ztoolsPersist.ts
@@ -0,0 +1,164 @@
+/**
+ * pinia 插件：把 store state 自动快照到宿主文档库（ztools.db），创建时自动水合。
+ *
+ * 用到的官方能力：
+ * - 插件签名 `pinia.use(({ store, options }) => ...)`，每个 store 创建时执行一次；
+ * - `store.$subscribe(cb, { detached: true, flush: 'sync' })` 监听状态变更（官方示例即用于持久化）；
+ * - `store.$patch(saved)` 水合；
+ * - 声明合并 `DefineStoreOptionsBase`，让 setup store 第三参可写 `{ persist: {...} }`；
+ * - 声明合并 `PiniaCustomProperties`，为每个 store 注入 `$persist()` / `$hydrate()`。
+ *
+ * 读写快慢分离：
+ * - 读（水合）同步：一次小文档读取，换取首帧不出现空表；
+ * - 写（落库）异步 + 防抖：交互路径不阻塞 UI；
+ * - 退出兜底同步：宿主 onPluginOut（含进程被杀）时走同步写，避免丢掉防抖窗口内的最后一次改动。
+ *
+ * 快照模式：一个 store 一个文档，_id = 'store:{key}'（key 默认 store.$id）。
+ * 无宿主（pnpm dev 浏览器）时由 api/db 退化为内存 Map，零磁盘 IO。
+ */
+import type { PiniaPlugin, StateTree, StoreGeneric, _ActionsTree, _GettersTree } from 'pinia';
+import * as dbApi from '../../api/db';
+
+/** 快照文档集合名（_id 前缀） */
+const COLLECTION = 'store';
+
+/** 默认写库防抖毫秒：合并同一批变更，避免每改一个字段就写一次库 */
+const DEFAULT_DEBOUNCE = 200;
+
+/**
+ * 已接管持久化的 store 的「同步 flush」函数集合。
+ * pinia 4 没有 $onDisposed 钩子，且本应用的 store 与实例同生命周期，因此不做注销清理。
+ */
+const flushers = new Set<() => void>();
+
+/** 单个 store 的持久化配置 */
+export interface PersistOptions {
+  /** 快照文档 key，默认 store.$id */
+  key?: string;
+  /** 只持久化这些 state 字段，缺省全量 */
+  pick?: string[];
+  /** 写库防抖毫秒，0 表示立即写 */
+  debounce?: number;
+  /** 水合前钩子 */
+  beforeHydrate?: (store: StoreGeneric) => void;
+  /** 水合后钩子 */
+  afterHydrate?: (store: StoreGeneric) => void;
+}
+
+/** 插件全局配置 */
+export interface ZtoolsPersistOptions {
+  /** 未声明 persist 的 store 是否也持久化，默认 false（显式 opt-in） */
+  auto?: boolean;
+  /** 各 store 共用的默认配置 */
+  defaults?: Omit<PersistOptions, 'key'>;
+}
+
+declare module 'pinia' {
+  /** 让 defineStore 的 options（含 setup store 第三参）支持 persist 配置 */
+  export interface DefineStoreOptionsBase<S extends StateTree, Store> {
+    /** true = 全量持久化；对象 = 精细配置；false / 缺省 = 不持久化 */
+    persist?: boolean | PersistOptions;
+  }
+
+  /** 插件为每个 store 注入的方法 */
+  export interface PiniaCustomProperties<
+    Id extends string = string,
+    S extends StateTree = StateTree,
+    G = _GettersTree<S>,
+    A = _ActionsTree,
+  > {
+    /** 立即把当前 state 快照异步写库（取消防抖） */
+    $persist: () => Promise<void>;
+    /** 从库同步重新水合 state（等价「刷新」） */
+    $hydrate: () => void;
+  }
+}
+
+/** 把所有受管 store 的待写快照同步落库（宿主退出 / 进程被杀前调用） */
+export function flushPersistedStores(): void {
+  for (const flush of flushers) flush();
+}
+
+/** reactive 代理 → 纯 JSON 对象（宿主文档库只接受可 JSON 化的数据） */
+function snapshot(state: StateTree, pick?: string[]): Record<string, unknown> {
+  const picked: Record<string, unknown> = {};
+  for (const key of pick && pick.length > 0 ? pick : Object.keys(state)) {
+    if (key in state) picked[key] = state[key];
+  }
+  return JSON.parse(JSON.stringify(picked)) as Record<string, unknown>;
+}
+
+/** 创建持久化插件：`pinia.use(createZtoolsPersist())` */
+export function createZtoolsPersist(config: ZtoolsPersistOptions = {}): PiniaPlugin {
+  return ({ store, options: storeOptions }) => {
+    const declared = storeOptions.persist;
+    if (declared === false) return;
+    if (!declared && !config.auto) return;
+
+    const settings: PersistOptions = {
+      ...config.defaults,
+      ...(typeof declared === 'object' ? declared : {}),
+    };
+    const key = settings.key ?? store.$id;
+    const wait = settings.debounce ?? DEFAULT_DEBOUNCE;
+
+    let timer: ReturnType<typeof setTimeout> | null = null;
+    /** 水合期间的 $patch 会触发订阅，用该标记避免把刚读出来的数据又写回去 */
+    let hydrating = false;
+
+    const cancelTimer = (): void => {
+      if (timer) {
+        clearTimeout(timer);
+        timer = null;
+      }
+    };
+
+    /** 异步写库：交互路径 */
+    const persist = (): Promise<void> => {
+      cancelTimer();
+      return dbApi.putDoc(COLLECTION, key, snapshot(store.$state, settings.pick));
+    };
+
+    /** 同步写库：退出路径，进程被杀也来得及落地 */
+    const persistSync = (): void => {
+      cancelTimer();
+      dbApi.putDocSync(COLLECTION, key, snapshot(store.$state, settings.pick));
+    };
+
+    /** 水合：同步读库并 $patch 回 state */
+    const hydrate = (): void => {
+      hydrating = true;
+      settings.beforeHydrate?.(store);
+      try {
+        const saved = dbApi.getDocSync<StateTree>(COLLECTION, key);
+        if (saved) store.$patch(saved);
+      } finally {
+        hydrating = false;
+        settings.afterHydrate?.(store);
+      }
+    };
+
+    // detached：插件级订阅不随组件卸载而注销
+    // flush: 'sync'：回调与变更同步执行，水合期的 hydrating 守卫才有效（否则会把刚读出的数据又写回一次）
+    store.$subscribe(
+      () => {
+        if (hydrating) return;
+        cancelTimer();
+        if (wait <= 0) {
+          void persist();
+          return;
+        }
+        timer = setTimeout(() => {
+          timer = null;
+          void persist();
+        }, wait);
+      },
+      { detached: true, flush: 'sync' }
+    );
+
+    hydrate();
+    flushers.add(persistSync);
+
+    return { $persist: persist, $hydrate: hydrate };
+  };
+}
diff --git a/plugins/link-relay/src/store/types/group.ts b/plugins/link-relay/src/store/types/group.ts
new file mode 100644
index 000000000..243988643
--- /dev/null
+++ b/plugins/link-relay/src/store/types/group.ts
@@ -0,0 +1,29 @@
+/**
+ * 分组表 —— 实体与 CRUD 入参（1:1 对应 groupStore.ts）。
+ * 分组可为空：不预置固定组，组 id 由 uuid v4 生成。
+ */
+
+/** 分组实体（VO） */
+export interface GroupVO {
+  /** 主键，uuid v4 */
+  id: string;
+  /** 组显示名 */
+  name: string;
+  /** 整组开关，停用只灰显不删数据 */
+  enabled: boolean;
+  /** 创建时间 ISO */
+  createdAt: string;
+}
+
+/** C：新增入参（id / createdAt 由服务端或本地生成） */
+export type GroupCreateDTO = Pick<GroupVO, 'name'>;
+
+/** U：更新入参（改名 / 整组启停） */
+export type GroupUpdateDTO = Partial<Pick<GroupVO, 'name' | 'enabled'>>;
+
+/** R：查询入参 */
+export interface GroupQueryDTO {
+  /** 名称模糊匹配 */
+  name?: string;
+  enabled?: boolean;
+}
diff --git a/plugins/link-relay/src/store/types/index.ts b/plugins/link-relay/src/store/types/index.ts
new file mode 100644
index 000000000..f1dce1736
--- /dev/null
+++ b/plugins/link-relay/src/store/types/index.ts
@@ -0,0 +1,7 @@
+/**
+ * store/types —— store 层实体出口（barrel）。
+ * 1:1 对应：log.ts ↔ logStore.ts、mapping.ts ↔ mappingStore.ts、group.ts ↔ groupStore.ts。
+ */
+export * from './log';
+export * from './mapping';
+export * from './group';
diff --git a/plugins/link-relay/src/store/types/log.ts b/plugins/link-relay/src/store/types/log.ts
new file mode 100644
index 000000000..ebfd6a8a7
--- /dev/null
+++ b/plugins/link-relay/src/store/types/log.ts
@@ -0,0 +1,71 @@
+/** 日志级别 */
+export type LogLevel = 'info' | 'success' | 'warn' | 'error';
+
+/** 操作动作：纯动词，跨资源统一，新增资源无需扩枚举 */
+export const LogAction = {
+  /** 新增 */
+  Create: 'create',
+  /** 修改 */
+  Update: 'update',
+  /** 删除 */
+  Delete: 'delete',
+  /** 启停开关 */
+  Toggle: 'toggle',
+  /** 执行迁移 */
+  Migrate: 'migrate',
+  /** 重建链接 */
+  Relink: 'relink',
+  /** 修复链接 */
+  Repair: 'repair',
+  /** 失败回滚 */
+  Rollback: 'rollback',
+} as const;
+export type LogAction = (typeof LogAction)[keyof typeof LogAction];
+
+/** 操作对象：资源域，与 store 一一对应 */
+export const LogResource = {
+  /** 迁移目录配置行 */
+  Mapping: 'mapping',
+  /** 分组 */
+  Group: 'group',
+  /** 全局设置 */
+  Setting: 'setting',
+  /** 系统级（启动、整表刷新、批量任务） */
+  System: 'system',
+} as const;
+export type LogResource = (typeof LogResource)[keyof typeof LogResource];
+
+/** 日志实体（VO） */
+export interface LogVO {
+  /** 主键，uuid v4 */
+  id: string;
+  /** 操作对象 */
+  resource: LogResource;
+  /** 操作对象主键，空串表示无关联对象（系统级日志） */
+  resourceId: string;
+  /** 冗余对象名，空串表示无；对象删除后日志仍可读 */
+  resourceName: string;
+  /** 操作动作 */
+  action: LogAction;
+  /** 级别 */
+  level: LogLevel;
+  /** 信息 */
+  message: string;
+  /** 发生时间 ISO：展示与落库用 */
+  createdAt: string;
+  /** 发生时间毫秒时间戳：排序与耗时计算用，与 createdAt 同源生成 */
+  timestamp: number;
+}
+
+/** C：新增入参（id / createdAt / timestamp 由服务端或本地生成） */
+export type LogCreateDTO = Pick<LogVO, 'resource' | 'action' | 'level' | 'message'> & Partial<Pick<LogVO, 'resourceId' | 'resourceName'>>;
+
+/** R：查询入参 */
+export interface LogQueryDTO {
+  resource?: LogResource;
+  resourceId?: string;
+  action?: LogAction;
+  level?: LogLevel;
+  /** 返回条数上限 */
+  limit?: number;
+}
diff --git a/plugins/link-relay/src/store/types/mapping.ts b/plugins/link-relay/src/store/types/mapping.ts
new file mode 100644
index 000000000..57e375fdc
--- /dev/null
+++ b/plugins/link-relay/src/store/types/mapping.ts
@@ -0,0 +1,61 @@
+/** 链接状态 */
+export type LinkStatus =
+  | 'linked' // 已链接且指向正确
+  | 'notLinked' // 未迁移，源为实体目录
+  | 'broken' // 链接断裂或指向错误
+  | 'conflict' // 源与目标都有实体目录
+  | 'targetOnly' // 源不存在、目标有数据
+  | 'notInstalled' // 源目录本机不存在
+  | 'unknown'; // 无法判定
+
+/** 配置行实体（VO） */
+export interface MappingVO {
+  /** 主键，uuid v4 */
+  id: string;
+  /** 显示名 */
+  name: string;
+  /** 所属分组 id，空串表示未分组 */
+  groupId: string;
+  /** 源目录 */
+  sourcePath: string;
+  /** 目标目录 */
+  targetPath: string;
+  /** 关联进程检测名 */
+  exeNames: string[];
+  /** 缓存排除目录名 */
+  cachePatterns: string[];
+  /** 是否参与一键迁移 */
+  enabled: boolean;
+  /** 实时链接状态 */
+  status: LinkStatus;
+  /** 可释放空间（字节），linked 为 0 */
+  sizeBytes: number;
+  /** 上次成功迁移时间 ISO，空串表示从未迁移 */
+  lastMigratedAt: string;
+  /** 上次失败原因，空串表示无 */
+  lastError: string;
+  /** 创建时间 ISO */
+  createdAt: string;
+}
+
+/** C：新增入参 */
+export type MappingCreateDTO = Pick<MappingVO, 'name' | 'sourcePath' | 'targetPath'> &
+  Partial<Pick<MappingVO, 'groupId' | 'exeNames' | 'cachePatterns'>>;
+
+/**
+ * U：更新入参。
+ * - 用户可编辑列来自 CreateDTO 与 enabled；
+ * - status/sizeBytes/lastMigratedAt/lastError 为扫描/迁移流程内部回写的系统列，
+ *   仅允许业务 hook 更新，不在新增表单中出现。
+ */
+export type MappingUpdateDTO = Partial<MappingCreateDTO> &
+  Partial<Pick<MappingVO, 'enabled' | 'status' | 'sizeBytes' | 'lastMigratedAt' | 'lastError'>>;
+
+/** R：查询入参 */
+export interface MappingQueryDTO {
+  groupId?: string;
+  status?: LinkStatus;
+  enabled?: boolean;
+  /** 名称模糊匹配 */
+  keyword?: string;
+}
diff --git a/plugins/link-relay/src/styles/base.scss b/plugins/link-relay/src/styles/base.scss
new file mode 100644
index 000000000..6631054eb
--- /dev/null
+++ b/plugins/link-relay/src/styles/base.scss
@@ -0,0 +1,290 @@
+// ════════════════════════════════════════════════════════════
+// 基础通用样式
+// 工具类 + 跨组件复用的基础元素（按钮 / 标签 / 弹窗 / 进度条 / 日志 / 骨架屏）
+// 组件特有的样式仍写在各 .vue 的 <style scoped> 中
+// ════════════════════════════════════════════════════════════
+@use 'variables' as *;
+
+// ────────────── 工具类 ──────────────
+
+.mono {
+  font-family: var(--font-mono);
+  font-size: var(--fs-sm);
+  letter-spacing: -0.01em;
+}
+
+.num {
+  font-variant-numeric: tabular-nums;
+}
+
+// ────────────── 通用按钮 ──────────────
+
+.btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  border: 1px solid var(--border-strong);
+  border-radius: var(--r);
+  padding: 6px 14px;
+  font-size: var(--fs-sm);
+  color: var(--ink-2);
+  white-space: nowrap;
+  background: var(--bg);
+  transition:
+    background-color var(--t-base) var(--ease-out),
+    border-color var(--t-base) var(--ease-out),
+    color var(--t-base) var(--ease-out),
+    box-shadow var(--t-base) var(--ease-out);
+  min-height: 32px;
+
+  svg {
+    width: 14px;
+    height: 14px;
+  }
+
+  &:hover {
+    border-color: var(--ink-3);
+    color: var(--ink-1);
+  }
+
+  &.primary {
+    background: var(--accent);
+    border-color: var(--accent);
+    color: var(--on-accent);
+    font-weight: 600;
+    box-shadow: 0 1px 2px var(--glow);
+
+    &:hover {
+      background: var(--accent-hover);
+      border-color: var(--accent-hover);
+    }
+  }
+
+  &.danger {
+    color: var(--bad-ink);
+    border-color: rgba($color-bad, 0.3);
+    background: var(--bad-soft);
+
+    &:hover {
+      background: rgba($color-bad, 0.18);
+    }
+  }
+
+  &.ghost {
+    border-color: transparent;
+
+    &:hover {
+      background: var(--panel-2);
+    }
+  }
+
+  &.sm {
+    padding: 4px 10px;
+    font-size: var(--fs-xs);
+    min-height: 26px;
+  }
+
+  &:disabled {
+    opacity: 0.5;
+    cursor: not-allowed;
+  }
+}
+
+// ────────────── 状态标签 ──────────────
+
+.tag {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding: 2px 9px;
+  border-radius: var(--r-pill);
+  font-size: var(--fs-xs);
+  font-weight: 500;
+  white-space: nowrap;
+  flex-shrink: 0;
+
+  &::before {
+    content: '';
+    width: 6px;
+    height: 6px;
+    border-radius: 50%;
+    background: currentColor;
+  }
+
+  &.ok { background: var(--ok-soft); color: var(--ok-ink); }
+  &.warn { background: var(--warn-soft); color: var(--warn-ink); }
+  &.bad { background: var(--bad-soft); color: var(--bad-ink); }
+  &.info { background: var(--info-soft); color: var(--info-ink); }
+}
+
+// ────────────── 弹窗遮罩与容器 ──────────────
+
+.scrim {
+  position: fixed;
+  inset: 0;
+  background: rgba(12, 24, 23, 0.4);
+  z-index: $z-scrim;
+  backdrop-filter: blur(1px);
+  opacity: 0;
+  pointer-events: none;
+  transition: opacity var(--t-slow) var(--ease-out);
+
+  &.on {
+    opacity: 1;
+    pointer-events: auto;
+  }
+}
+
+.modal {
+  position: fixed;
+  left: 50%;
+  top: 50%;
+  transform: translate(-50%, -46%);
+  z-index: $z-modal;
+  width: min(620px, 92vw);
+  max-height: 86vh;
+  display: flex;
+  flex-direction: column;
+  background: var(--bg);
+  border-radius: 10px;
+  opacity: 0;
+  pointer-events: none;
+  transition: opacity var(--t-slow) var(--ease-out), transform var(--t-slow) var(--ease-out);
+  box-shadow: var(--shadow-modal);
+
+  &.on {
+    opacity: 1;
+    pointer-events: auto;
+    transform: translate(-50%, -50%);
+  }
+
+  > header {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    padding: var(--space-md) var(--space-lg);
+    border-bottom: 1px solid var(--border);
+    flex-shrink: 0;
+
+    h3 {
+      font-size: var(--fs-md);
+      font-weight: 650;
+      color: var(--ink-1);
+    }
+
+    .close {
+      margin-left: auto;
+      flex-shrink: 0;
+      width: 28px;
+      height: 28px;
+      padding: 0;
+      display: inline-flex;
+      align-items: center;
+      justify-content: center;
+      line-height: 1;
+    }
+  }
+
+  > .body {
+    padding: var(--space-md) var(--space-lg);
+    overflow-y: auto;
+    flex: 1;
+    min-height: 0;
+  }
+
+  > footer {
+    display: flex;
+    gap: 8px;
+    justify-content: space-between;
+    align-items: center;
+    padding: var(--space-sm) var(--space-lg);
+    border-top: 1px solid var(--border);
+    flex-shrink: 0;
+
+    .left {
+      font-size: var(--fs-xs);
+      color: var(--ink-3);
+    }
+
+    .right {
+      display: flex;
+      gap: 8px;
+    }
+  }
+}
+
+// ────────────── 进度条 ──────────────
+
+.progress-bar {
+  height: 6px;
+  border-radius: 3px;
+  background: var(--panel-2);
+  overflow: hidden;
+
+  > i {
+    display: block;
+    height: 100%;
+    background: var(--accent);
+    border-radius: 3px;
+    transition: width 0.3s var(--ease-out);
+  }
+}
+
+// ────────────── 日志终端 ──────────────
+
+.log-box {
+  background: var(--ink-1);
+  border-radius: var(--r);
+  padding: 10px 12px;
+  margin-top: 10px;
+  font-family: var(--font-mono);
+  font-size: var(--fs-xs);
+  line-height: 1.7;
+  color: #8fbfbd;
+  max-height: 140px;
+  overflow-y: auto;
+
+  .ok { color: #6fc99a; }
+  .warn { color: #e0a84e; }
+  .err { color: #e8837c; }
+}
+
+// ────────────── 骨架屏 ──────────────
+
+@keyframes skel {
+  0% { background-position: 200% 0; }
+  100% { background-position: -200% 0; }
+}
+
+.skel {
+  background: linear-gradient(90deg, var(--panel-2), #e6ebea, var(--panel-2));
+  background-size: 200% 100%;
+  animation: skel 1.4s infinite linear;
+  height: 16px;
+  border-radius: 3px;
+  margin: 8px 16px;
+}
+
+// ────────────── 响应式断点 ──────────────
+
+// 超小屏（< 480px）
+@media (max-width: $bp-xs) {
+  .modal {
+    width: 96vw;
+    max-height: 92vh;
+
+    > header,
+    > .body,
+    > footer {
+      padding-left: 12px;
+      padding-right: 12px;
+    }
+  }
+}
+
+// 平板及以下（< 768px）
+@media (max-width: $bp-sm) {
+  :root {
+    --container-padding: 10px;
+  }
+}
diff --git a/plugins/link-relay/src/styles/main.scss b/plugins/link-relay/src/styles/main.scss
new file mode 100644
index 000000000..8c0cc124f
--- /dev/null
+++ b/plugins/link-relay/src/styles/main.scss
@@ -0,0 +1,14 @@
+// ════════════════════════════════════════════════════════════
+// 全局样式统一出口
+// 引入顺序：主题变量 → 重置初始化 → 基础通用样式
+// main.ts 中只需 import 本文件即可加载全部全局样式
+// ════════════════════════════════════════════════════════════
+
+// 1. 主题变量（SCSS 变量 + :root CSS 自定义属性）
+@use 'variables';
+
+// 2. 样式重置与元素基线
+@use 'reset';
+
+// 3. 通用基础样式（工具类 / 按钮 / 标签 / 弹窗等）
+@use 'base';
diff --git a/plugins/link-relay/src/styles/reset.scss b/plugins/link-relay/src/styles/reset.scss
new file mode 100644
index 000000000..f02b2e4a9
--- /dev/null
+++ b/plugins/link-relay/src/styles/reset.scss
@@ -0,0 +1,126 @@
+// ════════════════════════════════════════════════════════════
+// 样式重置与初始化
+// 消除浏览器默认样式差异，统一元素基线行为，滚动条视觉归一
+// ════════════════════════════════════════════════════════════
+@use 'variables' as *;
+
+// ── 盒模型 & 内外边距归零 ──
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+}
+
+// ── 根元素与 body ──
+html,
+body {
+  width: 100%;
+  min-height: 100%;
+  overflow-x: hidden;
+}
+
+body {
+  background: var(--page);
+  color: var(--ink-2);
+  font-family: var(--font-sans);
+  font-size: var(--fs-base);
+  font-weight: 400;
+  line-height: 1.55;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+  text-rendering: optimizeLegibility;
+  -webkit-text-size-adjust: 100%;
+  text-size-adjust: 100%;
+}
+
+// ── 标题 / 段落：继承字号字重，不使用浏览器默认加粗阶梯 ──
+h1, h2, h3, h4, h5, h6,
+p, figure, blockquote, dl, dd {
+  font-size: inherit;
+  font-weight: inherit;
+}
+
+// ── 列表：去标记点 ──
+ul, ol {
+  list-style: none;
+}
+
+// ── 链接：继承颜色、去下划线 ──
+a {
+  color: inherit;
+  text-decoration: none;
+  -webkit-backface-visibility: hidden;
+  backface-visibility: hidden;
+}
+
+// ── 按钮 / 输入控件：继承字体，去原生边框 ──
+button,
+input,
+select,
+textarea {
+  font: inherit;
+  color: inherit;
+}
+
+button {
+  background: none;
+  border: 0;
+  cursor: pointer;
+  min-height: 28px;
+}
+
+// ── 表格：边框合并、宽度撑满 ──
+table {
+  border-collapse: collapse;
+  width: 100%;
+}
+
+// ── 媒体元素：块级、不溢出 ──
+img,
+picture,
+video,
+canvas,
+svg {
+  display: block;
+  max-width: 100%;
+  flex-shrink: 0;
+}
+
+// ── 焦点环：鼠标点击移除，键盘 Tab 保留（WCAG 2.1） ──
+:focus:not(:focus-visible) {
+  outline: none;
+}
+
+// ── 滚动条美化（WebKit） ──
+::-webkit-scrollbar {
+  width: 8px;
+  height: 8px;
+}
+::-webkit-scrollbar-track {
+  background: transparent;
+}
+::-webkit-scrollbar-thumb {
+  background: rgba($color-ink, 0.15);
+  border-radius: 4px;
+}
+::-webkit-scrollbar-thumb:hover {
+  background: rgba($color-ink, 0.25);
+}
+
+// ── 文本选中色 ──
+::selection {
+  background: var(--accent-soft-2);
+  color: var(--ink-1);
+}
+
+// ── 减少动画偏好（无障碍） ──
+@media (prefers-reduced-motion: reduce) {
+  *,
+  *::before,
+  *::after {
+    animation-duration: 0.01ms !important;
+    transition-duration: 0.01ms !important;
+  }
+}
diff --git a/plugins/link-relay/src/styles/variables.scss b/plugins/link-relay/src/styles/variables.scss
new file mode 100644
index 000000000..10670bbde
--- /dev/null
+++ b/plugins/link-relay/src/styles/variables.scss
@@ -0,0 +1,112 @@
+// ════════════════════════════════════════════════════════════
+// 全局主题变量
+// ────────────────────────────────────────────────────────────
+// 两层变量体系：
+//   1. SCSS 编译期变量（$ 前缀）：调色板原始值、断点、z-index，
+//      仅用于编译期颜色派生与媒体查询，不输出到产物；
+//   2. CSS 自定义属性（-- 前缀）：运行期主题令牌，全部挂在 :root，
+//      后期扩展暗色/自定义主题只需新增 [data-theme="xxx"] 覆盖即可。
+// ════════════════════════════════════════════════════════════
+
+// ────────────── SCSS 编译期变量 ──────────────
+
+// 基础色值（用于 rgba() 派生 soft / border 等透明度色阶）
+$color-page: #e9eeed;
+$color-ink: #102626;
+$color-accent: #176c6b;
+$color-ok: #2f7a55;
+$color-warn: #b77a16;
+$color-bad: #c0453c;
+$color-info: #4a6fa5;
+
+// 品牌主色 hover 加深值
+$accent-hover: #135e5d;
+
+// 响应式断点（与媒体查询配合使用）
+$bp-xs: 479px;   // 超小屏
+$bp-sm: 767px;   // 平板及以下
+
+// z-index 层级
+$z-scrim: 30;
+$z-modal: 31;
+$z-toast: 40;
+
+// ────────────── CSS 运行期主题令牌 ──────────────
+
+:root {
+  // ── 基底 ──
+  --page: #e9eeed;
+  --bg: #ffffff;
+  --panel-2: #f1f5f4;
+  --border: rgba($color-ink, 0.07);
+  --border-strong: rgba($color-ink, 0.13);
+
+  // ── 墨色（文字三级层级） ──
+  --ink-1: #0f2322;  // 主标题 / 强调
+  --ink-2: #3a4b4a;  // 正文
+  --ink-3: #6b7d7c;  // 辅助 / 占位
+
+  // ── 品牌色 — 深青 ──
+  --accent: #176c6b;
+  --accent-hover: #{$accent-hover};
+  --accent-soft: rgba($color-accent, 0.10);
+  --accent-soft-2: rgba($color-accent, 0.16);
+  --on-accent: #fff;
+  --glow: rgba($color-accent, 0.28);
+
+  // ── 语义色（每色三档：实心 / 文字 / 浅底） ──
+  --ok: #2f7a55;
+  --ok-ink: #1a5c3e;
+  --ok-soft: rgba($color-ok, 0.12);
+
+  --warn: #b77a16;
+  --warn-ink: #8a5a08;
+  --warn-soft: rgba($color-warn, 0.13);
+
+  --bad: #c0453c;
+  --bad-ink: #8e2a24;
+  --bad-soft: rgba($color-bad, 0.11);
+
+  --info: #4a6fa5;
+  --info-ink: #2e4f7a;
+  --info-soft: rgba($color-info, 0.11);
+
+  // ── 圆角 ──
+  --r: 6px;          // 卡片 / 按钮
+  --r-control: 4px;  // 小型控件
+  --r-pill: 999px;   // 胶囊标签
+
+  // ── 阴影 ──
+  --shadow-card: 0 1px 2px rgba(15, 35, 34, 0.04), 0 6px 16px -8px rgba(15, 35, 34, 0.08);
+  --shadow-modal: 0 2px 8px rgba(15, 35, 34, 0.06), 0 24px 56px -12px rgba(15, 35, 34, 0.22);
+
+  // ── 字体族 ──
+  --font-sans: system-ui, -apple-system, 'Segoe UI', 'PingFang SC', 'Microsoft YaHei', sans-serif;
+  --font-mono: 'JetBrains Mono', 'SF Mono', 'Cascadia Code', Consolas, 'Courier New', monospace;
+
+  // ── 流体间距（随视口缩放，无需 JS 测量） ──
+  --space-xs: clamp(4px, 0.5vw, 6px);
+  --space-sm: clamp(6px, 0.8vw, 10px);
+  --space-md: clamp(10px, 1.2vw, 16px);
+  --space-lg: clamp(14px, 1.8vw, 24px);
+  --space-xl: clamp(20px, 2.5vw, 32px);
+
+  // ── 流体排版 ──
+  --fs-xs: clamp(10.5px, 0.75vw, 11.5px);
+  --fs-sm: clamp(11.5px, 0.85vw, 12.5px);
+  --fs-base: clamp(12.5px, 0.95vw, 13.5px);
+  --fs-md: clamp(13.5px, 1.05vw, 15px);
+  --fs-lg: clamp(15px, 1.3vw, 17px);
+  --fs-xl: clamp(18px, 1.8vw, 22px);
+  --fs-2xl: clamp(22px, 2.5vw, 30px);
+
+  // ── 布局容器 ──
+  --container-max: 1280px;
+  --container-padding: clamp(12px, 2vw, 24px);
+
+  // ── 动效时长 ──
+  --t-fast: 0.12s;
+  --t-base: 0.15s;
+  --t-slow: 0.18s;
+  --ease-out: ease;
+}
diff --git a/plugins/link-relay/src/utils/enums.ts b/plugins/link-relay/src/utils/enums.ts
new file mode 100644
index 000000000..b23696975
--- /dev/null
+++ b/plugins/link-relay/src/utils/enums.ts
@@ -0,0 +1,104 @@
+/**
+ * 全局枚举与状态元数据（前端唯一事实源，与后端 core/status-enum.js 同构）。
+ * 注意：store / 前端统一使用 camelCase 状态（notLinked…），kebab 仅在 api 层与 preload 互转。
+ * 所有状态文案、色调、行操作、严重度都集中在此，便于统一维护与复用。
+ */
+import type { LinkStatus } from '../store/types/mapping';
+
+// ────────────── 链接状态 ──────────────
+
+/** 状态语义色（对应 styles/base.scss 的 .tag.ok/.warn/.bad/.info/.neutral） */
+export type StatusTone = 'ok' | 'warn' | 'bad' | 'info' | 'neutral';
+
+/** 行主操作类型 */
+export type RowActionType = 'migrate' | 'relink' | 'repair' | 'none';
+
+/** 行主操作描述（由状态纯函数推导） */
+export interface RowAction {
+  type: RowActionType;
+  /** 按钮文案 */
+  label: string;
+  /** 是否禁用 */
+  disabled: boolean;
+}
+
+interface StatusMeta {
+  /** 展示文案 */
+  label: string;
+  /** 语义色 */
+  tone: StatusTone;
+  /** 严重度（组聚合取最严重） */
+  severity: number;
+  /** 行主操作 */
+  action: RowAction;
+}
+
+const noAction: RowAction = { type: 'none', label: '—', disabled: true };
+
+export const STATUS_META: Record<LinkStatus, StatusMeta> = {
+  linked: {
+    label: '已链接', tone: 'ok', severity: 1,
+    action: { type: 'none', label: '已迁移', disabled: true },
+  },
+  notLinked: {
+    label: '待迁移', tone: 'warn', severity: 3,
+    action: { type: 'migrate', label: '迁移', disabled: false },
+  },
+  broken: {
+    label: '链接断裂', tone: 'bad', severity: 4,
+    action: { type: 'repair', label: '修复', disabled: false },
+  },
+  conflict: {
+    label: '冲突', tone: 'bad', severity: 5,
+    action: { type: 'repair', label: '修复', disabled: false },
+  },
+  targetOnly: {
+    label: '待重建', tone: 'info', severity: 2,
+    action: { type: 'relink', label: '重建链接', disabled: false },
+  },
+  notInstalled: { label: '未安装', tone: 'neutral', severity: 0, action: noAction },
+  unknown: { label: '未知', tone: 'neutral', severity: 0, action: noAction },
+};
+
+export function statusLabel(status: LinkStatus): string {
+  return STATUS_META[status]?.label ?? status;
+}
+export function statusTone(status: LinkStatus): StatusTone {
+  return STATUS_META[status]?.tone ?? 'neutral';
+}
+export function statusAction(status: LinkStatus): RowAction {
+  return STATUS_META[status]?.action ?? noAction;
+}
+export function statusSeverity(status: LinkStatus): number {
+  return STATUS_META[status]?.severity ?? 0;
+}
+
+/** 待处理：需要迁移/重建 */
+export function isPendingStatus(status: LinkStatus): boolean {
+  return status === 'notLinked' || status === 'targetOnly';
+}
+/** 异常：冲突/断裂 */
+export function isAbnormalStatus(status: LinkStatus): boolean {
+  return status === 'conflict' || status === 'broken';
+}
+
+// ────────────── 视图 / 筛选 ──────────────
+
+export const ViewModeEnum = {
+  Grouped: 'grouped',
+  Flat: 'flat',
+} as const;
+export type ViewMode = (typeof ViewModeEnum)[keyof typeof ViewModeEnum];
+
+export const FilterEnum = {
+  All: 'all',
+  Pending: 'pending',
+  Linked: 'linked',
+  Conflict: 'conflict',
+} as const;
+export type FilterKey = (typeof FilterEnum)[keyof typeof FilterEnum];
+
+/** 未分组行的 groupId（空串） */
+export const UNGROUPED_ID = '';
+/** 未分组展示名 */
+export const UNGROUPED_NAME = '未分组';
diff --git a/plugins/link-relay/src/utils/format.ts b/plugins/link-relay/src/utils/format.ts
new file mode 100644
index 000000000..7d91c4708
--- /dev/null
+++ b/plugins/link-relay/src/utils/format.ts
@@ -0,0 +1,17 @@
+/** 通用格式化纯函数：无状态、无 IO，可在任意层复用。 */
+
+/** 字节数 → 人类可读（0/负数显示 —） */
+export function formatBytes(bytes: number): string {
+  if (!bytes || bytes <= 0) return '—';
+  const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+  const i = Math.min(units.length - 1, Math.floor(Math.log(bytes) / Math.log(1024)));
+  return `${(bytes / Math.pow(1024, i)).toFixed(i >= 2 ? 1 : 0)} ${units[i]}`;
+}
+
+/** 把逗号/分号/换行分隔的文本解析为去空字符串数组（进程名、缓存目录名等） */
+export function parseLineList(text: string): string[] {
+  return text
+    .split(/[,，;；\n\r]+/)
+    .map((s) => s.trim())
+    .filter(Boolean);
+}
diff --git a/plugins/link-relay/src/views/Home.vue b/plugins/link-relay/src/views/Home.vue
new file mode 100644
index 000000000..c1425ae1f
--- /dev/null
+++ b/plugins/link-relay/src/views/Home.vue
@@ -0,0 +1,273 @@
+<script setup lang="ts">
+/**
+ * 唯一页面：内联页头 / KPI / 工具栏（不单独抽组件），只把表格与弹窗组装起来。
+ * 数据流：api（宿主能力）→ store 三张表（数据）→ hooks（业务编排）→ 本页与纯渲染组件。
+ */
+import { onMounted, onUnmounted, ref } from 'vue';
+import MappingTable from '../components/MappingTable.vue';
+import MappingDialog from '../components/MappingDialog.vue';
+import GroupDialog from '../components/GroupDialog.vue';
+import MigrateDialog from '../components/MigrateDialog.vue';
+import ProgressDialog from '../components/ProgressDialog.vue';
+import { useDashboard } from '../hooks/useDashboard';
+import { useMigration } from '../hooks/useMigration';
+import useDialog from '../hooks/useDialog';
+import * as envApi from '../api/env';
+import { FilterEnum, ViewModeEnum } from '../utils/enums';
+import type { MappingRowVM } from '../hooks/useDashboard';
+
+const dashboard = useDashboard();
+const migration = useMigration();
+const groupDialog = useDialog({ title: '分组管理' });
+
+// 模板直接使用解构后的顶层绑定（ref/computed 自动解包）
+const {
+  loading, error, filter, viewMode, selectedIds, collapsed, editorVisible,
+  visibleGroups, flatRows, kpi, filterCounts, selectedItemIds, allVisibleChecked, visibleIndeterminate, hasSelection,
+  init, refresh, setFilter, setView, toggleRow, toggleAllVisible, clearSelection, toggleCollapse,
+  openAdd, openEdit, removeMapping, createGroup, renameGroup, toggleGroup, removeGroup,
+} = dashboard;
+
+// ── 表格事件 ──
+function onRowAction(row: MappingRowVM): void {
+  void migration.runRowAction(row);
+}
+function onRemove(id: string): void {
+  if (window.confirm('仅删除这条映射配置，不会删除磁盘上的任何文件/目录。确认删除？')) removeMapping(id);
+}
+function batchMigrate(): void {
+  migration.openConfirm(selectedItemIds.value);
+}
+
+// ── 宿主窗口高度自适应（clamp 480~900） ──
+const rootRef = ref<HTMLElement | null>(null);
+let resizeObserver: ResizeObserver | null = null;
+
+// 说明：页面内部的自适应（百分比 / grid / flex / clamp / 媒体查询）全部由纯 CSS 完成，不用 JS 测量。
+// 这里唯一的 JS 是 ZTools 宿主协议——插件运行在宿主 webview 中，其外层面板像素高度只能通过
+// setExpendHeight 主动上报，CSS 无法替代。同步执行、不做动画/延时；相同高度直接跳过，避免宿主反复 resize。
+let lastHostHeight = -1;
+function syncHostHeight(): void {
+  const el = rootRef.value;
+  if (!el) return;
+  const next = Math.min(900, Math.max(480, el.scrollHeight + 32));
+  if (next === lastHostHeight) return;
+  lastHostHeight = next;
+  envApi.setViewHeight(next);
+}
+
+onMounted(async () => {
+  await init();
+  syncHostHeight();
+  // 仅监听「内容高度」变化（行数/折叠/筛选导致），视口宽度变化由 CSS 自适应，不经过这里
+  resizeObserver = new ResizeObserver(syncHostHeight);
+  if (rootRef.value) resizeObserver.observe(rootRef.value);
+  envApi.onEnter(() => {
+    void refresh();
+  });
+});
+
+onUnmounted(() => {
+  resizeObserver?.disconnect();
+});
+</script>
+
+<template>
+  <div ref="rootRef" class="page">
+    <!-- 页头 -->
+    <header class="page-head">
+      <div class="ph-left">
+        <h1 class="ph-title">目录迁移助手</h1>
+        <span class="ph-sub">把系统盘目录迁移到其他盘，以 Junction 链接保持程序无感知运行</span>
+      </div>
+      <div class="ph-actions">
+        <button class="btn ghost" @click="groupDialog.openDialog()">分组管理</button>
+        <button class="btn ghost" :disabled="loading" @click="refresh">
+          <span class="ico-refresh" :class="{ spinning: loading }">↻</span> 刷新
+        </button>
+        <button class="btn primary" @click="openAdd()">＋ 添加映射</button>
+      </div>
+    </header>
+
+    <!-- KPI -->
+    <section class="kpi-row">
+      <div class="kpi-card">
+        <span class="kpi-label">全部目录</span>
+        <span class="kpi-value num">{{ kpi.total }}</span>
+      </div>
+      <div class="kpi-card ok">
+        <span class="kpi-label">已迁移</span>
+        <span class="kpi-value num">{{ kpi.linked }}</span>
+      </div>
+      <div class="kpi-card warn">
+        <span class="kpi-label">待处理</span>
+        <span class="kpi-value num">{{ kpi.pending + kpi.conflict }}</span>
+      </div>
+      <div class="kpi-card accent">
+        <span class="kpi-label">预计节省 C 盘</span>
+        <span class="kpi-value num">{{ kpi.saveSizeFormatted }}</span>
+      </div>
+    </section>
+
+    <!-- 工具栏 -->
+    <section class="toolbar">
+      <div class="tb-left">
+        <div class="seg">
+          <button :class="{ active: viewMode === ViewModeEnum.Grouped }" @click="setView(ViewModeEnum.Grouped)">按组</button>
+          <button :class="{ active: viewMode === ViewModeEnum.Flat }" @click="setView(ViewModeEnum.Flat)">平铺</button>
+        </div>
+      </div>
+
+      <div class="tb-right">
+        <div class="filters">
+          <button
+            v-for="f in [
+              { key: FilterEnum.All, label: '全部' },
+              { key: FilterEnum.Pending, label: '待处理' },
+              { key: FilterEnum.Linked, label: '已迁移' },
+              { key: FilterEnum.Conflict, label: '异常' },
+            ]"
+            :key="f.key"
+            class="chip"
+            :class="{ active: filter === f.key }"
+            @click="setFilter(f.key)"
+          >
+            {{ f.label }}
+            <span class="chip-count num">{{ filterCounts[f.key] }}</span>
+          </button>
+        </div>
+
+        <label v-if="hasSelection" class="batch-bar">
+          <span class="num">已选 {{ selectedIds.size }}</span>
+          <button class="btn sm primary" @click="batchMigrate">批量迁移</button>
+          <button class="btn sm ghost" @click="clearSelection">取消选择</button>
+        </label>
+      </div>
+    </section>
+
+    <!-- 表格 -->
+    <MappingTable
+      :groups="visibleGroups"
+      :flat-rows="flatRows"
+      :view-mode="viewMode"
+      :collapsed="collapsed"
+      :selected="selectedIds"
+      :loading="loading"
+      :error="error"
+      :all-checked="allVisibleChecked"
+      :indeterminate="visibleIndeterminate"
+      @select="toggleRow"
+      @select-all="toggleAllVisible"
+      @toggle-group="toggleCollapse"
+      @group-add="openAdd"
+      @row-action="onRowAction"
+      @edit="openEdit"
+      @remove="onRemove"
+      @retry="refresh"
+    />
+
+    <!-- 弹窗 -->
+    <MappingDialog :open="editorVisible" />
+
+    <GroupDialog
+      :open="groupDialog.visible.value"
+      :groups="dashboard.groups.value"
+      @close="groupDialog.closeDialog()"
+      @create="createGroup"
+      @rename="renameGroup"
+      @toggle="toggleGroup"
+      @remove="removeGroup"
+    />
+
+    <MigrateDialog
+      :open="migration.confirmVisible.value"
+      :preview="migration.preview.value"
+      @close="migration.closeConfirm()"
+      @confirm="(o) => void migration.confirmMigrate(o)"
+    />
+
+    <ProgressDialog
+      :open="migration.progressVisible.value"
+      :running="migration.running.value"
+      :preview="migration.preview.value"
+      :logs="migration.runLogs.value"
+      :current-phase="migration.currentPhase.value"
+      :current-item="migration.currentItem.value"
+      :progress-info="migration.progressInfo.value"
+      @close="migration.closeProgress()"
+      @cancel="migration.cancelMigration()"
+    />
+  </div>
+</template>
+
+<style scoped>
+.page {
+  /* 纯 CSS 流体：横向内边距随视口百分比缩放，无 JS 测量 */
+  padding: clamp(12px, 2.2vh, 20px) clamp(12px, 2vw, 24px) clamp(16px, 2.6vh, 24px);
+  display: flex; flex-direction: column; gap: clamp(10px, 1.4vw, 14px);
+  width: 100%; max-width: 1180px; margin: 0 auto;
+}
+
+/* 页头 */
+.page-head { display: flex; align-items: flex-end; justify-content: space-between; gap: 16px; flex-wrap: wrap; }
+.ph-left { display: flex; flex-direction: column; gap: 3px; }
+.ph-title { font-size: var(--fs-xl); font-weight: 750; color: var(--ink-1); letter-spacing: -0.01em; }
+.ph-sub { font-size: var(--fs-xs); color: var(--ink-3); }
+.ph-actions { display: flex; gap: 8px; align-items: center; flex-wrap: wrap; }
+.ico-refresh { display: inline-block; }
+.ico-refresh.spinning { animation: spin 0.9s linear infinite; }
+@keyframes spin { to { transform: rotate(360deg); } }
+
+/* KPI */
+.kpi-row {
+  display: grid;
+  /* min(150px,100%) 保证极窄屏不溢出；列数与列宽纯由容器宽度决定 */
+  grid-template-columns: repeat(auto-fit, minmax(min(150px, 100%), 1fr));
+  gap: clamp(8px, 1vw, 10px);
+}
+.kpi-card {
+  background: var(--bg); border: 1px solid var(--border); border-radius: var(--r);
+  padding: clamp(10px, 1.4vw, 13px) clamp(12px, 1.6vw, 16px);
+  display: flex; flex-direction: column; gap: 4px;
+  box-shadow: var(--shadow-card); position: relative; overflow: hidden;
+}
+.kpi-card::before { content: ''; position: absolute; left: 0; top: 0; bottom: 0; width: 3px; background: var(--ink-3); opacity: 0.35; }
+.kpi-card.ok::before { background: var(--ok-ink); }
+.kpi-card.warn::before { background: var(--warn-ink); }
+.kpi-card.accent::before { background: var(--accent); }
+.kpi-label { font-size: var(--fs-xs); color: var(--ink-3); }
+.kpi-value { font-size: var(--fs-xxl); font-weight: 750; color: var(--ink-1); line-height: 1.1; }
+
+/* 工具栏 */
+.toolbar { display: flex; align-items: center; justify-content: space-between; gap: 12px; flex-wrap: wrap; }
+.tb-left { display: flex; align-items: center; gap: 12px; flex-wrap: wrap; }
+.filters { display: flex; gap: 6px; flex-wrap: wrap; }
+.chip {
+  display: inline-flex; align-items: center; gap: 6px;
+  padding: 5px 12px; border-radius: var(--r-pill); font-size: var(--fs-sm);
+  border: 1px solid var(--border-strong); background: var(--bg); color: var(--ink-2);
+  /* 只过渡颜色，不过渡布局属性，缩放即时无补间 */
+  transition: background-color 0.12s ease, border-color 0.12s ease, color 0.12s ease;
+}
+.chip:hover { border-color: var(--accent); color: var(--accent-ink); }
+.chip.active { background: var(--accent); border-color: var(--accent); color: #fff; }
+.chip-count { font-size: 11px; opacity: 0.75; }
+.tb-right { display: flex; align-items: center; gap: 12px; flex-wrap: wrap; }
+.batch-bar { display: inline-flex; align-items: center; gap: 8px; font-size: var(--fs-sm); color: var(--ink-2); }
+.seg { display: inline-flex; border: 1px solid var(--border-strong); border-radius: var(--r-control); overflow: hidden; }
+.seg button { padding: 5px 12px; font-size: var(--fs-sm); background: var(--bg); color: var(--ink-2); }
+.seg button + button { border-left: 1px solid var(--border-strong); }
+.seg button.active { background: var(--accent-soft); color: var(--accent-ink); font-weight: 600; }
+
+@media (max-width: 767px) {
+  .page { padding: 14px 12px 20px; }
+  .page-head { align-items: stretch; }
+  .ph-actions { width: 100%; }
+  .ph-actions .btn { flex: 1; }
+}
+@media (max-width: 479px) {
+  .kpi-row { grid-template-columns: repeat(2, 1fr); }
+  .toolbar { align-items: stretch; }
+  .tb-left, .tb-right { width: 100%; justify-content: space-between; }
+}
+</style>
diff --git a/plugins/link-relay/tsconfig.json b/plugins/link-relay/tsconfig.json
new file mode 100644
index 000000000..8f08af44d
--- /dev/null
+++ b/plugins/link-relay/tsconfig.json
@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "module": "ESNext",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "preserve",
+    "strict": true,
+    "noImplicitAny": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "forceConsistentCasingInFileNames": true,
+    "types": ["@ztools-center/ztools-api-types"]
+  },
+  "include": ["src"]
+}
diff --git a/plugins/link-relay/vite.config.js b/plugins/link-relay/vite.config.js
new file mode 100644
index 000000000..2752ef4b3
--- /dev/null
+++ b/plugins/link-relay/vite.config.js
@@ -0,0 +1,26 @@
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import { resolve, dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+
+// ZTools 插件构建配置
+export default defineConfig({
+  plugins: [vue()],
+  base: './',
+  resolve: {
+    alias: {
+      '@': resolve(__dirname, 'src'),
+    },
+  },
+  // 开发服务器配置
+  server: {
+    port: 5173,
+    strictPort: true,
+  },
+  build: {
+    outDir: resolve(__dirname, 'dist'),
+    emptyOutDir: true,
+  },
+});