dsh-better-sidebar
DSH web 插件：类似 VSCode 的右侧边栏（资源管理器 / 编辑器 / 终端 / git / 浏览器），按对话会话隔离。提供服务，供其他插件注册侧边栏标签页和文件查看器。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:omdsh-dev/DSH-better-sidebar#817ee8fc6da2a1476e2e02d5be5d5b9c7c48c00f
Better Sidebar 以 dsh-better-sidebar 发布，当前版本为 0.19.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
[!IMPORTANT] 已适配 DSH 原生侧边栏 API（v0.19.0 起，DSH
0.1.5-rc.1+）：右列就是 DSH 自己的右侧栏——插件的每个 tab 类型与 tab 体通过ctx.sidebarRightTabs/ctx.sidebarRight注册与打开，聊天里的文件打开统一走ctx.sidebarRight.openResource('dsh-resource://file/…')，插件不再自绘右侧面板（旧的浮窗能力同步移除）。自绘的底部工作台与开放给其他插件的ctx.betterSidebar服务保持不变，接入方式见插件接入指南。
ctx.betterSidebar 服务开放给所有插件——registerTab / registerFileViewer 注册新的侧边栏页面与文件预览器。
registerFileIcon 注册自定义图标与目录图标）+ CodeMirror 编辑器；图片 / Markdown（含 Mermaid 图表，strict 安全渲染 + 点击放大；README 级内嵌 HTML——徽章墙 / <details> 折叠 / 表格内联标签经 DOMPurify 消毒真实渲染；浮动目录大纲一键跳转）/ HTML / PDFterminal_* 工具sidebar_open 工具——模型可主动在侧边栏打开文件 / 文件夹（树以该目录为根）/ HTTP(S) 网页.md 操作（读 / 写 / 编辑）预览头部可切换阅读模式——经共享 MarkdownText 渲染 GFM 表格 / 任务列表 / 删除线 / 脚注 / 数学公式，本地图片自动改写为 /sidebar/file 媒体路由；含 ```mermaid 围栏时走编辑器同款懒加载 mermaid 渲染器（图可点击缩放 / 平移）；敏感内容脱敏——凭据形态路径整文件遮罩、普通文件按内容形态遮值（api_key: / Bearer / sk- / AKIA / ghp_ / PEM 等，字段名保留），默认开启、预览面板一键开关（localStorage 记忆），仅影响显示、不改会话数据。已知边界：mermaid 无引号节点标签含被遮密钥时，图回退源码（规避：标签加引号）；.html 操作（读 / 写 / 编辑）预览头部可切换渲染模式——复用编辑器同款 /sidebar/html 路由 iframe，相对资源（./style.css、img/x.png）同路由解析，分段读取也渲染完整文档，恒定沙箱（opaque origin + CSP 头，无逃生门）；.pdf 操作（读 / 写 / 编辑）同样可切换渲染模式——复用编辑器同款 PDF 预览（媒体路由字节流 + 显式 Blob，浏览器原生查看器内嵌，附下载入口）dsh-resource://file/**，并接管内置「文件」页 / 文件树），插件自己只保留底部工作台（分栏 / 终端 / 随会话持久化），开合按钮挂在会话头右侧🔌 核心理念：服务优先——内置的 8 tab + 6 viewer 与第三方插件通过同一套
ctx.betterSidebarAPI 注册，能力完全对等；官方不再内置、可由生态提供的功能，交由生态插件实现（已有 28+ 生态插件，见下方「🌐 插件生态」）。接入文档见「🔌 服务化扩展」与 外部插件接入指南。
前置：已装好 DSH（dsh web 能正常运行），Node.js ≥ 20、pnpm ≥ 10。
📌 正式版：
v0.19.0起适配 DSH 0.1.5-rc.1+（npm dist-taglatest；v0.19.1已在 0.1.5-rc.2 上完成真机挂载验证，rc.1 用户无需升级即可用本版——peer 下限仍是^0.1.5-rc.1）。仍停在 DSH 0.1.5-alpha.2 的用户请固定安装dsh-better-sidebar@0.19.0-alpha.1；0.1.2-rc.1 稳定线用户继续用dsh-better-sidebar@0.18.x；DSH ≤ 0.1.1-rc.2 请用dsh-better-sidebar@0.17.1。
dsh plugin --profile web add dsh-better-sidebar@latest # 首次会因 pnpm 11 拦截 node-pty 构建脚本而失败（依赖已写入）
cd ~/.dsh/profiles/web && pnpm approve-builds --all # 放行构建脚本（自动重跑安装）
dsh plugin --profile web add dsh-better-sidebar@latest # 重跑即成功
装完硬刷新浏览器（Cmd/Ctrl+Shift+R）即可看到侧边栏（DSH 对 client 改动热加载，无需重启；仅 host 半更新时需要重启）。
方式二：让 DSH 自己装——把下面这段提示词发给任意一个 DSH 会话：
帮我安装 dsh-better-sidebar 插件（DSH 侧边栏工作台），步骤：
1. 执行 dsh plugin --profile web add dsh-better-sidebar@latest（首次会被 pnpm 11 拦截 node-pty 构建脚本而失败，属正常）
2. 在 ~/.dsh/profiles/web 下执行 pnpm approve-builds --all（放行构建脚本，会自动重跑安装）
3. 再次执行 dsh plugin --profile web add dsh-better-sidebar@latest
4. 完成后提醒我硬刷新浏览器（Cmd/Ctrl+Shift+R）
遇到报错先查 https://github.com/omdsh-dev/DSH-better-sidebar README 的常见问题表。
方式三：一键脚本——克隆本仓库后执行 bash scripts/install.sh（macOS / Linux / Windows Git Bash；Windows 原生环境用 install.ps1；-h 查看参数），自动完成 add → 放行构建脚本 → 重跑安装。
dsh plugin --profile web add dsh-better-sidebar@latest
也可把 ~/.dsh/profiles/web/package.json 里的版本号改高后 pnpm install。改完硬刷新浏览器（Cmd/Ctrl+Shift+R）即可（client 改动无需重启 DSH）。
| 现象 | 原因与解决 |
|---|---|
报 Ignored build scripts | pnpm 11 拦截构建脚本。在 profile 目录（~/.dsh/profiles/web）跑 pnpm approve-builds --all。 |
报 minimum release age / 版本不足 24h | 装的版本发布不足 24 小时。等 24h 或重跑一次（pnpm 会自动补 minimumReleaseAgeExclude）。 |
| 报「找不到 profile 目录」 | 先跑一次 dsh web，让它初始化 ~/.dsh/profiles/web。 |
| 页面出现两个侧边栏 | 双挂载。旧的手动挂载行：~/.dsh/profiles/web/cordis.patch.yml 还留着 - insert: ... better-sidebar ...，删掉那段（同 id 重复挂载 loader 会直接报 duplicate loader entry id）。聚合包（如 @linxin666/dsh-web-ui-all）以不同 id 挂载本包时，0.13.x 起插件自身 bundle patch 会自动退让（检测到已有启用中的同包名挂载就不挂自己），无需手动处理；若仍双挂载，先确认聚合包的 bundle 顺序在 dsh-better-sidebar 之前。 |
| Windows 下终端无法使用 | node-pty 依赖预编译二进制；若当前 Node 版本没有对应产物，需装编译工具链（VS Build Tools）。主流 Node 版本一般已有预编译。 |
| 终端提示「node-pty 加载失败」 | node-pty 安装缺失/损坏（如 pnpm 拦截了构建脚本）。终端横幅会给出修复命令：复制到 DSH 所在环境的终端/cmd 执行（在 ~/.dsh/profiles/web 下 pnpm approve-builds --all && pnpm rebuild node-pty），完成后重启 DSH 并点重试。插件与 DSH 核心使用同一 node-pty@^1.1.0，修复后两者同步恢复。 |
提示 dsh: command not found | 先安装 DSH；或直接用 npx -y --package @deepseek-ai/dsh dsh plugin --profile web add dsh-better-sidebar@latest。 |
调试本地改动或跟随开发分支时，把依赖指向本地克隆并自行构建：
1. git clone https://github.com/omdsh-dev/DSH-better-sidebar.git ~/Code/DSH-better-sidebar
cd ~/Code/DSH-better-sidebar && pnpm install && pnpm build
2. ~/.dsh/profiles/web/package.json 的 dependencies 写 "dsh-better-sidebar": "link:<克隆目录绝对路径>"
3. ~/.dsh/profiles/web/cordis.patch.yml 追加挂载行（需要指定终端 shell 时，在行内加 `config.shell`；`config.shellArgs` 可带参启动，非空时替换默认的 `-l`。不填则自动解析 `$SHELL` / 登录 shell / powershell.exe）：
- insert:
- id: better-sidebar
name: 'dsh-better-sidebar'
config:
shell: /bin/zsh
shellArgs:
- --noprofile
- --no-rc
4. 在 ~/.dsh/profiles/web 执行 pnpm install
5. 硬刷新浏览器（Cmd/Ctrl+Shift+R）即可看到效果（client 改动无需重启 DSH；host 半改动才需重启）
更新：git pull && pnpm install && pnpm build → 硬刷新浏览器即可（client 改动热加载生效，无需重启 DSH；host 半改动才需重启）。切回 npm 通道时，把依赖改回 "dsh-better-sidebar": "^0.16.1" 再 pnpm install。
前置：DSH 已集成 plugin-registry（dsh registry 可用）。同时启用两个通道会双挂载（Node 半挂两次、页面两个侧边栏）。
git clone https://github.com/omdsh-dev/DSH-better-sidebar.git && cd DSH-better-sidebar
pnpm install && pnpm build
node scripts/package-registry.mjs # 组装 registry/ 暂存（含清单 + 产物 + README，不入库）
dsh registry install ./registry # 安装（默认禁用）
dsh registry enable dsh-external/dsh-better-sidebar
更新：git pull && pnpm install && pnpm build → node scripts/package-registry.mjs → dsh registry uninstall/install/enable。切换通道前先移除另一通道的挂载。
以下均为真实界面实拍（每行两张，点击可放大）。
| 🗂️ 文件工作台：资源管理器 支持两种格式的资源管理器：内嵌在文件预览中 / 独立显示文件树。懒加载目录树、软链接按目标类型展示（目录软链接可展开、失效链接标红）、全局文件名搜索、上传文件/文件夹与拖放上传、右键菜单（在新 Tab 打开 / 在侧边打开 / 复制路径）、悬浮 @文件 一键引用进输入框。 | 📝 Markdown · 图片 · PDF 内联预览 Markdown 预览支持 Mermaid 图表（ securityLevel: 'strict' 安全渲染 + 二次清洗；点击图表弹窗放大、滚轮缩放、拖拽平移）、README 级内嵌 HTML（徽章墙 <div align=center>、<details> 折叠块内嵌 markdown、表格单元格内联标签——DOMPurify 白名单消毒真实渲染，<script> 等活性内容剥除，本地图片经会话媒体路由重写）与浮动目录大纲（≥3 标题出现，点击平滑跳转、自动展开折叠块）；图片 / PDF 走媒体路由内联展示；Office 三件套由生态插件补齐。 |
| 🖥️ CodeMirror 代码编辑器 | 🖼️ 图片内联预览 |
| 💻 真实终端 xterm.js + node-pty 真实 shell（不是模拟器）：断线重连 transcript 回放、shell / shellArgs 可配置（设置页或 cordis.patch.yml）、可选为模型注入 terminal_* 工具（agent 可直接开终端跑命令）。 | 🌿 文件变动：Git 视角 + 本轮文件 双视角合一：Git 视角保留完整源代码管理（暂存 / 取消暂存 / 提交（ Ctrl+Enter）/ 还原、历史、worktree 与子仓库选择）；本轮文件视角实时折叠会话事件日志，记录模型读 / 写 / 编辑的每个文件（按文件分组、按类型筛选、操作数角标）。点击任意改动在底部可拖拽预览面板查看统一 diff——删红 / 增绿 / 改蓝配对 + 行内字符级高亮 + 语法着色 + 上下文折叠——也可一键展开为 VSCode 式独立 diff tab（同一渲染栈）。 |
ctx.betterSidebar 服务向所有插件开放两个扩展点：registerTab（注册侧边栏页面） 与 registerFileViewer（注册文件预览器）。内置的 8 tab + 6 viewer 与第三方插件走同一套 API，能力完全对等。
import type {} from 'dsh-better-sidebar' // 触发 ctx.betterSidebar 类型合并
export const inject = ['betterSidebar']
export function apply(ctx: Context) {
ctx.effect(() => ctx.betterSidebar.registerTab({
id: 'my-plugin:db', title: 'Database', component: ({ scope }) => <DbView sessionId={scope.sessionId} />,
}))
ctx.effect(() => ctx.betterSidebar.registerFileViewer({
id: 'my-plugin:csv', exts: ['csv'], fetchStrategy: 'custom',
load: async (path, scope) => parseCsv(await fetchText(scope, path)),
component: ({ customData }) => <CsvGrid rows={customData} />,
}))
}
GitHub topic dsh-better-sidebar 下已有 28+ 生态插件（持续增长中）：
| 插件 | ⭐ | 简介 |
|---|---|---|
| ChenRuoT/dsh-sidebar-qa | 划选追问侧边页：类 Codex 侧边提问 / Claude Code /btw | |
| fuhefei/dsh-sentinel | 条件驱动唤醒系统：文件 / 命令 / HTTP / 进程 / Webhook 监视，到点唤醒 agent；dock + 侧栏分支 + 全局仪表盘 | |
| Fisfzy/ego-browser | Agent 浏览器：i18n 感知的本机浏览器 Tab（@dsh-external/ego-browser，装了 better-sidebar 自动注册侧边栏页，未装回退浮动浮窗观察） | |
| jiuge2467/dsh-studio | 全栈增强工作台：多源 MCP 可视化调试中枢、视觉思考引擎 | |
| Iwctwbh/dsh-flowglass | 流镜 Flowglass：会话流程图实时可视化（消息 / 工具组 / 子代理分支） | |
| FeatherHunter/dsh-mattpocock-skills-deck | mattpocock/skills 游戏化任务系统：地图拨迷雾、任务栏推进 | |
| GULI-lab/DSH-element-source | 点击页面任意 UI 元素直达 Vue / React / Svelte / Angular 源码并送入会话 | |
| Lzh3070/dsh-file-review-tab | 文件改动审查页：行级红绿 diff + 撤销 + chat 行深链 | |
| yq04/dsh-git-remotes | Git 远程页：分支 / 上游 / ahead-behind，fetch 可 prune、ff-only pull、确认后 push | |
| ztyhehe/dsh-better-sidebar-svn | SVN 源码管理页：status / diff / log / commit / update / revert / 冲突解决，与内置 Git 面板对称 | |
| Melody-max114/dsh-excel-panel |
| 插件 | ⭐ | 简介 |
|---|---|---|
| HuanLinOTO/dsh-plugin-better-sidebar-plugin-office | Office 三件套预览（.docx / .xlsx / .pptx），独立 bundle 瘦身主体（官方推荐目录收录） | |
| zemul/dsh-video-preview | 视频内联预览：.mp4 / .webm / .mov / .mkv / .avi，自带 /video 路由支持 HTTP Range 拖进度条 | |
| dong-victor/dsh-better-sidebar-jupyter | .ipynb 可运行 Notebook 视图：懒启动 Python kernel、流式输出、保存回写 |
| 插件 | ⭐ | 简介 |
|---|---|---|
| eg-bole/dsh-better-sidebar-icons | VSCode 风格文件 / 文件夹图标主题：文件树与编辑器 Tab 换上熟悉的开发环境图标（vscode-icons 移植，纯 DOM 覆盖零侵入，安装 / 卸载零残留） | |
| dong-victor/dsh-better-sidebar-terminal-plus | 终端增强：内嵌 Nerd Font 图标字体、修复 xterm 图标渲染、稳定终端 cwd | |
| Max-Null/dsh-sidebar-preview-select | 预览划选增强：侧边栏预览里划选文本 → 浮动「发送到会话」 | |
| Hoemr/dsh-quicklook | QuickLook 式空格预览：活动文件标签页按 Space 全尺寸查看图片 / PDF / 文本，Space 或 Esc 关闭 |
📣 上架你的插件：给仓库打上
dsh-better-sidebartopic 即出现在 topic 页；再向src/client/plugins-tabs.ts/src/client/plugins-viewers.ts提一条PluginEntryPR，即可进入设置页内置推荐目录（数据完整性由tests/plugin-list.spec.ts守护）。
支持的 DSH 版本： · 完整发布历史见 Releases
📌 正式版（npm
latest，无 prerelease 后缀）：钉版推进到 DSH 0.1.5-rc.2（npmnext），peer 下限仍是^0.1.5-rc.1——rc.2 的上游 delta 里没有任何触及本插件的面（零packages/api|host|session|agent变更，真实代码改动只有消息反馈弹窗、产物卡片 CSS 与CodeFileIcon的 SVG 数据拆分），因此 rc.1 用户无需升级 DSH 即可用本版。DSH 0.1.5-alpha.2 用户继续用 v0.19.0-alpha.1；0.1.2-rc.1 稳定线继续用 v0.18.1。
SIDEBAR_SERVICE_VERSION 同步到 rc.2；插件侧零代码改动（上游 delta 未触及本插件，逐文件核对见 docs/plans/2026-09-10-dsh-0.1.5-rc.2-adaptation.md——300 个变更文件里绝大多数只是各包 package.json 的版本号单行）。ui-primitives 的 FileTypeIcon（48 类官方全彩代码/配置图形 + markdown/图片/PDF/Office/视频/文件夹的类目色板），插件不再自带扩展名表，也不再需要图标懒加载 chunk——#429 那份 563 条彩色数据与 lib/client-file-icons.js（255 kB）连同 fileIconTheme 设置开关一并删除，彩色就是唯一形态（核心 bundle 因此只增 10 kB）。registerFileIcon API（能力 'fileIcons'）：按扩展名（exts）、精确文件名（names）、目录名（folderNames）注册自己的图标，优先级降序、同级按注册序；注意：宿主分类器覆盖任意路径，所以注册 exts: [] 的 catch-all 会接管所有未具体命中的行。--dsw-alias-* 令牌，皮肤照旧全覆盖）。sidebar.right.pane.tab.title 槽就是芯片内容——插件在该槽渲染「图标 + 标题」（编辑器 tab 带路径时显示该文件的图标），glyph 为 aria-hidden，芯片可访问名不变。ci-windows 在 2026-09-09/10 窗口内红了 8 次，其中 6 次是真起进程的用例撞上 vitest 默认 5000ms：tests/agent-pty.spec.ts（真起 PowerShell + ConPTY）与 tests/install-powershell.spec.ts（冷启 powershell.exe 实测 12.1s）现在各自声明 30s 预算，且 vitest.config.ts 的全局 testTimeout 从默认 5000ms 提到 15s（第一次真实 Windows 跑又在第三个文件上翻车：tests/git.spec.ts:85 耗时 9607ms——三个文件同一个根因，逐文件加超时是打地鼠）；waitForTranscript 的内层轮询预算从 5000ms 降到 15s，内层预算必须小于外层（原先是同一个 5000ms，结构性必然超时）。ci-windows 的 Test 改跑 pnpm test:windows（--maxWorkers=2），在 2 核 runner 上不再让真起进程的 spec 互相抢占。plugin-mount 的 npm install -g @deepseek-ai/dsh@<ver> 曾 4 次失败（2 次 ETARGET、2 次 JavaScript heap out of memory exit 134）：钉版自身的传递依赖是浮动 范围，上游预发布版时（rc.2 于 09-10 的 14:43–14:57 逐包上线）npm 会组出 rc.1/rc.2 混合 peer 图（3062 条 ERESOLVE）。现在钉一个的 rc.2（修 ETARGET）并加 （修 OOM）。中途试过 ，被真实 CI 否掉：它跳过的正是全局安装必须提供的 peer， 在 boot 时 require 的 是 peer 而非 dependency，加了它 CLI 直接 。📌 正式版（npm
latest，无 prerelease 后缀）：本版仅支持 DSH 0.1.5-rc.1+（peer 下限^0.1.5-rc.1，CI 钉@deepseek-ai/dsh@0.1.5-rc.1）。DSH 0.1.5-alpha.2 用户请继续用 v0.19.0-alpha.1（npmalpha标签仍指向它）；0.1.2-rc.1 稳定线继续用 v0.18.1。
✨ 新功能
SidebarRightGuideEntry.description 回归（可选），插件随之恢复 TabDescriptor.description，六个内置类型各写回一条说明（原生指南的 文件 / 文件变动 / 任务管理 / 侧边对话 / 终端 / 浏览器 六行都带上它），guideDesc* 词条回到 20 份词典。宿主的原生指南只在列出的条目 ≤ 4 条时渲染说明（更长的列表是整列丢弃，不是截断），而插件默认贡献 6 个 guide 条目——因此默认组合下说明不渲染，只有在插件设置页关掉足够多的 tab 类型、把 guide 压到 ≤ 4 条时才会出现。未声明说明的条目仍是「图标 + 标题」单行（插件不补通用兜底句）。🐛 修复
files 类型改用自己的彩色文件夹图标作指南字形）外，没有需要插件适配的变更。🧰 CI 与内部
dsh.plugin.json 的 engines.dsh 同步（rc.1 在 npm 上同时是 latest 与 next）。main 槽 / sidebar.panellist / ctx.layout / 根级 rightbar + rightbar.session，插件仍不接入）、文件地址语法（packages/util/workspace-path 只动了版本号）、原生 tab 体宿主契约（.paneBody 仍是有确定高度的块级滚动容器）、core / agent / session / subagent 宿主 API 与 ui-primitives 导出面（仅 CodeBlock 渲染变化）。@deepseek-ai/dsh-client-ui-primitives@0.1.5-rc.1 仍不声明 dependencies 而 bundle 仍裸 import anser / shiki / @shikijs/langs/* / mdast-util-* / micromark-* / katex——上一版提升进 devDependencies 的那组包因此保留，不得回退。typecheck / lint / check:consumer-types 全绿，单测 124 files · 1296 passed · 9 skipped，pnpm peers check 干净；挂载冒烟对真实 rc.1 7 passed（含 tab 体填充断言，以及新增的「指南 ≤4 条时说明才渲染」断言）；本地 3080 实测：guide 六行仍是「图标 + 标题」（6 > 4，说明按上游规则不渲染；上游把胶囊 min-height 从 48px 调到 56px），文件树点击 AGENTS.md 落到插件编辑器（CodeMirror 就绪），sidechat 输入框贴底（宿主盒 962px == 面板体 962px，composer 底边距 8px），底部工作台与中心列左右边完全重合，pageerror 0（控制台仅有第三方 dsh-tauri-worktree 的 /api/dsh-worktree/attach 500，与本次改动无关）。🧪 alpha 通道（npm dist-tag
alpha，安装dsh-better-sidebar@alpha）：本版仅支持 DSH 0.1.5-alpha.2+（peer 下限^0.1.5-alpha.2，CI 钉@deepseek-ai/dsh@0.1.5-alpha.2）。0.1.5-alpha.1 请继续用 v0.19.0-alpha.0；0.1.2-rc.1 稳定线用 v0.18.1（npmlatest）。
✨ 新功能
flex: 1，在块容器里塌成内容高度——侧边对话的输入框因此贴不到面板底（转录一长就被推出可视区）。现在 native 适配层统一给每个 tab 体包一层 height: 100% 的列 flex 宿主，插件全部 tab（含第三方 registerTab 注册的 descriptor）恢复与底部工作台一致的填满语义。🐛 修复
fileAddressFor 一律产出 session 作用域地址、绝对路径保留前导 /；parseFileAddress 改为前缀解析并忽略 ?/# 后缀。conversation 槽改为根级 main keyed 槽下的 main.conversation，定位器改认新 key 并跳过 display: contents 槽宿主（alpha.1 的旧 key 仍兼容）。🧰 CI 与内部
dsh.plugin.json engines 同步；pnpm peers check 干净（按 §3-9 补提 dsh-session-persistence 传递 peer）。TabDescriptor.description：alpha.2 的原生指南条目不再渲染第二行（改为「图标+标题」胶囊），该字段与 6 个 guideDesc* 词条（20 份词典）一并下线；新建标签页的默认页改由注册表选（恰好 1 个指南条目则直接打开它）。🧪 alpha 通道（npm dist-tag
alpha，安装dsh-better-sidebar@alpha）：本版仅支持 DSH 0.1.5-alpha.1+（peer 下限^0.1.5-alpha.1，CI 钉@deepseek-ai/dsh@0.1.5-alpha.1）。0.1.2-rc.1 稳定线请继续用 v0.18.1（npmlatest）。
✨ 新功能
ctx.sidebarRight.openResource(dsh-resource://file/…)；editor 类型以 extension 优先级认领文件资源（压过内置文本预览）并接管内置「文件」页 kind（注销即复位）；跨会话打开在目标会话未上屏时排队重放。floats / floatTab / dockFloat / raiseFloat / 右键「移动到自由窗口」）、features 里的 'floatWindows'，以及 openByDefault / defaultWidthPercent / changesDiffFloat 三个设置项一并删除（旧持久化文档里的 floats 字段被忽略，不影响加载）。assistant/chunk 事件删除 → 实时增量改由 agent/assistant-stream 帧折叠（侧边对话转录的 live 字段）；sessionPersistence.inspect 删除 → 冷会话读取改走 open(id,'read')；会话头 version 用 SESSION_FORMAT_VERSION。🐛 修复
jobs.output 回放 / fork 继承等 8 处会话事件读取跟随 0.1.5 契约；自定义种子补齐 fork 标记对，避免继承父会话未领取的 inbox 输入。🧰 CI 与内部
.tsx → React、package.json → npm、node_modules 着色），数据在懒加载 chunk（lib/client-file-icons.js）里，只有选中时才下载，默认关闭时启动零开销。数据源自 #429（@fenter）。VscFile——markdown / 图片媒体 / PDF / JSON / 40+ 代码扩展 / 配置 / 数据库 / lock / 压缩包各有专属 glyph（VSCodicons 单色 currentColor，遵循皮肤契约），未知扩展回退通用图标。ctx.betterSidebar 新增 registerFileIcon（features 含 'fileIcons'）：按扩展名 / 精确文件名（names）/ 目录名（folderNames）注册自定义图标（彩色 ReactNode 亦可，颜色责任在注册方），exts: [] 为全局默认（只兜内置 glyph 没认领的扩展，不吞掉内置多样性），保留扩展名 'folder' / 'folder-open' 可换目录行图标；fileIcon / folderIcon 为权威解析器（完整回退链 + 逐工厂崩溃隔离），注册/注销即时生效。接入示例见外部插件指南 §7。📌 正式版（npm
latest）：DSH 基线不变（0.1.2-rc.1+，peer 下限^0.1.2-rc.1）——本版是 v0.18.0 之后的增量发布：变更面板预览能力增强、文件树可写，以及五项修复。
✨ 新功能
.md 阅读模式（含 mermaid 渲染）、.html 与 .pdf 内嵌渲染预览；diff 语法高亮扩展到 mjs/cjs/mts/cts、CSS/SCSS/Less、HTML/XML/SVG/Vue、GraphQL、JSONC/JSON5；新增密钥脱敏层（预览默认开启，面板头部可切换）🐛 修复
-U3 裁剪使 gap 段没有行文本）；现按需经 git.show 拉取两侧完整内容切片填充，带加载 / 失败降级三态与请求去重；顺带修复该路由的 rev:path 寻址（此前恒返空）🧰 CI 与内部
use-polling（#541）、删除 rc.7 宿主的 __DSH_MODULES__ 回退路径（#540）、One Dark/Light 语法色板单源化（#534）、重复实现收敛与死代码清理（#525）📌 正式版（npm
latest）：本版仅支持 DSH 0.1.2-rc.1+（peer 下限^0.1.2-rc.1）；不再支持 0.1.0-rc.8 ~ 0.1.1-rc.2——DSH stable 用户请固定安装dsh-better-sidebar@0.17.1，停留在 0.1.2-alpha.x 的宿主继续用dsh-better-sidebar@alpha（v0.18.0-alpha.0）。
✨ 新功能
workspaceFence 声明式设置键，工作区外路径 403 时错误面一键关闭并指引⚡ 性能
🐛 修复（节选）
🧰 CI 与内部
🌐 生态收录
🧪 alpha 通道：本版仅支持 DSH 0.1.2-alpha.x（peer 下限
^0.1.2-alpha.5，npm dist-tagalpha）。该版本号当时未单独发布，内容已并入 v0.18.0 正式版；v0.19.0-alpha.0 这个号后来被 0.1.5 适配线复用（见上）。
alpha dist-tag）：CI 挂载门禁钉版、dsh.plugin.json engines 下限与 @deepseek-ai/* peer / devDependencies 基线升至 0.1.2-alpha.5（真机挂载冒烟 14/14 验证）。dsh-client-locale 上游停在 0.1.2-alpha.3 未发新版，其 peer 下限 / devDep 保持并天然兼容 alpha.5 运行时（pnpm peers check 零失配，无需新增提升传递 peer）。代码适配了 alpha.4 的兼容性标记改动——Session.events 属性移除，迁移到按需读 API snapshotEvents()（sidechat 转录 live 读、fork 继承、jobs.output 回放、subagent 活跃度共 8 处），新建线程 meta 中宿主已删的 seedLength 一并移除；alpha.4 其余变化（双向 send_message、自定义模型发现复用 Profile 请求头、SessionSeq/SessionLogOffset 强类型）与 alpha.5（升级启动修复）经核实不触及本插件其余表面。🧪 alpha 通道：本版仅支持 DSH 0.1.2-alpha.x（peer 下限
^0.1.2-alpha.3，npm dist-tagalpha，安装dsh-better-sidebar@alpha）。该版本号未单独发布，内容已并入 v0.18.0 正式版。
alpha dist-tag）：CI 挂载门禁钉版、dsh.plugin.json engines 下限与 @deepseek-ai/* peer / devDependencies 基线升至 0.1.2-alpha.3（真机挂载冒烟 14/14 验证）。逐点核查了 alpha.2 → alpha.3 全部 117 个 commit：插件依赖的宿主契约（token 鉴权、斜杠 RPC、MarkdownText labels、sidechat.events 所依赖的事件流与持久化 API、SettingsNamespaceInput、SUBAGENT_DESCRIPTOR_VERSION（仍为 3）、dsh-client-store、profile 加载器、node-pty 钉版）均无变化，无需代码适配；alpha.3 的破坏性改动（BeginSubmissionInput.mode 必填、subagent 错误码改名 attachment-invalid、SQLite 持久化后端移除、投影 change feed 收紧为 identity-gated）经核实均不触及本插件。🧪 alpha 通道：本版仅支持 DSH 0.1.2-alpha.x（peer 下限
^0.1.2-alpha.2，npm dist-tagalpha，安装dsh-better-sidebar@alpha）；不再支持 0.1.0-rc.8 ~ 0.1.1-rc.2——stable DSH 用户请用 v0.17.1（npmlatest）。
推荐添加QQ群(577011007)
| 操作 | 按键 |
|---|---|
| 保存编辑 | Ctrl/Cmd + S |
| Git 提交 | Ctrl + Enter |
| 关闭 Tab | 鼠标中键 |
| Tab 右键菜单 | 关闭 / 关闭其他页签 / 关闭左侧页签 / 关闭右侧页签（当前标签组） |
| 拆分/合并分栏 | 拖 Tab 到分栏边缘 / 中间 |
| 引用文件到输入框 | 悬浮行尾 @文件 按钮 |
| 复制文件路径 | 右键行 → 复制相对/绝对地址 |
从 v0.4.0 起暴露 ctx.betterSidebar 服务，其他插件可注册侧边栏页面与文件预览器（内置 8 tab + 6 viewer 亦通过同一服务注册）。v0.12.1 补齐基座能力（完整类型导出、能力探测、状态订阅、tab 角标、生命周期回调、定向打开、插件自有设置等）。v0.19.0 起新增文件图标注册：registerFileIcon 按扩展名（或保留的 'folder' / 'folder-open' 目录扩展名、exts: [] 全局默认）替换文件树与文件 tab 的图标，彩色 ReactNode 亦可——内置消费、注册即生效，无需自己接线。
完整接入文档（全字段、匹配算法、HMR 陷阱、声明式设置、版本探测、原生栏承载面与皮肤契约）：docs/external-plugin-guide.md；仓库开发规则（硬约束 / CI / 发版）见 AGENTS.md。
设置页「侧边卡片」两个网格末尾的虚线卡片分别打开 Tab / 预览插件弹窗：声明扩展点、「在 GitHub 上浏览更多插件」按钮（GitHub topic dsh-better-sidebar）、推荐插件目录（名字 / 仓库 / 简介 / 安装脚本），每个条目「跳转」直达仓库、「复制」把安装命令写入剪贴板。
收录新插件：向 src/client/plugins-tabs.ts（Tab 注册）或 src/client/plugins-viewers.ts（文件预览注册）追加一条 PluginEntry，并把仓库打上 dsh-better-sidebar topic；数据完整性由 tests/plugin-list.spec.ts 守护。
pnpm install # @deepseek-ai/* devDependencies 已发布（基线 0.1.2-rc.1，next dist-tag），直接解析、无需令牌
pnpm typecheck # tsc --noEmit
pnpm lint # eslint .（flat config：js + typescript-eslint + react-hooks recommended）
pnpm build # → lib/index.js + lib/invariant.js + lib/client.js + lib/client-registry.js + lib/types
pnpm test # vitest（含 manifest 一致性守卫，需先 build）
pnpm watch # tsdown --watch
Make 薄封装（make help 查看全部目标；package.json 仍是唯一事实源）：
make check # 聚合校验门禁：typecheck → build → test → check:consumer-types（对齐 CI）
make mount # 真机挂载冒烟：build + pack → 安装 Chromium → pnpm test:mount
make clean # 清理 lib/、*.tgz、playwright-report/、test-results/
pnpm check:consumer-types：对外类型声明面守卫——以浏览器-only 消费者（无 @types/node、skipLibCheck: false）的视角对构建出的 lib/types 做类型检查，需先 pnpm build。
架构：单 npm 包、host/client 双半结构——host（src/index.ts）：/sidebar/api/* JSON API、/sidebar/file 媒体路由、/sidebar/html 预览路由、/sidebar/ws/terminal WebSocket（fs / git / pty / 预览，全部会话级 + 信任围栏）；client（src/client/index.tsx）：portal 侧边栏 + 各视图 + 拦截；状态按会话持久化 localStorage。插件按 DSH 官方规范组织（无 default 导出、双 client bundle），运行期不依赖 npm / checkout（@deepseek-ai/* 由 web profile 提供）。
/api 一致）；fs.write 原子写入；媒体/预览路由仅限会话 cwd 内文件；git 只调 CLI、绝不设置身份allow-same-origin/allow-top-navigation、no-referrer、权限策略全禁）；/sidebar/html 路由带 CSP sandbox + 大小/路径边界；地址栏拒绝 javascript:/data:/file: 与 localhost 等本机地址X-Frame-Options/frame-ancestors 拒绝嵌入的站点（如 arxiv.org）显示原因面板（含「在浏览器中打开」）；iframe 内部跳转不进后退栈Windows / Linux / macOS 三平台适配（macOS 日常验证；其余经单元测试覆盖）；node-pty 优先预编译二进制，失败需编译工具链（Windows VS Build Tools / Linux make+g+++python3 / macOS Xcode CLT）。
feat/* / fix/* 分支开发 → gh pr create；纯文档改动可直接推 maindsh-better-sidebar topic + 向 src/client/plugins-tabs.ts / plugins-viewers.ts 提 PRpnpm typecheck && pnpm build && pnpm test（或 make check 一键聚合；CI 另有 npm 打包 → 真实挂载 → 无头渲染门禁 pnpm test:mount，及聚合双挂载回归 pnpm test:mount:aggregate）AGENTS.md（含仓库硬约束与 CI 说明）感谢每一位贡献者：
贡献者dsh-plugin 下的公开仓库清单，每日同步 star、贡献者与增长数据@huanlin/dsh-plugin-better-locale| 🧩 任务页：子代理拓扑 + 后台任务 子代理树实时拓扑（运行状态、批量实时预览）+ 后台任务清单（退出码 / 实时输出 / 强制终止）；新子代理 / 新任务可自动激活任务页，宽屏同时展开侧边栏，窄屏不强制展开全屏抽屉（可关）。 |
| 💬 侧边对话(beta) Codex 风格侧边线程：每个对话一个独立 Tab；线程继承主会话完整上下文（含进行中回合，以 interrupted 诚实冻结）独立运行，不污染主会话；可持续追问、重启冷恢复；一键「保存为新会话」提升为顶层会话。 | 🖥️ DSH 原生右侧栏 + 插件底部工作台 右列是 DSH 自己的右侧栏：插件把每个 tab 类型注册成原生 tab（含接管内置「文件」页与文件预览），聊天里的文件点击直接落到原生栏；插件自有底部面板可与其同时展开，拖 Tab 到分栏边缘拆分、拖到中间合并，高度拖上缘调节；开合按钮在会话头右侧。 |
| ⚙️ 声明式设置 设置页「侧边卡片」分区：每个 tab / 预览器一张小卡片，独立开关（高亮启用态 + 品牌开关滑块）；二级设置经卡片底部「功能设置」条弹窗（开关 / 文本 / 数字 / 下拉）；插件自有设置持久化在 pluginSettings。 | 📱 移动端 窄屏（<768px）自动切换为全宽抽屉：底栏 tab 一次性并入右侧栏，触屏拖拽可调。 |
| Excel 编辑页：xlsx 预览 / 编辑、公式实时计算、合并单元格、保存回原文件 |
| v587d/dsh-anysearch-refs | AnySearch 搜索结果引用卡片：搜索词、来源摘要、关键词高亮 |
| mlosun/dsh-docs-panel | 全局文档面板：随身 Markdown 笔记，任何工作区随时可读 |
| lnyuqian/dsh-skill-sidebar | 技能面板：扫描本机技能目录，4-6 字功能短语 + 一键复制调用 + 置顶 |
| g-yixuan/dsh-sidenote | Codex 风格侧边对话 + 划选引用注释（轻量消费插件） |
| thirsty5034/dsh-ssh-tunnel | 多主机 SSH 隧道 + SSH 管理器页 |
| thirsty5034/dsh-git-forge | GitHub / Gitea 账号、项目授权与推送策略 |
| YesSanSan/dsh-conversation-outline | 对话大纲页：按轮次结构化展示、一键跳转、LLM 一句话标题 |
| Wulabalabo/dsh-sidebar-Explorer-Plus | 文件管理页：上传 / 移动 / 删除 / 重命名 / 新建文件夹（补全写操作） |
| yq04/dsh-turn-review | 本轮审查：逐回合审查 agent 改动 |
| Ghz114514/dsh-refpics | Pinterest 风格参考图搜索：瀑布流、侧栏画板、下载与 Eagle 收藏 |
| yzlin499/dsh-yzlin499-easy-plugins | 实用小工具集（毛坯房 DSH 友好） |
| dong-victor/dsh-better-sidebar-starter | 运行配置页：IDEA 式 Run/Debug 配置（npm / springboot / python / custom）——一键启动、历史保存、WebSocket 实时日志（ANSI 彩色）、多实例并行、进程树跨平台杀死 |
| baosfeng/my-dsh-plugins | 个人多插件合集（dsh-file-activity）：侧边栏文件活动页——记录文件读取 / 新增 / 修改历史与统计，按文件夹平铺，点击用原生预览打开 |
| Hoemr/dsh-better-overleaf | Overleaf 标签页：直连 CDP 浏览器登录（支持第三方 Chromium）、项目切换、工作区下 overleaf/ 目录本地 git 镜像与双向同步 |
^NODE_OPTIONS=--max-old-space-size=4096--legacy-peer-depsdsh-app-boot@deepseek-ai/cordis-plugin-groupERR_MODULE_NOT_FOUNDalpha@deepseek-ai/*dsh-settingssettingsNamespacedsh-subagentSUBAGENT_DESCRIPTOR_VERSIONSessionEvent.ignorableRemoteErrorctx.connection.api（错误被静默吞掉，tab 永远渲染空转录），现改由插件自有 sidechat.events 路由供给（活线程读内存事件日志、冷线程读会话持久化，afterSeq 增量拉取，sidechat-routes.ts）。MarkdownText labels 收敛为嵌套单形状（markdown-labels.tsx，不再双 prop 名）；peerDependencies / devDependencies / dsh.client.inject / chunk externals 白名单四处同步清除已消亡的 @deepseek-ai/dsh-client-runtime。MarkdownText labels 契约变更已全量适配，插件在 0.1.0-rc.8 ~ 0.1.1-rc.2 与 0.1.2-alpha.1 上一致工作（后者经 GitHub tag 源码构建的真机挂载冒烟 14/14 验证；alpha.1 至今未发布 npm，CI 钉版已在 v0.18.0-alpha.0 升至 npm 发布的 0.1.2-alpha.2）。要点：MarkdownText 四个渲染点统一改走双形状 labels helper（markdown-labels.tsx），修复 alpha.1 上 markdown/mermaid 预览的 reading 'code' 崩溃；e2e 冒烟双协议化（token URL 换 cookie、/api 斜杠端点 + 按参数名包装 args，tests/e2e/host-protocol.ts）；移除已在 0.1.2-alpha.1 消亡的 @deepseek-ai/dsh-client-runtime peer自 v0.16.0 以来的全部更改：
🐛 修复
git status --untracked-files=all 响应上限 2000 条（超限置 truncated，面板显示截断提示，对齐 fs.read 截断语义；worktree 变更计数同步有界），海量未跟踪文件不再冻结浏览器主线程；② 仓库发现限界——cwd 非 Git 仓库（如家目录）时不再对每个可见子目录串行无界探测：探测超时 30s→5s、子目录探测上限 200 个、并发请求共享同一次扫描并按 60s TTL 缓存，家目录不再引发 git rev-parse 进程风暴；③ 重置逃生通道——带 ?dsh-sidebar-reset 打开页面即丢弃持久化布局（含共享宽度）从默认布局启动，即使原页面已卡死也能自救，移除参数后恢复持久化；statusTruncated 文案同步全部 19 个词典自 v0.15.2 以来的全部更改：
✨ 新功能
closeTab 正常关闭生命周期（释放终端等）；拖到侧边栏 pane 上时该 pane 高亮、松开即停靠合并回该 pane；floats 随会话持久化（刷新原样恢复，宽容 sanitize + 几何钳入视口）；服务语义：features 新增 'floatWindows'——openTab 的 dedupe/id 聚焦命中浮动 tab = 置顶窗口（不重复开、不展开面板），closeTab / activateTab 对浮窗正常关窗 / 置顶并照常触发回调，浮窗内 tab visible 恒 true，agent 终端 reconcile 覆盖浮窗；tab 内容复用常规渲染、插件 tab 与 pane 完全同契约；附带文件二级页面 8px 网格间距规整（设计文档）sidebar_open 工具）（#353）：侧边栏新增全局设置 agentOpenTools（默认关闭），开启后向模型注入一个工具——模型可在调用方会话的侧边栏打开本地文件（editor tab，按 path 去重）、文件夹（全窗树窗口，以该目录为根，meta.dir）与 HTTP(S) 网页（browser tab，URL 预填）；关闭设置即注销工具并清空未投递队列，已打开 tab 保留；非激活会话的打开排队、下次可见时重放（/sidebar/ws/agent-opens 推送，同一 trust fence）；无新增公共 API、不改变 BetterSidebarService（设计文档）<div align=center>、<details> 折叠块内嵌 markdown、表格单元格 <br/>/<sub>/<img>、<video>/<picture> 全部经 DOMPurify 白名单消毒（<script> 等活性内容剥除、<a> 强制 _blank rel=noopener），本地媒体 src 重写为会话媒体路由；≥3 标题出现浮动目录大纲按钮，点击平滑滚动并自动展开折叠 <details>，HTML 段内标题同样收录；渲染器仍是宿主 MarkdownText（shiki / KaTeX / GFM 保留），纯 markdown（零 HTML）文档走原路径零回归（设计文档）@huanlin/dsh-plugin-better-locale——ja / de / fr / pt / ko / ar / hi / id / tr / vi / th / ru / it / nl / sv / pl / zh-HK / zh-TW / zh-MO 全量词典（每种约 340 keys）；覆盖借用 DSH 英文槽位（DSH active=en 时生效，zh 下完全惰性、界面不混语言）；19 语言词典同时注册进 better-locale，外部 ctx.locale.lookup('betterSidebar', key) 调用者同样可拿覆盖文本；未安装时 ctx.get('betterLocale') 为 undefined、整段 no-op，zh/en 行为不变browserAllowedLoopback（逗号分隔 host 或 host:port；裸 host 匹配任意端口、带有端口精确匹配）——显式信任的本地开发服务器（如 Vite）可导航，并额外获得 iframe allow-same-origin 令牌（模块 / HMR / fetch 管线需要真实 origin，否则白屏）；页面相对 GUI 与其他站点仍是跨源；服务端 browser.probe 镜像同一允许清单，本地服务器不再被误拒.vue 映射 @codemirror/lang-vue（template / script / style 按 lang 属性分派、<style lang="scss"> 预处理器）；零新依赖用 legacy-modes 补齐 scss/sass/less/stylus/ruby/lua/perl/r/dart/scala/groovy/powershell/diff/protobuf/cmake/pug/tcl/haskell/clojure/erlang/julia/pascal/vb/vhdl/stex/objectivecpp；语言工厂抛错降级纯文本（console.warn），不再炸编辑器；.v / .m 跨语言歧义故意不映射fs.stat 版本端点（后台 API 零流量）、/cwd/img.png 与引用式 [id]: url 目标重写为 /sidebar/file 媒体 URL（会话 cwd 边界不变）——预览不再只显示 alt 文本@dsh-external/ego-browser Agent 浏览器 Tab（会话侧边栏自动注册本机浏览器页，无 better-sidebar 时回退浮动浮窗）；描述词典 19 语言补全（#371）🐛 修复
peerDependencies 里的公开版 cordis（市场预览硬拒依赖字段出现 cordis，optional 无效）——npm 包满足 dsh-community-market 安装规范，dshfind / 1024Store 目录里的条目重新获得 repository_backlink 验证目标，可直接从 Desktop 市场受管安装@deepseek-ai/cordis（#338）：Context = 真实 vendored cordis Context 与结构化服务面的交集，ctx.betterSidebar 类型合并改挂 @deepseek-ai/cordis，公开版 cordis 不再被依赖。消费者迁移：import type { Context } from 'cordis' 改为 import type { Context } from '@deepseek-ai/cordis'（import type {} from 'dsh-better-sidebar' 的类型合并方式不变）；未使用该导入的插件无影响ctx.betterSidebar 读取全面修复（#357，修复 #356）：npm 安装的 DSH 0.1.1-rc.x（web bundle）下侧边栏页面每次加载即崩（cannot get property "betterSidebar" without inject）——26 处内部直读 ctx.betterSidebar 改走 ctx.get('betterSidebar')（root reflect store 解析，不受 fiber 链影响）；外部消费者 inject: ['betterSidebar'] + ctx.betterSidebar 契约不变fs.tree / fs.read / fs.write 的 workspace 越界访问修复；媒体、HTML 预览与上传统一 real-path 符号链接校验；新增绝对路径 / 符号链接 / 上传 / 嵌套 Git 会话回归测试overflow: hidden 裁剪视口边缘，收起的面板不再把文档撑出双向滚动（实测 scrollWidth 2289→1672 / scrollHeight 1280→1032，任意皮肤）min-height: 0 + overflow: hidden + overflow-wrap: anywhere（长不可断 URL / OAuth 链接不再把 composer 与左侧设置按钮挤出视口）；layout-push effect 拆「仅设置 + 仅卸载移除」并按 panelOpen 门控宽度 push——右栏关闭时拖底部高度不再挤压对话区、松手瞬间不再整页右铺再回弹；useLayoutEffect 消除跨 paint 全宽闪帧；松手 flush 最终帧 + centerRect.right 同步提交；底部高度按 viewportHeight - PANEL_MIN 封顶；拖拽手柄拖动中不再高亮aria-disabled 保持不可执行语义、同时允许触摸 / 键盘聚焦显示「选择一个会话以使用侧边栏」提示；panel 改 border-box——移动端 100vw 含左边框，不再产生 1px 横向溢出dsh-sidebar:v1:width，缓存会话切换与新建会话即时跟随；无全局键（首次运行 / 旧会话）时行为逐字节不变PtyManager.closeSession() + 订阅 DSH session/disposed——删除会话不再等 30s 重连宽限到期（agent 终端由 agent 生命周期管理，不受影响）node_modules / .pnpm-store / .yarn / .turbo / .next / dist / build / coverage 等黑名单（小写不敏感，.git 仍跳）——超大依赖树不再耗尽 10 万访问预算提前 truncated，docs/ 等后序目录里的真实文件能搜到；不引入 .gitignore 语义，保持「文件名查找」suppressErrorRendering——非法图表不再把大错误 SVG 注入 document.body；组件级错误回退与源码展示保留withIconFontFallbacks() 为胜出的基础字体追加 Nerd Font 图标族（插入首个通用族之前、按族名去重、过滤 CSS 全局关键字、不列彩色 emoji 字体）/sidebar/html 响应带 charset=utf-8（无 <meta charset> 的中文片段不再乱码），保留原始文件字节http://127.0.0.1 对 Host: 127.0.0.1:3080 不再 403（对齐 DSH 官方网关栅栏）；不同 hostname / opaque null origin 仍拒绝"..." is a directory）——revealInExplorer 切到资源管理器 tab、面板折叠时自动展开、展开父目录并高亮滚动到本轮产出文件；产物行数据改读引擎 Turn deliverable（与 ui-deliverables 同源）-Version / -DryRun 参数在 Windows PowerShell 5.1 下恢复生效（BOM 解析不再吃掉首行 param(...)）；安装前校验 pnpm --version（主版本 <10 时明确报错并以退出码 1 结束，不再写一半 profile）unrun devDependency（#336）：tsdown 0.22 经 unrun 加载配置而 pnpm 11 不自动装 peer——git-hosted 安装的 prepare 不再报 Failed to import module "unrun"（npm tarball 不受影响）ctx.effect 严格化顺手修了 4 处：拦截注册失败时 effect 体返回 undefined 改为 no-op disposer（vendored cordis 的 effect 契约要求返回 disposer，返回 undefined 属非法形状）自 v0.15.1 以来的全部更改：
✨ 新功能
vscode-remote/ssh-remote+<host>/<path> 协议打开，本地专用条目自动隐藏；支持自定义编辑器（名称 + URL 模板 {path} + 是否 VSCode 系，配置入口在 Files 卡片齿轮弹窗）。打开动作经新宿主路由 POST /sidebar/api/open.external（argv 数组 spawn，无 shell 注入）（设计文档）onClose 路径，生命周期完整🐛 修复
sanitizeState 现在同时修剪空的 split leaf，并修复修剪后的失效激活 pane 指针；整个工作台为空时保留唯一空 panerunGit() 统一加 windowsHide: true，仓库状态轮询与操作不再闪现控制台窗口（其他平台行为不变）git status 从 --untracked-files=normal 切换为 --untracked-files=all——新文件夹内每个文件独立成行、可正常加载差异（修正 fs.read 报 "is a directory"，与 VSCode 默认行为一致）自 v0.15.0 以来的全部更改：
✨ 新功能
prefers-reduced-motion 停帧；首条问题不再被边界提示吞掉——上下文注入与首问拆分交付（边界 + 快照经 agent.inject 排队、问题唤醒驱动），转录把注入映射为可折叠注入行、真实用户消息（含首问）渲染为用户气泡，旧线程的首问同样拆分为独立气泡add → approve-builds → add、node-pty 安全构建、粘贴到 DSH 安装提示）、插件生态 28+ 与分类折叠展示🐛 修复
park 控制帧，主机跳过 30s 重连宽限倒计时；切回会话（open() 取消 parked）或显式关闭恢复正常生命周期；agent 终端保持无限期存活dataTransfer.types 含 Files 门控（与面板宿主 shield 一致），Tab 正常落下；OS 文件拖拽行为不变自 v0.14.0 以来的全部更改：
✨ 新功能
no-drag）；底栏推挤锚点复合选择器双保险（[data-pane] 与 :has(> [data-slot])）--dsw-alias-* 令牌派生，皮肤体系自动跟随dsh-docs-panel 全局文档面板（#230）、dsh-flowglass（#261）、dsh-git-forge 与 dsh-ssh-tunnel（#204）、dsh-turn-review（#102）🐛 修复
subagents.history，host 侧每次触发全量子代理枚举形成 O(N²) 放大、多子代理并发时页面卡顿——改为单个批量接口 subagents.live（一次枚举整棵子代理树）+ 客户端单轮询、单在途请求；展示逻辑与文案不变relativePath 空段 / 绝对路径显式拒绝；临时文件唯一命名（并发上传互不干扰、崩溃不阻塞）；写流错误监听（磁盘失败不崩溃进程）；客户端错误码与服务端统一、413 本地化fs.tree/read/write、媒体、HTML 预览和上传统一按真实路径限制在会话 workspace 内，拒绝越界绝对路径与外链符号链接⚠️ 本版起需要 DSH ≥ 0.1.0-rc.8。自 v0.13.1 以来的全部更改：
✨ 新功能
[data-dsh-panel-host] 固定含块层（fixed inset-0 z-40），免疫桌面套壳中间层 transform 对 fixed 含块的劫持；挂载自检（页面级 transform → data-dsh-panel-host-degraded 降级同步，按未修正几何判定、祖先变换消失才退出）；推挤锚点改 #root [data-dsh-frame] > [data-pane="conversation"] + #root calc 宽度防桌面壳加性溢出；chunk 激活重验证（HEAD+ETag 保留未变 chunk，5s 超时兜底 fail-open）；visualViewport 键盘 inset + env(safe-area-inset-*) 移动端适配editorExplorer 默认从「合并」改为「独立」——新会话树点击 / 打开文件按路径新开文件 tab，无路径窗口即纯资源管理器；合并模式保留为可选手动开启cordis.patch.yml 配置）——设置页写入后对之后打开的 UI 终端与模型终端（terminal_create）即时生效；留空保持 yaml → $SHELL / 登录 shell / powershell.exe 的既有解析顺序DSH-better-sidebar v0.14.0 身份徽标（版本与服务实例同步，由测试守护）category 分组渲染，列表独立滚动（弹窗不再随条目数无限增长）🐛 修复
window.__DSH_MODULES__ 页面全局（改由 ctx.modules 服务提供），懒加载 chunk 的外部依赖解析全面失效——client 注入 modules 服务 + 插件自有全局共享给 chunk 副本（终端 / 编辑器 / Mermaid 恢复正常按需加载）resetChunks 清挂起的重验证屏障pointercancel / 捕获丢失中断同样保留拖动结果；提交后立即重测中心列（消除底栏宽度中间帧抖动）；HMR 重激活后中心列重定位兜底（<html> 样式观察 + 底栏打开重测），修复热更新后底栏空白 / 输入框位移✨ 新功能
client-mermaid.js chunk（~7MB，无 mermaid 文件零加载）；纵深防御渲染——securityLevel: 'strict' + htmlLabels: false（节点文字走真实 SVG <text>）+ SVG 注入前二次清洗（删 foreignObject/script/外来 HTML 元素、剥 @*/on*/href 属性）；点击图表在弹窗中放大（滚轮以鼠标为中心缩放、拖拽平移、工具栏与快捷键），深浅色跟随重渲、解析失败回退原码cordis.patch.yml 的 better-sidebar.config 可指定 shell / shellArgs（shellArgs 非空时完全替换默认参数；未配置维持自动解析 $SHELL / 登录 shell / powershell.exe 原行为），UI 终端与 agent 终端（terminal_create）同时生效；终端 tab 标题改用 shell 名（bash / zsh / powershell），内部标识改 UUID，同 shell 可开多个终端🐛 修复
cordis.patch.yml 的守卫表达式自动禁用自身 better-sidebar 行，不再重复注册 /sidebar/api 导致 duplicate prefix route 整个插件树启动失败（dsh web 崩溃）；独立安装行为不变agent-presets: refusing to compose an unscoped context 的问题✨ 新功能
editorExplorer 设置（编辑器卡齿轮）——文件 tab 增加路径输入框头部 + 可开关的右侧停靠文件树（每 tab 记忆展开/宽度，左缘拖拽调宽 160~480px，全局文件名搜索走 host fs.search 路由，预算封顶并跳过 .git / 符号链接目录）；独立模式（默认）树点击 / 输入框 Enter 按路径新开文件 tab，合并模式原地切换当前 tab；新会话默认 seed 空文件窗口（Files）替代 explorer tab，无路径窗口在独立模式为纯资源管理器、合并模式为带 chrome 的空文件窗口；树右键提供「在新 Tab 中打开」「在侧边打开」（split）type: 'select'（options 支持 value/title/desc/icon，multi 多选存数组）；带图标的选项渲染大图标选项卡、收起态同样显示图标；editorExplorer 改为图标化下拉（合并 / 独立）；能力清单新增 settingSelectaionui-panel 设置命名空间的提供方选择——当选择「使用 aionui-panel」时，整个 better-sidebar（右侧栏 / 底部面板 / 浮动入口 / 各类接管）不再挂载；选择 DSH-better-sidebar（或未安装 aionui）时正常。设置页保存后实时生效（settings-document 推送），无需刷新✨ 新功能
dsh-git-remotes——Git 远程 Tab（分支/上游/ahead-behind、fetch 可 prune、ff-only pull、确认后才 push，不替换内置暂存/提交）（#91）；dsh-video-preview——视频内联预览（.mp4/.webm/.mov/.mkv/.avi 等，自带 /video 宿主路由支持 HTTP Range 206 拖进度条，不受 20MB mediaLimit 限制）（#126）🐛 修复
@xterm/xterm（Closes #122，#128）.md 时把指向本地文件的图片目标（相对/绝对路径、引用式 [id]: url）重写为 /sidebar/file 媒体 URL 并显示（此前仅绝对 http(s) 图片能渲染，相对路径只显示 alt 文本）