Dpf555/dsh-workbench
VS Code-style three-column Explorer + Monaco editor plugin for the DeepSeek Harness web GUI
安装Install
dsh plugin --profile web add github:Dpf555/dsh-workbench把 Dpf555/dsh-workbench 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
DSH Workbench — VS Code 风格三栏布局插件
中文 | English
参考 microsoft/vscode 的设计，为 DeepSeek Harness（DSH）Web GUI 增加：
- 右侧常驻 Explorer 文件树（VS Code 官方 seti 文件类型图标、展开/折叠、新建文件/文件夹、刷新、全部折叠、可拖宽/折叠面板）
- 中间区域点击文件即切换为代码编辑器（monaco-editor 0.52.2 —— VS Code 编辑器核心；多标签页、语法高亮、minimap、Ctrl+S、脏标记、保存冲突"重新加载/强制覆盖"）
- Markdown 渲染预览：打开
.md文件后标签行出现"预览"按钮，一键切换渲染视图（标题/列表/表格/代码块/引用/任务清单/链接/图片），随编辑实时刷新；内置自包含渲染器，无额外依赖 - 编辑器占满整列（编辑时下方输入框/停靠条自动隐藏，"返回会话"或顶部"对话"标签切回）
- 安全边界：所有文件操作经 DSH 的
ctx.fs服务，双重围栏在工作区沙箱内，越界拒绝；写入走版本号 CAS 防覆盖
┌─────────┬──────────────────────────┬────────────┐
│ 左侧边栏 │ 中间：会话 ⇄ 文件内容 │ 右侧：文件树 │
│ （不变） │ 点文件 → Monaco 编辑器 │ Explorer │
└─────────┴──────────────────────────┴────────────┘
架构
| 文件 | 作用 |
|---|---|
index.js |
主机半部（Cordis 插件）：注册 /wb/* 静态资源路由 + /wb/api/<op> 文件操作（describe/listDir/readFile/writeFile/createFile/createDir/assetText），工作区围栏 |
client.js |
客户端半部（浏览器插件 bundle）：引导加载 /wb/workbench-client.js |
assets/workbench-client.js |
UI bundle：右栏 ExplorerRoot（explorer slot）+ 中栏 EditorView（conversation.view 的 workbench.editor 视图） |
assets/vs/ |
monaco-editor 发行版（npm run setup:assets 生成，不入库） |
assets/seti.* |
seti 图标字体与生成产物（npm run generate:seti） |
patches/*.patch |
对 DSH 检出包的三处内嵌补丁（三栏布局依赖它们） |
scripts/*.mjs |
资产下载/图标生成/补丁应用/profile 安装 |
dynamic/ |
会话内动态插件形态（cordis_define 用），可选 |
三处补丁（patches/，对 DSH 0.1.0-rc.6 生成）：
ui-layout.patch— AppFrame 新增第 4 条网格轨道explorer（240–420px、默认 300）+explorerslot + 拖宽手柄 +toggleExplorer服务方法ui-conversation.patch— 暴露window.__DSH_CONV_BRIDGE__[sessionId].setView，点击文件自动切换中间视图ui-sidebar.patch— 页面加载即挂载 UI bundle（刷新自愈）
安装
前置：Node.js ≥ 18、git、可访问 npm registry 的网络。
git clone <this-repo> dsh-workbench
cd dsh-workbench
# 1. 下载 monaco 资产并生成 seti 图标（约 13MB）
npm run setup:assets
# 2. 安装到 DSH profile（下次 `dsh web` 重启后随组合加载 /wb 路由与客户端引导）
node scripts/install-profile.mjs --profile web
# 3. 给当前 DSH 检出打三栏布局补丁（不改则只有浮窗/无右栏，见下方"补丁"说明）
node scripts/apply-patches.mjs --checkout <checkout-root>
# 不传 --checkout 时自动探测 ~/.npm-cache/_npx 下的检出
然后重启 dsh web 并 Ctrl+F5 硬刷新页面。
检出根目录：包含
node_modules/@deepseek-ai/的目录（npx 安装通常位于~/.npm-cache/_npx/<hash>/；本机示例C:\Users\<you>\.npm-cache\_npx\1e7f6d9597241db0）。
补丁（为什么需要）
DSH 的客户端壳不提供"常驻右栏 + 点击文件切换中间视图"的公开扩展点：
- 右栏需要布局壳新增网格轨道（
explorerslot）——由ui-layout.patch完成 - 中间视图环（
conversation.view）的活动视图切换是私有状态——由ui-conversation.patch暴露桥接
补丁直接修改检出的客户端 bundle（DSH 按请求实时读取、cache-control: no-cache，硬刷新即生效，无需构建）。补丁基于 0.1.0-rc.6 生成；DSH 升级后如不能应用，请对照新 bundle 重新生成（git diff --no-index <原始> <补丁后>）。
使用
- 硬刷新页面 → 右栏出现文件树
- 点目录展开、点文件 → 中间自动切换为 Monaco 编辑器，输入框隐藏
- Ctrl+S 保存；顶部"对话 / 代码"标签或"返回会话"按钮切换
- 右栏头部：新建文件/文件夹、刷新、全部折叠、
«收起面板；左边缘拖宽；收起后右侧保留 28px 窄条，点击即可重新展开
工作区跟随
文件树根 = 当前活跃会话的工作区（该会话的 header.cwd，即其沙箱边界）：
- 切换到哪个工作区/会话，右栏就显示那个工作区的文件；切换时编辑器标签页与文件树自动重建
- 客户端把活跃会话 id 注入每个
/wb/api/*调用，服务端按sandboxPolicy.resolve({ session })解析栅栏根 - 无活跃会话时回退到部署根（
sandboxPolicyfallback root，可通过 profile 的cordis.patch.yml固定）
注意：会话级解析需要主机半部注入
sessions服务，改完index.js/client.js后需重启dsh web再硬刷新。
卸载
- 删除
<DSH_HOME>/profiles/web/cordis.patch.yml中- insert:的workbench行，重启dsh web - 删除
<DSH_HOME>/profiles/web/node_modules/@dsh-local/dsh-workbench/ - 补丁回退：重装对应 npm 包（
npm i @deepseek-ai/dsh-client-ui-{layout,conversation,sidebar}@0.1.0-rc.6后覆盖检出的lib/client.js），或git apply -R patches/*.patch
已知限制
ctx.fs契约无 rename/delete → 暂不支持重命名/删除文件- 二进制文件只读拒绝；单文件读取上限 5MB
- 未打开会话时右栏可见但点击文件不切换中间视图（视图环是会话级的）；此时文件树显示部署根
- 文件树根 = 当前活跃会话的工作区（无会话时回退到
sandboxPolicyfallback root，可用 profile 补丁固定） - Markdown 预览为自包含渲染器的 GFM 子集：支持标题/粗斜体/行内与围栏代码/列表与任务清单/引用/表格/链接/图片/分隔线；暂不支持嵌套列表、脚注、HTML 透传（HTML 一律转义防注入）
致谢与许可
- microsoft/vscode（Explorer 设计参考；seti 图标与主题数据，MIT）
- microsoft/monaco-editor（MIT）
- jesseweed/seti-ui（seti 字体上游，MIT）
- 本插件 MIT License
相关推荐Related
-
nexu-io/open-design
🎨 Best DeepSeek Harness Design Plugin. The open-source Claude Design alternative. 🖥️ Local-first desktop app. 🖼️ Your…
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
esengine/DeepSeek-Reasonix
DeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.
-
Tencent/WeKnora
Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-m…
- Nagi-ovo/voyager Enhancement suite for Gemini, AI Studio, Claude & ChatGPT — plus a prompt manager for any web UI, DeepSeek Harness inclu…
-
anywhere-labs/deepseek-harness-desktop
为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」，桌面本身也是「插件」。
-
EverMind-AI/EverOS
One portable memory layer for every AI agent: local-first, Markdown-native, user-owned, and self-evolving across apps, t…
-
freestylefly/awesome-gpt-image-2
Prompt as Code | GPT-Image2 工业级提示词引擎与模板库，470+ 个案例逆向工程，20+ 套工业级模板，并提炼出Skills，持续更新中