dsh-aionui-panel — DSH Web GUI 右侧面板系统

English | 中文

已停止支持：本面板不再维护、测试或纳入 CI 门禁，且已不可启用——提供方选择已移除，右侧面板固定为 dsh-better-sidebar；本包仅承载「侧边卡片」设置卡，后续版本将从全家桶聚合包移除。下文的面板功能说明仅作历史记录。

AionUi 右侧面板的像素级复刻（Apache-2.0 授权参考实现，非抄录）：Explorer 项目面板（文件树 / 文件名搜索 / Git 变更）+ Preview 预览面板（10+ 格式多 tab 预览）+ 统一拖拽布局系统，按项目隔离的偏好持久化。

安装

推荐直接安装全家桶聚合包 @linxin666/dsh-web-all（一个包装齐全部功能插件与皮肤），或单独安装本插件：

### 从 npm 安装（推荐）
dsh plugin --profile web add @linxin666/dsh-client-ui-aionui-panel@latest

### 从仓库安装（开发调试）
git clone https://github.com/zhu1090093659/dsh-web.git
cd dsh-web
pnpm install && pnpm -r build
dsh plugin --profile web add link:$(pwd)/packages/dsh-aionui-panel

安装后重启 dsh web，打开项目会话即可看到聊天区右侧的「预览」与「文件/变更」两块面板。

使用

项目会话（当前会话有工作目录）打开后，聊天区右侧出现两块面板：

• Explorer（最右栏，默认 260px，范围 220~500px）：文件 / 变更 双 tab；文件树整行点击展开/收起文件夹，点击文件在预览面板打开，顶部按文件名搜索（150ms 防抖，点击结果 = 定位到树中，不打断思路）；变更 tab 读取真实 git 状态，支持 stage / unstage / discard（untracked 走删除，tracked 走 restore，批量放弃有确认）。
• 文件树右键菜单：右键文件/文件夹弹出菜单——复制路径、复制名称、在文件管理器中显示、用默认应用打开（仅文件）、重命名、新建文件、新建文件夹、删除（二次确认）；全部走工作区门禁（loopback 围栏 + 拒绝 .git 路径），「在文件管理器中显示」Windows 用 explorer /select、macOS 用 open -R、Linux 桌面回退打开父目录。
• 拖拽文件到输入框：文件树中的文件行可拖拽（目录行除外），拖到聊天输入框区域松手即把相对路径（如 deploy/base/deployment.yaml）插入当前会话草稿的光标处，agent 收到消息后会自行读取该文件，无需手动输入路径；拖拽过程中输入框上方显示高亮提示条。
• Preview（右二栏，默认 480px，范围 340~1200px）：多 tab 预览，支持 markdown / html / code / diff / csv / pdf / word / excel / ppt / 图片 / 文本 / url（code 预览经由官方 shiki core 语法高亮）；源码/预览切换、分屏编辑（比例持久化）、保存（mtime 冲突检测）、下载、刷新（4 态：不渲染死按钮）、dirty 点、中键关闭、右键菜单批量关闭（dirty 确认）、tab 溢出渐变指示器。
• Mermaid 图表：markdown 预览中的 ```mermaid 代码块会渲染成图表。mermaid 运行时打包在包内，经 /aionui-panel/vendor/mermaid.js 同源提供（不走 CDN、离线可用、loopback 围栏）；图表跟随 shell 明暗主题并在切换时重渲染；图源语法错误时回退为原代码块。
• 侧边卡片设置（设置 → Web UI 插件 → 侧边卡片）：卡片声明右侧面板由侧边卡片提供、来自 ，并内嵌其常用设置（新会话默认打开、默认宽度占比、聊天区文件打开方式、位置兼容模式、侧边栏内容与文件预览开关），改动即时生效；设置一级菜单不再出现「侧边卡片」入口。更细分的设置（终端字体、沙箱开关等）可编辑 的 命名空间。以下历史记录描述已停用的 aionui 面板。选择 aionui-panel 时挂载两块面板、显示右侧浮动展开按钮、注册 路由（随之开始工作区文件监视与 git 轮询）；选择 DSH-better-sidebar 时本面板不挂载，上述路由与监视停止。该选择：better-sidebar 读取同一设置，选择「使用 aionui-panel」时其整体不挂载（需 dsh-better-sidebar >= 0.13.0）。aionui 面板，直到功能完全迁移到 dsh-better-sidebar——迁移完成前可切回但不建议。该选择在独立安装与 聚合包内行为一致。