DSH Plugins
返回列表
⚙️

dsh-plugin-api-gallery

工作流 更新于 2026.10.28

在终端中运行以下命令:

dsh plugin install xiguazhiPrince/dsh-plugin-api-gallery

将以下提示词粘贴到 DeepSeek Harness 对话框中:

在 DeepSeek Harness 中执行 `dsh plugin install xiguazhiPrince/dsh-plugin-api-gallery` 安装本插件,源码见 https://github.com/xiguazhiPrince/dsh-plugin-api-gallery。

插件介绍

做 DSH 插件时,功能想好了,却常常卡在「该挂在界面哪一块」——Slot 名字一堆,文档又偏索引式,很难和真实 UI 对上号。API Gallery 把这件事拆成三件事:用意图对照表帮你从「想做的事」落到该注册的接口;在 46 个可增量 Slot 的真实位置上各放一个带注册代码的 demo,点开即见「这里该怎么写」;在侧栏图鉴面板里提供 Slot、Host Service、Host Event 等全量参考,并逐项说明 57 个不可注册 Slot 的原因。

核心能力不是做一个总览页把按钮堆在一起,而是把入口长在 composer、会话消息、侧栏 Session、Settings、插件详情、原生右侧栏等真实区域。小入口经 shell.overlay 弹出说明与代码;整页或整 tab 类 Slot 则在自身页面内展示。数据对齐 DSH 0.2.1-rc.3 接口快照,条目带「首次出现版本」,便于核对宿主能力边界;插件只注册 list 与自家 key 的 keyed Slot,不替换 single、chain 等内置 UI。

侧栏「图鉴demo」图标打开的参考页集中查阅非 UI 接口:Events、Services、Tools/Builtins,以及 57 个 B 类 Slot 与 6 个 Factory 的分类与 replaceRisk。composer「+」菜单里的指令项则演示 ctx.commandUi.register——扩展点属于 Client Service,不是 Slot——与右侧栏「先 sidebarRightTabs.register、再 sidebar.right.pane.tab 渲染 body」的用法一并写清。

适合正在写或维护 DSH 插件的开发者,尤其是需要快速试 Slot、查 Service/Event 签名、或确认某个位置能不能安全增量注册的人。建议在测试 profile 安装:会在界面多处出现 demo 入口,便于对照而非干扰日常主力环境。

使用场景

  • 不确定功能该注册哪个 Slot,需要对照真实界面位置
  • 要查 Host Service 或 Event 是否存在、签名与 ctx 调用方式
  • 想在测试环境逐个点击 demo,复制注册代码再改自己的插件

适合人员

  • 正在编写或维护 DSH 插件的开发者
  • 需要熟悉 Slot 分类与不可注册边界的插件作者
  • 带新人上手 DSH 扩展接口的团队或维护者