Workspace Switch

Workspace Switch

统一管理 AI 编程助手的配置中枢 —— 在一个地方管理 **Skill**、**MCP Server**、**Provider** 和 **Project**，然后将它们分发到本机安装的所有 AI 编程工具中。

为什么需要 Workspace Switch？

当你同时使用多个 AI 编程助手（Claude Code、Cursor、Copilot、Codex、Gemini CLI、Qoder 等），你会面临这些问题：

• 同一个 Skill 要在每个 Agent 的配置目录里各存一份，更新时容易遗漏
• MCP Server 的配置格式各不相同（JSON / TOML、字段名不同），手动维护容易出错
• API Key 散落在各个工具的配置文件里，无法集中管理
• 换一台机器后，所有配置要重新来一遍

Workspace Switch 用 **可信源 + symlink 分发** 的模式解决这些问题：

1. 所有 Skill / MCP 配置只保存在一个可信源目录（~/.workspace_switch/）
2. "Apply" 操作通过 symlink 将 Skill 链接到目标 Agent 的配置目录
3. MCP 配置会根据目标 Agent 的格式自动渲染并合并到对应配置文件
4. 一次管理，多处生效；反向扫描还能把已有的配置导入回来

核心概念

概念	说明
Agent	AI 编程工具，如 Claude Code、Cursor、Copilot 等。每个 Agent 有独立的配置目录格式
Skill	可复用的 AI 指令集（通常是一个包含 SKILL.md 的目录），通过 symlink 分发到各 Agent
MCP Server	Model Context Protocol 服务端配置，提供工具调用能力。支持 stdio / sse / http 三种传输方式
Provider	LLM API 提供者（OpenAI、Anthropic 等），管理 Base URL、API Key 和模型列表
Project	本地代码项目，支持按项目维度启用/禁用特定 Agent 并应用不同的 Skill 集合
可信源	~/.workspace_switch/ 目录，是所有 Skill 和 MCP 配置的唯一真实来源
反向扫描	从 Agent 的实际配置目录扫描已有的 Skill / MCP，导入到可信源后再同步到其他 Agent

项目结构

workspace-switch/
├── packages/
│   ├── core/        # 核心业务逻辑（SQLite 数据库、CRUD、symlink 分发、反向扫描、MCP 渲染器）
│   ├── cli/         # CLI 工具 ws_cli（基于 Commander.js 的薄封装层）
│   ├── desktop/     # Electron 桌面 GUI（React + Zustand + Tailwind CSS）
│   └── templates/   # Agent 模板定义
├── pnpm-workspace.yaml
└── package.json

环境要求

• Node.js >= 18
• pnpm >= 9
• macOS 10.15+（推荐，完整 Keychain 支持；Windows / Linux 可运行但无 API Key 安全存储）

---

GUI 桌面应用（推荐）

桌面应用基于 Electron + React + Tailwind CSS，提供完整的可视化管理界面。

内置功能

• Dashboard — 工作区健康概览、Agent 同步状态、快捷操作入口
• Agent 管理 — CRUD、自动检测本机已安装的 Agent
• Skill 管理 — CRUD、标签管理、反向扫描向导、Apply / Unapply 到指定 Agent、批量操作
• MCP 管理 — CRUD、反向扫描、Apply 到指定 Agent（自动格式转换）
• Provider 管理 — CRUD、API Key 安全存储（macOS Keychain）
• Project 管理 — 按项目启用/禁用 Agent、按项目应用 Skill
• 全局搜索 — `C