跳到主内容

dsh-web-ui-all 使用指南

DSH Web UI 全家桶聚合包,一键安装 task-board、aionui-panel、git-graph、pet、live-stats、usage-dashboard、ssh、web-ui-settings 及全部皮肤,并内置 DOM 兼容垫片与 crypto.randomUUID 兜底。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-web-ui-all

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @captain1275/dsh-web-ui-all

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • 毛玻璃输入框:高斯模糊(backdrop-filter 30px)+ 半透明玻璃底 + 细边框 + 内高光
  • 自定义背景:URL / 本地图片 / 动图(GIF/WebP)/ 视频(mp4/webm) / 透明度 / 模糊调节,
  • 仿Claude Code推理等级滑块:点击模型菜单的「推理等级」弹出 Effort 滑块面板——无极拖动、松手吸附、
  • 用户消息气泡毛玻璃:与输入框统一的玻璃质感
  • 图片资源(社区同人资源,codex-pet-DeepSeek-girl)

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装完还需要做什么才能让插件生效?

重启 dsh web。如果是源码开发模式,还需在仓库内 pnpm install && pnpm -r build,再 node scripts/link-profile.mjs 把本地包链接进 profile,最后重启 dsh web 才生效(README.md:115-126)。

只想装其中一两个子插件怎么办?

直接装对应独立子包即可(如 dsh plugin --profile web add @captain1275/dsh-pet),不必走本聚合包;本包安装会激活全部子插件,无法只挑其中一部分(README.md:73-89)。

跟同名独立插件包同时安装会冲突吗?

会。聚合行 id 与独立子包 id 完全相同(如 task-board、pet、ssh、live-stats),cordis loader 会拒绝重复注册;切换前请先 dsh plugin remove 移除旧包,再装本聚合包(README.md:73-89、cordis.patch.yml:11-49)。

本包代码里到底装了什么自定义逻辑?

host 半区没有任何业务逻辑(src/index.ts:14 的 apply 是空函数);浏览器半区只有一个 compat shim(src/client/index.ts:17-83),给 dsh web 外壳侧栏/中间/详情三列容器补上老式 data-pane / data-dsh-frame 属性,让按老选择器挂载的子插件与皮肤继续工作;并对旧 WebView 缺失的 crypto.randomUUID 做了 UUID v4 polyfill。

官方 dsh web 外壳升级后,本包还能正常工作吗?

可以。compat shim 用 MutationObserver 监听整个 body 的 DOM 变化(src/client/index.ts:75-83),React 重渲染重建列容器后会自动补回属性,且只写入固定属性值、不删节点、不破坏 React 协调,可幂等重复触发。

修改了子插件的 cordis.patch.yml 怎么同步到本包?

不要直接改本包的 cordis.patch.yml(文件头明确标注 AUTO-GENERATED by scripts/aggregate.mjs)。改 aggregate.yml 的 patchFrom / deps 列表后执行 node scripts/aggregate.mjs,脚本会重新汇总子包 insert 行并写入本包 patch(cordis.patch.yml:1-3、scripts/aggregate.mjs:1-31)。

升级到新版本后新版没有生效,怎么排查?

改 profile 的 package.json 版本号后执行 pnpm install,顶层 node_modules/@captain1275/* 条目可能仍链接到旧版;需要确认这些链接已指向新版,再重启 dsh web(docs/plugins.md:39-58)。

部分皮肤不在设置页"Web UI 插件"组里怎么办?

皮肤中心(skin-center)卡片本身就是"Web UI 插件"组里的一张卡(packages/skins/skin-center/README.md:1-7);要在设置页里禁用皮肤走皮肤中心列表,不要去编辑 profile 的 cordis.patch.yml(aggregate.yml:6-7、README.md:77-83)。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 未声明(本包 package.json 未声明 engines;子包 peerDependencies 锁定 @deepseek-ai/dsh-* 为 ^0.1.0-rc.6,如 packages/dsh-pet/package.json:55-68、packages/dsh-task-board/package.json:37-43、packages/dsh-aionui-panel/package.json:33-43)
  • Node: 未声明(本包 package.json 未声明 engines;同仓子包 packages/dsh-pet/package.json:6-8、packages/dsh-git-graph/package.json:6-8、packages/dsh-ssh/package.json:6-8 均声明 ^22.19.0 || >=24.0.0)

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源:通用规则