dsh-user-experience

DeepSeek Harness（DSH）UX 走查插件：帮你发现项目中可能存在的用户体验问题——自动走查 React/TypeScript 源码，定位问题并给出具体优化建议。

v0.1 能力边界：仅 React + TypeScript 源码、仅静态证据、不覆盖视觉类问题。

现有自动化检查（axe、Lighthouse）只能校验绝对规则——对比度够不够、有没有 alt。但体验问题的本质是相对的：删除前的二次确认，对偶尔操作的用户是保护，对每天处理上百条记录的操作员是损耗。脱离了"给谁用"，"体验问题"无法定义。

本插件把目标用户画像（Persona）作为走查的前置输入：所有问题判定都挂靠到明确画像上，无 persona 不出结论。走查在开发阶段就产出可行动、可定位、可复核的体验提示，而不是等上线后的用户反馈。

---

能力边界（v0.1 明确不做）

• 仅支持 React + TypeScript 源码（检出其他技术栈时明确告知不支持）
• 证据等级固定为 static（静态源码证据）；不覆盖视觉类问题：对比度、热区尺寸、文字截断、焦点顺序
• 不自动修复 / 不自动改代码：只给优化方向（"提醒开发者去看一眼"，不是判决书）
• 输入源仅源码；网站输入（v0.2）、设计图输入（v0.3）为预留路线

功能

能力	入口	说明
Persona 初始化	/ux init	模型从 README / package.json / 路由结构生成 1-3 个画像草稿，经用户确认后写入 .ux/personas.yml；文件已存在时直接加载，不重复询问
Persona 上下文注入	自动	每次请求按当前项目注入生效画像与走查协议（对齐 AGENTS.md section provider 模式）
源码走查	/ux scan	先确定范围（架构说明优先，否则询问功能/流程），再逐 persona 独立走查、合并成一份报告；9 条高置信度规则，模型判断为主、AST 求证为辅
问题确认闭环	报告卡片	每条 finding 带 locator 与「成立 / 不成立」按钮；判定写入会话日志，重放完整恢复
报告输出	自动	Markdown 按 P0→P3 排序，共性问题（≥2 画像命中）在前；仅 confirmed 计入最终清单
术语表	自动	R-02 判定增量持久化到 .ux/glossary.yml，后续只做增量比对

9 条规则（v0.1）

ID	规则	验证路径
R-01	错误提示无行动指引	模型（AST 仅提取错误分支文案）
R-02	术语不一致（条件触发：仅当本轮无 P0/P1）	模型（AST 仅提取候选位置）
R-03	不可逆操作文案泛化	模型
R-04	不可逆操作缺二次确认	model+ast
R-05	有 loading 无 empty	model+ast
R-06	有 success 无 error	model+ast
R-07	提交中按钮未禁用	model+ast
R-08