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

快速上手

dsh-user-experience

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-user-experience

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

— 源: plugins.install

关键要点

• 每条结论标记为 static、rendered 或 interactive。浏览器能力是可选项：不可用时继续静态走查，不会假装看过页面
• 布局密度、视觉语言和主要操作层级问题至少需要 rendered 证据；流程冗余问题至少需要 interactive 任务记录
• 不自动改代码：插件先给优化建议；用户确认问题后，再生成一份现象导向的任务 Prompt 交给编码 AI
• CSS 只能提供检查线索；没有真实路由截图时，不会断言页面留白、层级或视觉质量存在问题
• 不设置 overrides、packageExtensions，不重写 profile 依赖

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后需要做什么初始化？

不需要任何初始化。直接用自然语言告诉 DSH “看看下单流程好不好用”之类即可；项目里没有用户画像时，会自动从 README 推断 1–3 个草稿作为走查依据。

应该用 npm 还是 github 方式安装？

用包名安装（不要加 github: 前缀）。仓库不再提交 lib/ 构建产物，Git 检出目录缺少预编译文件，pnpm 默认会拦截构建步骤导致 github: 安装失败。

改完前端代码后会自动跑走查吗？

默认会。改前端文件后回合收尾时会自动对所属完整组件/页面跑一次走查，并安静出报告；只有一级、二级问题才会提示一句。用户可通过 .ux/rules.local.yml 的 autoScan.enabled: false 关闭。

不支持哪些前端技术栈？

不支持 Svelte、Vue 2 和小程序。其余 Vue 2 项目也会在被检出时明确告知；当前仅支持 React（TypeScript / JavaScript）和 Vue 3。

走查结果为什么会”出现在技术细节里、不显示文件路径“？

报告卡片有两个读者：给人看的部分只说哪个页面、出了什么事、严不严重；给 AI 用的精确位置、规则 ID、验证路径折叠在「技术细节」里，展开后一键复制为结构化 YAML 喂给编码 AI。

如何卸载本插件？

在 profile 的 package.json 中删除对应依赖行，并清理 node_modules 与 pnpm-lock.yaml 后重新安装覆盖。重启或刷新页面即可。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.6 <0.2.0
• Node: 未声明

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则