https://github.com/minbox-projects/one-space
一个集成多模型 AI、MCP、Skills 插件系统、SSH 终端及各类生产力工具（邮件、笔记、代码片段）的全能数字化工作空间。
https://github.com/minbox-projects/one-space
Last synced: about 2 months ago
JSON representation
一个集成多模型 AI、MCP、Skills 插件系统、SSH 终端及各类生产力工具（邮件、笔记、代码片段）的全能数字化工作空间。
- Host: GitHub
- URL: https://github.com/minbox-projects/one-space
- Owner: minbox-projects
- Created: 2026-02-28T03:06:39.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-04-22T08:39:53.000Z (about 2 months ago)
- Last Synced: 2026-04-22T10:31:30.518Z (about 2 months ago)
- Language: TypeScript
- Homepage:
- Size: 6.8 MB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# OneSpace
OneSpace 是一个面向开发者的 macOS 桌面工作台，用来把 AI CLI、环境配置、MCP、Skills/Subagents、工作流和常用生产力工具收拢到一个窗口里。
当前实现重点是：
- 统一管理 `Claude`、`Codex`、`Gemini`、`OpenCode` 的环境预设与 CLI 配置
- 在原生终端中创建和恢复 AI 会话，并把会话记录同步回应用
- 以模型维度管理 `Skills`、`Subagents` 和 `MCP Servers`
- 通过工作流预设把目录、环境、MCP、Skills 一次性组合起来启动
- 提供 `Launcher`、`SSH`、`Snippets`、`Bookmarks`、`Notes`、`AI News`、`Gmail` 等配套工具
## 功能概览
### AI Environments
- 支持 `Claude`、`Codex`、`Gemini`、`OpenCode`
- 自动检测本机 CLI 是否已安装，并显示版本与安装指引
- 对 `Claude`、`Codex`、`Gemini` 支持从系统现有配置自动导入默认环境
- 支持多环境预设、激活当前环境、导出/导入环境 JSON
- 支持 `Env Managed` 开关，决定是否由 OneSpace 持续接管 CLI 配置文件
- 支持从其它已同步设备导入并激活环境
### AI Sessions And Workflows
- 从工作目录直接创建原生终端会话
- 会话可恢复、重命名、删除、复制 ID
- 会话名称和模型信息会持续从各 CLI 历史记录回填
- 支持 `Workflow Presets`
- 工作流可绑定工具、目录、环境、MCP、Skills、启动提示词和 `Shared/Strict` 作用域
- 提供依赖检查、一键补依赖、最近运行记录、重放与失败恢复
### Skills And Subagents
- `Recommended / Repository / Installed` 三视图
- 按模型安装，也支持按项目范围安装
- 支持本地目录导入、远端源同步、差异预览、更新应用、打开本地目录
- `Subagents` 与 `Skills` 共用相似的管理流，但会额外提供源诊断能力
### MCP Servers
- 手动新增 `stdio / http / sse` 三类 MCP Server
- 模板创建，内置 GitHub、Filesystem、PostgreSQL、Context7、Slack、Google Maps、Brave Search、Puppeteer、Figma、Weather 等模板
- 支持按模型单独启用/禁用
- 支持链接到环境、导入导出配置、刷新本地安装状态
- 对部分 `npx` 型 `stdio` MCP 提供更新检查与更新应用
### Developer Utilities
- `Launcher`：启动应用、脚本、URL、文件夹，或跳转应用内部页面
- `OmniSearch`：统一搜索会话、启动项、SSH、代码片段、书签、笔记、Skills、工作流
- `SSH`：读取 `~/.ssh/config`，维护历史、收藏、忽略列表和自定义连接
- `Snippets`、`Bookmarks`、`Notes`
- `AI News`：按关键词抓取 AI 资讯，支持保留策略和 API Key 配置
- `Mail`：通过 Google OAuth 连接 Gmail，查看收件箱、阅读邮件、回复、下载附件
### Fun And Zen
- `Fish Pond` 内置 `CyberMuyu`、`Snake`、`Tetris`、`Sudoku`、`Minesweeper`、`Wordle`
- 入口位于主界面底部鱼形图标，不是独立侧边栏页面
### Experimental Areas
- `Cloud Drive` 当前仍是实验性/模拟状态
- 目前主要完成了 token 保存、基础浏览器界面和示例文件列表流程
- 不应把它视为完整可用的阿里云盘客户端
## 当前实现特点
- macOS-first：会话、SSH、应用启动依赖原生终端和 `open`/AppleScript 工作流
- local-first：运行时读写以本地镜像为主，再按配置同步到 `local / iCloud / Git`
- 支持托盘菜单、全局快捷键、Quick AI Session 浮动条
- 设置页按分区保存，每个分区可以独立保存和重置
## 文档
- 使用手册：[`docs/USAGE.md`](./docs/USAGE.md)
- CLI 文档：[`docs/CLI.md`](./docs/CLI.md)
- Skills 与 Subagents 文档：[`docs/SKILLS.md`](./docs/SKILLS.md)
- MCP 文档：[`docs/MCP.md`](./docs/MCP.md)
- AI Session 命令矩阵：[`docs/AI_SESSION_COMMAND_MATRIX.md`](./docs/AI_SESSION_COMMAND_MATRIX.md)
- 应用内入口：侧边栏 `Documentation`
## 推荐上手顺序
1. 完成初始化向导，选择 `Local / iCloud / Git`，设置主密码。
2. 进入 `AI Environments`，确认 CLI 安装状态并导入或创建环境。
3. 在 `Settings -> AI Terminal` 配置默认目录、默认模型和各工具启动命令。
4. 在 `AI Sessions` 里先手动创建一个会话，再试一次 `Workflow Preset`。
5. 根据需要补充 `Skills`、`Subagents` 和 `MCP Servers`。
6. 安装 `onespace` CLI，开始在终端里创建会话。
## 开发
```bash
npm install
npm run tauri dev
```
构建：
```bash
npm run tauri build
```
技术栈：
- Tauri 2
- Rust
- React 19
- TypeScript
- Tailwind CSS
- Radix UI
## macOS 常见安装问题
如果 macOS 提示“`OneSpace` 已损坏”，通常是 Gatekeeper 拦截导致：
```bash
sudo xattr -cr /Applications/OneSpace.app
```
## 国际化
- 支持中文和英文界面
- 语言可在 `Settings -> Appearance` 中切换