0xKcyzz/dsh-local-project

README 摘要

简体中文 English DSH Local Project · 本地项目 将本地文件夹导入为服务器 DSH 的工作区，并让 DSH 的修改自动同步回本地文件夹。 适合在浏览器中把本机代码或资料交给远程 DSH 直接读写，同时保留本地副本。 功能特性 - 点击「添加工作区」选择本地文件夹，自动上传并在服务器创建镜像工作区。 - DSH 使用原生 read/write/edit/glob/bash 工具直接操作服务器镜像，无需自定义工具。 - DSH 修改文件后通过 WebSocket 实时同步回本地，断线自动重连并补齐漏掉的变更。 - 删除项目只删除服务器副本与工作区记录，不影响本地文件。 - 刷新页面后可从服务器恢复项目列表，并可重新选择本地文件夹恢复同步。 安装 安装后 重启 DSH ，「添加工作区」会打开本地项目导入对话框。 使用 1. 在 DSH 侧边栏或空状态中点击「添加工作区」。 2. 输入项目名称，点击「选择文件夹并导入」。 3. 在系统对话框中选择本地文件夹（需要 Chrome/Edge 浏览器授权）。 4. 首次导入会开始上传文件；完成后左侧工作区列表出现「本地项目: 名称」。 5. 打开该工作区对话，DSH 操作的是服务器镜像副本，文件改动会自动同步回本地。 限制 - 需要浏览器支持 File System Access API：Chrome / Edge（含 Chromium）。Firefox / Safari 不支持。 - 单个文件上限约 15MB（上传使用 base64 JSON）；超大文件请勿放入项目。 - 不传播单个文件的删除：只有「删除项目」会整包删除服务器副本，本地/服务器各自删除的文件不会被对面清除。 - 本地改动不会自动上传：只有首次导入会上传本地文件；之后本地手改的文件不会同步到服务器。 - 实时推送需要保持 WebSocket 连接；断线会自动重连并补齐漏掉的变更。 - 桌面端 Electron 窗口若 API 不可用，请用系统浏览器打开 DSH 的 Web 地址。 工作原理 - Host 侧 ：提供 /local-project/ HTTP 接口和 WebSocket 推送，负责创建/上传/删除服务器镜像，并用 fs.watch 监听文件变化。 - Client 侧 ：填充 DSH 的「添加工作区」目录流，负责选择本地文件夹、上传文件、接收 WebSocket 变更并写回本地。 - 同步方向为 DSH → 本地 ：服务器文件变化通过 WebSocket 推送，浏览器只下载被改动的文件；不做持续双向同步。 Host 接口 接口 说明 POST /local-project/create 创建服务器目录 + 工作区记录 POST /local-project/upload 上传/覆盖服务器文件（base64） GET …

分类