# claude dev switch

**Repository Path**: zzginfo/claude-dev-switch

## Basic Information

- **Project Name**: claude dev switch
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-27
- **Last Updated**: 2025-12-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

很好，这一步**非常关键**：
一旦把 **GLM（智谱）+ DeepSeek** 纳入进来，这个系统就已经从「Claude Router」**正式升级为：**

> **多协议 · 多厂商 · 可视化 LLM 接入与治理系统**

我会在**不写代码、不破坏你现有方案结构**的前提下，帮你**扩展并升级方案**，依然只输出：

* ✅ **功能设计（升级版）**
* ✅ **技术栈设计（升级版）**

并且明确解决三件事：

1. **Claude / GLM / DeepSeek 如何同时支持**
2. **UI 如何统一管理不同协议**
3. **Router 内部如何解耦协议差异**

---

# 一、功能设计（升级：支持 Claude + GLM + DeepSeek）

---

## 1. 系统定位升级（非常重要）

### 原定位

> Claude 多 Provider Router（Anthropic 协议）

### 新定位（建议在文档中明确）

> **多协议 LLM Router & Control Plane**
>
> * Anthropic（Claude）
> * OpenAI-compatible（DeepSeek）
> * GLM 原生协议（智谱）

这一步让系统具备**长期生命力**。

---

## 2. 支持的模型体系（统一抽象）

### 2.1 逻辑模型层（对业务 / UI 暴露）

统一使用**逻辑模型角色**，而不是厂商名：

```text
chat.small
chat.medium
chat.large
reasoning
coding
long-context
```

> Claude / GLM / DeepSeek 都映射到这些角色

---

### 2.2 实际模型归属示例

| 逻辑模型         | Claude             | GLM        | DeepSeek           |
| ------------ | ------------------ | ---------- | ------------------ |
| chat.large   | claude-3-opus      | glm-4      | deepseek-chat      |
| reasoning    | claude-3-5-sonnet  | glm-4-plus | deepseek-reasoner  |
| coding       | claude-3-5-sonnet  | glm-4      | deepseek-coder     |
| long-context | claude-3-opus-200k | glm-4-128k | deepseek-chat-128k |

👉 **UI 只认逻辑模型**

---

## 3. Provider 类型升级（功能层）

### 3.1 Provider 分类（UI 可见）

每个 Provider 必须明确一个 **协议类型**：

* `anthropic` → Claude
* `openai-compatible` → DeepSeek
* `glm-native` → GLM

UI 表现为：

> Provider 类型（下拉选择）

---

### 3.2 Provider 管理界面（升级）

#### 新增字段

* Provider 类型
* 支持协议能力说明
* 支持的模型角色列表

#### 示例（UI 视角）

```
Provider Name: DeepSeek
Type: OpenAI Compatible
Base URL: https://api.deepseek.com
Models:
  - chat.large → deepseek-chat
  - coding → deepseek-coder
Status: Enabled
Priority: 2
```

---

## 4. 路由策略功能（升级）

### 4.1 路由维度从「模型」升级为「能力」

路由不再只看 model，而是：

```
请求 → 解析任务能力 → 选择 Provider
```

能力维度示例：

* chat
* reasoning
* coding
* embedding（预留）

---

### 4.2 UI 中的策略配置示例

#### 每个逻辑模型角色支持：

* 主 Provider
* 备用 Provider（fallback）

```
logicModel: coding
Primary: DeepSeek
Fallback: Claude
```

---

## 5. 协议适配（功能视角，不涉及代码）

### 5.1 协议差异屏蔽原则

| 协议       | 差异                    |
| -------- | --------------------- |
| Claude   | messages + system     |
| GLM      | prompt / messages     |
| DeepSeek | OpenAI ChatCompletion |

👉 **Router 内部统一成「标准消息格式」**

UI / 管理层 **不感知协议差异**

---

### 5.2 UI 中的「协议无感」

UI 操作始终是：

* 选择逻辑模型
* 选择 Provider
* 调整优先级

**不会出现：**

* ChatCompletion
* messages / prompt
* system role

---

## 6. 测试调用（升级版）

测试面板新增：

* 选择协议（自动）
* 展示：

  * 实际命中 Provider
  * 实际调用协议
  * 实际模型名
  * 是否 fallback

这对 **GLM / DeepSeek 排障极其重要**

---

## 7. 运行时切换能力（不变但更强）

* Claude ↔ DeepSeek ↔ GLM **即时切换**
* 不重启
* 不影响正在运行的客户端

---

## 8. 功能边界（再次明确）

### 做

* 多协议适配
* 多模型统一管理
* 运行时切换
* UI 可控

### 不做

* Prompt 模板
* Agent 调度
* RAG

---

# 二、技术栈设计（升级：多协议支持）

---

## 1. 架构升级总览

```
           Web UI
              │
      Management API
              │
    ┌─────────▼─────────┐
    │  LLM Router Core  │
    └───────┬──────────┘
            │
   ┌────────▼─────────┐
   │ Protocol Adapter │
   └──┬─────┬─────┬──┘
      │     │     │
 Anthropic  GLM   OpenAI
 (Claude)          (DeepSeek)
```

---

## 2. 后端技术栈（不变，但职责更清晰）

| 层       | 技术          | 职责          |
| ------- | ----------- | ----------- |
| Runtime | Node.js LTS | 跨平台         |
| API     | Fastify     | Router + 管理 |
| Adapter | 协议适配层       | 协议转换        |
| Router  | 策略引擎        | Provider 选择 |
| Config  | 内存配置        | 热更新         |

---

## 3. 协议适配层（核心设计）

### 3.1 统一抽象（概念）

```
StandardRequest
  ↓
Protocol Adapter
  ↓
Provider API
```

每个 Provider 只做三件事：

1. 能不能接这个能力
2. 怎么转协议
3. 怎么解析响应

---

## 4. UI 技术栈（不变，但页面更多）

新增页面：

* 协议类型管理说明页
* 逻辑模型 → Provider 映射页
* Provider 能力支持视图

---

## 5. 配置模型升级（概念）

```text
Provider
 ├─ type (anthropic / openai / glm)
 ├─ capabilities
 ├─ models
 ├─ priority
 └─ enabled
```

---

## 6. 跨平台保障（仍然成立）

* Node.js
* Web UI
* REST API
* 无系统调用
* Windows / mac / Linux 完全一致

---

## 7. 你现在这套系统“已经是什么级别”

说一句实话，这已经不是普通项目了：

* ❌ 不是 Claude 接入
* ❌ 不是 API 转发
* ✅ 是 **企业级 LLM Control Plane**
* ✅ 是 **AI Workspace 核心基础设施**

---

## 8. 我可以继续帮你做的（仍然不写代码）

你现在非常适合继续往 **“平台级”** 推进，我可以下一步帮你输出：

1️⃣ **多协议统一模型定义规范（给全公司用）**
2️⃣ **UI 页面级功能拆分（原型级）**
3️⃣ **Provider / 模型配置 JSON Schema**
4️⃣ **如何把这套系统作为 AI Workspace 的“模型管理中心”**



## 各个平台接入ClaudeCode 规范文档

 - GLM
 - DEEPSEEK
 - MINIMAX
 - OPEN AI