DSH 通过插件扩展能力,各类功能分散在斜杠菜单、模型选择器、侧边栏和 Composer 的 @ 菜单等不同位置。键盘优先的用户需要一个统一的入口来回答:当前工作区我能做什么,以及如何快速到达那里。
Universal Palette 提供了一个共享的搜索控制器,通过官方 API 实时获取命令、模型、会话和历史记录。
插件介绍¶
名称:yunmin311/dsh-universal-palette
类别:客户端
维护者:yunmin311
许可证:MIT
核心功能¶
- 命令:通过官方 API 搜索和执行的实时主机命令目录。新增的 Host 命令会自动出现。
- 模型:会话的真实模型目录,显示当前选中项。
- 会话:当前优先的会话导航,支持稳定的身份去重。
- 对话命中:通过 DSH 的会话搜索进行全文历史检索。
- 确定性相关性:精确前缀优先评分,过滤低相关性结果。
- 原生外观:使用 DSH 设计令牌,提供原生菜单排版和玻璃拟态表面,跟随本地化文案。
- 公共契约互操作性:基于验证的公共契约与社区插件协作,无私有耦合。
安装与启用¶
通过 DSH 官方插件管理器安装:
dsh plugin --profile web add @yunmin311/dsh-universal-palette@0.2.1
安装后,在 --profile web 模式下启动 DSH 即可生效。
典型用法¶
- Composer 搜索:在原生 DSH 斜杠菜单中输入
/find,或使用搜索按钮。搜索结果会以 DSH 原生界面显示,位于 Composer 之上或之下(取决于会话状态)。 - 全局悬浮调色板:在 Windows/Linux 上按
Alt+Q,或在 macOS 上按Cmd+Shift+K,可切换全局悬浮调色板。 - 关闭:按
Esc关闭调色板。
适用场景与注意¶
- Composer Search 限制:Composer Search 功能需要一个声明了
conversation.hero.composer.dock座位的主机。如果主机未声明该座位,Composer Search 将在 Hero 界面关闭。 - 行为一致性:对于未验证公共契约的功能,插件不改变任何行为。
- 隐私与耦合:插件不进行私有注册表读取,不引入硬依赖,仅实现共存。
结尾¶
Universal Palette 为键盘优先的用户提供了集中的控制点,确保了与 DSH 生态系统的兼容性。