20 lines
1.8 KiB
Markdown
20 lines
1.8 KiB
Markdown
# @deepseek-ai/dsh-host-directory-picker-native
|
||
|
||
[English](README.md) | 中文
|
||
|
||
[目录选择 seam](../directory-picker/README.md) 的**原生 OS 选择器后端**：`NativeDirectoryPicker` 以 `native` 能力注册 `ctx.directoryPicker`，其 `pick(signal)` 每次调用打开一个原生选择器并解析出所选绝对路径（取消时为 `null`）。调用平台工具时不经过 shell：macOS 使用 `osascript`，Windows 使用以 STA 模式运行的 PowerShell `FolderBrowserDialog`，Linux 使用 Zenity 并以 KDialog 回退；调用方的中止信号会终止原生进程。该后端仅适用于操作者可直接使用宿主显示器的场景；远程部署应组合 [`-browse`](../directory-picker-browse/README.md)。命令边界（`DirectoryPickerRunner`）与平台事实可注入，便于确定性测试。共享的免 shell 子进程运行器位于 [`dsh-native-command`](../../util/native-command/README.md)。
|
||
|
||
**双面包**：browser half（`./client`）向 [ui-workspace](../../client/ui-workspace/README.md) 的两个目录流洞注册一个无渲染的流程占用者——每次 `open` 请求都会调用 `host.pickDirectory`，并通过洞的 owner 会话上报一次结果（所选路径／取消／失败）。因此一行 cordis.yml 同时组合原生交互的两侧；client 侧不含任何能力 kind 分支，挂载第二个流程包会在加载时失败（洞为 `single` kind）。
|
||
|
||
## 模型体验
|
||
|
||
无。该后端服务于 GUI 宿主的目录选择；这里没有任何内容进入模型请求。
|
||
|
||
#### KV Cache 影响
|
||
|
||
无；该包既不组装也不发送提供方请求。
|
||
|
||
## 已知限制与暂缓事项
|
||
|
||
- **Linux 依赖桌面工具**——Zenity 与 KDialog 均未安装时，`pick` 会拒绝并返回包含解决建议的错误；它不会回退为手动输入路径的提示（组合层面的回退是 browse 后端）。
|