前言¶
DeepSeek Harness(DSH)的斜杠命令是常用操作入口之一。随着内置命令和插件命令增多,只靠输入框里的 / 候选来发现、查看说明和执行,操作路径会显得更碎。
Arcana 提供一个可拖动、可折叠、按使用次数排序的悬浮「命令甲板」,把当前 Harness 可用的斜杠命令列成按钮:悬停看介绍,点击即执行,命令较多时自动分页。
这是什么¶
Arcana 是 GooodWei 维护的 DSH 客户端插件,许可证为 MIT,面向 dsh 0.1.0-rc.6 的 web profile。
它不做服务端改造,不修改 DSH 引擎,只消费公开的 remote.commands、sessions、slots、locale 服务,把命令入口整理成界面化的操作面板。
核心功能¶
- 全量命令发现:直接读取 Harness 的命令目录,也就是
remote.commandsRPC,覆盖内置命令和第三方插件命令。 - 悬停即见介绍:鼠标停在命令按钮上时,显示该命令的
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。
项目源码地址: