description: "计算机操作提供方注册：供每次启用一个桌面驱动的部署使用。" kind: "package-reference"

@x1a0f3n9/dsh-computer-use

English | 中文

概述

部署每次可启用一个计算机操作提供方。加载另一个提供方时会失败，并报告已注册的提供方名称。各提供方提供自己的工具和桌面操作。本包不添加模型可见工具，也不协调并发 Session。

目录

• 使用本包
• 理解实现
• 延伸阅读
• 模型体验
• 已知限制与后续工作
• 开发备注

使用本包

在 Cordis 组合中，将服务与选定的提供方一起挂载一次：

- name: '@x1a0f3n9/dsh-computer-use'

服务没有配置项。提供方插件注入 computerUse 并调用 ctx.computerUse.register(ComputerUseProviderName(name))；该品牌类型从 @x1a0f3n9/dsh-computer-use/brand 导出。返回的 effect 清理函数释放此次注册。

提供方先停止接收工具调用、关闭资源并等待自有工作结束，再释放注册。释放前，ctx.computerUse.providerName 始终报告已注册的名称。

理解实现

一个私有名称占用注册位置。Cordis effect 在插件卸载时移除贡献；重复调用清理函数不会移除后续注册。源码不包含驱动对象、操作接口或提供方选择器。

不发布 ./invariant 伴随入口：注册表只有一个权威字段，没有可能与之分歧的独立维护观测值。所属测试覆盖重复注册拒绝和插件卸载。

延伸阅读

• 计算机操作 — 提供方选择和共享桌面限制。
• Cua Driver MCP 提供方 — 使用已安装的驱动。
• Cua Driver 原生提供方 — 使用 npm 运行时。

模型体验

无，因为此注册表只记录提供方名称。

KV 缓存影响

注册不改变模型请求。提供方拥有的工具和指导文本决定各自对请求前缀的影响。

已知限制与后续工作

服务在其 Cordis 服务实例内限制注册。

• 共享桌面 — 并发 Session 和独立 DSH 进程可以操作同一桌面；调用方协调完整的计算机操作流程。
• 提供方选择 — 由配置选择提供方；模型不能在运行时切换已注册的驱动。

开发备注

无。