dsh-plugin-workbench 0.0.14 → 0.0.16

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [0.0.16] - 2026-09-04
+
+### Fixed
+
+- **适配 dsh 0.1.2-rc.1 布局 bundle**：两处补丁锚点失配导致插件启动时自动重打失败
+  （启动日志 `ui-layout patch exited 1`，explorer 布局不生效）。⑴ `css.explorerCol.rule`：
+  detailsCol 边框样式 `border-left:1px solid var(--dsw-alias-border-l2)` 在新版改为
+  `.5px solid var(--dsw-alias-border-l3)`，锚点与注入规则同步更新；⑵
+  `appframe.explorerColumn`：DetailsColumn 的 children 在新版被 `SessionProvider`
+  包裹，锚点按新结构更新。其余 22 个锚点与 `computeColumns` 函数体逐字节未变。
+# Changelog
+
+## [0.0.15] - 2026-08-29
+
+### Fixed
+
+- **DSH Desktop 下文件树列不显示（[issue #1](https://github.com/Pasumao/dsh-plugin-workbench/issues/1)）**：
+  布局补丁的锚点按 npm 构建的编译产物逐字节写死，而 DSH Desktop 安装包内置的
+  `dsh-client-ui-layout` 是同一版本的另一构建产物（保留注释、缩进不同、折叠侧栏宽度用
+  `COLLAPSED_SIDEBAR_WIDTH` 常量），`computeColumns` 锚点失配导致补丁每次启动整体放弃——
+  插件加载正常但界面永远不出现。补丁脚本现按目标文件自动探测构建变体（npm / desktop-ci，
+  后者锚点存于 `scripts/layout-anchors.desktop-ci.json`），两种产物都能正确打补丁。
+
 ## [0.0.14] - 2026-08-29
 
 - 文档：对标生态头部插件优化 README（首屏新增「装完你会看到」；布局补丁话术改为开箱即用）；

package/README.en.md

@@ -16,6 +16,8 @@ Once installed, the DSH web GUI becomes a lightweight code editor.
 > ✅ **Works out of the box**: since 0.0.9 the layout patch is fully automated — it takes effect right after install and
 > restart; if a DSH upgrade overwrites the bundle, the plugin patches it back automatically, with no manual steps
 > required (manual action is only needed if the anchors break, see the "Configuration" section).
+> Since 0.0.15 both build flavors — the npm build and the DSH Desktop bundled build — are detected automatically, so
+> **DSH Desktop works out of the box** too.
 
 What you'll see after installing:
 
@@ -81,8 +83,9 @@ What you'll see after installing:
 ## Configuration
 
 No environment variables or config files needed; the layout patch is fully automated (the plugin automatically detects
-and re-runs `scripts/patch-layout.mjs` at startup — idempotent, non-blocking; written against
-`dsh-client-ui-layout@0.1.0-rc.6`):
+and re-runs `scripts/patch-layout.mjs` at startup — idempotent, non-blocking; since 0.0.15 both build flavors of the
+same version are detected automatically — the npm build and the DSH Desktop bundled build; anchors are byte-coupled to
+the compiled output, so a DSH upgrade that breaks them requires anchor updates):
 - **Behavior preferences** (word wrap, light/dark theme, tab layout, file tree expansion state) persist per workspace
   and need no manual configuration;
 - **File operation channel**: via the loopback RPC `/dsh-plugin-files`; write operations are executed explicitly under
@@ -90,9 +93,9 @@ and re-runs `scripts/patch-layout.mjs` at startup — idempotent, non-blocking;
 
 ## Installation
 
-> The layout patch is written against `dsh-client-ui-layout@0.1.0-rc.6`; other versions require updating the anchors.
-> Since 0.0.9 the plugin detects and re-applies the patch automatically at startup (see the "Configuration" section
-> for details).
+> Layout-patch anchors are byte-coupled to the DSH compiled output; a DSH upgrade that breaks them requires anchor
+> updates. Since 0.0.15 both build flavors (npm / DSH Desktop) are detected automatically and the patch re-applies at
+> startup (see the "Configuration" section for details).
 
 ```powershell
 # npm (recommended)
@@ -146,6 +149,8 @@ dsh plugin --profile web remove dsh-plugin-workbench
   bytes, with a 20MB limit
 - DSH upgrades overwrite the layout bundle; since 0.0.9 the plugin detects and re-applies the patch automatically at
   startup, so there is no need to re-run it manually; if the anchors break, `scripts/patch-layout.mjs` must be updated
+  (since 0.0.15 the anchor table carries two build variants auto-detected per target — npm and desktop-ci, the latter
+  stored in `scripts/layout-anchors.desktop-ci.json`)
 - This repository does not include DSH build artifacts
 
 ## Contributing
@@ -153,6 +158,15 @@ dsh plugin --profile web remove dsh-plugin-workbench
 See [CONTRIBUTING](./CONTRIBUTING.md) and [CODE_OF_CONDUCT](./CODE_OF_CONDUCT.md); the changelog is in
 [CHANGELOG](./CHANGELOG.md).
 
+## Compatibility
+
+- Tested on DSH `0.1.2-rc.1` (since 0.0.16 the layout patch anchors are adapted to that
+  version: the detailsCol border style changed from `1px/--dsw-alias-border-l2` to
+  `.5px/--dsw-alias-border-l3`, and the DetailsColumn children gained a `SessionProvider`
+  wrapper); for 0.1.1-rc.2 and earlier, use the 0.0.15 anchor table.
+- Since 0.0.9 the plugin re-applies the layout patch automatically at startup, so DSH
+  upgrades normally need no manual action; on anchor mismatch the startup log shows
+  `ui-layout patch exited 1` — upgrading this plugin fixes it.
 ## Related plugins
 
 This plugin is part of **Pasumao's dsh plugin ecosystem**; the published plugins in the same series can be used

package/README.md

@@ -15,6 +15,7 @@
 
 > ✅ **开箱即用**：0.0.9 起布局补丁全自动——装完重启即生效；DSH 升级覆盖 bundle
 > 后插件会自动补回，无需任何手动操作（仅锚点失效时才需手动，见「配置」节）。
+> 0.0.15 起自动识别 npm 与 DSH Desktop 两种构建产物，**DSH Desktop 开箱即用**。
 
 装完你会看到：
 
@@ -73,15 +74,17 @@
 ## 配置
 
 无需环境变量或配置文件；布局补丁全自动（插件启动时自动检测并重跑
-`scripts/patch-layout.mjs`，幂等、非阻塞；针对 `dsh-client-ui-layout@0.1.0-rc.6`
-编写）：
+`scripts/patch-layout.mjs`，幂等、非阻塞；0.0.15 起自动识别同一版本的两种构建产物
+——npm 构建与 DSH Desktop 内置构建；锚点与编译产物字节级耦合，DSH 升级后如失配
+需更新锚点）：
 - **行为偏好**（自动换行、亮暗主题、标签布局、文件树展开状态）按工作区持久化，无需手动配置；
 - **文件操作通道**：经 loopback RPC `/dsh-plugin-files`，写操作显式以 `danger-full-access` 执行，无外部配置项。
 
 ## 安装
 
-> 布局补丁针对 `dsh-client-ui-layout@0.1.0-rc.6` 编写，其他版本需更新锚点。
-> 0.0.9 起插件启动时自动检测并重打补丁（详见「配置」节）。
+> 布局补丁锚点与 DSH 编译产物字节级耦合，DSH 升级后如失配需更新锚点；0.0.15 起
+> 自动识别 npm / DSH Desktop 两种构建产物，插件启动时自动检测并重打补丁
+> （详见「配置」节）。
 
 ```powershell
 # npm（推荐）
@@ -132,7 +135,9 @@ dsh plugin --profile web remove dsh-plugin-workbench
 - 图片预览走同源路由 `/dsh-plugin-files/raw/<path>`：仅响应图片扩展名，
   先经 `ctx.fs.resolve → stat`（沙箱一致的路径解析）再读取字节，20MB 上限
 - DSH 升级会覆盖布局 bundle；0.0.9 起插件启动时自动检测并重打补丁，
-  无需手动重跑；锚点失效时需更新 `scripts/patch-layout.mjs`
+  无需手动重跑；锚点失效时需更新 `scripts/patch-layout.mjs`（0.0.15 起锚点表分
+  npm / desktop-ci 两个构建变体自动探测，desktop-ci 变体存于
+  `scripts/layout-anchors.desktop-ci.json`）
 - 本仓库不包含 DSH 编译产物
 
 ## 参与贡献
@@ -140,6 +145,14 @@ dsh plugin --profile web remove dsh-plugin-workbench
 见 [CONTRIBUTING](./CONTRIBUTING.md) 与 [CODE_OF_CONDUCT](./CODE_OF_CONDUCT.md)；
 变更记录见 [CHANGELOG](./CHANGELOG.md)。
 
+## 兼容性
+
+- 实测于 DSH `0.1.2-rc.1`（0.0.16 起布局补丁锚点适配该版：detailsCol 边框样式
+  `1px/--dsw-alias-border-l2` → `.5px/--dsw-alias-border-l3`、DetailsColumn 的
+  children 新增 `SessionProvider` 包裹）；0.1.1-rc.2 及更早版本用 0.0.15 的锚点表。
+- 0.0.9 起插件启动时自动检测并重打布局补丁，DSH 升级后通常无需手动操作；
+  锚点失配会在启动日志提示 `ui-layout patch exited 1`，此时升级本插件即可。
+
 ## 相关插件
 
 本插件属于 **Pasumao 的 dsh 插件生态**，同系列已发布插件可搭配使用：

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-plugin-workbench",
   "description": "VS Code-style workspace file explorer for the DeepSeek Harness web GUI — editable preview with syntax highlighting, tabs and line numbers, full right-click file operations (create / rename / delete / copy / cut / paste / reveal in file manager), inline image & markdown preview, @-mention files into chat, drag files into the composer, per-workspace state with undo. Turns the dsh web page into a lightweight code editor.",
-  "version": "0.0.14",
+  "version": "0.0.16",
   "type": "module",
   "packageManager": "pnpm@11.21.0",
   "engines": {

package/scripts/layout-anchors.desktop-ci.json

@@ -0,0 +1,6 @@
+{
+  "variant": "desktop-ci",
+  "note": "computeColumns anchor/replacement for the DSH Desktop packaged build of @deepseek-ai/dsh-client-ui-layout (2-tab indent, COLLAPSED_SIDEBAR_WIDTH, one stray CRLF). Generated mechanically from a real bundle; do not hand-edit.",
+  "anchor": "\t\tfunction computeColumns(viewport, sidebar, details) {\n\t\t\tconst s = sidebar === 0 ? COLLAPSED_SIDEBAR_WIDTH : clampWidth(sidebar, 264, 420);\r\n\t\t\tconst d0 = details === 0 ? 0 : clampWidth(details, 300, 520);\n\t\t\tif (s + d0 + 640 <= viewport) return {\n\t\t\t\tsidebar: s,\n\t\t\t\tcenter: viewport - s - d0,\n\t\t\t\tdetails: d0\n\t\t\t};\n\t\t\tconst d1 = d0 === 0 ? 0 : Math.max(300, viewport - s - 640);\n\t\t\tif (s + d1 + 640 <= viewport) return {\n\t\t\t\tsidebar: s,\n\t\t\t\tcenter: 640,\n\t\t\t\tdetails: d1\n\t\t\t};\n\t\t\treturn {\n\t\t\t\tsidebar: s,\n\t\t\t\tcenter: Math.max(0, viewport - s),\n\t\t\t\tdetails: 0\n\t\t\t};\n\t\t}",
+  "replacement": "\t\tfunction computeColumns(viewport, sidebar, explorer, details) {\n\t\t\tconst s = sidebar === 0 ? COLLAPSED_SIDEBAR_WIDTH : clampWidth(sidebar, 264, 420);\r\n\t\t\tconst e0 = explorer === 0 ? 0 : clampWidth(explorer, 200, 420);\r\n\t\t\tconst d0 = details === 0 ? 0 : clampWidth(details, 300, 520);\n\t\t\tif (s + e0 + d0 + 640 <= viewport) return {\n\t\t\t\tsidebar: s,\n\t\t\t\texplorer: e0,\n\t\t\t\tcenter: viewport - s - e0 - d0,\n\t\t\t\tdetails: d0\n\t\t\t};\n\t\t\tconst d1 = d0 === 0 ? 0 : Math.max(300, viewport - s - e0 - 640);\n\t\t\tif (s + e0 + d1 + 640 <= viewport) return {\n\t\t\t\tsidebar: s,\n\t\t\t\texplorer: e0,\n\t\t\t\tcenter: 640,\n\t\t\t\tdetails: d1\n\t\t\t};\n\t\t\treturn {\n\t\t\t\tsidebar: s,\n\t\t\t\texplorer: e0,\n\t\t\t\tcenter: Math.max(0, viewport - s - e0),\n\t\t\t\tdetails: 0\n\t\t\t};\n\t\t}"
+}

package/scripts/patch-layout.mjs

@@ -8,6 +8,17 @@
  * this script performs precise, idempotent string replacements and verifies
  * every anchor landed. It backs up the original before the first write.
  *
+ * The same @deepseek-ai/dsh-client-ui-layout version ships as TWO different
+ * builds with byte-different output:
+ *   - "npm":        the npm-registry tarball (function bodies at 0 indent,
+ *                   literal `56`, LF-only line endings);
+ *   - "desktop-ci": the build packaged inside DSH Desktop's resources/app and
+ *                   cloned into its profile (2-tab indented computeColumns,
+ *                   `COLLAPSED_SIDEBAR_WIDTH` constant, one stray CRLF).
+ * Every variant shares all anchors except `computeColumns`; both variants are
+ * dry-run against the target and the first one whose anchors ALL match is
+ * applied. If none matches, the bundle changed again — update the anchors.
+ *
  * Usage:
  *   node scripts/patch-layout.mjs [--target <abs path to client.js>] [--force]
  *
@@ -19,6 +30,7 @@ import { basename, dirname, join, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { homedir } from 'node:os'
 
+const SCRIPT_DIR = fileURLToPath(new URL('.', import.meta.url))
 const REPO_ROOT = fileURLToPath(new URL('..', import.meta.url))
 const BACKUP_DIR = join(REPO_ROOT, 'patches', 'layout.backup')
 
@@ -36,8 +48,8 @@ const L = (...lines) => lines.join('\n')
 const REPLACEMENTS = [
   {
     id: 'css.explorerCol.rule',
-    anchor: '.pI_x6G_detailsCol{border-left:1px solid var(--dsw-alias-border-l2);min-width:0;overflow:hidden}',
-    replacement: '.pI_x6G_detailsCol{border-left:1px solid var(--dsw-alias-border-l2);min-width:0;overflow:hidden}.pI_x6G_explorerCol{background:var(--dsw-specific-sidebar-fill);border-right:1px solid var(--dsw-alias-border-l1);min-width:0;overflow:hidden}',
+    anchor: '.pI_x6G_detailsCol{border-left:.5px solid var(--dsw-alias-border-l3);min-width:0;overflow:hidden}',
+    replacement: '.pI_x6G_detailsCol{border-left:.5px solid var(--dsw-alias-border-l3);min-width:0;overflow:hidden}.pI_x6G_explorerCol{background:var(--dsw-specific-sidebar-fill);border-right:.5px solid var(--dsw-alias-border-l3);min-width:0;overflow:hidden}',
   },
   {
     id: 'css.explorerCol.handleContent',
@@ -162,7 +174,7 @@ const REPLACEMENTS = [
   },
   {
     id: 'appframe.explorerColumn',
-    anchor: '\t\t\t\t\t(0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [(0, react_jsx_runtime.jsx)(CenterColumn, { children: renderSlot("conversation", {}) }), (0, react_jsx_runtime.jsx)(DetailsColumn, { children: renderSlot("details", {}) })] }),',
+    anchor: '\t\t\t\t\t(0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [(0, react_jsx_runtime.jsx)(CenterColumn, { children: renderSlot("conversation", {}) }), (0, react_jsx_runtime.jsx)(DetailsColumn, { children: (0, react_jsx_runtime.jsx)(SessionProvider, { children: renderSlot("details", {}) }) })] }),',
     replacement: L(
       '\t\t\t\t\t(0, react_jsx_runtime.jsx)("div", {',
       '\t\t\t\t\t\tclassName: AppFrame_module_css_default.explorerCol,',
@@ -170,7 +182,7 @@ const REPLACEMENTS = [
       '\t\t\t\t\t\t\twidth: cols.explorer',
       '\t\t\t\t\t\t})',
       '\t\t\t\t\t}),',
-      '\t\t\t\t\t(0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [(0, react_jsx_runtime.jsx)(CenterColumn, { children: renderSlot("conversation", {}) }), (0, react_jsx_runtime.jsx)(DetailsColumn, { children: renderSlot("details", {}) })] }),',
+      '\t\t\t\t\t(0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [(0, react_jsx_runtime.jsx)(CenterColumn, { children: renderSlot("conversation", {}) }), (0, react_jsx_runtime.jsx)(DetailsColumn, { children: (0, react_jsx_runtime.jsx)(SessionProvider, { children: renderSlot("details", {}) }) })] }),',
     ),
   },
   {
@@ -242,8 +254,41 @@ const REPLACEMENTS = [
   },
 ]
 
+// desktop-ci variant: same table, with `computeColumns` swapped for the anchor
+// pair extracted mechanically from a real DSH Desktop packaged bundle.
+const DESKTOP_CI = JSON.parse(readFileSync(join(SCRIPT_DIR, 'layout-anchors.desktop-ci.json'), 'utf8'))
+const VARIANTS = [
+  { id: 'npm', replacements: REPLACEMENTS },
+  {
+    id: 'desktop-ci',
+    replacements: REPLACEMENTS.map((item) =>
+      item.id === 'computeColumns'
+        ? { id: 'computeColumns', anchor: DESKTOP_CI.anchor, replacement: DESKTOP_CI.replacement }
+        : item
+    ),
+  },
+]
+
 const PATCHED_MARKERS = ['"explorerCol": "pI_x6G_explorerCol"', 'setExplorer: (d, px) => {', 'renderSlot("explorer"', 'renderSlot("explorer.preview"', 'conversationSeat']
 
+function applyReplacements(original, replacements) {
+  let patched = original
+  const failures = []
+  for (const item of replacements) {
+    const count = countOccurrences(patched, item.anchor)
+    if (count === 0) {
+      failures.push(`${item.id}: anchor not found`)
+      continue
+    }
+    if (count > 1) {
+      failures.push(`${item.id}: anchor found ${count} times (expected exactly 1)`)
+      continue
+    }
+    patched = patched.replace(item.anchor, item.replacement)
+  }
+  return { patched, failures }
+}
+
 function main() {
   const target = resolve(targetArg ?? defaultTarget)
   if (!existsSync(target)) {
@@ -264,6 +309,19 @@ function main() {
     console.log('[patch-layout] --force: re-patching from the current file. Consider restoring the .orig backup first.')
   }
 
+  const trials = VARIANTS.map((variant) => ({ id: variant.id, ...applyReplacements(original, variant.replacements) }))
+  const chosen = trials.find((trial) => trial.failures.length === 0)
+  if (!chosen) {
+    console.error('[patch-layout] ABORTED — the bundle matches no known build variant:')
+    for (const trial of trials) {
+      console.error(`  variant "${trial.id}":`)
+      for (const failure of trial.failures) console.error(`    - ${failure}`)
+    }
+    console.error('[patch-layout] the dsh version may have changed; update the variant anchors in scripts/.')
+    process.exit(1)
+  }
+  console.log(`[patch-layout] build variant: ${chosen.id}`)
+
   mkdirSync(BACKUP_DIR, { recursive: true })
   const pristine = join(BACKUP_DIR, 'client.js.orig')
   if (!existsSync(pristine)) {
@@ -274,36 +332,14 @@ function main() {
     copyFileSync(real, join(BACKUP_DIR, `client.js.${stamp}.bak`))
   }
 
-  let patched = original
-  const failures = []
-  for (const item of REPLACEMENTS) {
-    const count = countOccurrences(patched, item.anchor)
-    if (count === 0) {
-      failures.push(`${item.id}: anchor not found`)
-      continue
-    }
-    if (count > 1) {
-      failures.push(`${item.id}: anchor found ${count} times (expected exactly 1)`)
-      continue
-    }
-    patched = patched.replace(item.anchor, item.replacement)
-  }
-
-  if (failures.length > 0) {
-    console.error('[patch-layout] ABORTED — the bundle does not match the expected compiled output:')
-    for (const failure of failures) console.error(`  - ${failure}`)
-    console.error('[patch-layout] the dsh version may have changed; update scripts/patch-layout.mjs anchors.')
-    process.exit(1)
-  }
-
-  const missingMarkers = PATCHED_MARKERS.filter((marker) => !patched.includes(marker))
+  const missingMarkers = PATCHED_MARKERS.filter((marker) => !chosen.patched.includes(marker))
   if (missingMarkers.length > 0) {
     console.error('[patch-layout] verification failed — missing markers:')
     for (const marker of missingMarkers) console.error(`  - ${marker}`)
     process.exit(1)
   }
 
-  writeFileSync(real, patched, 'utf8')
+  writeFileSync(real, chosen.patched, 'utf8')
   console.log(`[patch-layout] patched: ${real}`)
   console.log('[patch-layout] verified: explorerCol class, setExplorer action, explorer slot render.')
   console.log('[patch-layout] restart dsh web to serve the new bundle rev.')