CreatixChu
17b13383af
* fix(plugins): temporarily hide the CUA bundle * test(plugins): update expectations for hidden CUA * fix(cua): preserve management for enabled bundles * test(cua): cover default-hidden activation and retained details * test(cua): verify installed state survives disabling * test(cua): use the native provider display name
description, kind
| description | kind |
|---|---|
| Enable optional macOS Computer Use and its permission page. | package-bundle |
@deepseek-ai/dsh-cua-bundle
English | 中文
Summary
Enable macOS Computer Use from Plugins for existing and new PTC sessions. Windows support is in development. This bundle remains in experimental until that support is complete, then moves to the computer-use group. It is off by default and hidden from the default plugin lists until enabled or separately installed; disabled profiles prepare no native components and register neither CUA tools nor their model guidance.
Table of Contents
- Use this package
- Understand the implementation
- Further Exploration
- Model Experience
- Known Limitations and Deferred Work
Use this package
This workflow targets developers running macOS Web or unpackaged Desktop from source. In Plugins → Add plugin, enter @deepseek-ai/dsh-cua-bundle, choose Install, then Enable now. DSH enables its shipped copy without downloading another one. Enabled bundles remain in Plugins, where you can open Computer Use to manage permissions or switch it off. Switching off hides its card again unless the profile separately installed it. The permission page identifies the responsible application reported by macOS when the optional system query is available. Request access and enable that application in System Settings; follow the application named by macOS if it differs from the detected source. For Web, run these commands from the repository root:
pnpm run build
pnpm dsh web
For the source Desktop launcher and its separate development profile, follow Desktop development. Enable Computer Use in each profile that needs it.
The switch saves bundle selection in the profile’s package.json. Computer Use is installed only in PTC sessions. Enabling through Add plugin or a visible card offers setup guidance when system permissions need attention; enabling from its detail page displays the permission controls directly. The detail page offers Set to PTC for the new-session default; existing sessions keep their preset. The switch leaves PTC execution mode and other settings unchanged. The detail page’s Use persistent mode action separately enables in-memory state across PTC calls; its effects and reload behavior are described in the permission page. Native preparation runs when the provider loads and reuses the source-hashed executable when available.
Disabling unloads the provider and withdraws CUA tools from its Agent scopes. Runtime configuration, the new-session default and saved grants remain. Session-only application decisions end with provider disposal.
Computer Use requires a macOS DSH Host. On other operating systems, installation omits the optional macOS provider and the bundle skips its Loader entry. Shared CUA logic and the permission-page entry remain available, but Computer Use operations require the provider. A browser on another operating system can connect to a supported Mac Host.
If preparation fails, the saved selection remains and CUA operations stay unavailable. Read the Host startup diagnostic, correct its cause, then restart DSH.
Explicit activation runs a read-only permission check, which may start a helper without opening a system dialog. Open the permission page for system requests, settings navigation and automatic refresh. Tasks ask separately before accessing an application. Saved application decisions use the existing profile configuration; session decisions remain in memory across turns and connections until DSH restarts or Computer Use is disabled. Revoke access on the same page.
Understand the implementation
Maintainer details
The bundle patch mounts the native provider and permission UI with agentPreset: ptc. Existing Agent scopes register the tools without changing preset documents. The detail-page action uses the existing settings form to save agent-preset-registry.selectedDefault: ptc only when clicked. CUA owns registration and disposal.
Further Exploration
Model Experience
Computer Use in PTC sessions
What the model sees
Existing and new PTC sessions receive cua through the generated SDK and run_code, plus CUA guidance. Disabling withdraws these contributions and keeps PTC presentation. Other presets receive no CUA contributions. CUA and PTC own the interfaces and output semantics.
Token effect
CUA activation adds its guidance. Disabling removes that guidance; the existing PTC execution instructions remain.
KV Cache effect
CUA activation and removal change the PTC SDK and system guidance; subsequent requests use the updated prefix. The top-level run_code transport remains present.
Known Limitations and Deferred Work
- Source Web and Desktop share permission controls on macOS. Packaged Desktop helper distribution, signing, and permission attribution are deferred.
- PTC execution is shared by the profile and is configured independently. A Host without HMR applies saved changes at restart. Saving or revoking application grants while another HMR transaction unloads the provider can block; queued-write cancellation is a separate pending lifecycle fix.
Dev Note
None.