Skip to content

feat(composer): 用可搜索的 Codex 风格项目选择器替换欢迎页工作区菜单 - #106

Closed
HappyDIY wants to merge 1 commit into
MichengAI:mainfrom
HappyDIY:feat/codex-workspace-picker
Closed

HappyDIY wants to merge 1 commit into
MichengAI:mainfrom
HappyDIY:feat/codex-workspace-picker

Conversation

@HappyDIY

Copy link
Copy Markdown
Contributor

问题

欢迎页 conversation.hero.workspace 槽位用的是宿主默认菜单:项目多了只能线性滚动,没有搜索,也没有「新建项目」入口,和 Codex 的项目选择器体验有明显差距。

改动

  • 以 priority: -100 覆盖宿主单槽 conversation.hero.workspace,用 portal 浮层渲染可搜索的项目列表;选中仍走 owner 的 onPick,数据仍取自宿主 useWorkspaces 快照,不额外维护本地副本。
  • 搜索按「标题 / 路径」过滤;方向键移动高亮、Enter 选中、Esc 与浮层外点击关闭;展开方向只在打开时判定一次,过滤导致高度变化时不会来回翻面。
  • 「新建项目」:桌面端优先走预加载桥 __DSH_DIRECTORY_PICKER__,普通浏览器 / 远程 Peer 回退 ctx.uiWorkspace.pickDirectory();拿到目录后调用 ctx.workspaces.create()。取消选择不注册工作区,失败就地展示错误并可重试。
  • 列表溢出时在右缘显示固定的 24px 短滚动条(可拖动、随滚动更新位置),列表底部做渐隐遮罩。
  • 图标复用宿主 @deepseek-ai/dsh-client-ui-primitives(folder / search / plus);样式全部走 --dsw-alias-* 主题令牌,浅色 / 深色 / 玻璃主题自动适配,并随插件生命周期注入与移除。
  • 补齐 zh / en / ja / es / fr / de / ru / pt 八种内置语言文案。
  • 按仓库惯例同步 lib/ 构建产物。

兼容性

  • 无新增运行时依赖;@deepseek-ai/* 仅引入类型,编译期擦除。
  • 目录选择能力缺失时回退宿主 picker,不改变宿主 Workspace Controller 的任何语义。

验证

  • tsc --noEmit、tsdown 构建通过;CI 同款 git diff --exit-code HEAD -- lib/ 无差异。
  • Vitest 全量 45 文件 / 476 用例通过,其中新增 tests/workspace-picker.spec.ts(9 用例:渲染、搜索过滤、点击选中、新建成功 / 取消 / 失败、键盘、滚动条、关闭)与 tests/composer-plugin.spec.ts 的槽位接线用例。
  • pnpm test 的 assertion 脚本与 Chromium layout / glass / settings 几何检查全部通过。

基于上游 80587dd(2.3.0)rebase,已重建 lib/。

…picker

- replace the conversation.hero.workspace slot occupant with a searchable
  project dropdown (title/path filter, keyboard navigation, outside-click and
  Esc close, stable open direction)
- show a fixed short draggable scrollbar thumb when the project list overflows
- add a "New project" action backed by the desktop directory bridge (or the
  Host picker) followed by createWorkspace, with inline error handling
- use the DSH-native folder/search/plus icon set and add copy for all eight
  built-in locales
- cover rendering, filtering, selection, creation, cancellation, failure,
  keyboard and scrollbar behaviour with unit tests plus a slot-wiring test
@MichengAI

Copy link
Copy Markdown
Owner

非常感谢提交此 PR!在欢迎页(Hero 区域)提供支持按名称/路径即时搜索、键盘快速导航、并能就地一键新建工作区的设计,非常契合多项目用户的痛点,也很符合 Codex 的核心交互质感。你的改动非常完整,不仅覆盖了 8 种内置语言,还补充了详细的单元测试。

经过维护团队的深入技术评审与端到端契约核验,这个方向我们非常认可,但当前 PR 的实现路径因为与 DSH 宿主的架构契约和跨环境兼容性存在深层冲突,遗憾无法直接合入,主要原因如下:

  1. 破坏子插槽生态契约(directoryFlow 链断裂)
    宿主在 conversation.hero.workspace 单槽设计中,要求声明单槽子插槽 conversation.hero.workspace.directoryFlow。这是 DSH 架构解耦本地桌面 OS 选择器(directory-picker-native)与应用内通用选择器(directory-picker-browse)的标准机制。PR 使用 priority: -100 抢占父槽但未声明并暴露该子插槽,会导致挂载在该槽位上的官方与第三方目录流插件直接失效。

  2. Web / 远程端多环境运行风险
    PR 优先尝试探测私有全局预加载桥 __DSH_DIRECTORY_PICKER__,不存在时回退至 ctx.uiWorkspace.pickDirectory()。然而在 Web Profile 或远程 Peer 部署场景下,后端并不具备本地 OS 原生对话框能力(宿主设计上正是通过 directoryFlow 插件接管提供应用内弹窗),直接调用会导致未捕获的错误。

  3. 宿主原语与材质规范对齐
    根据插件工程规范,浮层、面板与滚动条应优先复用宿主自带的控件原语和系统级毛玻璃/微光投影规范(如 --dsw-menu-surface-fill、--dsw-elevation-prominent 等),以保障不同主题和宿主升级时的视觉一致性。手绘 CSS 浮层与自定义滚动条在后续宿主演进中维护成本较高。此外,弹出层还需要完整的无障碍支持(如 Tab 焦点陷阱捕获、关闭后焦点安全归位回触发按钮等)。

  4. Store 异步投影快照的竞态时序
    在新建工作区时,createWorkspace resolve 后仍需等待前端全局 Store(useWorkspaces)的快照更新完成,过早触发 onPick 会在快照广播未达时出现根据 workspaceId 寻址为空的状态竞态。


后续规划:
这项交互改进十分重要,维护团队已将「Codex 风格可搜索项目选择器」正式纳入近期的迭代路线中,届时我们将基于官方标准的 directoryFlow 插槽架构与原生原语控件规范进行深度集成。

再次感谢你对 dsh-codex-ui 的关注与高质量探索!期待未来在更多特性上有进一步的合作。

@MichengAI

Copy link
Copy Markdown
Owner

补充一条进展:这个方向已经落地并发版了,作者的原始实现已在主干上,特此同步。

落地情况

相对原 PR 的调整(就是上一条评论里列的几点)

  1. 改用宿主原语:浮层换成 MenuSurface / MenuItemButton / Input,删掉手绘 panel、24px 自绘滚动条与 z-index: 1100;材质沿用宿主 --dsw-elevation-* 与滚动条 l2 令牌,主题与宿主升级自动跟随。
  2. 焦点与滚动:关闭(选中 / Esc / 外部点击)统一归还焦点到工作区胶囊;键盘高亮随列表滚动保持可见。
  3. 可辨识性:同名项目显示最短可区分路径后缀;当前工作区带对勾。
  4. 远程与无原生对话框宿主:directory-picker/unavailable 时永久关闭「新建项目」闸门并让入口消失,不再留下点了没反应的假入口,也不会抛未捕获错误。

一处保留的取舍

conversation.hero.workspace.directoryFlow 子槽由官方 ui-workspace 独占声明,遮蔽条目无法再声明 children(否则 SlotOwnershipError)。因此欢迎页不再提供应用内目录浏览流:新建项目改走系统目录对话框,在没有原生对话框的宿主(远程 Peer、SSH 启动、非 loopback 绑定)上隐藏该入口。这一限制已明确写入双语 CHANGELOG 的 2.4.0 段落。

再次感谢这份高质量的探索——搜索过滤、键盘导航、八语本地化和测试都为我们后面这版打了个很好的底子。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants