tingfeng347/dsh-vscode-workbench

亮点

• 一体化本地工作台：资源管理器、Monaco 编辑器、搜索、Git、终端和 DSH 对话集中在一个 VS Code 风格界面。
• 完整文件体验：文本、Markdown、图片、PDF 和 Word 文档均可直接打开；目录支持拖放上传和常用文件操作。
• 可靠且实时：原子保存与版本校验避免静默覆盖，WebSocket 会及时标记工作区的外部变更。
• 可视化 Git 工作流：覆盖状态、暂存、提交、分支、差异、提交文件与泳道式提交图。
• 可持续的工作上下文：按工作区恢复标签、目录、视图、面板与栏宽；终端支持多会话、分屏与重命名。
• 贴合 DSH：右侧直接复用 DSH 对话能力，主题与布局集中在工作台设置中管理。

功能

• 文件与编辑器：懒加载目录树、创建、上传、拖放、重命名、删除和 Git 状态；Monaco 多标签编辑支持脏状态、原子保存与冲突提示。
• 预览：Markdown 支持源码、大纲、相对链接和图片；内置 PDF 翻页缩放与 DOCX 渲染，DOC/ODT 可直接下载打开。
• 搜索与 Git：@vscode/ripgrep 支持大小写、全词、正则和路径筛选；Git 提供暂存、撤销、丢弃、提交、分支、差异、提交文件和提交图表。
• 终端：基于 node-pty 与 xterm，支持最多 8 个会话、会话重命名、右侧切换、分屏、ANSI 输出和 Ctrl+C。
• 布局与 DSH：左侧视图、终端面板和右侧 DSH 对话栏可独立显示和调整；设置面板管理主题与各栏宽度。
• 同步与恢复：工作区文件变化实时推送；刷新后恢复活动视图、标签、目录展开、面板和布局。

工作台通过官方 sidebar.footer.action 与 shell.overlay 扩展点挂载，不替换或卸载 ui-layout。

演示

安装

dsh plugin --profile web add dsh-vscode-workbench

首次安装终端支持

终端使用 node-pty。pnpm 11 首次安装时会拦截其构建脚本，dsh plugin ... add 可能显示 Ignored build scripts 并以失败结束；这是预期的安全检查，插件依赖已经写入 profile。在 DSH 所在机器执行：

cd ~/.dsh/profiles/web
pnpm approve-builds --all

该命令会批准 node-pty 的构建并重新完成安装；完成后重启 dsh web。若终端仍提示 node-pty 加载失败，可执行：

cd ~/.dsh/profiles/web
pnpm approve-builds --all && pnpm rebuild node-pty

刚发布不足 24 小时的版本可能被 pnpm 的安全等待期拦截。等待后重试即可；DSH 提供“立即更新”时可直接选择它。

快捷键

快捷键	操作
Ctrl+Shift+E	打开资源管理器
Ctrl+Shift+F	打开搜索
Ctrl+Shift+G	打开源代码管理
Ctrl+S	保存当前文件
Ctrl+Alt+B	显示或隐藏 DSH 对话栏
`Ctrl+``	显示或隐藏终端
`Ctrl+Shift+``	新建终端

左侧活动栏的终端按钮可切换显示或隐藏终端面板。

安全

Host 只接受当前 DSH 会话工作目录内的相对路径，并阻止目录穿越与符号链接越界。保存使用版本校验与原子替换；Git 与 ripgrep 使用参数数组启动，不拼接 Shell 命令。终端只接受同源 loopback 请求，固定在会话工作目录启动，并移除 API key、token、secret 等敏感环境变量。

开发

pnpm install
pnpm typecheck
pnpm test
pnpm build

需要 Node.js ^22.19 || >=24、pnpm 11.7、系统 Git，以及 node-pty 所需的本机构建环境（预编译产物不可用时）。

许可证

MIT