跳到主内容

web-plugin 使用指南

面向 DSH Web 宿主平台的极简外部插件,挂入渲染端模块加载器并标记文档根节点,用于校验插件安装与热更新链路。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

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

快速上手

Minke

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:lencx/Minke#path:tests/fixtures/web-plugin

复制以上命令在 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 仓库自带的烟雾测试夹具,仅被 scripts/harness/smoke.mjs 复制到临时目录后通过 dsh plugin add 安装,用来验证宿主能否正确加载并热更新外部 Web 插件。

装上之后界面会有什么变化?

安装后会在宿主页面 document.documentElement 上写入 data-dsh-external-web-plugin="active",普通用户看不到任何界面改动,插件本身不提供业务功能。

它会运行在桌面主进程吗?

不会。包内 dsh.client.platform 声明为 web,lib/index.js 的 apply() 是空函数;真正的副作用发生在客户端(渲染进程)。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 未声明
  • Node: 未声明

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源:通用规则