# HeiCode Swarm 桌面客户端

基于 **Electron + React + TypeScript** 的桌面客户端，是蜂群系统面向用户的入口。它负责提交任务、连接并展示 Orchestrator 的运行状态，分析任务复杂度以推荐 Agent 数量，并对生成结果进行聚合与查看。

## 环境要求

- Node.js 18+ 与 npm
- 可访问的 Kubernetes 集群与有效的 kubeconfig（如使用 K8s 调度）
- 已正确配置的 kubectl

## 安装与开发

```bash
npm install      # 安装依赖
npm run build    # 编译 TypeScript
npm run dev      # 开发模式启动
npm run type-check
npm run lint
```

## 配置

应用按以下顺序加载 kubeconfig：
1. 环境变量 `KUBECONFIG`（若设置）
2. 默认位置 `~/.kube/config`

请确保 kubeconfig 指向正确的集群且凭据有效。

## 目录结构

```
desktop-client/
├── src/
│   ├── main.ts                  # Electron 主进程
│   ├── App.tsx                  # React 根组件
│   ├── index.html               # 入口页面
│   ├── api/
│   │   └── orchestrator-client.ts   # 调用 Orchestrator REST 接口
│   ├── ai/                      # 任务复杂度分析（见该目录 README）
│   ├── components/              # 界面组件
│   │   ├── TaskSubmissionForm.tsx   # 任务提交
│   │   ├── AgentDashboard.tsx       # Agent 与运行状态看板
│   │   ├── ResultViewer.tsx         # 结果查看
│   │   └── CostControlDialog.tsx    # 成本/规模确认
│   ├── analytics/usage-tracker.ts   # 用量统计
│   ├── git/                     # Git 工作区与分支合并
│   │   ├── workspace-manager.ts
│   │   └── merge-manager.ts
│   └── k8s/                     # K8s 接入
│       ├── kubeconfig-loader.ts     # 鉴权/集群配置加载
│       └── auto-scaler.ts           # 按复杂度自动伸缩 Agent 规模
├── package.json
├── tsconfig.json
└── tailwind.config.js
```

## 主要能力

- **任务提交**：用户输入需求后，通过 `orchestrator-client` 创建蜂群部署。
- **复杂度分析**：`ai/` 模块评估任务规模并推荐 Agent 数量（详见 `src/ai/README.md`）。
- **成本控制**：超过阈值时通过 `CostControlDialog` 提示并要求确认，避免规模失控。
- **状态展示**：`AgentDashboard` 实时展示 Agent、任务与工作流阶段。
- **结果聚合**：`git/merge-manager` 合并各 Agent 的结果分支，`ResultViewer` 统一查看。
- **弹性伸缩**：`k8s/auto-scaler` 依据复杂度分析结果调整 Agent 数量。

## 工作方式

1. 用户在客户端提交需求并（可选）查看复杂度分析与推荐规模。
2. 客户端调用 Orchestrator 创建部署，Orchestrator 分解任务并调度 Agent 执行。
3. 客户端轮询/订阅运行状态，展示阶段进度与各 Agent 产出。
4. 运行完成后，聚合各结果分支并在结果视图中呈现最终交付物。