前言¶
在 DeepSeek Harness（DSH）里做联网或桌面自动化时，常见做法是单独挂 Browser Use、再另配 Computer Use，或者让模型间接操作不可见的浏览器实例。页面归属不清、侧栏 guest 与 Playwright 窗口各管各的，停服、接管和恢复时也容易和 Host 状态不同步。@missher/dsh-computer-browser 面向与 Missher Desktop 匹配的整合版，把「可见 Browser Use」和「按会话归属的 Cua 桌面工具」收进一个独立 Bundle，并保证同一时间只有一个 Browser Use 提供者生效。
这是什么¶
- 包名：
@missher/dsh-computer-browser（npm 包；社区目录条目为 missher12/missher-dsh-computer-browser） - 维护者：Missher12
- 当前版本：
0.1.0-rc.5（预发布，README 明确保留验收限制，不宣称生产就绪） - 分类：联网工具（SkillHub 目录）
- 一句话：为兼容的 Missher DeepSeek Harness Desktop 构建提供可见 Browser Use 与会话归属的 Computer Use。
本仓库是该独立 Bundle 的唯一持续维护源码；不是 DeepSeek 官方桌面发行版。Cordis、Agent、ToolRuntime、MCP、BrowserUse 与 ComputerUse 等服务由 Host 提供，本包不安装第二套 Host。
核心功能¶
双后端，单一 Browser Use 提供者¶
| 后端 | 可见页面 | 归属与存储 |
|---|---|---|
electron（默认） |
与 browser_use 相同的真实侧栏 guest |
绑定当前活跃会话，默认临时存储 |
playwright |
单独启动的可见 Chromium | 每个活跃会话独立临时 profile 与工作目录 |
同一时间只能启用一个 Browser Use 提供者；遇到冲突会拒绝启动，原生组件启动失败时会回滚已启动的浏览器提供者。
浏览器动作与桌面协调¶
open、navigate要求绝对 HTTP(S)url，且不得内嵌凭据；非法 URL 在 IPC 与创建会话所有权之前即被拒绝。- 工具采用对象根 schema（如
{ action, url, ... }），先观察所属页面，再用当前引用操作，最后读回结果。 - Cua Driver 运行在 Standard 模式；浏览器子工具（含旧
page）被禁用，浏览器控制只保留一条归属链。 - 截图经 Host 图像与附件通路传递；刷新失败会撤销旧操作许可，只有有效 PNG 经 Host 管道成功后，才允许下一次原生动作。
停止、接管与会话边界¶
- 停止会拒绝新操作，已派发的底层工作可能仍在结束。
- 接管把控制权交给用户；恢复后必须重新观察。
- 取消或超时不会撤销已送出的输入，也不会自动重放结果不确定的动作。
- 会话隔离保护目标归属，不是操作系统级沙箱；插件能力随当前 DSH / Desktop 进程权限运行。
明确排除的能力¶
Playwright 后端始终启动可见隔离浏览器，不附着已有浏览器、不复用日常 profile。任意脚本执行、模型指定的宿主文件路径、任意上传与拖入等均被排除。原生 get_window_state 默认仅截图；verify_state 与 invoke_menu（Cua 0.28 中不安全的菜单 AX 路径）不向模型提供。
宿主要求（安装前必读）¶
仅安装本 Bundle 不会补齐 Desktop 能力。所用 Missher Desktop / Host 须同时满足 README 所列条件，包括但不限于：
- Desktop 浏览器桥
automationVersion: 1及配套侧栏客户端（electron后端）； - 原生授权与停止 / 接管 / 恢复控制的 Host 适配器；
- MCP
excludedTools（playwright后端）； runProfile.prepareContext启动集成；- 2026-10-05 Host 与侧栏挂载修复，以及后续 Host 截图修复（持续遮挡、关闭重开画布等）。
官方 Desktop 0.2.0-rc.2 不包含上述新增能力。安装前应对照配套宿主发布说明与仓库内 COMPATIBILITY.json；peer 依赖范围宽不代表已验证兼容。
安装与启用¶
资料中的安装路径不是 dsh plugin add github:...，而是从 GitHub Releases 取固定版本归档，经 Desktop 插件管理器安装。
- 确认 Desktop / Host 具备上文能力，且未同时启用另一 Browser Use 或 Computer Use 提供者。
- 打开本仓库 Releases，下载对应版本的
.tgz及 SHA-256 校验文件（发布协调者上传并核验后链接才可用；README 不保证每个候选均已公开下载）。 - 在该 Desktop 的插件管理器中安装下载的归档，按提示重启。保留的
desktopprofile 须通过 Desktop 正常通道管理，不要用无关 CLI 直接改其文件。 - 确认 Bundle 为 active。在测试对话中打开无敏感页面、读取标题，并核对观察结果是否与侧栏或 Playwright 窗口一致。
停用：在同一插件管理器中停用 Bundle 并重启。卸载 @missher/dsh-computer-browser 会移除其配置层并释放所属工具、会话与临时资源；已有对话、凭据、其他插件及用户明确保留的登录存储不受影响。
升级与回滚：升级前保留前一版归档，并为受影响应用与 profile 做新备份；Host 桥与 Bundle 须继续匹配，只恢复一侧可能导致组合不可用。
配置¶
通过 Host 配置入口编辑 computer-browser Loader 条目。README 示例：
backend: electron # 或 playwright
sessionTtlSeconds: 3600
idleTtlSeconds: 600
# 仅 Playwright 可选：指定已安装的 Chromium 可执行文件。
# executablePath: /path/to/chromium
# toolCallTimeoutMs: 60000
idleTtlSeconds 不得超过 sessionTtlSeconds。切换后端需在 Desktop 空闲时重启，会关闭原活跃实例资源，不迁移正在运行的页面或授权。Bundle 固定 Playwright 为 mode: launch、headless: false。
典型用法（工作流）¶
README 未给出独立 CLI 演示脚本，模型侧用法遵循同一对象根工具约定：
- 使用
open或navigate，传入合法绝对 URL（例如https://example.com）。 - 读取 Browser Use 提供的可访问性结构或截图观察结果，确认页面状态。
- 在停止状态未生效、且已有有效截图许可的前提下，按 schema 发起点击、
type_text等动作；原生路径上 README 建议：已授权点击 → 新截图 → 无坐标type_text→ 再读回。 - 需要人工介入时使用接管；恢复后重新观察，不要假设旧句柄或旧快照仍有效。
Electron 上传需用户经原生选择器选文件；下载需批准一次传输并选择目标。持久登录需原生确认，且作用于此后创建的标签。
适用场景与注意¶
适合：已在（或计划使用）与 rc.5 匹配的 Missher Desktop / Host、需要在可见页面上做 Browser Use，并在同一会话内协调 Cua 桌面工具的智能体开发者；希望 Playwright 与 Electron 侧栏二选一、且避免多 Browser Use 提供者冲突的场景。
不适合或需降级预期：
- 仅安装官方 DeepSeek Desktop
0.2.0-rc.2或旧整合基线（如 README 提到的latest-cbu-20261004）而未升级 Host 能力——Electronopen等路径可能不可用，只更新本 Bundle 无法修复挂载。 - 需要完整 AX 菜单扫描、任意脚本注入、附着已有 Chrome profile，或期望预发布等同于生产就绪的场景。
- Apple Silicon、Windows、Linux 原生行为：README 写明 macOS Intel 证据不代表其他平台已通过；真实付费模型与 P0 Playwright / P1 Electron 等验收项以维护者记录为准。
安全与合规：安装前请阅读仓库源码、LICENSE（MIT）及 THIRD_PARTY_NOTICES.md（含 Playwright MCP、Cua 等）。插件以当前 harness 进程权限运行；屏幕录制与辅助功能权限由系统管理，不会自动代你申请。
结尾¶
@missher/dsh-computer-browser 把可见浏览器与会话归属的 Computer Use 收敛到一个 Bundle，并依赖匹配的 Missher Desktop Host 完成桥接、截图与授权。若你的环境已对齐 COMPATIBILITY 与 Releases 中的固定归档，可按插件管理器流程安装，再用 YAML 选择 electron 或 playwright 后端做验证。
