NokorinNishikino/kidai-plugin-remote-client

🖥 Kidai Plugin Remote Client · 纪代管理 Client

双击即用的独立窗口版 Kidai Plugin Remote —— 自带运行时 · 无需 Node · 无需浏览器

简体中文 · English

✨ 为什么用？

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