# 本地验证记录（2026-09-08，DSH 0.1.2-rc.1 / Windows）

> 本文件记录 dsh-beginner-hub v0.1.0 在本机的验收过程与证据（敏感值一律不出现）。

## 环境

- DSH CLI：`C:\Users\10464\AppData\Local\npm-cache\_npx\1e7f6d9597241db0\node_modules\.bin\dsh.cmd`
- DSH_HOME：`D:\deepseek_harness_qwen\dsh_data`
- profile：`web`（bundles：`@deepseek-ai/dsh-base`、`@deepseek-ai/dsh-web-app`、`dsh-whale-widget`、`dsh-beginner-hub`）

## 验收逐条证据

### 1. node --check 全部通过

```
OK: lib\index.js / lib\env-check.js / lib\settings-lite.js / lib\data.js / lib\frontend\hub.js / tests\smoke.mjs
```
另：`node tests\smoke.mjs` 输出「全部冒烟测试通过 ✅」（settings-lite 解析、env-check 容错、data 完整性）。

### 2. 安装成功（退出码 0）

`dsh plugin --profile web add link:D:\openclaw_workspace\dsh-beginner-hub`：

```
dependencies:
+ dsh-beginner-hub link:../../../../openclaw_workspace/dsh-beginner-hub
Done in 5.7s using pnpm v12.3.4
```

profile `package.json` 现在包含：
- `dependencies["dsh-beginner-hub"] = "link:D:/openclaw_workspace/dsh-beginner-hub"`
- `dsh.profile.bundles` 末尾追加了 `"dsh-beginner-hub"`

组成树验证（`dsh --profile web --dump-config`，退出码 0）能看到插入行：

```
# == dsh-beginner-hub
- id: dsh-beginner-hub
  name: dsh-beginner-hub
```

### 3. 启动验证（dsh web，端口 3080）

后台启动 `dsh web --no-open --port 3080`（日志 `dev.log`），启动行：

```
dsh web: http://127.0.0.1:3080/?token=...
```

日志全文仅此一行，**无任何插件加载报错**（dev.log 与 dev.log.err 均无 beginner-hub/error/warn 字样）。

端点自测（全部 200）：

| 端点 | 结果 |
| --- | --- |
| `GET /dsh-beginner-hub/hub.js` | 200 application/javascript |
| `GET /dsh-beginner-hub/hub.css` | 200 text/css |
| `GET /dsh-beginner-hub/data.json` | 200 application/json（commands=8 / templates=6） |
| `GET /dsh-beginner-hub/status.json` | 200 application/json |
| `GET /`（token 握手后） | 200，`index.html` 已被注入 `<link hub.css>` 与 `<script defer hub.js>`（位于 `</body>` 前） |

status.json 实测内容（只列状态与说明，不含任何凭据值）：
- 默认模型：✅ `deepseek-official / deepseek-v4-flash（reasoning: high）`
- 模型来源：✅ `DeepSeek 官方 4 个模型；第三方/本地提供方：ollama-local`
- 凭据：✅ DEEPSEEK_API_KEY / ⚠️ DEEPSEEK_PLATFORM_TOKEN（可选未配）/ ✅ OLLAMA_LOCAL_API_KEY
- Ollama：✅ `运行中，已装模型：nomic-embed-text:latest、qwen2.5:7b`

### 4. 停止服务

`taskkill /PID <cmd> /T /F` 终止进程树；确认 3080 已无监听、无残留 dsh/node 进程。

## ⚠️ 需要人工确认的部分

面板 UI 的观感与交互（左下角「🧭 新手台」按钮位置、三页签渲染、命令点击复制、
模板「填入新会话」/「打开设置」的 DOM 桥接是否命中）**无法自动化截图验证**，
需人工打开 http://127.0.0.1:3080 确认；若 UI 结构随 DSH 前端版本变化，
桥接策略可能失效，但所有交互都带降级提示，不会把用户带进死胡同。

---

## 第二轮：用户实测反馈修复（2026-09-08，v0.1.1）

### 反馈 1：模板「填入新会话」没填进文字 → 已修复

**根因**（真实 DOM 侦察确认，见下）：DSH 0.1.2-rc.1 的输入框不是 `<textarea>`，
而是 **Lexical 编辑器**的 contenteditable div（`role=textbox`、
`data-composer-input="true"`、`data-lexical-editor="true"`）。v0.1.0 直接写
`textContent` 只改了 DOM 渲染层，Lexical 的 EditorState 仍为空，发送/重渲染时文字消失。

**修复**：`findComposer()` 优先命中 `[data-composer-input="true"]`（其次
`[data-lexical-editor="true"]`，再回落 textarea/contenteditable）；写入改为
「聚焦 → 光标置尾 → `document.execCommand('insertText')`」走浏览器原生输入管线
（Lexical/React 都靠它更新内部状态，等价于真实打字）；写入后 250ms 回读校验，
校验不过自动转「复制到剪贴板 + 提示」兑底。

### 反馈 2：面板不能拖动 → 已实现

按住顶部标题栏（含 ⠿ 拖拽手柄）可整体移动「入口按钮 + 面板」；Pointer Events +
`setPointerCapture`，位移 < 4px 视为点击不劫持按钮；拖动中全局禁用文字选中；
面板展开时限制顶部不超出视口；松手即停并写入 `localStorage`（下次打开沿用位置）。

### 验证方式（headless Edge + CDP，真实点击页面里的插件按钮）

环境：msedge 152 headless + CDP（零依赖，Node 自带 WebSocket），复用同一浏览器
profile 的登录 cookie；`dsh web` 已干净重启加载新代码（旧进程停掉→新进程监听 3080）。

| 步骤 | 结果 |
| --- | --- |
| 打开面板 → 切「会话模板」→ 点第一个模板「🚀 填入新会话」 | 页面 `[data-composer-input]` 内文本长度 **0 → 138**，开头为「请对以下代码做一次认真的代码审查，按严重程度输出：1. Bug / 隐患…」；toast 提示成功 |
| 截屏确认（verify-fill.png） | 面板左下角正常展开，输入框内可见模板中文文字，无遮挡/破损 |
| CDP 鼠标事件拖动标题栏（右移 240px / 上移 180px） | root 位置 (18,752) → **(258,634)**；`localStorage['dshbh-pos-v1']` 已写入新位置 |
| 拖动后点「✕」关闭 | panel.hidden = true，交互正常 |
| 截屏确认（verify-drag.png） | 面板移至中上区域，布局完整无破损 |

> 截图与验证脚本在 `.scratch/`（已 gitignore，不入库）。截图仅在本地查看。

---

## 第四轮：收起态 pill 按钮独立拖动（2026-09-08，v0.1.3）

### 反馈与要求
- 展开面板拖动已 OK；要修的是**收起态的小圆钮（🧭 新手台 pill）**：整钮满屏可拖、
  阈值区分拖动/点击、位置记忆、与面板位置互不干扰（各自记忆）。

### 根因
- v0.1.2 里 pill 是 `<button>`，被面板拖拽的“交互控件豁免”规则一并跳过（永远不启动拖拽）；
- pill 与面板共用一个位置 key（dshbh-pos-v1），拖面板=整体位移，两者无法各自记忆。

### 改动（lib/frontend/hub.js + hub.css，结构重构）
- **pill 与面板拆成两个互相独立的 fixed 元素**（不再一个容器里上下堆叠）：
  - pill：`position: fixed`，JS 用视口坐标 left/top 定位；整个按钮任意位置按住即拖
    （skipInteractive=false），贴边留白 4px；
  - 面板：同样独立 fixed，整面可拖（交互控件豁免规则保留）；
- 拖动内核收敛为通用 `makeDraggable(el, {key, skipInteractive, margin})`：
  pointer capture + 失败退回 window 监听；4px 阈值；拖动中全局禁选文字；
  拖动结束抑制一次 click（`suppressed()` 供点击处理器判断）→ **拖完不误开面板**；
- **双位置记忆**：`dshbh-pos-pill-v2`（收起态按钮）与 `dshbh-pos-panel-v2`（面板）
  分开存；旧 `dshbh-pos-v1` 仅作首次升级时 pill 的初始位置；
- 面板打开：优先用自己的记忆位，无记忆则开在 pill 上方/下方；
  **渲染完成后再按真实尺寸夹回视口**（修隐藏态量高为 0 → 小窗口首开位置估算失真、
  可能把面板放到视口外导致“点不到/拖不动”的隐藏 bug）；
- 位置都用视口坐标（fixed + left/top），不受 DSH 页面滚动/缩放影响。

### 验证（headless Edge 152 + CDP；Emulation 强制 1440×900；每例实时取点）

| 用例 | 结果 |
| --- | --- |
| pill 本体三处（左 1/4、中点、右 3/4）按住拖动 +90,+30 | (300,498)→(390,527)→(480,556)→(570,585) 全部 moved=✅，且面板保持关闭（不误开）|  |
| 小位移松手（原地点击 pill） | panel.hidden=false（点击开面板未被破坏）✅ |
| 面板拖动（头部空白 +160,+60） | panel (460,145)→(620,205) 移动；pill 位置不变 ✅ |
| 收起（✕）后 | panel 关闭；pill 仍在自己位置 (300,584)±2px ✅ |
| localStorage | 双 key 各自独立：pill={300,585}、panel={620,205} ✅ |
| 重载页面 | pill 回到记忆位（300,585±2px）；面板保持关闭 ✅ |
| 重开面板 | 面板回到自己的记忆位 (620,205)，与 pill 位置互不干扰 ✅ |
| 版本标记 | 面板右下角 v0.1.3 ✅ |

**PASS=9/9**。截屏 verify-pill-v013.png 目检：pill 在左侧、面板在中右区域，互不粘连、
无破损/溢出（覆盖页面属弹窗正常遮挡）。

---

## 第五轮：v0.2.0 内容大改版（2026-09-08，五页签重构）

### 目标用户与结构
面向「用过 AI（豆包/ChatGPT）但没接触过 DSH/GitHub/命令行」的小白。面板重排为五个页签：
① 欢迎·从这开始（默认，三步 + 词典）；② 场景模板（7 个日常）；③ 避坑·常识（FAQ）；
④ Skills 与插件（A–D 四小节）；⑤ 进阶（默认折叠，自检 + 命令速查）。
工程代码（拖动/填充/复制/记忆/版本号）不动，重写内容层 data.js + UI 渲染层。

### Skills/插件调研结论（决定第④页文案的事实基础，详见 research-notes §8）
- Skill = 扫描目录里的文件夹（含 SKILL.md + YAML frontmatter，必填 name/description）或平铺 .md；
  默认扫描根：项目 `.dsh/skills`/`.agents/skills` → `<DSH_HOME>/skills` → `~/.agents/skills`，
  实时监视，新增即生效；
- 调用方式：聊天输入框打 `/技能名`，建议菜单选择后发送（宿主把它当“说明书”注入）；
- DSH 0.1.2-rc.1 **没有图形化的“装技能/技能商店”入口** → 第④页如实写“几种装法”，
  最友好 = 直接让 DSH 帮你写并放进书架；命令行放折叠区；
- 设置 → 插件页的“插件列表”是**只读**清单（官方 README 明言不能启停/增删），
  装/卸插件只能走 `dsh plugin --profile web add/remove` 命令行；
- 推荐区不编造技能名，改为“怎么挑 + 先别囤”标准。

### 验证（headless Edge 152 + CDP，强制 1440×900，PASS=9/9）
| 用例 | 结果 |
| --- | --- |
| 打开面板默认页 | 欢迎页激活态高亮、三步卡片×3、词典折叠×8 词 ✅ |
| 五页签逐一切换 | 场景模板(fill 按钮≥6)、避坑(faq≥5)、Skills(A–D 四小节)、进阶(两折叠) ✅ |
| 进阶展开自检折叠 | 出现状态行（check 行 ≥4，实测 6）✅ |
| 场景「填入新会话」 | composer 文本 0→94（首场景真实入框）✅ |
| pill 拖动回归 | (18,846)→(158,845)，面板未误开 ✅ |
| 版本标记 | 面板右下角 v0.2.0 ✅ |

**过程中发现并修复的真实 bug**：v0.2 面板改为独立浮层后，默认“开在 pill 上方”用的是隐藏态
估算高度，内容实际更高时被视口钳制顶到屏幕底、**盖住自家 pill**（pill 点不到/拖不动）。
修复：内容区 MutationObserver 在渲染稳定后按真实高度把面板重新贴回 pill 上方/下方
（用户拖过面板后只夹回视口、不打扰）。截屏 v02-skills.png / v02-advanced.png 目检正常。

---

## 第六轮：v0.3.0 需求路由 + 技能筛选器（2026-09-08）

### 面板结构（四页签）
① 需求路由（默认）：输入框 + 本地关键词分类器（7 类意图 + 兜底）→ 方案卡 A 直接问它
（每类 2-3 个话术变体）/ B 可用技能（内置清单+已装现配）/ C 进阶玩法；每卡带填入/复制；
底部折叠避坑速记+词典。② 技能筛选：已装一览（新端点 skills.json 扫描）/ 需求匹配 /
值得装清单（7 个真实生态项目）。③ 学习路线（折叠 CTA 跳回路由自动问）。④ 进阶（折叠）。

### 值得装清单来源（全部真实）
[awesome-dsh-plugin/awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)
README 实测收录（2026-09-08 抓取），选 7 条新手相关并逐一给 GitHub 源：whale 余额挂件（本机
已装实证）、dsh-market 插件市场、dsh-project-memory、7D Code Reviewer 技能、Matt Pocock
技能包中文版、dsh-starter-zh、dsh-find-plugin。技能/插件区别如实标注。

### 新端点
`GET /dsh-beginner-hub/skills.json`（服务端扫描 skill 根目录：项目 .dsh/skills、.agents/skills、
<DSH_HOME>/skills、~/.agents/skills，读 SKILL.md frontmatter 的 name/description，同名按 rank
取胜出；全程只读容错）。实测（临时实例）真实列出 `C:\Users\10464\.agents\skills` 下
coze-agent-collaboration 与 using-coze-cli 两个已装技能（含描述与来源根）。

### 验证（headless Edge + CDP，PASS=15/15）
分类器覆盖表逐条断言通过（每例出 3 张方案卡）：
学知识(我想学清楚 RAG)、写东西(实习申请邮件)、让它动手(读桌面文件夹找 bug)、解释代码(报错)、
整理资料(长文总结)、编程任务(写脚本改名)、求职(秋招备战)；兜底(你好呀→万能公式)；
方案A 填入新会话真实入框（0→71 字且含需求）；技能页列出 2 个已装技能 + 7 条目录卡
（每条带 GitHub 链接）；匹配“代码审查”命中目录技能；学习路线 CTA 跳回路由自动出求职分类；
进阶两折叠；版本标 v0.3.0。截屏 v03-route.png / v03-skills.png 目检正常无破损乱码。

### 过程中发现并修复的两个真问题
1. 分类误判：“写个脚本批量给文件改名”被“写个”误判进“写东西”（关键词过宽）→ 移除写东西类
   “写个”，补强编程类（脚本/批量/改名）后修复（E2E 复测通过）；
2. 自动化找不到“填入新会话”按钮：v0.3 新渲染器 actionRow 没带 data-act 属性，旧选择器失效
   （真实按钮一直在，纯测试/一致性缺陷）→ 补 data-act=fill/copy 并复测 15/15。

### 第七轮：v0.3.0 技能模块扩展——发现(搜 GitHub) / 一键装 / 已装管理（2026-09-09）

### 机制核实结论（决定实现路线的事实）
- GitHub 实测：生态“技能”仓库（mattpocock-zh / 7D Code Reviewer / starter-zh）根目录都是
  **插件 bundle**（cordis.patch.yml + package.json），技能本体在仓库内 skills/ 等子目录 →
  “一键装”主路线 = 自动调 `dsh plugin` CLI（装完需重启）；纯技能文件夹/指名子目录走直接复制；
- 停用机制：DSH 官方不支持发现嵌套 SKILL.md → 移入 `<root>/disabled/` 即停用、移回即启用；
- 卸载：移入 `<root>/.trash/`（可恢复，绝不直接删）——都只动技能目录内部，符合安全边界。

### 新增实现
- lib/skill-scan.js：扫描扩展为“启用中 + 已停用（disabled/ 下）”双清单；
- lib/skill-ops.js（服务端）：启停/卸载(移动而非删除)、GitHub 安装（codeload tarball→系统 tar
  解压→分类→插件走 CLI / 技能直装）、操作日志（$DSH_HOME/.dshb-skills-ops.json，50 条上限）、
  DSHB_ARCHIVE_URL 测试注入点；
- index.js 新端点：POST /skills/action、POST /install（支持 probeOnly/subPath/forceSkill）、GET /ops；
- 前端技能页重构为三段式：🔍发现（GitHub 搜索 client 直调 api.github.com + 值得装清单一键装）/
  📦已装（列表+启停/卸载+刷新+操作日志）／🎯匹配（原推荐保留）；所有破坏性动作二次确认。

### 验证证据
headless E2E（UI）9/9 项核心通过：三段式渲染、默认发现段、GitHub 搜索真实返回 6 条结果卡
（⭐/链接/一键装按钮）、清单一键装按钮 ≥7、UI 停用(二次确认)→disabled 列表、UI 启用回、
UI 卸载→从列表移除、匹配段推荐正常；面板版本 v0.3.0。
安装管线 API 测试（本地归档注入 DSHB_ARCHIVE_URL，不依赖外网）8/8：
探针分类=plugin ✓ / 技能直装入书架 ✓ / skills.json 立即可见 ✓ / 重复安装报错不覆盖 ✓ /
停用(disabled/)→启用 ✓ / 卸载(.trash) ✓ / 操作日志含安装+卸载记录 ✓。

### 过程中发现并修复的真问题
1. codeload.github.com 在本环境从 dsh 进程下载超时（60s AbortSignal）→ 超时放宽到 120s、
   失败必清临时目录（此前可能残留 os.tmpdir 目录）；
2. 指名 subPath 安装被“插件优先分类”抢走、误走 CLI 且 CLI 拼 cmd 引号出错（乱码输出）→
   subPath 请求直接走技能直装；CLI 改用无引号安全命令拼接 + spec 白名单校验；
3. 环境无外网时安装链路不可测 → 增加 DSHB_ARCHIVE_URL 注入点并用本地夹具全链验证
   （探针/直装/启停/卸载/日志 8/8）。
测试后已清理全部夹具（$DSH_HOME/skills 恢复不存在；profile 未被测试改动，bundles 仍四项）。

### 第八轮：规格调整——撤销自研管理后端，聚焦需求路由（2026-09-09，仍 v0.3.0）

用户查过 GitHub 后决定：技能管理交给成熟生态插件，不自研（避免重复造轮子）。调整：
- **删除**：lib/skill-ops.js（启停/卸载/安装/日志后端）；index.js 的 POST /skills/action、
  /install、/ops 端点；前端技能页三段式（GitHub 搜+一键装+启停管理 UI）；
- **保留**：只读 GET skills.json（扫描已装技能）；skill-scan.js 还原为只读 active 一览；
- **新增**：GET managers.json（只读检测 dsh-skill-manager 等是否已装，返回候选清单）；
- **技能页改为只读三块 + 引导**：① 已装一览（只读，无操作按钮）② 匹配说明（匹配在路由页
  方案B：已装→引用+用法；未装→链接 + 提示用 dsh-skill-manager）③ 想要更多/想管理
  （未装→是什么/解决什么 + 一键安装命令复制 + 执行说明；已装→提示去它的入口）④ 社区推荐
  5 个（带 GitHub 链接，仅展示）；路由方案B 空/未装文案同步指向管理器。

### 管理器候选核实（GitHub API，2026-09-09 逐仓库）
sulfide2085/dsh-skill-manager ✓（★11，设置页统一管理 DSH/Codex/Claude 技能：热开关启停、
GitHub 技能市场一键发现安装）、MichengAI/dsh-skills-manager ✓（★38）、
zhengjy01/dsh-skill-studio ✓（★3）——均真实存在，引导区用它们。

### 验证（headless E2E，PASS=14/14）
分类抽查全对（RAG→学知识 / 实习邮件→写东西 / 读文件夹找bug→让它动手 / 报错→解释代码 /
秋招→求职），方案卡各 3 张；兜底万能公式；方案A 一键填入 0→71 字；技能页：四小节头齐全、
已装一览(只读)渲染 2 个真实技能（coze x2）、无启停/卸载按钮、管理器未装→引导含一键装命令
（dsh plugin --profile web add github:sulfide2085/dsh-skill-manager）、社区推荐 ≥3 带 GitHub 链接；
自研端点 install/ops/skills/action 全部 405（已移除）。node --check 全过、冒烟全绿。
期间修复：回退扫描模块时误用了含运行时 bug 的历史版本 → 重写只读版并当场 import 验证。

### 第九轮：v0.3.1 发布前完善（2026-09-09，含用户实测反馈）
- 用户实测：「我怎么让 AI 不乱说」掉兜底 → 新增第 9 类意图 **ai-use（AI 使用困惑·防乱说/避坑）**：
  词表覆盖 乱说/乱编/编造/幻觉/答错/不靠谱/说错话/瞎说/回答太假/防 AI 骗/不知道就说不知道 等 20+ 变体；
  方案A 含“只根据事实回答、不确定就说不确定、给依据/出处”的可用模板与 2-3 条白话避坑要点，
  方案C 含“先给依据再给结论 / 读原文核对”两句进阶玩法；该句已入回归集不再掉兜底；
- 词表扩充：8 类各 +3~8 个高频变体（怎么写 prompt/改成口语/帮我校对/怎么提速/简历怎么写/面试会问什么 等），
  并修正两处交叉误判（改成口语类缺 token；简历怎么写与写东西的“简历”打平被抢先）后回归 28/28；
- 兜底话术升级：万能公式 + 「试试直接说这几句」3 个可点示例 + “说得更具体些（背景/目标/限制/输出）”引导；
- README 全面重写（求职作品集级）：徽章、英文简介、定位与差异表（vs starter-zh/skill-manager/launcher，
  三仓均 GitHub API 核实）、功能清单、**真实截图 3 张**（docs/screenshots/，无头实拍）、快速开始、本地开发、
  Roadmap、License；
- 打包自查：files=[lib, cordis.patch.yml, README, LICENSE, docs]（含 docs/screenshots）、
  keywords 补 dsh/dsh-plugin/deepseek-harness/beginner/onboarding/skill/router；版本/角标 0.3.1。
- 回归：headless E2E **28/28**（9 类×3 例含用户三重点原用例 + 兜底公式+3 chips+引导 + 填入 0→71 + 技能页只读）。
截图：docs/screenshots/01-route-default.png、02-route-result.png（RAG→学知识+方案A/B/C）、03-skills-installed.png。

### 第九轮·补充：DSH 上手意图 + 裸“dsh”特判（2026-09-09 用户二轮实测反馈）
- 新增第 10 类意图 **dsh-onboard（DSH 上手 · 从零学会用它）**：覆盖 怎么学dsh/怎么用 dsh/dsh 是什么/dsh
  怎么入门/dsh 教程/deepseek harness/怎么开新会话/怎么看用量/怎么换模型/dsh 和普通 AI 聊天的区别 等
  30+ 变体（中英大小写、有无空格都收）；方案A 三条“带我走一遍/它能干嘛/功能清单”话术，方案C 含
  “让 DSH 自己教你用 DSH（你有哪些功能）”与指向面板「学习路线/进阶」的引导，均可一键填入；
- 裸输入「dsh」特判：classifyNeed 先去标点归一化，命中纯 dsh → 直接进 dsh-onboard（不再掉兜底）；
- 词表刻意不加裸“dsh”token（避免误伤所有提到 dsh 的句子，如“用 dsh 写个爬虫”→ 编程类靠更专词胜出）；
- 输入框 spellcheck=false，避免 “dsh” 被浏览器画红波浪线；
- 回归：扩展用例集（怎么学dsh / dsh / AI 不乱说 + 原 8 类）后 headless E2E **32/32** 全绿。

### 第十轮：v0.3.2 动态兜底——本地规则答不了时上网/GitHub 找（2026-09-09）
- 新增 lib/frontend/external.js（独立前端模块）：GitHub 仓库搜索封装（直调 api.github.com，
  CORS；本地 6s 节流 + 403/429 后降级态；只发用户当前输入原文作搜索词，绝不上送对话）；
  index.js 新增 external.js 静态路由并在 tapIndex 中保证它先于 hub.js 注入（旧页面自动补标签）；
- 兜底区三管齐下：万能公式 + 换说法示例保留，新增「🌐 让 DSH 上网查」（填入指令
  “请帮我上网搜索并总结这个问题：<原文>（给出结论和来源链接）”）与「🐙 去 GitHub 找找」
  （区内联 top5 仓库：名/简介截断/⭐，点击开仓库；加载/空态/错误态文案齐全，失败降级为
  “打开 GitHub 搜索页”外链）；成功方案卡尾部也加同一升级出口（不满意→交外部）；
- 版本 0.3.2、角标/冒烟同步；README 补功能描述 + 第 4 张截图（docs/screenshots/04-fallback-outlets.png，
  面板元素级裁剪：万能公式+chips+引导+两按钮，干净可入 README）。
- 验证：headless E2E v032 **8/8**（必兜底输入“怎么让 AI 写诗押韵”→三出口齐全；上网查填入=模板+原文；
  中文查询空态文案+链接正确；searchRepos API 探针真实 5 条（cpj-dev/dsh-plugin-cc 等）；
  UI 内联真实渲染 5 仓库（dsh plugin code review）；成功页尾部出口存在）；v031 全量回归 **32/32** 无退化。
  注：GitHub 未认证搜索对纯中文/长句常返回 0 条属正常（产品按空态+搜索页链接引导），
  中文查询“怎么让 AI 写诗押韵”→空态出口已断言。

---

## 第三轮：整面板拖动 + 拖不动排查（2026-09-08，v0.1.2）

### 反馈与要求
- 「新手台」拖不动；要求**整个面板任意空白处可拖**（交互控件除外：按钮/模板卡片/复制项/滚动区/页签）。

### 根因排查结论
1. **最可疑：旧脚本未加载**。拖拽代码是 v0.1.1 才加的，若用户浏览器里跑的还是 v0.1.0 的
   旧页面/旧 hub.js，页面里根本没有拖拽逻辑——“拖不动”是必然的。hub.js 虽以
   `Cache-Control: no-store` 提供，但**整个 index.html 若被浏览器缓存**，注入的脚本引用不变，
   需强刷（Ctrl+F5）才能拿到新脚本。本次把版本号标进面板右下角（v0.1.2），
   用户刷新后可肉眼确认新脚本已生效。
2. **热区太小**：v0.1.1 只有标题栏可拖，正文空白/页签空白/底部都不可拖，与直觉不符。
3. **健壮性加固**：setPointerCapture 未包 try/catch（个别环境抛错会中断拖拽）；
   拖动结束若松手落在按钮上可能误触发 click。

### 改动（lib/frontend/hub.js + hub.css）
- 拖拽热区改为**整面板事件委托**（挂在 .dshbh-root）：pointerdown 命中
  `INTERACTIVE_SELECTOR`（button/a/input/textarea/select/summary/label、role=button/tab/menuitem、
  .dshbh-card、.dshbh-code、.dshbh-close、[data-act]）或其祖先则跳过，否则开始拖；
- 位移阈值 4px 区分点击；捕获失败自动退回 window 级 pointermove/pointerup（防“拖不动”）；
- 拖动结束短暂抑制一次根内 click（150ms），防松手误触；拖动中全局禁选文字；
- 边界钳制改为以**面板**为准：展开时整块面板留在视口内（可贴边，上下左右均可拖至任意位置）；
- 位置记忆保持 localStorage（key dshbh-pos-v1），打开/缩放视口自动夹回；
- 光标提示：面板空白处 grab/grabbing，卡片 default（不可拖的视觉区分）。

### 验证方式与数据（headless Edge 152 + CDP，真实鼠标事件序列，多次重复跑）

| 用例 | 位移 | 结果 |
| --- | --- | --- |
| 顶部（标题栏）按住拖动 | +130,+40 | (498,734)→(618,762) moved=✅（第二轮）/(738,762)→(868,762) ✅ |
| 中部（check 行空白）按住拖动 | +130,+40 | (618,762)→(738,762) ✅；(868,762)→(960,762) ✅ |
| 底部（foot 栏）按住拖动 | +150,+90 | (378,684)→(498,734) ✅；(640,762)→(790,762) ✅ |
| 大幅拖向右下角外（2000,2000） | 钳制 | panel 整块停在视口内：(960,136)–(1402,750) ≤ vw=1410/vh=805 ✅ |
| 拖到最右 | 钳制 | panelRight=1402 vs vw=1410，贴边停住 ✅ |
| 页签上按下拖动 | +120,+60 | 位置不变（不误拖）✅ |
| 模板卡片上按下拖动 | +120,+60 | 位置不变（不误拖）✅；点击卡片按钮/切页签仍正常 |
| 拖动后点「✕」关闭 | — | panel.hidden=true ✅ |
| 面板版本标记 | — | 右下角显示 v0.1.2（可肉眼确认新脚本） |

> 首轮“中部/底部不动”是测试脚本自身陈旧坐标的假失败（面板已移走，坐标落在面板外），
> 改成“每次拖动前实时取点”后全部通过；真实逻辑无失败用例。
> 截图 verify-drag-v012.png 目检：面板停在中右侧，内容/页签正常、无破损；
> 右下角与鲸鱼挂件重叠属预期（挂件 z-index 9999 高于面板 9980）。