dsh-browser-bsk
给 DeepSeek Harness 提供 browser 能力 seam（ctx.browser）的 bsk 后端：把本机 browser-skill 用的 bsk CLI 包成一个浏览器服务，供那些 inject 了 browser 的插件注入。
为什么需要它
有些插件把 browser 当作可选依赖，却写进了 inject。dsh-accounts 的代填入口就是一例：
export const inject = ['tools', 'credentials', 'browser']
cordis 的 inject 是硬门禁：没有名为 browser 的服务，这条 entry 永远停在 pending；而当前 Harness（packages/boot/app-boot 的 assertEntriesActivated）把"有 entry 未激活"判定为 boot 失败：
Error: dsh: plugin tree failed to load: dsh: 1 entry did not activate
dsh-accounts/fill: pending (waiting for service: browser)
于是装上这类插件、但机器上没有 browser 服务的 profile 会直接起不来（上游已在 issue #2 记录，并在 PR #3 里改成运行时检测）。
在两者都修好之前，本插件是一条立刻可用的路：只发布 browser 服务，不注册任何工具。
社区里另一个提供 browser 服务的是 dsh-builtin-browser（npm 上的无 scope 包名，第三方项目，不是 DeepSeek 官方；自带 Electron + CDP 与 33 个 browser_* 工具）。但如果你已经在用 browser-skill（bsk + 浏览器扩展，驱动你自己的浏览器），装它会撞车：两者都注册 browser_session，而工具注册表对重名直接抛错，browser-skill 的六个工具是一次整体注册，会整组失效。
| 驱动 | 工具 | ctx.browser 服务 |
|---|
browser-skill | 你的浏览器（扩展 + bsk） | 6 个（懒加载） | ❌ |
dsh-builtin-browser | 自带 Electron | 33 个 | ✅ |
| 本插件 | 你的浏览器（bsk） | 0 个 | ✅ |
因此它可以和 browser-skill 共存：会话、Agent Window、登录态都复用同一套 bsk daemon。
安装
dsh plugin --profile web add file:/Volumes/Kapp/source/dsh-browser-bsk
装完重启 DSH。然后 dsh-accounts/fill 就能激活——如果你的 cordis.patch.yml 里有为它写的 disabled: true，现在可以删掉（有服务了，不会再 pending）。
实现的服务面
消费者需要什么就实现什么，没有 stub（未实现的方法直接不存在，调用即报错，不会静默无操作）：
| 方法 | bsk 命令 | 说明 |
|---|
open(label) | bsk session start | 返回 session id；label 只记日志（bsk 不按 label 去重） |
listTabs(session) | bsk tab list --session S | 归一化为 {tabId, url, title, active, scope} |
setValue(session, {target, value}, signal) | bsk fill --session S --selector X --value V | 只支持 by: 'css'（bsk 只认 CSS 选择器与快照 ref） |
click(session, {target}, signal) | bsk click --session S --selector X | 同上 |
key(session, {key}, signal) | bsk press <KEY> --session S | 例如 Enter |
detectChallenge(session, signal) | bsk get-html --session S | 读页面标记匹配验证码特征（reCAPTCHA/hCaptcha/Turnstile/Geetest/滑块…） |
close(session) | bsk session stop <ID> | 幂等；会话已消失时静默 |
dsh-accounts/fill 里"复用当前会话"的快路径会 import('dsh-builtin-browser/tool-browser') 读它的 internals.sessions；本插件不提供那个包，所以它每次都会走它自己的回退路径（ctx.browser.open(taskKey) 自开会话），日志里会有一条 warn。这是已知且预期的行为。
配置
cordis.patch.yml 的 entry config：
- insert:
- id: browser-bsk
name: dsh-browser-bsk
config:
bskPath: bsk # bsk CLI；默认从 PATH 解析
timeoutMs: 120000 # 单次命令超时
sessionWidth: 1400 # 可选，与 sessionHeight 成对生效
sessionHeight: 900
测试
node --test test/*.test.mjs
测试用真实 cordis Context 挂载服务（覆盖 super(ctx, 'browser') 注册路径），CLI 调用全部走注入的假 runner，不会启动真实浏览器会话，也不需要 daemon。
真实浏览器端到端（可选，会开一个 Agent Window）
e2e.mjs 与 e2e-challenge.mjs 走真实 bsk daemon：前者在一个本地登录页上跑完 open → listTabs → detectChallenge → setValue ×2 → click → 校验提交结果 → close（就是 dsh-accounts/fill 的调用序列）；后者是验证码检测的正样本对照。
mkdir -p /tmp/logintest && cd /tmp/logintest && python3 -m http.server 8123 &
node e2e.mjs # 期望末尾打印 WELCOME alice
node e2e-challenge.mjs # 期望打印 markers: g-recaptcha / recaptcha/api.js / captcha / verify you are human
需要本目录下有指向 Harness 依赖的 node_modules：
ln -sfn ~/.dsh/profiles/node_modules node_modules # 仅本地跑测试用，已被 .gitignore 忽略
已知限制
- 只实现上面那张表；seam 的其他方法（
navigate/snapshot/execute/screenshot…）没有实现。有消费者需要时再加，而不是现在铺 stub。
- 只支持 CSS 选择器定位（
by: 'css'，index: 0）。
detectChallenge 是标记匹配，不是能力边界：只用于"命中就跳过代填"的保守判断。- 与
dsh-builtin-browser 互斥（两者都发布 browser 服务），同时安装会重复注册服务。
