dsh-cloak-browser

dsh-cloak-browser

一句话：把 CloakBrowser（可装扩展的补丁版 Chromium）的启动参数与生命周期，固化成 start / stop / status 三个工具。

为什么值得用：CloakBrowser 的可用性依赖一串加固参数的正确组合（代理、指纹种子、语言/时区对齐、扩展装载）——手工每次敲一遍，漏一个就表现为「能开但行为不对」这种最难查的失败。本插件把 20 个参数固化进 cloak_start，并配两个安全默认：代理 fail-closed（代理不可用即失败，绝不回落直连）与语言/时区与出口对齐（不一致本身就是可识别指纹）。

能力

工具面 3 个（名称逐字来自 src/index.ts 的 defineTool({ name })）：

快速开始

1) 装依赖：

"dsh-cloak-browser": "link:E:/alice/self-plugins/dsh-cloak-browser"

2) 挂组合：

- id: cloak-browser
  name: dsh-cloak-browser

3) 30 秒验证：cloak_status → 应报「未运行 / 运行中 + 进程与端口」；cloak_start {seed: 48213} → 应起进程且代理不可用时直接失败（不是静默直连）；再 cloak_stop → 只应杀该安装目录下的进程。

配置

落盘与自证

判据：cloak_status 一条命令答「跑没跑 / 是谁的进程 / 代理通不通」。

生效判据与回退

怎么证明线上跑的是当前构建：行为级（工具面有 cloak_*）+ 构建级（lib/index.js mtime 晚于 web 进程启动时间；⚠ 重新构建 ≠ 生效）。 回退：① git revert + 重建 + 预检重启；② patch 行 disabled: true；③ 已起的浏览器进程用 cloak_stop 收掉。

测试

cd self-plugins/dsh-cloak-browser && npm test

10 条用例（跑一次得到）：覆盖状态判定的三态（未运行 / 运行中 / 归属不明）· 目录归属过滤（不是我的进程不认）· 代理 fail-closed 判定。无需网络（代理探测走注入的假探测）。

设计要点

• 只认自己的安装目录：cloak_stop 不碰主人的实例——这是单点所有权纪律在进程管理上的落地（同一资源只能有一个 owner）。
• 代理 fail-closed：代理不可用即失败，绝不回落直连——出口与住所脱钩是硬要求，静默降级等于把家宽 IP 暴露在对外活动里。
• 参数固化而非每次敲：20 个参数里任何一个漏掉都是「能开但行为不对」型失败——最难查的一类。
• 语言/时区与出口对齐：三者不一致本身就是可识别指纹。

相关文档

• docs/semantic.md —— 权威契约（定位/反定位 · 验收表）
• 中心仓：alice-digital-life（本插件归 感知层）
• 相关技能：agent-orchestration · wsl-headless-web-automation（代理与出口纪律）

License

MIT © jonah791

---

本插件属于爱丽丝 DSH 自研插件生态（alice-digital-life · 73 个插件 · 8 个模块）：单一职责、独立仓库、独立可用。