Hakunm/dsh-workspace
30Last commit Aug 14, 2026
dsh-workspace DSH plugin
dsh-workspace integrates a file workspace directly into the DSH WebUI, allowing you to browse, edit, and organize local files. It also provides a stable API for remote clients like the dsh-android-app to access chat, workspace, and file capabilities. The plugin supports Windows, macOS, and Linux with prebuilt binaries.
How to install the dsh-workspace DSH plugin
dsh plugin --profile web add https://github.com/Hakunm/dsh-workspace/releases/download/v1.0.0/dsh-workspace-1.0.0.tgzCopying does not run this command. Review the repository and version before installing the dsh-workspace DSH plugin.
dsh-workspace DSH plugin data source
dsh-workspace DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-workspace DSH plugin can do
- Lazy-load directory browsing with file creation, upload, download, rename, move, and delete operations.
- CodeMirror 6 editor for UTf-8 text files, preserving BOM and line endings, with ETag conflict detection.
- Trash recovery system: deleted files go to a plugin-managed trash before permanent removal.
- Remote access via REST API with device pairing, token-based auth, and granular permissions per scope and root.
- Manage DSH workspaces, sessions, messages, model selection, agent presets, and slash commands via API.
- Stream real-time events (chat, runs, approvals, file changes) over WebSocket.
Where the dsh-workspace DSH plugin fits
- Edit code or text files directly in the DSH WebUI without leaving the interface.
- Connect a mobile app (e.g., dsh-android-app) to continue conversations and manage files remotely.
- Integrate custom third-party clients with DSH using the documented REST API and SDK.
- Set up a secure local network file server with authentication and access control for team collaboration.
- Automate session management, message sending, or file operations via scripts using the API.
Who the dsh-workspace DSH plugin is for
- DSH users who want a built-in file manager within the WebUI.
- Developers or power users needing remote access to DSH from mobile devices or custom applications.
dsh-workspace DSH plugin limitations
- Only supports editing UTF-8 text files; binary files are read-only (metadata, download, replace).
- Remote access is disabled by default and must be manually enabled; HTTP is not encrypted.
- Requires Node.js ^22.19.0 or >=24.0.0 and a running DSH WebUI instance.
- File operations are confined to explicitly authorized root directories; paths are validated against symlink escapes.
- The plugin is in version 1.0.0 and may have limited stability; see CI notes for compatibility.
dsh-workspace DSH plugin: from the repository README
Quoted from the Hakunm/dsh-workspace README, the upstream source of the dsh-workspace DSH plugin. Copyright remains with the original authors.
中文 · <a href="./README.en.md">English</a> </p> <p align="center"> <img alt="Version" src="https://img.shields.io/badge/version-v1.0.0-087f8c"> <img alt="DSH plugin" src="https://img.shields.io/badge/DeepSeek_Harness-plugin-1f2328"> <img alt="Platforms" src="https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-586069"> <img alt="License" src="https://img.shields.io/badge/license-AGPL--3.0-2da44e"> </p> `dsh-workspace` 是 DeepSeek Harness（DSH）的 WebUI 文件工作区与远程访问插件。安装后，你可以留在 DSH WebUI 里浏览、编辑和整理本机文件，也可以让 [dsh-android-app](https://github.com/Hakunm/dsh-android-app) 通过版本化 API 连接同一套聊天、工作区和文件能力。 界面默认中文，可随时切换 English。插件支持 Windows、macOS 和 Linux，安装包已经包含编译产物，不要求用户在服务器上重新构建。 ## 实际效果 文件工作区直接显示在 DSH WebUI 中，目录树、编辑器和文件操作集中在同一个窗口。  远程访问默认关闭。管理员可在本机 WebUI 中设置绑定 IP、端口和新设备的初始权限。  ## 快速安装 ### 环境要求 - 已安装并能正常启动的 DeepSeek Harness WebUI - Node.js `^22.19.0` 或 `>=24.0.0` - 默认端口 `3090` 可用，或准备一个其他端口 使用运行 DSH WebUI 的同一系统用户执行： ```sh dsh plugin --profile web add https://github.com/Hakunm/dsh-workspace/releases/download/v1.0.0/dsh-workspace-1.0.0.tgz npx @deepseek
Read the full READMERepository license: AGPL-3.0
dsh-workspace DSH plugin questions
I installed the plugin but don't see the 'Files' entry in the sidebar.
Make sure you installed the plugin in the 'web' profile and restarted the DSH WebUI after installation. The plugin entry appears in the sidebar only after a restart. If it still doesn't show, check your DSH version compatibility.
The 'Enable and create pairing' button is disabled. What's wrong?
You need to add at least one authorized root directory in the workspace settings first. Go to 'Files' > 'Workspace Settings' > 'Root Directories' and add a directory. Also, if you changed the bind IP or port, you must save the listening settings before the button becomes active.
My mobile phone can't connect to the remote access. What should I check?
First, ensure remote access is enabled in the plugin settings. Then check that your server's firewall and cloud security group allow the configured port. The address you enter in the app must be reachable from the phone (e.g., the server's LAN IP, not 127.0.0.1). Also verify that the pairing code is within the 10-minute validity.
Why do I get a conflict error when saving a file?
The file has been modified by another window or program since you opened it. The plugin uses ETag to detect changes. Reload the file (which will discard your local edits), then merge the changes you need and save again. To avoid conflicts, avoid editing the same file from multiple places simultaneously.
How do I upgrade or uninstall the plugin?
To upgrade, stop the DSH WebUI, install the new version with `dsh plugin --profile web add <new-tarball>`, then restart. To uninstall, run `dsh plugin --profile web remove dsh-workspace`. Note that uninstalling does not remove the plugin's state directory or trash; you can manually delete the `dsh-workspace` folder under your DSH_HOME if needed.