Skip to content

Latest commit

 

History

History

README.md

Blade

Blade 是一个面向真实工程任务的 AI 编程助手。CLI、Web、Headless 和 ACP 共享同一套 Session Runtime、工具、权限与持久化语义。

查看更新日志

核心特性

🌐 多种运行入口

  • CLI 模式: 在终端中使用,支持 Markdown 渲染和语法高亮
  • Web UI 模式: 在浏览器中使用,完整的图形界面体验
  • Headless 模式: 为脚本、CI 和自动化提供稳定 JSONL 事件
  • ACP 模式: 接入支持 Agent Client Protocol 的编辑器和宿主
blade                                      # CLI 模式
blade web                                  # Web UI 模式
blade serve                                # 无头 HTTP 服务器
blade --headless --output-format jsonl "分析项目"  # Headless Agent

📡 Provider Catalog

Provider、模型能力、上下文窗口和价格均从内置目录动态读取,不在文档中维护容易过期的 静态模型表。官方 Provider、云平台和自定义兼容渠道使用同一配置流程。

3 步配置向导:选择 Provider → 输入 API Key → 选择模型

🛡️ 安全权限控制

  • 敏感操作前请求确认
  • 支持 glob 模式的权限规则
  • 四种权限模式(default、autoEdit、plan、yolo)

🔧 强大的工具集

  • 文件操作: 读取、写入、编辑、搜索
  • 代码分析: 语法检查、类型检查、测试运行
  • 终端执行: 安全的命令执行环境
  • Git 集成: 版本控制操作
  • 网络搜索: 多提供商自动故障转移

📝 灵活的工作模式

  • Plan 模式: 先规划后执行
  • Subagents: 并行任务处理

🔌 MCP 扩展

支持 Model Context Protocol,可连接外部工具和服务。

快速开始

# 安装
npm install -g blade-code

# CLI 模式
blade

# Web UI 模式
blade web

# 从 Provider Catalog 添加模型
# 在 Blade 中输入: /model add

文档目录

入门指南

配置

使用指南

参考

其他

支持的 Provider

运行 /model add 可查看当前安装版本支持的 Provider 和模型。自定义 OpenAI 或 Anthropic 兼容 endpoint 可配置为独立渠道,凭证与其他渠道隔离存储。

许可证

MIT License