跳到主内容

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

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则