本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

Minke

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:lencx/Minke#path:packages/harness-overlay

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 不只是对话窗口 — 彼此独立的右侧和底部 Tabs，将文件管理器、终端、浏览器、插件和 Session 详情放在当前对话旁边。插件区支持从 GitHub 发现插件，以及安装、状态检查、修复与卸载。文件管理器支持目录浏览、语法高亮预览、编辑与 Diff；终端则连接运行 Minke 的电脑上的真实 PTY。
• 真正的远程工作空间，而非桌面投影 — Minke Host 将受支持的桌面能力投射到响应式 Web UI。你可以在手机或平板上继续对话、启动智能体任务、管理项目文件和使用宿主机终端，不需要传输 Electron 窗口的像素画面。
• 可安装的 PWA — 通过安全的 HTTPS 地址打开 Minke，即可安装到主屏幕并以独立应用模式启动。PWA 提供完整品牌启动界面和更及时的连接状态反馈，同时不会缓存已认证的工作空间内容。
• 私有远程访问 — Minke 可以通过由应用管理的远程链路提供响应式工作空间。目前完成验证的是 Tailscale Serve HTTPS；Tailscale Direct IP 与 Cloudflare Access 在完成发布测试前仍属于实验性接入。
• 本地模型集成 — Minke 可以发现并连接 LM Studio、Ollama，以及其他仅监听本机回环地址的 OpenAI 兼容服务。可选的生命周期管理能够按需启动受支持的本地运行时，同时不会接管原本已经运行的服务。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件是什么？我应该装哪个 Minke 包？

Minke 桌面版由多包组成，harness-overlay 是其中被注入宿主 DSH runtime 的产品定制层，单独通过 DSH plugin 命令安装到现有的 Harness 运行中；如果你下载的是 GitHub Releases 里的 Minke 桌面安装包，桌面应用已自带此层，不需要单独 add。

装上之后能直接用 LM Studio 和 Ollama 吗？

默认仅发现已运行的本地 LM Studio/Ollama（lifecycle=external）。要自动启动需在 ~/.minke/desktop/minke.config.json 中把 modelRuntime.{lmStudio,ollama}.enabled 设为 true 并启动 Minke 时同时提供 CLI 路径环境变量；手动接入任何兼容 OpenAI 的回环服务可走 openAICompatible 列表。

提供的 Codex 子代理是怎么用的？

此层注入 Harness 的 dsh-subagent-codex 和 tool-subagent（provider=codex），把任务代理到本地 codex app-server --stdio；codex 自身的登录、模型、sandbox、workspace 行为完全由 Codex CLI 自身管理，不在插件权限内。

快捷键能改吗？

可以。默认 8 个动作（palette.open / settings.open / session.new 等），通过产品设置页修改后由 IPC 经 minke:shortcut-settings:read|write 通道持久化；schema 在 shortcut-contract.ts 校验，最多 128 条，按规则 Mod+Shift+...+Key 表达。

安装在 Windows 或 Linux 上和 macOS 上有什么不同？

跨平台都可用；macOS 额外启用半透明、sidebar 与 titlebar 等桌面 Surface 适配，Windows 和 Linux 保留平台默认样式，且受 isolated preload 能力门控控制，dispose 时会移除监听器与样式表。

卸载会影响什么？

卸载时插件 effect 会调用 prepared.dispose()：仅停止本插件启动的服务（LM Studio 仅在明确由本插件启动的实例上清理；Ollama 若是本进程拉起的 ollama serve 也会被关闭）。managed 策略在插件 disposal 时按"是否本插件启动"为条件回收外部服务。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明
• Node: >=24

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则