Hakunm/dsh-workspace 预览 preview

Hakunm/dsh-workspace

一个将文件工作区直接集成到DeepSeek Harness WebUI,并为手机和第三方客户端提供稳定远程接口的双语插件。

Project Overview项目介绍

dsh-workspace is a native plugin built exclusively for DeepSeek Harness (DSH) that adds a fully integrated native file workspace to the DSH WebUI and exposes a standardized remote REST API for external clients. To install the plugin, you need a working running instance of DSH WebUI on your system, plus Node.js version 22.19.0 or newer, and an available network port (the default port is 3090). Precompiled release packages are available for Windows, macOS, and Linux, so you can install it directly via the DSH plugin CLI without needing to build the entire project from source code.

After installation and a restart of DSH WebUI, you will see a new "Files" entry in the WebUI sidebar that lets you browse your local file system directly within the DSH interface. You can create, edit, rename, move, and delete files, and deleted files are sent to a plugin-specific trash can instead of being removed immediately, so you can restore accidentally deleted files. When connecting an external client like the official dsh-android-app, you generate a one-time 10-minute valid pairing code from the DSH WebUI to authenticate the device.

Remote access is disabled by default, and when disabled, the service only listens on the loopback address so it does not expose any services to your local network or the public internet. If you enable remote access on an untrusted network or the public internet, you should use HTTPS via a reverse proxy like Nginx or Caddy, or connect via a VPN or encrypted tunnel like WireGuard to protect your sensitive data. The plugin is released under the open source AGPL-3.0 license, and supports offline installation from a downloaded tarball if you cannot install directly from GitHub.

dsh-workspace 是专为 DeepSeek Harness(DSH)开发的原生插件,可为 DSH WebUI 集成原生文件工作区能力,同时提供标准化远程 REST API 接口,供 Android 客户端和其他第三方客户端调用 DSH 的聊天、文件管理能力。它支持 Windows、macOS、Linux 三大主流桌面平台,发布包已预编译完成,普通用户无需自行重新构建源码即可安装使用。

安装后,DSH WebUI 侧栏会新增“文件”入口,用户可在 WebUI 同一窗口内完成本机文件的浏览、新建、编辑、移动、删除等全流程操作。删除文件会先进入插件回收站,方便误删恢复,同时支持检测文件外部修改,避免冲突覆盖。需要连接移动设备的用户,可通过一次性配对码完成授权连接。

该插件要求用户已安装可正常运行的 DSH WebUI,且 Node.js 版本需为 ^22.19.0 或 >=24.0.0。它采用 AGPL-3.0 开源许可证,远程访问默认关闭,仅在未启用时监听回环地址,不会主动暴露服务到公网。公网部署需配置 HTTPS 或通过加密隧道连接,避免数据泄露。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • Only 6 stars - very few users, little community feedback星标只有 6,几乎没人在用,遇到问题缺少社区反馈
  • Desktop client: installation downloads an executable - verify the publisher and checksums桌面客户端:安装会下载可执行文件,请核对发布者与校验和
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add https://github.com/Hakunm/dsh-workspace/releases/download/v1.0.0/dsh-workspace-1.0.0.tgz

把 Hakunm/dsh-workspace 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-workspace

把文件工作区直接带进 DeepSeek Harness WebUI,并为手机和第三方客户端提供稳定的远程接口。

中文 · English

Version DSH plugin Platforms License

dsh-workspace 是 DeepSeek Harness(DSH)的 WebUI 文件工作区与远程访问插件。安装后,你可以留在 DSH WebUI 里浏览、编辑和整理本机文件,也可以让 dsh-android-app 通过版本化 API 连接同一套聊天、工作区和文件能力。

界面默认中文,可随时切换 English。插件支持 Windows、macOS 和 Linux,安装包已经包含编译产物,不要求用户在服务器上重新构建。

实际效果

文件工作区直接显示在 DSH WebUI 中,目录树、编辑器和文件操作集中在同一个窗口。

DSH WebUI 中的文件工作区

远程访问默认关闭。管理员可在本机 WebUI 中设置绑定 IP、端口和新设备的初始权限。

远程访问设置

快速安装

环境要求

  • 已安装并能正常启动的 DeepSeek Harness WebUI
  • Node.js ^22.19.0 或 >=24.0.0
  • 默认端口 3090 可用,或准备一个其他端口

使用运行 DSH WebUI 的同一系统用户执行:

dsh plugin --profile web add https://github.com/Hakunm/dsh-workspace/releases/download/v1.0.0/dsh-workspace-1.0.0.tgz
npx @deepseek-ai/dsh web

重启 WebUI 后,侧栏会出现“文件”入口,会话视图中也会出现文件标签页。

从 GitHub Release 下载离线安装包时,可直接安装 tarball:

dsh plugin --profile web add ./dsh-workspace-1.0.0.tgz

第一次使用

  1. 在 DSH WebUI 中打开“文件”,点击右上角的“工作区设置”。
  2. 在“根目录”页添加允许管理的本机目录,并为它起一个容易识别的名字。
  3. 返回文件工作区,选择授权根后即可浏览和编辑文件。
  4. 需要连接手机时,进入“远程访问”,填写绑定 IP 和端口并保存。
  5. 点击“启用并创建配对”,再将十分钟内有效的一次性配对码填入 App。

远程访问只有在至少存在一个授权根时才能开启。安装插件本身不会把服务暴露到局域网,未启用时只监听回环地址。

你可以做什么

在 DSH WebUI 中管理文件

  • 懒加载浏览目录,新建文件或文件夹。
  • 上传、下载、替换、重命名和移动文件。
  • 使用 CodeMirror 6 查看和编辑 UTF-8 文本。
  • 尽量保留 UTF-8 BOM 与原有换行风格。
  • 使用 ETag 检测外部修改,遇到冲突时拒绝静默覆盖。
  • 删除内容时先进入插件回收站,之后可恢复或由本机管理员永久清理。
  • 二进制文件只提供元数据、下载和替换,不会被误当作文本写回。

连接 Android App 或其他客户端

公开 API 不依赖 DSH 私有协议,可用于:

  • 查看、新建、重命名和移除 DSH 工作区登记。
  • 创建、重命名、分叉和归档会话。
  • 读取消息、流式接收正文和思考、追加引导或取消运行。
  • 查看 TODO、斜杠命令、权限模式和待审批操作。
  • 选择 Agent、模型和思考强度。
  • 查看或修改模型供应商,支持完全自定义供应商。
  • 管理设备获准访问的文件和回收站项目。

远程访问与安全

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-plugin-doctor 下一个 Next dsh-trail →