DSH 启动提示 /pet 重复注册怎么办
日志出现 duplicate prefix route "/pet" 时,先恢复宿主启动,再定位冲突插件组合。
你会看到什么
DSH Desktop 的启动修复页面指出插件使用重复服务入口,错误包含:
webserver: duplicate prefix route "/pet"#16 标题称与 dsh-web-ui 冲突,正文确认了重复路由和 dsh-pet 加载失败,但没有插件版本、完整插件列表或单独启用对照,因此不能认定任意安装这两个插件都会出错。
解决步骤
- 使用启动修复入口暂时停用 dsh-pet。
若桌面版已经列出导致启动失败的插件,按界面提供的停用或恢复操作继续启动。先保住可用的 DSH 会话,不要删除工作区或整个配置目录。
- 恢复后记录插件组合。
在插件管理中记下 dsh-pet、dsh-web-ui 和宿主版本。若管理界面允许停用插件,保存工作后仅保留其中一个启用,正常重启,比较原错误是否消失;不要同时改变多个插件版本。
- 暂时保留能启动的组合。
需要桌宠时可在可恢复的前提下单独测试;如果仍冲突,保持它停用并提交日志。不要编辑插件源码随意改路由,其他页面可能仍指向旧地址。
怎么确认有效
重启能进入 DSH,启动日志不再报 duplicate prefix route,原会话和模型操作可用。只在某组合启用时复现,才有更充分的冲突证据。
如果还不行
没有恢复入口时向桌面端官方提供启动日志,勿手动删除 profile。其他启动错误见更新与启动故障,包识别错误见安装失败;宿主已正常启动而桌宠不可见,转显示排查。
来源与适用范围
原始报告:#16。本文依据已保存的 issue 正文整理,并对照官方 INSTALL 与 CONFIG 文档;未核查后续评论、当前源码与发布记录;报告中的分析和版本仅用于定位,不能据此认定当前版本仍有同样问题或已有修复。
官方参考:安装说明、配置说明(2026-11-03 查阅的上游快照)。配置和运行时目录应以该实例实际使用的 DSH_HOME 为准,~/.dsh 只是默认路径示例。官方安装文档要求安装后重开 DSH;网页实例则重启 dsh web。
资料来源(历史报告):#16。整理日期:2026-11-03,适用版本及证据限制见正文。