dsh-aionui-panel 使用指南
在 DSH Web GUI 聊天区右侧加入可拖拽的文件树、多格式预览和 Git 变更面板,支持真实文件与本地编辑,SSH 模式下自动跟随远程。
本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。
本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。
快速上手
dsh-IDE
— 源: plugin_wiki.wiki_content
安装与验证
dsh plugin --profile web add --allow-build=@deepseek-ai/dsh-client-ui-aionui-panel github:chenw2759-wq/dsh-IDE#path:packages/dsh-aionui-panel
复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。
— 源: plugins.install
关键要点
- 🖥️ 右侧边栏:可停靠的右栏抽屉——文件树 + 预览/编辑同框;拖 tab 拖出成浮窗,拖回右缘自动停靠(下框 / 右栏 / 浮动 / 三栏 IDE 四态切换)
- 📄 预览:Markdown / HTML / 图片 / CSV / Office(docx / xlsx / pptx)/ 日志等多格式直接预览
- ✏️ 编辑:代码即时编辑(语法高亮 + 行号 + 斑马纹)+ Markdown/HTML Word 式可视化编辑 + Office 框内富文本编辑
- 🧩 IDE:文件树、命令行终端、Trae 风格红绿 diff、类型颜色标签、Git 角标、监视路径——开箱即用的 JupyterLab 式工作区
- 下框展示(⇊):预览显示在下栏
— 源: plugin_wiki.readme_zh (fallback readme_raw)
常见问题
安装后需要重启 DSH 吗?
需要。cordis.patch.yml 通过 dsh.bundle.patch 注入到 web profile,必须重启一次 dsh web 才会注册新的插件行(src/index.ts:34 / cordis.patch.yml:11-13);之后通过设置面板调整功能不需要再重启。
不装 dsh-easyssh 也能用吗?
能。本插件在不依赖 SSH 的情况下提供本地文件树、本地 git 操作和本地终端,所有 fs/git 接口默认走本地宿主文件系统(src/host/fs-service.ts:185-219 / src/host/routes.ts:198-260);SSH 切换是可选增强。
改了浏览器设置里的开关要刷新页面吗?
不需要。「右边栏工作区」设置通过共享设置 store 即时热应用(src/client/settings.ts:138-143),feature 代码每次操作都直接读 store,覆盖监视圆点、Git 角标、语法高亮等开关不会留陈旧状态。
文件保存会不会丢内容?
不会。text 写入走 /aionui-panel/write,docx/xlsx/pptx 走 /aionui-panel/write-binary,统一的 mtime 冲突基线:浏览器随写入提交上一次读到的 mtime,服务端比对最新 mtime 不一致就返回 write-conflict 拒绝覆盖(src/host/routes.ts:218-247 / src/host/fs-service.ts 中 baseMtime 处理)。
能预览哪些文件格式?
自动识别 markdown / html / code(含 70+ 后缀)/ diff / csv / pdf / word(docx/odt/rtf)/ excel(xlsx/ods)/ ppt(pptx/odp)/ image / text / url 共 13 类(src/client/fileType.ts:10-82);不支持的扩展名显示「此格式暂不支持预览」占位。
怎么卸载?
从 cordis.patch.yml 删除 ui-dsh-aionui-panel 行(cordis.patch.yml:12),重启 dsh web;浏览器侧的 aionui-workspace-settings 等 localStorage 可保留也可手动清除。
会和 dsh 自带的 fs-sandbox / subprocess 冲突吗?
不会。本插件只读 + ctx.webServer / ctx.systemPrompt 注入(src/index.ts:34),不会覆盖宿主的 fs/subprocess 服务。如果同时安装 dsh-easyssh,由它替换 fs-sandbox / subprocess,本插件自动通过 SSH 模式切换文件树来源。
docx 为什么有时候图表不显示?
已知限制。docx 解析只走段落/表格/段落底纹/页眉页脚/内联图片(src/client/preview/office.tsx:1-17 / README.md:36);word/charts 与嵌入对象暂不解析,CHANGELOG 也明确列为此项为已知限制,不会单独弹错。
— 源: plugin_wiki.faq_json
兼容性
- DSH: 0.1.0-rc.6+
- Node: >=22
— 源: plugin_wiki.compatibility_json
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则