什么是 WopalSpace

WopalSpace 是一套面向 AI 辅助开发的本地空间管理系统。它提供了一套完整的工具链，帮助开发者在 AI 时代更高效地组织项目、管理知识、自动化工作流。

为什么选择 WopalSpace？

在现代软件开发中，开发者面临诸多挑战：

  • 项目结构混乱：随着项目增长，文件和配置越来越难以管理
  • 上下文切换频繁：多个项目之间切换时，需要重新加载上下文
  • 知识碎片化：文档、笔记、代码散落在不同工具中
  • AI 协作困难：AI 助手缺乏对项目结构的深入理解

WopalSpace 通过空间隔离、知识本体和技能系统三大核心能力，系统性地解决这些问题。

核心特性

空间隔离

每个项目拥有独立的工作空间，包含完整的配置、依赖和上下文。空间之间互不干扰，让你可以专注于当前任务。

workspace-a/               workspace-b/
├── .wopal-space/          ├── .wopal-space/
│   ├── STRUCTURE.md       │   ├── STRUCTURE.md
│   └── memory/            │   └── memory/
├── src/                   ├── src/
└── ...                    └── ...

知识本体 (Ontology)

通过 STRUCTURE.md 文件定义项目的”结构真相”，让 AI 助手准确理解你的项目组织方式：

# 项目结构
## 模块
- `src/components/` - UI 组件
- `src/api/` - API 端点
- `src/lib/` - 工具函数

## 规则
- 组件使用 PascalCase 命名
- API 路由遵循 RESTful 规范

技能系统 (Skills)

可插拔的能力扩展机制，让 AI 助手具备特定领域的专业能力：

技能类型说明示例
内置技能WopalSpace 自带代码审查、测试生成
社区技能社区贡献部署助手、文档生成
自定义技能用户自行开发业务逻辑处理

快速体验

推荐的首次链路如下：

# 1. 安装 CLI
curl -fsSL https://wopal.cn/install.sh | bash

# 2. 初始化 WopalSpace
wopal setup

# 3. 启动 engine 并进入 space
wopal ellamaka serve

技术架构

WopalSpace 采用模块化架构设计：

┌──────────────────────────────────────────┐
│              WopalSpace CLI              │
├──────────┬───────────┬───────────────────┤
│  Space   │ Ontology  │      Skills       │
│ Manager  │  Engine   │     Registry      │
├──────────┴───────────┴───────────────────┤
│            Core Runtime                  │
├──────────────────────────────────────────┤
│         Plugin System (Node.js)          │
└──────────────────────────────────────────┘

与其他工具的对比

特性WopalSpace传统项目管理IDE 插件
空间隔离✅ 完整❌ 无⚠️ 部分
AI 原生✅ 是❌ 否⚠️ 附加
知识本体✅ 内置❌ 无❌ 无
技能扩展✅ 灵活❌ 无⚠️ 有限
本地优先✅ 是✅ 是❌ 依赖云端
开源✅ MIT各异各异

适用场景

WopalSpace 特别适合以下场景：

  1. 多项目并行开发：同时维护多个项目，需要快速切换上下文
  2. AI 辅助编程：希望 AI 助手深入理解项目结构和业务逻辑
  3. 团队协作：需要统一的项目结构和开发规范
  4. 知识管理：将文档、笔记、代码统一管理

下一步