creatixchu
7fd2abd828
The web GUI's folder picking was hardwired to one interaction: a native OS chooser compiled into the gateway, unusable for remote deployments and swappable only by editing apiproxy source. Directory picking becomes a three-package capability seam in packages/host: ctx.directoryPicker returns a discriminated capability — dialog (the extracted native chooser; host-display only) or browse (new: one-level listing + child creation over Node stdlib, hidden flags host-stamped, symlinks followed, ancestry crumbs; remote-capable). The gateway injects the seam, advertises the kind via host.describe.directoryPicker, serves host.listDirectory / host.createDirectory under browse, and answers directory-picker-unavailable across kinds. cordis.yml is the swap point; apps/cli keeps dialog mounted, so behavior is unchanged until the in-app browser PR flips the default. The connection fixture serves a deterministic browse tree; WorkspacesService gains the browse calls the browser UI will drive. Decision record: .agents/notes/implemented/architecture/2026-07-28-directory-picker-capability-seam.md
1.2 KiB
1.2 KiB
@deepseek-ai/dsh-host-directory-picker-dialog
English | 中文
目录选择 seam 的原生 OS 对话框后端：DialogDirectoryPicker 以 dialog 能力注册 ctx.directoryPicker，其 pick(signal) 每次调用打开一个原生选择器并解析出所选绝对路径（取消时为 null）。平台工具不经 shell 调用：macOS 使用 osascript，Windows 使用以 STA 模式运行的 PowerShell FolderBrowserDialog，Linux 使用 Zenity 并以 KDialog 回退；调用方的中止信号会终止原生进程。只有操作者坐在宿主屏幕前时才可用——远程部署应组合 -browse。命令边界（DirectoryPickerRunner）与平台事实可注入，便于确定性测试。
模型体验
无。该后端服务于 GUI 宿主的目录选择；这里没有任何内容进入模型请求。
KV 缓存影响
无；该包既不组装也不发送提供方请求。
已知限制与延期工作
- Linux 依赖桌面工具——Zenity 与 KDialog 均未安装时，
pick以包含解决建议的错误拒绝；它不会回退为手输路径提示（组合层面的回退是 browse 后端）。