跳到主内容

endfield-ui-plugin 使用指南

把终末地工业风视觉封装成 dsh 标准主题插件，免修改 dsh 核心即可替换 web 工作台外观。

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

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

快速上手

dsh-endfield-ui

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:rison114514/dsh-endfield-ui#path:endfield-ui-plugin

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

— 源: plugins.install

关键要点

  • endfield-ui-plugin/：双端 dsh 插件。核心交付物。Host 端提供素材，Client 端加载视觉外壳。
  • desktop-app/：Electron 桌面入口（可选）。自动启动本地 dsh、装载插件并打开窗口。
  • cover/：封面图素材。
  • dsh-packaged-final.jpg / dsh-settings-final.jpg：界面预览。
  • 阶段 1（标准插件）：dsh.bundle.patch 已声明，0.5.0 发布准备完成，冒烟测试 8/8 通过。✅

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后会自动生效吗？

会。插件声明了标准 dsh.bundle，启动 dsh web 时自动加载终末地风格，无需复制 CSS、修改 ~/.dsh 或追加 --patch。

卸载后用户数据会丢失吗？

不会。视觉层只注入样式与覆盖 slot，不会触碰 ~/.dsh 下的对话与配置数据；卸载后 dsh 原生前端完整恢复。

是否修改 dsh 核心源码？

不修改。Host 端只注册 /endfield-ui/* 静态资源路由，Client 端通过官方 Theme Token 覆盖与 shell.overlay 插槽注入，无需 patch 宿主。

dsh 大版本升级后主题异常怎么办？

主题通过 dsh DOM/CSS Module 特征选择器覆盖，大版本升级可能需要同步维护。建议先卸载插件确认原生页面正常，再向作者反馈。

桌面 App 是否可以公开分发？

不建议。当前桌面壳仅为 ad-hoc 签名，公开分发需要 Developer ID 签名与公证，否则会被系统拦截。

第三方字体与游戏素材是否合规？

第三方字体（Harmony、Novecento、Space Grotesk）保留各自许可证文件；图片素材含参考游戏视觉生成内容，公开发布前需逐项确认授权并替换不可再分发的素材。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 0.1.0-rc.6+（实测通过；package.json 未写宽泛兼容声明，大版本升级可能需同步维护）
  • Node: 未声明
  • Platforms: macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则

endfield-ui-plugin 使用指南