AI助手VSCode扩展

一款为VSCode设计的AI助手扩展,提供无限上下文、持久记忆、检查点和基于本地Malibu MCP服务器的智能工作流。

  • by malibuiconic
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 malibuiconic/malibu_mcp_vs_code_extension

使用说明

Malibu代理助理-VCode扩展

VSCode的高级AI助手扩展,提供由本地Malibu MCP服务器支持的无限上下文、持久内存、检查点和代理工作流。

特性

🤖 人工智能助理

  • 计划行为验证工作流:智能多步骤问题解决
  • 无限上下文:没有代币限制-完全了解项目
  • 持久存储器:跨会话记住您的项目
  • 多个专业代理:架构师、开发人员、分析师和助理模型

💾 高级检查点

  • 自动检查点:保存重大更改前的项目状态
  • 手动检查点:随时创建命名快照
  • 一键还原:立即恢复到任何以前的状态
  • 导出/导入:跨机器共享检查点

🧠 智能上下文管理

  • 项目分析:自动代码库理解
  • 文件结构映射:完整的项目拓扑结构
  • 依赖项跟踪:了解你的技术栈
  • 语言检测:多语言项目支持

💬 增强的聊天界面

  • 流媒体响应:实时AI通信
  • 丰富的格式:对话中的Markdown支持
  • 导出对话:将聊天记录另存为JSON或Markdown
  • 代理模式:触发复杂的多步骤工作流

📊 代理状态监控

  • 实时状态:看看每个代理都在做什么
  • 工作流可视化:跟踪计划行动验证阶段
  • 性能指标:监控代理效率
  • 健康监测:确保服务器连接

先决条件

  1. Malibu MCP服务器:您需要在本地运行Malibu MCP服务器

    • 克隆: https://github.com/your-repo/malibu_mcp
    • 按照主存储库中的设置说明进行操作
    • 确保服务器正在上运行 http://localhost:8080
  2. 本地AI模型:Ollama或兼容的本地AI设置

    • 推荐型号: mistral:latest, deepseek-coder:latest, deepseek-r1:latest

安装

来自VSIX(推荐)

  1. 下载最新 .vsix 文件来自发布
  2. 打开VSCode
  3. 按 Ctrl+Shift+P (或 Cmd+Shift+P 在Mac上)
  4. 类型“扩展:从VSIX安装”
  5. 选择已下载的 .vsix 文件

来源

  1. 克隆此存储库
  2. 跑 npm install
  3. 跑 npm run compile
  4. 按 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"
}

用法

快速开始

  1. 在VSCode中打开项目
  2. 在资源管理器侧栏中查找“Malibu助手”
  3. 点击“开始聊天”或使用 Ctrl+Shift+P → “Malibu:开始聊天”
  4. 开始与你的AI助手对话!

代理工作流

  1. 使用聊天中的“代理”按钮处理复杂任务
  2. 或使用 Ctrl+Shift+P → “Malibu:启动代理工作流”
  3. 描述你的高级目标(例如,“重构此代码库以获得更好的性能”)
  4. 观察人工智能计划、实施和验证解决方案

检查点

  • 自动检查点:在重大更改之前自动创建
  • 手动检查点: 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的交互界面
  • 日志记录器:全面的日志记录和调试

故障排除

服务器连接问题

  1. 确保Malibu MCP服务器正在运行: curl http://localhost:8080/health
  2. 检查服务器日志是否有错误
  3. 验证VSCode设置中的配置

检查点问题

  1. 检查工作区中的文件权限
  2. 确保有足够的磁盘空间
  3. 查看扩展日志:查看→ 输出→ “马里布:延伸”

性能问题

  1. 如果需要,减少检查点频率
  2. 清除旧检查点:最大检查点设置
  3. 监控代理状态以发现瓶颈

发展

从源头构建

git clone <repository-url>
cd malibu_vscode_extension
npm install
npm run compile

包装

npm install -g vsce
vsce package

测试

npm test

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 如果适用,添加测试
  5. 提交拉取请求

许可证

此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。

支持

  • 问题:在GitHub上报告错误和功能请求
  • 文档:检查Malibu MCP主存储库
  • 社区:加入我们的Discord服务器以获得支持和讨论

路线图

  • []多工作空间支持
  • []自定义代理配置
  • []与外部工具集成
  • []高级工作流模板
  • []协作功能
  • []扩展插件系统

备注:此扩展要求Malibu MCP服务器在本地运行。它旨在与您自己的AI模型和数据协同工作,确保隐私和无限使用。