Arcana:DSH 的悬浮斜杠命令甲板

前言

DeepSeek Harness(DSH)的斜杠命令是常用操作入口之一。随着内置命令和插件命令增多,只靠输入框里的 / 候选来发现、查看说明和执行,操作路径会显得更碎。

Arcana 提供一个可拖动、可折叠、按使用次数排序的悬浮「命令甲板」,把当前 Harness 可用的斜杠命令列成按钮:悬停看介绍,点击即执行,命令较多时自动分页。

这是什么

Arcana 是 GooodWei 维护的 DSH 客户端插件,许可证为 MIT,面向 dsh 0.1.0-rc.6web profile

它不做服务端改造,不修改 DSH 引擎,只消费公开的 remote.commandssessionsslotslocale 服务,把命令入口整理成界面化的操作面板。

核心功能

  • 全量命令发现:直接读取 Harness 的命令目录,也就是 remote.commands RPC,覆盖内置命令和第三方插件命令。
  • 悬停即见介绍:鼠标停在命令按钮上时,显示该命令的 description;带参数的命令还会额外显示用法提示。
  • 点击即执行:无参数命令点击后立即运行;带参数命令会弹出内联输入框,填完参数后按回车运行。
  • 可拖动、可折叠:可以按住标题栏上下拖动,位置会记忆;标题栏右侧提供折叠/展开按钮,收起后只保留标题栏。
  • 按使用次数排序:每个命令的使用次数保存在本地 localStorage 中,使用次数高的命令排在前面,跨刷新、跨重启保留。
  • 每页 10 条分页:命令较多时自动分页,列表区可滚动。
  • 中英双语:跟随 Harness 的语言设置自动切换。
  • 纯客户端、零构建:无 host 逻辑、无打包步骤,并随主题 --dsw-* token 自适应明暗色。

安装与启用

先安装 pnpm,因为 dsh plugin add 内部会调用它。

在目标 DSH 环境中执行安装命令:

npx @deepseek-ai/dsh plugin --profile web add github:GooodWei/arcana

如果已经全局安装了 dsh,上面的 npx @deepseek-ai/dsh 也可以简写为 dsh

dsh plugin --profile web add github:GooodWei/arcana

安装完成后,重启 DSH:

dsh --profile web

启动后,右上角会出现命令甲板。

典型用法

下面几个操作都可以直接在命令甲板上完成。

1、运行命令:点击某个命令按钮。无参数命令会立即执行;带参数命令会弹出输入框,输入参数后按回车运行。例如 /resume-claude 这类带参数命令,会先在甲板里填参数,再执行。

2、查看介绍:鼠标悬停在命令按钮上,可以看到完整描述;如果命令带参数,还可以看到用法提示。

3、翻页:命令较多时,底部会出现类似 ‹ 1/3 › 的分页控件,每页展示 10 条。

4、拖动:按住标题栏上下拖动,甲板位置会自动记忆。

5、折叠/展开:点击标题栏右侧的 ▸/◂ 按钮可以折叠或展开甲板;收起后只保留标题栏。

6、排序:命令按使用次数降序排列;使用次数相同时按名称排列。

适用场景与注意

Arcana 适合希望在 web profile 中更直接地发现和执行 DSH 斜杠命令的场景,尤其是命令数量较多、需要频繁切换或调用常用命令时。

它仍然是插件,以当前 DSH 进程权限运行。安装前建议检查源码、依赖和许可证。该项目许可证为 MIT。

项目源码地址:

https://github.com/GooodWei/arcana

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜