Contributing

August 21, 2026 · View on GitHub

感谢对这个插件的兴趣!

开发环境

npm install
npm run build
node --test test/host-composition.test.mjs test/page-chrome.test.mjs test/provider-actions.test.mjs

约定

  • TDD:先写失败测试(test/provider-actions.test.mjs 用 FakeHost 断言 CDP 调用序列;host-composition.test.mjs 为源码断言,保护 host 线序)。
  • 铁律:
    1. 永不 reparent 可见 WebContentsView(唯一例外:capture 的 CDP 回退,临时 detach 同窗口视图且必须恢复)。
    2. 页面 chrome 留在页面内(closed Shadow DOM);不得变成第二个 WebContentsView。
    3. Electron 锁 42.9.3(43.4.1 组合器故障);升级需 5/5 导航浸泡测试。
    4. 快照/填充/内容脚本必须过滤 closest('[data-dsh-browser-chrome]')。
  • 提交信息风格:feat/fix|test(scoped): ...,每个任务独立提交。

运行时验证

改动 host-main.js/page-chrome.js 后需重启浏览器子进程;改动 provider/remote/tool 层后需重启 DSH(见 docs/SOAK-CHECKLIST.md)。

发布

package.json 声明 dsh.bundle.patch(已就绪);发布 = 打 tag + npm pack + gh release create。