deepseek harness DSH 安装皮肤脚手架(dsh‑client‑ui‑skin‑center)踩坑完整记录

前言

试用 DeepSeek‑Harness(DSH)想换一套界面,目标插件是皮肤中心脚手架 @linxin666/dsh-client-ui-skin-center。

仓库地址

dsh-web-ui

但是 webui这个项目整体的插件特别多,我本次只安装 linxin666/dsh-client-ui-skin-center

只想用皮肤,或者只装某一个插件?

A: 只要皮肤就装 @linxin666/dsh-client-ui-skin-center;只装某一个插件就用「单独安装某个插件」里的包名,两者都走 npm 安装。

本机环境:Windows,npm,DSH 最新版本。

效果图:

前置准备

先确认 pnpm 正常可用:

复制代码
pnpm -v

重要提醒:不要直接在 dsh plugin 命令后面追加数字类的 --config 参数 。dsh 会把参数原样透传给 pnpm,数字会被转成字符串,直接抛出 ERR_INVALID_ARG_TYPE 类型错误,这个坑卡了我挺久。

所有超时、镜像、新包校验的配置,统一写到 pnpm 全局配置里。

简单说下 profile 目录: C:\Users\luke\.dsh\profiles\web 这是web插件独立的pnpm工作目录,所有web端插件都装在这里。一旦安装中途下载失败中断,这个文件夹会变成半损坏状态,卸载命令也会失效,直接删文件夹重置比修配置快得多。

标准安装步骤(Windows可用流程)

  1. 如果你之前安装失败过,优先删除已经损坏的web profile,干净环境再开始安装

    Remove-Item -Recurse C:\Users\luke.dsh\profiles\web

  2. 设置pnpm全局配置,配置国内镜像、关闭新包年龄校验、拉长下载超时、增加重试

    pnpm config set registry https://registry.npmmirror.com
    pnpm config set fetch-timeout 600000
    pnpm config set fetch-retries 5
    pnpm config set minimumReleaseAge 0
    pnpm config set strict-ssl false

  3. 执行插件安装命令

    dsh plugin --profile web add @linxin666/dsh-client-ui-skin-center@latest

  4. 判断是否真正安装成功 很多人看到pnpm输出下载完成就以为好了,真正成功的标志是控制台输出 Plugin installed successfully。 只看到pnpm done,没有这句,代表dsh后续注册bundle步骤没有跑完,插件不会生效。

  5. 启动web服务

    dsh web

浏览器打开页面,务必按 Ctrl+F5 强制硬刷新清除缓存,进入设置页面,就可以看到皮肤中心的入口。

常见问题简记

  1. 下载中途报 error23 timeout,直接dsh: pnpm failed Windows pnpm11下载大体积tarball很容易被防火墙掐断连接。
  2. pnpm下载完成,但是界面看不到皮肤中心 两种可能:
  • dsh没有自动写入cordis.patch.yml注册bundle,需要手动补写bundles配置;
  • peer依赖缺失,依赖树不完整。优先尝试删除整个web目录重新走一遍完整流程,手动修补yaml很容易越修越乱。
相关推荐
传奇开心果编程11 小时前
【ArkUI进阶练中学】第11课:安全与合规进阶
学习·ui·华为·harmonyos
传奇开心果编程16 小时前
【ArkUI进阶练中学】第12课:应用架构演进与遗留系统迁移
学习·ui·华为·harmonyos
海盗123417 小时前
微软技术日报 2026-10-04:26H2 三个已知问题确认,Blazor 补上智能体 UI
人工智能·microsoft·ui·机器人·aigc
java1234_小锋18 小时前
shadcn/ui 开源项目,专业打造专业UI
ui·开源
传奇开心果编程18 小时前
【ArkUI进阶练中学】第13课:元服务与卡片开发
学习·ui·华为·harmonyos
传奇开心果编程19 小时前
【ArkUI进阶练中学】第19课:AI安全与隐私治理
学习·ui·华为·harmonyos
传奇开心果编程20 小时前
【ArkUI进阶练中学】第18课:Agent亲和架构与应用智能化改造
学习·ui·华为·harmonyos
墨心@20 小时前
AI Agent 学习总结
人工智能·自然语言处理·agent·harness·datawhale共学
XLYcmy1 天前
Dify 本地部署、Ollama 与 Xinference 集成:踩坑与最佳实践指南
llm·agent·dify·rag·ollama·rerank·harness
传奇开心果编程2 天前
【ArkUI进阶练中学】第9课:分布式能力与多设备协同
学习·ui·华为·harmonyos