Skip to content

README.zh-CN.md

Latest commit

 

History

History
223 lines (160 loc) · 12.2 KB

README.zh-CN.md

File metadata and controls

223 lines (160 loc) · 12.2 KB
Raw

Minke 图标

Minke

基于 DeepSeek Harness 的本地优先桌面智能体工作空间

English · 简体中文

Minke downloads Minke Discord 在 X 上关注 @lencx_ 请我喝杯咖啡

Minke 是基于 DeepSeek Harness 的本地优先桌面智能体工作空间。你可以围绕对话、项目文件、终端和可见的浏览器标签页与 Agent 协作，随时接管网页操作、检查和编辑产出的文件，也可以从其他设备访问工作空间。

Important

Minke 正在持续开发中，功能、打包方式和本地数据结构可能随项目迭代发生变化。本 README 描述当前源码，已发布安装包的功能可能有所不同。Minke 是独立的社区项目，并非 DeepSeek 官方产品。

核心亮点

Minke 在 Harness 智能体能力的基础上，提供浏览器共同控制、桌面工作空间、远程访问和本地模型管理。

  • Agent Browser 与人机协作 — Agent 可以在可见的浏览器标签页中搜索、打开并操作网页；你可以在不关闭当前标签页的情况下接管、完成后交还给 Agent，也可以把带标注的页面上下文发回对话。
  • 灵活的工作空间与文件编辑 — 通过 Harness 侧栏的分屏、浮动和全屏标签页，以及 Minke 独立的底栏，将文件、终端、网页、浏览历史和插件放在对话旁边。直接编辑源码、查看 Diff，并预览 Markdown 和 HTML 草稿。
  • 智能体工作流与会话历史 — 使用 Harness 的智能体预设（Agent Presets）、计划、目标、技能和子代理。通过对话轮次目录浏览长会话、跳转到早期轮次、导出会话日志，也可以让 Agent 安排会话内的定时跟进。
  • 在常用设备和应用中远程使用 — 从手机或其他电脑打开支持 PWA 的响应式 Web 工作空间，或通过微信、Telegram 与 Discord 向 Minke 电脑上的 Agent 发起任务。Web 私密访问支持 Tailscale 和 Cloudflare Access。
  • 云端与本地模型 — 使用 Harness 的模型提供方和自定义端点，并通过 Minke 发现 LM Studio、Ollama 中的模型，按需启用服务自动启动。其他仅监听本机回环地址的 OpenAI 兼容服务也可手动配置。
  • 可查看运行状态的插件管理 — 发现、安装、启用或禁用 Harness 插件，并查看运行中、加载中或加载失败等状态。遇到启动问题时，可通过安全模式排查，同时保留已安装插件。
  • 桌面集成与本地存储 — macOS、Windows 和 Linux 版本提供原生菜单、自定义快捷键、内置更新、主题同步及中英文界面。Session、设置、浏览历史和浏览器会话数据保留在你的电脑上。
Minke 对话工作空间 Minke 代码工作区：文件 Diff 与终端
Minke 设置与工作空间 Minke Agent 浏览器
Minke 通过微信、Telegram 和 Discord 远程控制 Minke 插件工作空间与 Tabs 布局

从其他设备远程访问

Minke 的远程访问是由 Minke Host 支撑的响应式 Web 客户端，并不是 Electron 窗口的视频流或触控投影。你可以在手机上继续对话、启动智能体任务、管理项目文件， 并使用实际运行在 Minke 电脑上的终端。

Minke 在手机与桌面上的远程工作空间

Note

Tailscale Serve HTTPS、Tailscale Direct IP 和 Cloudflare Access 均已完成端到端测试回归，目前都可以使用。

  • Tailscale Serve HTTPS（推荐） — 适合已经加入同一 tailnet 的设备，提供安全的 HTTPS 地址，并支持安装 PWA。
  • Tailscale Direct IP（高级） — 仅绑定当前设备的 Tailscale IPv4。流量仍由 Tailscale 端到端加密，但访问地址是 HTTP，不属于浏览器安全上下文。
  • Cloudflare Access — 通过受身份策略保护的 Named Tunnel 从公网访问，手机无需安装 Tailscale；使用前需配置 Cloudflare Tunnel、Access 应用和允许访问的身份。

推荐方案：Tailscale Serve

Minke 可以通过 Tailscale Serve 私密地提供响应式 Web 界面。Harness 仍然只监听本机回环地址，不会暴露到局域网，也不会启用公开的 Tailscale Funnel。

  1. 在运行 Minke 的电脑和手机上安装 Tailscale，登录同一个 tailnet，并确认电脑已连接。
  2. 打开 Minke 的 连接 → 设备访问 → 远程访问，选择 HTTPS Serve 并启用远程访问。Minke 会在后台连接，无需重启应用。
  3. 在手机上打开界面显示的 https://…ts.net 地址。

安装为 PWA

通过 Tailscale Serve 或 Cloudflare Access 的 HTTPS 地址打开远程页面，点击侧边栏中的 安装 Minke，并接受浏览器的安装提示。在 iPhone 或 iPad 上，请使用 分享 → 添加到主屏幕。 安装后会以独立应用模式启动；网络较差时会展示连接中或离线状态，而不是静默展示 缓存的工作空间内容。

Minke 同一时间只启用一条远程链路，并只在应用运行期间持有前台代理，退出时会将其停止。远程页面能够启动 Agent 任务，并使用 Minke 已授权的本机工具，因此请只允许可信的 tailnet 成员或 Cloudflare Access 身份访问。

安装

请仅从 Minke 官方 GitHub Releases 页面下载安装包。

平台 架构 安装包
macOS Apple Silicon（arm64） .dmg
macOS Intel（x64） .dmg
Windows x64 .exe
Linux Debian / Ubuntu（x64） .deb
Linux Fedora / RHEL（x64） .rpm
Linux x64（便携 AppImage） .AppImage

打包后的 macOS、Windows 和 Linux 版本都会自动检查稳定更新。Minke 会为当前系统 选择名称固定的 DMG、EXE、DEB、RPM 或 AppImage，校验 GitHub 不可变 Release、 下载地址链、精确大小、SHA-256 和系统可用的来源属性，再询问是否打开。可在 设置 → Minke → 偏好设置 → 软件更新 中关闭后台下载；关闭后必须先确认“下载更新”。 也可随时在 关于 Minke → 检查更新 中手动触发。安装过程始终需要用户明确确认。 用户操作和各平台行为见桌面应用更新说明。

macOS

  1. 下载并打开 .dmg 文件。

  2. 将 Minke.app 拖入“应用程序”目录。

  3. 当前预发布版本尚未经过 Apple 公证。请先尝试在 系统设置 → 隐私与安全性 中使用 Apple 提供的“仍要打开”流程。

  4. 仅当你明确接受风险且系统流程不可用时，才对已安装应用的精确路径移除 quarantine：

    xattr -dr com.apple.quarantine "/Applications/Minke.app"

  5. 从“应用程序”目录打开 Minke。

Caution

移除 quarantine 属性会绕过一项 macOS 安全检查。Minke 更新器绝不会自动执行该命令。请仅将它作为最后手段，对从官方 Releases 页面下载的 Minke.app 使用，并且不要把路径替换为宽泛目录。

在 macOS 上授权凭据存储

Minke 仅在你打开连接并点击授权凭据访问后请求钥匙串权限。如果 macOS 弹出系统窗口，请输入 Mac 登录密码并选择始终允许；如果拒绝了访问，点击 重新请求授权即可。

如果凭据存储仍不可用，一种可能原因是应用签名无效或被修改，导致 macOS 无法 识别 Minke 的钥匙串身份。先校验应用：

codesign --verify --deep --strict --verbose=2 "/Applications/Minke.app"

如果可信的旧预发布构建校验失败，并且不便重新安装，请先完全退出 Minke，再修复 签名并重新打开：

/usr/bin/codesign --force --deep --sign - --timestamp=none "/Applications/Minke.app" \
  && /usr/bin/codesign --verify --deep --strict --verbose=2 "/Applications/Minke.app" \
  && /usr/bin/open "/Applications/Minke.app"

Warning

临时重签会替换已安装应用的现有签名。不要对具有有效 Developer ID 签名且经过 Apple 公证的版本执行；请改为重新安装官方构建。不要删除 ~/.minke/secrets 或“钥匙串访问”中的 Minke Safe Storage 项，已有通道凭据依赖这些数据。

Windows

  1. 下载 Windows x64 .exe 安装程序。
  2. 运行安装程序，并按照界面提示完成安装。
  3. 新发布的预览版本可能触发 Windows 信誉安全提示。请先确认安装程序来自 Minke 官方 Releases 页面，再决定是否继续。

Linux

根据发行版下载对应安装包，可以通过图形化软件管理器打开，也可以在终端中安装。

Debian / Ubuntu：

sudo apt install "/path/to/minke-package.deb"

Fedora / RHEL：

sudo dnf install "/path/to/minke-package.rpm"

请将示例路径替换为实际下载的安装包路径。

从源码构建

请在与目标安装包相同的操作系统和 CPU 架构上构建 Minke。构建产物位于 out/make，本项目不支持在单一宿主机上进行跨平台打包。

内置 Harness 的版本、源码提交和应用的补丁记录在 runtime 配置中。

环境依赖：

  • 支持 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：

pnpm run harness:stage

该命令会安装并构建项目固定版本的 DeepSeek Harness 源码，然后将可复用的桌面 runtime 生成到 runtime/host。首次检出源码，或固定的 Harness 源码及 runtime 契约发生变化后，需要执行一次。

使用开发模式启动 Minke：

pnpm start

pnpm start 会刷新已准备 runtime 中的 Minke 集成，并启动开发应用。

为当前平台生成安装包：

pnpm make

pnpm make 会先重新执行一次完整的 runtime 准备流程，再将当前平台的安装包生成到 out/make。

macOS 钥匙串按代码签名识别应用。默认的本地包使用临时 ad-hoc 签名，每次源码 变化后都可能被视为新应用；跨版本稳定授权必须使用同一个有效签名证书。可先用 security find-identity -v -p codesigning 查找身份，然后在打包进程中设置：

MINKE_MACOS_SIGN_IDENTITY="Developer ID Application: …" pnpm make

CI 使用独立钥匙串时还可设置 MINKE_MACOS_SIGN_KEYCHAIN。不要把证书私钥或 钥匙串密码提交到仓库。