dsh-remote-plugin 0.5.6-rc.1 → 0.5.6

package/README.en.md

@@ -0,0 +1,45 @@
+# dsh-remote-plugin
+
+[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)
+
+**English** · [中文](README.md)
+
+The DSH bundle plugin for DSH Remote: registers a native entry in DSH's left sidebar and opens an admin drawer from the right. The plugin **bundles the gateway and auto-starts/stops it with DSH** (standalone systemd unit); the drawer shows the token, host IP and device monitor. Works with the [dsh-Remote](https://github.com/Blank-not-black/dsh-Remote) Android app for remote control and file transfer (`/fs/list`, `/fs/file`, `/fs/upload`). The panel ships four themes (Deep Space / Sunset / Elbphilharmonie / Prairie Tower) — light / dark / neutral, following the system preference automatically.
+
+## Install
+
+```sh
+dsh plugin --profile web add dsh-remote-plugin
+# or pin a version
+dsh plugin --profile web add dsh-remote-plugin@0.5.0
+```
+
+Restart DSH Web and hard-refresh (Ctrl+F5); the app icon entry appears at the bottom of the left sidebar.
+
+git source install (equivalent):
+
+```sh
+dsh plugin --profile web add "github:Blank-not-black/dsh-Remote#main&path:/packages/plugin"
+```
+
+## Gateway
+
+- Auto-start by default: on DSH startup or drawer refresh, the plugin launches the built-in `gateway.cjs` (`0.0.0.0:8787`), independent of the DSH process; Linux uses a standalone systemd unit, and environments without systemd (e.g. macOS) automatically fall back to a resident child process.
+- On/off intent persists in `~/.dsh-remote/gateway.enabled`; it can be stopped/started from the drawer.
+- Token lives in `~/.dsh-remote/token` (auto-generated on first run, reused and never overwritten), shown in the drawer and copyable; supports **QR pairing** and **one-click rotation**.
+- Env var `DSH_REMOTE_AUTOSTART=0` disables auto management.
+- File endpoints: `/fs/list` (list directory), `/fs/file` (download with Range support), `/fs/upload` (chunked resume with pause/cancel, SHA-256 verified before writing to disk); default root is `~`, and `DSH_REMOTE_FS_ROOT` opens multiple roots (`:`-separated).
+
+## Mobile App
+
+The app is embedded in the plugin package (`apk/dsh-remote.apk`) — install the plugin and you have it, no GitHub needed:
+
+- Tap **QR code** in the desktop drawer → scan it with the phone to open the admin page → download the app from that page
+- Or open `http://<gateway-IP>:8787` in a browser to download
+- App updates are pushed by the gateway too (`update.json` relative path), never touching GitHub
+
+The app has built-in multi-server latency switching and offline chat history caching; downloaded files are stored in the system `Download/dsh-remote` folder.
+
+## License
+
+MIT

package/README.md

@@ -2,7 +2,9 @@
 
 [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)
 
-DSH Remote 的 DSH bundle 插件：在 DSH 左侧原生边栏注册入口，点击从右侧滑出管理抽屉；插件**内置网关程序并随 DSH 自动启停**（独立 systemd 单元），抽屉直显令牌、主机 IP 与设备监控，配合 [dsh-Remote](https://github.com/Blank-not-black/dsh-Remote) 的 Android App 实现手机远程操控与文件互传（`/fs/list`、`/fs/file`、`/fs/upload`）。
+**中文** · [English](README.en.md)
+
+DSH Remote 的 DSH bundle 插件：在 DSH 左侧原生边栏注册入口，点击从右侧滑出管理抽屉；插件**内置网关程序并随 DSH 自动启停**（独立 systemd 单元），抽屉直显令牌、主机 IP 与设备监控，配合 [dsh-Remote](https://github.com/Blank-not-black/dsh-Remote) 的 Android App 实现手机远程操控与文件互传（`/fs/list`、`/fs/file`、`/fs/upload`）。面板内置四套皮肤（深空 / 落日 / 易北爱乐厅 / 草原孤塔），亮暗中性三档随系统偏好自动切换。
 
 ## 安装
 
@@ -22,7 +24,7 @@ dsh plugin --profile web add "github:Blank-not-black/dsh-Remote#main&path:/packa
 
 ## 网关
 
-- 默认**自动启动**：DSH 启动或抽屉刷新时，插件会拉起内置 `gateway.cjs`（`0.0.0.0:8787`），独立于 DSH 进程。
+- 默认**自动启动**：DSH 启动或抽屉刷新时，插件会拉起内置 `gateway.cjs`（`0.0.0.0:8787`），独立于 DSH 进程；Linux 使用独立 systemd 单元，macOS 等无 systemd 环境自动回退为常驻子进程。
 - 开关持久化在 `~/.dsh-remote/gateway.enabled`；抽屉内可停止/启动。
 - 令牌在 `~/.dsh-remote/token`（首次自动生成，重复使用不覆盖），抽屉里显示并可复制；支持**二维码扫码配对**与**一键轮换**。
 - 环境变量 `DSH_REMOTE_AUTOSTART=0` 可关闭自动管理。
@@ -30,7 +32,13 @@ dsh plugin --profile web add "github:Blank-not-black/dsh-Remote#main&path:/packa
 
 ## 手机 App
 
-从 [Releases](https://github.com/Blank-not-black/dsh-Remote/releases/latest) 下载 `dsh-remote.apk`。推荐在抽屉点「二维码」，App「设置 → 扫码连接」直接配对；也可手动添加多个服务器地址（局域网 + Tailscale），点「测速」自动选最快。聊天记录会本地缓存，断网也能看历史；下载的文件统一放系统「下载/dsh-remote」。
+App 已随插件包内嵌（`apk/dsh-remote.apk`），装好插件即可获取，无需上 GitHub：
+
+- 桌面抽屉点「二维码」→ 手机扫码打开管理页 → 页面提供 App 下载
+- 或浏览器直接访问 `http://<网关IP>:8787` 下载
+- App 更新同样走网关自动推送（`update.json` 相对路径），全程不绕 GitHub
+
+App 内置多服务器测速切换与聊天记录离线缓存，下载文件统一放系统「下载/dsh-remote」。
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-remote-plugin",
-  "version": "0.5.6-rc.1",
+  "version": "0.5.6",
   "description": "DSH Remote 官方 bundle 插件：DSH 左侧原生边栏入口 + 右侧抽屉内嵌管理控制台；内置网关随 DSH 自动启停(systemd 独立单元)，抽屉直显令牌与设备监控；网关提供 /fs/* 文件传输端点(列表/断点下载/上传)，配合 Android App 远程操控会话/审批/提问/goal 与文件互传(多服务器测速切换、聊天记录离线缓存)。",
   "type": "module",
   "main": "./index.mjs",
@@ -16,7 +16,8 @@
     "gateway.cjs",
     "public",
     "apk",
-    "cordis.patch.yml"
+    "cordis.patch.yml",
+    "*.md"
   ],
   "keywords": [
     "dsh-plugin",

package/public/update.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.5.6-rc.1",
+  "version": "0.5.6",
   "apkUrl": "dsh-remote.apk",
-  "releasedAt": "2026-08-16T15:29:43.309Z",
-  "notes": "修复：APK 内置版本文件滞后导致“已装新版本仍提示更新”；检查更新弹窗只显示版本号，完整说明在设置页展开查看"
+  "releasedAt": "2026-08-16T16:35:38.295Z",
+  "notes": "本次更新：插件包文档双语化，手机 App 分发说明改为网关内嵌 APK；macOS (Apple Silicon) 网关预览版改为独立发布，不随 Android/Windows/Linux 版本号更新；功能与 v0.5.5 相同。"
 }

package/public/version.json

@@ -1,3 +1,3 @@
 {
-  "version": "0.5.6-rc.1"
+  "version": "0.5.6"
 }