前言¶
在 DeepSeek Harness (DSH) 的開發中，文件刪除通常是後臺靜默執行的命令，缺乏反饋且容易因模型誤判導致誤刪。良秀「天殺拔刀斬」將刪除操作轉化爲一個帶審查機制的視覺事件，通過強制確認和全屏特效，在保證文件永久刪除的同時提供防誤刪的安全保障。
插件介紹¶
本插件屬於 DSH 生態的「趣味換裝」類別，旨在爲文件管理操作增加趣味性與安全性。
- 名稱：dsh-ryoshu-slash
- 所有者：88514205-oss
- 許可證：MIT
- 核心定位：帶斬擊特效的文件刪除工具，替代 bot 原本的刪除方式，強制審查防誤刪。
安裝步驟¶
安裝該插件需要執行 DSH 原生命令，並確保環境依賴滿足要求。
官方安裝¶
通過 bundle 層棧安裝，無需本地構建：
dsh plugin --profile web add github:88514205-oss/dsh-ryoshu-slash#main
前提條件¶
DSH 的 plugin 命令本質是 pnpm 轉發器。安裝前需確保 pnpm 已安裝在 PATH 中：
npm install -g pnpm
生效方式¶
安裝完成後必須重啓 web 進程才能生效：
dsh web
核心功能¶
該插件在 Windows 平臺提供完整的特效體驗，並在 macOS/Linux 平臺提供核心刪除功能。
刪除機制¶
- 永久刪除：不經過回收站。Windows 使用 PowerShell
Remove-Item，macOS/Linux 使用 Node 原生fs.rm。 - 強制審查：默認開啓。無論模型傳入
auto或delay，都會強制轉爲審查確認模式，必須在界面點擊「確認出刀」後纔會執行刪除。
視覺與交互特效¶
- 全屏斬擊動畫：文件從屏幕下方彈入、聚攏成網格、逐刀斬下、刀光閃爍、音效配合、變白淡出。
- 真實圖標支持：僅 Windows 平臺。支持顯示 exe 的真實圖標和圖片縮略圖（最長邊 96px），通過 HTTP 路由返回 PNG 緩存。
- 語音觸發：支持拇指/食指/中指/環指四種語音觸發。
- 多文件佈局：支持網格矩陣排列，可配置每行文件數。
使用方式¶
安裝並重啓 web 後，在對話中調用工具 ryoshu_slash 即可使用。
配置項¶
設置頁面提供以下持久化配置：
| 配置項 | 默認值 | 說明 |
|---|---|---|
| 文件排列 | 堆疊(抽卡) | 網格堆疊 / 排列一排 |
| 斬殺方式 | 逐個砍 | 一起砍 / 逐個砍 |
| 每行最多文件數 | 6 | 多文件分行的列數上限 |
| 音效音量 | 1 | 語音/音效/BGM 音量 |
| 強制審查 | 開 | 關閉後 auto/delay 才生效 |
| 接管默認刪除方式 | 開 | 開啓後 bot 刪除文件一律走天殺 |
平臺差異¶
- Windows：支持完整的特效、真實系統圖標、圖片縮略圖。
- macOS / Linux：核心功能完整（刪除、審查、動畫、音效），但無系統圖標 API，自動降級爲內置靜態圖標。
注意事項¶
- 永久刪除文件，不經過回收站。
- 需要 pnpm ≥10，安裝過程可能需要允許構建（如遇到構建錯誤，需在 profile 的
pnpm-workspace.yaml中 allowBuilds 放行）。 - 許可證爲 MIT，爲同人作品，僅供學習交流。
- 安裝後必須重啓 web 才能生效。
