# 故障排查

## 安装后皮肤不生效

1. 确认已装入 profile：`dsh plugin --profile web add <本仓库路径>`，然后重启 dsh web。
2. 确认启用：`dsh-skin use matrix`（注册表条目随本仓库发布；若使用上游 dsh-skin，
   需先在 `scripts/dsh-skin` 的 SKINS 注册 matrix 条目）。
3. 硬刷新页面（Cmd+Shift+R）。

## 皮肤中心试穿互操作

本皮肤已适配 skin-center 试穿：
- 试穿其他皮肤时，数字雨 canvas 被隐藏（`[data-plugin='dsh-matrix-skin']` 中和规则）；
- 强制暗色 MutationObserver 仅在本皮肤标记 `data-dsh-matrix` 存在时生效 ——
  试穿收回标记即惰性化，退出后自动恢复。

若升级 DSH 后发现试穿异常，先确认 skin-center 的 NEUTRALIZE_CSS 仍含 matrix 规则。

## 想要更宽的聊天区（非官方行为）

DSH 默认把聊天内容区限制在 `--dsh-chat-content-width: 748px`。本机实测可覆盖：

```css
body[data-dsh-matrix] .wSkVaW_root{--dsh-chat-content-width:1080px}
```

把该规则追加进 `lib/client.js` 内嵌 CSS 字符串的末尾即可（`.wSkVaW_root` 是
DSH 构建的哈希类名，大版本更新后可能变化，届时重新抓取）。

## 数字雨不显示

- 系统开启了「减少动态效果」（prefers-reduced-motion）→ 本皮肤设计行为，雨层关闭；
- 浏览器不支持 canvas 2d → 自动降级（皮肤其余部分不受影响）。

## 构建产物与源码不一致

改 `src/` 后必须重建：`bash scripts/build.sh`（需先安装依赖）。
测试读的是构建产物 `lib/client.js`，漏重建会导致测试行为与源码不符。