前言¶
DeepSeek Harness（DSH）作为插件化平台，其原生工作区与会话管理功能在深度使用时存在操作繁琐、文件交互受限等问题。本插件以标准 DSH 插件包的形式发布，通过 overlay 补丁集覆盖官方 17 个 bundle，对会话生命周期、文件处理流程及工作区沙箱能力进行增强。它旨在为开发者提供更灵活的会话归档、跨工作区流转以及完善的文件预览与 Git 操作支持。
核心功能¶
会话回收站与归档¶
插件接管了 session.delete 与 workspace.delete 的默认行为，将其改为软删除（移入回收站）。
* 软删除：删除操作仅标记会话或工作区，不会立即清除物理文件。
* 彻底删除：物理删除需通过回收站界面执行，调用 session.purge 或 workspace.purge。
* 会话合并：新会话已自带整个工作区上下文，插件移除了原有的会话合并功能，相关按钮已删除。
工作区与会话管理¶
- 跨工作区拖动：支持将会话行直接拖拽至其他工作区行或「未分组」组，关系持久化，会话自身目录与日志保持不变。
- 未分组工作区：顶部「新会话」按钮创建的会话默认归属「未分组」组，该组常驻显示。
- 多文件夹挂载：每个工作区可挂载多个根目录（
additionalPaths），沙箱权限同步授权全部根目录。 - 文件夹与文件区：工作区侧边栏分为上下两层。上层为文件夹区（蓝色底，列出主目录及附加目录），下层为文件区（紫色底，列出公共文件或空态提示）。未分组区域不渲染这两块。
文件交互与预览¶
- 上传方式：支持粘贴（Ctrl+V）或拖拽文件到文件区。文件经
workspace.importFiles落盘至工作区.dsh-uploads/目录（重名自动编号，单文件 ≤5MB）。 - 会话文件：粘贴到会话的文件会以 sessionId 挂载，显示为绿色区块（含左竖条强调线），标题格式为「会话文件 · N 个文件 · 会话标题」。文件行支持移除与预览。
- 附件限制放开：粘贴/拖拽任意格式文件均可作为附件（图片仍走图片管线）。二进制文件仅标注
[附件 文件名]，大小限制仅作用于传输内容。 - 内置选择器：Windows 下使用应用内浏览式选择器（含驱动器列表），替代原生对话框。
- 多选支持：文件夹区/文件区标题栏的「+」按钮打开多选浏览器，支持勾选框多选与跨目录保持选择。
文件预览面板¶
点击侧边栏文件夹树中的文件，右侧滑出 520px 预览面板。
* 渲染能力：正文使用 Markdown 渲染。
* 代码高亮：支持 .md 及 30+ 种代码文件（.js/.ts/.vue/.java/.py/.xml/.yml/.css/.html 等）的语法高亮。
* 限制：内容由服务端 host.readFile RPC 提供，限制在工作区根目录内，≤256KB，二进制文件拒绝预览。
文件夹 Git 面板¶
文件夹区中，Git 仓库文件夹行显示当前分支 chip 与三色状态点：
* 🟡 黄 = 有未提交修改
* 🔵 蓝 = 落后远程
* 🟢 绿 = 与远程一致
点击 chip 弹出菜单，支持切换分支、新建分支、更新代码（git pull --ff-only）以及推送代码（自动暂存、AI 生成中文提交信息、提交、推送）。所有操作直接作用于磁盘工作区。
安装与启用¶
前置条件¶
确保已安装 DeepSeek Harness（目标版本 @deepseek-ai/dsh@0.1.0-rc.6，Windows）。
安装步骤¶
使用 npm 将插件安装到 DSH profiles 目录。安装后 postinstall 脚本会自动应用 overlay 补丁集。
npm install --prefix "$env:USERPROFILE\.dsh\profiles" dsh-workspace-enhance
启用与生效¶
安装完成后，需重启 DSH 服务并刷新浏览器页面以使补丁生效。
# 重启 DSH 服务（具体命令视宿主方式而定，如 npx -y @deepseek-ai/dsh web）
# 浏览器 Ctrl+Shift+R 强刷
补丁机制说明¶
- 幂等性：插件宿主侧每次加载时自动检查并补打 overlay。已补打的文件不会重复操作。
- 持久性：overlay 采用「删除后复制」方式落盘，与官方包硬链接断开。即使使用
npx -y @deepseek-ai/dsh web重启服务重新拉取官方包，已打的补丁也不会被覆盖。 - 版本守卫：overlay 仅匹配
@deepseek-ai/dsh@0.1.0-rc.6。检测到其他版本时会跳过并告警，直接覆盖新版 bundle 会破坏运行。 - 自动恢复：官方包刷新或 DSH 升级导致补丁丢失时，会自动恢复。
注意事项与兼容性¶
- 版本锁定：当前插件仅兼容
@deepseek-ai/dsh@0.1.0-rc.6（Windows）。升级 DSH 后需同步更新 overlay 补丁，否则功能可能失效或报错。 - 目录权限：插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证（MIT）。
- 回滚：如遇问题，可通过提供的脚本进行校验或回滚。
