@deepseek-ai/dsh-host-directory-picker-native 0.1.5-rc.2 → 0.1.6-alpha.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.i18n.yaml +1 -1
- package/README.zh.md +7 -7
- package/package.json +3 -3
package/README.i18n.yaml
CHANGED
|
@@ -3,4 +3,4 @@
|
|
|
3
3
|
# after editing either side, bring the other along and re-record with:
|
|
4
4
|
# pnpm run verify-translation-pairing --write packages/host/directory-picker-native/README.md
|
|
5
5
|
README.md: 3f980831848965b976e32b0e5ef25abb77fe4e6e
|
|
6
|
-
README.zh.md:
|
|
6
|
+
README.zh.md: 7a221cbbfebf3d79534e049800e26dab6ca39ad3
|
package/README.zh.md
CHANGED
|
@@ -25,19 +25,19 @@ kind: "package-reference"
|
|
|
25
25
|
<a id="use-this-package"></a>
|
|
26
26
|
## 使用本包
|
|
27
27
|
|
|
28
|
-
|
|
28
|
+
当操作者工作在宿主屏幕前，且原生选择器是合适的交互时，组合此后端。打开目录选择器的工作区流程每个打开请求调用一次 `pick(signal)`；返回的 Promise 解析为所选绝对路径，操作者取消时解析为 `null`。
|
|
29
29
|
|
|
30
30
|
### 何时选择
|
|
31
31
|
|
|
32
|
-
为 macOS、Windows 或桌面 Linux 上的工作站本地操作者选择此后端。当客户端无法触达 OS 选择器时——远程浏览器、SSH 转发会话或无人值守宿主——请选择[浏览后端](../directory-picker-browse/README.zh.md)
|
|
32
|
+
为 macOS、Windows 或桌面 Linux 上的工作站本地操作者选择此后端。当客户端无法触达 OS 选择器时——远程浏览器、SSH 转发会话或无人值守宿主——请选择[浏览后端](../directory-picker-browse/README.zh.md)。具体情况不固定时，[自适应选择器](../directory-picker-auto/README.zh.md)会在启动时判定。
|
|
33
33
|
|
|
34
34
|
### 操作者会看到什么
|
|
35
35
|
|
|
36
|
-
每次调用在宿主屏幕上打开一个原生选择器并等待操作者；中止调用方的信号会终止选择器进程，而不是让它留在屏幕上。Linux 上选择器需要安装 Zenity 或 KDialog 之一；两者都没有时，`pick`
|
|
36
|
+
每次调用在宿主屏幕上打开一个原生选择器并等待操作者；中止调用方的信号会终止选择器进程，而不是让它留在屏幕上。Linux 上选择器需要安装 Zenity 或 KDialog 之一；两者都没有时，`pick` 以包含解决建议的错误拒绝，而不会回退为手输路径提示。本包的浏览器端向工作区流程注册一个无渲染的流程占用者——每次 `open` 请求驱动 `directoryPicker/pick`，并上报唯一结果（所选路径、取消或失败）。
|
|
37
37
|
|
|
38
38
|
### 可观察的失败
|
|
39
39
|
|
|
40
|
-
取消返回 `null
|
|
40
|
+
取消返回 `null`，不是错误。平台工具缺失、选择器启动失败或选择操作中止都会导致 Promise 拒绝，界面可呈现相应错误；[浏览后端](../directory-picker-browse/README.zh.md)仍是原生目录选择不可靠时的组合层回退方案。
|
|
41
41
|
|
|
42
42
|
-----
|
|
43
43
|
|
|
@@ -49,7 +49,7 @@ kind: "package-reference"
|
|
|
49
49
|
|
|
50
50
|
### 设计理念
|
|
51
51
|
|
|
52
|
-
后端是平台选择器之上的一层薄服务：`NativeDirectoryPicker` 注册 `native` 能力，其 `pick` 转发给 `pickNativeDirectory
|
|
52
|
+
后端是平台选择器之上的一层薄服务：`NativeDirectoryPicker` 注册 `native` 能力，其 `pick` 转发给 `pickNativeDirectory`，选择器以子进程运行，因此宿主进程不会因对话框而阻塞。命令边界（`DirectoryPickerRunner`）与平台事实可注入；共享的免 shell 子进程运行器位于 [`dsh-native-command`](../../util/native-command/README.zh.md)。
|
|
53
53
|
|
|
54
54
|
### 平台机制
|
|
55
55
|
|
|
@@ -94,7 +94,7 @@ kind: "package-reference"
|
|
|
94
94
|
<a id="known-limitations-and-deferred-work"></a>
|
|
95
95
|
|
|
96
96
|
|
|
97
|
-
|
|
97
|
+
这些限制说明原生交互何时不可用或不稳定。它们是当前包约束，不是任务积压。
|
|
98
98
|
|
|
99
99
|
- **Linux 依赖桌面工具**——Zenity 与 KDialog 均未安装时，`pick` 以包含解决建议的错误拒绝；它不会回退为手输路径提示（组合层面的回退是浏览后端）。
|
|
100
100
|
- **Windows 没有机制级回退**——通过打包依赖 koffi 运行的子进程选择器是唯一原生层级，因此 COM 拒绝或对话框崩溃会直接上报失败；组合层面的回退仍是浏览后端。
|
|
@@ -110,4 +110,4 @@ kind: "package-reference"
|
|
|
110
110
|
|
|
111
111
|
</details>
|
|
112
112
|
|
|
113
|
-
**运行时不变式：**
|
|
113
|
+
**运行时不变式：** 不发布伴生入口。每次选择都是一次无状态的子进程往返；选择器的结果仅为返回的路径。
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@deepseek-ai/dsh-host-directory-picker-native",
|
|
3
3
|
"description": "Native-OS-chooser backend of the directory-picker seam for the DeepSeek Harness web GUI host",
|
|
4
|
-
"version": "0.1.
|
|
4
|
+
"version": "0.1.6-alpha.2",
|
|
5
5
|
"publishConfig": {
|
|
6
6
|
"access": "public"
|
|
7
7
|
},
|
|
@@ -33,8 +33,8 @@
|
|
|
33
33
|
"license": "MIT",
|
|
34
34
|
"dependencies": {
|
|
35
35
|
"koffi": "^3.1.0",
|
|
36
|
-
"@deepseek-ai/dsh-
|
|
37
|
-
"@deepseek-ai/dsh-
|
|
36
|
+
"@deepseek-ai/dsh-native-command": "^0.1.6-alpha.2",
|
|
37
|
+
"@deepseek-ai/dsh-host-directory-picker": "^0.1.6-alpha.2"
|
|
38
38
|
},
|
|
39
39
|
"peerDependencies": {
|
|
40
40
|
"@deepseek-ai/cordis": "^4.0.2"
|