[BUG] Windows：文件「打开方式」菜单列出了系统里全部注册处理器，而非推荐项（应使用 ASSOC_FILTER_RECOMMENDED）

[anyuezou]

分类： Bug 报告
组件： @deepseek-ai/dsh-native-command（Windows 文件关联枚举）、@deepseek-ai/dsh-client-ui-open-in-app（菜单渲染与空列表回退）、@deepseek-ai/dsh-api-session-controller（workspacePathApplications 路由）
版本： DSH 桌面端 0.2.0-rc.2（Electron 44.0.0 / Node 24.18.1）
平台： Windows 11 x64

English abstract: On Windows, the file "Open with" menu (dsh-client-ui-open-in-app) lists every registered shell handler instead of the recommended ones, because dsh-native-command's Windows adapter calls SHAssocEnumHandlers(extension, ASSOC_FILTER_NONE /* 0 */, ...) and never consults the IHandler::IsRecommended() it already declares. Measured on one machine: a .xlsx yields 17 entries with filter 0 vs 2 with ASSOC_FILTER_RECOMMENDED. Note a naive 0 → 1 change regresses file types whose recommended set is empty (.json, .et, …): the dropdown disappears and the main button degrades to "reveal only" — recommend a fallback to the full list when the recommended set is empty.

---

1. 环境

项	值
DSH 桌面端	@deepseek-ai/dsh-desktop 0.2.0-rc.2
Electron / Node	44.0.0 / 24.18.1
OS	Windows 11 x64
相关包	dsh-client-ui-open-in-app 0.2.0-rc.2、dsh-host-open-in-app 0.2.0-rc.2、dsh-native-command 0.2.0-rc.2、dsh-api-session-controller 0.2.0-rc.2
安装资源时间戳	2026-09-29

2. 现象

在文档预览（右侧栏）的「打开」分体按钮上点下拉箭头，菜单列出 17 个应用：

Excel / ChatGPT / WorkBuddy / Kimi / 记事本 / 百度网盘 / 百度网盘 /
excelcnv(显示为 Microsoft Excel) / Adobe Illustrator 2026 / MuMu模拟器 /
Adobe Photoshop 2025 / Qianwen / Quark / Word / 旧版 Windows Media Player /
Word Converter / Microsoft Office component

其中大部分（百度网盘两个 exe、夸克、千问、MuMu、Adobe 两件套、Office 的三个转换组件 excelcnv.exe/WORDICON.EXE/Wordconv.exe、旧版 WMP）并不会打开 .xlsx，只是把自己注册成了"通用打开程序"。

作为对照，改用 Shell 的"推荐"档（ASSOC_FILTER_RECOMMENDED，即系统自带「打开方式」界面所用的档位）枚举同一个文件，只得到 2 项。用户预期：只列真正能打开该格式的应用 + 底部固定的「显示文件位置」。

3. 复现步骤

1. 在 Windows 上安装若干会写"通用打开项"的软件（国产网盘/浏览器客户端、模拟器、Adobe 系列等）。它们会在 HKEY_CLASSES_ROOT\Applications\<exe> 下写 shell\open\command，但既不写 SupportedTypes（不限定格式），也不写 NoOpenWith（不退出列表）。
   • 对照：iexplore.exe、provtool.exe、系统 notepad.exe 都带 NoOpenWith=1，它们不会出现在菜单里——说明枚举结果确实受这些注册约束。
2. 任取一个 .xlsx（.xls/.csv 同样），在 DSH 文档预览里点「打开」下拉箭头。
3. 菜单列出全部 17 项。

4. 根因定位

调用链：

ui-open-in-app (文档预览/文件树 文件控件)
  → session.workspacePathApplications        （dsh-api-session-controller）
  → nativeFileApplications                   （dsh-native-command）
  → file-applications-windows.js 内编译的 C# → SHAssocEnumHandlers(ext, filter, ...)

包内路径：
@deepseek-ai/dsh-native-command/lib/types/file-applications-windows.js

第 183 行（根因）：

SHAssocEnumHandlers(extension, 0, out handlers);   // 0 == ASSOC_FILTER_NONE

SHAssocEnumHandlers 的第二个参数是过滤级别：

• ASSOC_FILTER_NONE = 0x0 —— 返回全部已注册处理器
• ASSOC_FILTER_RECOMMENDED = 0x1 —— 只返回推荐处理器（系统自己的「打开方式」界面用的就是这一档）

同一文件第 26 行已经声明了 [PreserveSig] int IsRecommended();，但整个文件从未调用它——拿得到"是否推荐"的信息却没有用来过滤。

5. 实测对照

用该文件内嵌的同一段 C#（含 Add-Type -ReferencedAssemblies System,System.Core,System.Drawing、-STA）在本机枚举：

.xlsx：

• filter = 0 → 17 项（即上面那串）
• filter = 1 → 2 项（Excel、Kimi）

跨扩展名（filter 0 / filter 1）：

扩展名	0	1	扩展名	0	1
.xlsx	17	2	.json	14	0
.xls	17	2	.md	15	2
.xlsm	17	1	.xlsb	15	1
.csv	17	2	.ods	15	1
.txt	15	3	.et（WPS）	14	0
.png	19	6	.zzz/.foo/.tmp	14	0
.pdf	18	8
.docx	16	3

补充：探针单次耗时 0.4–0.5 秒，连续多次运行结果完全一致，可排除超时/不稳定的可能；.zzz 这类无关联扩展名同样返回 14 项，说明"通用打开项"对任意扩展名都被算作候选。

6. 期望行为

菜单只列出被 Shell 标记为"推荐"的处理器，再加上固定在底部的「显示文件位置」。

7. ⚠️ 修法提醒：直接改常量会造成功能倒退

如果只是把第 183 行的 0 改成 1，会出现新的问题。dsh-client-ui-open-in-app 的 OpenTargetButton 中：

const hasMenu = props.loading === true || props.failed || applications.length + (kind === "file" ? 1 : 0) > 1;
const revealDefault = kind === "file" && preferred === void 0 && props.loading !== true;

当推荐档为空（applications.length === 0）时：

• hasMenu 为 false → 下拉箭头整个不渲染；
• revealDefault 为 true → 主按钮变成只执行「显示文件位置」。

即：用户连"用默认应用打开"都点不到。上表里 .json、.et(WPS 表格) 在 filter = 1 下正好返回 0 项，会命中这个分支——这是实打实的功能倒退，比"菜单太长"更严重。

因此建议的修法是：优先使用推荐档；当推荐档为空时回退到完整列表。（或保留完整列表，但把 IsRecommended() == false 的条目排到后面/折叠起来。）如果产品上确实有意展示全部处理器，至少把推荐档作为默认，并提供设置开关。

8. 影响面

• 仅 Windows 分支：macOS 走 LaunchServices（并做了同名副本去重），Linux 走 GIO。
• 两个界面都受影响：文档预览 / 文件树的文件控件，以及交付卡片（dsh-client-ui-deliverables 的 deliverables.file.actions → FileRouteAction → GET /api/present.open，该路由同样返回 workspacePathApplications 的结果）。
• 目录（workspace）那个分体按钮不受影响，它走的是 catalog 应用表。

9. 最小验证脚本

把下面这段存成 .ps1，-Path 指向任意 .xlsx，即可对比两档过滤（ASCII 文件名即可，扩展名是唯一输入）：

param([string]$Path)
$ErrorActionPreference = 'Stop'
[Console]::OutputEncoding = New-Object System.Text.UTF8Encoding($false)
Add-Type -ReferencedAssemblies System,System.Core -TypeDefinition @'
using System;
using System.Collections.Generic;
using System.Runtime.InteropServices;
using System.Runtime.InteropServices.ComTypes;

public static class AssocProbe {
  [ComImport, Guid("973810ae-9599-4b88-9e4d-6ee98c9552da"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
  public interface IEnumHandlers { [PreserveSig] int Next(uint count, out IHandler handler, out uint fetched); }
  [ComImport, Guid("f04061ac-1659-4a3f-a954-775aa57fc083"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
  public interface IHandler {
    void GetName([MarshalAs(UnmanagedType.LPWStr)] out string name);
    void GetUIName([MarshalAs(UnmanagedType.LPWStr)] out string name);
    void GetIconLocation([MarshalAs(UnmanagedType.LPWStr)] out string path, out int index);
    [PreserveSig] int IsRecommended();
    void MakeDefault([MarshalAs(UnmanagedType.LPWStr)] string description);
    void Invoke(IDataObject data);
    void CreateInvoker(IDataObject data, [MarshalAs(UnmanagedType.Interface)] out object invoker);
  }
  [DllImport("shell32.dll", CharSet = CharSet.Unicode, PreserveSig = false)]
  static extern void SHAssocEnumHandlers(string extension, uint filter, out IEnumHandlers handlers);

  public static string[] List(string path, uint filter) {
    string ext = System.IO.Path.GetExtension(path);
    var list = new List<string>();
    IEnumHandlers handlers;
    SHAssocEnumHandlers(ext, filter, out handlers);
    try {
      while (true) {
        IHandler h; uint fetched;
        int r = handlers.Next(1, out h, out fetched);
        Marshal.ThrowExceptionForHR(r);
        if (r != 0 || fetched == 0) break;
        try {
          string id, name; h.GetName(out id); h.GetUIName(out name);
          list.Add(String.Format("{0}  [IsRecommended={1}]", name, h.IsRecommended() == 0));
        } finally { Marshal.FinalReleaseComObject(h); }
      }
    } finally { Marshal.FinalReleaseComObject(handlers); }
    return list.ToArray();
  }
}
'@
foreach ($f in 0, 1) {
  $items = [AssocProbe]::List($Path, [uint32]$f)
  Write-Output "=== filter=$f  (0=ASSOC_FILTER_NONE, 1=ASSOC_FILTER_RECOMMENDED)  条目数=$($items.Count) ==="
  $items | ForEach-Object { Write-Output "  $_" }
}

调用方式（必须 -STA）：

powershell.exe -NoProfile -NonInteractive -STA -ExecutionPolicy Bypass -File .\assoc-probe.ps1 -Path C:\tmp\sample.xlsx

10. 附：注册表侧证据（节选）

HKLM\SOFTWARE\Classes\.xlsx\OpenWithProgids      -> WorkBuddy.xls
HKCU\...\Explorer\FileExts\.xlsx\OpenWithProgids -> Excel.Sheet.12
HKCR\Applications\BaiduNetdisk.open\shell\open\command -> "...\BaiduNetdisk.exe" "%1"   (无 SupportedTypes / 无 NoOpenWith)
HKCR\Applications\quark.exe\...        (同上，注册在 HKLM)
HKCR\Applications\Photoshop.exe\...    (同上，注册在 HKLM)
HKCR\Applications\iexplore.exe         NoOpenWith = 1  -> 不出现在菜单中（对照组）
HKCR\Applications\provtool.exe         NoOpenWith = 1  -> 不出现在菜单中（对照组）

其中 dsh-client-ui-open-in-app 的 README 已写明"文件菜单列出已发现的关联应用，不单列『用默认应用打开』"，与当前实现一致；问题只在于"关联应用"的取法用了最宽的过滤档。

---

本报告由用户与 AI 协作排查后整理。第 5、7 节的数字均为在本机按上述脚本实测所得，可复现下为附图。

[PerryLink]

确认了，你标的根因在 0.2.1-rc.1 上一处没改。

packages/util/native-command/src/file-applications-windows.ts:185：

SHAssocEnumHandlers(extension, 0, out handlers);

第二个参数就是过滤档，0 是 ASSOC_FILTER_NONE。IsRecommended() 在同一个文件 :28 的 IHandler 接口里声明着，全文再没有第二处出现——我按整文件扫过，只有这一行声明。所以确实是"拿得到推荐信息但没用"。

一个小差别：你读的是发布包里编译过的 lib/types/file-applications-windows.js，那句在第 183 行；源码 .ts 里是第 185 行。同一个语句，PR 里引源码行号更稳。

你第 7 节那个倒退提醒是对的，而且它不是"可能"，是必然——Visit() 在 :183 对空扩展名直接 return，List() 在 :197-198 也有同样的守卫，所以"枚举结果为空"这条路今天已经在跑了（无扩展名的文件就会走到），UI 早就得容忍它：packages/client/ui-open-in-app/src/client/OpenTargetButton.tsx 的 :93 hasMenu、:94 revealDefault 就是干这个的。因此把 0 换成 1 不会崩，只是让 .json、.et 这类没有推荐项的格式新加入这个状态。

有个实现位置的问题，我觉得比改哪个常量更要紧。packages/client/ui-open-in-app/README.md:38 写着空结果走 reveal 回退是 "without platform branches in the control"——也就是说，回退逻辑不能写在按钮里，得落在 native-command 的 Windows 适配器内；写在按钮里等于把同一套语义在三个平台各写一遍，正好违反那条约定。落法就是 Visit()/List() 里先按 1 枚举、空了再按 0 枚举一次；或者更省一次 Shell 调用：一次拿全量，用 handler.IsRecommended() 分两区，推荐项在前、其余折叠。

再补一个你两张表之外的点：List() 在 :196-199 用两次 Associated() 结果算 @default，:207 再拿它跟每个 handler 的 id 比。这段计算与过滤档完全无关，所以无论取 0 还是 1，默认应用的标记都还能照算——改过滤不会丢默认项。

影响面你那节也对上了：deliverables.file.actions 和 deliverables.review.file.actions 两个槽在 packages/client/ui-deliverables/src/client/index.ts:67 与 :90 注册，路由是 packages/api/session-controller/src/index.ts:397-398 的 @Remote('workspacePathApplications')。