Files
deepseek-harness/packages/host/directory-picker-native/README.zh.md
Huanqi Cao e182f03230 fix(picker): cascade thread DPI contexts and harden the round-three review points
- setThreadDpiAwareness checks SetThreadDpiAwarenessContext's return value
  and cascades per-monitor-v2 -> per-monitor -> system-aware; DPI stays a
  deliberate cosmetic best-effort - a host accepting none (or lacking the
  API, pre-1607) still gets the modern dialog instead of a downgrade to the
  legacy fallback chain over a cosmetic concern.
- The mocked-koffi world now uses a distinctive 4-byte pointer width and
  rejects mis-sized out-buffers and mis-divided vtable offsets, so a
  regression to hardcoded 8s fails the suite (the ia32 bug class).
- A keyless built-worker e2e guard loads lib/worker.cjs under plain
  worker_threads on POSIX (the workflow-workerthread shape).
- The 'loaded lazily' module claims are reworded to attribute laziness to
  the dynamic import('koffi') calls, and the discarded close-attempt
  rejection is named at its catch.
2026-08-05 00:31:43 +08:00

2.7 KiB
Raw Blame History

@deepseek-ai/dsh-host-directory-picker-native

English | 中文

目录选择 seam原生 OS 选择器后端NativeDirectoryPickernative 能力注册 ctx.directoryPicker,其 pick(signal) 每次调用打开一个原生选择器并解析出所选绝对路径(取消时为 null)。平台工具不经 shell 调用macOS 使用 osascriptLinux 使用 Zenity 并以 KDialog 回退调用方的中止信号会终止原生进程。Windows 在进程内打开现代 IFileOpenDialog——由 koffi 在 worker 线程上驱动的 COM 会话,采用宿主接受的最佳线程 DPI 感知(优先 per-monitor-v2中止时向对话框线程投递 WM_CLOSE——当该原生面不可用时回退到 PowerShell 承载的对话框(先 pwsh,再回退到每台 Windows 都自带的 Windows PowerShell 5.1);可解析但无法呈现对话框的 pwshPowerShell 6 没有 WinForms同样落入该回退。只有操作者坐在宿主屏幕前时才可用——远程部署应组合 -browse。命令边界(DirectoryPickerRunner)与平台事实可注入,便于确定性测试。共享的免 shell 子进程运行器位于 dsh-native-command

双面包browser half./client)向 ui-workspace 的两个目录流洞注册一个无渲染的流程占用者——每次 open 请求驱动 host.pickDirectory,并经洞的 owner 会话上报唯一结果(所选路径/取消/失败)。因此一行 cordis.yml 同时组合原生交互的两侧client 侧不含任何能力 kind 分支,挂载第二个流程包会在加载期失败(洞为 single kind

模型体验

无。该后端服务于 GUI 宿主的目录选择;这里没有任何内容进入模型请求。

KV 缓存影响

无;该包既不组装也不发送提供方请求。

已知限制与延期工作

  • Linux 依赖桌面工具——Zenity 与 KDialog 均未安装时,pick 以包含解决建议的错误拒绝;它不会回退为手输路径提示(组合层面的回退是 browse 后端)。
  • Windows 回退链会降级对话框——进程内选择器就是现代资源管理器风格对话框koffi 无法驱动 COM 时由 PowerShell 层级接手,最终只到达 Windows PowerShell 5.1 的机器得到旧版文件夹树DPI 已修正,但界面不是现代的。
  • 卡死的中止可能泄漏一个对话框线程——当 WM_CLOSE 始终投递不到对话框窗口从未创建driver 会 terminate 并 unref 该 workerNode 无法打断阻塞在原生模态调用里的线程,因此该线程会存活到进程退出。