🗡️ Blade Cowork

智能协作终端 - AI Agent 驱动的代码协作工具

中文 | English

✨ 功能特性

• 🤖 AI Agent 驱动的代码协作
• 🖥️ 支持 CLI 和桌面应用两种模式
• 🔌 MCP (Model Context Protocol) 支持
• 🛠️ 丰富的内置工具（文件操作、搜索、Shell 等）
• 🎨 多主题支持
• 📦 Skills 动态扩展系统
• 🏠 本地模型支持 - 通过 Ollama 运行本地大模型，完全离线使用

🏠 本地模型

Blade Cowork 支持通过 Ollama 运行本地大模型，实现完全离线的 AI 编程助手体验。

功能亮点

• 硬件检测 - 自动检测 CPU、内存、GPU，智能推荐适合的模型
• 模型商店 - 精选热门开源模型，一键下载安装
• GGUF 导入 - 支持导入本地 GGUF 格式模型文件
• Metal 加速 - Apple Silicon 芯片原生 GPU 加速

截图

本地模型管理	模型商店

导入 GGUF 模型	设置入口

📥 安装

macOS

下载

从 Releases 页面下载对应架构的安装包：

• Apple Silicon (M1/M2/M3): Blade Cowork-x.x.x-arm64.zip
• Intel Mac: Blade Cowork-x.x.x-x64.zip

⚠️ 首次打开提示"已损坏"的解决方法

由于应用未经 Apple 签名，首次打开可能会提示：

"Blade Cowork" 已损坏，无法打开。你应该将它移到废纸篓。

解决方法：打开终端，执行以下命令：

xattr -cr /Applications/Blade\ Cowork.app

如果应用不在 /Applications 目录，请替换为实际路径：

xattr -cr /path/to/Blade\ Cowork.app

执行后即可正常打开应用。

💡 这是 macOS Gatekeeper 的安全机制，对于未经 Apple 公证的应用会显示此提示。本项目代码完全开源，你可以在 GitHub 查看源码。

Windows

从 Releases 页面下载 .exe 安装包或 .zip 便携版。

Linux

从 Releases 页面下载 .AppImage 或 .deb 安装包。

🛠️ 开发

环境要求

• Node.js >= 20.0.0
• pnpm

安装依赖

pnpm install

环境变量

cp .env.example .env

请在 .env 中配置以下变量（示例值请勿直接用于生产）：

• DISCORD_WEBHOOK_URL：可选，发布脚本 Discord 通知 webhook
• BLADE_BUILTIN_KEY_PROXY_URL：内置模型 key 代理地址
• BLADE_BUILTIN_KEY_PROXY_TOKEN：内置模型 key 代理认证 token
• VITE_SUPABASE_URL：Supabase 项目 URL
• VITE_SUPABASE_ANON_KEY：Supabase 匿名访问 key
• VITE_DISABLE_ANALYTICS：可选，设为 1 或 true 时强制禁用分析事件上报

开发模式

pnpm dev

构建

# 构建所有平台
pnpm build

# 仅构建 macOS
pnpm build:mac

# 构建特定架构
pnpm build:mac:arm64  # Apple Silicon
pnpm build:mac:x64    # Intel

测试

pnpm test

代码检查

pnpm lint
pnpm typecheck

📄 许可证

MIT License

🤝 贡献

欢迎提交 Issue 和 Pull Request！