在 DSH 的 Web 界面中,bash 和 pwsh 工具行的展示直接影響使用體驗。原版工具行在處理長命令或需要單獨複製命令時存在操作不便的問題。dsh-shell-card-plus 旨在解決這些具體痛點,提供更清晰的展示與操作方式。
是什麼¶
這是一個由 antnesswcm 維護的增強插件。它的核心作用是完全替換 Web 界面中 bash/pwsh 的官方工具行,不改變命令執行邏輯。
功能¶
- 完全替換官方工具行:摺疊行樣式與官方保持一致,展開後爲自定義卡片。
- 頭部:顯示狀態點、當前工作目錄(cwd)、複製命令、複製輸出按鈕。
- 命令區:完整命令,支持自動折行與行號顯示。
- 輸出區:橫向滾動,保留原版閱讀習慣。
- 獨立複製按鈕:提供“複製命令”和“複製輸出”兩個獨立按鈕,解決原版只能複製輸出的問題。
- 範圍限定:僅接管 bash 和 pwsh,不影響 read/write/search 等其他工具。
安裝與啓用¶
安裝命令如下:
dsh plugin --profile web add dsh-shell-card-plus
安裝完成後,需重啓 dsh web 或在瀏覽器中刷新頁面(Ctrl+F5)才能生效。
工作原理¶
插件通過官方的 tool.call.toolview 插槽註冊 bash 和 pwsh 兩個 key,接管渲染。命令、cwd、輸出、退出碼全部來自官方已有的 ToolCallBlock 數據。它是一個純展示層插件,不引入新事件或對 host 做改動。
注意事項¶
使用該插件要求 DSH 版本不低於 0.1.0-rc.5。插件遵循 MIT 許可證,源碼託管於 GitHub。