Malibu代理助理-VCode扩展
VSCode的高级AI助手扩展,提供由本地Malibu MCP服务器支持的无限上下文、持久内存、检查点和代理工作流。
特性
🤖 人工智能助理
- 计划行为验证工作流:智能多步骤问题解决
- 无限上下文:没有代币限制-完全了解项目
- 持久存储器:跨会话记住您的项目
- 多个专业代理:架构师、开发人员、分析师和助理模型
💾 高级检查点
- 自动检查点:保存重大更改前的项目状态
- 手动检查点:随时创建命名快照
- 一键还原:立即恢复到任何以前的状态
- 导出/导入:跨机器共享检查点
🧠 智能上下文管理
- 项目分析:自动代码库理解
- 文件结构映射:完整的项目拓扑结构
- 依赖项跟踪:了解你的技术栈
- 语言检测:多语言项目支持
💬 增强的聊天界面
- 流媒体响应:实时AI通信
- 丰富的格式:对话中的Markdown支持
- 导出对话:将聊天记录另存为JSON或Markdown
- 代理模式:触发复杂的多步骤工作流
📊 代理状态监控
- 实时状态:看看每个代理都在做什么
- 工作流可视化:跟踪计划行动验证阶段
- 性能指标:监控代理效率
- 健康监测:确保服务器连接
先决条件
- Malibu MCP服务器:您需要在本地运行Malibu MCP服务器
- 克隆: https://github.com/your-repo/malibu_mcp - 按照主存储库中的设置说明进行操作 - 确保服务器正在上运行 http://localhost:8080
- 本地AI模型:Ollama或兼容的本地AI设置
- 推荐型号: mistral:latest, deepseek-coder:latest, deepseek-r1:latest
安装
来自VSIX(推荐)
- 下载最新
.vsix文件来自发布 - 打开VSCode
- 按
Ctrl+Shift+P(或Cmd+Shift+P在Mac上) - 类型“扩展:从VSIX安装”
- 选择已下载的
.vsix文件
来源
- 克隆此存储库
- 跑
npm install - 跑
npm run compile - 按
F5启动扩展开发主机
配置
扩展可以通过VSCode设置进行配置:
{
"malibu.apiUrl": "http://localhost:8080/v1",
"malibu.mcpUrl": "stdio:///path/to/malibu_mcp/rust_core/target/release/mcp_bridge",
"malibu.defaultModel": "malibu-claude-like",
"malibu.enableCheckpoints": true,
"malibu.checkpointFrequency": 30,
"malibu.maxCheckpoints": 50,
"malibu.enableAgenticWorkflow": true,
"malibu.enableProjectMemory": true,
"malibu.logLevel": "info"
}用法
快速开始
- 在VSCode中打开项目
- 在资源管理器侧栏中查找“Malibu助手”
- 点击“开始聊天”或使用
Ctrl+Shift+P→ “Malibu:开始聊天” - 开始与你的AI助手对话!
代理工作流
- 使用聊天中的“代理”按钮处理复杂任务
- 或使用
Ctrl+Shift+P→ “Malibu:启动代理工作流” - 描述你的高级目标(例如,“重构此代码库以获得更好的性能”)
- 观察人工智能计划、实施和验证解决方案
检查点
- 自动检查点:在重大更改之前自动创建
- 手动检查点:
Ctrl+Shift+P→ “Malibu:创建检查点” - 恢复:
Ctrl+Shift+P→ “马里布:恢复检查点” - 管理:使用侧边栏中的Checkpoints面板
项目分析
- 使用
Ctrl+Shift+P→ “马里布:分析项目” - 全面了解您的代码库
- 了解文件结构、依赖关系和复杂性
命令
| 命令 | 描述 |
|---|---|
malibu.startChat | 打开聊天界面 |
malibu.startAgenticWorkflow | 启动代理工作流 |
malibu.createCheckpoint | 创建手动检查点 |
malibu.restoreCheckpoint | 从检查点还原 |
malibu.analyzeProject | 分析当前项目 |
malibu.showAgentStatus | 显示代理状态面板 |
malibu.clearContext | 清晰的对话背景 |
malibu.exportCheckpoints | 将检查点导出到文件 |
malibu.importCheckpoints | 从文件导入检查点 |
面板
马里布助理
- 主聊天界面
- 发送消息并接收AI响应
- 在常规模式和代理模式之间切换
- 导出对话历史记录
代理状态
- 所有AI代理的实时状态
- 当前任务和进度
- 模型信息和健康状态
检查点
- 列出所有可用检查点
- 恢复或删除检查点
- 查看检查点元数据和时间戳
项目记忆
- 持续的项目背景
- 文件更改跟踪
- 依赖性监控
建筑
该扩展由几个关键组件组成:
- 马里布:处理与MCP服务器的通信
- 检查点管理器:管理项目状态快照
- 上下文管理器:跟踪项目结构和变化
- UI面板:基于Webview的交互界面
- 日志记录器:全面的日志记录和调试
故障排除
服务器连接问题
- 确保Malibu MCP服务器正在运行:
curl http://localhost:8080/health - 检查服务器日志是否有错误
- 验证VSCode设置中的配置
检查点问题
- 检查工作区中的文件权限
- 确保有足够的磁盘空间
- 查看扩展日志:查看→ 输出→ “马里布:延伸”
性能问题
- 如果需要,减少检查点频率
- 清除旧检查点:最大检查点设置
- 监控代理状态以发现瓶颈
发展
从源头构建
git clone
cd malibu_vscode_extension
npm install
npm run compile包装
npm install -g vsce
vsce package测试
npm test贡献
- 分叉存储库
- 创建要素分支
- 进行更改
- 如果适用,添加测试
- 提交拉取请求
许可证
此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。
支持
- 问题:在GitHub上报告错误和功能请求
- 文档:检查Malibu MCP主存储库
- 社区:加入我们的Discord服务器以获得支持和讨论
路线图
- \[\]多工作空间支持
- \[\]自定义代理配置
- \[\]与外部工具集成
- \[\]高级工作流模板
- \[\]协作功能
- \[\]扩展插件系统
______________________________________________________________________
备注:此扩展要求Malibu MCP服务器在本地运行。它旨在与您自己的AI模型和数据协同工作,确保隐私和无限使用。
