简体中文 | English
dsh-side-panel-patched
DSH Web 右侧工作区面板（文件浏览器 / Git 审查 / 终端）的本地增强版，以 fork 形式维护。
- 上游是 ccq1/dsh-side-panel（BSD-3-Clause，v0.2.0，安装源
github:ccq1/dsh-side-panel）。它提供右侧面板的基础功能，包括文件树、预览、编辑（CodeMirror）、Git 审查与终端（xterm），Node 端暴露/side-panel/api（文件 / Git / 终端 API） - 本仓库在上游代码上叠加本地增强。改动在源码里带
PATCH(2026-08-14)、PATCH(2026-08-21)、PATCH(2026-08-27)标记，grep能直接定位，完整过程翻 git log 就能看到
功能增强（相对上游 v0.2.0）
实现细节都写在源码的 PATCH 标记旁边，git log 里有完整过程，这里只列要点。
- 独立面板挂载。面板放进自己的挂载点，绕开了官方 details 列和 520px 宽度上限。它用
position:fixed停在右侧，宽度能在 420px ~ 60% 视口之间拖拽，拖出来的宽度会持久保存 - 头部尺寸与官方界面一致。标题栏 44px，tabs 栏 28px，像素级贴合
- Codex 风格梭形拖拽把手
- Windows 原生终端。v0.2.1 使用可选依赖
node-pty的 ConPTY 支持交互输入、输出和实时调整尺寸；单命令模式走隐藏窗口的cmd.exe /c。Linux 保留scriptPTY，运行期尺寸调整仍返回applied:false。 ctx.sessions/ctx.workspaces服务注入声明补齐。会话切换能被跟踪，文件 tab 按会话分组- 终端会话归属（
PATCH(2026-08-27)）。宿主按owner=sessionId校验所有terminal-*动作，轮询、输入、缩放、关闭都绑定打开终端时的那个会话 - 放大按钮在 60% 视口与全宽之间切换，拖拽出的宽度保留
- 多文件 tab 栈。文件树是单例，跟随当前激活的 tab；滚动位置跨 tab 保持；打开第一个文件后自动隐藏「文件」功能 tab；tab 按会话与工作区分组，互不串扰
markdown 预览增强（2026-08-21，PATCH(2026-08-21)）
- GitHub 风格排版，亮暗主题自适应。代码围栏用 lezer 做语法高亮，解析器复用插件内置的 CodeMirror，没有新增依赖，每段代码带语言徽标
mermaid代码围栏按需渲染成 SVG。渲染引擎从 CDN 懒加载（先 jsdelivr 后 unpkg，[email protected]），主题跟随 DSH，切换时重新渲染，输出再过一遍 DOMPurify。离线、CSP 拦截或语法出错时降级回源码视图- 实现入口在
lib/client.js的dfbRenderMarkdown/markdownCss/dfbRenderMermaidBlocks。src/是源码，npm run build由src/host与src/client构建出lib/
安装
v0.2.1 已针对 DSH 0.1.2-rc.1 验证。Windows 需要支持 ConPTY 的系统（Windows 10 1809+）及 node-pty 原生组件；Linux 使用 script、stty 和 Bash。pnpm test 同时覆盖终端实际命令输出、归属校验和目录链接边界。
# 从 GitHub 安装（推荐）
dsh plugin --profile web add github:DDDFXYqiming/dsh-side-panel-patched
# 本地开发时也可直接使用仓库目录
dsh plugin --profile web add <本目录>
发布形态
- 插件实际加载
lib/，本包以预构建产物分发。src/与tsconfig.json是唯一的源码，npm run build把 host 和 client 一起构建进lib/（host 侧经 typescript 转译擦类型）。prepare脚本运行完整build + check，npm pack和 GitHub 安装都会重新产出lib/；pnpm ≥10 首次 git 安装需在 profile 的pnpm-workspace.yaml放行：allowBuilds:下加入 pnpm 打印的本包键 - scoped 包已配置
publishConfig.access: public。所有前端依赖（codemirror / xterm 等）都内联进 bundle，声明在devDependencies里，只在构建期使用 - 配置默认值由插件内的 Schemastery
Config提供（maxTextBytes/maxImageBytes/searchMaxResults/terminalTimeoutMs/searchNodeBudget），cordis.patch.yml不再携带默认值 /side-panel/api加了 Host / Origin 回环校验，只接受127.0.0.1/localhost/[::1]来源
已知边界
- Windows 交互终端需要
node-pty的 ConPTY 原生组件；Linuxscript后端只在启动时设置尺寸。 - 面板覆盖官方 detailsCol，官方「工具调用详情」面板会被挡住
- 这是浏览器端插件。改了
lib/client.js需要强刷页面生效；Node 端lib/index.js的改动需要重启宿主 findFrameParts用[data-details-collapsed]/[class*="centerCol"]定位官方布局，hash class 后缀是稳定的。DSH 大版本升级如果改了结构，这里要重新适配
License
MIT（见 LICENSE 文件）。上游 ccq1/dsh-side-panel 原为 BSD-3-Clause，其归属已在 LICENSE 中保留
