dsh-adaptive-shell
A responsive + Miracle-visual layer for the DeepSeek Harness Web UI, shipped as one Cordis
client plugin: phone drawer with a permanent header toggle, full-bleed settings sheet, one
card scheme for the transcript, and motion built from named steps. Desktop gets its own
additions rather than being left alone. 169 static checks run the real client.js.
中文文档见下。
DeepSeek Harness Web 界面的自适应 + Miracle 视觉层：按屏幕尺寸与比例匹配手机 / 平板 / 桌面，
给输入框和页头补安全区、窄屏收紧留白、触摸设备放大控件，并把配色换成 Miracle 设计语言。
一句话：桌面一个像素都不动；手机上 56px 图标栏完全收起（侧栏入口移到会话页头）、输入框不再被地址栏和 Home 指示条吃掉、刘海不再压住页头、窄屏留白收紧、按钮变成能用手指点的尺寸；配色是 Miracle 的暖白纸感 + 墨蓝色阶 + 蓝紫品牌色。
v2 的核心不是"加了什么"，而是"永远不可能把你锁住"。 见下面的两次事故。
目录
它改了什么
全部在浏览器半（client.js）。不新增宿主能力、不改任何 shipped 包、不 monkey-patch 服务。
1. 运行时判定 —— 测视口，在 <html> 上打标记：
| 属性 | 取值 | 含义 |
|---|
data-dsh-adaptive | 1 | 运行时活着（所有 CSS 的第一道门） |
data-dsh-adaptive-form | phone / tablet / desktop | 形态 |
data-dsh-adaptive-orient | portrait / landscape | 方向 |
data-dsh-adaptive-density | compact / comfortable | 纵向余量 |
data-dsh-adaptive-narrow | 1 | 宽度 < 1024（镜像 shell 自己的侧栏断点），决定窄屏专属的规则是否生效 |
data-dsh-adaptive-touch | 1 | 粗指针（触摸设备） |
data-dsh-adaptive-compat | 1 | 允许对推理卡片做窄屏收敛 |
data-dsh-adaptive-miracle | 1 | Miracle 令牌层已生效（诊断用） |
外加 --dsh-adaptive-vw / -vh / -ratio 三个诊断变量。任何一步失败都不落标记 ⇒ 全部 CSS 失效 ⇒ 界面等于出厂。
2. 文档基础
- 补
<meta name="viewport">：viewport-fit=cover（否则 env(safe-area-inset-*) 恒为 0）、
interactive-widget=resizes-content（键盘弹出时重排而不是盖住输入框）；移除 maximum-scale / user-scalable。
卸载时逐字还原。
- 不动文档高度。 v1 用过
100dvh：手机浏览器地址栏收放会让容器在手势中途改高度，是已知会丢失触摸滚动的写法。出厂的 100% 链保持原样。
3. 几何（只有 padding 与最小尺寸）
- 输入框：窄屏 + 手机形态下左右 8px、底部 4px，各自叠加
env(safe-area-inset-*)（刘海、横屏侧边、Home 指示条）。
- 会话页头：叠加
env(safe-area-inset-top/left/right)；矮屏（紧凑档）再压一次，把高度让给内容。
- 触摸设备：输入框 / 会话页头 / 右侧面板里的
button 最小 36px。
- 桌面级窗口（宽度 ≥1024）一条规则都不命中。
4. Miracle 视觉 —— 一层 ctx.theme.overrideTokens，独立开关。
5. 手机上完全收起图标栏
shell 在窄屏收起侧栏时保留 56px 图标栏 —— 390px 屏幕上那是约 14% 的宽度花在空栏上。
手机形态（且宽度 <1024）下把这一条轨道清零，宽度还给对话；对应的侧栏开关移到 conversation.header.leading
（shell 自己留的空席位，位于会话列内部）。
这不是一次"顺手加的功能"，而是 v1 锁死事故的对症修正：打开某个状态的控件，绝不能住在那个状态里、也绝不能被自己打开的东西盖住。
放在会话列内部的按钮满足这一点 —— 侧栏展开时它依然可见可点。
收起时轨道 0→ 图标栏消失；展开时按 shell 原有行为（中栏被挤压，和出厂点图标栏上的开关完全一致）。
6. Motion（Miracle 动效纪律）
动效只做 Miracle 允许的四件事里的两件，而且只动合成层属性：
| 位置 | 动作 | 属性 |
|---|
| 侧栏抽屉 | 位移（从左侧滑入/滑出） | transform |
| 主会话 | 位移（按同一位移量同步右移/复位） | transform |
| 页头侧栏按钮 | 按下位移（缩放反馈） | transform |
- 一条时间线：抽屉与主会话在同一状态下声明完全相同的
transition（不只是"看起来差不多"），所以不可能出现一个先到、另一个后补。
- 两向同时结束：进出用同一个时长令牌、两条不同曲线（入场减速落位 / 出场加速离开）。性格来自曲线，不来自时钟。
- 令牌集中：
--dshas-motion-enter/exit/drawer/press 只在一处声明，页面里只引用；样式表里没有就地写的时长或曲线常量。
- 两态之间只变
transform：抽屉的盒子属性（position / width / z-index / box-shadow / will-change）声明在两态之外，切态不动盒子。
—— 这是"点开后先弹出、随后又修正一次位置"的根因：盒子在两态不同，浏览器会在滑动结束后再落一次布局。
- 不用
@keyframes：全部是状态驱动的 transition，终点状态由 CSS 决定，所以**不存在"卡在动画中间态"**这回事（不需要定时器兜底，因为根本没有 JS 动画状态）。
prefers-reduced-motion：整条时间线降级为瞬时，且落到正确的终点状态。- 300ms tap 延迟：手机浏览器在未声明
touch-action 的元素上会把 click 延迟约 300ms —— 那正是"点击后延迟弹出"。按钮声明 touch-action: manipulation 后立即触发。
will-change: transform 只出现在侧栏列（让图层在切换前就存在，避免首帧画在终点）。它绝不放在主会话列上 —— 那会让主会话成为 position:fixed 的包含块，也就是即使抽屉关着也会破坏第三方浮层。
7. 空闲预取（"预渲染"里插件真能做的那一半）
面板是按需加载的：模块脚本要下载 → factory 执行（顺带注入该面板的样式）→ 面板挂载，全发生在第一次点开它的那一次点击上。
客户端模块加载器没有公开的预热接口（materialize 只发生在首次 import），但 shell 把引导清单发布在 globalThis.__DSH_BOOT__，
所以模块 URL 是可读的。本插件在空闲时给下列面板放一次性 prefetch 提示，把"下载"这段从点击上挪走：
ui-sidebar · ui-sidebar-right · ui-jobs · ui-subagent · ui-agent-team
安全边界（自检逐条守着）：只走有深度上限的遍历；只接受同源、/assets/ 下、.js 结尾的 URL（畸形或恶意载荷无法让本文档去取别的任何东西）；
只在空闲时放一次；不执行任何模块、不改任何别的插件的状态；卸载即摘除。
8. 即时按下反馈
:active 在触摸设备上生效很晚（某些 iOS 版本在没有 touch 处理器的页面上根本不生效），所以按下状态由按钮自己的 pointer 事件驱动 ——
不是全局监听，也仍然不改事件本身。这是"点下去像没反应"的感知延迟那一半；另一半是抽屉自身的启动成本（见已知限制）。
9. 两种手势，各归其位（这一条是用户校正出来的）
| 对象 | 手势 | 机制 |
|---|
| 转录里的行：思考、命令块、工具调用、折叠卡片 | 高度展开 | 折叠根两行网格 0fr→1fr；命令块与折叠根另有一层 JS 高度接管（测出前后真实高度再推开），因为收起那一帧原语已把 body 卸载 |
| 浮在会话之上的卡片：右侧面板（后台任务/子 Agent/团队）、dock 浮窗、对话框 | 曲线缩放展开 | transition:transform + @starting-style，transform-origin 贴它锚定的一边 |
| 被点击的行头 | 按下几何反馈 | scale(.996)，跑在 press 令牌上 |
不重叠：转录的行不做缩放（行属于流，必须推动流）；浮层卡片不做高度展开（它不是流的一部分）。之前把两种手势给同一个元素，读起来就是噪音。
10. 转录卡片：一处定义，一套配方
思考、命令块、工具行、折叠后的过程组 —— 同一个面、同一个圆角、同一条 hairline，全部读三个令牌：
--dshas-card-surface → var(--dsw-alias-bg-layer-1) （App 自己的抬升层，不是自造色）
--dshas-card-hairline → var(--dsw-alias-border-l1)
--dshas-card-radius → var(--dsw-radius-md)
一条规则承载四类标记，改方案只改一处。填充取应用自己的层，这是"与整体符合"的关键：早先用 bg-layer-2（暖灰）是自造色块，在纸面上就是一块补丁。
唯一随嵌套变化的是内边距：内部行 6/10，容纳它们的组 8/12。
进行中是唯一允许出现品牌色的状态，且两类"运行中"行由同一条声明上色。
11. 手机上的设置页（这一轮的核心修复）
设置不是侧栏页，而是一个居中模态：
.panel width:800px; max-width:calc(100vw - 48px); height:min(800px, …)
.nav width:188px（固定）
.content → .options
在 390px 手机上：面板只剩 342px，扣掉固定 188px 的导航列，内容列约 150px —— 这就是"比例不对"的真身。
它的类名是构建哈希，所以三个元素用结构关系命中（唯一稳定锚点是内容里的 settings.section 席位包装）：
| 元素 | 关系 |
|---|
| 分区导航 | 紧邻在"持有该席位者"之前的兄弟 |
| 面板 | 子元素是那个导航的元素 |
| 内容区 | 席位直接所在的元素 |
手机上的结果：面板满幅（height:100%，在 inset:0 的覆盖层内，因此不引入任何 viewport 单位）、分区列变成横向条（overflow-x:auto + overflow-y:hidden，纵向手势不会被它吃掉）、内容区拿到安全区内边距。
全部是关系而非名字：结构变了就自动不再匹配、回到出厂版式 —— 这是本插件一贯选择的失败方向。
12. 手机上的设置页（按真实标记重做）
先前的做法是从样式表反推结构，结果两条规则命中了错的节点，把分区挤成竖条。现在改为读它自己的渲染代码，于是拿到了不经猜测的钩子：
div[data-shortcut-modal="settings"][role=dialog][aria-modal=true]
<nav> → [ 标题, 列表 ]
div.content → [ header, div.options ← settings.section 席位 ]
手机上：
| 目标 | 处理 |
|---|
| 面板 | flex-direction:column + 满幅满高、圆角 0（用百分比高度，不引入 viewport 单位） |
分区 nav | 变顶部横向条，仅横向滚动（纵向手势仍归面板，不会被吃掉） |
| 分区标题 | 隐藏（content header 已有标题） |
| 分区项 | flex:none 固定自身宽度 ← 这是"竖条"的成因：被压窄后中文逐字换行 |
| 内容区 | 安全区内边距 |
data-shortcut-modal 是专用属性，两条 > 关系是该标记结构里真实存在的；结构一变即自动不匹配、退回出厂版式。
13. 诊断：谁在抢我的定义（tools/inspect.mjs）
node tools/inspect.mjs <dsh web 打印的令牌>
它驱动一个无头浏览器打开真实页面，然后对每类卡片、每个本插件设置的属性，打印计算值 + 所有命中该元素的、设置了该属性的规则（含特异性、以及是"我"还是"壳"）。产出长这样：
思考标题行 → background-color=rgba(0,0,0,0)
background-color 竞争者: 600 [我] html[data-dsh-adaptive-miracle="1"] [data-variant="think"] [data-disclosure-row]
overflow 竞争者: 100 [壳] .lcKema_row
两个真实教训催生了它：卡片令牌曾声明在 html 上而调色板在 body 上（整条 background/border 静默作废，而样式表看起来完全正确）；思考展开后标题行被壳的吸顶条刷成页面底色且特异性高过我。两次都是"规则正确但输了层叠"，肉眼看不出来。
14. 设置行 —— 只在 settings.general.item（加法席位）里加 8 行。
两次事故与它们留下的铁律
事故一：整页点不动、滑不动
原因：遮罩的显隐只看"形态是不是 phone/tablet"，而"侧栏是浮层还是真列"由 shell 自己的断点决定。
在 宽度 ∈ (1024, 1152] 且很矮的窗口里，插件判 phone 挂上遮罩，shell 却认为侧栏是普通列、压根没进抽屉模式 ⇒
遮罩判定为"抽屉开着" ⇒ 全屏吃掉指针事件。
修法：新增 narrow 标记镜像 shell 断点；遮罩 pointer-events 基础态 none，只有带 narrow 门的正向规则才 auto。
事故二：一次点击就把自己关在门外（v1 真正的设计错误）
原因：遮罩盖住中栏，而唯一的开关按钮（汉堡）就在中栏里、位于遮罩之下 ⇒ 遮罩一起来就再也点不到它。
同时遮罩不是对话滚动容器的后代，手指在它上面拖动不会滚动后面的正文 ⇒ "整个会话无法滑动"。刷新才恢复。
另外"新建工作区按钮浮在对话上"就是同一个状态：抽屉展开态浮在中栏之上。
修法（v2 的设计起点）：不再"修好这个遮罩"，而是把整类失败从设计上删掉：
| 铁律 | 自检怎么守 |
|---|
不渲染任何覆盖层，永久不提 pointer-events | 断言全表没有 pointer-events 声明 |
不做任何定位（position / inset / z-index） | 断言这些属性一个都不出现 |
| 只允许一条结构规则：窄屏手机上清零收起状态的图标栏轨道 | 断言"引用框架标记的规则"恰好是那两条，且必须同时带 narrow + phone + [data-sidebar-collapsed] 三重门；!important 全表只允许出现在那一条轨道上 |
| 打开某状态的控件不在该状态里，也不在任何东西下面 | 断言侧栏开关注册进 conversation.header.leading（会话列内部），而不是 shell.overlay 或侧栏 |
| 唯一的事件监听是被动观察者：手机上点侧栏之外收回抽屉 | 断言监听只在"窄屏+手机+抽屉确实打开"时挂上、离开即摘；断言全表从不调用 preventDefault / stopPropagation；断言只用 click（气泡阶段），不在事件派发中途改布局；断言"来自本插件自己按钮的那一次 click"不算点外 —— 观察者是借由这次点击的状态变化才挂上的，不管住它就会自己触发自己（点开即秒关，侧栏永远打不开） |
两态之间只变 transform | 断言抽屉的两条状态规则里没有任何盒子属性；断言 will-change 只出现在侧栏列；断言主会话列从不被提升（否则固定浮层即使抽屉关着也会坏） |
预取不越界：只读引导清单、只放同源 assets/*.js 提示、深度有上限、不执行模块、不改别人状态 | 断言只给点名的面板放提示；断言跨源 URL、非 .js、/assets/ 之外的路径一律不提示；断言载荷缺失/畸形时不抛异常也不产生任何提示；断言卸载后提示被摘除 |
| 动效只动合成层、且令牌集中命名 | 断言全表无 @keyframes、无 animation；断言每条 transition 要么是 none，要么完全由 --dshas-motion-* 构成；断言抽屉与主会话的 transition 字面相同；断言进出同用时长令牌、曲线不同 |
| 不动文档高度 | 断言没有 viewport 高度声明；height 只出现在插件自己的控件上 |
剩下的能力面只有：padding、一条只会被清空的网格轨道、最小尺寸、颜色 —— 这些做错了也不会锁住任何人。
踩坏结构的代价被压缩到"图标栏没消失"或"图标栏还在"，而不是"整页动不了"。
Miracle 视觉层
用 ctx.theme.overrideTokens(source, { token: { light, dark } }) 实现 —— shell 自己的一等机制：一个角色 → 双配色层，
叠在当前主题之上，一次调用整体摘除，shipped 主题文件一个字都不改。
| shell 令牌 | Miracle 角色 | 亮色 | 暗色 |
|---|
--dsw-alias-bg-base | paper 页面底 | #FBFAF6 | #12141F |
--dsw-alias-bg-layer-1 | surface 可点的面 | #FFFFFF | #1B1E2E |
--dsw-alias-bg-layer-2 | sunk 凹陷面 | #F4F3ED | #242839 |
--dsw-alias-label-primary | ink 主文字 | #161B38 | #EEF0F8 |
--dsw-alias-label-secondary | inkSoft 次级 | #454C70 | #C4C9DD |
--dsw-alias-label-tertiary | muted 标签 | #7B83A6 | #8B92AD |
--dsw-alias-brand-primary | 品牌强调 | #5570D8 | #7E96F0 |
--dsw-radius-sm/md/lg/xl | 柔和圆角 | 10 / 14 / 20 / 24px | 同值 |
--dsw-shadow-* / --dsw-elevation-* | 带墨色的克制阴影 | 墨蓝低透明度 | 近零 |
三条 Miracle 规则被编码并由自检守着：不用纯黑纯白；暗色下交互色提亮而不是压暗；阴影带色相、暗色近零，层级改由"面比底亮"承担。
形态判定规则
width <= 600 -> phone
height <= 480 && width / height <= 2.4 -> phone // 手机横屏（844x390）
width <= 1024 -> tablet
否则 -> desktop
orient = height > width ? portrait : landscape
density = height <= 560 ? compact : comfortable
narrow = width < 1024 // 独立于 form，镜像 shell 的侧栏断点
ratio <= 2.4 专门挡"又矮又宽的桌面窗口"（1280×470 ⇒ desktop）。
测量用 documentElement.clientWidth/clientHeight 而不是 window.inner*：后者会在地址栏收放、软键盘弹出时跳动，导致判定反复横跳。
设置项
设置 → 通用，最底部 7 行（order 40–46）：
| 行 | 默认 | 作用 |
|---|
| 自适应界面 | 开 | 总开关。关掉立刻摘掉所有标记 ⇒ 回到出厂 |
| 形态覆盖 | 自动 | 强制 手机 / 平板 / 桌面 |
| 紧凑纵向间距 | 自动 | 矮屏压缩页头（仅窄屏生效） |
| 触摸尺寸 | 开 | 粗指针设备上放大控件 |
| 推理卡片宽度收敛 | 开 | 窄屏限制 .efs-card 宽度 |
| Miracle 视觉 | 开 | 叠加 / 摘除 Miracle 令牌层 |
| 侧栏推开主会话（同步运动） | 开 | 抽屉与主会话同频位移。代价：展开期间，混用"固定定位 + 视口坐标"的第三方浮层（如推理卡片）会偏移一个侧栏宽度；装了那类插件时建议关掉 |
| 当前判定 | — | 只读：手机 / 窄屏 / 390x844 / 鼠标尺寸 / 侧栏收起 / 配色 miracle。读不到显示 — |
最后一行是给报 bug 用的：它让布局问题可以引用真实数字而不是描述屏幕。
偏好存 localStorage["dsh-adaptive-shell/preferences"]（按浏览器，不按 profile）。
与 dsh-codex-efforting 的兼容契约
- 除
max-width 那一条，不写任何 .efs-* 规则，不碰 conversation.input.model 席位。
- 绝不给
[data-composer-card] 的祖先加 transform / filter / perspective / contain / backdrop-filter / will-change / container-type（会把 fixed 卡片的包含块挪走）。
- 绝不改祖先的
container-type（45cqw 的分辨基准）。
- 绝不加
overflow:hidden。
- 不用任何 z-index。
- 窄屏收敛：
.efs-card{max-width:calc(100vw - 24px)}（它自己的 clamp 在视口窄于约 364px 时必然越界；用 max-width 修，因为轨道和滑块都是百分比定位）。可关。
依赖的 shell 公开标记
只读地用三个（不使用任何 CSS-Module 哈希类名）：
| 标记 | 用途 |
|---|
[data-composer-card] | 用 div:has(> …) 定位消费输入框变量的那个元素，覆盖 padding |
[data-conversation-header-leading] | 定位会话页头 <header>，加安全区 |
[data-sidebar-right-panel] | 只用于触摸尺寸 |
[data-shell-overlay] / [data-sidebar-collapsed] | CSS 里只出现在那一条图标栏规则上（三重门）；另外 JS 只读地用于诊断行显示侧栏状态 |
如果 shell 改了这些标记：选择器失配 ⇒ 规则静默失效 ⇒ 界面回到出厂。不崩、不闪、不半成品。
三个层叠陷阱（写给写 Cordis UI 插件的人）
这三个坑的共同点：样式表本身完全正确，肉眼与静态审查都看不出问题，只有把浏览器里的
计算值读出来才会现形。它们分别花掉了我好几轮。
1. 自定义属性声明在错误的元素上
应用的调色板 --dsw-alias-* 定义在 body 上，而我把自己的令牌层写在 html[data-dsh-adaptive]。
自定义属性只向下继承，于是：
/* 在 html 上取 body 的值 → 取不到 */
html[data-dsh-adaptive] body{--dshas-card-surface:var(--dsw-alias-bg-layer-1)} /* ✅ 正确位置 */
后果不是"颜色不对"，而是整条声明作废：background: var(--dshas-card-surface) 里的 var()
解析成无效值 → background 回退成初始值 → 卡片全部透明。凡是用令牌的规则一起静默死掉，
而用字面值的规则（抽屉、设置页）却一切正常 —— 这就是"卡片时有时无"的真正原因。
判据：getComputedStyle(document.body).getPropertyValue('--你的令牌') 返回空串，就是它。
2. transition 是一个属性，平手时后者通吃
折叠根上有两条规则都写 transition：一条给 grid-template-rows（展开），一条给 height（收起）。
两者特异性相同，而网格规则在样式表更后面 → 它赢，元素上生效的过渡只有 grid-template-rows，
高度变化因此没有过渡。给两条过渡分别声明没用，必须让收起规则的特异性严格更高。
3. 壳的规则会以更高特异性抢你的声明
思考展开后，它的标题行会被 shell 变成吸顶条并刷成页面底色：
.lcKema_root[data-expanded] [data-open] [data-disclosure-row]{ background: var(--dsw-alias-bg-base); position: sticky }
特异性 (0,4,0) 高于我那条"强制透明"的 (0,3,1) → 我的规则一直在输，而样式表看起来毫无问题。
正解不是覆盖成透明，而是沿用它的结构与不透明度、只换颜色：
html[data-dsh-adaptive-miracle="1"] [data-variant="think"][data-expanded] [data-open] [data-disclosure-row]{
background: var(--dshas-card-surface); /* 保持吸顶、保持不透明，只是换成卡片色 */
}
判据：不要猜谁赢。tools/inspect.mjs 会把每个属性的竞争者与特异性列出来。
"我改了但页面没变"
插件被拆成两半注入，两半的更新路径不同：
| 半 | 注入方式 | 改代码后 |
|---|
| 样式 | 宿主抽取为 <style data-plugin="…"> | 随页面加载，刷新即新 |
| 脚本 | 按带 rev 的 URL 加载的 ES 模块 | rev 不变 → 浏览器吃缓存旧模块 |
所以会出现"改 CSS 立刻见效、改 JS 像没改"的假象。我有好几轮是对着旧模块改代码。
现在插件自己会标明版本，读一下就知道跑的是哪一半：
document.documentElement.getAttribute('data-dsh-adaptive-build-js') // "5.3.1-js"
getComputedStyle(document.body).getPropertyValue('--dshas-build') // "5.3.1-css"
两者不一致 → 脚本是旧的 → 彻底重启应用（普通刷新可能仍复用同一个 rev 的 URL）。
已知限制
- 左抽屉首次打开仍有一小段延迟：那是 shell 在点击那一刻重新渲染/布局它自己的展开态子树，插件无法替另一个插件预渲染 React 子树，也没有公开的预热接口。唯一剩下的手段是"空闲时开合一次"去替它把这次成本付掉 —— 但那会在你看不见的地方改动你的侧栏状态，正是前面两次事故的同类动作，所以我默认不做。你要的话说一声，我做成显式开关再给你。
- 面板预取只省下载：脚本下载被挪走了，但 factory 执行（含样式注入）与挂载仍在首次点开时发生 —— 加载器不提供更早的入口。
- 主会话是"被推开"而不是"被压缩"：它的布局宽度、缩放比例与渲染分辨率全程不变，只是整体位移一个侧栏宽度。因此展开期间它右侧会有一部分移出视口（被框架裁剪）。
- "同步运动"的代价：主会话上的
transform 使它成为 position:fixed 后代的包含块 ⇒ 展开期间，第三方"固定定位 + 视口坐标"浮层会偏移一个侧栏宽度。默认开着同步运动，可在设置里关掉（关掉后抽屉照常滑动，主会话保持不动）。
- 侧栏开关只在会话页头：手机上非会话面板（如插件页）没有它，回会话由那些面板自己的返回控件负责。
- 平板保留 56px 图标栏（空间够），也不显示额外按钮。
- 紧凑纵向间距只在窄屏生效，桌面级窗口不会被压缩。
- 不覆盖桌面壳（
data-platform=darwin / data-windows-titlebar）：所有规则都带门。
静态自检
node test/smoke.mjs
真跑 client.js（node:vm + 最小 window/document/MutationObserver/matchMedia 桩），126 项断言：
- 加载器声明、导出、
inject、无 Harness Client 包 import；
- 形态判定 11 个边界 + 分类器纯函数；
- 锁死类失败的断言：无
pointer-events / overflow / filter / contain 等属性；结构规则全部在钉死的白名单上；帧子元素绝不被移出流（否则中栏会掉进 0 宽轨道、会话消失）；定位只出现在抽屉盒子上；will-change 只在侧栏列；touch-action 只能是 manipulation；无 viewport 高度声明；裸色值为 0；
- 令牌与门：每个选择器都以
html[data-dsh-adaptive 开头、每个针对 shipped 元素的规则都带门、每个引用的令牌都由 shipped 包定义、无 !important、无哈希类名；
- 三次干跑（390×844 / 1100×460 / 1440×900）：标记、席位、令牌层、卸载还原；
- 专项回归：
1100×460 必须判 phone、必须无 narrow、必须无覆盖层、必须不给侧栏开关。
它不做渲染、不做布局、不声称视觉正确。
安装 / 卸载
# 安装（link 方式，改代码后刷新页面即生效）
plugin_manager action=install_bundle target=<本仓库的绝对路径>
# 卸载（正规路径，会同时清 package.json / bundles / lock / node_modules）
plugin_manager action=remove_bundle target=dsh-adaptive-shell
只关功能不停用插件：设置页关掉自适应界面（结构全关）或Miracle 视觉（只回配色）。
之前我用"手删 node_modules 里的软链"当卸载 —— 那是错的：包仍在 package.json 与 bundles 里，下次启动照样加载。必须走 remove_bundle。
License
MIT
