前言¶
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。
項目源碼地址: