OpenSkill

可扩展的 AI Skills 桌面应用，通过 Skills Marketplace 扩展 AI 能力。

特性

• Skills Marketplace: 从 GitHub 仓库浏览和安装 Skills
• 自动更新检测: 自动检查已安装 Skills 的更新
• 网络代理支持: 自动检测代理配置，支持中国大陆网络环境
• 内置 Skill: 包含 create-skill，帮助用户创建新 Skills
• 极简设计: 简洁实用的用户界面
• 开箱即用: 无需复杂配置，安装即可使用
• 跨平台: 支持 macOS、Windows、Linux

安装

macOS

1. 从 Releases 下载 DMG 文件
2. 双击打开，将应用拖入 Applications 文件夹
3. 首次运行可能需要在"系统偏好设置 > 安全性与隐私"中允许

Windows

1. 从 Releases 下载 MSI 安装程序
2. 双击运行安装向导

Linux

1. 从 Releases 下载 AppImage 或 deb 包
2. 安装并运行

使用

1. 启动应用
2. 首次使用需要配置 API key（可选，已有内置免费模型）
3. 点击"Marketplace"浏览和安装 Skills
4. 选择要使用的 Skill
5. 上传文件或输入指令
6. 等待 AI 处理完成

开发

环境要求

• Node.js 18+
• Bun（包管理器）
• Rust 1.70+
• Tauri CLI

安装依赖

bun install

启动开发服务器

cargo tauri dev

构建应用

# 构建 Mac 应用
cargo tauri build

# 构建产物位置
# - App: src-tauri/target/release/bundle/macos/AI 工具箱.app
# - DMG: src-tauri/target/release/bundle/dmg/AI 工具箱_1.0.0_aarch64.dmg

项目结构

my-product/
├── src/                    # React 前端
│   ├── components/         # UI 组件
│   │   ├── chat/          # 聊天相关
│   │   ├── layout/        # 布局组件
│   │   ├── marketplace/   # Marketplace 相关组件
│   │   ├── session/       # 会话相关
│   │   └── settings/      # 设置页面
│   ├── hooks/              # React hooks
│   │   ├── useOpencode.ts  # OpenCode 服务管理
│   │   ├── useSession.ts   # 会话管理
│   │   └── useUpdates.ts   # 更新管理
│   ├── lib/                # 工具库
│   │   ├── opencode-sdk/  # OpenCode SDK 客户端
│   │   ├── opencode.ts    # SDK 封装
│   │   └── tauri.ts       # Tauri 命令封装
│   └── types/              # 类型定义
├── src-tauri/              # Rust 后端
│   ├── src/
│   │   ├── commands.rs    # Tauri IPC 命令
│   │   ├── config.rs      # 配置管理
│   │   ├── lib.rs         # Tauri 入口
│   │   ├── marketplace.rs # Marketplace 逻辑
│   │   └── sidecar.rs     # OpenCode sidecar 管理
│   ├── resources/          # 打包资源
│   │   └── skills/        # 内置 Skills
│   └── Cargo.toml          # Rust 依赖
├── AGENTS.md               # 开发规范
├── CLAUDE.md               # Claude 开发助手指南
├── CONTRIBUTING.md         # 贡献指南
├── CHANGELOG.md            # 更新日志
└── DEVELOPMENT.md          # 开发环境指南

配置

API Key 配置

应用支持两种方式配置 API key：

1. 内置 key: 应用已内置默认 key，可直接使用
2. 自定义 key: 在设置页面配置自己的 key

Skills 配置

Skills 可以通过三种方式添加：

1. 内置 Skills: 位于 src-tauri/resources/skills/ 目录，构建时自动打包
2. 用户导入: 通过应用界面导入 zip 格式的 Skill 包
3. Marketplace: 从 Marketplace 服务器自动下载和安装

添加新的内置 Skill：

1. 创建目录 src-tauri/resources/skills/your-skill/
2. 创建 SKILL.md 文件，包含 YAML frontmatter（name、description）
3. 重新构建应用

使用 Marketplace：

1. 在设置中配置 Marketplace URL（可选）
2. 应用会自动检查可用更新
3. 点击"更新"按钮安装新版本

文档

• 开发规范 - 开发规范和最佳实践
• Claude 指南 - Claude 开发助手指南
• 贡献指南 - 如何参与项目开发
• 更新日志 - 版本更新记录
• 开发环境 - 开发环境搭建指南

贡献

欢迎贡献代码！请查看 贡献指南 了解详细信息。

许可证

本项目采用 MIT 许可证。

致谢

• Tauri - 跨平台桌面应用框架
• React - 用户界面库
• Tailwind CSS - CSS 框架
• OpenCode - AI 编码代理