核心功能
Multi-Workplace 是一套面向复杂开发环境的项目工作区管理框架,通过为每个代码库创建隔离的 .workplace/ 目录结构,实现多项目并行开发时的上下文管理、代理编排与记忆隔离。
显著优点
1. 多项目隔离:每个工作区拥有独立的 UUID、代理定义、记忆日志和技能集,避免项目间上下文污染
2. 智能工作区发现:自动扫描 .git 目录识别潜在工作区,支持子模块嵌套与手动链接
3. Swarm 式代理编排:基于 .workplace/agents/*.md 定义多角色代理,支持触发条件与交接机制
4. 持久化内核代理:kernel 代理常驻运行,维护项目结构摘要与跨会话状态
5. 跨IDE同步:一键生成 Cursor MDC、Claude Code 规则、OpenCode 配置,保持工具链一致
6. 交互式部署:内置 Telegram/Discord 按钮界面,支持环境切换与一键部署
潜在局限
- 平台依赖:Rust 文件监控服务器需预编译二进制,新架构需手动构建
- 记忆膨胀:长期项目的
memory/日志可能累积,需定期归档 - IDE覆盖风险:
sync命令会覆写现有规则文件,建议版本控制备份 - 学习曲线:代理定义需掌握 YAML frontmatter 与交接协议规范
适用人群
- 同时维护 3+ 个代码库的全栈开发者
- 需要多代理协作的 AI 辅助编程用户
- 团队 Lead 统一项目模板与部署规范
常规风险
- 代理交接循环可能导致消息风暴(建议设置
max_turns限制) workplace delete仅从注册表移除,不删除物理目录- 导出 ZIP 默认排除记忆文件,敏感部署凭证需手动核查