Kuse Cowork

开源 · 模型无关 · 本地优先的桌面协作代理

用你自己的 AI 密钥，在本地安全地完成真实工作。

Kuse Cowork 是一款由 Kuse 团队开发的轻量级桌面 AI 协作代理，专为重视隐私、追求控制权、拒绝云端黑盒的用户设计。它不绑定任何特定模型，支持你使用 Anthropic、OpenAI、Ollama 或任意 OpenAI 兼容端点，所有数据和执行过程均在本地完成。

核心理念

• BYOK（Bring Your Own Key）：API 密钥由你掌控，永不上传
• 模型无关：Claude、GPT、本地 LLM —— 任你选择
• 本地优先：任务执行、文件访问、数据存储全部在本机
• 安全隔离：通过 Docker 容器隔离命令执行，防止意外或恶意操作

主要特性

隐私与安全

• 所有 API 调用直连你指定的供应商，无中间代理
• 密钥仅存储于本地，无遥测、无日志上传
• Docker 容器隔离：每个外部命令在独立、受限环境中运行
• 开源透明，可审计全部代码

轻量高效

• 基于 Tauri + Rust 构建，应用体积约 10MB
• 内存安全、启动迅速、资源占用低
• 原生支持 macOS（Intel/ARM）、Windows、Linux

可扩展能力

• 技能系统（Skills）：默认支持 docx、pdf、pptx、xlsx 等文档处理
• MCP（Model Context Protocol）：无缝集成外部工具与服务
• 支持自定义技能开发，扩展代理能力边界

灵活模型接入

• Anthropic Claude（如 Claude 3.5 Sonnet）
• OpenAI GPT 系列
• 本地模型（Ollama、LM Studio 等 OpenAI 兼容端点）
• 自定义 API 端点

快速开始

1. 配置 AI 模型

• 打开设置（侧边栏齿轮图标）
• 选择服务商并输入你的 API 密钥（或本地模型地址）
• 选择偏好模型（如 claude-3-5-sonnet、gpt-4o 等）

🔑 所有密钥仅保存在本地，绝不共享或上传。

2. 设置工作空间

• 创建新任务时，点击 “选择项目路径”
• 指定一个本地文件夹作为上下文目录
• 代理将在此范围内读取、生成、修改文件

3. 发起任务

描述你的需求，例如：

• “整理我的会议记录，提取待办事项”
• “读取所有 PDF 发票，生成月度费用汇总表”
• “将这份技术文档转为 PPT 演示文稿”

代理将自动规划步骤、执行操作，并在界面中展示全过程。

开发与构建

环境要求

• Node.js 18+
• Rust（用于 Tauri）
• Docker Desktop（启用容器隔离所必需）

⚠️ 若未安装 Docker，应用仍可运行，但命令执行将失去隔离保护，请谨慎使用。

构建步骤

git clone https://github.com/kuse-ai/kuse-cowork.git
cd kuse-cowork
npm install
npm run tauri dev      # 开发模式
npm run tauri build    # 构建生产版本

项目结构

kuse-cowork/
├── src/                # 前端（SolidJS + TypeScript）
├── src-tauri/          # 后端（Rust）
│   ├── agent/          # 协作代理核心逻辑
│   ├── tools/          # 内置工具（文件读写等）
│   ├── skills/         # 技能模块（PDF/DOCX/PPTX 等）
│   ├── mcp/            # MCP 协议实现
│   └── database.rs     # 本地状态存储
└── tauri.conf.json     # 应用配置

安全说明

• 早期项目：当前为 v0.0.2，功能仍在完善中
• 文件访问风险：代理可读写你指定的工作目录，请勿授予敏感路径权限
• 容器依赖：强烈建议启用 Docker 以获得完整安全隔离
• 开源可审计：所有代码公开，欢迎社区审查与贡献