Hakunm/dsh-workspace
30最近提交 2026年8月14日
dsh-workspace DSH 插件
dsh-workspace 将文件工作区直接嵌入 DSH WebUI，支持浏览、编辑和组织本地文件。同时提供稳定的 REST API，让 dsh-android-app 等远程客户端访问聊天、工作区和文件功能。插件支持 Windows、macOS 和 Linux，已预编译。
如何安装 dsh-workspace DSH 插件
dsh plugin --profile web add https://github.com/Hakunm/dsh-workspace/releases/download/v1.0.0/dsh-workspace-1.0.0.tgz复制不会执行命令。安装 dsh-workspace DSH 插件前请核对仓库和版本。
dsh-workspace DSH 插件数据来源
dsh-workspace DSH 插件快照日期：2026年8月16日
discovered
dsh-workspace DSH 插件能做什么
- 懒加载目录浏览，支持新建、上传、下载、重命名、移动和删除文件。
- 基于 CodeMirror 6 的编辑器，处理 UTF-8 文本，保留 BOM 和换行风格，ETag 冲突检测。
- 回收站机制：删除文件先进入插件回收站，可恢复或由管理员永久清理。
- 远程访问通过 REST API，支持设备配对、令牌认证，按作用域和根目录授权精细控制。
- 管理 DSH 工作区、会话、消息、模型选择、Agent 预设和斜杠命令。
- 通过 WebSocket 实时推送聊天、运行、审批和文件变更事件。
dsh-workspace DSH 插件适合哪些场景
- 在 DSH WebUI 中直接编辑代码或文本文件，无需切换界面。
- 通过手机 App（如 dsh-android-app）远程继续对话和管理文件。
- 使用开放 API 集成自定义第三方客户端或脚本。
- 在局域网内搭建带认证和权限控制的文件共享服务，供团队协作。
- 通过 API 自动化管理会话、发送消息或操作文件。
dsh-workspace DSH 插件适合谁
- 希望在 DSH WebUI 内获得文件管理功能的用户。
- 需要从手机或自定义应用远程访问 DSH 的开发者或高级用户。
dsh-workspace DSH 插件的限制
- 仅支持编辑 UTF-8 文本文件；二进制文件只读（查看元数据、下载、替换）。
- 远程访问默认关闭，需手动启用；HTTP 不加密。
- 依赖 Node.js ^22.19.0 或 >=24.0.0，且需要已运行 DSH WebUI。
- 文件操作限定在显式授权的根目录内，路径经过符号链接逃逸检查。
- 插件版本 1.0.0，稳定性可能有限；请参考 CI 兼容性说明。
dsh-workspace DSH 插件的仓库 README 摘录
以下文字摘自 dsh-workspace DSH 插件的上游仓库 Hakunm/dsh-workspace 的 README，版权归原作者，仅作引用。
中文 · <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
阅读完整 README仓库许可: AGPL-3.0
dsh-workspace DSH 插件常见问题
安装后侧栏没有显示“文件”入口。
请确认插件安装在 `web` profile，并在安装后重启了 DSH WebUI。重启后侧栏才会出现“文件”入口。如果仍然不显示，请检查 DSH 版本是否兼容。
“启用并创建配对”按钮不可用，怎么办？
需要先添加至少一个授权根目录。请进入“文件”>“工作区设置”>“根目录”，添加一个目录。如果修改过绑定 IP 或端口，还需要先保存监听设置，按钮才会可用。
手机无法连接远程访问，应该检查哪些？
首先确保插件中已启用远程访问。然后检查服务器防火墙和云安全组是否放行了配置的端口。App 中填写的地址必须能从手机访问（例如服务器局域网 IP，不要填 127.0.0.1）。另外确认配对码在 10 分钟有效期内。
保存文件时提示冲突，是什么原因？
文件在您打开后被其他窗口或程序修改过。插件通过 ETag 检测到冲突。请重新加载文件（会丢弃本地编辑），合并需要保留的内容后再保存。为避免冲突，请不要同时在多个地方编辑同一文件。
如何升级或卸载插件？
升级：先停止 DSH WebUI，使用 `dsh plugin --profile web add <新版本压缩包>` 安装新版本，然后重启。卸载：运行 `dsh plugin --profile web remove dsh-workspace`。注意卸载不会自动删除插件状态目录或回收站，如有需要可手动删除 DSH_HOME 下的 `dsh-workspace` 文件夹。