dsh-ide-vscode
给 DeepSeek Harness（DSH）右侧栏装一个能读能写的 IDE：左边是工作区文件树，右边是编辑器 / 图片预览 / 压缩包查看，文件可以直接改、Ctrl+S 直接存。
面板
它解决什么问题
DSH 自带的工作区文件面板只能看不能改（宿主的 workspaceFiles 服务是只读的）。想看代码、改一行配置、新建个脚本，都得切出去用别的编辑器。
这个插件把「文件树 + 编辑器」直接放进右侧栏的标签页：改完 Ctrl+S 就落盘，不用离开 DSH。
功能
文件树（左）
- 展开 / 折叠目录，点文件就在右侧打开
- 配色照着 Windows 资源管理器来：文件夹与文件名同一种正文色（不压暗、不区分颜色），文件夹是黄色填充图标（
#ffd767 + #d9a13a 描边），文件图标保持中性灰
- 文件图标直接用系统里那一张：Windows 下按后缀问资源管理器要（
SHGetFileInfo），所以 .txt 是记事本那张纸、.bat 是齿轮窗口、.zip / .tar 是压缩包，装了什么软件就显示什么图标；只做 Windows——macOS / Linux 上 host 直接回空对象（不跑 PowerShell、不碰任何 Win32 接口），前端退回自带中性图标；没有真机可验证，所以不写无法调试的原生代码
- 目录上右键：新建文件… / 新建文件夹… / 打包成 zip… / 刷新
- 文件上右键：重命名 / 改后缀… / 删除 / 打包成 zip…
- 树空白处右键 = 对当前选中的目录操作
- 新建文件时给一排后缀胶囊（
.txt .md .json .js .py .ps1 .sh .bat .yaml .ini .log 无后缀），点一下自动补全名字，也可以手打任意后缀
- 顶部搜索框：输名字回车搜（
/search 路由，按名字跨子目录找，最多列 60 条），粘一个带斜杠 / 盘符的路径就直接跳到那一层，是文件就顺手打开
新建文件
编辑器（右）
- 行号 + 语法高亮（用宿主自带的 shiki 高亮器，按扩展名识别）
- 直接打字编辑；
Tab 插入两个空格；Ctrl+D 复制当前行（选中多行就复制整段）；Ctrl+S 保存（也有「保存」按钮）
- 焦点不在编辑器里时（比如刚打开 DSH、正在跟会话说话），
Ctrl+D 就是打开这个面板的全局快捷键——右侧栏起始页的卡片上也写着它
- 状态栏显示 行数 / 字符数 / 字节数 / 已保存·未保存；有未保存修改时文件名旁带一个圆点
- 切换文件时如果当前文件有未保存的修改，会问「保存并打开 / 放弃修改 / 取消」
图片（点开就预览）
.png .jpg .jpeg .gif .webp .bmp .ico .avif 点开直接当图片显示（不是丢给你一句「不是文本文件」）：可切「原始大小 / 适应窗口」，状态栏显示文件大小与「只读预览」。图片走 GET /api/ide-vscode/raw，单张上限 64 MB。
图片预览
音频 / 视频（点开就播放）
.mp3 .m4a .aac .wav .ogg .oga .opus .flac .weba .wma .mid 与 .mp4 .m4v .webm .ogv .mov .mkv .avi 点开就在面板里播放（<audio> / <video>，带浏览器原生控件），状态栏标明「只读播放」；字节同样走 GET /api/ide-vscode/raw。
压缩包（看内容 / 解压 / 打包）
.zip .tar .tar.gz .tgz .gz .7z .rar 点开列出包内成员（目录缩进显示，最多列 1000 项，超出会提示总数）- 面板上「解压到旁边」：解到压缩包旁边的同名目录（已存在就自动用
名字-2，不会覆盖）；解出来的顶层目录与压缩包里存的一致（和资源管理器 / 7-Zip 的默认行为相同）
- 文件或目录右键「打包成 zip…」：在它旁边生成
<名字>.zip；同名已存在会提示，不会默默覆盖
- 底层用系统自带的
tar（Windows 10+ 自带 bsdtar），所以不用装任何依赖；系统没有 tar 时会明确报错
压缩包
删除
- 默认移到回收站，不是真删；对话框里另有「彻底删除」按钮并二次确认
- 回收站位置会写在删除后的提示里（默认
<工作区根>/.dsh-ide-vscode/trash，可配置，见下）
在哪里打开
- 右侧栏点
+ → 起始页上的「工作区 IDE」卡片（图标是文件树）
- 任何地方按
Ctrl+D（macOS 是 ⌘D；网页版因为是浏览器，用 Ctrl+Alt+D）直接开面板；焦点在编辑器里时这个组合键仍是「复制当前行」
- 会话里点到
.js .ts .py .json .ps1 .yaml ... 这类代码 / 配置文件时，也会直接开在这个 IDE 里
.md、.html 仍交给 DSH 自带的文档预览，不抢
安装
从插件市场装（推荐）：设置 → 插件 → 插件市场 → 搜 dsh-ide-vscode → 安装。
或者命令行：
dsh plugin --profile desktop add dsh-ide-vscode
（desktop 换成你在用的 profile 名；用 dsh web 的话是 --profile web。）
装完要重启一次 DSH。 插件包列表只在启动时读，热加载不会带上新插件。
工作区根目录（跟随会话）
树显示的就是这个面板所在会话的工作区——切换工作区，树跟着换，不需要配置。每个请求都带上会话 id，宿主据此取该会话的 cwd。整条链按顺序取第一个真实存在的目录：
- 环境变量
DSH_IDE_ROOT（想强行钉死一个目录时才用）
- 该请求所属会话的工作目录（
ctx.sessions → sessionPersistence）
- 插件包目录下的
ide-root.json，例如 {"root": "D:\\my\\project"}（可选）
- DSH 自己记录的默认工作区（
~/.dsh/storages/workspace.json）
- 宿主进程的当前目录（
process.cwd()，最后兜底）
回收站同理：DSH_IDE_TRASH（绝对路径）> ide-root.json 里的 trash（相对根目录）> 默认 <工作区根>/.dsh-ide-vscode/trash（这个目录在树里被隐藏）。
ide-root.json 是本地文件，既不在 git 里也不在 npm 包里（想留一份自己的根目录就写它；删掉它，面板就纯粹跟着会话走）。
安全边界
- 所有路径都相对根目录解析，越出根目录一律 403（
.. 跳出去、绝对路径都拦）
- 只接受回环地址（
127.0.0.1 / ::1）的请求；写操作如果带 Origin，还要求它与 Host 同源，否则 403
node_modules、.git、.pnpm-store 等目录拒绝写入 / 新建 / 删除- 名称校验：空名、
.、..、Windows 非法字符、保留名（CON / PRN / AUX / …）、超过 200 字符一律拒绝
- 读单文件上限 2 MB、单张图上限 64 MB，写上限 8 MB，单目录最多列 5000 项，压缩包最多列 1000 项
- 解压 / 打包调系统自带的
tar，命令带 5 分钟超时；解压出来的东西只落在工作区根目录内
兼容性
- DSH
>= 0.1.5-rc.1（web / desktop，用到右侧栏标签页 API）
- Node
>= 22
- 解压 / 打包需要系统有
tar（Windows 10 1803+ 自带 bsdtar，Linux / macOS 自带）
- 没有第三方运行时依赖，不联网
已知限制
- 不是完整的 VS Code：没有 Monaco、没有 LSP 补全、没有终端 / Git / 全局搜索，编辑体验就是「行号 + 高亮 + 存盘」
- 一次只开一个文件，没有多标签
- 图片只做预览，不能裁剪 / 缩放后另存；音频 / 视频只能在面板里播放，不能剪辑；PDF、Office 文档不处理
- 压缩包只支持系统
tar 认识的那些格式（.rar 一般解不了，Windows 自带的 bsdtar 不含 rar 解码器），加密包不支持
- 编辑二进制文件不行（不认识的二进制后缀仍然不打开）
- 读写走插件自建的本地 HTTP 路由（挂在宿主 web server 上，只服务这个面板），因为宿主提供的文件服务是只读的
开发
lib/index.js host 半边：15 条路由（root / list / read / stat / raw / archive / search / extract / compress / write / create / rename / delete / log / icons）
client/client.js 客户端半边：右栏标签页 + 文件树 + 编辑器 + 图片预览 + 压缩包面板（React，复用宿主的 ui primitives）
cordis.patch.yml 把插件插进 bundle 列表
ide-root.json 可选的本机根目录配置（gitignore，不进包）
test/host-smoke.mjs 106 项：全部路由、越界、改名、回收站、图片 / 压缩包、Origin 闸、会话工作区解析、系统图标解析与「非 Windows 不碰 Win32」守卫（离线，无需 DSH）
test/client-smoke.mjs 53 项：bundle 契约、面板注册与全局快捷键、后缀解析（离线，jsdom + react）
test/dom-e2e.mjs 65 项：真 DOM 交互（点右键菜单、打字、Ctrl+D 复制行、Ctrl+S 落盘、图片预览、压缩包解压、系统图标 img）
test/gui-verify.mjs 真 GUI 端到端：无头 Edge + CDP 真鼠标真键盘，对隔离的 DSH 实例跑完整流程
npm test # host + client + dom，三套全部离线
test/gui-verify.mjs 需要一个带 token 的 DSH 网页地址（dsh web 启动时会打印），用法见文件头部注释。
License
MIT
English
dsh-ide-vscode puts a small IDE into the DeepSeek Harness right sidebar: a workspace file tree on the left, an editor / image preview / archive viewer on the right.
- Create files and folders from the context menu, with one-click extension chips; rename (extension included) and delete (to a trash folder by default, hard delete on request).
- Edit in place with line numbers and syntax highlighting,
Tab for two spaces, Ctrl+D to duplicate the current line (or the whole selection), Ctrl+S to save; unsaved changes are tracked and confirmed before switching files.
- Pictures (
.png .jpg .jpeg .gif .webp .bmp .ico .avif) open as an image preview, fit-to-window or 1:1, never as a "not a text file" error.
- Sound and video (
.mp3 .m4a .aac .wav .ogg .oga .opus .flac .weba .wma .mid, .mp4 .m4v .webm .ogv .mov .mkv .avi) play in place with the browser's own controls and a read-only marker in the status line, again from GET /api/ide-vscode/raw.
- Archives (
.zip .tar .tar.gz .tgz .gz .7z .rar) list their members, can be unpacked next to themselves, and any file or folder can be packed into a .zip from the context menu — all through the system tar, so there is no runtime dependency.
- The tree has a search box: type a file name to search it by name across subdirectories (up to 60 hits), or paste a path containing a slash or drive letter to jump to that folder and open the file.
- Opens from the right-sidebar + start page ("工作区 IDE" card) and takes over code/config files (
.js, .ts, .py, .json, .ps1, …) opened from a session; Markdown and HTML stay with DSH's own preview.
- The opening file tree follows the colours of Windows Explorer: folder and file names share one body colour (nothing is dimmed or tinted), folders use the yellow filled icon (
#ffd767 fill, #d9a13a outline) and file icons stay neutral grey.
- File icons are the pictures the OS itself uses: on Windows the host asks the shell for the extension (via
SHGetFileInfo), so .txt is Notepad's page, .bat the gear window and .zip / .tar the archive — whatever is installed wins. This is Windows only: on macOS and Linux the host answers {} without spawning PowerShell or touching any Win32 API, and the panel falls back to its bundled neutral icons (no native extractor is written without a machine to verify one on).
- Everything else stays platform-agnostic: paths go through Node's , the API speaks -separated relative paths, and no Windows separators are hard-coded.
