deepseekplugins

DeepSeek Harness plugin

dsh-local-project

DSH plugin: import a local folder as a server workspace and sync DSH changes back to local.

Tools & Capabilities
Jump to install

Source facts

Repository
0xKcyzz/dsh-local-project
Latest update
Aug 15, 2026
Category
Tools & Capabilities
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/0xKcyzz/dsh-local-project
Plugin: dsh-local-project
Author: 0xKcyzz

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

<p align="center">

<strong>简体中文</strong> | <a href="README_EN.md">English</a>

</p>

<p align="center"> <img alt="License" src="https://img.shields.io/badge/license-MIT-0B7285?style=flat-square"> <img alt="DSH Plugin" src="https://img.shields.io/badge/DSH-Plugin-5B4CF0?style=flat-square"> <img alt="Platform" src="https://img.shields.io/badge/platform-Web-4B6FFF?style=flat-square"> <img alt="Sync" src="https://img.shields.io/badge/sync-WebSocket-00B8A9?style=flat-square"> <img alt="File System Access" src="https://img.shields.io/badge/API-File%20System%20Access-4B6FFF?style=flat-square"> </p>

DSH Local Project · 本地项目

> 将本地文件夹导入为服务器 DSH 的工作区，并让 DSH 的修改自动同步回本地文件夹。 > 适合在浏览器中把本机代码或资料交给远程 DSH 直接读写，同时保留本地副本。

功能特性

  • 点击「添加工作区」选择本地文件夹，自动上传并在服务器创建镜像工作区。
  • DSH 使用原生 read/write/edit/glob/bash 工具直接操作服务器镜像，无需自定义工具。
  • DSH 修改文件后通过 WebSocket 实时同步回本地，断线自动重连并补齐漏掉的变更。
  • 删除项目只删除服务器副本与工作区记录，不影响本地文件。
  • 刷新页面后可从服务器恢复项目列表，并可重新选择本地文件夹恢复同步。

安装

dsh plugin --profile web add github:0xKcyzz/dsh-local-project

安装后重启 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 /local-project/rev获取项目变更号
GET /local-project/pull获取断线期间漏掉的变更
GET /local-project/list列出服务器镜像项目
GET /local-project/manifest获取服务器文件清单
GET /local-project/download下载服务器文件（base64）
POST /local-project/delete删除服务器目录 + 工作区记录
GET /local-project/wsWebSocket 实时变更推送

配置（环境变量）

变量默认值说明
DSH_LOCAL_PROJECT_ROOT$DSH_HOME/workspaces本地项目的服务器镜像目录。

开发 / 构建

npm install
npm run build   # 产出 lib/index.js（Host）+ lib/client.js（浏览器）

License

[MIT](LICENSE)

Back to searchOpen GitHub repository

More related plugins

View category