# GO-DESK-9: 插件系统

> 状态：Phase 0 已实施完成，待推进 Phase 1
> 创建日期：2026-05-01
> 前置文档：`../../02-架构设计/插件化架构方案.md`（初版调研）

---

## 一、背景与动机

### 1.1 当前痛点

| 痛点 | 现状 | 影响 |
|------|------|------|
| **app.go God Object** | 825 行，47 个方法全在一个 struct 上 | 难以维护，新功能必须改核心文件 |
| **App.vue 硬编码映射** | `getComponent()` 只有 2 个 key 的字面量对象 | 新 Tab 必须改源码 |
| **FileEditorPanel if/else 链** | 10 层 v-if/v-else-if | 新增文件类型需改 5+ 处 |
| **前后端配置断层** | 后端定义 3 个 Tab，前端硬编码只保留 file-system | 新 Tab 无法透传到前端 |
| **无扩展机制** | 所有功能编译时固定 | 无法按需加载，安装包膨胀 |

### 1.2 目标

建立**两层插件体系**（内置 + 外部市场），使 u-desk 从"单体应用"演进为**可扩展平台**。

## 二、文档结构

```
GO-DESK-9.插件系统/
├── README.md                  ← 本文件（总览）
├── 设计文档/
│   ├── 架构设计.md            ← 系统形态、两层体系、设置面板原型
│   ├── 接口定义.md            ← Go 后端 + TS 前端完整接口
│   ├── 数据模型.md            ← plugin_state 表 DDL 与存储策略
│   └── 复杂度与价值评估.md     ← 投入产出分析 + 远期风险预警
├── 任务规划/
│   ├── 实施路线图.md          ← Phase 0~5 全景时间线与范围
│   └── Phase0-基础设施.md     ← Phase 0 详细步骤与验证标准
└── 决策记录/
    └── README.md              ← 关键技术决策（adapter 模式等）
```

## 三、快速导航

| 如果你想看 | 去哪里 |
|-----------|--------|
| 系统长什么样 | `设计文档/架构设计.md` |
| UI 插槽怎么切 | `设计文档/架构设计.md` → 第四章 |
| 接口怎么定义的 | `设计文档/接口定义.md` |
| 数据库存什么 | `设计文档/数据模型.md` |
| 复杂度值不值 | `设计文档/复杂度与价值评估.md` |
| 分几步做、每步做什么 | `任务规划/实施路线图.md` |
| Phase 0 具体怎么动手 | `任务规划/Phase0-基础设施.md` |
| 为什么选这个方案不选那个 | `决策记录/README.md` |

## 四、里程碑概览

```
Phase 0  ████████████  基础设施骨架（当前目标）
Phase 1  ████          Draw.io 验证插件
Phase 2  █████████████  预览系统重构
Phase 3  █████████████  Tab 插件化 + 设置面板 + UI 插槽
Phase 4  ██████        外部插件支持
Phase 5  ░░░░░░░░░░░░░  插件市场（远景）
```

每个 Phase 可独立交付验证。
