f1da0fe345eff166314a73ec9b0d7d37a67ca979
8
Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
 Menghuan1918
|
6cfe7a736f |
feat: adapt to DSH 0.1.2-alpha.1 (Remote gateway + token auth + MarkdownText labels)
Dual-version compatibility: the plugin now works identically on
0.1.0-rc.8 ~ 0.1.1-rc.2 and 0.1.2-alpha.1 (the latter verified against a
source build of the dsh-v0.1.2-alpha.1 tag: mount smoke 14/14 + aggregate
double-mount; 0.1.1-rc.2 re-verified 14/14).
- MarkdownText: alpha.1 renamed the flat optional `codeLabels` prop to a
required nested `labels: { code: {copyLabel, copiedLabel}, footnotes }`;
the old prop alone crashes fence rendering with "reading 'code'". All
four render sites (mermaid / MarkdownHtml / TextEditor / SideChatView)
now go through src/client/markdown-labels.tsx (dual-shape object passed
under both prop names).
- e2e mount lanes speak both host dialects (tests/e2e/host-protocol.ts +
host.ts, unit-locked by tests/e2e-host-protocol.spec.ts):
- one-time-token browser auth: the launch URL grep extends past the
`/?token=` query (truncating at `/` loses the token), goto navigates
the token URL (browser cookie exchange), and stamped navigations
pre-seed the context cookie via addCookies — the exchange 303 drops
sibling query params;
- Remote gateway: dot endpoints first, slash endpoints on 404 fallback,
with args keyed by the controller parameter name (workspace/create ->
{request}, session/list -> {_request}; verified on a live host).
- package.json: drop the @deepseek-ai/dsh-client-runtime peer (package
removed upstream in alpha.1; zero references in the source — the chunk
externals entry stays and is resolution-tolerant).
- scripts/e2e-mount.sh: fix a latent set -u crash in the npx fallback
branch ($DSH_CMD followed by a full-width comma parsed as part of the
variable name).
- CI pin stays at @deepseek-ai/dsh@0.1.1-rc.2 until alpha.1 publishes to
npm (comment updated); README/AGENTS document the new contracts.
- Version lockstep bumped to 0.17.1.
|
||
|
Atlas Zeng
|
0da2812dd3 |
chore(e2e): remove flaky bottom-panel re-locate test (issue #248) (#299)
The test fails ~50% of CI runs (4 of the last 5 main/PR runs) at the second poll: the bottom panel stays at the pre-swap centerRect for 15s on slow ubuntu runners while the page JS stays responsive. Local reproduction attempts (warm/cold instance, CPU throttling, timing variants) always recover in <1s, so the flake is environmental and cannot be pinned down without CI-side DOM dumps. Removing the test restores the deterministic-gate design (retries: 0); the product locate chain itself is untouched and keeps the issue #248 behavior. |
||
|
Atlas Zeng
|
50a888845f |
feat(sidebar): 桌面兼容三方案——自动检测(WCO 标准几何)/壳预设/自定义 CSS (#284)
* feat(sidebar): 桌面兼容三方案——自动检测(WCO 标准几何)/壳预设/自定义 CSS 核心只保留 Web 标准机制，壳专属适配全部下沉到用户空间（KISS）： - prefs 新增 titleBarScheme(默认 auto)/titleBarPresetId/customCss，旧 titleBarCompat 布尔自动迁移（true→custom 保留 stripPx，false/缺失→auto） - wco.ts：navigator.windowControlsOverlay 反应式几何（geometrychange 实时更新； visible=false 的幽灵 API 视为缺失），实现 #257 - titlebar-strip.ts 唯一 strip 取值链：WCO → dsh-desktop-titlebar-inset 契约参数 → 预设 stripFor → 手动 px → 0；desktop-env.ts 移除 win32 32px 硬编码 - shell-presets.ts 数据驱动预设（准入：issue/PR 提及 + 100+ star；v1 仅 anywhere-labs DSH Desktop：darwin 20px / win32 无 WCO 时 32px），opt-in 手动 - 预设/自定义 CSS 注入（data-dsh-preset-css / data-dsh-custom-css 标签）， chrome 补稳定寻址面 data-dsh-toggle-cluster / data-dsh-panel - 交互 chrome 统一 -webkit-app-region: no-drag（吸收 #111/#153） - layout.css 底栏推挤复合锚点（[data-pane] 与 :has(> [data-slot]) 双保险， rc.8 实测前者失效、后者命中，吸收 #226 思路） - 设置 UI：位置兼容模式齿轮弹窗改三方案（自动检测/壳兼容方案/自定义方案） - 测试：wco/titlebar-strip/shell-presets 单测 + prefs 迁移 + e2e 5 场景 （保守 auto/WCO 反应式/预设/自定义 CSS/复合锚点），挂载门禁 12/12 全绿 核心 grep 无壳专属类名；为某壳做的兼容在另一壳会再坏——预设与自定义 CSS 是唯一出路（AGENTS.md §8 契约已更新）。 * refine(sidebar): 位置兼容模式改主行下拉四选项——自动检测/DSH官方Web/壳预设/自定义 按用户反馈定稿 UI： - 主行下拉：自动检测（默认）/ DSH官方Web（显式零适配，连 WCO 也强制 0）/ 各壳预设（命中环境带「已检测」后缀，仅提示）/ 自定义方案（保留齿轮弹窗： 下移距离 + 自定义 CSS） - 旧文档迁移：titleBarCompat=true 或 titleBarStripPx 非默认值（此前已有配置） → 默认落到 custom 方案保留用户数值；干净文档 → auto - prefs 新增 'web' 方案；strip 取值链最优先处理 web→0 - 测试：prefs 迁移（stripPx 48→custom / 40→auto）、web 强制 0、下拉渲染断言 - 单测 693 通过，挂载 e2e 12/12 全绿 * refine(sidebar): 方案下拉复用 SelectMenu 组件，不用原生 <select> - 抽出可复用 SelectMenu（primitives Menu：锚点按钮 + 下拉选项卡，支持 icon/desc/多选），SelectRow 改为其薄壳 - 位置兼容模式方案下拉改用 SelectMenu；选项带描述（自动检测/DSH官方Web/ 各壳预设(命中带「已检测」后缀)/自定义方案） - 移除原生 select 样式；单测 693 通过，挂载 e2e 12/12 全绿 |
||
|
Atlas Zeng
|
5cc1a4b52e | fix(layout): 推挤变量挂载期持续有效，拖拽松手后底边栏不再闪全宽 (#258) (#259) | ||
|
Atlas Zeng
|
e8d04980b4 |
fix(drag): 中断/快速释放不再回滚，HMR 后中心列重定位兜底 (#247 #248) (#249)
#247 拖拽回退（v0.13.1 无此问题，unified-host 重构引入的回归）： - pointerup 恢复 v0.13.1 语义：以 up 事件坐标（指针最终位置）提交， 不再优先 rAF pending —— 浏览器把快速 flick 的尾部合并进 up 事件时 pending 是陈旧中间值，提交后会“看起来没拖到位” - onPointerCancel 把事件（携带坐标）传给 abortDrag：此前的坐标兜底 是死代码（handler 未传 event），pointercancel 且无 move 时必回滚 - abortDrag 无任何位置信息时采用最后应用尺寸（lastDragSize），不再 显式回滚到拖动前值；pointercancel -> lostpointercapture 双发只提交 一次（dragCommitted 在所有提交路径置位，第二次中断不再回滚） #248 HMR 后底栏空白/输入框位移： - #root 观察改为 childList+subtree：HMR 原地替换 centerCol 节点时 childList-only 观察器不触发，ref/RO 挂在已分离节点上永久失效 - locate 只在列节点身份变化时测量（同节点缩放交给 ResizeObserver）， rAF 防抖避免流式渲染 mutation 突发强制布局 - 列节点断开（isConnected=false）时丢弃引用，下次 tick 重新定位 - 1.5s 兜底重定位 interval：任何 HMR teardown/setup 时序都能在数秒内 收敛（style 属性字节相同、观察器尚未挂上等盲区全部覆盖） 测试： - e2e 新增三条回归：pointercancel 双发提交一次、无坐标 capture-lost 采用最后应用宽度、中心列深层替换后底栏重定位追踪新几何 - 修复既有快速拖动测试的滑入动画竞态（动画中读 strip 盒子在视口外， 指针事件打不到 strip）——此前依赖时序侥幸通过 - 全部在新启动的 scratch DSH 实例（e2e-mount，随机端口）上验证， 未触碰本地 3080 实例；三条新用例对未修复代码均失败（回滚/不恢复） |
||
|
Atlas Zeng
|
6c891514b5 |
feat(injection): 统一面板宿主注入重构——含块层+几何写路径+chunk缓存+锚点弱化+桌面/移动适配 (#232)
* feat(injection): 统一面板宿主——固定含块层 + 挂载自检降级 + body 锚点守卫 - Sidebar 渲染根包 [data-dsh-panel-host]（fixed inset-0 pointer-events:none） - 面板/开关簇由 fixed 改 absolute（层内视口坐标等价），免疫套壳中间层 transform 劫持 - 挂载后一次性几何自检：页面级 transform 时降级 absolute + rAF 视口同步 - MutationObserver（body childList）守卫锚点被宿主清空时重挂 * perf(injection): 几何写路径统一为 writeGeometry + 面板 layout 隔离 - 拖拽帧与打开态共用单一推挤写入器（--dsh-sidebar-width/height） - .panel/.bottomPanel contain: layout style——内部重排不外泄 - 拖拽期（body[data-dsh-sidebar-dragging]）才挂 will-change: transform * perf(chunks): HMR 激活保留未变 chunk 的已解析 exports + ETag HEAD 重验证 - 新增 revalidateChunksOnReactivate()：激活时 HEAD 每个已加载 chunk 对比 ETag， 未变保留内存缓存（跳过重注入/重执行），变更或不可达则 fail-open 重取 - 测试夹具与孤儿缓存条目不跨激活存活 - index.tsx 激活路径由 resetChunks() 改为 revalidateChunksOnReactivate() * fix(layout): 推挤锚点改 data 属性 + #root calc 宽度防桌面壳溢出 - nth-child(2) → #root [data-dsh-frame] > [data-pane="conversation"]（实证同元素） - #root 宽度 calc(100% - var) 与 margin 同步过渡：web 视觉不变（实测 1140+300=1440 无溢出）， Desktop 壳（#208）width:100% 的加性溢出根因消除 * feat(desktop): 桌面信号自动探测 + win32 顶栏 overlay 自动避让 + 键盘/safe-area 适配 - 新增 desktop-env.ts：解析 dsh-desktop-mode/platform URL 信号与 preload 标记 - win32 advanced 壳自动启用 titleBarCompat（32px overlay），手动 pref 仍可覆盖 - visualViewport 键盘 inset：底部面板/窄屏抽屉键盘弹起时上移 - 面板与开关簇 safe-area-inset 适配（env() 桌面端为 0） - 单测 7 例（含 URLSearchParams 前导 ? 剥除修复） * docs+e2e: 注入方案实施记录（路线B关闭、偏差记录、基线数据）+ 契约同步 + e2e 新断言 - 设计文档：路线 B 标记关闭、§8.1 改单 PR 步骤（含 commit 对照）、拖拽基线数据、实施偏差记录 - AGENTS.md §8：data-dsh-panel-host 含块层、推挤锚点契约（禁 nth-child）、桌面信号 - mount.e2e：data-dsh-panel-host 断言 + win32 advanced 桌面信号场景 * fix(cr): 响应 #232 CR 三条 findings - P1 降级同步：按未修正几何判定（跟踪自身补偿量），祖先 transform 消失才退出循环—— 修正后矩形不再被误判为无需修正（自清除缺陷） - P1 chunk 重验证成为 loadChunk 屏障：重验证挂起期间不提供缓存，杜绝 HMR 竞态陈旧 exports； 测试夹具加载不再被误记为生产加载 - P2 键盘 inset：innerHeight - (vv.height + vv.offsetTop)，并监听 scroll（offsetTop 变化） - 新增屏障单测 1 例；设计文档偏差记录更新 * fix(chunks): 屏障 HEAD 加超时兜底 + resetChunks 清 revalidation - revalidateChunksOnReactivate 的 HEAD 与 recordEtag 均带 AbortSignal.timeout(5s)：路由挂起时 fail-open（drop + 重取）， 屏障不再可能无限期阻塞所有懒加载 chunk（CR #232 P1 修复的健壮性缺口） - resetChunks 同步清 revalidation：重验证挂起期间重置后， loadChunk 不再等待已丢弃状态的孤儿任务（finally 身份判断 no-op） - 单测 +2：HEAD 挂起超时 fail-open（fake AbortSignal.timeout 触发中止）、 resetChunks 清屏障后 loadChunk 立即放行 * fix(deps): align @deepseek-ai/* peers with DSH 0.1.0-rc.8 - peer/devDependencies: 13 个 @deepseek-ai/* 从 ^0.1.0-rc.7 升至 ^0.1.0-rc.8；删除随 rc.8 消失的 dsh-client-web-react / dsh-client-schema-form （无 rc.8 发布、rc.8 依赖树与壳 bundle 零引用、插件 src 零引用）； cordis peer/devDep 同步升 ^4.0.0-rc.8 - 版本 0.13.1 -> 0.14.0（package.json / dsh.plugin.json / SIDEBAR_SERVICE_VERSION 三处同步） - CHUNK_EXTERNALS / CLIENT_EXTERNALS / CLIENT_REQUIRE_ALLOWED 三处镜像 同步删除两个死包（primitives/slots 仍是 rc.8 壳静态模块表种子，保留） - CI 挂载冒烟钉版 @deepseek-ai/dsh@0.1.0-rc.7 -> rc.8 - pnpm clean --lockfile 全量重解析：lockfile 内 @deepseek-ai/* rc.7 残留 清零（传递链同升 rc.8，杜绝 #206 式混用树）；pnpm-workspace.yaml minimumReleaseAgeExclude 按 #207 模式整体换为 rc.8 列表 - 文档同步：README 安装说明、AGENTS.md CI 钉版、外部插件指南与设计文档 cordis 示例、issue 模板版本示例 * feat(prefs): editorExplorer 默认独立（关）——文件各自新开 tab - SIDEBAR_PREFS_DEFAULTS 与 host PrefsSchema 的 editorExplorer 默认 true -> false：新会话树点击/打开文件按 path 新开 tab，无路径窗口即 纯资源管理器；合并模式保留为可选手动开启（持久化过的用户设置不受影响） - 测试同步：prefs.spec 默认断言翻转、plugin-shape.spec 与 smoke.spec 默认对象翻转；editor-host 合并模式用例显式开启 editorExplorer（split 用例本已显式）；side-card-section-rows 的 select 行用例固定选中 Merged - e2e 重写：mount.e2e 文件打开流程从 in-place 断言改为独立模式 （新开 hello.txt tab、Files home tab 保留），文件头注释同步 - 契约文档同步：AGENTS.md §3.4 editor 行默认描述翻转 + CI 冒烟描述、 README/README_EN v0.13.0 特性描述 + v0.14.0 changelog * fix(client): rc.8 模块系统经 ctx.modules 注入 + chunk 副本全局共享 rc.8 不再暴露 window.__DSH_MODULES__ 页面全局（改由 ctx.modules 服务 提供），chunk 外部依赖解析全面失效（terminal/editor/mermaid 全部 "client module system unavailable"）。修复： - src/client/index.tsx: inject 增加 'modules'（Cordis 服务访问守卫， 此前直接读 ctx.modules 抛 "cannot get property modules without inject"）；apply() 激活时 setChunkModuleSystem(ctx.modules) - package.json dsh.client.inject 增加 @deepseek-ai/dsh-client-modules - chunk-loader: 注入写插件自有页面全局 __dshSidebarModuleSystem__—— 懒加载 chunk bundle 各自内联一份 loader（rc.7 靠官方全局回退工作， rc.8 全局消失后副本注入变量恒空）；moduleSystem() 按 注入变量 → 插件全局 → rc.7 全局回退解析 - context-types: Context 镜像补 modules 服务声明（client half） - e2e: assertNoCrash 失败时输出错误条文本；独立模式断言修正 （Files 数量按存在性、mermaid 流程先切回 Files、md 预览 locator 去掉 重复的 [data-dsh-better-sidebar] 嵌套） 验证：typecheck / 639 测试全绿；本地 rc.8 CLI + Chromium 挂载冒烟 3/3 通过（drag-layout、mount 深扫含 editor/mermaid chunk、桌面信号） * feat(settings): 终端 shell/shellArgs 可在设置页配置（bash 管理） - SidebarPrefs 新增 terminalShell / terminalShellArgs（默认空 = 保持 yaml config.shell → $SHELL / 登录 shell / powershell.exe 的既有解析） - 终端卡齿轮二级页面新增两行 text 配置（与字体行同列） - host 侧生效链路：UI 终端 WS 打开与 agent terminal_create 均读取 设置文档覆盖（ptyManager.open / AgentPtyRegistry.create 增加可选 shell 覆盖参数；shellOverridesOf 解析设置文档）；设置页写入即时 影响之后打开的终端（既有 pty 保持原 shell） - locales zh/en 文案；parsePrefs 校验新字段；测试同步 * feat(settings): 侧边卡片设置页加 DSH-better-sidebar 版本徽标 - 设置页 intro 下新增身份徽标：名称 + v{service.version}（服务实例 版本，与 package.json 由 tests/service.spec.ts 保持同步） - token 驱动样式（--dsw-alias-*），名称/版本 pill 布局 * fix(drag): 快速拖动提交最后位置 + HMR 后中心列重定位兜底 快速释放（浏览器合并/丢失 pointermove 突发，超快速 flick 甚至可能 完全无 move）时的回退问题： - pointerup 优先采用最后一次已知拖动值（rAF pending），而非 up 位置 （事件合并时可能等于按下位置） - pointercancel / lostpointercapture 中断时同样提交最后已知位置； 无 move 时用中断事件自身的坐标计算（clamp 后提交）——只有真正 未产生位移的拖动才回滚 - commitDrag 统一 flush + 同值提交 + 立即重测中心列（消除提交后 React 用旧 centerRect 覆盖底栏 right 的中间帧） HMR 重激活后底栏空白（输入框被推挤上移、强制刷新恢复）： - 根因：新组件实例重跑 locate 时壳的 centerCol 尚未就绪，而壳重建 复用 #root 子节点（childList 观察器不触发）→ centerRect 卡 {0,0} → 底栏 visibility:hidden 永久空白 - 修复：额外观察 <html> 的 style 属性（layout push 写回 --dsh-sidebar-* 时重定位重测）；底栏打开时 effect 重跑 locate/measure 兜底 - 底栏未测量时由「不渲染」改为 visibility:hidden（渲染链不被几何 门控，jsdom 测试不回归） e2e 新增：极快拖动（单 move 立即 up）提交拖动位置、稳定后不回退 * feat(plugins): 添加插件目录支持搜索/分组/独立滚动（多插件场景） - PluginListBody 顶部加实时搜索框（按名称/id/描述过滤，空结果提示） - PluginEntry 增加可选 category 分组字段（i18n 友好），目录条目按组 渲染（未分类条目保持平铺）；数量徽标跟随过滤结果 - 条目列表 max-height + overflow-y 独立滚动，插件多时弹窗不再无限 增长；渲染数量由搜索天然收敛 - locales zh/en（搜索占位、无匹配）；测试文件固定英文环境 （vitest 4.1.11+ jsdom 跟随系统 locale，本机 zh-CN 导致英文文案 断言漂移） * chore(deps): 适配 pnpm 11.8 supply-chain 校验（exclude 通配） pnpm 11.8.0 起对 lockfile 既有条目强制 minimumReleaseAge 校验， 且精确 exclude（@scope/pkg@version）对带 peer 依赖后缀的解析条目 匹配失效（44 条误报违规，CI 全红）。@deepseek-ai/* scope 为官方 可信 scope，minimumReleaseAgeExclude 改为 '@deepseek-ai/*' 通配 （保留 rc.1 历史与 stable 条目）；通配经实测通过全部 504 条校验。 * docs: v0.14.0 changelog 补全（自 v0.13.1 全部更改 + 特别声明 rc.8 适配） 新增条目：终端 shell/shellArgs 设置页配置、设置页版本徽标、 添加插件目录搜索/分组/滚动、rc.8 模块系统迁移、拖拽健壮性修复； 版本说明块醒目声明本版适配 DSH 0.1.0-rc.8（rc.7 及更早无法解析依赖） |
||
|
Atlas Zeng
|
6ee1ba11d0 |
feat(editor): 文件窗口与资源管理器二合一 + 声明式设置 select 行 (#151)
* feat(editor): merged explorer mode — path input, docked file tree, global name search
New editorExplorer pref (default on, editor card gear): the editor tab gains
a path-input header and a toggleable right-docked tree panel (per-tab state
in tab.meta.treeOpen; file tabs default closed, the seeded path-less home
tab defaults open). Fresh sessions seed that empty editor tab instead of
the explorer tab when merged mode is on; the standalone explorer tab stays
in the + menu unchanged.
- Extract FileTree.tsx from ExplorerView (shared by both hosts)
- Host fs.search route: recursive case-insensitive name search rooted at
the session cwd, budget-capped (200 matches / 100k visited), skips .git,
never descends symlink dirs
- EditorHost reads the pref reactively (boolean snapshot) and keeps the
pre-merge layout verbatim when off
* feat(settings): select row type for declarative settings; editorExplorer as iconed select
- SidebarSettingToggle gains type 'select' with options {value,title,desc,icon}
and multi (default false; stores the picked values as an array in options
order). Any option carrying an icon renders big-icon option cards in the
dropdown and the icon in the closed anchor; icon-less rows are one-line text.
- SelectRow in SideCardSection rides the primitives Menu (portal); single-pick
commits and closes, multi toggles and stays open. Wired for both host-prefs
toggles and plugin-owned pluginToggles via the new onSelectValue seam.
- The editorExplorer merged-mode pref is now an iconed select (merged vs
separate) instead of a switch; the stored value stays boolean.
- Advertise the capability as 'settingSelect' in SIDEBAR_FEATURES.
* feat(editor): unify explorer into the editor surface, resizable tree dock, hoisted toolbar
- One tree implementation, two presentations: the shared TreePanel (global
name search + refresh + FileTree) docks as the editor tab's right panel
and — in merged mode — fills the explorer tab's window; the pref-off
explorer keeps its legacy header shell.
- The docked panel drag-resizes from its left edge (160-480px clamp),
persisted as tab.meta.treeWidth alongside treeOpen.
- The text editor's preview/edit/save toolbar moves into the path-input
header row: FileViewerProps gains internal toolbar fields ('host' mode
skips the viewer's own row, reports EditorToolbarState and registers
EditorToolbarControls); non-merged mode is byte-identical to before.
* feat(editor): single files window with in-place switching; explorer descriptor removed
- editor tab replaces explorer on the + menu (order 10, Files); persisted
explorer tabs migrate to the editor home tab via sanitizeState
- editorExplorer now only controls open behavior: merged = in-place
updateTab, independent = openSidebarFile; both modes share the merged
chrome (path input + hoisted preview/edit/save toolbar + tree toggle)
- file tree context menu gains 'open in new tab' / 'open to the side'
(mintTabId avoids the id safety net; insertLeafAt splits right)
- tree dock resize uses pointer capture (touch-action none, 6px handle)
- defaults: openByDefault off, sidebar width 35%
- file tree clips horizontal overflow (no sideways scroll)
- e2e: mount lane arms the editor-chunk wait before goto and clicks the
tree row's left edge (hover @-reference button sits mid-row); drag lane
expands the panel first (collapsed push writes 0px), waits for the
slide-in to settle, and picks the leftmost col-resize strip; 'Files'
title assertions require draggable to skip the bottom panel's welcome
cards
* feat(editor): split mode turns the path-less window into the standalone explorer
In independent (split) mode a path-less files window renders ONLY the
tree panel (search + FileTree, full-window form) — no path input, no
hoisted toolbar, no tree toggle. File clicks open per-path editor tabs
(full chrome, tree docked closed by default) through openSidebarFile,
unchanged. Merged mode is untouched (chrome + docked tree, in-place
switching). TreePanel's previously reserved 'full' prop now has its
consumer.
|
||
|
Atlas Zeng
|
3c196fffc3 |
feat: 皮肤兼容（令牌驱动）+ CSS 修复（#106 #105 #90 #60，附带 #52 #57 #92） (#110)
令牌驱动方案（主目标：与 dsh-web-ui 皮肤中心兼容）： - 面板表面改用通用卡片令牌 --dsw-alias-bg-layer-1，不再消费宿主左导航专属 --dsw-specific-sidebar-fill——dsh-web-ui 10 款皮肤全部覆盖 --dsw-alias-* 层，换肤后侧边栏自动跟随，零每皮肤适配（#60/#105/#106）。 - effectiveTokenValue 增加 alpha 阈值（新增 colorAlpha 解析 computed 颜色）： transparent 与 alpha<0.9 的半透明玻璃值（dsh-web-ui 皮肤 bg-base 为 rgba 0.16–0.7）一律回退不透明底色，终端/编辑器文字永不叠在皮肤背景画上 （#90）；≥0.9 的近不透明值放行，皮肤仍可控终端表面。 独立修复（保留）： - z-index 降到 DSH 浮层栈（100+）之下：面板 40 / 按钮簇 45 / 角手柄面板内 局部 2，Cordis 弹出框不再被底部工作台遮挡（#52）。 - 角手柄移入右面板、CSS 相对定位（bottom: calc(var(--dsh-sidebar-height) + 6px)），删除 JS 内联 viewport 坐标。 - 刷新按钮统一 14px（#57 前半）。 - 拖拽逐帧回归 e2e（#92）：真实挂载下 rAF 采样（拖条以 cursor: col-resize 语义定位），断言拖拽期间 data-dsh-sidebar-dragging 存在、#root transition 为 none、会话列与面板边单调 1:1 跟随（实测通过）。 按 KISS 回退首版契约：类名 kebab-case 改名与 data-bs-* 语义钩子全部移除 （令牌驱动下不需要，改名引入无谓 breaking），skin-hooks 测试删除； mount e2e 改为断言 --dsh-sidebar-width 布局变量随面板挂载生效。 文档：AGENTS.md §8 重写为「皮肤兼容（令牌驱动）」；设计文档记录决策与 回退。README 与版本号不在本批更新（发布流程统一处理）。 测试：tests/theme.spec.ts（colorAlpha + effectiveTokenValue 阈值）； typecheck/vitest(511)/build/consumer-types/test:mount 全绿。 |