Agentswarm/desktop-client/README.md

HeiCode Swarm 桌面客户端

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

环境要求

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

安装与开发

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. 运行完成后，聚合各结果分支并在结果视图中呈现最终交付物。