diff --git a/packages/experimental/cua-bundle/README.i18n.yaml b/packages/experimental/cua-bundle/README.i18n.yaml
index ff42d19472..1d6f10f1c5 100644
--- a/packages/experimental/cua-bundle/README.i18n.yaml
+++ b/packages/experimental/cua-bundle/README.i18n.yaml
@@ -15,8 +15,8 @@
en: b563e4ec4727d0de
zh: d0228da978238e05
/deepseek-ai-dsh-cua-bundle/use-this-package:
- en: e19d1fd30ca77a8b
- zh: b192eacfac12a5fe
+ en: 9bac8b814e2f0087
+ zh: ef9098d3448dae6d
/deepseek-ai-dsh-cua-bundle/understand-the-implementation:
en: 057771fe13aaa337
zh: 4fdb2b98ff3e7a78
diff --git a/packages/experimental/cua-bundle/README.md b/packages/experimental/cua-bundle/README.md
index d534cb07a6..f9870d698d 100644
--- a/packages/experimental/cua-bundle/README.md
+++ b/packages/experimental/cua-bundle/README.md
@@ -33,6 +33,8 @@ pnpm dsh web
For the source Desktop launcher and its separate development profile, follow [Desktop development](../../../apps/desktop/README.md). Enable Computer Use in each profile that needs it.
+The plugin detail page shows a localized feature preview above the permission controls.
+
The switch saves bundle selection in the profile’s `package.json`. Computer Use is installed only in PTC sessions. Enabling from the plugin list 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](../cua/README.md). 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.
diff --git a/packages/experimental/cua-bundle/README.zh.md b/packages/experimental/cua-bundle/README.zh.md
index e47bd3ad43..fcd76aed2a 100644
--- a/packages/experimental/cua-bundle/README.zh.md
+++ b/packages/experimental/cua-bundle/README.zh.md
@@ -33,6 +33,8 @@ pnpm dsh web
源码 Desktop 的启动方式和独立开发配置档见[桌面开发说明](../../../apps/desktop/README.zh.md)。需要使用 Computer Use 的配置档分别开启该功能。
+插件详情页在权限控件上方显示本地化的功能预览图。
+
开关将组合包选择保存到 profile 的 `package.json`。Computer Use 仅安装在 PTC 会话中。从插件列表启用时,系统权限未就绪会显示设置引导;从详情页启用后直接显示权限控件。详情页提供“设为 PTC”按钮来修改新会话默认模式,已有会话保留原 preset。开关保持 PTC 执行方式和其他设置不变。详情页的“设为持久化”按钮单独开启 PTC 跨调用的内存状态保留,作用范围和重载行为见[权限页面](../cua/README.zh.md)。提供方加载时准备本机组件,已有与源码摘要匹配的可执行文件时直接复用。
关闭会卸载提供方,并从其 Agent 作用域中撤回 CUA 工具。执行器配置、新会话默认值和已保存的授权保留。会话级应用授权随提供方卸载而失效。
diff --git a/packages/experimental/cua-bundle/docs/DETAIL.md b/packages/experimental/cua-bundle/docs/DETAIL.md
new file mode 100644
index 0000000000..071519af31
--- /dev/null
+++ b/packages/experimental/cua-bundle/docs/DETAIL.md
@@ -0,0 +1 @@
+
diff --git a/packages/experimental/cua-bundle/docs/DETAIL.zh.md b/packages/experimental/cua-bundle/docs/DETAIL.zh.md
new file mode 100644
index 0000000000..7acb1b1476
--- /dev/null
+++ b/packages/experimental/cua-bundle/docs/DETAIL.zh.md
@@ -0,0 +1 @@
+
diff --git a/packages/experimental/cua-bundle/docs/preview.svg b/packages/experimental/cua-bundle/docs/preview.svg
new file mode 100644
index 0000000000..6d9727402c
--- /dev/null
+++ b/packages/experimental/cua-bundle/docs/preview.svg
@@ -0,0 +1,33 @@
+
diff --git a/packages/experimental/cua-bundle/docs/preview.zh.svg b/packages/experimental/cua-bundle/docs/preview.zh.svg
new file mode 100644
index 0000000000..a4834b6252
--- /dev/null
+++ b/packages/experimental/cua-bundle/docs/preview.zh.svg
@@ -0,0 +1,33 @@
+
diff --git a/packages/experimental/cua-bundle/locale/en.json b/packages/experimental/cua-bundle/locale/en.json
index eaab4261ac..5893fa41d8 100644
--- a/packages/experimental/cua-bundle/locale/en.json
+++ b/packages/experimental/cua-bundle/locale/en.json
@@ -1,6 +1,7 @@
{
"meta": {
"title": "Computer Use",
- "description": "Currently supports macOS; Windows support is in development. Loads Computer Use for existing and new PTC sessions. Switch to PTC mode and grant Accessibility and Screen Recording permissions to use it."
+ "description": "Currently supports macOS; Windows support is in development. Loads Computer Use for existing and new PTC sessions. Switch to PTC mode and grant Accessibility and Screen Recording permissions to use it.",
+ "detail": "docs/DETAIL.md"
}
}
diff --git a/packages/experimental/cua-bundle/locale/zh.json b/packages/experimental/cua-bundle/locale/zh.json
index 3daf33eab3..e1e2cdf945 100644
--- a/packages/experimental/cua-bundle/locale/zh.json
+++ b/packages/experimental/cua-bundle/locale/zh.json
@@ -1,6 +1,7 @@
{
"meta": {
"title": "Computer Use",
- "description": "目前仅支持 macOS,Windows 支持正在开发中。为已有及新建 PTC 会话加载 Computer Use。请切换到 PTC 模式来使用,并授予辅助功能和屏幕录制权限。"
+ "description": "目前仅支持 macOS,Windows 支持正在开发中。为已有及新建 PTC 会话加载 Computer Use。请切换到 PTC 模式来使用,并授予辅助功能和屏幕录制权限。",
+ "detail": "docs/DETAIL.zh.md"
}
}
diff --git a/packages/experimental/cua-bundle/package.json b/packages/experimental/cua-bundle/package.json
index d4e4438b46..e3daa599cc 100644
--- a/packages/experimental/cua-bundle/package.json
+++ b/packages/experimental/cua-bundle/package.json
@@ -27,6 +27,7 @@
"files": [
"icon.svg",
"locale/*.json",
+ "docs",
"lib/index.js",
"cordis.patch.yml",
"lib/types/**/*.d.ts"