---

✨ 为什么用？

Kidai Plugin Remote 是 DSH 的外部插件管理器。Client 版把它装进一个 Electron 原生窗口：自带 运行时，下载解压、双击即用——最适合发给别人用，或放在 GitHub Releases 分发。

• 🚀 双击即用 —— 真正的桌面窗口，没有浏览器标签页、没有命令行
• 📦 零依赖 —— 内置 Electron（zip 约 143 MB），不需要安装 Node.js
• 🖥 原生窗口 —— 独立窗口，关窗即退出（UI ↔ 服务器联动保持）
• 📌 发送快捷方式 —— 设置页一键：在任意选定目录创建快捷方式
• 🎨 8 套主题 —— 与经典版相同的主题，服务器端记忆（随机端口也不丢）
• 🔗 数据互通 —— 与经典版、内部守护共享同一快照存储与守护目录
• 🛡 隔离值守 —— 隔离运行期间关窗会弹确认，防止意外丢失值守

打开即用 —— 经典版的所有能力都在这个原生窗口里。

---

🚀 快速开始

下载 kidai-plugin-remote-client → 解压 → 双击
Kidai Plugin Remote Client.exe

完事。查看 / 启停 / 启动 / 隔离 / 快照 / 回滚——全都在。

---

🔗 生态

仓库	职责	运行位置
kidai-plugin-remote-client（你在这里）	同一管理器，原生窗口，零依赖	DSH 之外
kidai-plugin-remote	外部管理器（浏览器界面）	DSH 之外
kidai-snapshot-guard	快照、待确认→已验证、自动恢复	DSH 内部

客户端使用自己的管理器数据目录（%LOCALAPPDATA%\KidaiPluginRemoteClient）， 可与经典版并排运行；同时与经典版、内部守护共享快照存储 （$DSH_HOME/.kidai-snapshots）与守护目录（$DSH_HOME/guard/）。

---

📸 技术细节

• 进程内服务器 — 主进程通过动态 import 启动 KPR 服务器（kpr/server.js）， 在随机本地端口上承载 UI（无浏览器、无独立终端）。关闭窗口 = 退出整个客户端。
• IPC 桥 — 极简 preload 暴露 kprClient.createShortcut()；主进程弹出原生 目录选择器，用 PowerShell WScript.Shell 写 .lnk（EncodedCommand，ASCII 安全）。
• 韧性 — 继承管理器的容错：任何单个损坏的 bundle 都会被报告，绝不致命。

kidai-plugin-remote-client/
├── app/
│   ├── main.js      # Electron 主进程：启动服务器、承载窗口、快捷方式 IPC
│   ├── preload.js   # contextBridge → kprClient
│   ├── package.json
│   └── kpr/         # 完整 Kidai Plugin Remote 服务器（构建时复制）
├── build-client.ps1 # 打包 dist\（Electron + app），重命名 exe
├── vendor/          # electron-win32-x64.zip（只需下载一次）
└── dist/            # 产物：Kidai Plugin Remote Client.exe

上游更新后重建：powershell -File build-client.ps1。

📄 License

MIT