# dsh-api-client 知识库 本项目踩坑与经验的沉淀。**接到任务先扫下方索引，命中主题必读再动手；收口时按标准蒸馏新主题**（规则见 AGENTS.md §七）。 - **收录标准**（三条同时满足）：可复用（后续还会遇到）、非显然（读代码/官方文档推不出）、已实证（本项目验证过，注明来源）； - **三路分流**：项目事实与规范 → PROJECT.md；一次性事件 → docs/DEVLOG.md；可复用经验与方法论 → 本库； - **格式**：一主题一文件（kebab-case 命名，不带日期/版本号，原地迭代），索引一行一条； - **毕业路径**：主题成熟且跨项目通用 → 提炼成独立 skill，本库文件改为指向 skill 的存根。 ## 索引 - [jsdom 焦点假绿](jsdom-focus-false-green.md) — focus() 可见性语义 + act() 时序反转两个机制让焦点类 jsdom 测试假绿；做任何菜单/对话框/drawer 焦点交互前必读。 - [ego-browser 真实浏览器验收方法论](ego-browser-acceptance-methodology.md) — 选择器限定容器、React 受控驱动、CDP 拖动/视口模拟、滚动竞态、剪贴板捕获法、暗色模拟；跑浏览器验收前必读。 - [冻结合同漂移](frozen-contract-drift.md) — 合同误读被测试固化 + 跨包备注丢限定词：门禁全绿也拦不住的两种缺陷模式；多包并行开发与 review 时必读。