yth1120/dsh-web-workbench

dsh-web-workbench

面向 DeepSeek Harness Web UI 的非官方社区插件补丁集与源码包。

本仓库包含 2026 年 8 月开发的完整客户端/服务端插件套件，面向评审、集成和社区分享。官方上游当前不接受外部 Pull Request，因此本仓库作为实际提交与评审路径，同时保留可直接应用的补丁。

English

提交状态：已打包待社区评审；dsh-external 组织登记仓库为私有，公开侧暂无法引用对应 issue/PR。

包含内容

5 个新增包：

- @deepseek-ai/dsh-client-ui-workbench：右侧工作台，包含浏览器、文件查看、任务、活动日志、Review、状态等标签。
- @deepseek-ai/dsh-client-ui-terminal：自下而上展开的终端面板，直接在输出区输入命令，不设独立命令输入框。
- @deepseek-ai/dsh-client-ui-timeline：聊天界面的问题历史时间轴，采用悬浮刻度和跳转提问记录交互。
- @deepseek-ai/dsh-terminal-web：浏览器终端的行式 Shell 桥接服务。
- @deepseek-ai/dsh-workspace-review：工作区 Git Review 服务，提供受限的改动文件与 diff。

另外修改了 17 个官方包以接入 Web 装配层，包括 web-app、客户端布局/会话/侧边栏/工具、host apiproxy、workspace、session-log-export 等。补丁集不修改 agent-loop、会话存储或核心运行时。

验证结果

- 目标包：131 个测试文件，2136 个测试通过。
- 终端包：14 个测试通过。
- 全量并发测试中的失败均为资源竞争（超时/EPERM）；失败文件串行重跑后 10 个文件 / 312 个测试通过，5 个跳过。
- typecheck、lint、翻译配对（1013 对）、客户端目录、包约束均通过。
- 浏览器真实冒烟覆盖终端命令、工作台标签、侧边栏以及面板/终端拖拽。
- 优化验证（2026-08-24）：89 个测试文件 / 1197 个测试通过（1 跳过），typecheck 与 lint 通过。

完整证据见 docs/SUBMISSION.md。

兼容范围

- 基准提交：528c682e061696f5a160f363f236ecbf53cbd006
- 分支：master
- 上游上下文：release/dsh-0.1.1-rc.1
- 需要 DeepSeek Harness 源码目录，本仓库不是独立 Web 应用。

安装（源码补丁）

在本仓库克隆目录中执行，把补丁应用到兼容基准提交的 DeepSeek Harness 源码目录：

$env:DSH_SOURCE = 'C:\path\to\deepseek-harness'
.\scripts\apply-patch.ps1 -DshSource $env:DSH_SOURCE
pnpm --dir $env:DSH_SOURCE install
pnpm --dir $env:DSH_SOURCE run typecheck
pnpm --dir $env:DSH_SOURCE run build
pnpm --dir $env:DSH_SOURCE dsh --profile web

只检查、不修改源码：

.\scripts\apply-patch.ps1 -DshSource $env:DSH_SOURCE -CheckOnly

手动方式：

git -C "$DSH_SOURCE" apply --check patches/official-all-changes.patch
git -C "$DSH_SOURCE" apply patches/official-all-changes.patch

如果只需要插件包源码，使用 patches/plugin-packages.patch，这样不会改根级构建配置。

Release 附件
Release 产物（源码归档与校验和）在生成发布包时产出，不提交到源码树；docs/SHA256SUMS 对应的是该发布包。

- dsh-plugin-submission-2026-08-23.zip：完整提交归档。
- all-plugin-sources.tar.gz：便携源码归档。
- patches/：可直接应用的补丁。
- docs/SUBMISSION.md：包清单、验证与提交说明。
- docs/SHA256SUMS：交付归档校验和。

Windows 桌面包

desktop/ 目录包含预编译 Wails/WebView2 壳及启动器，会把本地已构建的工作台版 dsh web 后端嵌入原生桌面窗口，无需再开浏览器标签。详见 desktop/README.md。

安全说明

终端是用户操作的 Shell 通道，以 dsh web 进程的权限运行。开启后不要把服务暴露给不可信网络。工作区 Review 与文件接口均为同源且做了路径限制，但仍应按本地服务假设处理。

文件查看器会拦截 .git 元数据、绝对路径、反斜杠路径以及解析到工作区之外的符号链接；终端桥只接受已登记工作区目录。

许可证

MIT。详见 LICENSE 与 NOTICE.md。