---

📸 启动界面

---

✨ 核心特性

- 🤖 智能对话 - 上下文理解、多轮协作、可继续会话
- 🆓 开箱即用 - 内置免费 GLM-4.7 模型，可选自定义模型
- 🌐 双模式界面 - CLI 终端 + Web UI，随心切换
- 🛠️ 丰富工具 - 20+ 内置工具：文件/搜索/Shell/Git/Web 等
- 🔗 扩展能力 - MCP、插件与 Skills 系统
- 📋 结构化工作流 - Spec / Plan / Subagents
- 🔒 安全可控 - default/autoEdit/plan/yolo 权限模式与工具白/黑名单
- 🎨 现代 UI - React + Ink 终端 UI / React + Vite Web UI

---

🚀 快速开始

``bash


快速体验

> 默认使用内置免费模型；要使用自有模型，可运行 blade 按提示配置。

---

⚙️ 可选配置

配置文件支持全局和项目级：~/.blade/config.json 或 .blade/config.json。
更多配置项见文档。

`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 打印模式（适合管道）
- --output-format 输出格式（text/json/stream-json）
- --permission-mode 权限模式
- --resume/-r 恢复会话 / --session-id 指定会话

---

📖 文档

- 用户文档
- 本仓库文档入口
- 贡献指南

---

🤝 贡献

`bash
git clone https://github.com/echoVic/blade-code.git
cd blade-code && pnpm install && pnpm dev
``

---

💬 交流群

添加小助手微信 VIc-Forever，备注「Blade」拉你进群。

---

🔗 相关资源

- NPM 包
- Discord 社区 - 加入我们的 Discord 服务器
- 问题反馈

---

⭐ Star History

---

📄 许可证

MIT - Made with ❤️ by echoVic