📸 界面预览
CLI 终端界面
Web UI 界面（0.2.0 新增）
✨ 核心特性
- 🤖 智能对话 - 上下文理解、多轮协作、可继续会话
- 🧠 自动记忆 - 跨会话持久化项目知识，自动学习构建命令、代码模式、调试洞察
- 🌐 双模式界面 - CLI 终端 + Web UI，随心切换
- 🛠️ 丰富工具 - 20+ 内置工具：文件/搜索/Shell/Git/Web 等
- 🔗 扩展能力 - MCP、插件与 Skills 系统
- 📋 结构化工作流 - Spec / Plan / Subagents
- 🔒 安全可控 - default/autoEdit/plan/yolo 权限模式与工具白/黑名单
- 🎨 现代 UI - React + Ink 终端 UI / React + Vite Web UI
🚀 快速开始
# 快速体验
npx blade-code
# 全局安装
npm install -g blade-code
# 或
pnpm add -g blade-code
# CLI 模式
blade
blade "帮我分析这个项目"
blade --print "写一个快排算法"
blade --headless "分析这个仓库并给出重构建议"
blade --headless --output-format jsonl "在 CI 中运行完整 agent 循环"
# Web UI 模式（0.2.0 新增）
blade web # 启动并打开浏览器
blade serve --port 3000 # 无头服务器模式
首次启动需配置模型，运行
blade后输入/model add进入向导。
⚙️ 可选配置
配置文件支持全局和项目级：~/.blade/config.json 或 .blade/config.json。
更多配置项见文档。
{
"provider": "openai-compatible",
"apiKey": "${BLADE_API_KEY}",
"baseUrl": "https://api.openai.com/v1",
"model": "gpt-4o-mini"
}
🧰 命令速览
常用命令
blade启动交互式 CLI 界面blade web启动 Web UI（0.2.0 新增）blade serve启动无头服务器（0.2.0 新增）blade mcp管理 MCP 服务器blade doctor环境自检blade update检查更新
常用选项
--print/-p打印模式（适合管道）--headless无 Ink UI 的完整 agent 模式，按终端事件流输出--output-format输出格式（text/json/stream-json/jsonl）--permission-mode权限模式--resume/-r恢复会话 /--session-id指定会话
Headless 模式
blade --headless "..."会运行完整 agent loop，但不启动交互式 Ink UI- 默认权限模式为
yolo，除非显式传入--permission-mode --output-format jsonl会输出稳定的机器可消费事件流，适合 CI、sandbox 和测试场景
交互式命令（会话内）
/memory list列出所有记忆文件/memory show显示 MEMORY.md 内容/memory edit [topic]用编辑器编辑记忆文件/memory clear清空所有记忆
📖 文档
🤝 贡献
git clone https://github.com/echoVic/blade-code.git
cd blade-code && bun install && bun run dev
💬 交流群
添加小助手微信 VIc-Forever，备注「Blade」拉你进群。
🔗 相关资源
- NPM 包
- Discord 社区 - 加入我们的 Discord 服务器
- 问题反馈