🚀 一个开源的 AI Agent 桌面应用框架，用于学习如何构建现代化的 AI Skill助手
SkillMate 目前处于活跃开发阶段，主要用于：
- 🎓 学习和研究 - 了解 AI Agent 的实现原理
- 🔬 实验和探索 - 测试新的交互方式和工具集成
- 📚 教学演示 - 展示现代 AI 应用的构建方法
- 🔴 稳定性 - 可能存在未知 bug 和崩溃问题
- 🔴 安全性 - AI 操作本地文件系统，需要用户谨慎授权
- 🔴 功能完整性 - 部分功能仍在开发中
- 🔴 性能优化 - 未经过大规模测试和优化
✅ 适合：
- 学习 Electron + AI 应用开发
- 研究 AI Agent 架构和实现
- 个人实验和原型验证
- 教学演示和代码示例
❌ 不适合：
- 生产环境部署
- 处理重要数据
- 需要高可靠性的场景
- 🎯 通用架构 - 不绑定任何特定领域，自由扩展
- 🔧 高度可定制 - 支持自定义技能和 MCP 服务器
- 📚 教学优先 - 清晰的代码结构和文档，适合学习
- 🛠️ 最佳实践 - 展示 AI Agent 开发的行业标准
- 🔌 MCP 协议支持 - 无限扩展能力边界
- 🖥️ 跨平台 - Windows、macOS、Linux 全支持
- 💬 智能对话 - 基于 Claude AI 的自然语言交互
- 🔧 工具调用 - 安全的文件操作和命令执行
- 🔌 技能系统 - 35+ 内置技能，涵盖文档处理、设计创作、开发工具、Git 工作流等
- 🌐 MCP 集成 - 标准化的工具集成协议
- ⚡ 流式响应 - 实时展示 AI 思考过程
- 🔐 权限管理 - 细粒度的权限控制和确认机制
- ⚡ 性能优化 - 技能懒加载、智能缓存、并行加载（v2.0 新增）
- 📖 学习如何构建 Electron + AI 应用
- 🔍 理解 AI Agent 的运行时机制
- 🎓 掌握 MCP 协议和技能系统
- 🚀 快速原型验证 AI Agent 创意
- 🧩 基于框架构建定制化助手
- 🔌 集成自定义工具和服务
- 🔬 研究 AI Agent 的行为模式
- 📊 分析工具调用和权限管理
- 🎨 实验新的交互方式
SkillMate allows AI to operate on local file systems and terminals. Please note:
SkillMate 允许 AI 操作本地文件系统和终端。请注意：
- 🚨 AI may accidentally delete files or execute incorrect commands
- 🚨 AI 可能意外删除文件或执行错误命令
- 🔓 Prompt injection risks may exist
- 🔓 可能存在提示注入风险
- 👁️ AI can read all files within authorized directories
- 👁️ AI 可以读取授权目录内的所有文件
Recommendations / 建议：
- ✅ Only authorize necessary directories / 仅授权必要的目录
- ✅ Backup data regularly / 定期备份数据
- ✅ Review operation requests / 审查操作请求
- ✅ Monitor AI behavior / 监控 AI 行为
Disclaimer / 免责声明： This software is provided "as-is" for learning and development purposes only. Developers are not liable for any losses caused by using this software.
本软件按"原样"提供，仅用于学习和开发目的。开发者不对使用本软件造成的任何损失承担责任。
This is a development version - use at your own risk! 这是开发版本 - 使用风险自负！
- 桌面框架: Electron 30.0.1
- 前端: React 18.2.0 + TypeScript 5.2.2 + Tailwind CSS
- 构建工具: Vite 5.1.6 + vite-plugin-electron
- AI SDK: 支持多种大模型（默认使用智谱 AI GLM-4.7）+ Model Context Protocol SDK
智谱 AI 优势：
- 💰 性价比高：GLM-4-Flash 完全免费，编程套餐 20元/月（Claude 的 1/7 价格）
- ⚡ 速度快：55+ Tokens/秒生成速度
- 🎯 代码能力强：SWE-bench 得分 59.2%，专为编程优化
- 🇨🇳 中文友好：国产大模型，对中文理解更深入
- ✅ 流式响应 - 实时展示 AI 思考过程
- ✅ 工具调用 - 安全的文件操作和命令执行
- ✅ 权限管理 - 细粒度的权限控制和确认机制
- ✅ 会话管理 - 多会话支持和历史记录持久化
- ✅ 技能系统 - 可扩展的技能框架
- ✅ MCP 协议 - 标准化的工具集成协议
SkillMate/
├── electron/ # Electron 主进程代码
│ ├── main.ts # 主进程入口（窗口管理、IPC 注册）
│ ├── preload.ts # 预加载脚本（IPC 桥接）
│ ├── agent/ # AI Agent 系统
│ │ ├── AgentRuntime.ts # 核心运行时
│ │ ├── commands/ # Agent 命令系统
│ │ ├── skills/ # 技能管理器
│ │ ├── mcp/ # MCP 客户端服务
│ │ ├── tools/ # 内置文件系统工具
│ │ ├── security/ # 权限管理器
│ │ ├── PythonRuntime.ts # Python 运行时
│ │ └── SkillRecommender.ts # 技能推荐引擎
│ └── config/ # 配置存储
├── src/ # React 渲染进程代码
│ ├── App.tsx # 根组件
│ └── components/ # React 组件
│ ├── CoworkView.tsx # 主界面（聊天/工作双模式）
│ ├── SettingsView.tsx # 设置面板
│ ├── SkillsEditor.tsx # 技能编辑器
│ ├── MCPConfigEditor.tsx # MCP 配置编辑器
│ ├── QuickActionsEditor.tsx # 快捷按钮配置
│ ├── FloatingBallPage.tsx # 悬浮球窗口
│ ├── CommandPalette.tsx # 命令面板
│ ├── ConfirmDialog.tsx # 权限确认对话框
│ └── ... # 其他 UI 组件
├── forge/ # Electron Forge 构建配置
│ └── vite.*.config.ts # Vite 构建配置
├── resources/skills/ # 内置技能库
├── docs/ # 项目文档
│ ├── architecture.md # 架构设计
│ ├── getting-started.md # 快速开始
│ ├── configuration.md # 配置指南
│ ├── skill-development.md # 技能开发
│ ├── mcp-integration.md # MCP 集成
│ └── development.md # 开发指南
├── public/ # 静态资源
│ ├── icon.png # 应用图标
│ └── index.html # HTML 入口
├── .gitignore # Git 忽略规则
├── package.json # 项目配置
├── tsconfig.json # TypeScript 配置
├── forge.config.ts # Electron Forge 配置
├── CREDITS.md # 致谢与致敬
└── README.md # 项目说明
- 安全机制详解
- 性能优化技巧
- 自定义 UI 主题
💬 直接说："帮我安装这个 GitHub 项目" 或 "帮我设置 SkillMate"
AI Agent 会自动完成所有安装步骤：
- ✅ 克隆项目
- ✅ 安装所有依赖
- ✅ 配置环境
- ✅ 启动应用
详细流程: 查看 INSTALL.md - 专为 AI Agent 设计的自动化安装指南
- Node.js: >= 18.0.0（推荐 20.x）
- npm: >= 9.0.0
- Git: 用于克隆仓库
- 操作系统: Windows 10+, macOS 10.15+, Linux (Ubuntu 20.04+)
# 1. 克隆仓库
git clone https://github.com/hhhh124hhhh/SkillMate.git
cd SkillMate
# 2. 安装依赖（选择一种方式）Windows 用户:
install.batmacOS/Linux 用户:
npm run setup# 仅安装 Node.js 依赖
npm install
# 可选：安装 Python MCP 服务器（用于网页抓取功能）
pip install mcp-server-fetch💡 提示: 如果 npm install 速度慢或失败，可以尝试：
- 使用国内镜像：
npm install --registry=https://registry.npmmirror.com- 清理缓存：
npm cache clean --force
# 3. 启动开发服务器
npm start应用会自动启动并打开窗口。
┌─────────────────────────────────────┐
│ 点击右上角 ⚙️ 设置按钮 │
│ ↓ │
│ 粘贴智谱 AI API Key │
│ 获取地址: open.bigmodel.cn │
│ ↓ │
│ 点击"保存配置" │
└─────────────────────────────────────┘
推荐使用 智谱 AI 编程套餐（性价比高）
┌─────────────────────────────────────┐
│ 设置 → 权限管理 │
│ ↓ │
│ 添加授权目录 │
│ (选择工作文件夹，如 D:\Projects) │
│ ↓ │
│ 点击"授权" │
└─────────────────────────────────────┘
在底部输入框输入：
你好，请介绍一下你自己
按 Enter 发送，如果 AI 回复，配置成功！
┌──────────────────────────────────────┐
│ 技能系统 (35+ 技能) │
│ • 直接输入需求，系统自动推荐技能 │
│ • 或输入 / 搜索技能 │
│ • 或按 Ctrl+Shift+P 打开命令面板 │
└──────────────────────────────────────┘
┌──────────────────────────────────────┐
│ 文件操作 │
│ • 拖拽文件到输入区 │
│ • 或点击 + 按钮选择文件 │
│ • 点击 📂 选择工作目录 │
└──────────────────────────────────────┘
┌──────────────────────────────────────┐
│ 对话模式 │
│ • 💬 Chat: 纯对话（安全） │
│ • 🔧 Work: 可操作文件（完整功能） │
└──────────────────────────────────────┘
| 快捷键 | 功能 |
|---|---|
Ctrl+L |
聚焦输入框 |
Ctrl+Shift+P |
命令面板 |
/ |
技能搜索 |
- AI 执行操作时会弹出权限确认，请仔细查看
- 只授权必要的文件夹
- 建议先在 Chat 模式熟悉功能
-
首次运行配置
- 打开应用后，点击右上角设置按钮
- 配置你的 API Key（推荐使用智谱 AI）
- （推荐）配置授权文件夹（限制 AI 访问范围）
-
获取智谱 AI API Key
SkillMate 推荐使用智谱 AI GLM 编程套餐，性价比极高：
-
💰 超值定价：
- GLM-4-Flash：完全免费，永久调用
- GLM Coding Plan：月付 20元起（首月仅 8.9元），年付 192元
- API 按量付费：5元/百万tokens（约 Claude 的 1/4 价格）
-
🚀 性能优势：
- 生成速度：55+ Tokens/秒
- SWE-bench Verified 得分：59.2%
- 价格仅为 Claude 的 1/7，用量提升 3 倍
-
🎯 支持的模型：
glm-4-flash- 免费模型（推荐入门使用）glm-4.7- 最新旗舰模型deepseek-v3.2- 高性能编程模型kimi-k2-thinking- 思维链模型
-
📱 获取方式：
- 访问 智谱 AI 开放平台
- 注册/登录账号
- 进入 GLM Coding Plan 查看编程套餐
- 创建 API Key
-
-
其他模型支持
也可以使用其他兼容的模型，在设置面板中配置：
- Claude API：
https://api.anthropic.com - OpenAI GPT：
https://api.openai.com - Gemini：
https://generativelanguage.googleapis.com
- Claude API：
-
可选配置
- 添加自定义技能
- 配置 MCP 服务器（项目已内置，开箱即用）
- 调整快捷键设置
# 仅构建前端代码
npm run build:frontend
# 完整构建（Electron + Vite + 打包）
npm run build
# 仅构建 Electron 主进程
npm run build:electron创建自己的技能非常简单：
# 1. 在 resources/skills/ 创建新目录
mkdir -p resources/skills/my-skill
# 2. 创建 SKILL.md 文件
cat > resources/skills/my-skill/SKILL.md << 'EOF'
---
name: my-skill
description: 我的自定义技能
input_schema:
type: object
properties:
query:
type: string
description: 查询内容
---
这里是技能的具体指令...
EOF
# 3. 重启应用，技能会自动加载详细指南：技能开发文档
MCP (Model Context Protocol) 允许集成外部工具和服务：
{
"mcpServers": {
"filesystem": {
"name": "filesystem",
"description": "本地文件系统访问",
"type": "stdio",
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/allowed/path"]
},
"fetch": {
"name": "fetch",
"description": "网页内容获取",
"type": "stdio",
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-fetch"]
}
}
}详细指南：MCP 集成文档
- 架构设计 - 理解项目整体架构
- 快速开始 - 安装和运行指南
- 技能开发 - 创建自定义技能
- MCP 集成 - 配置 MCP 服务器
- 开发指南 - 如何参与开发
- CLAUDE.md - AI 辅助开发配置
- 致谢与致敬 - 开源项目致敬详情 ⭐
npm start # 启动开发服务器
npm run build # 完整构建（Electron + Vite）
npm run lint # 代码检查- Node.js: >= 18.0.0（推荐 20.x）
- npm: >= 9.0.0
- 操作系统: Windows 10+, macOS 10.15+, Linux (Ubuntu 20.04+)
项目使用 ESLint 和 Prettier 进行代码检查和格式化：
# 运行代码检查
npm run lint
# 自动修复代码格式问题
npm run lint -- --fix开发模式下有以下便利功能：
- 🔥 热重载（前端代码修改自动刷新）
- 🐛 自动打开 DevTools
- 📝 详细日志输出
- ⚡ 快速重启（主进程修改需手动重启）
欢迎贡献！请查看 贡献指南
- Fork 本仓库
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启 Pull Request
- 🐛 Bug 报告 - 使用 GitHub Issues
- 💡 功能建议 - 使用 GitHub Discussions
- 📖 文档改进 - 提交 PR
- 🔧 代码贡献 - 遵循代码规范，添加测试
- 查看文档 - 先查看 文档
- 搜索 Issues - 检查是否已有类似问题
- 创建 Issue - 包含详细的错误信息和复现步骤
创建 Issue 时请包含：
- 📝 描述 - 清晰描述问题
- 🔍 复现步骤 - 如何触发问题
- 💻 环境 - 操作系统、Node.js 版本等
- 📸 截图/日志 - 错误截图或日志
- 🎯 期望行为 - 你期望发生什么
v0.2.0-dev (开发版本)
- ✨ 新增 35+ 内置技能
- ✨ 新增 MCP 协议支持
- ✨ 新增权限管理系统
- ✨ 新增技能懒加载和并行加载
- 🐛 修复多个已知 bug
- 📚 完善文档和注释
- 🔮 更多内置技能
- 🔮 技能市场（社区技能分享）
- 🔮 多语言支持
- 🔮 插件系统
- 🔮 性能优化和内存管理
Apache License 2.0 - 详见 LICENSE
Copyright © 2024 SkillMate Team
SkillMate 的诞生离不开开源社区的无私分享。
本项目在学习、参考和借鉴了以下优秀开源项目的基础上进行开发：
-
OpenCowork - 本项目的基础来源
- 重要: SkillMate 基于 OpenCowork 进行二次开发和改造
- 提供了 Electron + React + TypeScript 架构基础
- 提供了 AI Agent 运行时系统设计
- 提供了 MCP 协议集成框架和技能系统核心实现
- 改造方向：保留通用架构，优化为学习和研究 AI Agent 的开源框架
-
Claude Code - Anthropic 官方的 AI 编程助手
- 启发了 AI Agent 与文件系统交互的设计思路
- 参考了权限管理和安全确认机制
- 借鉴了技能系统的设计理念
-
Continue - AI 代码补全和助手
- 参考了多 AI 模型支持的架构
- 学习了上下文管理的实现方式
-
Cursor - AI 驱动的代码编辑器
- 启发了 AI 辅助开发的交互模式
- 参考了流式响应的展示方式
本项目建立在以下优秀开源项目的肩膀上：
AI 和协议层：
- 智谱 AI GLM - 主要推荐的高性价比大语言模型
- GLM-4-Flash 完全免费，编程套餐仅 20元/月
- 55+ Tokens/秒 生成速度，代码能力强
- SWE-bench 得分 59.2%，专为编程优化
- Anthropic Claude API - 强大的大语言模型能力
- Model Context Protocol - 标准化的工具集成协议
- @anthropic-ai/sdk - TypeScript SDK
桌面应用框架：
- Electron - 跨平台桌面应用框架
- Electron Forge - Electron 打包和构建工具
- electron-store - 简单的配置存储
- electron-updater - 自动更新机制
前端框架：
- React - 用户界面库
- TypeScript - 类型安全的 JavaScript
- Vite - 下一代前端构建工具
- Tailwind CSS - 实用优先的 CSS 框架
- @tanstack/react-virtual - 虚拟滚动组件
开发工具：
- ESLint - 代码质量检查
- Prettier - 代码格式化
- electron-log - Electron 日志模块
社区资源：
- everything-claude-code - Anthropic 黑客松获胜配置
- 提供了完整的 Claude Code 最佳实践
- 参考了 agents、skills、hooks 等设计模式
- 借鉴了自动化工作流配置
- 智谱 AI 团队 - 提供高性价比的 GLM 大模型和完善的开发者支持
- Anthropic 团队 - 提供强大的 Claude AI 能力和完善的技术文档
- Model Context Protocol 社区 - 制定开放的工具集成标准
- Electron 社区 - 提供稳定的跨平台应用框架
- 所有开源贡献者 - 用代码和知识构建更美好的世界
本项目遵循 Apache License 2.0 开源，感谢以下项目的启发：
- 技术架构设计思路
- 安全最佳实践
- 用户体验优化
- 开发者体验设计
如果你是某个开源项目的作者，并且觉得本项目参考了您的设计但没有列出来，欢迎通过 Issues 告知我们，我们会立即添加致谢！
开源的本质是分享和传承。我们站在巨人的肩膀上，也希望我们的工作能够帮助到更多人。
如果你看到旧的对话历史或遇到缓存问题，可以按以下步骤清除：
Windows:
scripts\clean-cache.batmacOS/Linux:
chmod +x scripts/clean-cache.sh
./scripts/clean-cache.sh- 打开应用
- 点击右上角设置图标
- 进入"高级设置"
- 点击"清除所有数据"按钮
- 确认清除
# 删除 Electron 用户数据
rm -rf .vscode/electron-userdata # macOS/Linux
rmdir /s /q .vscode\electron-userdata # Windows
# 重新启动应用
npm startElectron 浏览器缓存存储在 .vscode/electron-userdata/ 目录中。如果你克隆项目时包含了此目录（虽然已在 .gitignore 中），历史记录就会被带过去。
解决方案：删除 .vscode/electron-userdata/ 目录后重新启动。
-
✅ 会删除：
- 所有对话历史
- 授权文件夹列表
- 禁用的技能设置
- 用户偏好设置
-
❌ 不会删除：
- API Key（会保留）
- 系统配置
# 1. 检查是否有用户数据文件
git ls-files | grep -i "electron-userdata\|opencowork-sessions"
# 2. 应该看到空结果（表示没有用户数据被跟踪）
# 3. 检查 .gitignore
grep "electron-userdata" .gitignore
# 4. 应该看到: .vscode/electron-userdata/- GitHub: https://github.com/hhhh124hhhh/SkillMate
- Issues: https://github.com/hhhh124hhhh/SkillMate/issues
- Discussions: https://github.com/hhhh124hhhh/SkillMate/discussions
扫描二维码，加入微信群
如果这个项目对你有帮助，请给它一个 Star ⭐
🚀 开始构建你的 AI Agent 之旅