kidai-plugin-remote-client
其他 活跃维护

kidai-plugin-remote-client

NokorinNishikino/kidai-plugin-remote-client

零依赖桌面客户端,提供插件的启停管控、隔离运行、手动回滚、预检诊断与变砖救急能力,搭配KSG工具可自动保存运行快照、实现备份一键回滚,操作轻便。

1
Stars 标星
0
Forks 分支
1
Watchers 关注
0
Open Issues
JavaScript
主要语言
None
开源协议
12 KB
仓库大小
1 个月前
最后推送
一键安装扩展 / 插件指令
dsh plugin --profile web add github:NokorinNishikino/kidai-plugin-remote-client
git clone https://github.com/NokorinNishikino/kidai-plugin-remote-client.git
git clone git@github.com:NokorinNishikino/kidai-plugin-remote-client.git
README.md master
# 🖥 Kidai Plugin Remote Client · 纪代管理 Client **双击即用的独立窗口版 Kidai Plugin Remote** —— 自带运行时 · 无需 Node · 无需浏览器 **简体中文** · [**English**](https://github.com/NokorinNishikino/kidai-plugin-remote-client/blob/master/README.en.md)

✨ 为什么用?

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