2234839/silkpulse/skill

# 1. 先看有哪些在线设备
node tools/skill/scripts/silkpulse.mjs devices
 
# 2. 一键诊断聚合（错误 + 失败网络(含响应体) + 慢请求 Top + WebSocket 连接 + 日志 + 快照，AI 诊断最高效的入口）
node tools/skill/scripts/silkpulse.mjs inspect <deviceId>
 
# 3. 取页面快照（AI 友好的 compact 文本，一眼读懂页面结构）
node tools/skill/scripts/silkpulse.mjs snapshot <deviceId>
 
# 4. 查看错误和日志
node tools/skill/scripts/silkpulse.mjs errors <deviceId> 5         # 最近 5 条错误（每条带 stack，省 token）
node tools/skill/scripts/silkpulse.mjs logs <deviceId> 20          # 最近 20 条日志（AI 常用，省 token）
node tools/skill/scripts/silkpulse.mjs network <deviceId> 10       # 最近 10 条网络请求（含 WebSocket 连接 + 帧时间线）
 
# 4. 在远程页面执行诊断代码
node tools/skill/scripts/silkpulse.mjs exec <deviceId> "return document.querySelector('#btn').textContent"
 
# 复杂多行代码用管道传入（避免 shell 转义）
echo 'return { url: location.href, btn: document.querySelector("#btn")?.textContent }' | node tools/skill/scripts/silkpulse.mjs exec <deviceId>
 
# 5. 生成接入片段（给新设备装 SDK）
node tools/skill/scripts/silkpulse.mjs inject bookmarklet   # 书签
node tools/skill/scripts/silkpulse.mjs inject userscript    # Tampermonkey / 脚本猫（ScriptCat）

1. silkpulse devices                     # 确认有在线设备
2. silkpulse inspect <id>                # 一键聚合：错误 + 失败网络 + 快照（最高效）
3. 如需深入：silkpulse errors/logs/network <id> 逐项细看
4. silkpulse exec <id> "return location.href"    # 执行诊断代码

1. silkpulse errors <id>                 # errors 输出会自动带 ↳ 原始源码位置（若有 source map）
2. silkpulse exec <id> "return await __silkpulse_sourcemap(1, 8453, 'https://site.com/a1b2.min.js')"
   # → { source: 'src/cart.ts', line: 142, column: 8, name: 'calculateTotal' }

 
**辅助函数**（exec 代码中可直接用）：
- `__silkpulse_click(idx)` — 点击 snapshot 中 idx 对应的元素（触发完整鼠标事件序列 mouseover→mousedown→mouseup→click，覆盖 div[role=button] 等监听 mousedown 的自定义组件）
- `__silkpulse_setValue(idx, val)` — 设置表单值（触发 input/change 事件，兼容 Vue/React v-model）。input/textarea 传文本值；select 传 option 的 value；checkbox 传 `'true'`/`'1'` 勾选、`'false'`/`'0'` 取消；radio 传任意非空值选中（同组其他自动互斥取消）
- `__silkpulse_type(idx, text)` — 模拟键盘逐字输入（触发 keydown/keyup 序列，用于搜索框等监听 keyup 的场景）
- `__silkpulse_scroll(idx, x, y)` — 滚动元素内部（idx<0 时滚动整个窗口），触发懒加载/检查 sticky
- `__silkpulse_scrollIntoView(idx, block?)` — 滚动元素到可视区域（block: 'center'|'start'|'end'|'nearest'，默认 center）
- `__silkpulse_hover(idx)` — 鼠标悬停（触发 mouseover/mouseenter），展开下拉菜单/tooltip
- `__silkpulse_pressKey(idx, key, mods?)` — 按键（派发 keydown+keyup），如 'Enter'/'Escape'/'ArrowDown'；idx<0 对当前焦点元素；mods 可选 {ctrl,shift,alt,meta}
- `__silkpulse_wait(ms)` — 异步等待
- `__silkpulse_snapshot()` — 手动取页面快照
- `__silkpulse_sourcemap(line, col, sourceUrl?)` — 解析 source map，把压缩代码位置映射回原始源码位置（线上压缩代码报错时定位真实出错点）
- `__silkpulse_sourcemapStack([{url,line,col},...])` — 批量解析堆栈帧，返回紧凑文本
- `__silkpulse_storage(type?)` — 查询页面存储（`'local'`/`'session'`/`'cookie'`，默认 `'local'`），返回 `{key:value}` 对象。诊断登录态丢失/接口 401/配置异常（token 在 localStorage、会话在 cookie），单个值超 200 字符截断
 
**注意**：exec code 是 async 函数体，写 `return` 才有返回值。多条操作间用 `await __silkpulse_wait(0)` 让框架处理响应式更新。
 
## snapshot 阅读指南
 
snapshot 是 token 高效的 compact 文本，每行一个元素：
 

 
- `#数字` 是稳定 idx，跨快照不变，供 `__silkpulse_click(idx)` 使用
- `#id名` 是元素的 id 属性（语义信息）
- 交互元素（button/input/a/select）会显示 idx，纯文本元素不显示
- select 的 options 用 `value:text` 格式（如 `bj:北京`），`__silkpulse_setValue(idx, "bj")` 传 value 切换选项
 
## 配置
 
- `SILKPULSE_SERVER` 环境变量指定 server 地址（默认 `http://localhost:8080`）
- server 启动：`pnpm start`（或 `node packages/server/dist/bin/silkpulse.mjs --port 8080`）
- SDK 注入：目标页面加 `<script src="http://<server>/sdk.js" data-server="http://<server>"></script>`