Minke
为 DeepSeek Harness 打造的原生桌面工作空间
English · 简体中文
Minke 在本地运行 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)，将它带入一个专注、本地优先的智能体桌面工作空间。对话、项目文件、终端、网页工具和原生桌面操作始终触手可及，无需在多个应用之间切换，让工作流保持完整。
> [!IMPORTANT]
> Minke 正在持续开发中，功能、打包方式和本地数据结构可能随项目迭代发生变化。Minke 是独立的社区项目，并非 DeepSeek 官方产品。
## 核心亮点
- **一个完整的智能体工作台** — Minke 将 DeepSeek Harness 从对话窗口扩展成完整的工作空间。文件、终端、网页工具和插件发现能力可以放在彼此独立的右侧与底部工作区中，让理解项目、修改内容和验证结果所需的工具始终与当前对话相邻。
- **本地优先，数据留在设备** — DeepSeek Harness 在本地运行，Minke 应用状态和浏览器会话数据也保留在用户设备上。桌面配置统一存放在 `~/.minke` 下，让应用拥有清晰、可预期的数据边界。
- **为日常使用打造的原生桌面体验** — 原生菜单、可配置快捷键、Session 日志导出、主题同步和中英文界面，让 Minke 适合长期日常使用。macOS 获得原生窗口细节优化，Windows 和 Linux 保留符合各自平台的默认样式，自动化发布流程覆盖三大桌面平台。
## 安装
请仅从 Minke 官方 [GitHub Releases](https://github.com/lencx/Minke/releases) 页面下载安装包。
| 平台 | 架构 | 安装包 |
| --- | --- | --- |
| macOS | Apple Silicon（`arm64`） | `.dmg` |
| macOS | Intel（`x64`） | `.dmg` |
| Windows | `x64` | `.exe` |
| Linux | `x64` | `.deb` 或 `.rpm` |
### macOS
1. 下载并打开 `.dmg` 文件。
2. 将 `Minke.app` 拖入“应用程序”目录。
3. 当前预发布版本尚未经过 Apple 公证。打开“终端”，移除已安装应用的 quarantine 属性：
```bash
xattr -dr com.apple.quarantine "/Applications/Minke.app"
```
4. 从“应用程序”目录打开 Minke。
> [!CAUTION]
> 移除 quarantine 属性会绕过一项 macOS 安全检查。请仅对从官方 Releases 页面下载的 `Minke.app` 执行上述命令，不要将命令中的路径替换为宽泛目录。也可以尝试在 **系统设置 → 隐私与安全性** 中使用 Apple 提供的[“仍要打开”](https://support.apple.com/zh-cn/102445)流程。
### Windows
1. 下载 Windows x64 `.exe` 安装程序。
2. 运行安装程序，并按照界面提示完成安装。
3. 新发布的预览版本可能触发 Windows 信誉安全提示。请先确认安装程序来自 Minke 官方 Releases 页面，再决定是否继续。
### Linux
根据发行版下载对应安装包，可以通过图形化软件管理器打开，也可以在终端中安装。
Debian / Ubuntu：
```bash
sudo apt install "/path/to/minke-package.deb"
```
Fedora / RHEL：
```bash
sudo dnf install "/path/to/minke-package.rpm"
```
请将示例路径替换为实际下载的安装包路径。
## 从源码构建
请在与目标安装包相同的操作系统和 CPU 架构上构建 Minke。构建产物位于 `out/make`，本项目不支持在单一宿主机上进行跨平台打包。
环境依赖：
- 支持 submodule 的 Git，并确保已检出 `vendor/deepseek-harness` 子模块。
- Node.js 24 或更高版本。
- pnpm 11.7.0；执行脚本前需已安装仓库依赖。
- macOS：Apple Silicon 或 Intel Mac，并安装 Xcode Command Line Tools；`.dmg` 只能在 macOS 上构建。
- Windows：Windows x64；如果原生依赖需要在本地编译，可能还需要安装 Visual Studio 2022 Build Tools，并选择 **Desktop development with C++** 工作负载。
- Linux：Linux x64，并安装原生编译工具链、`fakeroot`、`dpkg`，以及 `rpm` 或 `rpm-build`。
首次检出源码并安装仓库依赖后，先准备 Harness runtime：
```bash
pnpm run harness:stage
```
该命令会安装并构建项目固定版本的 DeepSeek Harness 源码，然后将可复用的桌面 runtime 生成到 `runtime/host`。首次检出源码，或固定的 Harness 源码及 runtime 契约发生变化后，需要执行一次。
使用开发模式启动 Minke：
```bash
pnpm start
```
`pnpm start` 会刷新已准备 runtime 中的 Minke 集成，并启动开发应用。
为当前平台生成安装包：
```bash
pnpm make
```
`pnpm make` 会先重新执行一次完整的 runtime 准备流程，再将当前平台的安装包生成到 `out/make`。