---
name: pending-verify-issue
description: 把"已提交但尚未真机验证"的改动登记成 GitHub issue,避免未验收当已完成。当改动触碰 AGENTS.md 要求真机验收的运行时/UI 行为,但验证被阻塞(没拿到部署授权、或用户选择先提交后验证)时使用。
---

# 待验证登记(pending-verify issue)

`AGENTS.md` 要求运行时/UI 行为在真机 gamescope 会话验收。部署未获授权或用户明确要求
先提交时,不得把改动描述成已完成或已验证;创建 issue 记录剩余验收。真机操作见
**`decky-dev` skill**。

## 何时用

仅在以下两点同时成立时使用:

1. 改动影响 player 出声、UI 视觉/文案/布局/手柄焦点、异常纵深或日志内容。
2. 当前无法完成真机验收:未获重新部署授权,或用户要求先提交/推送。

纯文档、无运行时表现的内部重构、或已经完成真机验收时,不要创建。

## 怎么做

1. 确认代码已提交,取得 commit 短 hash。
2. 用下面模板创建 issue;清单只保留本次改动涉及的 `AGENTS.md` 验收项。
3. 回复 issue 链接,明确写“已提交,真机验证待做”,不要写成已验收。
4. 验证后勾完清单、附真机截图并关闭 issue。UI 视觉变更还要更新
   `docs/ui-design/assets/device-screenshots/`,并提示重新渲染展示图。

## 模板

```bash
gh issue create --title "待验证:<一句话说清验的是什么>(真机)" --body "$(cat <<'EOF'
关联提交:<shorthash> `<commit subject>`

## 背景
<改了什么、为什么、修复前后的行为差异。已过的检查(单测/tsc/lint)也写上,并点明"未在真机验证"。>

## 待验证(真机 / gamescope 会话)
<按需保留,删掉不相关项>
- [ ] 复现触发条件:<怎么制造这个场景>
- [ ] player 出声正常 / `ldd` 只动态依赖 libasound(涉及音频时)
- [ ] 目标 UI 出现预期表现(中/英各看一次)
- [ ] 注错误 / 杀后端 / 畸形数据 / 断网:Steam UI 不崩不冻,手柄焦点正常
- [ ] 日志符合预期,且不含任何敏感信息(URL/cookie/凭证)
- [ ] 恢复正常态后行为回归

## 复现办法
<制造该场景的具体步骤>

## 验收标准
上述全部勾选;UI 变更附真机截图。验证完关闭本 issue。
EOF
)"
```

## 红线

- issue body 同样遵守日志红线:**不写任何 URL(限时 token)/ cookie / 凭证**。
- 在验证真正做完前,别在提交信息、PR、回话里把改动写成"已验证/已验收"。
- issue 只是"欠条",不是替代验证。能当场验就当场验,别为了省事而开 issue 拖着。